Dokumentacja (długie, ale przeczytajcie proszę)

[Jacek Konieczny]

On wto, 02 lis 1999, Ziemek Borowski wrote:
 
> >     * From: "Jacek Konieczny" <jajcus w zeus.polsl.gliwice.pl>
> >     * Date: Mon, 1 Nov 1999 15:15:05 +0100
> >       <Pine.LNX.4.10.9911010055510.1221-100000 w rudy.mif.pg.gda.pl>; from
> 
> >Mnie się ten pomysł wogóle nie podoba. A co przy uaktualnieniach
> >dokumentacji? W końcu ludzie w PLD zajmowali by się tylko dokumentacją.
> 
> Oj tak. 
> 
> >A co do dokumentacji, którą musimy zrobić do PLD - tu trzeba określić
> >standard i sie jego trzymać.
> >Mnie osobiście na JWL'99 przekonano do PDF-a, choć ma on swoje wady
> >(trudno przeszukiwać). Napewno SGML jest dobrym kierunkiem - ale co
> >dalej to nie jestem pewien.
> 
> Rozróżnijmy to w czym tworzyć dokumentację od tego w czym ją dawać
> użytkownikom. Do tego drugiego PDF się świetnie nadaje. 
> Ale tworzenie? W tej chwili implikuje pratycznie tylko TeXa w różnych
> odmianach. IMHO należy o tym zapomnieć (TeX i LaTeX ma mnóstwo zalet, 
> i jedno podstawową wadę: jest potwornie bałaganiarski i hackerski). 

Do tworzenia tylko SGML.
A dalej to np. :
SGML -> LaTeX -> PDF

To chyba da sie zrobic. I otrzymujemy dokument gotowy do ogladania
(bardziej niz PostScript) i do drukowania. Jedynie problem z
przeszukiwaniem.
Many tez powinny zostac, bo man, apropos i whatis to podstawowe
narzedzia. Texinfo w sumie nie daje nic ponadto co ma HTML czy PDF.

Pozdrowienia,
       Jacek

-- 
+---------+--------------------------------------------------------+
!      ,  !            Jacek Konieczny, Gliwice, Poland            !      
! Jajcus  !   email: jajcus w zeus.polsl.gliwice.pl, jacek w kde.org   !
!         ! ICQ# 7149127                           WWW: none (yet) !
+---------+--------------------------------------powered-by-Linux--+