Platon Technologies
neprihlásený Prihlásiť Registrácia
SlovakEnglish
open source software development oslavujeme 10 rokov vývoja otvoreného softvéru! Utorok, 18. február 2025
O nás
Magazín
Otvorený softvér
CVS
Služby
Index  »  Projekty  »  Platon.SK  »  Dokumentácia  »  HTML

Kapitola 4. Iné systémy pre dokumentáciu softvéru

Existujú aj ďalšie systémy pre dokumentáciu softvéru. O žiadnom z týchto systémov sa nedá povedať, či patrí do skupiny používateľskej alebo vývojárskej dokumentácie. Každý z nich v dobe svojho vzniku sledoval svoj konkrétny cieľ a bol takpovediac šitý na mieru žiadanému a predpokladanému účelu. Sú to napríklad:

PerlDoc je dokumentačný systém používaný komunitou okolo skriptovacieho jazyka Perl. Jeho veľkému rozvoju dopomohla najmä existencia CPAN - archívu znovupoužiteľného kódu pre Perl. Dokumentácia sa píše priamo do zdrojových kódov pomocou špeciálnych POD značiek. Používatelia si ju potom prezerajú pomocou systémového Perl skriptu perldoc. Existuje mnoho konvertorov PerlDoc dokumentácie do rôznych výstupných formátoch, napr. HTML.

Dokumentačný systém systémových manuálových stránok (man stránky) vznikol ešte v časoch vzniku operačného systému UNIX a jej dodnes aktívne vyvíjaný. Pre formátovanie výstupu sa používa program nroff a stránky sa prezerajú príkazom man. Vyskytujú sa takmer na každom UNIX alebo GNU/Linux systéme. Na disku je uložená každá man stránka osobitne a zkomprimovaná. Taktiež existujú nástroje na ich konverziu do iných formátov.

Výsledkom hnutia GNU (GNU is not UNIX) je info dokumentácia, ktorá sa snaží nahradiť používané manuálové stránky. Tento dokumentačný systém sa však kvoli komplikovanému ovládaniu a nevábnemu vzhľadu neujal v takej miere ako si jeho tvorcovia predstavovali. Väčšina GNU nástrojov však obsahuje obsiahlejšiu a podrobnejšiu dokumentáciu vo svojich info stránkach ako v príslušných man stránkach. Stránky sa prezerajú príkazom info.


Copyright © 2002-2006 Platon Group
Stránka používa redakčný systém Metafox
Na začiatok · Odkazový formulár · Prihláška
Upozorniť na chybu na PLATON.SK webstránke · Podmienky použitia · Ochrana osobných údajov