doxygen-develop — List for discussing new features, submitting patches, etc.

[Doxygen-develop] Seamless documentation for project with C++ and VHDL

[Martin Z. <mar...@df...>]

Hi,

I'm setting up a documentation about some sort of library which consists
of a C/C++ part and a VHDL part, plus some instructive doxygen-only
pages. They have to be put into one self-contained group with several
subgroups separated by language and so on. Everything works so far, nice
and fluffy...

But what if I want to optimise the output in the vhdl-subdirectory by
using 'OPTIMISE_OUTPUT_VHDL = YES' and optimise the output of the
c-subdirectory by using 'OPTIMISE_OUTPUT_C = YES' at the same time?

As far as I understand, using doxygen-tags is not optimal in my case,
since it introduces new doxyfile.conf-files in each subdirectory, with
independent runs of doxygen in each subdirectory. So, doing this I can't
put both parts (c and vhdl) in different subgroups of the same group
any more, and links between the two parts are not possible. Also, the
whole module should be "self-contained", to be includable into bigger
documentations, without the special build-structure involved in this
solution...

What would you do?


see also my earlier posts at Stackoverflow and doxygen-users about the
same problem:
http://stackoverflow.com/questions/5102770/doxygen-seamless-documentation-for-project-with-c-and-vhdl

http://sourceforge.net/mailarchive/forum.php?thread_name=1298967113.3440.153.camel%40mzenzes-u&forum_name=doxygen-users

Re: [Doxygen-develop] Smart Pointers

[Robert N. <rn...@re...>]

I attached the patch to implement handling of operator ->() for Smart Pointer support to bug # 333931.

The problem described below seems to be caused by the call context being set to the template class instead of the specific instantiation of it.  If anyone has any suggestions on how to fix it I'd really appreciate it.  This is the only thing remaining to have proper "Referenced By" and "References" when using smart pointers.

-----Original Message-----
From: Robert Nelson 
Sent: Tuesday, March 08, 2011 1:17 PM
To: dox...@li...
Subject: [Doxygen-develop] Smart Pointers

I'm implementing support for smart pointers.  I have the operator ->() part working but I'm hitting a problem with typedefs and was hoping someone could point me in the right direction.

For example given the following code:

template<class T>
class CPointer
{
public:
    T *operator ->(void) const
    {
        return m_pObject;
    }

private:
    T * m_pObject;
};
	
class   CTest
{
public:
    void Func(void)
    {
    }
};

CPointer<CTest> pTest;

typedef CPointer<CTest> CTestPtr;

CTestPtr pTest2;

pTest->Func();    // Works

pTest2->Func();	// Doesn't work.



------------------------------------------------------------------------------
What You Don't Know About Data Connectivity CAN Hurt You
This paper provides an overview of data connectivity, details
its effect on application quality, and explores various alternative
solutions. http://p.sf.net/sfu/progress-d2d
_______________________________________________
Doxygen-develop mailing list
Dox...@li...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

Re: [Doxygen-develop] Smart Pointers

[Robert N. <rn...@re...>]

No I want references through smart pointers to work.  See bug # 333931.

I've written a fix for that bug, however smart pointers are frequently wrapped 
in a typedef and that part isn't working.

-----Original Message-----
From: Jordi Gutiérrez Hermoso [mailto:jo...@gm...] 
Sent: Tuesday, March 08, 2011 2:07 PM
To: Robert Nelson
Cc: dox...@li...
Subject: Re: [Doxygen-develop] Smart Pointers

On 8 March 2011 15:17, Robert Nelson <rn...@re...> wrote:
> I'm implementing support for smart pointers.

I don't understand. Do you meant Doxygen should generate documentation
for smart pointers in a special way? They're just another C++ class.

- Jordi G. H.

Re: [Doxygen-develop] Smart Pointers

[Jordi G. H. <jo...@gm...>]

On 8 March 2011 15:17, Robert Nelson <rn...@re...> wrote:
> I'm implementing support for smart pointers.

I don't understand. Do you meant Doxygen should generate documentation
for smart pointers in a special way? They're just another C++ class.

- Jordi G. H.

[Doxygen-develop] Smart Pointers

[Robert N. <rn...@re...>]

I'm implementing support for smart pointers.  I have the operator ->() part working but I'm hitting a problem with typedefs and was hoping someone could point me in the right direction.

For example given the following code:

template<class T>
class CPointer
{
public:
    T *operator ->(void) const
    {
        return m_pObject;
    }

private:
    T * m_pObject;
};
	
class   CTest
{
public:
    void Func(void)
    {
    }
};

CPointer<CTest> pTest;

typedef CPointer<CTest> CTestPtr;

CTestPtr pTest2;

pTest->Func();    // Works

pTest2->Func();	// Doesn't work.

Re: [Doxygen-develop] Winbuild Missing Files

[Todd <lev...@gm...>]

Hi Dimitri,

Thanks for the help. I'm up and running now.

I had already done all the updates to the environment variables. The build
worked when I downloaded and used the tarball.

I thought I would be able to check out from SVN and build from that. Not
sure why that didn't work but that is ok.  :)

Thanks,

Todd


On Wed, Mar 2, 2011 at 10:56 AM, Dimitri Van Heesch <do...@gm...>wrote:

> Hi Todd,
>
> On Mar 2, 2011, at 1:13 , Todd wrote:
>
> > Hi all,
> >
> > I just checked out trunk and am trying to build on Windows.
> >
> > When I try to build the Doxygen project, I get the following error:
> PRJ0019: A tool returned an error code from "Executing Lex for
> c:\Doxygen\src\/scanner.cpp ...".
> >
> > Scanner.cpp has a question mark next to it in Visual Studio. Any ideas
> what might be causing this?
>
> Did you do the part starting with "The next step ..." mentioned here?
> http://www.doxygen.org/install.html#install_src_windows
>
> Regards,
>   Dimitri
>
>

Re: [Doxygen-develop] Fortran code test suite

[Arnold.Steve <arn...@en...>]

Howdy:

I haven't played with Photran for a while, but I'm pretty sure it also relies on the gcc/gfortran toolchain (or some other Fortran compiler) for much of the work.  That said, the Java stuff in the .jar files should include the language-sensitive parts (for the Eclipse editor) and maybe some basic analysis tools (the latter is just a guess).

I'm thinking the OpenFortranParser thing would be your best bet...

Steve

________________________________________
From: Albert [alb...@gm...]
Sent: Wednesday, March 02, 2011 10:12 AM
To: Oleg Batrashev
Cc: dox...@li...
Subject: Re: [Doxygen-develop] Fortran code test suite

Hi Oleg,

Thanks for your support.
I've had a quick look at the OpenFortranParser site and in the
downloads there are quite a few test files (so I'll have a go at
them). Photran is packed in jar files so I have to Install it, I will
have a go at it (didn't see a test suite there yet).

Best Regards,

Albert

On Wed, Mar 2, 2011 at 07:05, Oleg Batrashev <og...@gm...> wrote:
> Hi Albert,
>
> On Tue, Mar 1, 2011 at 9:25 PM, Albert <alb...@gm...> wrote:
>> Dear all,
>> I think it would be a good idea to have some sort of test suite to
>> test if all Fortran constructs and especially the newer ones are
>> covered by Doxygen.
> This is a good idea. Especially, if it is possible to match doxygen
> output against predefined answer, so not only program errors are
> caught but also failures. I doubt however that it is easy to achieve.
>
>> The reason for this email is: does anybody know more places with test
>> suites for Fortran that can be used to find possible problems ?
> The only idea I have is to look into Fortran parsers,e.g.
> OpenFortranParser
> http://fortran-parser.sourceforge.net/
> Phortran
> http://www.eclipse.org/photran/
>
> Best,
> Oleg
>
>>
>> Albert
>>
>> ------------------------------------------------------------------------------
>> Free Software Download: Index, Search & Analyze Logs and other IT data in
>> Real-Time with Splunk. Collect, index and harness all the fast moving IT data
>> generated by your applications, servers and devices whether physical, virtual
>> or in the cloud. Deliver compliance at lower cost and gain new business
>> insights. http://p.sf.net/sfu/splunk-dev2dev
>> _______________________________________________
>> Doxygen-develop mailing list
>> Dox...@li...
>> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>>
>

------------------------------------------------------------------------------
Free Software Download: Index, Search & Analyze Logs and other IT data in
Real-Time with Splunk. Collect, index and harness all the fast moving IT data
generated by your applications, servers and devices whether physical, virtual
or in the cloud. Deliver compliance at lower cost and gain new business
insights. http://p.sf.net/sfu/splunk-dev2dev
_______________________________________________
Doxygen-develop mailing list
Dox...@li...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

The information contained in this email message is intended only for the use of the individual(s) to whom it is addressed and may contain information that is privileged and sensitive. If you are not the intended recipient, or otherwise have received this communication in error, please notify the sender immediately by email at the above referenced address and note that any further dissemination, distribution or copying of this communication is strictly prohibited.

The U.S. Export Control Laws regulate the export and re-export of technology originating in the United States. This includes the electronic transmission of information and software to foreign countries and to certain foreign nationals. Recipient agrees to abide by these laws and their regulations -- including the U.S. Department of Commerce Export Administration Regulations and the U.S. Department of State International Traffic in Arms Regulations -- and not to transfer, by electronic transmission or otherwise, any content derived from this email to either a foreign national or a foreign destination in violation of such laws.

Re: [Doxygen-develop] Winbuild Missing Files

[mkk1 <mk...@gm...>]

have you installted flex/bison ? see GnuTools

Todd-75 wrote:
> 
> Hi all,
> 
> I just checked out trunk and am trying to build on Windows.
> 
> When I try to build the Doxygen project, I get the following error:
> PRJ0019:
> A tool returned an error code from "Executing Lex for
> c:\Doxygen\src\/scanner.cpp ...".
> 
> Scanner.cpp has a question mark next to it in Visual Studio. Any ideas
> what
> might be causing this?
> 
> Thanks,
> 
> Todd
> 
> ------------------------------------------------------------------------------
> Free Software Download: Index, Search & Analyze Logs and other IT data in 
> Real-Time with Splunk. Collect, index and harness all the fast moving IT
> data 
> generated by your applications, servers and devices whether physical,
> virtual
> or in the cloud. Deliver compliance at lower cost and gain new business 
> insights. http://p.sf.net/sfu/splunk-dev2dev 
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
> 
> 

-- 
View this message in context: http://old.nabble.com/Winbuild-Missing-Files-tp31049364p31052409.html
Sent from the Doxygen - Development mailing list archive at Nabble.com.

Re: [Doxygen-develop] Winbuild Missing Files

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

Hi Todd,

On Mar 2, 2011, at 1:13 , Todd wrote:

> Hi all,
> 
> I just checked out trunk and am trying to build on Windows.
> 
> When I try to build the Doxygen project, I get the following error: PRJ0019: A tool returned an error code from "Executing Lex for c:\Doxygen\src\/scanner.cpp ...". 
> 
> Scanner.cpp has a question mark next to it in Visual Studio. Any ideas what might be causing this?

Did you do the part starting with "The next step ..." mentioned here?
http://www.doxygen.org/install.html#install_src_windows

Regards,
  Dimitri

Re: [Doxygen-develop] Fortran code test suite

[Albert <alb...@gm...>]

Hi Oleg,

Thanks for your support.
I've had a quick look at the OpenFortranParser site and in the
downloads there are quite a few test files (so I'll have a go at
them). Photran is packed in jar files so I have to Install it, I will
have a go at it (didn't see a test suite there yet).

Best Regards,

Albert

On Wed, Mar 2, 2011 at 07:05, Oleg Batrashev <og...@gm...> wrote:
> Hi Albert,
>
> On Tue, Mar 1, 2011 at 9:25 PM, Albert <alb...@gm...> wrote:
>> Dear all,
>> I think it would be a good idea to have some sort of test suite to
>> test if all Fortran constructs and especially the newer ones are
>> covered by Doxygen.
> This is a good idea. Especially, if it is possible to match doxygen
> output against predefined answer, so not only program errors are
> caught but also failures. I doubt however that it is easy to achieve.
>
>> The reason for this email is: does anybody know more places with test
>> suites for Fortran that can be used to find possible problems ?
> The only idea I have is to look into Fortran parsers,e.g.
> OpenFortranParser
> http://fortran-parser.sourceforge.net/
> Phortran
> http://www.eclipse.org/photran/
>
> Best,
> Oleg
>
>>
>> Albert
>>
>> ------------------------------------------------------------------------------
>> Free Software Download: Index, Search & Analyze Logs and other IT data in
>> Real-Time with Splunk. Collect, index and harness all the fast moving IT data
>> generated by your applications, servers and devices whether physical, virtual
>> or in the cloud. Deliver compliance at lower cost and gain new business
>> insights. http://p.sf.net/sfu/splunk-dev2dev
>> _______________________________________________
>> Doxygen-develop mailing list
>> Dox...@li...
>> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>>
>

Re: [Doxygen-develop] Winbuild Missing Files

[<jon...@no...>]

Hi,

Not sure about the question mark but trunk builds fine for me on windows. That looks like a flex windows error (I have gotten a few of these in the past). Where did you get the version of flex you are using? (unxutils, msys, mingw etc.) I use the version provided with unxutils and once I set the BISON_SIMPLE variable it worked fine.
Regards,
Jon.

From: ext Todd [mailto:lev...@gm...]
Sent: 02 March 2011 00:13
To: Doxygen-dev
Subject: [Doxygen-develop] Winbuild Missing Files

Hi all,

I just checked out trunk and am trying to build on Windows.

When I try to build the Doxygen project, I get the following error: PRJ0019: A tool returned an error code from "Executing Lex for c:\Doxygen\src\/scanner.cpp ...".

Scanner.cpp has a question mark next to it in Visual Studio. Any ideas what might be causing this?

Thanks,

Todd

Re: [Doxygen-develop] Fortran code test suite

[Oleg B. <og...@gm...>]

Hi Albert,

On Tue, Mar 1, 2011 at 9:25 PM, Albert <alb...@gm...> wrote:
> Dear all,
> I think it would be a good idea to have some sort of test suite to
> test if all Fortran constructs and especially the newer ones are
> covered by Doxygen.
This is a good idea. Especially, if it is possible to match doxygen
output against predefined answer, so not only program errors are
caught but also failures. I doubt however that it is easy to achieve.

> The reason for this email is: does anybody know more places with test
> suites for Fortran that can be used to find possible problems ?
The only idea I have is to look into Fortran parsers,e.g.
OpenFortranParser
http://fortran-parser.sourceforge.net/
Phortran
http://www.eclipse.org/photran/

Best,
Oleg

>
> Albert
>
> ------------------------------------------------------------------------------
> Free Software Download: Index, Search & Analyze Logs and other IT data in
> Real-Time with Splunk. Collect, index and harness all the fast moving IT data
> generated by your applications, servers and devices whether physical, virtual
> or in the cloud. Deliver compliance at lower cost and gain new business
> insights. http://p.sf.net/sfu/splunk-dev2dev
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>

[Doxygen-develop] Winbuild Missing Files

[Todd <lev...@gm...>]

Hi all,

I just checked out trunk and am trying to build on Windows.

When I try to build the Doxygen project, I get the following error: PRJ0019:
A tool returned an error code from "Executing Lex for
c:\Doxygen\src\/scanner.cpp ...".

Scanner.cpp has a question mark next to it in Visual Studio. Any ideas what
might be causing this?

Thanks,

Todd

[Doxygen-develop] Fortran code test suite

[Albert <alb...@gm...>]

Dear all,

Currently my main interest for Doxygen is with the Fortran part. When
using Doxygen, for Fortran, I've noticed some bugs and I've tried to
fix some bugs.
A type of bug that is quite annoying is of the form:
********************************************************************
Error in file /cygdrive/c/Users/user/AppData/Local/Temp/dg/Wall.f90
line: 14, state: 10
********************************************************************
as most of the time it is quite unclear where the problem is and can
only be found by stripping the code to the bare minimum.

I think it would be a good idea to have some sort of test suite to
test if all Fortran constructs and especially the newer ones are
covered by Doxygen.
I've been looking around the Internet and found a test suite with
gfortran / gcc. This test suite is quite large and does not only
contain correct programs but also tests to have the compiler emit
errors. For Doxygen, I think, we should concentrate on programs that
do compile (and are standard conforming).

I've only looked if the programs didn't throw an error message, I have
not looked at the results.
With the aid of this suite I did find some problems eg:
- variable with the name "type" confuses Doxygen (Doxygen thinks it is
the start of a type definition)
- construct "type is" (new since Fortran 2003) confuses Doxygen
- block data is not handled by Doxygen (existing bug 567494)
- double complex is not handled by Doxygen (this is not standard
conforming code)
- the "extends" keyword gives an error message from the file
fortrancode.l (When in the Doxyfile the option SOURCE_BROWSER = YES)
For the first 2 I'm going to submit a bug report, found for the "type
is" already a solution. The "double complex" is not standard Fortran
so I won't submit a bug report for it, users should use
complex(kind=1.0d1) or similar). For the "extends" problem I'll append
my example to bug 598481.

The reason for this email is: does anybody know more places with test
suites for Fortran that can be used to find possible problems ?

Best Regards,

Albert

[Doxygen-develop] Broken subpage links?

[Watts, S. (UK) <SW...@ng...>]

Hi all,

I am seeing broken subpage links in PDF/Latex output for a medium sized project.

Now, I have made a small test project in which these links *do* work, but I have not been able to deduce what would cause it to be failing in the "real" project...

The links are correctly formed in the HTML output, and the subpages can be reached from the main PDF navigation and contents page.  It appears to be _only_ the links from @subpage entries which are broken for PDF/Latex.

The links appear to be malformed in the raw tex output, as shown below.


Each page and its subpages are contained in their own '.dox' file, with a separate comment block for the page and each subpage, as shown in the following sample:

Sample source file:  "page-specifications.dox":
---------------------------------------------
/**	@page P0150overview Overview

	...blah...

	Topics covered:
	 - @subpage overview01 "Thingy"
	 - @subpage overview02 "Widget"
*/


/**	@page overview01 Tickling the Thingy
	
	...blah...
 */


/**	@page overview02 Winding the Widget

	...blah...
 */
---------------------------------------------

Tex output (snippet): ".../a00024.tex":
---------------------------------------------
	\begin{DoxyItemize}
	\item \hyperlink{a00025}{Thingy}	%< broken link
	\item \hyperlink{a00026}{Widget}	%< broken link
	\end{DoxyItemize}
	\hypertarget{overview01}{}     	%< first subpage target
	\section{Tickling the Thingy}
	\label{overview01}
	 ...
---------------------------------------------

NOTE: The broken links have names in the form "a%05d", sequentially following the filename.  There are also tex files in the latex output with these names (".../a00025.tex" etc), which are unrelated to this page and its subpages.


In addition (maybe related); the text in the pages (and subpages) mentions classes from the API being documented (as "Klass", "Klass::method()"), which I would expect to be auto-linked.  This is not happening, but such links are formed in the API documentation, and within code blocks (@code...@endcode, and @include) in these pages.




Any suggestions?


Simon./

[Doxygen-develop] Incorrect included-by graphs generated

[Vincent B. <vbe...@en...>]

Hi,

Updating doxygen to the most recent version, I get very wrong
included-by graphs (instead of all files including a given one, I only
get one of them, which is much less useful ...). What I want:

    http://www.umpa.ens-lyon.fr/~vbeffara/files/good_1.5.6.png

What I get with the most recent version:

    http://www.umpa.ens-lyon.fr/~vbeffara/files/bad_1.7.3.png

Did the syntax change at some point, or did I get the right result just
by chance ? Or is it a bug in doxygen ?

I did a bisect search, the first release exhibiting the bad output is
"Release-1.7.2-20101118" (SVN 748), which contains a huge rewrite of
dot.cpp, but I had no time to look further ...

Cheers,

        /vincent

-- 
|                 |   Umpa - ENS Lyon   | Mél: vbe...@en... |
| Vincent Beffara |  46 allée d'Italie  | Tél: (+33) 4 72 72 85 25  |
|                 | 69364 Lyon Cedex 07 | Fax: (+33) 4 72 72 84 80  |

Re: [Doxygen-develop] [Patch] LATEX_FOOTER

[Mark de W. <m.d...@da...>]

Mark de Wever wrote:
> Hi,
> 
> I recently wanted to add the LaTeX output of Doxygen in the middle of a 
> manual. So I wanted to have a Doxygen generated refman.tex that only 
> adds the list of files needed to include the Doxygen output. With an 
> empty LATEX_HEADER file I could skip the automatic preamble, but alas 
> there was no LATEX_FOOTER option to avoid the generation of the final 
> part (\makeindex\end{document}).
> 
> So I wrote a small patch which adds a LATEX_FOOTER configuration option. 
> The option allows you to use a file to generate the final part of the 
> LaTeX file. If you deem it useful feel free to include it in Doxygen.

I send the message above a while ago, but got no reaction. I'm curious 
is there no interest in the patch or did it went below the radar?

Is is there another place where I should post patches?

Regards,
Mark de Wever

Re: [Doxygen-develop] Scope identification

[Albert <alb...@gm...>]

Thanks, makes it quite a bit easier.

Btw. I also found a small problem in case I have a C class:
class tst
{
  public:
    int *i_ptr;
    int  i_val;
  private:
    int *pri_ptr;
};
In the collaboration diagram i_ptr is shown as an int *, i_val is
shown as an int, but pri_ptr is also shown as an int.
I'll create a bug report for this one.

Best Regards,

Albert

On Mon, Jan 31, 2011 at 20:51, Dimitri Van Heesch <do...@gm...> wrote:
>
> On Jan 31, 2011, at 20:24 , Albert wrote:
>
>> Dear all,
>>
>> I'm working on some problems in regard to collaboration diagrams in
>> Fortran (BUG 637099) and I come across a problem with stripping the
>> Scope from a type. The scope is stripped (stripScope function) by
>> searching from the back to the first colon (:) this works OK in most
>> cases, but in case in Fortran the scope also contains some qualifiers
>> it is possible that one of these qualifiers contains a colon (eg.
>> dimension).
>> In case the scope identification consists always of 2 colons I can
>> easily fix this problem, otherwise it will be a bit harder (have to
>> see in the colon is in round brackets).
>> Can anyone confirm if the scope identification as used inside the
>> Doxygen code always has 2 colons ?
>
> Yes, it follows the C++ convention of using two colons as a scope separator.
>
> Regards,
>  Dimitri
>
>

Re: [Doxygen-develop] Scope identification

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

On Jan 31, 2011, at 20:24 , Albert wrote:

> Dear all,
> 
> I'm working on some problems in regard to collaboration diagrams in
> Fortran (BUG 637099) and I come across a problem with stripping the
> Scope from a type. The scope is stripped (stripScope function) by
> searching from the back to the first colon (:) this works OK in most
> cases, but in case in Fortran the scope also contains some qualifiers
> it is possible that one of these qualifiers contains a colon (eg.
> dimension).
> In case the scope identification consists always of 2 colons I can
> easily fix this problem, otherwise it will be a bit harder (have to
> see in the colon is in round brackets).
> Can anyone confirm if the scope identification as used inside the
> Doxygen code always has 2 colons ?

Yes, it follows the C++ convention of using two colons as a scope separator.

Regards,
  Dimitri

[Doxygen-develop] Scope identification

[Albert <alb...@gm...>]

Dear all,

I'm working on some problems in regard to collaboration diagrams in
Fortran (BUG 637099) and I come across a problem with stripping the
Scope from a type. The scope is stripped (stripScope function) by
searching from the back to the first colon (:) this works OK in most
cases, but in case in Fortran the scope also contains some qualifiers
it is possible that one of these qualifiers contains a colon (eg.
dimension).
In case the scope identification consists always of 2 colons I can
easily fix this problem, otherwise it will be a bit harder (have to
see in the colon is in round brackets).
Can anyone confirm if the scope identification as used inside the
Doxygen code always has 2 colons ?

Thanks,

Best Regards,

Albert

[Doxygen-develop] Bugzilla bug 637099, Fortran: Collaboration diagram

[Albert <alb...@gm...>]

Dear all,

I'm trying to fix the bug: Bugzilla bug 637099, Fortran: Collaboration diagram
To be able to do this I need to know if the current language is
Fortran or not en the routine extractClassNameFromType, util.cpp, as
called from doxygen.cpp find UsedC;lasses. In this case it wold be
easy, adding an argument rootNav -> lang(), but unfortunately
extractClassNameFromType is called on a number of other places as well
and there I don't see how to obtain the language in an easy fashion.
The other places are:
classdef.cpp: is in a #if 0 block, so no problem at the moment
doxygen.cpp: discussed above, from rootNav -< lang()
pycode.l:  easy language is Python
code.l:
util.cpp:

The other 2 are a bit of a problem for me.

Does anyone have a suggestion ?

Best Regards,

Albert

Re: [Doxygen-develop] Underline text

[Jason M. <ko...@gm...>]

On 1/11/2011 10:48 PM, Albert wrote:
> Thanks for the work around for the HTML version, but I'd like to have
> a version that works for all output formats.
>
> Like I wrote I think I have the required values for HTML. rtf and
> latex but I would like to have the equivalences for XML, man, Perl as
> well.

XML and Perl are not standardized formats. That is, they are defined by 
Doxygen itself, whereas HTML, Latex, and RTF have their own 
standardizations. So you can use whatever seems reasonable to you. 
<underline> tags for XML, for example.

To be honest though, I would feel much more comfortable with a solution 
that didn't explicitly use an "underline" tag. HTML uses CSS for styling 
for a reason. I would much rather see a generic "style" element that 
could be applied for HTML to arbitrary text. Something like this:

/** Here's some text. <style class="definition">This text is a 
definition.</style> **/

The HTML formatter would simply output the text in <span> tags with the 
class set to "definition". It would be up to the user to provide a CSS 
that keys off of "definition" to provide the appropriate styling.

> > From your posting I got also that I probably should implement overline
> and line-through (I'll have a look at them as well).
>
> If anybody knows the codes for these features in HTML / latex, rtf etc
> please let me, so I don't have to search for them.
>
> On Fri, Jan 7, 2011 at 12:57, mkk1<mk...@gm...>  wrote:
>>
>> Here is the correct alias
>>
>> ALIASES                = "un=" "bl=" "lt=" "ov="  "ee="
>>
>>
>> Albert_1 wrote:
>>> Dear all,
>>>
>>> In the current version of Doxygen (1.7.3) there are, to the best of my
>>> knowledge, no easy facilities for underlining texts like it is
>>> possible for italic or bold.
>>> I think it would be good to have this possibility by means of the tags  .
>>> Analogous to italic, the following would to the best of my knowledge
>>> valid for underline:
>>> For HTML the code to be generated will be the pair
>>> For Latex it will be \underline{
>>> For RTF it will be \ul
>>> For the other output formats (XML, man, Perl) I don't know the values.
>>>
>>> Please comment,
>>>
>>> Albert
>>>
>>> ------------------------------------------------------------------------------
>>> Learn how Oracle Real Application Clusters (RAC) One Node allows customers
>>> to consolidate database storage, standardize their database environment,
>>> and,
>>> should the need arise, upgrade to a full multi-node Oracle RAC database
>>> without downtime or disruption
>>> http://p.sf.net/sfu/oracle-sfdevnl
>>> _______________________________________________
>>> Doxygen-develop mailing list
>>> Dox...@li...
>>> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>>>
>>>
>> --
>> View this message in context: http://old.nabble.com/Underline-text-tp30581704p30613569.html
>> Sent from the Doxygen - Development mailing list archive at Nabble.com.
>>
>>
>> ------------------------------------------------------------------------------
>> Gaining the trust of online customers is vital for the success of any company
>> that requires sensitive data to be transmitted over the Web.   Learn how to
>> best implement a security strategy that keeps consumers' information secure
>> and instills the confidence they need to proceed with transactions.
>> http://p.sf.net/sfu/oracle-sfdevnl
>> _______________________________________________
>> Doxygen-develop mailing list
>> Dox...@li...
>> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>>
> ------------------------------------------------------------------------------
> Protect Your Site and Customers from Malware Attacks
> Learn about various malware tactics and how to avoid them. Understand
> malware threats, the impact they can have on your business, and how you
> can protect your company and customers by using code signing.
> http://p.sf.net/sfu/oracle-sfdevnl
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>

Re: [Doxygen-develop] Underline text

[Albert <alb...@gm...>]

Thanks for the work around for the HTML version, but I'd like to have
a version that works for all output formats.

Like I wrote I think I have the required values for HTML. rtf and
latex but I would like to have the equivalences for XML, man, Perl as
well.

>From your posting I got also that I probably should implement overline
and line-through (I'll have a look at them as well).

If anybody knows the codes for these features in HTML / latex, rtf etc
please let me, so I don't have to search for them.

On Fri, Jan 7, 2011 at 12:57, mkk1 <mk...@gm...> wrote:
>
>
> Here is the correct alias
>
> ALIASES                = "un=" "bl=" "lt=" "ov="  "ee="
>
>
> Albert_1 wrote:
>>
>> Dear all,
>>
>> In the current version of Doxygen (1.7.3) there are, to the best of my
>> knowledge, no easy facilities for underlining texts like it is
>> possible for italic or bold.
>> I think it would be good to have this possibility by means of the tags  .
>> Analogous to italic, the following would to the best of my knowledge
>> valid for underline:
>> For HTML the code to be generated will be the pair
>> For Latex it will be \underline{
>> For RTF it will be \ul
>> For the other output formats (XML, man, Perl) I don't know the values.
>>
>> Please comment,
>>
>> Albert
>>
>> ------------------------------------------------------------------------------
>> Learn how Oracle Real Application Clusters (RAC) One Node allows customers
>> to consolidate database storage, standardize their database environment,
>> and,
>> should the need arise, upgrade to a full multi-node Oracle RAC database
>> without downtime or disruption
>> http://p.sf.net/sfu/oracle-sfdevnl
>> _______________________________________________
>> Doxygen-develop mailing list
>> Dox...@li...
>> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>>
>>
>
> --
> View this message in context: http://old.nabble.com/Underline-text-tp30581704p30613569.html
> Sent from the Doxygen - Development mailing list archive at Nabble.com.
>
>
> ------------------------------------------------------------------------------
> Gaining the trust of online customers is vital for the success of any company
> that requires sensitive data to be transmitted over the Web.   Learn how to
> best implement a security strategy that keeps consumers' information secure
> and instills the confidence they need to proceed with transactions.
> http://p.sf.net/sfu/oracle-sfdevnl
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
>

Re: [Doxygen-develop] Underline text

[mkk1 <mk...@gm...>]

Here is the correct alias

ALIASES                = "un=" "bl=" "lt=" "ov="  "ee=" 


Albert_1 wrote:
> 
> Dear all,
> 
> In the current version of Doxygen (1.7.3) there are, to the best of my
> knowledge, no easy facilities for underlining texts like it is
> possible for italic or bold.
> I think it would be good to have this possibility by means of the tags  .
> Analogous to italic, the following would to the best of my knowledge
> valid for underline:
> For HTML the code to be generated will be the pair  
> For Latex it will be \underline{
> For RTF it will be \ul
> For the other output formats (XML, man, Perl) I don't know the values.
> 
> Please comment,
> 
> Albert
> 
> ------------------------------------------------------------------------------
> Learn how Oracle Real Application Clusters (RAC) One Node allows customers
> to consolidate database storage, standardize their database environment,
> and, 
> should the need arise, upgrade to a full multi-node Oracle RAC database 
> without downtime or disruption
> http://p.sf.net/sfu/oracle-sfdevnl
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
> 
> 

-- 
View this message in context: http://old.nabble.com/Underline-text-tp30581704p30613569.html
Sent from the Doxygen - Development mailing list archive at Nabble.com.

Re: [Doxygen-develop] Underline text

[mkk1 <mk...@gm...>]

Hi,

here is a workaround for your problem. It only works for HTML.

copy the lines to doxygen_css.h and compile the source (needed for
doxygen.css )

"span.un {text-decoration: underline;}\n"
"span.ov {text-decoration: overline;}\n"
"span.lt {text-decoration: line-through;}\n"
"span.bl {text-decoration: blink;}\n"
"\n"

in your config file insert the alias

ALIASES                = "un=" "bl=" "lt=" "ov="  "ee=" 

//! \bl blinking text \ee
//! \ov overline \ee 
//! \lt <em>line-through</em> \ee 
//! \un underline \ee

should work for a brief description (only tested for brief!)



Albert_1 wrote:
> 
> Dear all,
> 
> In the current version of Doxygen (1.7.3) there are, to the best of my
> knowledge, no easy facilities for underlining texts like it is
> possible for italic or bold.
> I think it would be good to have this possibility by means of the tags <u>
> </u>.
> Analogous to italic, the following would to the best of my knowledge
> valid for underline:
> For HTML the code to be generated will be the pair <u> </u>
> For Latex it will be \underline{
> For RTF it will be \ul
> For the other output formats (XML, man, Perl) I don't know the values.
> 
> Please comment,
> 
> Albert
> 
> ------------------------------------------------------------------------------
> Learn how Oracle Real Application Clusters (RAC) One Node allows customers
> to consolidate database storage, standardize their database environment,
> and, 
> should the need arise, upgrade to a full multi-node Oracle RAC database 
> without downtime or disruption
> http://p.sf.net/sfu/oracle-sfdevnl
> _______________________________________________
> Doxygen-develop mailing list
> Dox...@li...
> https://lists.sourceforge.net/lists/listinfo/doxygen-develop
> 
> 

-- 
View this message in context: http://old.nabble.com/Underline-text-tp30581704p30613047.html
Sent from the Doxygen - Development mailing list archive at Nabble.com.