[nem-pl] Dokumentacja

Dawid Duda daveduda at plusnet.pl
Wed Nov 19 01:11:22 CET 2003


Moze by tak pisac xml'a o ustalonym formacie, takim dostosowanym do 
struktury programow w nemerle, i napisac do niego xsl'a ktory by go 
przerabial powiedzmy na razie na html'a, a potem mozna by to przez rozne 
narzedzia wpuszczac do innych formatow? Wtedy w przyszlosci narzedzie do 
generowania dokumentacji generowaloby takiego xml'a jakiego teraz by sie 
pisalo recznie.

To mogloby miec np. postac:

<module name="List" file="list.n">
	<variant name="...">
	...
	</variant>

	<function name=...>
		<param name="...">
	</function>
</module>

i tak dalej, kazdy wie jak by to mialo wygladac. Musimy sie na cos 
zdecydowac, bo reczne przegladanie zrodel jest bez sensu. No i w ten 
sposob od razu mielibysmy specyfikacje wyjscia systemu wyciagajacego 
dokumentacje ze zrodel, ktory by zostal w ten sposob ladnie oddzielony 
od dalszego przetwarzania tej dokumentacji.

Czekam na opinie :)

dave





More information about the devel-pl mailing list