29 Mar 18:50 2015

### sqlite implementation

Hi all,

I was excited to see the sqlite generator addition back in 1.8.4, as I was struggling with the clunkiness of trying to integrate the in-game developer documentation system for a MUD I admin for with doxygen's XML output. Unfortunately when I took a look at what was being stored in sqlite, it wasn't a step up from what we could get by parsing the xml, so I put the project on hold to see if better support would turn up. It seems like progress on the implementation has been languishing for the past year, so I've been taking a more serious look at what information's being stored, and how much work it'll take to push the existing implementation forward to fit our use case (a slow process, since I haven't worked on doxygen before, or even written any C++ in the last ~12 years...)

At first I thought this might just be a matter of extending support for groups and pages, but as I've been getting my hands dirty I've found a number of issues that suggest that the current implementation probably isn't using an ideal schema or data model. For example, because we have a lot of inheritance relationships documented, our memberdef table has 87100 total records, 70545 of which are duplicates of 3197 unique members that differ only in rowid. I'm hoping to get a sense of whether anyone here:
- already has substantive work done on issues with this implementation that hasn't worked its way upstream to the doxygen repo yet
- is actually using it for something non-trivial (and whether you're using workarounds to do so)

Just hoping to get a sense of whether I am or can avoid reinventing the wheel, and how much resistance there will be to schema changes.

Cheers,
Travis
------------------------------------------------------------------------------
Dive into the World of Parallel Programming The Go Parallel Website, sponsored
by Intel and developed in partnership with Slashdot Media, is your hub for all
things parallel software development, from weekly thought leadership blogs to
news, videos, case studies, tutorials and more. Take a look and join the
conversation now. http://goparallel.sourceforge.net/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

9 Mar 17:46 2015

### Possible bug in writeDotImageMapFromFile()

Hi,

While using the \dot and \dotfile commands, I ran across a potential bug in writeDotImageMapFromFile() in dot.cpp.  The following is a snippet of the existing code:

if (imgExt=="svg") // vector graphics

{

//DotFilePatcher patcher(inFile+".svg");

QCString svgName=outDir+"/"+baseName+".svg";

DotFilePatcher patcher(svgName);

patcher.run();

}

Note that the SVG file link is created *before* the SVG file is patched with the svgpan.js support.   As a result, for any \dot or \dotfile that has a resulting large size, the iframe link generated by writeSVGFigureLink() will be forced to the actual dimensions of the SVG (potentially thousands of pixels wide), so the svgpan.js will not provide any useful functionality and viewing the resulting embedded SVG is unwieldy.

Moving the writeSVGFigureLink() to *after* the call to patcher.run() produces better HTML results where the embedded SVG is put in an HTML iframe with "width=100%" rather than the original SVG width, however I wasn't sure if doing so would have any adverse effects.

Thanks,
Brian

- CONFIDENTIAL-

This email and any files transmitted with it are confidential, and may also be legally privileged. If you are not the intended recipient, you may not review, use, copy, or distribute this message. If you receive this email in error, please notify the sender immediately by reply email and then delete this email.
------------------------------------------------------------------------------
Dive into the World of Parallel Programming The Go Parallel Website, sponsored
by Intel and developed in partnership with Slashdot Media, is your hub for all
things parallel software development, from weekly thought leadership blogs to
news, videos, case studies, tutorials and more. Take a look and join the
conversation now. http://goparallel.sourceforge.net/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

11 Feb 21:08 2015

### Preprocess generated .dot files

Hello,

I've been using doxygen recently to try to document some embedded code I'm working on. I would like to be able to insert some custom processing code on the generated .dot files before they are used.

I've put up a small example of what I'd like to do up at http://static.chintal.in/doxygen/simplify.html

Is there some way to get doxygen to allow calling a script from within doxygen? I can't seem to find any related config options, but perhaps there is some plugin interface I could use or such?

Thanks
Shashank
------------------------------------------------------------------------------
Dive into the World of Parallel Programming. The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

1 Feb 15:20 2015

### Tutorial Message Sequence Charts with Moritz is online

Hello every body

As already announced last year, a first tutorial was published today to
show how to create message sequence charts with Moritz. As for nassi
shneiderman or uml like activity diagrams Moritz generates no images
directly but image describing scripts in this case scripts for the tool
msgen you will find at
http://www.mcternan.me.uk/mscgen/
Mscgen is already known by Doxygen and the script-files can be added to
the Doxygen output by using the command mscfile .
This first version is published to introduce the new feature of Moritz
that is still under development. The goal is to ask the users to take a
look and to post some comments in the forum at
http://sourceforge.net/p/moritz/discussion/
A pdf in tutorial describes the basic steps needed to create message
sequence charts. The provided folder "MessageSequence_1" contains the
example based on the same sources as the other tutorials.

Eckard Klotz.

------------------------------------------------------------------------------
Dive into the World of Parallel Programming. The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net/

24 Jan 10:51 2015

### Doxygen 1.8.9 on Win8.1 "Error: Reference source not found" in refman.

Hello,

a)
with RTF output of Doxygen 1.8.9 on english Windows 8.1, there is the
problem in the file refman.rtf

> File Index
> 	File List
> Here is a list of all documented files with brief descriptions:
> C:/Users/Public/projects_local/hemmerling/hemmerling_pwendean_keil/src/getline.c (Line
Edited Character Input for the application "Paketwendeanlage" ) 	Error: Reference source not found

while of course Doxygen was/is processing all the mentioned files,
successfully ( as shown by the HTML output, and the logging ).

If I move the "refman.rtf" file to another *german* Windows 7, the error
message even changes to German language "Fehler: Referenz nicht gefunden".

There is nothing special with the files, or the file location. I did not
include special informations in the parsed files to handle the "File
list" section.

b)
I found a description of this kind of bug here

"Don’t Let Word Get You Down, With “Error! Reference Source Not Found”
http://www.turbolaw.com/blog/2007/10/05/dont-let-word-get-you-down-with-error-reference-source-not-found/

Sincerely
Rolf

--

--
http://www.hemmerling.com
SCADA Expertness - Quality Intensification for IT + Automation
Member of Texas Instruments Expert Advisory Panel
CeBIT Competence Store Partner

------------------------------------------------------------------------------
New Year. New Location. New Benefits. New Data Center in Ashburn, VA.
GigeNET is offering a free month of service with a new server in Ashburn.
Choose from 2 high performing configs, both with 100TB of bandwidth.
Higher redundancy.Lower latency.Increased capacity.Completely compliant.
http://p.sf.net/sfu/gigenet
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

24 Jan 10:32 2015

### Doxygen 1.8.9 on Win8.1 is "swallowing" some (expected) characters in the log

Hello,

Some output of Doxygen 1.8.9 on Win8.1 is "missing", see

**************
> Combining RTF output...
> lookup cache used 44/65536 hits=71 misses=44
> finished...
> irq.c is not documented.
--^
There is never a file "irq.c" in the directory, but just "sioirq.c".
> C:/Users/Public/projects_local/hemmerling/hemmerling_pwendean_keil/src/sioirq.c:50:
warning: Member oend (variable) of file sioirq.c is not documented.
--^
Here and everyelse, "sioirq.c" is properly displayed.
*************

This means that Doxygen at that point is "swallowing" some characters in
the output to the log file.

Maybe it is a typical "buffer problem", as known from such legacy
software ( 1997 was initial release according to Wikipedia ), and so
maybe the indication of much bigger fault.

I didn´t check the Doxygen source code for the bug.
I would be pleased if you can fix it, anyhow.

** Anyhow I think Doxygen is really-great software, thanks for

Sincerely
Rolf

Complete output of Doxygen:
************************************
C:/Users/Public/projects_local/hemmerling/hemmerling_pwendean_keil/src/sioirq.c:37:
warning: Member S0BUF (macro definition) of file sioirq.c is not documented.
C:/Users/Public/projects_local/hemmerling/hemmerling_pwendean_keil/src/sioirq.c:38:
warning: Member RI0 (macro definition) of file sioirq.c is not documented.

...

finalizing index lists...
writing tag file...
Combining RTF output...
lookup cache used 44/65536 hits=71 misses=44
finished...
irq.c is not documented.
C:/Users/Public/projects_local/hemmerling/hemmerling_pwendean_keil/src/sioirq.c:50:
warning: Member oend (variable) of file sioirq.c is not documented.
...
*** Doxygen has finished
************************************
--

--
http://www.hemmerling.com
SCADA Expertness - Quality Intensification for IT + Automation
Member of Texas Instruments Expert Advisory Panel
CeBIT Competence Store Partner

------------------------------------------------------------------------------
New Year. New Location. New Benefits. New Data Center in Ashburn, VA.
GigeNET is offering a free month of service with a new server in Ashburn.
Choose from 2 high performing configs, both with 100TB of bandwidth.
Higher redundancy.Lower latency.Increased capacity.Completely compliant.
http://p.sf.net/sfu/gigenet
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

13 Jan 06:12 2015

### Cannot work with salt of plantuml

Hi All,

I am using latest version of doxygen 1.8.9.1 and plantuml 8071. But doxygen cannot work with salt subproject.

Step to reproduce my problem:

1) Type an example for plantuml

\startuml salt { Just plain text [This is my button] () Unchecked radio (X) Checked radio [] Unchecked box [X] Checked box "Enter text here " ^This is a droplist^ } \enduml

2) Run doxygen
I got an error in the html output:

salt: forbidden line salt

3) The generated .pu file is

<at> startuml salt { Just plain text [This is my button] () Unchecked radio (X) Checked radio [] Unchecked box [X] Checked box "Enter text here " ^This is a droplist^ } <at> enduml

PlantUML.jar cannot generate png for this file.

4) After I remove the new line after <at> startuml. PlantUML.jar can generate png.

I can confirm doxygen will generate a new line after <at> staruml for every plantuml code. But PlantUML require no new line for salt subproject.

Is it possible to fix it?

Best regards,
Bangyou
------------------------------------------------------------------------------
New Year. New Location. New Benefits. New Data Center in Ashburn, VA.
GigeNET is offering a free month of service with a new server in Ashburn.
Choose from 2 high performing configs, both with 100TB of bandwidth.
Higher redundancy.Lower latency.Increased capacity.Completely compliant.
http://p.sf.net/sfu/gigenet
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

10 Jan 18:03 2015

### Dual-Boot Mode on my Laptop

Hello everyone,

Now that my laptop is old enough, I have decided to make it dual boot
Windows and Linux (Fedora 21).  Everything worked right out of the box,
including my wi-fi connection.  I have not tried my external blu-ray
drive (though my laptop has an internal DVD drive), but everything else
works.

After installing development packages through yum, I was able to get
doxygen's command line interface to compile.  I still have yet to figure
out how to get the GUI to work, but the GUI is low-priority to me as I
know how to edit files manually using 'vim'.  After being away from
Linux for several years, I am slowly getting used to using Fedora.

I am back in Windows currently, as that is where most of the apps I use
work with.  But at least now, I have a much better way once again to
verify bugs in Doxygen, especially crashers.  I have Doxygen compiled in
debug mode for debugging crashers.

It is certainly about time that I got (though the old way) a linux
subsystem of some sort installed.

- Kevin McBride

------------------------------------------------------------------------------
Dive into the World of Parallel Programming! The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net

7 Jan 16:26 2015

### [PATCH] typo in doxmlparser subdirectory path

Hi,

There's a typo in the doxmlparser subdirectory path.

index 3b2354d..f26a291 100644
<at>  <at>  -11,7 +11,7  <at>  <at>  win32-borland:LIBS          += doxmlparser.lib qtools.lib
shell32.lib
win32-borland:TMAKE_LFLAGS  += -L..\..\..\..\lib
win32:TMAKE_CXXFLAGS        += -DQT_NODLL
DESTDIR                     = ../../../../bin
-OBJECTS_DIR                 = ../../../../objects/doxmlparer/metrics
+OBJECTS_DIR                 = ../../../../objects/doxmlparser/metrics
TARGET                      = metrics
DEPENDPATH                  = ../../include
INCLUDEPATH                += ../../../../qtools ../../include

Best Regards
--

--
Stephane

------------------------------------------------------------------------------
Dive into the World of Parallel Programming! The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net

5 Jan 10:49 2015

### Re: PATCH limit warnings from doxygen

Dimitri

I hope you don’t mind but I’m resending this to the develop list, this time with a smaller zip file as the previous one  bounced the email from the list and I am unsure if the list received the message.

The larger config.xml I removed, but outline the change needed here

-------------------------------------------------------

</docs>

</option>

<option type='int' id='LIMIT_WARNINGS' minval='0' maxval='10000' defval='0'>

<docs>

<![CDATA[

The \c LIMIT_WARNINGS tag can be used to stop doxygen when a maximum number of warnings has been seen.

<br>

\b Tip: Turn warnings on while writing the documentation.

]]>

-------------------------------------------------------

Paul

Sent: 03 December 2014 12:57
To: 'doxygen-develop <at> lists.sourceforge.net'; 'dimitri <at> stack.nl'
Subject: PATCH limit warnings from doxygen

Dimitri

I recently posted a question on StackOverFlow regarding being able to stop doxygen after it had seen a certain number of warnings, somewhat akin to the –ferror-limit=N option that certain compilers have.

http://stackoverflow.com/questions/27174031/possible-to-stop-doxygen-after-n-warnings

I have a large code base, mostly un-doxygen’d, I have a nightly build that runs doxygen but its produces thousands of warnings. I know getting full coverage is going to require a gradual continuous improvement approach which leads to a mindset change of the individual teams of developers.

So to tackle this I have added doxygen running on the current source subdirectory as “PreBuild Event” in Visual Studio project files, I don’t want to use the temporary documentation it generates (that will come from the full tree nightly build), but I want to see the warnings, I format the warnings with

WARN_FORMAT            = "$file($line): \$text"

Which this means that while the code is compiling, this allows the developer to go back in and double click the warnings in the output window and be taken to the location to fix those doxygen warnings (as they would any other warning), the problem is that for many of the directories the number of warnings is huge (which are too daunting to fix in one go)

I don’t want to do a full Doxygen scan everytime (which is also why I only do it on the sub directory) because that will take too long and I don’t want all the warnings or the developer will simply treat it a noise, I just want them to see a few and then stop.

My idea is to be able to tell doxygen to document locally only a certain number of warnings and then stop, this means that every build the developer will see a few more warnings (but only a couple 5-10) and be driven to fix those, over time the code will become documented and the developers will learn to document as they go, also any new code (especially in previously doxygen clean areas) will immediately become a warning. Think of it as “Continuous Incremental Documentation”

Given that I don’t think this is possible currently, I took it upon myself to try and learn how to do it, I am very new to the doxygen source code, so I apologize in advance if I did it in the wrong place.

So the change to the doxygen source to implement something like this turned out to be fairly simple, with only having to add a new LIMIT_WARNINGS option to the config file, so I thought I would share the code change, feel free to use or discard as you see fit.

So I’ve not contributed before, so I’m not 100% clear of the etiquette or who to send any diffs to, so I’ve included the changed files and the diff from the tip of the git tree, if I should submit this another way, bug number etc.. let me know.

Paul

P.S. I couldn’t find any requests like this in the bug tracker database.

Attachment (LIMIT_WARNING.zip): application/x-zip-compressed, 4300 bytes
------------------------------------------------------------------------------
Dive into the World of Parallel Programming! The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

3 Jan 16:15 2015

### New snapshot of Moritz 2.0.2 to generate nassi shneiderman and UML like activity together with some tutorials is available

Hello Everybody.

I wish you a happy new year.

Since some years I'm providing  Moritz a tool to generate source diagrams. First Moritz started with html-based nassi shneiderman diagrams and since  last year dot-based UML like activity diagrams are available also.

Currently I'm working on a possibility to create mscgen-based message sequence charts. Even this feature is not available until now for you, I have posted today a new snapshot for windows and linux. For other operation-systems the source-code is provided and the both binaries abc2xml and xml2abc should be usable with the linux distribution then.

https://sourceforge.net/projects/moritz/files/Moritz_2.x/DevelopmentFor_2_1_0/Snapshot_2_0_2/

Here you will find a windows-distribution and one for linux (build with Ubuntu 14.04 for a 32bit system). Furthermore a the sources for the two binaries abc2xml and xml2abc.

New is a sub folder in this snapshot with some tutorials:
1. An introduction that explains a basic source example and the set up of the used tools.
2. A nassi shneiderman diagram example that shows how to create them and hoe to use them with doxygen.
3. A UML like activity diagram example that shows how to create them and hoe to use them with doxygen.

It would be kind if you would find the time to test it and please post a comment in the forum from Moritz.

Best regards,
Eckard Klotz.

------------------------------------------------------------------------------
Dive into the World of Parallel Programming! The Go Parallel Website,
sponsored by Intel and developed in partnership with Slashdot Media, is your
hub for all things parallel software development, from weekly thought
leadership blogs to news, videos, case studies, tutorials and more. Take a
look and join the conversation now. http://goparallel.sourceforge.net
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop


Gmane