dss/Makefile, branch master

Provide a static binary.

2024-07-02T16:52:03Z

For users which can't be bothered to use git or compile from source.

build: Move m4-only definitions to separate file.

2024-07-02T16:52:03Z

We currently pass a number of variables to m4 by specifying command line options of the form -D var=val. This approach makes the output of "make V=1" very verbose due to the three multi-line descriptions. To addresses this issue, introduce defs.m4 which contains one m4 macro definition for each former make variable. The end result should be identical. We tweak the M4 make variable to always read defs.m4 before the first regular input file so that the suite and the web page see the definitions. The third user of the former make variables is the README phony target. To convert this as well, we rename the README file to README.m4 and adjust the rule of the README phony target to run m4 on this file. Switch to saner m4 quoting characters while at it.

Move snapshot distribution explanation to separate man section.

2024-07-02T16:52:03Z

Since the new section contains a table, we have to tell groff to run the tbl preprocessor to generate the html version of the man page. We now pass -I image to the groff postprocessor so that the png image file gets a predictable name. We'd love to pass --image‐directory=build/ to place the png file in the build directory, but this also creates html like , which does not work because index.html is in build/. Change the cwd to the build directory to work around this.

Add phony targets distclean and maintainer-clean.

2024-07-02T16:52:03Z

With the patch applied, "make clean" keeps files generated by lopsub and m4, "make distclean" removes the build directory, and "make maintainer-clean" removes all untracked files except Makefile.local.

build: New phony target "www".

2024-07-02T16:52:03Z

This saves some typing as the simple "make www" now builds index.html and the html version of the man page.

build: Move recipe for index.html to proper place.

2024-07-02T16:52:03Z

There's no reason for this to be after the README stuff.

build: Generate intermediate files in build/.

2024-07-02T16:52:03Z

This way the intermediate files don't clobber the top level of the working directory. Also the clean phony target becomes simpler.

No longer include NEWS in index.html.

2024-07-02T16:52:03Z

It's not like the dss project saw lots of news lately, and the old news items only clutter the web page. This removes the last invocation of markdown(1), making the build independent of the discount converter. We keep maintaining the NEWS file in the repo, however. It's just no longer part of the web page.

index.html: Simplify make rule.

2024-07-02T16:52:03Z

This avoids index.html.in and parses index.html.m4 only once.

Kill INSTALL.

2024-07-02T16:52:03Z

Move the installation instructions to index.html.m4 and the configuration bits to the new examples section of the man page. Streamline the installation instructions and recommend to install the debian package of lopsub.