Re: [Optional] versus parameters

2023-03-05 Thread John Gardner
Hi Branden, Documentation cowboys think they're being cool when they cram all this shit > onto one logical synopsis line. > Synopses for command-line programs (i.e., man pages allocated to sections 1 or 8) are only a small part of the problem. When documenting file formats, configuration files, s

Re: [Optional] versus parameters

2023-03-05 Thread G. Branden Robinson
Hi John, At 2023-03-05T20:24:48+1100, John Gardner wrote: > Documentation cowboys think they're being cool when they cram all this > shit onto one logical synopsis line. > > Synopses for command-line programs (i.e., man pages allocated to > sections 1 or 8) are only a small part of the problem. W

Re: [platform-testers] groff 1.23.0.rc3 with non-GNU make

2023-03-05 Thread Bruno Haible
On FreeBSD, NetBSD, and AIX, with the platform's 'make' program (which is good enough for building many GNU packages, even as a VPATH build), I get this build failure: $ make ... GEN font/devpdf/DESC GEN font/devpdf/Foundry make: don't know how to make ./shdeps.sed. Stop The reason

Re: [platform-testers] groff 1.23.0.rc3 on AIX

2023-03-05 Thread Bruno Haible
On AIX 7.2, for a 64-bit build, the environment variable AR needs to be set to 'ar -X 64', see https://gitlab.com/ghwiki/gnow-how/-/wikis/Platforms/Configuration . This is what I have done, and nevertheless the groff build fails: $ make ... GEN src/utils/lookbib/lookbib.1 make all

Re: [platform-testers] groff 1.23.0.rc3 on Solaris 10

2023-03-05 Thread Bruno Haible
On Solaris 10, I tried two compilers: * The Sun C, C++ compilers. This resulted in a build failure: CC -xarch=generic64 -O -DHAVE_CONFIG_H -I. -I.. -I./src/include -I../src/include -I../lib -I./src/include -I./lib -I/home/haible/prefix-x86_64/include -g -c -o src/devices/grodvi/dvi.o ../s

Re: [platform-testers] groff 1.23.0.rc3 on native Windows

2023-03-05 Thread Bruno Haible
On native Windows, I attempted a build with mingw and with MSVC 14. * With mingw (in 64-bit mode), the build failed here: ../src/include/symbol.h: In member function ‘long unsigned int symbol::hash() const’: ../src/include/symbol.h:61:25: error: cast from ‘const char*’ to ‘long unsigned int’ lo

Re: [platform-testers] groff 1.23.0.rc3 on Solaris 11

2023-03-05 Thread Bruno Haible
On Solaris 11.4, with the default PATH setting, the build succeeds but there are 95 test failures. Log is attached. The cause is that the 'grep' program in $PATH is old. Solaris 11.4 comes with two alternatives: /usr/xpg4/bin/grep /usr/gnu/bin/grep So I set PATH=/usr/xpg4/bin:$PATH With th

Re: [platform-testers] groff 1.23.0.rc3 on GNU/Hurd and NetBSD

2023-03-05 Thread Bruno Haible
On GNU/Hurd and NetBSD 9.0, the build succeeds, and there is 1 test failure: FAIL: src/roff/groff/tests/initialization_is_quiet.sh = testing "-m cs"; COMPAT="" FAIL src/roff/groff/tests/initialization_is_quiet.sh (exit status: 1) Find attache

Re: [platform-testers] groff 1.23.0.rc3 on FreeBSD

2023-03-05 Thread Bruno Haible
On FreeBSD 13.1, the build succeeds, but there is 1 test failure: FAIL: contrib/gdiffmk/tests/runtests.sh Find attached the log. Apparently non-numeric arguments get passed to the 'expr' program. === GNU roff 1.23.0.rc3: ./test-suite.log

Re: [platform-testers] groff 1.23.0.rc3 on Alpine Linux

2023-03-05 Thread Bruno Haible
On Alpine Linux 3.14 the build works fine, but there is one test failure: FAIL: contrib/gdiffmk/tests/runtests.sh Find attached the log file. The cause is apparently that the 'diff' program on this platform is not GNU diff, but diff from BusyBox. See: $ diff --version diff: unrecognized option:

Re: [platform-testers] groff 1.23.0.rc3 testing

2023-03-05 Thread Bruno Haible
On the following platforms, the build succeeded and all tests passed: - Linux Ubuntu 22.04 Debian 9.1 Debian 11.1 CentOS 8-stream CentOS Stream 9 OpenSUSE Leap 15.2 Manjaro 17 - macOS 12.5 - OpenBSD 7.2 with cc - Solaris 11.4 (with the appropriate $PATH) - Cygwin 2.9.0