Re: [Doxygen-users] Linking to functions with long parameter lists

[Daniel R. <dr...@ma...>]

Clemens Feige wrote:

> Regarding this regular expression trick to deal with linebreak formating in source code:
> 
> On 16 Feb 2007 at 11:24, Daniel Rubin wrote:
> 
>> Clemens, that's just a _neat_ idea.
>> I wasn't aware of the INPUT_FILTER thing, never thinking I'd ever have
>> to preprocess my sources with anything other than cpp.
>>
>> Do you know when INPUT_FILTER is applied?  Before or after cpp?
>>
> 
> Hi Daniel!
> 
> I do not unterstand you question. Doxygen (and the input-filter) have 
> nothing to do with running the compiler (cpp).

Sorry for the confusion.  By "cpp" I meant the C-preprocessor.  (I 
think "cpp" is its common name on Unixens.)


> The input-filter is 
> applied before doxygen processes your files:
> 
> 1.
> Doxygen open a documented source file
> 
> 2.
> Doxygen applies the input filter which is an external program.
> 
> 3.
> Doxygen processes the output of the external program and makes the 
> documentation.
> 
> 4. 
> Doxygen goes to the next file ... -> 1.

My question essentially was about which of steps 1. or 3. the 
C-preprocessor hooks in at.  But it might just be doxygen does the 
preprocessing stuff (macro expansion, including headers etc.) all 
by itself.  But when?  Most probably after applying the external 
filter -- anything doesn't seem sensible to me right now (so it 
would be at the beginning of step 3).

My intention was to find out what sort of line continuation symbol 
I could use.  I actually thought about using just the common 
backslash -- wondering if that might not be evaluated by the 
preprocessor before my filter had a chance to look at the code.
But I abandoned that idea, it leads to dangerous grounds that I am 
not willing to explore -- the backslash is just too laden with 
functionality already.

Anyway, I was able to solve my problem following your suggestion, 
see my other post.


Have fun
----Daniel