On Monday, 19 February 2024 10.32.23 WET Patrick O'Callaghan wrote:
No, I'd rather there was a policy of requiring man pages, along
with
the other policies regarding what is accepted in Fedora.
I my humble opinion man pages are the wrong answer for the right problem.
That is why more and more packages, in this case command line interface
programs, use inline help. There are several programs where you get help with
the --help but there is no man page. Another challenge is to need to make into
sync between both formats.
Man pages are not portable across different operating systems, they come from
unix tradition, they suffer from several idiosyncratic, pardon historical,
choices. They do not have hyper-link capabilities and so on.
The raw format looks to me as Word Perfect (from the 80's) that was used by
George R.R. Martin to write the "Game of Thrones". :-)
So I would prefer for application to have better inline help even if that is
not a man page.
Regards,
--
José Abílio Matos