| version 1.1, 2002/12/01 22:56:56 |
version 1.2, 2002/12/11 18:20:39 |
|
|
| |
<!-- $Platon: phpWebFileManager/doc/sgml/changelog.sgml,v 1.3 2002/12/03 20:47:37 nepto Exp $ --> |
| |
|
| <chapter id="others-doc-sys"><title>Iné systémy pre dokumentáciu softvéru</title> |
<chapter id="others-doc-sys"><title>Iné systémy pre dokumentáciu softvéru</title> |
| |
<para> |
| |
|
| <para>bar foo</para> |
Existujú aj ďaľšie systémy pre dokumentáciu softvéru. O žiadnom z týchto |
| |
systémov sa nedá povedať, či patrí do skupiny uží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<!-- desirable --> a predpokladanému |
| |
účelu. Sú to napríklad: |
| |
|
| </chapter> |
<itemizedlist spacing="normal"> |
| |
<listitem><simpara><application>PerlDoc</></simpara></listitem> |
| |
<listitem><simpara><application>man</></simpara></listitem> |
| |
<listitem><simpara><application>info</></simpara></listitem> |
| |
</itemizedlist> |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
<ulink url="http://www.perldoc.org/"><application>PerlDoc</></> je dokumentačný |
| |
systém používaný komunitou okolo skriptovacieho jazyka <ulink |
| |
url="http://www.perl.org/"><acronym>Perl</></>. Jeho veľkému rozvoju dopomohla |
| |
najmä existencia <acronym><ulink url="http://www.cpan.org/">CPAN</></> - archívu |
| |
znovupoužiteľného kódu pre <acronym>Perl</>. Dokumentácia sa píše priamo do |
| |
zdrojových kódov pomocou špeciálnych <acronym>POD</> značiek. Užívatelia si ju |
| |
potom prezerajú pomocou systémového <acronym>Perl</> skriptu |
| |
<command>perldoc</>. Existuje mnoho konvertorov <application>PerlDoc</> |
| |
dokumentácie do rôznych výstupných formátoch, napr. <acronym>HTML</>. |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
Dokumentačný systém systémových manuálových stránok (<application>man</> |
| |
stránky) vznikol ešte v časoch vzniku operačného systému <productname>UNIX</> a |
| |
jej dodnes aktívne vyvíjaný. Pre formátovanie výstupu sa používa program |
| |
<application>nroff</> a stránky sa prezerajú prikazom <command>man</>. Vyskytujú |
| |
sa takmer na každom <productname>UNIX</> alebo |
| |
<productname><acronym>GNU</>/Linux</> systéme. Na disku je uložená každá |
| |
<application>man</> stránka osobitne a zkomprimovaná. Taktiež existujú nástroje |
| |
na ich konverziu do iných formátov. |
| |
|
| |
</para> |
| |
<para> |
| |
|
| |
Dokumentácia <application>info</> je výsledkom snahy hnutia <acronym>GNU</> (GNU |
| |
is Not <productname>UNIX</>) 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 |
| |
<acronym>GNU</> nástrojov však obsahuje obsiahlejšiu a podrobnejšiu dokumentáciu |
| |
vo svojich <application>info</> stránkach ako v príslušných <application>man</> |
| |
stránkach. Stránky sa prezerajú príkazom <command>info</>. |
| |
|
| |
</para> |
| |
</chapter> |
| |
|