On Nov 11, 2007 11:53 AM, Klemens Friedl <
frik85@gmail.com> wrote:
WineHQ's API-docu-system consists of static pages that are generated
by using a single perl script. The c2man.pl script uses regex
expressions to parse the source code and generate static html files.
An introduction and more in-deep information about the Wine API
documentation can be found on their website:
http://www.winehq.org/site/docs/winedev-guide/api-docs
In my opinion, we should try to optimize the
c2man.pl for our purpose.
An alternative would be to update or even rewrite the rgenstat tool.
Maybe by using the pcre3 regex library, or by writing a
lexer+parser+generator. The lexer and parser code could be generated
by using tools like bison, yacc or lemon. The later one even supports
EBNF and multi-threading.
The benefit of a tool written C or C++ would be that it would be
faster and it can be used with RosBE without additional third party
packages (like perl).
By using regex, especially the pcre3 library which is compatible with
perl-regex (the defacto standard) we could refactor the perl-script to
C code.
On the otherside, for the meantime it sounds more reasonable to go
with an slightly optimized wine perl script.