summaryrefslogtreecommitdiff
path: root/HACKING
Commit message (Collapse)AuthorAgeFilesLines
* HACKING: Stop saying automake.pdf isn't installed.G. Branden Robinson2023-04-011-2/+1
| | | | ...because it is.
* [man]: Improve portability of a test.1.23.0.rc3G. Branden Robinson2023-02-201-0/+9
| | | | | | | | | * tmac/tests/an_TS-do-not-keep-tables-when-cR-set.sh: Improve portability of script by using shell constructs instead of the nonstandard GNU coreutils 'seq' utility. Resolves test failure on Solaris 10. * HACKING: Document this problem.
* [ms]: Port a test to Solaris 11 sed.G. Branden Robinson2023-02-171-1/+17
| | | | | | | | * tmac/tests/s_TC-works-with-percent-in-custom-titles.sh: Put newlines after opening braces in sed scripts. macOS and GNU sed tolerate their absence, but this sed does not. * HACKING: Document this problem.
* HACKING: Clarify item.G. Branden Robinson2023-02-151-1/+1
|
* [tmac]: Work around macOS od (mis-)behavior.G. Branden Robinson2023-02-131-0/+13
| | | | | | | | | | | | | | | | * tmac/tests/latin2_works.sh: * tmac/tests/latin5_works.sh: * tmac/tests/latin9_works.sh: Port to work around macOS's apparently POSIX non-conforming 'od' command. Use single-byte octal output format instead of "character", and update test expectations accordingly. Apparently gratuitously, macOS also puts more spaces after the octal address field when using this output format. * HACKING: Document, and elaborate upon, this problem. Also distinguish identical test failure diagnostics. ANNOUNCE: Remove caveat about automated test failures on macOS.
* HACKING: Offer advice, resource for POSIX Issue 4.G. Branden Robinson2023-02-131-1/+7
|
* [mdoc]: Port a test to work with macOS sed.G. Branden Robinson2023-02-131-2/+12
| | | | | | | | | | | * tmac/tests/doc_heading-font-remapping-works.sh: Put semicolons between commands and closing braces in sed script. Put each of multiple closing braces on a separate input line, because macOS doesn't accept them otherwise. Resolves test failure observed on macOS. * HACKING: Document the closing brace sequence problem. * ANNOUNCE: Drop notice of failing test case, now resolved.
* [man]: Port a test to work with macOS sed.G. Branden Robinson2023-02-131-0/+20
| | | | | | | | | | | * tmac/tests/an_TS-adds-no-vertical-space.sh: Put semicolons between commands and closing braces in sed script. Separate command stream into multiple '-e' expressions, breaking them after branch and label commands. Resolves test failure observed on macOS. * HACKING: Document the above problems. * ANNOUNCE: Drop notice of failing test case, now resolved.
* [groff]: Accommodate macOS od behavior in test.G. Branden Robinson2023-02-131-0/+15
| | | | | | | | | | | * src/roff/groff/tests/some_escapes_accept_newline_delimiters.sh: Weaken regexes in two test cases to accommodate excessive output from macOS's 'od' command. Resolves test failure seen on macOS. * HACKING: Add section "Writing Tests" and document the above since this is the second time I've cracked my shin on this. * ANNOUNCE: Drop notice of failing test case, now resolved.
* HACKING: Drop extraneous word.G. Branden Robinson2022-10-061-1/+1
|
* HACKING: Point reader to "MANIFEST".G. Branden Robinson2022-09-021-0/+2
|
* FOR-RELEASE, HACKING, INSTALL.REPO, README: Tweak.G. Branden Robinson2022-05-261-5/+5
| | | | | | | | | | | | | | | | | | | * FOR-RELEASE: Split-off ChangeLog files need to be added to the distribution archive. * HACKING: Clarify non-ChangeLoggable items. Generally, an item that resolves a Savannah ticket should be ChangeLogged even if it would not normally meet that threshold. Also clarify a point in an example; we certainly expect table entries containing the word "FOOBAR" to show up that way when formatted. * INSTALL.REPO: Correct prose description of what to do with unpacked "gnulib" snapshot. * README: Clarify that the '.version' file is produced by the build process. Clarify origins and provenance of various groff components. Use a more appropriate URL for the Savannah issue tracker. Lightly recast.
* HACKING: Add developer-facing advice document.G. Branden Robinson2022-05-241-0/+70
This scoops up the 'automake.mom' material just dropped from 'INSTALL.REPO', and summarizes a couple of discussions from the mailing list over the past 2 years or so.