[groff] 17/40: doc/doc.am: Add commentary and tweak code style.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 775425c742935cfcd1a17df4379fc54c0c325a75
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Nov 9 02:11:34 2022 -0600

    doc/doc.am: Add commentary and tweak code style.
    
    * doc/doc.am (doc/groff-man-pages.pdf): Add explanatory comment.
      Rearrange options to put prepreprocessor stuff first, formatter
      options next, and postprocessor options last.
---
 doc/doc.am | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/doc/doc.am b/doc/doc.am
index 9c2198683..ee18976bb 100644
--- a/doc/doc.am
+++ b/doc/doc.am
@@ -249,9 +249,14 @@ man-clean:
        $(RM) $(GROFF_MAN_PAGES_ALL)
 
 # Many pages use tbl, a few use eqn, and soelim(1) uses pic.
+#
+# We embed the fonts to (1) honor the current PDF standard, (2) ensure
+# consistent rendering of the document, and (3) exercise this feature of
+# gropdf.
 doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL) eqn pic tbl
-       $(GROFF_V)$(DOC_GROFF) -pet -Tpdf -P-e -mandoc -rC1 \
-         -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
+       $(GROFF_V)$(DOC_GROFF) -pet -mandoc -rC1 -rCHECKSTYLE=3 \
+         -Tpdf -P-e \
+         $(GROFF_MAN_PAGES1) \
          $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
          $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@