[Tcsh] tcsh.man improvements style question

[Kimmo Suominen]

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:
>
>    https://github.com/tcsh-org/tcsh/pull/64
>
>
> regards,
> Luke.
>
>
> 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