[prev in list] [next in list] [prev in thread] [next in thread]
List: doxygen-users
Subject: Re: [Doxygen-users] \cond keword
From: "c.feige () osypkamed ! com" <c ! feige () osypkamed ! com>
Date: 2010-09-24 7:50:40
Message-ID: 1357215912.542279.1285314640828.JavaMail.open-xchange () oxltgw17 ! schlund ! de
[Download RAW message or body]
------=_Part_542278_1033769426.1285314640660
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
=C2=A0
Dimitri Van Heesch wrote:
> I think a better approach is to allow simple constant C-style expressions=
,
> i.e.
>
> \if !SOME_SECTION_NAME
> ...
> \endif
>
> or even:
>
> \if SOME_SECTION_NAME && (!THIS_ALTERNATIVE || THAT_ALTERNATIVE)
> ...
> \endif
>
> The same could be done for \cond.
>
> Regards,
> =C2=A0 =C2=A0Dimitri
Hi Dimitri.
I think there are some technical reasons for why doxygen needs two differen=
t
conditional commands: "\if" that works inside a documentation block and "\c=
ond"
that works over different documentation blocks. I assume that it is quite a=
lot
programming work to make "\if" to be used for both purposes, so that we wou=
ld
not need \cond any longer. Am I right?
However, you proposal with C-Style conditional expressions drastically redu=
ces
the number of doxygen conditional commands (which is good for users) while
actually being more powerfull than the old approach with \ifnot and friends=
. I
like it.
Altough not a problem for me. One should think a moment about back-ward
compatibility for those people that have a lot of obsolete \ifnot commands =
in
their code. My opinion would be that with some easy search-and-replace
operations those people could easily modify their code. For example "\ifnot=
XXX"
would become "\if !(XXX)".
Clemens
------=_Part_542278_1033769426.1285314640660
MIME-Version: 1.0
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" \
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
<title></title>
</head>
<body>
<p style="margin: 0px;"><span></span></p>
<p> </p>
<div style="margin: 5px 0px 5px 0px; font-family: monospace;">
Dimitri Van Heesch wrote:<br />
> I think a better approach is to allow simple constant C-style expressions, \
i.e.<br /> ><br />
> \if !SOME_SECTION_NAME<br />
> ...<br />
> \endif<br />
><br />
> or even:<br />
><br />
> \if SOME_SECTION_NAME && (!THIS_ALTERNATIVE || \
THAT_ALTERNATIVE)<br /> > ...<br />
> \endif<br />
><br />
> The same could be done for \cond.<br />
><br />
> Regards,<br />
>   Dimitri
</div><br />
Hi Dimitri.<br />
<br />
I think there are some technical reasons for why doxygen needs two different \
conditional commands: "\if" that works inside a documentation block and \
"\cond" that works over different documentation blocks. I assume that it is \
quite a lot programming work to make "\if" to be used for both purposes, so \
that we would not need \cond any longer. Am I right?<br /> <br />
However, you proposal with C-Style conditional expressions drastically reduces \
the number of doxygen conditional commands (which is good for users) while actually \
being more powerfull than the old approach with \ifnot and friends. I like it.<br /> \
<br /> Altough not a problem for me. One should think a moment about back-ward \
compatibility for those people that have a lot of obsolete \ifnot commands in their \
code. My opinion would be that with some easy search-and-replace operations those \
people could easily modify their code. For example "\ifnot XXX" would \
become "\if !(XXX)".<br /> <br />
Clemens<br />
<br />
</body>
</html>
------=_Part_542278_1033769426.1285314640660--
------------------------------------------------------------------------------
Nokia and AT&T present the 2010 Calling All Innovators-North America contest
Create new apps & games for the Nokia N8 for consumers in U.S. and Canada
$10 million total in prizes - $4M cash, 500 devices, nearly $6M in marketing
Develop with Nokia Qt SDK, Web Runtime, or Java and Publish to Ovi Store
http://p.sf.net/sfu/nokia-dev2dev
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic