[Tcsh] tcsh(1) mandoc conversion completed

[Christos Zoulas]

Wonderful work Luke! Thanks so much for completing it. I agree with Kim, let's go with 3. mdoc is superior to man and there is no point on keeping duplicate info around.

Best,

christos

> On Nov 22, 2022, at 3:37 AM, Kimmo Suominen <kim at netbsd.org> wrote:
> 
> 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
> -- 
> Tcsh mailing list
> Tcsh at astron.com
> https://mailman.astron.com/mailman/listinfo/tcsh