Vlákno názorů k článku
Údržba linuxových manuálových stránek byla pozastavena od Libor Chocholatý - Nejlepší manages, co si pamatuju, měl HPUX. Škoda,...

Nejlepší manages, co si pamatuju, měl HPUX. Škoda, že Linuxové jsou tak strohé. Asi bych byl ochoten na jejich tvorbu (nejlépe ve stylu HPUX) přispívat.

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.

Docela by mne zajímalo kolik programátorů dneska ještě umí manuálové stránky psát. Přijde mi, že ve většině případů se nejsou schopni přehoupnout přes README.md na githubu.

Dal bych palec, ale střelil bych se tím do vlastního kolene :-D