Nemám srovnání s HP-UX, ale třeba i současné Open a FreeBSD mi přijde taky fajn a vždycky se mi to líbilo, jak to mají udělané.
Jen si nemyslím, že jde nějak férově porovnávat kompletní systémy (jádro + userland) s typickými distribucemi Linuxu.
To co se řeší ve zprávičce, jsou man. stránky jen od jádra (obsluha linkeru, popis syscallů atp.). V distribuci jsou typicky ještě hromady dalších man. stránek z ostatních balíčků a nezávislých projektů, ať už systemd (freedesktop), coreutils (GNU), plus samozřejmě všechny další aplikace a služby, co má kdo přidané do systému. V porovnání s těmi kompletními systémy je úroveň dokumentace a její aktuálnost do jisté míry neříditelná z pohledu distribuce.
Další věc je, že u spousty projektů se ty klasické man. stránky moc neřeší a pokud už tam něco je, tak je to třeba jen readme nebo nějaký markdown dokument kdesi v /usr/share/doc.
I když zas když to vezmu upřímně za sebe, málokdy jsem dnes offline, aby mě to nějak zásadně omezovalo. Základ systému se určitě hodí mít v man stránkách. Nicméně u stovek balíčků, které se mi tam natáhnou jako závislosti, mě spíš dnes víc než chybějící man. stránky vadí, když jsou u daného balíčku blbě vyplněná metadata. Jako špatné url projektu, nebo tam vůbec není žádný changelog, jak je typické u spousty software z repozitářů třetích stran.
Chápu, že třeba u nějakého proprietárního sw tam úplně nechtějí vyklopit git log, ale aspoň pár odrážek s rozdíly mezi verzemi, by mi přišlo užitečné.
7. 9. 2024, 19:54 editováno autorem komentáře
mám rád man stránky hlavně z důvodu, že v nich mohu hledat najednou a popisují stejnou verzi, která je nasazena, občas si online vyhledat informaci ke konkrétní verzi SW je dost obtížné, každý projekt to má jinak.
Z toho stejného důvodu vítám i -src balíčky, kde mohu rovnou hledat v odpovídajícím zdrojovém kódu.
Jedinej zpusob ktery se mi kdy pro seriozni cli aplikace na dlouhy beh osvedcil je to secko generovat z jedinyho source. tzn:
pgm -h/--help (+ -v/--verhose pro vetsi info) generuje plaintext help. A umi navic generovat i man formatted text, ktery napriklad behem buildu spusti sam sebe (ve sve verzi) a vygeneruje do release tarballu manpage. Pridat generovani reame.md a pouzit hod do release docu/titulnmi stranku projektu je jednoducha tresnicka na dortu. Jednotlive readme se muzo malinko lisit. Vetsinou man page vychazi na ten -h ve verbose mode, a readme.md na -h ve -vvv (very verbose mode).
Jednou to pridam no jcmd a clapu....