Re: new feature proposal: filter maps

Francesco Montorsi <[email protected]>
Newsgroups gmane.text.doxygen.devel
Message-ID <[email protected]>
Oleg Batrashev ha scritto:
> Hi,
> 
>>  However I think that it shouldn't be difficult to add to Doxygen a
>>  generic system which allows to override the default strings returned by
>>  the Translator-derived class selected for use.
> I would move "resourece strings" and localization completely to text
> conf files. It worked very well in my past experience with Java and
> Python.
however how do you take "decisions" in text conf files?
some functions take boolean arguments and output different strings 
dependending on it...
I was proposing something simpler only for project-specific filtering; 
changing all doxygen's Translator class implementations seems 
inefficient to me (doxygen would be slower since it needs to read the 
text conf file).

> And compilation time translator files take is huge.
I don't think this is a major problem... not many doxygen users compile 
it from sources I think (all major distro have it packaged) :)


>>  I.e. we could add an option, say "OUTPUT_FILTER", which allows the user
>>  to specify a text file to use as "filter map".
>>  Suppose I want in my project to have "Modules" label (returned by
>>  trModules() function) replaced by a "SomethingElse" label and  the text
>>  returned by trGeneratedAutomatically(const char*s) replaced by
>>  "Generated for " + s + " by Doxygen".
>>  Then I could simply write in the "filter map":
>>
>>  trModules=SomethingElse
>>  trGeneratedAutomatically=Generated for \1 by Doxygen
ops; here I wanted to write

trGeneratedAutomatically{1}=Generated for \1 by Doxygen

actually.

> Yes, in Python I would use something like
> module=module
> generatedAutomatically=Generated for %{project-name} by Doxygen
hmmm, I think reusing the same ALIASes syntax would be simpler and more 
intuitive for the user...

> So, you just need to tweak a resource (localization) file and pass it
> to doxygen as a replacement to original.
> 
> But it is quite an effort to reimplement.
in fact... my approach seems easier to me.

Thanks anyway for your suggestions :)

Francesco



-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.