Re: [Doxygen-develop] Adding of new (all) HTML entities?

[Dimitri v. H. <di...@st...>]

On Thu, Jul 19, 2001 at 12:37:10PM +0200, Xavier Outhier wrote:
> Hi,
> 
> 
> As far as I understand, what is to be done for each new entity
> is the following:
> 
> -1 Add a new pure virtual method named writeEntity() in
>     class BaseOutputDocInterface (outputgen.h)
> -2 Add a new method
>     void writeEntity()
>     { forall(&OutputGenerator::writeEntity); }
>    in class OutputList (outputlist.h)
> -3 Add non pure virtual method in generators:
>     void writeEntity()        {}
>    in classes
>     class ManGenerator (mangen.h)
>     class LatexGenerator (latexgen.h)
>     class HtmlGenerator (htmlgen.h)
> 
> Remarks:
> I do not understand what doc.cpp does really. I suppose it has also
> to be changed but I don't know how.

doc.cpp is a generated file. Look at the flex file doc.l: You'll see lines like
these:

<DocScan,Text>"&"[cC]"cedil;"           { outDoc->writeCCedil(yytext[1]); }

these consist of a set of states (between <>), a regular expression, 
and some code.

The code is executed when the input matches the regular expression. yytext
is a char* containing the actual text that was matched. So the
above matches &ccedil; and &Ccedil;

> Besides, I know what to do with HTML and LaTeX (maybe not for
> all symbols, I have to check in my documentation) but I don't know
> what to do with man.

This has always been a mistery to me too.


> Questions:
> Is the process (with the 3 steps) correct? Is something missing?

Seems ok to me.

> As my free time is so precious (as for everybody), is it possible
> tha I only change the files and send them back for merging,
> compiling and so on?

Yes, that is fine. You can choose to do only those entities that you
need as well.

Regards,
  Dimitri