nmh-workers
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Unsupported nroff macros on MacOS X


From: Ken Hornstein
Subject: Re: Unsupported nroff macros on MacOS X
Date: Mon, 03 Apr 2023 16:30:20 -0400

>>In a more practical sense, I am not sure there is anyone with the free
>>cycles to convert the current man pages into some other markup language.
>
>This seems like the sort of thing that should be possible to automate, and
>that question has been raised before.  A quick search turned up the
>following, among others:
>
>   
> https://stackoverflow.com/questions/13433903/convert-all-linux-man-pages-to-text-html-or-markdown
>   https://jeromebelleman.gitlab.io/posts/publishing/manpages/

I am ... concerned about depending on pandoc, because of this:

  Pandoc is available in lxplus, aiadm and most RPM repositories. It's
  written in Haskell, which means it relies on hundreds of megabytes of
  library dependencies.

That screams to me, "this is going to bitrot at some point in the
future".  There seems to be a wealth of man/mdoc/roff converters and I
feel like there are always going to be some kind of nroff converter, at
least until Y2038..  I have no objection to Markdown but I'm not sure
what it would gain us exactly, other than maybe someone younger than 35
could edit the documentation.

--Ken



reply via email to

[Prev in Thread] Current Thread [Next in Thread]