[bug #61900] ship groff-man-pages.pdf

[G. Branden Robinson]

Update of bug #61900 (project groff):

                  Status:             In Progress => Fixed                  
             Open/Closed:                    Open => Closed                 
         Planned Release:                    None => 1.23.0                 

    _______________________________________________________

Follow-up Comment #1:


commit 52eeb52073806d09e24e35b38ba586d0b4d1f6e1
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Tue Jan 25 00:00:19 2022 +1100

    [man pages]: Ship compilations in UTF-8 text, PDF.

    Localization support and the resolution of Savannah #61266 have made it
    practical to batch-render all of groff's man pages as a single giant
    document.  Provide PDF and UTF-8 text (with ECMA-48 escape sequences,
    but not the italic attribute or OSC 8 sequences).

    Reasons for this addition include: {1} it is now possible, whereas I
    don't believe it was in any previous groff release; {2} many people
    still don't realize how much more pleasant reading typeset man pages can
    be (while a subjective assessment, I'm not alone[1]); {3} providing
    these forms permits full-text searching of groff's entire man page
    corpus via the PDF viewer or a pager like "less -R", the latter without
    sacrificing the style variations of the text that aid the reader to
    comprehend the material; {4} sentimentally, it honors the 50th
    anniversary of the first Unix manual (dated 3 November 1971)
    <https://www.bell-labs.com/usr/dmr/www/1stEdman.html>.

    * doc/doc.am (PROCESSEDDOCFILES): Add
      'doc/groff-man-pages.{pdf,utf8.txt}'.

      (GROFF_MAN_PAGES{1,2,3}): Add new macro storing names of all man pages
      generated in the build tree.  Motivate the reason for 3 variables in a
      comment (it's due to groff locale switching).

      (GROFF_MAN_PAGES_ALL): Add convenience macro for use in dependency
      lists required by...

      ('doc/groff-man-pages.{pdf,utf8.txt}'): ...these targets.  Generate
      pages with the lint dial turned all the way up.

    Fixes <https://savannah.gnu.org/bugs/?61900>.

    [1] "The manual was intended to be typeset; some detail is sacrificed on
    terminals." (man(1), _Unix Time-Sharing System Programmer's Manual_,
    Eighth Edition, Volume 1, February 1985)

    Also bump copyright range.  Today's commit to the file should do it for
    2022; for 2021, see below.  It wasn't _all_ mindless churn, I promise.

    $ COLUMNS=72 git diff --stat 'HEAD@{2020-12-31}' 'HEAD@{2021-12-31}' \
     -- doc/doc.am
     doc/doc.am | 316 +++++++++++++++++++++++++++++++----------------------
     1 file changed, 188 insertions(+), 128 deletions(-)



    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?61900>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/