[Tcsh] tcsh(1) mandoc conversion completed

[Kimmo Suominen]

Hi Luke,

Thanks a lot! I would go with #3:

- I'm not keen on maintaining two copies of the manual page (overhead!).
- Modern systems all support mdoc and it is way nicer.
- While tcsh.man2html is cool, I don't think it gets much use.
- It should be easy enough to produce HTML from mdoc (not that it is
interactive).

Cheers,
+ Kimmo


On Tue, 22 Nov 2022 at 09:57, Luke Mewburn <luke at mewburn.net> wrote:
>
> Hi tcsh list,
>
> I've completed the mdoc conversion of tcsh.man.new (that Christos
> started a few years ago).
> tcsh.man.new formats nicely as text (ascii or UTF-8) as well as PS/PDF.
> I haven't tried HTML yet.
>
> I also fixed various editorial issues in tcsh.man (the currently
> installed manual in man.old format).
>
> The changes are in a branch in my github fork
>         https://github.com/lukem/tcsh/tree/lukem/man-fixes
>
> The differences between tcsh.man and tcsh.man.new are mostly
> minor editorial and formatting issues, especially where
> the mdoc format is nicer. I did convert to Oxford comma
> in tcsh.man.new and didn't backport that to tcsh.man.
>
> I compared the differences with:
>         nroff -Tascii -c -man tcsh.man | col -b > ! out.old ;
>         nroff -Tascii -c -man tcsh.man.new | col -b > ! out.new ;
>         git diff --no-index --color-words out.old out.new
>
>
> Before I submit a pull request, a question to Christos, Kimmo
> and the community:
>
> Should we continue to maintain and install both tcsh.man and tcsh.man.new ?
>
>         1. Maintain both tcsh.man and tcsh.man.new, continue to only install
>         tcsh.man by default, maintaining tcsh.man2html for the man.old.
>
>         2. Maintain both tcsh.man and tcsh.man.new, change to only install
>         tcsh.man.new, maintaining tcsh.man2html for the man.old.
>         Maybe rename tcsh.man to tcsh.man.old ?
>         Maybe rename tcsh.man.new to tcsh.man or tcsh.mandoc ?
>
>         3. Migrate to tcsh.man.new, deprecate tcsh.man and tcsh.man2html.
>         Rename tcsh.man.new to tcsh.man.
>
>
> I have some other editorial improvements and refactoring I'd like to
> do, but I'd rather wait until there's a direction for the manual page
> first.
>
>
> regards,
> Luke.
>
>
> PS: I realised it's been nearly 30 years since my first contribution to tcsh!
> Time flies.
> --
> Tcsh mailing list
> Tcsh at astron.com
> https://mailman.astron.com/mailman/listinfo/tcsh