I revisited groff_mom(7) recently. I didn't write it and I've always felt it was there for the sake of completeness. I'd like to revise it, scrapping the alphabetic listing of macros and strings entirely. All it does is partially duplicate the mom Quick Reference Guide (macrolist.html) and arranges it by alphabet, which isn't an improvement.
If getting rid of the section entirely is too radical, macrolist.html could be converted to man markup and inserted in its place, although I can't see how it would be useful. Mom macros really need the documentation that's in the html/pdf docs. It's enough for the manpage to give the entry points, IMO. Since groff_mom(7) isn't actually my baby, I'm asking for opinions before I go ahead. -- Peter Schaffter http://www.schaffter.ca
