Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: Modernizing Documentation format?




On 8/21/2025 12:30 PM, Clinton Bunch wrote:

On 8/21/2025 9:52 AM, Marc Chantreux wrote:
On Thu, Aug 21, 2025 at 08:33:01AM -0500, Clinton Bunch wrote:

yes ... the man request package is quiet old and that's why mandoc was
meant for! please provide me some part of the documentation that makes
you feel insecure so we can think and share from concrete exemples.
The FAQ.  And again, groff (whether it's ms, man, or mandoc) does not produce good HTML and that is important for a modern project. I've actually had to fix groff HTML output to fit a simple modern CSS design that will also look good on a text based web browser. Our own intro.ms.
Thinking more about your question.  How is mandoc going to make it easy to find the read command in the zsh manual to examine its options?  Using less or grep or the browser's find function is going to produce a lot of false positives. RST has the capability.  It would likely have to be added manually since as far as I noticed YODL doesn't do it.





Messages sorted by: Reverse Date, Date, Thread, Author