The Unix Heritage Society mailing list
 help / color / mirror / Atom feed
From: segaloco via TUHS <tuhs@tuhs.org>
To: The Eunuchs Hysterical Society <tuhs@tuhs.org>
Subject: [TUHS] Manpage Analysis Repository (And V1/V2 roff Restorations)
Date: Mon, 03 Apr 2023 05:03:56 +0000	[thread overview]
Message-ID: <htluRlWC_ONMqHYtakpSVnz_LliMjaP9pVjvk5W8Q7Kzn3WDTvnQak5INcm51udRvY0rTGh0KiHLVgoWm0P_A1lEmVFCEDm2B9S3YPB9aVA=@protonmail.com> (raw)

Good evening or whatever time of day you find yourself in.  I've just finished the first tag in a git repository I've put together to track UNIX developments as documented in the manual.  In preparation for this, I also created restorations of the V1 and V2 manuals in roff based on the available V3 sources.  The repositories for all this can be found here:

https://gitlab.com/segaloco/mandiff
https://gitlab.com/segaloco/v1man
https://gitlab.com/segaloco/v2man

There are most certainly typos and minor discrepancies still to be found between sources and the PDF scans, but given all the cross-referencing involved I believe the manual restorations to be largely complete.

As for the mandiff repository, the commit log (which might shake up in format...) should capture relatively complete transactions of either a particular feature or comparable additions, deletions, or modifications.  That said, there may be little fixes in later commits of edits that really should've been in other ones, and the toc and index accuracy at any given commit is dubious at best.  However, the content of the pages themselves should be pretty well broken up in to noteworthy transactions.

If you find a problem or have a correction, feel free to send it my way or even better, open a pull request with an explanation for the change.  This repository will accrete more UNIX releases as time goes on, with a first goal being getting to V6, after which the fragmentary pathways will be a little harder to reconcile to a single informative trunk.  I might start branches at that point.

By the way, in this process I found that the V2 manual scanned by Dennis Ritchie [1] contains references to nroff(I) in the TOC and permuted index, but the page may not have been in his copy.  Given this, just to not hang up on it, I simply dropped in the V3 page with a note about this in the BUGS section.

1 - https://www.tuhs.org/Archive/Distributions/Research/Dennis_v2/v2man.pdf 

- Matt G.

                 reply	other threads:[~2023-04-03  5:04 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='htluRlWC_ONMqHYtakpSVnz_LliMjaP9pVjvk5W8Q7Kzn3WDTvnQak5INcm51udRvY0rTGh0KiHLVgoWm0P_A1lEmVFCEDm2B9S3YPB9aVA=@protonmail.com' \
    --to=tuhs@tuhs.org \
    --cc=segaloco@protonmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).