On 12/02/2024 05:41, David Christensen wrote:
Apparently, shred(1) has both an info(1) page (?) and a man(1) page. The obvious solution is to write one document that is complete and correct, and use it everywhere -- e.g. DRY.
https://www.gnu.org/prep/standards/html_node/Man-Pages.html 6.9 Man Pages in "GNU Coding Standards"
In the GNU project, man pages are secondary. It is not necessary or expected for every GNU program to have a man page, but some of them do.
A standalone man page is not the same as a section in a document describing the whole bundle.
Notice that man uses direct formatting, not logical markup. E.g. there is no dedicated structure for links to other man pages. They were not designed as hypertext documents, they are to be printed on paper. In this sense texinfo is a more advanced format.
P.S. I admit that in some cases "man bash" may be more convenient for searching than an info browser.