Documentation (Re: [PHPLIB-DEV] Changes to the CVS) From: Alexander Aulbach (ssilk <email protected>)
Date: 04/13/00

On Thu, 13 Apr 2000, Kristian Koehntopp wrote:

}In netuse.lists.phplib you write:
}>The amount of code of the ooh replacement has grown rapidly from
}>about 17k to 90k. Most of this is due to the inline
}>documentation.
}
}As PHP3 is - unlike Java or PHP4 - an interpreted language, I
}think it is worthwhile to separate this.

Hum, by the way: I think the documentation is one of the most important
problems of PHPLIB. Ok, ok, I must take me by my own nose (query_sql
documentation is a desert :-/ ).

But there is a reason: I have no idea how to write the documention in sgml
without a helping tool. Are there any editors for Linux? Because writing
this with an editor like vi, joe or emacs without any help is really a
pain. And if this is with me, perhaps others have the same problem.

I'm really one of those guys which want to document everything, but the
afford for the syntax and the surroundings must be kept in a limit. And
so, the programm-code is currently the best place to keep the
documentation.

PS: How about converting it to docbook? I think the chance that there are
tools for it is much better... 

-- 

SSilk - Alexander Aulbach - Herbipolis/Frankonia Minoris - (0931)22032

-
PHPLIB Developers Mailing List. Send messages to <phplib-dev <email protected>>.
To unsubscribe, send "unsubscribe" to <phplib-dev-request <email protected>> in
the body, not the subject, of your message.