Introduce 'make-dist' tool

.dir-locals.el

@@ -18,12 +18,10 @@
 ;;; Directory Local Variables
 ;;; For more information see (info "(emacs) Directory Variables")
 
-((nil
-  (sentence-end-double-space . t))
- (makefile-gmake-mode
-  (outline-regexp . "##"))
- (c-mode
-  (indent-tabs-mode . nil)
-  (c-basic-offset . 2)
-  (fill-column . 80)
-  (c-file-style . "gnu")))
+((nil . ((sentence-end-double-space . t)))
+ (sh-mode . ((sh-basic-offset . 2)))
+ (makefile-gmake-mode . ((outline-regexp . "#\\(#+\\)")))
+ (c-mode . ((indent-tabs-mode . nil)
+            (c-basic-offset . 2)
+            (fill-column . 80)
+            (c-file-style . "gnu"))))

.gitattributes

@@ -17,14 +17,21 @@
 # You should have received a copy of the GNU General Public License
 # along with Brogw.  If not, see <https://www.gnu.org/licenses/>.
 
-Makefile.*  linguist-language=Makefile
-*.m4        linguist-language=M4
-*.ac        linguist-language=M4
-
-AUTHORS     text
-CONTRIBUTE  text
-COPYING     text
-ChangeLog   text
-INSTALL     text
-NEWS        text
-README      text
+AUTHORS text
+CONTRIBUTE text
+COPYING text
+ChangeLog text
+INSTALL text
+NEWS text
+README text
+
+# Hooks for non-default diff hunk headers; see autogen.sh.
+*.ac diff=m4 linguist-language=M4
+*.m4 diff=m4 linguist-language=M4
+Makefile.* diff=make linguist-language=Makefile
+*[Mm]akefile diff=make
+*[-.]sh diff=shell
+*.texi diff=texinfo
+
+# Diff hunk header special-case file names.
+/make-dist diff=shell

.gitignore

@@ -1,39 +1,124 @@
+# Files that Git should ignore in the Brogw source directory.
+
 # Copyright (C) 2024 Free Software Foundation, Inc.
-#
+
 # This file is part of Brogw.
-#
+
 # Brogw is free software; you can redistribute it and/or modify it
 # under the terms of the GNU General Public License as published by
 # the Free Software Foundation; either version 3 of the License, or
 # (at your option) any later version.
-#
+
 # Brogw is distributed in the hope that it will be useful, but WITHOUT
 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 # or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
 # License for more details.
-#
+
 # You should have received a copy of the GNU General Public License
 # along with Brogw.  If not, see <https://www.gnu.org/licenses/>.
 
-brogw
+# Built by 'autogen.sh'.
+/aclocal.m4
+/configure
+/configure~
+src/config.in
+src/config.in~
 
-.deps
-build-aux
-autom4te.cache
+# Build by 'automake'.
+autom4te.cache/
+Makefile.in
 
+# Built by 'configure'.
+Info.plist
+InfoPlist.strings
 Makefile
-Makefile.in
-aclocal.m4
-autom4te.cache
-compile
-config.h
-config.h.*
-config.guess
-config.status
-config.sub
-configure
-configure~
-depcomp
-install-sh
-missing
+/config.status
+src/config.h
+
+# Dependencies.
+.deps/
+deps/
+
+# Time stamps.
+*.stamp
 stamp-h1
+
+# Object files and debugging.
+*.a
+*.dSYM/
+*.dll
+*.core
+*.o
+*.res
+*.so
+*.dylib
+
+# ctags, etags.
+TAGS
+
+# GNU global.
+GPATH
+GSYMS
+GRTAGS
+GTAGS
+
+# GNU idutils.
+ID
+
+# Executables.
+*.exe
+a.out
+nextstep/Brogw.app/
+src/brogw
+src/brogw-[0-9]*
+
+# Documentation.
+*.aux
+*.cm
+*.cms
+*.cp
+*.cps
+*.doc
+*.dvi
+*.fn
+*.fns
+*.info
+*.ky
+*.kys
+*.op
+*.ops
+*.pdf
+*.pg
+*.pgs
+*.pj
+*.pjs
+*.sc
+*.scs
+*.t2d/
+*.tg
+*.tgs
+*.toc
+*.tp
+*.tps
+*.vr
+*.vrs
+doc/*/*.html
+doc/*/*/*.html
+doc/*/*.ps
+doc/*/*/*.ps
+doc/man/brogw.1
+info/
+
+# Built by 'make-dist'.
+/MANIFEST
+make-dist.tmp.*/
+
+# Distribution directories and files.
+/brogw-[0-9]*/
+brogw-[0-9]*.[0-9]*.tar
+brogw-[0-9]*.[0-9]*.tar.bz2
+brogw-[0-9]*.[0-9]*.tar.gz
+brogw-[0-9]*.[0-9]*.tar.xz
+
+# Ignore Finder files on macOS.
+.DS_Store

NEWS

@@ -42,6 +42,33 @@ Entry specification.  Added 'Version', 'GenericName', 'Terminal' and
 'StartupNofify' fields to ensure proper behavior in graphical
 environments.
 
+** Introduced 'make-dist' tool.
+Added a new 'make-dist' script to automate the creation of
+distribution tarballs for Brogw.  This script ensures that only the
+appropriate files are included in the distribution, providing a clean
+and reliable way to package the project.
+
+Key features of the 'make-dist' script:
+
+- Supports optional compression with 'gzip', 'bzip2', or 'xz'.
+- Allows for incremental or patch distributions with the '--newer'
+  option.
+- Includes sanity checks for file consistency, such as ensuring
+  '.info' files are up-to-date with their '.texi' sources.
+- Automatically updates the 'MANIFEST' file when running under Git.
+- Provides options to skip certain steps, such as generating Info
+  files or creating a top-level 'ChangeLog'.
+
+Usage:
+
+To create a compressed tarball of the Brogw distribution, run:
+
+    ./make-dist --tar
+
+For more details and advanced options, use:
+
+    ./make-dist --help
+
 * Release 1.0, 2024-12-10
 
 Initial release.

README

@@ -2,7 +2,7 @@ Copyright (C) 2024 Free Software Foundation, Inc.
 See the end of the file for license conditions.
 
 
-This directory tree holds the source code for Brogw, a lightweight
+This directory tree holds version 1.1 of Brogw, a lightweight
 utility to route links to appropriate web browsers and profiles based
 on user-defined rules.  This tool is particularly useful for users
 managing multiple browsers or profiles for work and personal tasks.
@@ -39,7 +39,7 @@ construct the 'configure' script.
 
 The shell script 'autogen.sh' generates 'configure' and other files by
 running Autoconf (which in turn uses GNU m4), and configures files in
-the .git subdirectory if you are using Git.  If you want to use it,
+the '.git' subdirectory if you are using Git.  If you want to use it,
 you will need to install recent versions of these build tools.  This
 should be needed only if you edit files like 'configure.ac' that
 specify Brogw's autobuild procedure.
@@ -51,12 +51,25 @@ The file etc/config.conf.example provides a sample configuration file.
 After installation, copy it to your configuration directory and modify
 it to suit your needs.
 
+The file 'make-dist' is a shell script to build a distribution tar
+file from the current Brogw tree, containing only those files
+appropriate for distribution.  If you make extensive changes to Brogw,
+this script will help you distribute your version to others.
+
 There are several subdirectories:
 
 'src'       holds the C source code for the Brogw application.
 'etc'       holds miscellaneous architecture-independent data files Brogw
             uses, like example of the configuration file, desktop entry
             files for integrating Brogw with desktop environments.
+            The contents of the 'info', and 'doc' subdirectories are
+            architecture-independent too.
+'info'      holds the Info documentation tree for Brogw.
+'doc/brogw' holds the source code for the Brogw Manual.  If you modify the
+            manual sources, you will need the 'makeinfo' program to produce
+            an updated manual.  'makeinfo' is part of the GNU Texinfo
+            package; you need a suitably recent version of Texinfo.
+'build-aux' holds auxiliary files used during the build.
 'm4'        holds Autoconf macros used for generating the configure script.
 
 Note: If you modify files like configure.ac or Makefile.am, you may