doxygen-users — List for users of doxygen

[Doxygen-users] Cross Referencing of C Global Variables

[Roy L. <roy...@ya...>]

Hi,

I'm trying to figure out if the following is a bug or
just badly configured!  Anyone got any suggestions?

The global variable "not_referenced" in the header
file is not referenced correctly in doxygen output. 
However the "is_referenced" variable is correctly
cross referenced.

I have a global variable declared in a Header file

****test.h****
/**
 * This is a test variable
*/
extern const UINT8 not_referenced;

***test.c****
/**
 * this is another test variable
 */ 
extern const UINT8 is_referenced; 

/**
 * main func
 */ 
int main (void) 
{ 
    is_referenced = not_referenced; 
}

Cheers,

Roy

__________________________________________________
Do You Yahoo!?
Yahoo! Sports - Coverage of the 2002 Olympic Games
http://sports.yahoo.com

[Doxygen-users] TOC overflow AIX 4.1

[Gregor B. <gre...@bl...>]

I'm trying to compile doxygen on a AIX 4.1 machine.

First I runned
./configure --platform aix-g++ --english-only
which resulted in a 'virtual memory exhausted' error, as described in =
the 'known problems' section of the doxygen documentation.

Then I set the --debug option for configuration and encountered to =
following error:

g++  -o ../bin/doxygen ../objects/main.o  -L../lib -ldoxygen -ldoxycfg =
-lqtools
ld: 0711-781 ERROR: TOC overflow. TOC size: 67988       Maximum size: =
65536   =20
collect2: ld returned 12 exit status                                     =
     =20
make[1]: *** [../bin/doxygen] Error 1                                    =
     =20

I manually added '-mno-fp-in-toc' to all makefiles but it didn't help.

Any ideas?

Gregor

[Doxygen-users] Withdrawing my (stupid) question

[EXTERN H. M. (; DS/E. * <Mic...@de...>]

Sorry folks for my stupid question.

I thought I had checked everything before asking the mailing-list and then I
made this big error in the code.....(putting the enum name AFTER the
declaration)
That's because I don't compile the code at the mo', just checking the
Doxygen output :-{

Sorry for having doubts about doxygen ;-}

I'll get my coat.

Cheers,
Michael

RE: [Doxygen-users] aliases

[Kevin W. <KWi...@vi...>]

Thanks to everyone that tried to help.  Frederic got me - I didn't realize
there was an existing (blank) ALIASES line later in the config file.  After
removing that, my aliases are working great!

-- Kevin Williams
   Visionael Corporation
   kwi...@vi...


-----Original Message-----
From: Frederic Maria [mailto:fre...@fe...] 
Sent: Thursday, February 14, 2002 3:27 AM
To: dox...@li...
Subject: Re: [Doxygen-users] aliases


Multiple definition of configuration parameter only keeps the last one.

Try to find the place where ALIASES is defined in your config file (I 
suppose you kept the original one) :

ALIASES = "........"

and add the following line just after :

ALIASES += "z=BLAH"

(don't foget the '+', it's the key !)

This should work now.

Fred

RE: [Doxygen-users] BUSINESS PROPOSAL

[Catenacci, O. <Ono...@co...>]

I heard that Nigerian National Petroleum hired all the former managers from
Enron. :-P

<http://www.satirewire.com/news/jan02/scam.shtml>

-- 
Onorio Catenacci

> -----Original Message-----
> From: Eben Investment [mailto:ebe...@ya...]
> Sent: Thursday, February 14, 2002 9:09 AM
> To: dox...@li...
> Subject: [Doxygen-users] BUSINESS PROPOSAL
> 
> 
> DEAR SIR,
> 
<Snipped spam>

Re: [Doxygen-users] BUSINESS PROPOSAL

[Emilio R. <Emi...@ma...>]

This is what I call true privacy... :-)




Eben Investment <ebe...@ya...>@lists.sourceforge.net on
14/02/2002 15:08:49

Sent by:  dox...@li...


To:   dox...@li...
cc:

Subject:  [Doxygen-users] BUSINESS PROPOSAL


DEAR SIR,

HAVING CONSULTED WITH MY COLLEAGUES, AND BASED ON
THEINFORMATION GATHERED, I HAVE THE PRIVILEGE TO
REQUEST FOR YOUR ASSISTANCE TO TRANSFER THE SUM OF
TWELVE MILLION, ONE HUNDRED AND TEN THOUSAND
UNITED STATE DOLLARS ($12.110M U.S.) INTO YOUR
ACCOUNT.
THE ABOVE SUM RESULTED FROM AN OVER-INVOICED
CONTRACT,EXECUTED,COMMISSIONED AND PAID FOR ABOUT FOUR
YEARS AGO BY AFOREIGN CONTRACTOR. THIS ACTION WAS
HOWEVER INTENTIONAL AND SINCE THEN THE FUND HAS BEEN
IN A SUSPENSE ACCOUNT AT THE CENTRAL BANK OF NIGERIA
APEX BANK.

WE ARE NOW READY TO TRANSFER THE FUND OVERSEAS, AND
THAT IS WHERE YOU COME IN. IT IS IMPORTANT TO INFORM
YOU THAT ASCIVIL SERVANTS,WE ARE FOR BIDDEN TO OPERATE
A FOREIGN ACCOUNT, THAT IS WHY WE REQUIRE YOUR
ASSISTANCE. THE TOTAL SUM WILL BE SHARED ASFOLLOWS:
70% FOR US, 25% FOR YOU AND 5% FOR LOCAL AND
INTERNATIONALEXPENSES INCIDENTAL TO THE TRANSFER.THE
TRANSFER IS RISK FREE ON BOTH SIDES.

I AM ANACCOUNTANT WITH THE NIGERIAN NATIONAL PETROLEUM
CORPORATION(N.N.P.C.). IF YOU FIND THIS PROPOSAL
ACCEPTABLE, WE SHALL FAX TO YOU AFOREIGN CONTRACTORS
APPLICATION FORM, WHICH YOU WILL HAVE TO COMPLETE AND
FAX BACK TO US. THIS BUSINESS WILL TAKE US TWENTY-ONE
(21) WORKINGDAYS TO ACCOMPLISH.

FOR SECURITY REASONS, MAKE SURE YOU KEEP THIS
PROPOSALSTRICTLY TO YOURSELF THAT IS DO NOT DISCUSS
WITH A THIRD PARTY.ON YOUR ACCEPTANCE OF THIS
PROPOSAL, I WILL SEND YOU MY PERSONAL TELEPHONE/FAX
NUMBERS ON THE NEXT STEP THAT IS REQUIRED.REPLY
URGENTLY.

REGARDS,
CHIEF ADE.


__________________________________________________
Do You Yahoo!?
Send FREE Valentine eCards with Yahoo! Greetings!
http://greetings.yahoo.com

_______________________________________________
Doxygen-users mailing list
Dox...@li...
https://lists.sourceforge.net/lists/listinfo/doxygen-users





------------
This e-mail and any attachments are confidential.  If you are not the intended recipient, please notify us immediately by reply e-mail and then delete this message from your system. Do not copy this e-mail or any attachments, use the contents for any purpose, or disclose the contents to any other person: to do so could be a breach of confidence.

Re: [Doxygen-users] BUSINESS PROPOSAL

[Greger H. <gre...@ya...>]

Eben Investment wrote:

Oh no, Not another one, hehehehehe, who are you robbing?*S*

/Greger

> DEAR SIR,
>
> HAVING CONSULTED WITH MY COLLEAGUES, AND BASED ON
> THEINFORMATION GATHERED, I HAVE THE PRIVILEGE TO
> REQUEST FOR YOUR ASSISTANCE TO TRANSFER THE SUM OF
> TWELVE MILLION, ONE HUNDRED AND TEN THOUSAND
> UNITED STATE DOLLARS ($12.110M U.S.) INTO YOUR
> ACCOUNT.
> THE ABOVE SUM RESULTED FROM AN OVER-INVOICED
> CONTRACT,EXECUTED,COMMISSIONED AND PAID FOR ABOUT FOUR
> YEARS AGO BY AFOREIGN CONTRACTOR. THIS ACTION WAS
> HOWEVER INTENTIONAL AND SINCE THEN THE FUND HAS BEEN
> IN A SUSPENSE ACCOUNT AT THE CENTRAL BANK OF NIGERIA
> APEX BANK.
>
> WE ARE NOW READY TO TRANSFER THE FUND OVERSEAS, AND
> THAT IS WHERE YOU COME IN. IT IS IMPORTANT TO INFORM
> YOU THAT ASCIVIL SERVANTS,WE ARE FOR BIDDEN TO OPERATE
> A FOREIGN ACCOUNT, THAT IS WHY WE REQUIRE YOUR
> ASSISTANCE. THE TOTAL SUM WILL BE SHARED ASFOLLOWS:
> 70% FOR US, 25% FOR YOU AND 5% FOR LOCAL AND
> INTERNATIONALEXPENSES INCIDENTAL TO THE TRANSFER.THE
> TRANSFER IS RISK FREE ON BOTH SIDES.
>
> I AM ANACCOUNTANT WITH THE NIGERIAN NATIONAL PETROLEUM
> CORPORATION(N.N.P.C.). IF YOU FIND THIS PROPOSAL
> ACCEPTABLE, WE SHALL FAX TO YOU AFOREIGN CONTRACTORS
> APPLICATION FORM, WHICH YOU WILL HAVE TO COMPLETE AND
> FAX BACK TO US. THIS BUSINESS WILL TAKE US TWENTY-ONE
> (21) WORKINGDAYS TO ACCOMPLISH.
>
> FOR SECURITY REASONS, MAKE SURE YOU KEEP THIS
> PROPOSALSTRICTLY TO YOURSELF THAT IS DO NOT DISCUSS
> WITH A THIRD PARTY.ON YOUR ACCEPTANCE OF THIS
> PROPOSAL, I WILL SEND YOU MY PERSONAL TELEPHONE/FAX
> NUMBERS ON THE NEXT STEP THAT IS REQUIRED.REPLY
> URGENTLY.
>
> REGARDS,
> CHIEF ADE.
>
> __________________________________________________
> Do You Yahoo!?
> Send FREE Valentine eCards with Yahoo! Greetings!
> http://greetings.yahoo.com
>
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users


_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com

[Doxygen-users] Help with XML output

[EXTERN H. M. (; DS/E. * <Mic...@de...>]

Hi,

I'm using Doxygen for a while now and I use mainly the XML output feature. I
know that this feature is still under development, so I don't know if my
problem which I'm about to describe below is a bug or a feature. Maybe you
might be able to help me with that.

The following C-Code in Modul3.h:

/*! Enumeration of all modules */
enum
{      	MODUL1_E,
	MODUL2_E,
	MODUL3_E,
	NUM_MODULES_E
}modules_t;

results in this XML output:

<compounddef id="Modul3_8h" kind="file">
 
  <SNIP>

  <sectiondef kind="enum">
    <memberdef kind="enum" id="Modul3_8h_1a26" virt="normal" prot="public"> 
      <name>@0</name> 
      <enumvalue> 
        <name>MODUL1_E</name> 
      </enumvalue> 
      <enumvalue>  
        <name>MODUL2_E</name> 
      </enumvalue> 
      <enumvalue> 
        <name>MODUL3_E</name> 
      </enumvalue> 
      <enumvalue> 
        <name>NUM_MODULES_E</name> 
      </enumvalue> 
      <briefdescription /> 
      <detaileddescription> 
      <para>Enumeration of all modules</para> 
      </detaileddescription>   
    </memberdef> 
  </sectiondef>

  <SNIP>

  <sectiondef kind="var"> 
    <memberdef kind="variable" id="Modul3_8h_1a1" virt="normal"
prot="public"> 
      <type>enum @0</type> 
      <name>modules_t</name> 
      <briefdescription /> 
      <detaileddescription> 
      <para>Enumeration of all modules</para> 
    </memberdef>
  </sectiondef>
  
  <SNIP>

</compounddef>


My problem now is that the enum is described in two paragraphs. And I need
to filter both to get one complete description of the enum.
What I want is that the <type> and <name> tag of the second paragraph will
be all in the first paragraph (where only the <name> tag is there and this
just refers to the "@0" id in the <type> field of the second passage)

Have I done something wrong?? Will I be able to get what I need described
above??

 If you need the config file I can send that, too. Or the complette XML file
if necessary.

Thanks in advance,
Michael

[Doxygen-users] BUSINESS PROPOSAL

[Eben I. <ebe...@ya...>]

DEAR SIR,

HAVING CONSULTED WITH MY COLLEAGUES, AND BASED ON
THEINFORMATION GATHERED, I HAVE THE PRIVILEGE TO
REQUEST FOR YOUR ASSISTANCE TO TRANSFER THE SUM OF
TWELVE MILLION, ONE HUNDRED AND TEN THOUSAND 
UNITED STATE DOLLARS ($12.110M U.S.) INTO YOUR
ACCOUNT.
THE ABOVE SUM RESULTED FROM AN OVER-INVOICED
CONTRACT,EXECUTED,COMMISSIONED AND PAID FOR ABOUT FOUR
YEARS AGO BY AFOREIGN CONTRACTOR. THIS ACTION WAS
HOWEVER INTENTIONAL AND SINCE THEN THE FUND HAS BEEN
IN A SUSPENSE ACCOUNT AT THE CENTRAL BANK OF NIGERIA
APEX BANK.

WE ARE NOW READY TO TRANSFER THE FUND OVERSEAS, AND
THAT IS WHERE YOU COME IN. IT IS IMPORTANT TO INFORM
YOU THAT ASCIVIL SERVANTS,WE ARE FOR BIDDEN TO OPERATE
A FOREIGN ACCOUNT, THAT IS WHY WE REQUIRE YOUR
ASSISTANCE. THE TOTAL SUM WILL BE SHARED ASFOLLOWS:
70% FOR US, 25% FOR YOU AND 5% FOR LOCAL AND
INTERNATIONALEXPENSES INCIDENTAL TO THE TRANSFER.THE
TRANSFER IS RISK FREE ON BOTH SIDES. 

I AM ANACCOUNTANT WITH THE NIGERIAN NATIONAL PETROLEUM
CORPORATION(N.N.P.C.). IF YOU FIND THIS PROPOSAL
ACCEPTABLE, WE SHALL FAX TO YOU AFOREIGN CONTRACTORS
APPLICATION FORM, WHICH YOU WILL HAVE TO COMPLETE AND
FAX BACK TO US. THIS BUSINESS WILL TAKE US TWENTY-ONE
(21) WORKINGDAYS TO ACCOMPLISH. 

FOR SECURITY REASONS, MAKE SURE YOU KEEP THIS
PROPOSALSTRICTLY TO YOURSELF THAT IS DO NOT DISCUSS
WITH A THIRD PARTY.ON YOUR ACCEPTANCE OF THIS
PROPOSAL, I WILL SEND YOU MY PERSONAL TELEPHONE/FAX
NUMBERS ON THE NEXT STEP THAT IS REQUIRED.REPLY
URGENTLY.

REGARDS,
CHIEF ADE.


__________________________________________________
Do You Yahoo!?
Send FREE Valentine eCards with Yahoo! Greetings!
http://greetings.yahoo.com

Re: [Doxygen-users] aliases

[Frederic M. <fre...@fe...>]

Multiple definition of configuration parameter only keeps the last one.

Try to find the place where ALIASES is defined in your config file (I 
suppose you kept the original one) :

ALIASES = "........"

and add the following line just after :

ALIASES += "z=BLAH"

(don't foget the '+', it's the key !)

This should work now.

Fred

Kevin Williams <KWi...@vi...> wrote

>From: Kevin Williams <KWi...@vi...>
>To: "'dox...@li...'"
>	 <dox...@li...>
>Date: Wed, 13 Feb 2002 07:37:11 -0800
>Subject: [Doxygen-users] aliases
>
>This message is in MIME format. Since your mail reader does not understand
>this format, some or all of this message may not be legible.
>
>------_=_NextPart_001_01C1B4A4.4DC97890
>Content-Type: text/plain
>
>Using Doxygen 1.2.13.1.  The first thing in my config file is this:
>
>ALIASES = "z=BLAH"
>
>Here's some source code I ran through doxygen:
>
>/** @file blah.cpp */
>
>/*!
> * @brief Blah blah blah
> *
> * @z This is a test.
> */
>void blah(void)
>{
>  return;
>}
>
>In doxygen's HTML output, my @z alias doesn't get turned into BLAH (it
>remains "@z").  Am I defining the alias incorrectly?  Or do aliases not work
>in this case for some reason?
>
>-- Kevin Williams
>   Visionael Corporation
>   kwi...@vi...
>

[Doxygen-users] aliases

[Kevin W. <KWi...@vi...>]

Using Doxygen 1.2.13.1.  The first thing in my config file is this:

ALIASES = "z=BLAH"

Here's some source code I ran through doxygen:

/** @file blah.cpp */

/*!
 * @brief Blah blah blah
 *
 * @z This is a test.
 */
void blah(void)
{
  return;
}

In doxygen's HTML output, my @z alias doesn't get turned into BLAH (it
remains "@z").  Am I defining the alias incorrectly?  Or do aliases not work
in this case for some reason?

-- Kevin Williams
   Visionael Corporation
   kwi...@vi...

[Doxygen-users] Updated version of translator_de.h

[Brandt, O. / E. - B. <Oli...@Le...>]

Hello!

Here is an updated version of translator_de.h.

Regards
Oliver Brandt

[Doxygen-users] qt-mt230nc.dll missing

[Mr.Rajasekar.S <raj...@ya...>]

hi 
  When i try to execute the doxygen application it gives      
qt-mt230nc.dll file is missing . Give me the solution for this
problem.

regards
raj

__________________________________________________
Do You Yahoo!?
Send FREE Valentine eCards with Yahoo! Greetings!
http://greetings.yahoo.com

[Doxygen-users] End-user "How to use Doxygen-generated documentation" documentation

[Stephen G. <ste...@el...>]

Hello,

When I want to get developers to write documentation for their code, I
can tell them to read the existing Doxygen manual, which is a pretty
good manual. But when they are finished and the library is ready for
other people to use, I'm facing a repeated situation of trying to get
another new bunch of people to actually _use_ the Doxygen-generated
documentation, instead of just reading the original source code :-(

I find that I'm spending a lot of time explaining that if they look
they'll find - well, all the lovely things that are the reason we use
Doxygen in the first (coloured and hyperlinked source browsing, the
various diagrams etc).

What we need is a how-to guide to introduce the users to the _idea_ of
Doxygen-generated docs, what sort of thing they can find (eg, the
coloured and linked source listings) and, more importantly, _how_ they
can find it. This would then be linked to in a prominent place on the
mainpage - and possibly at the bottom of every page.

This end-user manual could also be useful when introducing the program
to a new development team, before there is the opportunity to show them
their own code nicely presented (after all, they might not have had time
to write any code yet :-) ) - in a way that the "features" list in the
existing Doxygen manual can't.

Has anyone ever tried to write something like this? I'd offer to help
straightaway, but right now I'm a bit too close to the problem (it keeps
ending up as "For bleep's sake, just hit a few links and see for
yourself" :-( )

Regards,
Stephen Goudge

Re: [Doxygen-users] Re: Pb with the new version of dot

[Stephane R. <ste...@sy...>]

Thanks for the infos.
The problem only occurs with the new version of dot for win32 (
http://www.research.att.com/sw/tools/graphviz/dist/gv1712.exe )
The new version solve some problems I had, but this one is new !

OK, I will send a mail to the dot team.

Stephane
----- Original Message -----
From: "Dimitri van Heesch" <di...@st...>
To: <dox...@li...>
Sent: Monday, February 11, 2002 2:08 PM
Subject: [Doxygen-users] Re: Pb with the new version of dot


> On Mon, Feb 11, 2002 at 01:50:43PM -0500, Stephane Routelous wrote:
> > Hi,
> >
> > I sent a few week ago, a mail to the mailing list with a problem with
the new version of dot.exe for win32 .
> > ( http://www.geocrawler.com/archives/3/11668/2002/1/0/7697694/ )
> >
> > I didn't have any answer.
> >
> > It seems that the maps for the dot-generated bitmaps are wrong.
> > For example, in the attached file, if you move the mouse cursor links
over the exotkAF_ViewPopup image, the area becomes "sensitive" only when the
cursor is on the "ot". On the right, thew area is sensitive passed the end
of the box.
> >
> > Is it a problem with dot or with doxygen ?
>
> I think it is a dot problem, but I don't have it with the latest version
of
> dot (as included in graphviz 1.7.15) on Linux.
>
> > Who generates those areas ?
>
> Doxygen lets dot generate a server side image map (with the areas),
> which doxygen then converts into a client side map. You can see the
> intermediate result if you set DOT_CLEANUP to NO.
>
> Regards,
>   Dimitri
>
>
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users

[Doxygen-users] Re: Pb with the new version of dot

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

On Mon, Feb 11, 2002 at 01:50:43PM -0500, Stephane Routelous wrote:
> Hi,
> 
> I sent a few week ago, a mail to the mailing list with a problem with the new version of dot.exe for win32 .
> ( http://www.geocrawler.com/archives/3/11668/2002/1/0/7697694/ )
> 
> I didn't have any answer.
> 
> It seems that the maps for the dot-generated bitmaps are wrong.
> For example, in the attached file, if you move the mouse cursor links over the exotkAF_ViewPopup image, the area becomes "sensitive" only when the cursor is on the "ot". On the right, thew area is sensitive passed the end of the box.
> 
> Is it a problem with dot or with doxygen ?

I think it is a dot problem, but I don't have it with the latest version of
dot (as included in graphviz 1.7.15) on Linux.

> Who generates those areas ?

Doxygen lets dot generate a server side image map (with the areas), 
which doxygen then converts into a client side map. You can see the
intermediate result if you set DOT_CLEANUP to NO.

Regards,
  Dimitri

[Doxygen-users] Pb with the new version of dot

[Stephane R. <ste...@sy...>]

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">=0A=
<html><head><meta http-equiv=3D"Content-Type" =
content=3D"text/html;charset=3Diso-8859-1">=0A=
<title>exotkAF_ViewType.hxx File Reference</title>=0A=
<link href=3D"doxygen.css" rel=3D"stylesheet" type=3D"text/css">=0A=
</head><body bgcolor=3D"#ffffff">=0A=
<!-- Generated by Doxygen 1.2.13.1 -->=0A=
<center>=0A=
<a class=3D"qindex" href=3D"main.html">Main Page</a> &nbsp; <a =
class=3D"qindex" href=3D"namespaces.html">Namespace List</a> &nbsp; <a =
class=3D"qindex" href=3D"hierarchy.html">Class Hierarchy</a> &nbsp; <a =
class=3D"qindex" href=3D"classes.html">Alphabetical List</a> &nbsp; <a =
class=3D"qindex" href=3D"annotated.html">Compound List</a> &nbsp; <a =
class=3D"qindex" href=3D"files.html">File List</a> &nbsp; <a =
class=3D"qindex" href=3D"namespacemembers.html">Namespace Members</a> =
&nbsp; <a class=3D"qindex" href=3D"functions.html">Compound Members</a> =
&nbsp; <a class=3D"qindex" href=3D"globals.html">File Members</a> &nbsp; =
<a class=3D"qindex" href=3D"pages.html">Related Pages</a> &nbsp; =
</center>=0A=
<hr><h1>exotkAF_ViewType.hxx File Reference</h1>Header file for the =
class exotkAF_ViewType. =0A=
<a href=3D"#_details">More...</a>=0A=
<p>=0A=
=0A=
<p>=0A=
This graph shows which files directly or indirectly include this =
file:<p><center><img src=3D"exotkAF__ViewType_8hxx__dep__incl.gif" =
border=3D"0" usemap=3D"#exotkAF_ViewType.hxxdep_map" alt=3D"Included by =
dependency graph"></center>=0A=
<map name=3D"exotkAF_ViewType.hxxdep_map">=0A=
<area href=3D"exotkAF__View_8cxx.html" shape=3D"rect" =
coords=3D"14,15,155,34" alt=3D"">=0A=
<area href=3D"exotkAF__ViewPopup_8cxx.html" shape=3D"rect" =
coords=3D"179,15,363,34" alt=3D"">=0A=
</map>=0A=
=0A=
<p>=0A=
<a href=3D"exotkAF__ViewType_8hxx-source.html">Go to the source code of =
this file.</a><table border=3D0 cellpadding=3D0 cellspacing=3D0>=0A=
<tr><td colspan=3D2><br><h2>Enumerations</h2></td></tr>=0A=
<tr><td nowrap align=3Dright valign=3Dtop>enum &nbsp;</td><td =
valign=3Dbottom><a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9">exotkAF_ViewType</a> { <br>=0A=
&nbsp;&nbsp;<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a0">exotkAF_vtFront</a>, =0A=
<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a1">exotkAF_vtBack</a>, =0A=
<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a2">exotkAF_vtRight</a>, =0A=
<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a3">exotkAF_vtLeft</a>, =0A=
<br>=0A=
&nbsp;&nbsp;<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a4">exotkAF_vtTop</a>, =0A=
<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a5">exotkAF_vtBottom</a>, =0A=
<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a6">exotkAF_vtAxo</a>, =0A=
<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a7">exotkAF_vtUserDefined</a>, =0A=
<br>=0A=
&nbsp;&nbsp;<a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx.html#a9a8">exotkAF_vtMaxEnum</a>=0A=
<br>=0A=
 }</td></tr>=0A=
</table>=0A=
<hr><a name=3D"_details"></a><h2>Detailed Description</h2>=0A=
Header file for the class exotkAF_ViewType.=0A=
<p>=0A=
=0A=
<p>=0A=
<dl compact><dt><b>=0A=
Author: </b><dd>=0A=
<a target=3D"top" =
href=3D"mailto:ste...@ex...?subject=3DexotkAF_ViewType.hx=
x">Stephane Routelous</a></dl>=0A=
<p>=0A=
Definition in file <a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx-source.html">exotkAF_ViewType.hxx</a>.<hr>=
<h2>Enumeration Type Documentation</h2>=0A=
<a name=3D"a9" doxytag=3D"exotkAF_ViewType.hxx::exotkAF_ViewType"></a><p>=0A=
<table width=3D"100%" cellpadding=3D"2" cellspacing=3D"0" border=3D"0">=0A=
  <tr>=0A=
    <td class=3D"md">=0A=
      <table cellpadding=3D"0" cellspacing=3D"0" border=3D"0">=0A=
        <tr>=0A=
          <td class=3D"md" nowrap valign=3D"top"> enum exotkAF_ViewType=0A=
      </table>=0A=
    </td>=0A=
  </tr>=0A=
</table>=0A=
<table cellspacing=3D5 cellpadding=3D0 border=3D0>=0A=
  <tr>=0A=
    <td>=0A=
      &nbsp;=0A=
    </td>=0A=
    <td>=0A=
=0A=
<p>=0A=
<dl compact><dt><b>=0A=
Enumeration values:</b><dd>=0A=
<table border=3D0 cellspacing=3D2 cellpadding=3D0>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a0" =
doxytag=3D"exotkAF_vtFront"></a><em>exotkAF_vtFront</em></em>&nbsp;</td><=
td>=0A=
front </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a1" =
doxytag=3D"exotkAF_vtBack"></a><em>exotkAF_vtBack</em></em>&nbsp;</td><td=
>=0A=
back </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a2" =
doxytag=3D"exotkAF_vtRight"></a><em>exotkAF_vtRight</em></em>&nbsp;</td><=
td>=0A=
right </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a3" =
doxytag=3D"exotkAF_vtLeft"></a><em>exotkAF_vtLeft</em></em>&nbsp;</td><td=
>=0A=
left </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a4" =
doxytag=3D"exotkAF_vtTop"></a><em>exotkAF_vtTop</em></em>&nbsp;</td><td>=0A=
top </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a5" =
doxytag=3D"exotkAF_vtBottom"></a><em>exotkAF_vtBottom</em></em>&nbsp;</td=
><td>=0A=
bottom </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a6" =
doxytag=3D"exotkAF_vtAxo"></a><em>exotkAF_vtAxo</em></em>&nbsp;</td><td>=0A=
axo </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a7" =
doxytag=3D"exotkAF_vtUserDefined"></a><em>exotkAF_vtUserDefined</em></em>=
&nbsp;</td><td>=0A=
user defined </td></tr>=0A=
<tr><td valign=3Dtop><em><a name=3D"a9a8" =
doxytag=3D"exotkAF_vtMaxEnum"></a><em>exotkAF_vtMaxEnum</em></em>&nbsp;</=
td><td>=0A=
must be the last enum menber </td></tr>=0A=
</table>=0A=
</dl>=0A=
=0A=
<p>=0A=
Definition at line <a class=3D"el" =
href=3D"exotkAF__ViewType_8hxx-source.html#l00036">36</a> of file <a =
class=3D"el" =
href=3D"exotkAF__ViewType_8hxx-source.html">exotkAF_ViewType.hxx</a>.    =
</td>=0A=
  </tr>=0A=
</table>=0A=
<hr><address><small>Generated on Mon Feb 11 13:40:56 2002 for exotk by=0A=
<a href=3D"http://www.doxygen.org/index.html">=0A=
<img src=3D"doxygen.gif" alt=3D"doxygen" align=3D"middle" border=3D0 =0A=
width=3D110 height=3D53></a>1.2.13.1 written by <a =
href=3D"mailto:di...@st...">Dimitri van Heesch</a>,=0A=
 &copy;&nbsp;1997-2001</small></address>=0A=
</body>=0A=
</html>=0A=

[Doxygen-users] Doxygen-1.2.13-20020210 in CVS

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

Hi,

In this week's release the following has changed:
-----------------------------------------------------------------------------
+ ADD: Added new command \~language_id to create sections that
       are outputted for the language <language_id> only:
       Example:
       /** \~czech Cesky komentar \~english English comment text \~dutch
            Nederlands commentaar \~ Common comment for all languages,
            this tag switches off the language filter...
       */
       Which of the language specific fragments is outputed depends
       on the setting of OUTPUT_LANGUAGE (Thanks to Milan Rusek for the patch).
+ ADD: Included update for Japanese (thanks to Ryunosuke Sato)
+ ADD: Added build support for Cygwin (thanks to Ryunosuke Sato).
+ ADD: Added new option HTML_FILE_EXTENSION to allow different file extension
       for the html file outputted by doxygen (like .php). Thanks to
       Rob Olsthoorn for the patch.
+ ADD: Added template parameter lists for classes to the XML output.
+ ADD: In the documentation of class, namespace, file, and group items a
       list of groups to which the item belongs is put between brackets ([..])
       under the title (HTML only).
+ BUG: Fixed escaping problem in Makefile generated for latex output.
+ BUG: File names were sometimes prefixed for undocumented classes in the
       class hierarchy.
+ BUG: Documenting defines with @param caused bogus warnings.
+ BUG: When computing the list of all members, interface members are now
       treated as virtual.
+ BUG: Protected members of a base class did not appear as such in the list of
       all members of derived classes.
+ BUG: Fixed problem with ending itemized lists before paragraph commands
       (like @see), which resulted in invalid output.
-----------------------------------------------------------------------------
Enjoy,
  Dimitri

RE: [Doxygen-users] Documenting from inside a function

[Scot W. <sc...@wi...>]

> A way to do what you desire is with the @fn command followed by the
> exact prototype. Where you are using it in your example now, it isn't
> needed. That command block is already associated with foo.

You mean I can just put @fn ahead of the actual declaration and it will
be picked up?  Great, I hate having two copies of the same text.

Anyone know if I can put @mainpage in the middle of another comment
block to have some stuff be duplicated to the main page (as well as its
usual place)?  I couldn't find an incantation which behaved that way.

> However, from within foo to get the comment block associated
> properly, you can use the @fn.

Use it how?  Repeat "@fn functionname" in each comment block related to
the function?  Something like sound nice...I didn't distill that from
the Doxygen dox.

[Doxygen-users] Text For [INLINE] Images in Doxygen Doc

[Scot W. <sc...@wi...>]

Because no graphical browser is available on the machine, I printed the Doxygen 
HTML documentation using Lynx within a2ps.

Scattered in the documentation are "[INLINE]" symbols due to images being used 
in some places instead of words -- I believe the "Doxygen" logo is used that 
way in several places.  It would be nice if alt="Alternate Text" were included 
in all the Image references.

RE: [Doxygen-users] Question regarding tagfiles

[Morgenthaler, G. <g.m...@vi...>]

>> I'm a newbie at using Doxygen and I'm trying to get the=20
>> TAGFILES feature to work.
[cut]
>> TAGFILES =3D proj1/proj1.tag=3Dc:/temp/proj1

Ahhh, the tagfile discussion - again ;-)

> Your syntax for the tagfiles might be wrong. Try this in your second
> project:
> >>>>>      TAGFILES =3D c:/temp/proj1/proj1.tag

Glenn, I think his SYNTAX is quite right BUT he may have problems
with absolute/relative paths, depending where he calls doxygen and
where he has the configuration file located.

Marcus, here is my answer from a thread Glenn and I had some time ago.
Try to adapt the path as shown in my example, then it should work.

----------------------------- snip ----------------------------------

> Your statement is only partly true. Installdox isn't just for moving a
> system or search.
> If you are creating a system out of multiple Doxygen runs and one
> system depends/inherits from another, you would:
> 1) Have the parent system generate a tag file.
> 2) Have the child system reference the tag file.
> 3) Later, after the system is built, use installdox to resolve
>    inherited references.

And I thought I'm doing exactly this without needing step 3) ;-)

I have a library at:

~/src/boblib/*.cpp *.hpp
~/src/boblib/doc/doxygen.cfg

I have a library at:

~/src/flclib/*.cpp *.hpp
~/src/flclib/doc/doxygen.cfg

And a program that uses that libraries at:

~/src/flcman/*.cpp *.hpp
~/src/flcman/doc/doxygen.cfg

What I do is:

1) I create the documentation and tagfile for boblib in
~/src/boblib/doc/boblib.tag
~/src/boblib/doc/html/
thru running doxygen doxygen.cfg in
~/src/boblib/doc

2) I create the documentation and tagfile for flclib in
~/src/flclib/doc/boblib.tag
~/src/flclib/doc/html/
thru running doxygen doxygen.cfg in
~/src/flclib/doc

3) I create the documentation for flcman in
~src/flcman/doc/html/
with:
TAGFILES =3D ../../boblib/doc/boblib.tag=3D../../../boblib/doc/html \
           ../../flclib/doc/flclib.tag=3D../../../flclib/doc/html
thru running doxygen doxygen.cfg in
~/src/flcman/doc

The links in flcman documentation are resolved to boblib and flclib.

Still no installdox involved.

----------------------------- snip ----------------------------------

Regards, Germar

RE: [Doxygen-users] Question regarding tagfiles

[Glenn M. <gle...@vo...>]

Your syntax for the tagfiles might be wrong. Try this in your second
project:

>>>>>      TAGFILES =3D c:/temp/proj1/proj1.tag

Also, I have some perl tools that can help you wrap your two projects
together into a single system. Let me know if you want them. I'm company
has given me permission to open-source them.

Glenn Maxey
Technical Writer
Voyant Technologies, Inc.
1765 West 121st Avenue
Westminster, CO 80234-2301
Tel. +1 303.223.5164
Fax. +1 303.223.5275
gle...@vo...


> -----Original Message-----
> From: mol...@fa... [mailto:mol...@fa...]
> Sent: Friday, February 08, 2002 7:43 AM
> To: Dox...@li...
> Subject: [Doxygen-users] Question regarding tagfiles
>=20
>=20
> Hello,
>=20
> I'm a newbie at using Doxygen and I'm trying to get the=20
> TAGFILES feature to
> work.
>=20
> My current directory setup looks like this
>=20
> c: +
>     + temp +
>                   + proj1
>                   + proj2
>=20
> Directory proj2 contains source that uses proj1.  I was looking at the
> documentation for TAGFILES, and using that
> as my template, I set up the config files as follows (btw I am using
> hardcoded directory paths, just as a first cut to try
> and get something working):
>=20
>      proj1.cfg:
>           INPUT =3D c:/temp/proj1
>           OUTPUT_DIRECTORY =3D c:/temp/proj1
>           GENERATE_TAGFILE =3D c:/temp/proj1/proj1.tag
>=20
>      proj2.cfg
>           INPUT =3D c:/temp/proj2
>           OUTPUT_DIRECTORY =3D c:/temp/proj2
>           TAGFILES =3D proj1/proj1.tag=3Dc:/temp/proj1
>=20
> I was under the impression that if you specify a path for the=20
> TAGFILES,
> doxygen will not generate an installdox perl script,
> but instead will just resolve the links automatically. =20
> However, this is
> not happening.  When I execute on proj1.cfg, I get the
> tag file as expected (in c:/temp/proj1).  But when I execute=20
> proj2.cfg, it
> generates an installdox perl script.
>=20
> My questions are, 1) Should doxygen resolve the links=20
> automatically? and 2)
> if it should, what is wrong with the above configuration
> file?  The only thing I could think of was the directory=20
> specification of
> proj2's TAGFILES, but it seems to follow the model in the
> example on www.doxygen.org
>=20
> Thanks in advance
>=20
> Marcus C. Oladell
> Software Engineer
> FactSet Research Systems
> mol...@fa...
>=20
>=20
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>=20

[Doxygen-users] Question regarding tagfiles

[<mol...@fa...>]

Hello,

I'm a newbie at using Doxygen and I'm trying to get the TAGFILES feature to
work.

My current directory setup looks like this

c: +
    + temp +
                  + proj1
                  + proj2

Directory proj2 contains source that uses proj1.  I was looking at the
documentation for TAGFILES, and using that
as my template, I set up the config files as follows (btw I am using
hardcoded directory paths, just as a first cut to try
and get something working):

     proj1.cfg:
          INPUT = c:/temp/proj1
          OUTPUT_DIRECTORY = c:/temp/proj1
          GENERATE_TAGFILE = c:/temp/proj1/proj1.tag

     proj2.cfg
          INPUT = c:/temp/proj2
          OUTPUT_DIRECTORY = c:/temp/proj2
          TAGFILES = proj1/proj1.tag=c:/temp/proj1

I was under the impression that if you specify a path for the TAGFILES,
doxygen will not generate an installdox perl script,
but instead will just resolve the links automatically.  However, this is
not happening.  When I execute on proj1.cfg, I get the
tag file as expected (in c:/temp/proj1).  But when I execute proj2.cfg, it
generates an installdox perl script.

My questions are, 1) Should doxygen resolve the links automatically? and 2)
if it should, what is wrong with the above configuration
file?  The only thing I could think of was the directory specification of
proj2's TAGFILES, but it seems to follow the model in the
example on www.doxygen.org

Thanks in advance

Marcus C. Oladell
Software Engineer
FactSet Research Systems
mol...@fa...

RE: [Doxygen-users] Documenting from inside a function

[Glenn M. <gle...@vo...>]

A way to do what you desire is with the @fn command followed by the =
exact prototype. Where you are using it in your example now, it isn't =
needed. That command block is already associated with foo.

However, from within foo to get the comment block associated properly, =
you can use the @fn.

Another point which is minor, you can prefix lines within your comment =
block with things like ** and Doxygen will ignore them. This way the =
comment block will look like a comment block. See my example.

What I don't know and haven't experimented with is whether the entire =
documentation for a code item can be distributed. (In my stuff on =
occassion, the comments can be separate from the code, but the comments =
are in their entirety. I don't have piecemeal comments that get merged =
together.)

If Doxygen doesn't work with piecemeal comments and doesn't combine them =
into one, what I would do is a perl input filter that collects the =
comments and outputs them where they should be just prior to processing =
by Doxygen.

<snip>
/** @brief foo is the bar.
 **
 ** @param in_bar you're in.
 ** @param out_bar you're out.
 **
 ** Here's overview stuff about foo and is automatically
 ** associated with foo just by its placement in front of foo.
*/
void foo (const Bar& in_bar,Bar& out_bar)
{
	//... some distance into the fn body.
	//	a point is encountered where it
	//	would be nice to have a comment
	//	that is both parsed by Doxygen
	//	and "in place" in the code.

	/** @fn void foo (const Bar& in_bar,Bar& out_bar)
       **
       **	@note The stuff immediately after
       **	this comment does something
       **	that I think you should know
       **	about, even if you're too
       **	lazy to look through it all.
	 **/

	out_bar << ::fooify(in_bar);

	//...
}
</snip>

HTH,

Glenn Maxey
Technical Writer
Voyant Technologies, Inc.
1765 West 121st Avenue
Westminster, CO 80234-2301
Tel. +1 303.223.5164
Fax. +1 303.223.5275
gle...@vo...


> -----Original Message-----
> From: Smith, David [mailto:smi...@ty...]
> Sent: Thursday, February 07, 2002 3:31 PM
> To: dox...@li...
> Subject: [Doxygen-users] Documenting from inside a function
>=20
>=20
> <snip>
> /**
> 	@fn void foo (const Bar& in_bar,Bar& out_bar)
> */
> void foo (const Bar& in_bar,Bar& out_bar)
> {
> 	//... some distance into the fn body.
> 	//	a point is encountered where it
> 	//	would be nice to have a comment
> 	//	that is both parsed by Doxygen
> 	//	and "in place" in the code.
>=20
> 	/**
> 		@note
> 			The stuff immediately after
> 			this comment does something
> 			that I think you should know
> 			about, even if you're too
> 			lazy to look through it all.
> 	*/
>=20
> 	out_bar << ::fooify(in_bar);
>=20
> 	//...
> }
> </snip>
>=20
> Hi,
>=20
> 	A quick question. Is it possible to get
> Doxygen to associate comment blocks occurring
> within a function body with that function? If
> not, has anyone found a means to accomplish
> something similar that they'd care to share?
>=20
> Thanks much,
> Dave
>=20
> _______________________________________________
> Doxygen-users mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-users
>=20

[Doxygen-users] Documenting from inside a function

[Smith, D. <smi...@ty...>]

<snip>
/**
	@fn void foo (const Bar& in_bar,Bar& out_bar)
*/
void foo (const Bar& in_bar,Bar& out_bar)
{
	//... some distance into the fn body.
	//	a point is encountered where it
	//	would be nice to have a comment
	//	that is both parsed by Doxygen
	//	and "in place" in the code.

	/**
		@note
			The stuff immediately after
			this comment does something
			that I think you should know
			about, even if you're too
			lazy to look through it all.
	*/

	out_bar << ::fooify(in_bar);

	//...
}
</snip>

Hi,

	A quick question. Is it possible to get
Doxygen to associate comment blocks occurring
within a function body with that function? If
not, has anyone found a means to accomplish
something similar that they'd care to share?

Thanks much,
Dave