gbranden pushed a commit to branch master
in repository groff.
commit 48b88549721f8d4a9ecb37b7070c19872eaaa8dd
Author: G. Branden Robinson <[email protected]>
AuthorDate: Wed Jan 21 10:49:02 2026 -0600
HACKING: Add tips on clean *.am file composition.
---
HACKING | 8 ++++++++
1 file changed, 8 insertions(+)
diff --git a/HACKING b/HACKING
index b43d894d5..568479e76 100644
--- a/HACKING
+++ b/HACKING
@@ -44,6 +44,14 @@ A document explaining the basics of GNU Automake and its
usage in groff
is available in 'doc/automake.mom'; peruse a PDF rendering in
'doc/automake.pdf' in your build tree.
+Tips:
+* Don't define macros, including those ending in `_srcdir` or
+ `_builddir`, unless you need to interpolate them elsewhere in the *.am
+ file.
+* If you need to define a `_builddir` macro, give it a plain literal
+ value; do _not_ lead it with an interpolation of `top_builddir` or
+ anything else. Failure to heed this advice leads to out-of-tree build
+ failures with BSD Make.
Testing
-------
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
