doxygen-develop

[Doxygen-develop] Aliases

[Randall, L. <l-r...@ti...>]

I have noticed that 1.3.8 and 1.4.x ignore the \n in an alias and start
on the same line as previous output.  Example:

 "rev =3D Revision \n" \
 "syn =3D Syntax \n" \

I have even tried:
 "lib =3D \n Library \n"

This produces:
	Library ImageConversion.lib=20

When \lib and \syn are "stacked", these produce:
	Library ImageConversion.lib Syntax Test of Syntax and code
style:  static CBufferCopyListener* NewL(const RThread* aSubThread) =20

Previous output was:=20

	Library (bolded)
		ImageConversion.lib=20

	Syntax  (bolded)
		Test of Syntax and code style:  static
CBufferCopyListener* NewL(const RThread* aSubThread)
 =20

Regards,=20
Larry Randall =20
OMAP(tm) Program Facilitation Office=20
 =20

[Doxygen-develop] Aliases

[John T. <joh...@gm...>]

Hey all,

  At the moment you can't use cond inside an alias, like:

ALIASES = foodev="\cond FooDev" \
          endfoodev="\endcond"

(http://bugzilla.gnome.org/show_bug.cgi?id=485773)

Does anyone know of a work around?

Can anyone give a hint how I could fix this bug in doxygen?

John Tapsell

Re: [Doxygen-develop] Aliases

[Dimitri V. H. <do...@gm...>]

On 31 jul 2009, at 11:41, John Tapsell wrote:

> Hey all,
>
>  At the moment you can't use cond inside an alias, like:
>
> ALIASES = foodev="\cond FooDev" \
>          endfoodev="\endcond"
>
> (http://bugzilla.gnome.org/show_bug.cgi?id=485773)
>
> Does anyone know of a work around?
>
> Can anyone give a hint how I could fix this bug in doxygen?

The problem is that both the ALIASES resolution and the processing of  
\cond..\endcond
section's are done in the same pass, in src/commentcnv.l.

To do this properly a two-pass approach would be needed.
First the ALIASES need to be resolved and then the \cond sections
need to be processed.

Alternatively, some special treatment could be given to
expanded aliases with \cond or \endcond commands.

Regards,
   Dimitri

Re: [Doxygen-develop] Aliases

[Iain B. <ia...@pc...>]

On Fri, 2009-07-31 at 10:41 +0100, John Tapsell wrote:
> Hey all,
> 
>   At the moment you can't use cond inside an alias, like:
> 
> ALIASES = foodev="\cond FooDev" \
>           endfoodev="\endcond"
> 
> (http://bugzilla.gnome.org/show_bug.cgi?id=485773)
> 
> Does anyone know of a work around?

as a workaround you could use the INPUT_FILTER option to pass your
source through a small (your choice of scripting language) script which
does the conditional checks for you... might be a bit of work though.

> Can anyone give a hint how I could fix this bug in doxygen?
> 
> John Tapsell

-- 
Iain Buchanan <iain at pcorp dot com dot au>

You may be right, I may be crazy,
But it just may be a lunatic you're looking for!
		-- Billy Joel

Re: [Doxygen-develop] Aliases

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

On Mon, Feb 07, 2005 at 10:36:28AM -0600, Randall, Larry wrote:
> I have noticed that 1.3.8 and 1.4.x ignore the \n in an alias and start
> on the same line as previous output.  Example:
> 
>  "rev = Revision \n" \
>  "syn = Syntax \n" \
> 
> I have even tried:
>  "lib = \n Library \n"
> 
> This produces:
> 	Library ImageConversion.lib 
> 
> When \lib and \syn are "stacked", these produce:
> 	Library ImageConversion.lib Syntax Test of Syntax and code
> style:  static CBufferCopyListener* NewL(const RThread* aSubThread)  
> 
> Previous output was: 
> 
> 	Library (bolded)
> 		ImageConversion.lib 
> 
> 	Syntax  (bolded)
> 		Test of Syntax and code style:  static
> CBufferCopyListener* NewL(const RThread* aSubThread)

To me this sounds like you want to define the aliases like this:
ALIASES                = "syn=\par Syntax:\n" \
                         "lib=\par Library:\n"

Regards,
  Dimitri