| Re: [AD] Documentation system 2009 |
[ Thread Index |
Date Index
| More lists.liballeg.org/allegro-developers Archives
]
On Sat, 2009-01-10 at 20:03 +1100, Peter Wang wrote:
>
> I think this alternative is easier to work with than separate files.
> The above description implies separate tags "Function:", "Type:",
> "Enum:" as in Natural Docs, but since it only served to complicate the
> scripts, I've unified them under "API:".
>
> Patch attached. The scripts are written in shell (they'd be trivial to
> rewrite, even in C). Natural Docs have been extracted but not reformatted.
> The CMake build will generate HTML, man and info documents (if enabled).
>
> I'll get some more opinions before committing.
>
I like the idea, it's similar to how the pygame documentation works.
Should I translate the shell scripts to Python btw? It would mean they
run also in Windows, and they would be much easier to read. And we would
not need helper programs like faster_search.
--
Elias Pschernig <elias@xxxxxxxxxx>