search

djcb / mu

maildir indexer/searcher + emacs mail client + guile bindings
http://www.djcbsoftware.nl/code/mu
GNU General Public License v3.0
1.61k stars 389 forks source link

Try to improve overall manual page typesetting #2728

Closed Tristan02d closed 2 months ago

Tristan02d commented 2 months ago

I tried to make the typesetting of the numerous manual pages more consistent and more compliant to the standards described in man-pages(7). There are quite a lot of changes I think, hence I tried to scatter them in different commits to make it easier to figure out what is going on and to allow picking only certain changes, in case some of them are not wanted.

There is one major thing to notice. In order to get the proper output for manual pages references, and synopses, I used zero width spaces which I learned about here. This is admittedly a little hacky, there might be a better way to get the same outputs. It renders fine in standard manual pages, but if you plan to export the Org sources to other formats, I do not know what it may look like.

djcb commented 2 months ago

Thank you, nice work! I'm merging this, thanks about the note re: zero-width-space, I'll keep that in mind!

Tristan02d commented 2 months ago

Nice, thank you ! Apart from synopses, the only zero-width space is in the man-link macro, so you can easily replace it if needed.