@sir It dates from approximately the same five minute interval in. which the WWW was born. Info should simply cede to WWW & HTML IMO.
And stop fucking deprecating manpages.
@email@example.comManpages serve a specific function: a command (or library or file) reference. Info ... doesn't serve that role.
Manpages are independent of reader. Info is tied directly to the info reader.
Manpages can *also* be rendered into multiple formats. 'man -Tps' for postcript output, ps2pdf will get you the obvious.
Debian's dwww delivers all of this (and more) over a web interface locally or (if you chose) remotely.
@amiloradovsky At the shell, rather than read info in either the user's defined $PAGER *or* a standard hypertext reader, THE DEFAULT ACTION is to use a reader _which is used for info and only for info_.
Which means its navigation is utterly foreign.
Again: dropping that for HTML and and HTML-capable reader (e.g., any GUI or console web browser) would be a win.
Info is an alternate, special-purpose, single-use hypertext format. It really should die.
@dredmorbius @craigmaloney @sir I'm advocating for info(1), because I'm now a long-term'ish #Emacs user, and have no problem reading info pages, often do it right in Emacs.
Yet, I can't stand long man-pages, where there should be a proper ToC and hyperlinks, but aren't… *they* should die.
I'm also pretty happy with the static (X)HTML, generated from the same #Texinfo sources.
And e.g. coreutils have their man-pages generated with help2man from .texi's, no?
@amiloradovsky An awful lot of manpages for GNU utilities are actually provided by Debian, which has a (non-release-critical) requirement that *all* system executables have a manpage.
They don't quite manage that, but *most* do, and they're generally better than the help2man stuff, though occasionally that's all you get.
There are tools (ImageMagick comes to mind) for which the manpages are entirely deficient.
MacOS also quite routinely has abysmal manpages.
@amiloradovsky I will die on the manpages hill, and am getting tired of reiterating how and why.
You're also misunderstanding or misrepresenting my argument. I've explicitly stated that manpages SHOULD have supplemental documentation, and do.
I was going to add to the thread: Debian offers manpages, texinfo, HOWTOs, RFCs, Linux Gazette (when it existed), and substantial other docs (the tetex docs, in PDF, come to mind).
All through dwww:
@dredmorbius @craigmaloney @sir TBH, I didn't manage to extract much of specific information from your reiterated arguments, they seem to be mostly a rant.
Nevertheless, I'll keep you in mind, and try to keep the man-pages output available and in a good shape.
I'm not a huge fan of Debian, but still, thanks for the link, I'll look into what DWWW has to offer.
[Notice Regarding the Transfer of the mstdn.jp / mastodon.cloud Services] We have received several inquiries showing interest in a transfer following the announcement of the end of the mstdn.jp and mastodon.cloud services. As a result of subsequently evaluating the situation and making preparations, we have decided that the corresponding services will be transferred to Sujitech, LLC. on June 30. Thank you.