18 Jun 12:44 2015

### Issue with # in inline code in markdown

Hi,

I have an issue with preprocessor directives in inline code in Markdown
readme included in Doxygen doc. When compiling the file, I get


resolved


Due to the line in the README.


* Code should **never** be commented out. To temporarily comment some
code, use #if 0 preprocessor directive.


It compiles fine, but there is still a warning during compilation.

Note also that the warning message refers to line 175 although my
README.md file has only 169 lines (and the faulty one is the last one).

Thanks!
--

--
Phyks

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

18 Jun 12:48 2015

### Warning: Unexpected html tag <img> found within <a href=...> context

Hi,

I've just encountered this issue in a Markdown file:
http://sourceforge.net/p/doxygen/mailman/message/12235967/.

However, according to the thread, I understand it was fixed in 1.2.6 and
I am using 1.8.9.1.

Thanks
--

--
Phyks

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

27 May 20:12 2015

### documenting bash function with dots and dashes inside

Hello,

I asked this question on the doxygen users list, but without any luck.

It would be nice if this little feature could be added to the doxygen code to parse bash functions correctly.

Besides of this little parser problem it works like a charm!

I found a little doxygen filter for bash functions:

After a few changes, it works really fine for my sources (60_000 loc).

(Attached, plus Example file)

But there is a thing, which is really annoying, there are tons of bash-functions, which uses a dot or a minus in the function name (which is allowed in bash), for example:

function e.() {

echo "hello"

}

function e-e() {

echo "foo"

}

Is there a chance to add the dot and the minus for function names, so that doxygen is able to parse these names correctly?

Thank you.

Best regards,

Alexander Elgert

Attachment (zbashrc2_test): application/octet-stream, 973 bytes
Attachment (doxyfilter-bash.py): application/octet-stream, 9 KiB
------------------------------------------------------------------------------

_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

7 May 22:57 2015

### Problem with a filter since Doxygen v1.8.8

Hi,

A filter for Google Protocol buffers files I've written (https://sourceforge.net/p/proto2cpp/) does not work from Doxygen v1.8.8 onward and so far I haven't been able to make it work. It does work with v1.8.7 and several older versions (oldest I've tested is 1.8.1.1).
Has anyone else encountered such problems with custom Doxygen filters?
Any clues what could be the root cause and how to fix it?

TimoM

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

28 Apr 01:26 2015

### References and automatic numbering for figures and tables

Hello,

I'm using Doxygen to create a reference manual. Input is markdown. Output is LaTeX and html. Currently using Doxygen 1.8.8.

I'm wondering if there are any plans for Doxygen to support automatic numbering of figures and tables, with referencing capability from the markdown text?

For example, behavior similar to the <at> section command's LaTeX output. But separate enumeration for figures and another separate enumeration for tables. And with the enumeration showing up in both LaTeX and html output.

Syntax might be something like this,

At the figure:

![fig_name](images/fig_growth_vs_time.png   "Growth rate vs time")

or maybe

![](images/fig_growth_vs_time.png   "Growth rate vs time")
<at> figure fig_name "Growth rate vs time"

The first example is preferable for it's simplicity, but maybe it's difficult to have ![Caption text ] used for multiple purposes...

At the table:

<at> table tab_name Growth rate data 2009 - 2014

| Year | Growth Rate|
|:------:|-----------------:|
| 2009|         0.3245  |
....whatever....

In the body text:

The growth rate for the last five years is shown in \ref tab_name. As can be seen in /ref fig_name, the growth rate is logarithmic.

In the generated pdf/html:

The growth rate for the last five years is shown in Table 93: Growth rate 2009 - 2014. As can be seen in Figure 125: Growth rate vs time, the growth rate is logarithmic.

So "Figure N" and "Table M" are automatically generated and pre-pended to the caption for each figure/table in the document. And you can link to any figure or table anyplace in the doc using a /ref tag.

I've noticed some users implement similar functionality with post-processing scripts or other "add-on" tools, such as doxynum. I could do likewise, but first, wanted to ask whether or not there are plans to have such functionality "built-in" to Doxygen - and if so, approximately when?

Kind regards,

------------------------------------------------------------------------------
One dashboard for servers and applications across Physical-Virtual-Cloud
Widest out-of-the-box monitoring support with 50+ applications
Performance metrics, stats and reports that give you Actionable Insights
Deep dive visibility with transaction tracing using APM Insight.
http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop <at> lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

13 Apr 19:11 2015

I'd like to link to Doxygen pages from a wiki.  Currently, we do that by
generating all the documentation in the top-level directory.  This is
less than ideal as it results in over 48000 files in a single
directory.  Doxygen allows for the creation of sub-directories to
alleviate this, but the mapping doesn't seem straight-forward.

Several javascript files are generated by Doxygen that look like they
could provide a look-up table, but I've been investigating hierarchy.js
and have been unable to figure out how it's generated, nor how it's
used.  Given my inability to discover how the file is generated and
used, I'm a little reluctant to make use of it for fear it might
disappear in some future release.  I've been poking at this for a while
now, and haven't uncovered any answers yet.

Is there a known method for linking to the appropriate document using
the name of the class/file/namespace/etc. as a reference?

------------------------------------------------------------------------------
BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
Develop your own process in accordance with the BPMN 2 standard
Learn Process modeling best practices with Bonita BPM through live exercises
http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_
source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF

6 Apr 16:58 2015

### doxygen and standard C++ library

Dimitri, as I work on some enhancements for Doxygen, is there any reason
I shouldn't use std as opposed to "qtools"?  The first enhancement I
did, some additional capabilities for markdown tables (column and row
spans), I used std.  The PlantUML enhancements I'm working on would
really benefit from std, but I wanted to be sure there wasn't a reason
not to implement things that way.

------------------------------------------------------------------------------
BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
Develop your own process in accordance with the BPMN 2 standard
Learn Process modeling best practices with Bonita BPM through live exercises
http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_
source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF

2 Apr 21:07 2015

### seg fault in doxygen.cpp (1.8.8 / 1.8.9.1)

There are numerous debug statements in doxygen.cpp using an unchecked
templSpec.data() which causes seg faults.  Should be changed to:

templSpec.isEmpty()?"":templSpec.data()

e.g.
Debug::print(Debug::Classes,0,
"    New undocumented base class %s'
baseClassName=%s templSpec=%s isArtificial=%d\n",
biName.data(),baseClassName.data(),templSpec.data(),isArtificial
);

becomes

Debug::print(Debug::Classes,0,
"    New undocumented base class %s'
baseClassName=%s templSpec=%s isArtificial=%d\n",
biName.data(),baseClassName.data(),templSpec.isEmpty()?"":templSpec.data(),isArtificial
);

------------------------------------------------------------------------------
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/

2 Apr 19:22 2015

### Working on adding PlantUML class diagrams

I'm interested in (and have started) modifying the Doxygen code to allow
for the generation of class diagrams using PlantUML, but I wanted to get
some input before I got too far in.

My current thinking is just to have the diagrams generated as an aside
to the Graphviz diagrams.  I mostly wanted a tool to automatically
generate nice UML class diagrams from my code.  I'm already using
Doxygen and it has a framework for doing this already. PlantUML does not
support image mapping so the nice links that are generated in Graphviz
simply aren't available.

That said, others probably have a different opinion on how best to
utilize PlantUML.  As such, I'm open to suggestions as to how best to
utilize the tool inside Doxygen (beyond the already available embedded
diagrams).

I should probably mention that I'm only inclined to add support for
PlantUML class diagrams - it's not really suited for the other types of
diagrams that Doxygen generates.

------------------------------------------------------------------------------
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/

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


Gmane