Bertrand --
On Thu, Dec 06, 2018, Bertrand Garrigues wrote:
> As the html doc is de facto the current reference doc for mom (again,
> I'm not arguing whether it's good or bad), I think the paragraph "4.6
> mom" in groff documentation should be modified.
Changed entry per your request:
diff --git a/doc/groff.texi b/doc/groff.texi
index a6d1260..4526d3c 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4649,11 +4649,26 @@ command line).
@c XXX documentation
@c XXX this is a placeholder until we get stuff knocked into shape
-See the @cite{groff_mom(7)} man page (type @command{man groff_mom} at
-the command line), which gives a short overview and a link to its
-extensive documentation in HTML format.
+Complete documentation for the @file{mom} macros is in html format.
+@display
+@file{/usr/share/doc/groff-base/html/mom/toc.html}
+@end display
+
+An online version is also available.
+
+@display
+@uref{http://www.schaffter.ca/mom/momdoc/toc.html}
+@end display
+PDF features and usage are covered in
+
+@display
+@file{/usr/share/doc/groff-base/pdf/mom-pdf.pdf}
+@end display
+
+See also @cite{groff_mom(7)} (type @command{man groff_mom} at the
+command line).
@c =====================================================================
@c =====================================================================
I'm not sure whether it's okay for entry points to local files to
have literal paths or whether they need to be rendered symbolically
for build/install purposes, so I won't commit without your go-ahead.
> I think the online html doc could also be mentioned in
> https://www.gnu.org/software/groff/; in the "Mission Statement"
> paragraph, a .mom document is given as an example without a single word
> on what the mom package is.
Done, discretely.
--
Peter Schaffter
http://www.schaffter.ca
