[Doxygen-develop] Transparent HTML entities: files

[Xavier O. <xav...@an...>]

John Olsson wrote:

> [...]> Sorry for newbie questions. I just wanted to help a little (for my
> needs

> > first), I'm simply maintainer of the French location of Doxygen. :-)
> > [...]
> >
> Aren't we all newbies? ;)

I think I'm the newest one. ;-)

> [...]
> Also, the default behaviour of flex is to print everything it can't match
> to stdout (this is the default rule which is always active). However, the
> flex code in doc.l (and scanner.l) has defined a rule which overrides the
> default rule which silently ignores text it can't match. If you modify the
> "match-all" rule so it looks like this
>
> <*>.                                    { ECHO; }
>
> you will "restore" the default behaviour (I think).

I don't know the reason why it is such. I'm not sure 'restoring' would
be a good idea. I prefer to restrict to entities in the form &entity;.

So here are my changes in sources. Files modified are:
 outputgen.h // new method writeEntity(const char* const entity) = 0;
or writeEntity(const char* const entity, int length) = 0; depending if
char* yytext has a trailing \0 or not, cf my PS.
 outputlist.h
 mangen.h    // empty implementation
 latexgen.h    // empty implementation
 rtfgen.h        // empty implementation
 html.h        // tranparent entities for HMTL
 doc.l    // new match for all entities

In all files writeEntity() is just behind writeCCedil().

Sorry, I have not time to compile and so on (I'm not under Linux :( ).
Tell me if there is any bug. I will try to implement the method for
LatexGenerator if I have free time. In any case, I will not implement
nothing for ManGenerator and RTFGenerator

Greetings,

Xavier.

PS: Because I don't know if yytext ends with '\0',
I include 2 zip:
-1 transparent-SGML-entities-no length parameter.zip
     To be used if yytext does _not_ include trailing '\0'.
     strlen(yytext) cannot be used.
-2 transparent-SGML-entities-no length parameter.zip
     To be used if yytext does include trailing '\0'.
     strlen(yytext) can be used
OK, I could read flex doc but that is faster. Hope you will
not quarrel me about that. :)