[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