[Tcsh] tcsh.man improvements style question
kim at netbsd.org
Thu Dec 8 13:06:30 UTC 2022
Merged. Thank you!
On Thu, 8 Dec 2022 at 15:00, Luke Mewburn <luke at mewburn.net> wrote:
> Thanks for all the feedback.
> I've moved the changes to a fresh branch and submitted:
> On 22-12-08 09:40, Kimmo Suominen wrote:
> | On Thu, 8 Dec 2022 at 07:52, Jamie Landeg-Jones <jamie at catflap.org> wrote:
> | > ... trying to find out how to build the latest tcsh.man, I looked
> | > at the file BUILDING. Not only does it not mention how to build,
> | > it refers to the old nroff -mdoc man page.
> | I read through the BUILDING document and it seems accurate to me. It
> | talks about DESTMAN, tcsh.1, and "make install.man", which all are
> | still correct. The "nroff -mdoc" man page is the new page. The old
> | page was in "nroff -man" format.
> | Since we now have "configure" generate tcsh.man, building without
> | running "./configure" is no longer available for the manual page. I
> | think we should probably just deprecate the other [I]Makefiles (by
> | removing them).
> | > Also, the now ironically named file "NewThings" contains references
> | > to the old man->html script.
> | The NewThings file also has headings that refer to the version in
> | which each "new" thing appeared. The top-most (and thus most recent)
> | entry is for tcsh 6.08, which was released in October, 1998.
> | My guess would be that since we attempt to record all notable changes
> | in Fixes, the information in NewThings is just duplicating that. Maybe
> | we should deprecate NewThings as well, although I'm not sure if all of
> | its information can be found elsewhere. If anyone wants to fold it
> | into Fixes, that might be a good approach. Or otherwise just check if
> | there is information there that didn't make it to the manual page.
> | > I've got the man page working myself, so this isn't a cry for help,
> | > just a few suggestions!
> | Personally I'm always happy when people take a closer look at what is
> | going on. :)
> | Thanks for the feedback!
> | Cheers,
> | + Kimmo
More information about the Tcsh