tag:old.nabble.com,2006:forum-22197Nabble - Doxygen2009-12-01T05:36:20Z<a href="http://www.stack.nl/~dimitri/doxygen/" target="_top" rel="nofollow">Doxygen</a> is a documentation system for C++, C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors) and to some extent PHP, C#, and D.
<br>It can help you in three ways:
<br> 1. It can generate an on-line documentation browser (in HTML) and/or an off-line reference manual (in $\mbox{\LaTeX}$) from a set of documented source files.
<br> 2. You can configure doxygen to extract the code structure from undocumented source files.
<br> 3. You can even `abuse' doxygen for creating normal documentation.
<br><br><b>Doxygen</b> is developed under Linux and Mac OS X, but is set-up to be highly portable. As a result, it runs on most other Unix flavors as well. Furthermore, executables for Windows are available.tag:old.nabble.com,2006:post-26592154Re: Generated HTML pages are getting huge2009-12-01T05:36:20Z2009-12-01T05:36:20ZEric MateckiEric Matecki wrote:
<div class='shrinkable-quote'><br>>> On Tue, Dec 1, 2009 at 1:56 PM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26592154&i=0" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>>> Mathieu Malaterre wrote:
<br>>>>> On Tue, Dec 1, 2009 at 11:58 AM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26592154&i=1" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>>>>>>> Nicolas Alvarez wrote:
<br>>>>>>>>> Mathieu Malaterre wrote:
<br>>>>>>>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>>>>>>>> png file, we were able to divide the size of the installed tree to
<br>>>>>>>>>> 431524 kB
<br>>>>>>>>>>
<br>>>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>>>>>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>>>>>>>
<br>>>>>>>>> Have you tried optipng instead? It's giving me further decreases
<br>>>>>>>>> over the
<br>>>>>>>>> compression already done in the latest package.
<br>>>>>>>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>>>>>>>> of the list...
<br>>>>>>>> So here it is again:
<br>>>>>>>>
<br>>>>>>>> The PNGs are much bigger because the lines are now antialiased.
<br>>>>>>>> They look much nicer than the old ones with their steps, but
<br>>>>>>>> compress much much less.
<br>>>>>>>> For sure its doxygen which tells dot to antialias them because I
<br>>>>>>>> didn't update my dot.
<br>>>>>>> I wouldn't know how to tell dot to do this, so I'm not sure this is
<br>>>>>>> true.
<br>>>>>>> Maybe a library used by dot got updated (libgd for instance).
<br>>>>>> Maybe some lib got updated, I really don't know.
<br>>>>>> My dot is still 2.18 (Wed Aug 6 10:29:47 UTC 2008).
<br>>>>>>
<br>>>>>>>> So maybe an option in Doxyfile to not antialias these lines ?
<br>>>>>>> Not that I'm aware of.
<br>>>>>> But it certainly would be useful for several people generating
<br>>>>>> big docs to disable this antialiasing.
<br>>>>>>
<br>>>>>> Does somebody know how to do this (I mean, telling dot to not antialias
<br>>>>>> the lines (edges), a quick look thru dot's man page didn't help) ?
<br>>>>> Does the following help ?
<br>>>>>
<br>>>>>
<br>>>>> <a href="https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html" target="_top" rel="nofollow">https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html</a><br>>>> Now that's a good starting point !
<br>>>>
<br>>>> I first simply tried :
<br>>>> DOT IMAGE FORMAT = png:gd
<br>>>> but a ps -elf|grep dot quickly showed that doxygen stripped the :gd part
<br>>>> of the format
<br>>>> (or ignored png:gd and used the default which is png)
<br>>>>
<br>>>> Then I wrote a short shell script to use instead of dot which replaces -Tpng
<br>>>> with -Tpng:gd
<br>>>> before calling /usr/bin/dot with the rest of the arguments.
<br>>>> The same ps showed dot was called with -Tpng:gd (ie. I didn't made an
<br>>>> error in my script :)
<br>>>>
<br>>>> But the PNGs are still antialiased...
<br>>>>
<br>>>> Can it really be that a newer version of libgd draws antialiased lines ?
<br>>> Well it does work *pretty* well for me:
<br>>>
<br>>> $ dot -Tpng:gd -ographics.png
<br>>> boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>>> $ dot -Tpng -ographics2.png
<br>>> boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>>>
<br>>> $ ls
<br>>> -rw-r--r-- 1 mathieu mathieu 1403 2009-12-01 13:50 graphics.png
<br>>> -rw-r--r-- 1 mathieu mathieu 13049 2009-12-01 13:51 graphics2.png
<br>>>
<br>>> $ apt-cache policy graphviz
<br>>> graphviz:
<br>>> Installed: 2.20.2-3
<br>>> Candidate: 2.20.2-3
<br>>> Version table:
<br>>> *** 2.20.2-3 0
<br>>> 500 <a href="http://ftp.fr.debian.org" target="_top" rel="nofollow">http://ftp.fr.debian.org</a> lenny/main Packages
<br>>> 100 /var/lib/dpkg/status
<br>>>
<br>>>
<br>>> $ apt-cache policy libgd2-xpm
<br>>> libgd2-xpm:
<br>>> Installed: 2.0.36~rc1~dfsg-3+lenny1
<br>>> Candidate: 2.0.36~rc1~dfsg-3+lenny1
<br>>> Version table:
<br>>> *** 2.0.36~rc1~dfsg-3+lenny1 0
<br>>> 500 <a href="http://security.debian.org" target="_top" rel="nofollow">http://security.debian.org</a> lenny/updates/main Packages
<br>>> 100 /var/lib/dpkg/status
<br>>>
<br>>> System is a debian/stable.
<br>>>
<br>>>
<br>>> BTW what happen if you escape the : with a \ or try something like:
<br>>>
<br>>> DOT IMAGE FORMAT = "png:gd"
<br>>>
<br>> Well, in the meantime I found this error from doxygen in my logs :
<br>> Invalid value for DOT_IMAGE_FORMAT: `png:gd'. Using the default.
<br>>
<br>> My libgd is the same as yours : 2.0.36~rc1~dfsg-3ubuntu1
<br>>
<br>> I am running right now doxygen on my sources with DOT_CLEANUP = NO ,
<br>> so I have the .dot files at hand to investigate further.
<br>>
<br>> Will keep everybody informed.
<br>>
</div>Ok, I got it work with the following script I use instead of dot :
<br><br># cat /usr/local/bin/dot
<br>#!/bin/sh
<br>/usr/bin/dot $1 -Tpng:gd -o $4 -Tcmapx -o $7
<br><br>by using :
<br>DOT_PATH = /usr/local/bin
<br><br>As Matthieu pointed out in his previous message, it would be a simple change
<br>to allow all values for DOT_IMAGE_FORMAT to solve this issue in a better way.
<br><br>Case closed :)
<br><br>--
<br>Keep intel OUTSIDE my Mac !
<br>Hiii !!! I can see Intel chips creeping around my G5 !
<br><br>Eric M.
<br><br>------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26592154&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26591668Re: Generated HTML pages are getting huge2009-12-01T05:21:05Z2009-12-01T05:21:05ZEric Matecki<div class='shrinkable-quote'>> On Tue, Dec 1, 2009 at 1:56 PM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591668&i=0" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>> Mathieu Malaterre wrote:
<br>>>> On Tue, Dec 1, 2009 at 11:58 AM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591668&i=1" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>>>>>> Nicolas Alvarez wrote:
<br>>>>>>>> Mathieu Malaterre wrote:
<br>>>>>>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>>>>>>> png file, we were able to divide the size of the installed tree to
<br>>>>>>>>> 431524 kB
<br>>>>>>>>>
<br>>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>>>>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>>>>>>
<br>>>>>>>> Have you tried optipng instead? It's giving me further decreases
<br>>>>>>>> over the
<br>>>>>>>> compression already done in the latest package.
<br>>>>>>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>>>>>>> of the list...
<br>>>>>>> So here it is again:
<br>>>>>>>
<br>>>>>>> The PNGs are much bigger because the lines are now antialiased.
<br>>>>>>> They look much nicer than the old ones with their steps, but
<br>>>>>>> compress much much less.
<br>>>>>>> For sure its doxygen which tells dot to antialias them because I
<br>>>>>>> didn't update my dot.
<br>>>>>> I wouldn't know how to tell dot to do this, so I'm not sure this is
<br>>>>>> true.
<br>>>>>> Maybe a library used by dot got updated (libgd for instance).
<br>>>>> Maybe some lib got updated, I really don't know.
<br>>>>> My dot is still 2.18 (Wed Aug 6 10:29:47 UTC 2008).
<br>>>>>
<br>>>>>>> So maybe an option in Doxyfile to not antialias these lines ?
<br>>>>>> Not that I'm aware of.
<br>>>>> But it certainly would be useful for several people generating
<br>>>>> big docs to disable this antialiasing.
<br>>>>>
<br>>>>> Does somebody know how to do this (I mean, telling dot to not antialias
<br>>>>> the lines (edges), a quick look thru dot's man page didn't help) ?
<br>>>> Does the following help ?
<br>>>>
<br>>>>
<br>>>> <a href="https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html" target="_top" rel="nofollow">https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html</a><br>>> Now that's a good starting point !
<br>>>
<br>>> I first simply tried :
<br>>> DOT IMAGE FORMAT = png:gd
<br>>> but a ps -elf|grep dot quickly showed that doxygen stripped the :gd part
<br>>> of the format
<br>>> (or ignored png:gd and used the default which is png)
<br>>>
<br>>> Then I wrote a short shell script to use instead of dot which replaces -Tpng
<br>>> with -Tpng:gd
<br>>> before calling /usr/bin/dot with the rest of the arguments.
<br>>> The same ps showed dot was called with -Tpng:gd (ie. I didn't made an
<br>>> error in my script :)
<br>>>
<br>>> But the PNGs are still antialiased...
<br>>>
<br>>> Can it really be that a newer version of libgd draws antialiased lines ?
<br>>
<br>> Well it does work *pretty* well for me:
<br>>
<br>> $ dot -Tpng:gd -ographics.png
<br>> boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>> $ dot -Tpng -ographics2.png
<br>> boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>>
<br>> $ ls
<br>> -rw-r--r-- 1 mathieu mathieu 1403 2009-12-01 13:50 graphics.png
<br>> -rw-r--r-- 1 mathieu mathieu 13049 2009-12-01 13:51 graphics2.png
<br>>
<br>> $ apt-cache policy graphviz
<br>> graphviz:
<br>> Installed: 2.20.2-3
<br>> Candidate: 2.20.2-3
<br>> Version table:
<br>> *** 2.20.2-3 0
<br>> 500 <a href="http://ftp.fr.debian.org" target="_top" rel="nofollow">http://ftp.fr.debian.org</a> lenny/main Packages
<br>> 100 /var/lib/dpkg/status
<br>>
<br>>
<br>> $ apt-cache policy libgd2-xpm
<br>> libgd2-xpm:
<br>> Installed: 2.0.36~rc1~dfsg-3+lenny1
<br>> Candidate: 2.0.36~rc1~dfsg-3+lenny1
<br>> Version table:
<br>> *** 2.0.36~rc1~dfsg-3+lenny1 0
<br>> 500 <a href="http://security.debian.org" target="_top" rel="nofollow">http://security.debian.org</a> lenny/updates/main Packages
<br>> 100 /var/lib/dpkg/status
<br>>
<br>> System is a debian/stable.
<br>>
<br>>
<br>> BTW what happen if you escape the : with a \ or try something like:
<br>>
<br>> DOT IMAGE FORMAT = "png:gd"
<br>>
</div>Well, in the meantime I found this error from doxygen in my logs :
<br>Invalid value for DOT_IMAGE_FORMAT: `png:gd'. Using the default.
<br><br>My libgd is the same as yours : 2.0.36~rc1~dfsg-3ubuntu1
<br><br>I am running right now doxygen on my sources with DOT_CLEANUP = NO ,
<br>so I have the .dot files at hand to investigate further.
<br><br>Will keep everybody informed.
<br><br>--
<br>Keep intel OUTSIDE my Mac !
<br>Hiii !!! I can see Intel chips creeping around my G5 !
<br><br>Eric M.
<br><br>------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591668&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26591652Hardcoded DOT_IMAGE_FORMAT (was Re: Generated HTML pages are getting huge)2009-12-01T05:19:56Z2009-12-01T05:19:56ZmalatOk I think I found the issue:
<br><br>$ cat doxygen-1.6.1/src/config.cpp
<br>...
<br> // check dot image format
<br> QCString &dotImageFormat=Config_getEnum("DOT_IMAGE_FORMAT");
<br> dotImageFormat=dotImageFormat.stripWhiteSpace();
<br> if (dotImageFormat.isEmpty())
<br> {
<br> dotImageFormat = "png";
<br> }
<br> else if (dotImageFormat!="gif" && dotImageFormat!="png" &&
<br>dotImageFormat!="jpg")
<br> {
<br> config_err("Invalid value for DOT_IMAGE_FORMAT: `%s'. Using the
<br>default.\n",dotImageFormat.data());
<br> dotImageFormat = "png";
<br> }
<br><br>So we cannot pass "png:gd" from doxygen. The external script is the
<br>sole solution for now.
<br><br>HTH
<br><br>On Tue, Dec 1, 2009 at 2:04 PM, Mathieu Malaterre
<br><<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591652&i=0" target="_top" rel="nofollow">mathieu.malaterre@...</a>> wrote:
<div class='shrinkable-quote'><br>> [CCing dox user]
<br>>
<br>> On Tue, Dec 1, 2009 at 1:56 PM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591652&i=1" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>> Mathieu Malaterre wrote:
<br>>>>
<br>>>> On Tue, Dec 1, 2009 at 11:58 AM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591652&i=2" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>>>>>>
<br>>>>>>> Nicolas Alvarez wrote:
<br>>>>>>>>
<br>>>>>>>> Mathieu Malaterre wrote:
<br>>>>>>>>>
<br>>>>>>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>>>>>>> png file, we were able to divide the size of the installed tree to
<br>>>>>>>>> 431524 kB
<br>>>>>>>>>
<br>>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>>>>>>
<br>>>>>>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>>>>>>
<br>>>>>>>> Have you tried optipng instead? It's giving me further decreases
<br>>>>>>>> over the
<br>>>>>>>> compression already done in the latest package.
<br>>>>>>>
<br>>>>>>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>>>>>>> of the list...
<br>>>>>>> So here it is again:
<br>>>>>>>
<br>>>>>>> The PNGs are much bigger because the lines are now antialiased.
<br>>>>>>> They look much nicer than the old ones with their steps, but
<br>>>>>>> compress much much less.
<br>>>>>>> For sure its doxygen which tells dot to antialias them because I
<br>>>>>>> didn't update my dot.
<br>>>>>>
<br>>>>>> I wouldn't know how to tell dot to do this, so I'm not sure this is
<br>>>>>> true.
<br>>>>>> Maybe a library used by dot got updated (libgd for instance).
<br>>>>>
<br>>>>> Maybe some lib got updated, I really don't know.
<br>>>>> My dot is still 2.18 (Wed Aug 6 10:29:47 UTC 2008).
<br>>>>>
<br>>>>>>> So maybe an option in Doxyfile to not antialias these lines ?
<br>>>>>>
<br>>>>>> Not that I'm aware of.
<br>>>>>
<br>>>>> But it certainly would be useful for several people generating
<br>>>>> big docs to disable this antialiasing.
<br>>>>>
<br>>>>> Does somebody know how to do this (I mean, telling dot to not antialias
<br>>>>> the lines (edges), a quick look thru dot's man page didn't help) ?
<br>>>>
<br>>>> Does the following help ?
<br>>>>
<br>>>>
<br>>>> <a href="https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html" target="_top" rel="nofollow">https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html</a><br>>>
<br>>> Now that's a good starting point !
<br>>>
<br>>> I first simply tried :
<br>>> DOT IMAGE FORMAT = png:gd
<br>>> but a ps -elf|grep dot quickly showed that doxygen stripped the :gd part
<br>>> of the format
<br>>> (or ignored png:gd and used the default which is png)
<br>>>
<br>>> Then I wrote a short shell script to use instead of dot which replaces -Tpng
<br>>> with -Tpng:gd
<br>>> before calling /usr/bin/dot with the rest of the arguments.
<br>>> The same ps showed dot was called with -Tpng:gd (ie. I didn't made an
<br>>> error in my script :)
<br>>>
<br>>> But the PNGs are still antialiased...
<br>>>
<br>>> Can it really be that a newer version of libgd draws antialiased lines ?
<br>>
<br>> Well it does work *pretty* well for me:
<br>>
<br>> $ dot -Tpng:gd -ographics.png
<br>> boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>> $ dot -Tpng -ographics2.png
<br>> boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>>
<br>> $ ls
<br>> -rw-r--r-- 1 mathieu mathieu 1403 2009-12-01 13:50 graphics.png
<br>> -rw-r--r-- 1 mathieu mathieu 13049 2009-12-01 13:51 graphics2.png
<br>>
<br>> $ apt-cache policy graphviz
<br>> graphviz:
<br>> Installed: 2.20.2-3
<br>> Candidate: 2.20.2-3
<br>> Version table:
<br>> *** 2.20.2-3 0
<br>> 500 <a href="http://ftp.fr.debian.org" target="_top" rel="nofollow">http://ftp.fr.debian.org</a> lenny/main Packages
<br>> 100 /var/lib/dpkg/status
<br>>
<br>>
<br>> $ apt-cache policy libgd2-xpm
<br>> libgd2-xpm:
<br>> Installed: 2.0.36~rc1~dfsg-3+lenny1
<br>> Candidate: 2.0.36~rc1~dfsg-3+lenny1
<br>> Version table:
<br>> *** 2.0.36~rc1~dfsg-3+lenny1 0
<br>> 500 <a href="http://security.debian.org" target="_top" rel="nofollow">http://security.debian.org</a> lenny/updates/main Packages
<br>> 100 /var/lib/dpkg/status
<br>>
<br>> System is a debian/stable.
<br>>
<br>>
<br>> BTW what happen if you escape the : with a \ or try something like:
<br>>
<br>> DOT IMAGE FORMAT = "png:gd"
<br>>
<br>>
<br>> Cheers
<br>> --
<br>> Mathieu
<br>>
</div><br><br><br>--
<br>Mathieu
<br><br>------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591652&i=3" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26591421Re: Generated HTML pages are getting huge2009-12-01T05:04:22Z2009-12-01T05:04:22Zmalat[CCing dox user]
<br><br>On Tue, Dec 1, 2009 at 1:56 PM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591421&i=0" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<div class='shrinkable-quote'><br>> Mathieu Malaterre wrote:
<br>>>
<br>>> On Tue, Dec 1, 2009 at 11:58 AM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591421&i=1" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<br>>>>>>
<br>>>>>> Nicolas Alvarez wrote:
<br>>>>>>>
<br>>>>>>> Mathieu Malaterre wrote:
<br>>>>>>>>
<br>>>>>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>>>>>> png file, we were able to divide the size of the installed tree to
<br>>>>>>>> 431524 kB
<br>>>>>>>>
<br>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>>>>>
<br>>>>>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>>>>>
<br>>>>>>> Have you tried optipng instead? It's giving me further decreases
<br>>>>>>> over the
<br>>>>>>> compression already done in the latest package.
<br>>>>>>
<br>>>>>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>>>>>> of the list...
<br>>>>>> So here it is again:
<br>>>>>>
<br>>>>>> The PNGs are much bigger because the lines are now antialiased.
<br>>>>>> They look much nicer than the old ones with their steps, but
<br>>>>>> compress much much less.
<br>>>>>> For sure its doxygen which tells dot to antialias them because I
<br>>>>>> didn't update my dot.
<br>>>>>
<br>>>>> I wouldn't know how to tell dot to do this, so I'm not sure this is
<br>>>>> true.
<br>>>>> Maybe a library used by dot got updated (libgd for instance).
<br>>>>
<br>>>> Maybe some lib got updated, I really don't know.
<br>>>> My dot is still 2.18 (Wed Aug 6 10:29:47 UTC 2008).
<br>>>>
<br>>>>>> So maybe an option in Doxyfile to not antialias these lines ?
<br>>>>>
<br>>>>> Not that I'm aware of.
<br>>>>
<br>>>> But it certainly would be useful for several people generating
<br>>>> big docs to disable this antialiasing.
<br>>>>
<br>>>> Does somebody know how to do this (I mean, telling dot to not antialias
<br>>>> the lines (edges), a quick look thru dot's man page didn't help) ?
<br>>>
<br>>> Does the following help ?
<br>>>
<br>>>
<br>>> <a href="https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html" target="_top" rel="nofollow">https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html</a><br>>
<br>> Now that's a good starting point !
<br>>
<br>> I first simply tried :
<br>> DOT IMAGE FORMAT = png:gd
<br>> but a ps -elf|grep dot quickly showed that doxygen stripped the :gd part
<br>> of the format
<br>> (or ignored png:gd and used the default which is png)
<br>>
<br>> Then I wrote a short shell script to use instead of dot which replaces -Tpng
<br>> with -Tpng:gd
<br>> before calling /usr/bin/dot with the rest of the arguments.
<br>> The same ps showed dot was called with -Tpng:gd (ie. I didn't made an
<br>> error in my script :)
<br>>
<br>> But the PNGs are still antialiased...
<br>>
<br>> Can it really be that a newer version of libgd draws antialiased lines ?
</div><br>Well it does work *pretty* well for me:
<br><br>$ dot -Tpng:gd -ographics.png
<br>boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br>$ dot -Tpng -ographics2.png
<br>boost_1_40_0_beta1/libs/graph/example/graphviz_example.dot
<br><br>$ ls
<br>-rw-r--r-- 1 mathieu mathieu 1403 2009-12-01 13:50 graphics.png
<br>-rw-r--r-- 1 mathieu mathieu 13049 2009-12-01 13:51 graphics2.png
<br><br>$ apt-cache policy graphviz
<br>graphviz:
<br> Installed: 2.20.2-3
<br> Candidate: 2.20.2-3
<br> Version table:
<br> *** 2.20.2-3 0
<br> 500 <a href="http://ftp.fr.debian.org" target="_top" rel="nofollow">http://ftp.fr.debian.org</a> lenny/main Packages
<br> 100 /var/lib/dpkg/status
<br><br><br>$ apt-cache policy libgd2-xpm
<br>libgd2-xpm:
<br> Installed: 2.0.36~rc1~dfsg-3+lenny1
<br> Candidate: 2.0.36~rc1~dfsg-3+lenny1
<br> Version table:
<br> *** 2.0.36~rc1~dfsg-3+lenny1 0
<br> 500 <a href="http://security.debian.org" target="_top" rel="nofollow">http://security.debian.org</a> lenny/updates/main Packages
<br> 100 /var/lib/dpkg/status
<br><br>System is a debian/stable.
<br><br><br>BTW what happen if you escape the : with a \ or try something like:
<br><br>DOT IMAGE FORMAT = "png:gd"
<br><br><br>Cheers
<br>--
<br>Mathieu
<br><br>------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26591421&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26590470Re: Generated HTML pages are getting huge2009-12-01T03:31:47Z2009-12-01T03:31:47ZmalatOn Tue, Dec 1, 2009 at 11:58 AM, Eric Matecki <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26590470&i=0" target="_top" rel="nofollow">ematecki@...</a>> wrote:
<div class='shrinkable-quote'><br>>>> Nicolas Alvarez wrote:
<br>>>>> Mathieu Malaterre wrote:
<br>>>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>>>> png file, we were able to divide the size of the installed tree to
<br>>>>>> 431524 kB
<br>>>>>>
<br>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>>>
<br>>>>> Have you tried optipng instead? It's giving me further decreases
<br>>>>> over the
<br>>>>> compression already done in the latest package.
<br>>>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>>>> of the list...
<br>>>> So here it is again:
<br>>>>
<br>>>> The PNGs are much bigger because the lines are now antialiased.
<br>>>> They look much nicer than the old ones with their steps, but
<br>>>> compress much much less.
<br>>>> For sure its doxygen which tells dot to antialias them because I
<br>>>> didn't update my dot.
<br>>>
<br>>> I wouldn't know how to tell dot to do this, so I'm not sure this is true.
<br>>> Maybe a library used by dot got updated (libgd for instance).
<br>> Maybe some lib got updated, I really don't know.
<br>> My dot is still 2.18 (Wed Aug 6 10:29:47 UTC 2008).
<br>>
<br>>>> So maybe an option in Doxyfile to not antialias these lines ?
<br>>> Not that I'm aware of.
<br>> But it certainly would be useful for several people generating
<br>> big docs to disable this antialiasing.
<br>>
<br>> Does somebody know how to do this (I mean, telling dot to not antialias
<br>> the lines (edges), a quick look thru dot's man page didn't help) ?
</div><br>Does the following help ?
<br><br><a href="https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html" target="_top" rel="nofollow">https://mailman.research.att.com/pipermail/graphviz-interest/2008q4/005889.html</a><br><br><br>Cheers
<br>--
<br>Mathieu
<br><br>------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26590470&i=1" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26590049Re: Generated HTML pages are getting huge2009-12-01T02:58:43Z2009-12-01T02:58:43ZEric Matecki<div class='shrinkable-quote'>>> Nicolas Alvarez wrote:
<br>>>> Mathieu Malaterre wrote:
<br>>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>>> png file, we were able to divide the size of the installed tree to
<br>>>>> 431524 kB
<br>>>>>
<br>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>>
<br>>>> Have you tried optipng instead? It's giving me further decreases
<br>>>> over the
<br>>>> compression already done in the latest package.
<br>>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>>> of the list...
<br>>> So here it is again:
<br>>>
<br>>> The PNGs are much bigger because the lines are now antialiased.
<br>>> They look much nicer than the old ones with their steps, but
<br>>> compress much much less.
<br>>> For sure its doxygen which tells dot to antialias them because I
<br>>> didn't update my dot.
<br>>
<br>> I wouldn't know how to tell dot to do this, so I'm not sure this is true.
<br>> Maybe a library used by dot got updated (libgd for instance).
</div>Maybe some lib got updated, I really don't know.
<br>My dot is still 2.18 (Wed Aug 6 10:29:47 UTC 2008).
<br><br>>> So maybe an option in Doxyfile to not antialias these lines ?
<br>> Not that I'm aware of.
<br>But it certainly would be useful for several people generating
<br>big docs to disable this antialiasing.
<br><br>Does somebody know how to do this (I mean, telling dot to not antialias
<br>the lines (edges), a quick look thru dot's man page didn't help) ?
<br><br>--
<br>Keep intel OUTSIDE my Mac !
<br>Hiii !!! I can see Intel chips creeping around my G5 !
<br><br>Eric M.
<br><br>------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26590049&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26589726FW: sealed2009-12-01T02:31:16Z2009-12-01T02:31:16ZJames French<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 12 (filtered medium)">
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-GB link=blue vlink=purple>
<div class=Section1>
<p class=MsoNormal><span style='color:#1F497D'>Do you want me to raise a bug?<o:p></o:p></span></p>
<p class=MsoNormal><span style='color:#1F497D'><o:p> </o:p></span></p>
<div style='border:none;border-left:solid blue 1.5pt;padding:0cm 0cm 0cm 4.0pt'>
<div>
<div style='border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0cm 0cm 0cm'>
<p class=MsoNormal><b><span lang=EN-US style='font-size:10.0pt;font-family:
"Tahoma","sans-serif"'>From:</span></b><span lang=EN-US style='font-size:10.0pt;
font-family:"Tahoma","sans-serif"'> James French
[mailto:<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26589726&i=0" target="_top" rel="nofollow">James.French@...</a>] <br>
<b>Sent:</b> 01 December 2009 10:19<br>
<b>To:</b> <a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26589726&i=1" target="_top" rel="nofollow">doxygen-users@...</a><br>
<b>Subject:</b> [Doxygen-users] sealed<o:p></o:p></span></p>
</div>
</div>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Hi,<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>It appears that the sealed keyword is not handled properly
in doxygen 1.6.1 – the class doesn’t get documented and you end up with
documentation for a class called ‘sealed’.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>James<o:p></o:p></p>
</div>
</div>
</body>
</html>
<br />------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26589726&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26589614sealed2009-12-01T02:19:08Z2009-12-01T02:19:08ZJames French<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=us-ascii">
<meta name=Generator content="Microsoft Word 12 (filtered medium)">
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-GB link=blue vlink=purple>
<div class=Section1>
<p class=MsoNormal>Hi,<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>It appears that the sealed keyword is not handled properly
in doxygen 1.6.1 – the class doesn’t get documented and you end up
with documentation for a class called ‘sealed’.<o:p></o:p></p>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>James<o:p></o:p></p>
</div>
</body>
</html>
<br />------------------------------------------------------------------------------
<br>Join us December 9, 2009 for the Red Hat Virtual Experience,
<br>a free event focused on virtualization and cloud computing.
<br>Attend in-depth sessions from your desk. Your couch. Anywhere.
<br><a href="http://p.sf.net/sfu/redhat-sfdev2dev" target="_top" rel="nofollow">http://p.sf.net/sfu/redhat-sfdev2dev</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26589614&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26580441Re: Generated HTML pages are getting huge2009-11-30T11:24:48Z2009-11-30T11:24:48ZDimitri van Heesch-2<br>On 30 nov 2009, at 14:40, Eric Matecki wrote:
<br><div class='shrinkable-quote'><br>> Nicolas Alvarez wrote:
<br>>> Mathieu Malaterre wrote:
<br>>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>>> png file, we were able to divide the size of the installed tree to
<br>>>> 431524 kB
<br>>>>
<br>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>>
<br>>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>>
<br>>> Have you tried optipng instead? It's giving me further decreases
<br>>> over the
<br>>> compression already done in the latest package.
<br>>
<br>> Oops, I sent my last reply by mistake privately to Nicolas instead
<br>> of the list...
<br>> So here it is again:
<br>>
<br>> The PNGs are much bigger because the lines are now antialiased.
<br>> They look much nicer than the old ones with their steps, but
<br>> compress much much less.
<br>> For sure its doxygen which tells dot to antialias them because I
<br>> didn't update my dot.
</div><br>I wouldn't know how to tell dot to do this, so I'm not sure this is
<br>true.
<br>Maybe a library used by dot got updated (libgd for instance).
<br><br>> So maybe an option in Doxyfile to not antialias these lines ?
<br><br>Not that I'm aware of.
<br><br>Regards,
<br> Dimitri
<br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26580441&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26579661Re: when i document the *.h and the *.c files all functions are documented twice.2009-11-30T10:34:03Z2009-11-30T10:34:03ZPaul JoiremanA solution I use is to bracket the function prototypes with \cond and
<br>\endcond commands in the *.h
<br>file, like so:
<br><br>*.h file:
<br><br>\**
<br> @cond INCLUDE_WITH_DOXYGEN
<br>**/
<br> ...
<br> /* Function prototypes */
<br>\**
<br> @endcond
<br>**/
<br><br>As long as INCLUDE_WIH_DOXYGEN is not defined in your Doxyfile, the function
<br>prototypes will be exclude from the *.h documentation. In this model I'm
<br>assuming that the marked up function comments are in the *.c file.
<br><br>Paul
<br><div class='shrinkable-quote'><br>> -----Original Message-----
<br>> From: vivelafete [mailto:<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26579661&i=0" target="_top" rel="nofollow">vivelafete@...</a>]
<br>> Sent: Monday, November 30, 2009 11:10 AM
<br>> To: <a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26579661&i=1" target="_top" rel="nofollow">doxygen-users@...</a>
<br>> Subject: [Doxygen-users] when i document the *.h and the *.c files all
<br>> functions are documented twice.
<br>>
<br>>
<br>> I searched for a long time for a solution, but i couldn't find one.
<br>>
<br>> Does anybody know how it's possible to document both files with:
<br>> /*! \file example.c*/
<br>> /*! \file example.h*/
<br>>
<br>> but the defined functions just once?
<br>>
<br>> Thanks in advance
<br>> vivelafete
<br>> --
<br>> View this message in context: <a href="http://old.nabble.com/when-i-document-" target="_top" rel="nofollow">http://old.nabble.com/when-i-document-</a><br>> the-*.h-and-the-*.c-files-all-functions-are-documented-twice.-
<br>> tp26578135p26578135.html
<br>> Sent from the Doxygen - Users mailing list archive at Nabble.com.
<br>>
<br>>
<br>> -----------------------------------------------------------------------
<br>> -------
<br>> Let Crystal Reports handle the reporting - Free Crystal Reports 2008
<br>> 30-Day
<br>> trial. Simplify your report design, integration and deployment - and
<br>> focus on
<br>> what you do best, core application coding. Discover what's new with
<br>> Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>> _______________________________________________
<br>> Doxygen-users mailing list
<br>> <a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26579661&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br>> <a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a></div><br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26579661&i=3" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26578135when i document the *.h and the *.c files all functions are documented twice.2009-11-30T09:09:57Z2009-11-30T09:09:57ZvivelafeteI searched for a long time for a solution, but i couldn't find one.
<br><br>Does anybody know how it's possible to document both files with:
<br>/*! \file example.c*/
<br>/*! \file example.h*/
<br><br>but the defined functions just once?
<br><br>Thanks in advance
<br>vivelafete<p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26575465Re: Generated HTML pages are getting huge2009-11-30T05:40:51Z2009-11-30T05:40:51ZEric MateckiNicolas Alvarez wrote:
<div class='shrinkable-quote'><br>> Mathieu Malaterre wrote:
<br>>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>>> png file, we were able to divide the size of the installed tree to
<br>>> 431524 kB
<br>>>
<br>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br>>
<br>> Is the 'convert' step part of the build process? (in debian/rules)
<br>>
<br>> Have you tried optipng instead? It's giving me further decreases over the
<br>> compression already done in the latest package.
</div><br>Oops, I sent my last reply by mistake privately to Nicolas instead of the list...
<br>So here it is again:
<br><br>The PNGs are much bigger because the lines are now antialiased.
<br>They look much nicer than the old ones with their steps, but compress much much less.
<br>For sure its doxygen which tells dot to antialias them because I didn't update my dot.
<br><br>So maybe an option in Doxyfile to not antialias these lines ?
<br><br>--
<br>Keep intel OUTSIDE my Mac !
<br>Hiii !!! I can see Intel chips creeping around my G5 !
<br><br>Eric M.
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26575465&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26571728Re: Static const Variables being documented as functions.2009-11-30T01:35:47Z2009-11-30T01:35:47ZBraden McDanielOn Mon, 2009-11-30 at 10:14 +0100, J.S. van Bethlehem wrote:
<br>> Braden, be aware of the subtle difference between 'this is problematic'
<br>> and 'this is considered bad practice'
<br><br>I am aware of it.
<br><br>And namespace-scope consts in headers are neither problematic nor
<br>considered bad practice.
<br><br>(Top-posting, on the other hand...)
<br><br>--
<br>Braden McDaniel <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26571728&i=0" target="_top" rel="nofollow">braden@...</a>>
<br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26571728&i=1" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26571536Re: Static const Variables being documented as functions.2009-11-30T01:14:36Z2009-11-30T01:14:36ZJ.S. van Bethlehem-2Braden, be aware of the subtle difference between 'this is problematic'
<br>and 'this is considered bad practice'
<br><br>Greetings, Jakob
<br><br>Braden McDaniel wrote:
<div class='shrinkable-quote'><br>> Simon wrote:
<br>>>> I tried doing exactly as you instructed, and the generated documentation
<br>>>> in the header file is correct, but the .cpp file still shows "const
<br>>>> Color::Color COLOR_WHITE" as a function. Any thoughts?
<br>>>
<br>>> I'm working on a geometry library and made a test with a similar line of code:
<br>>>
<br>>> const Vector ONE(1,1,1);
<br>>>
<br>>> In the header file, if you place just that line (which is btw, both a
<br>>> declaration and a definition) doxygen interprets it as a function.
<br>>>
<br>>> Changing the line in the header file for this one:
<br>>>
<br>>> extern const Vector ONE;
<br>>>
<br>>> And adding the original line in a code file:
<br>>>
<br>>> const Vector ONE(1,1,1);
<br>>>
<br>>> Now it gets interpreted by doxygen as a variable. Further, some
<br>>> testing shows it might just be the presence of the parenthesis in the
<br>>> declaration that confuse doxygen... in any case, it's bad practice to
<br>>> have such definitions in header files.
<br>>
<br>> No, it's not.
<br>>
<br>> namespace-scope consts have internal linkage in C++ (unless you specify
<br>> otherwise); so there's no problem with this.
<br>>
</div><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26571536&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26550614Re: Creole output2009-11-27T21:20:05Z2009-11-27T21:20:05ZCamilo PolymerisYes. That's the right URL. libmagt is the project I need the wiki
<br>output for, so I put the XSLT in the wiki repository, seemed to make
<br>more sense to me, given that the goal is to automatically generate
<br>creole/google wiki files. Of course, that doesn't work yet... If the
<br>XSLT grows and becomes more usable for the general public some day, i
<br>will move it to its own repo...
<br>You can take a look at the file here, too:
<br><a href="http://code.google.com/p/libmagt/source/browse/doxy2creole.xslt?repo=wiki" target="_top" rel="nofollow">http://code.google.com/p/libmagt/source/browse/doxy2creole.xslt?repo=wiki</a><br><br>But, as I said, I is really basic and I don't have any experience with
<br>XSLT. Reading about it right now.
<br><br>On Sat, Nov 28, 2009 at 12:26 AM, Nicolas Alvarez
<br><<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26550614&i=0" target="_top" rel="nofollow">nicolas.alvarez@...</a>> wrote:
<div class='shrinkable-quote'><br>> Camilo Polymeris wrote:
<br>>> So.
<br>>> I started writing a very basic doxygen to creole XSLT. If you are
<br>>> interested, I'll keep it at this mercurial repository at the moment:
<br>>>
<br>>> hg clone <a href="https://wiki.libmagt.googlecode.com/hg/" target="_top" rel="nofollow">https://wiki.libmagt.googlecode.com/hg/</a> libmagt-wiki
<br>>
<br>> Is that the right URL? That is your project's wiki, not the source code
<br>> repository...
<br>>
<br>> --
<br>> Nicolas
<br>>
<br>> I read mailing lists through Gmane. Please don't Cc me on replies; it makes
<br>> me get one message on my newsreader and another on email.
<br>>
<br>>
<br>> ------------------------------------------------------------------------------
<br>> Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>> trial. Simplify your report design, integration and deployment - and focus on
<br>> what you do best, core application coding. Discover what's new with
<br>> Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>> _______________________________________________
<br>> Doxygen-users mailing list
<br>> <a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26550614&i=1" target="_top" rel="nofollow">Doxygen-users@...</a>
<br>> <a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br>>
</div><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26550614&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26550214Re: Creole output2009-11-27T19:26:51Z2009-11-27T19:26:51ZNicolas Alvarez-2Camilo Polymeris wrote:
<br>> So.
<br>> I started writing a very basic doxygen to creole XSLT. If you are
<br>> interested, I'll keep it at this mercurial repository at the moment:
<br>>
<br>> hg clone <a href="https://wiki.libmagt.googlecode.com/hg/" target="_top" rel="nofollow">https://wiki.libmagt.googlecode.com/hg/</a> libmagt-wiki
<br><br>Is that the right URL? That is your project's wiki, not the source code
<br>repository...
<br><br>--
<br>Nicolas
<br><br>I read mailing lists through Gmane. Please don't Cc me on replies; it makes
<br>me get one message on my newsreader and another on email.
<br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26550214&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26540704Re: Creole output2009-11-27T02:44:15Z2009-11-27T02:44:15ZCamilo PolymerisSo.
<br>I started writing a very basic doxygen to creole XSLT. If you are
<br>interested, I'll keep it at this mercurial repository at the moment:
<br><br>hg clone <a href="https://wiki.libmagt.googlecode.com/hg/" target="_top" rel="nofollow">https://wiki.libmagt.googlecode.com/hg/</a> libmagt-wiki
<br><br>It's the first time I work with XSLT and the code is like 50 lines
<br>right now, so don't expect anthing useful, but it shows that it is
<br>possible.
<br>Here is sample output:
<br><a href="http://code.google.com/p/libmagt/wiki/Sandbox" target="_top" rel="nofollow">http://code.google.com/p/libmagt/wiki/Sandbox</a><br><br>On Thu, Nov 26, 2009 at 10:58 PM, Camilo Polymeris <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26540704&i=0" target="_top" rel="nofollow">cpolymeris@...</a>> wrote:
<br>>
<br>> Hello
<br>> does anybody have any experience outputting wiki or creole with doxygen or other documentation generators? What would be the best way to go about it? An XSLT file to transform doxygen's XML output to creole? Any suggestions?
<br>> Thanks,
<br>> Camilo
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26540704&i=1" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26537112Creole output2009-11-26T17:58:17Z2009-11-26T17:58:17ZCamilo PolymerisHello<br>does anybody have any experience outputting wiki or creole with doxygen or other documentation generators? What would be the best way to go about it? An XSLT file to transform doxygen's XML output to creole? Any suggestions?<br>
Thanks,<br>Camilo<br>
<br />------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26537112&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26533613User-defined generated HTML header2009-11-26T10:50:21Z2009-11-26T10:50:21ZSimon Turner-4Hi there,
<br> I've recently created a "\page table_of_contents" which only
<br>contains an HTML table with the contents categorized in a few columns.
<br> I normally used "\copydoc table_of_contents" at the end of my classes
<br>and modules details section, but I realize it could be done
<br>automatically by allowing to manipulate the content of the header or
<br>footer using special commands... here's my idea, let me know what you
<br>think of it...
<br><br>Just like you would use "\mainpage" to manipulate the content of the
<br>index, I'm thinking "\htmlheader" could be used to replace the
<br>doxygen-generated navigation header, same for "\htmlfooter". I know
<br>you can include a static html file as header, but this file won't take
<br>any of doxygen's advantages...
<br><br>Imagine the following code was possible and note that I'm taking
<br>advantage of doxygen's list syntax, reference title's substitution and
<br>auto-linking... to build a simple header with a logo on the left and a
<br>quick table of contents on the right.
<br><br>/**
<br>\htmlheader
<br><table border=0 width=100%><tr>
<br><td> <img src=...> </td>
<br><td>
<br>* Table of contents:
<br>* - \ref NS1
<br>* - \ref NS1::Class1
<br>* - \ref NS1::Class2
<br>* - \ref NS1
<br>* - \ref some_module
<br>* - \ref some_other_module
<br></td>
<br></tr></table>
<br>**/
<br><br>Simon
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26533613&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26521810Re: Static const Variables being documented as functions.2009-11-25T14:58:28Z2009-11-25T14:58:28ZBraden McDanielSimon wrote:
<div class='shrinkable-quote'><br>>> I tried doing exactly as you instructed, and the generated documentation
<br>>> in the header file is correct, but the .cpp file still shows "const
<br>>> Color::Color COLOR_WHITE" as a function. Any thoughts?
<br>>
<br>>
<br>> I'm working on a geometry library and made a test with a similar line of code:
<br>>
<br>> const Vector ONE(1,1,1);
<br>>
<br>> In the header file, if you place just that line (which is btw, both a
<br>> declaration and a definition) doxygen interprets it as a function.
<br>>
<br>> Changing the line in the header file for this one:
<br>>
<br>> extern const Vector ONE;
<br>>
<br>> And adding the original line in a code file:
<br>>
<br>> const Vector ONE(1,1,1);
<br>>
<br>> Now it gets interpreted by doxygen as a variable. Further, some
<br>> testing shows it might just be the presence of the parenthesis in the
<br>> declaration that confuse doxygen... in any case, it's bad practice to
<br>> have such definitions in header files.
</div><br>No, it's not.
<br><br>namespace-scope consts have internal linkage in C++ (unless you specify
<br>otherwise); so there's no problem with this.
<br><br>--
<br>Braden McDaniel e-mail: <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26521810&i=0" target="_top" rel="nofollow">braden@...</a>>
<br><<a href="http://endoframe.com" target="_top" rel="nofollow">http://endoframe.com</a>> Jabber: <<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26521810&i=1" target="_top" rel="nofollow">braden@...</a>>
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26521810&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26519287Re: Static const Variables being documented as functions.2009-11-25T11:53:47Z2009-11-25T11:53:47ZDimitri van Heesch-2<br>On 25 nov 2009, at 20:22, Simon wrote:
<br><div class='shrinkable-quote'><br>>> I tried doing exactly as you instructed, and the generated
<br>>> documentation
<br>>> in the header file is correct, but the .cpp file still shows "const
<br>>> Color::Color COLOR_WHITE" as a function. Any thoughts?
<br>>
<br>>
<br>> I'm working on a geometry library and made a test with a similar
<br>> line of code:
<br>>
<br>> const Vector ONE(1,1,1);
<br>>
<br>> In the header file, if you place just that line (which is btw, both a
<br>> declaration and a definition) doxygen interprets it as a function.
<br>>
<br>> Changing the line in the header file for this one:
<br>>
<br>> extern const Vector ONE;
<br>>
<br>> And adding the original line in a code file:
<br>>
<br>> const Vector ONE(1,1,1);
<br>>
<br>> Now it gets interpreted by doxygen as a variable. Further, some
<br>> testing shows it might just be the presence of the parenthesis in the
<br>> declaration that confuse doxygen... in any case, it's bad practice to
<br>> have such definitions in header files.
</div><br>Some more explanation:
<br><br>The problem for doxygen is it needs to distinguish between
<br><br>1) #define one 1
<br> const Vector ONE(one,one,one);
<br><br>which is a variable and
<br><br>2) const Vector ONE(int,int,int);
<br><br>which is a function prototype.
<br><br>As you can see the syntax of the C++ language is ambiguous in this
<br>respect and
<br>type analysis is needed to determine which of the two cases is meant.
<br><br>Doxygen has no full type information and uses some heuristics. One of
<br>the heuristics
<br>is the location where this code is found (source or header). A file
<br>ending with .h or .c
<br>is treated as a C file, and option 2) is assumed.
<br>So if you use .hpp or .hh for your header files it would have worked ;-)
<br><br>See doxygen.cpp function isVarWithConstructor() for even more details.
<br><br>Regards,
<br> Dimitri
<br><br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26519287&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26518773Re: Static const Variables being documented as functions.2009-11-25T11:22:01Z2009-11-25T11:22:01ZSimon Turner-4> I tried doing exactly as you instructed, and the generated documentation
<br>> in the header file is correct, but the .cpp file still shows "const
<br>> Color::Color COLOR_WHITE" as a function. Any thoughts?
<br><br><br>I'm working on a geometry library and made a test with a similar line of code:
<br><br>const Vector ONE(1,1,1);
<br><br>In the header file, if you place just that line (which is btw, both a
<br>declaration and a definition) doxygen interprets it as a function.
<br><br>Changing the line in the header file for this one:
<br><br>extern const Vector ONE;
<br><br>And adding the original line in a code file:
<br><br>const Vector ONE(1,1,1);
<br><br>Now it gets interpreted by doxygen as a variable. Further, some
<br>testing shows it might just be the presence of the parenthesis in the
<br>declaration that confuse doxygen... in any case, it's bad practice to
<br>have such definitions in header files.
<br><br>Good luck!
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26518773&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26516792Re: Static const Variables being documented as functions.2009-11-25T09:19:03Z2009-11-25T09:19:03ZLeach, Daniel J.Hi Laurent,
<br><br>I tried doing exactly as you instructed, and the generated documentation
<br>in the header file is correct, but the .cpp file still shows "const
<br>Color::Color COLOR_WHITE" as a function. Any thoughts?
<br><br>Thanks,
<br><br>Dan
<br><br><br>-----Original Message-----
<br>From: Laurent GRANVILLIERS [mailto:<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26516792&i=0" target="_top" rel="nofollow">Laurent.Granvilliers@...</a>]
<br>Sent: Wednesday, November 25, 2009 1:25 AM
<br>To: Leach, Daniel J.
<br>Subject: Re: [Doxygen-users] Static const Variables being documented as
<br>functions.
<br><br>Dear Dan,
<br><br>The static const variable must be defined in the header as follows:
<br><br>//! \brief white color
<br>//! \brief defined as a constant class variable static const Color
<br>COLOR_WHITE;
<br><br>It must be initialized in the associated .cpp file as follows:
<br><br>const Color::Color COLOR_WHITE (255, 255, 255);
<br><br>Best regards,
<br><br>Laurent
<br><br><br>> Hello,
<br>>
<br>> I have code similar to the following:
<br>>
<br>> static const Color COLOR_WHITE(255, 255, 255);
<br>>
<br>> That initializes COLOR_WHITE with the above values. I have read
<br>> through the list a bit and realize that Doxygen can't always tell the
<br>> difference between a variable and a function, but shouldn't the fact
<br>that "Color"
<br>> is there indicate that what follows must be a declaration of a Color
<br>> variable? My knowledge of the inner workings of C++ is limited, but
<br>> to me it seems this can be fixed. Or am I missing something else
<br>entirely?
<br>>
<br>> Thanks,
<br>>
<br>> Dan
<br><br><br>25/11/2009This e-mail transmission contains information that is confidential and may be privileged. It is intended only for the addressee(s) named above. If you receive this e-mail in error, please do not read, copy or disseminate it in any manner. If you are not the intended recipient, any disclosure, copying, distribution or use of the contents of this information is prohibited. Please reply to the message immediately by informing the sender that the message was misdirected. After replying, please erase it from your computer system. Your assistance in correcting this error is appreciated.
<br><br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26516792&i=1" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26515074Re: Hide private members in UML2009-11-25T07:48:59Z2009-11-25T07:48:59ZSunnyDhi Janosch,
<br><br>I am experiencing the same issue you mentioned. Have you been able to figure out a solution?
<br><br>Thanks,
<br>Dong
<br><br><br><blockquote class="quote light-black dark-border-color"><div class="quote light-border-color">
<div class="quote-author" style="font-weight: bold;">Janosch Peters-4 wrote:</div>
<div class="quote-message shrinkable-quote">Hi list,
<br><br>How do I configure the UML output?
<br><br>Id like to hide all private members in the UML output, so I set
<br>EXTRACT_PRIVATE=NO. The private members are not shown in the html output
<br>as expected, but they still show up in UML class diagrams generated by
<br>graphviz.
<br><br>Thanks in advance,
<br>Janosch
<br><br><br>------------------------------------------------------------------------------
<br>This SF.net email is sponsored by:
<br>SourcForge Community
<br>SourceForge wants to tell your story.
<br><a href="http://p.sf.net/sfu/sf-spreadtheword" target="_top" rel="nofollow">http://p.sf.net/sfu/sf-spreadtheword</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br>Doxygen-users@lists.sourceforge.net
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a></div>
</div></blockquote>
<p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26501601Static const Variables being documented as functions.2009-11-24T11:07:00Z2009-11-24T11:07:00ZLeach, Daniel J.Hello,
<br><br>I have code similar to the following:
<br><br>static const Color COLOR_WHITE(255, 255, 255);
<br><br>That initializes COLOR_WHITE with the above values. I have read through
<br>the list a bit and realize that Doxygen can't always tell the difference
<br>between a variable and a function, but shouldn't the fact that "Color"
<br>is there indicate that what follows must be a declaration of a Color
<br>variable? My knowledge of the inner workings of C++ is limited, but to
<br>me it seems this can be fixed. Or am I missing something else entirely?
<br><br>Thanks,
<br><br>Dan
<br><br>24/11/2009This e-mail transmission contains information that is confidential and may be privileged. It is intended only for the addressee(s) named above. If you receive this e-mail in error, please do not read, copy or disseminate it in any manner. If you are not the intended recipient, any disclosure, copying, distribution or use of the contents of this information is prohibited. Please reply to the message immediately by informing the sender that the message was misdirected. After replying, please erase it from your computer system. Your assistance in correcting this error is appreciated.
<br><br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26501601&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26499947Re: Generated HTML pages are getting huge2009-11-24T09:17:25Z2009-11-24T09:17:25ZNicolas Alvarez-2Mathieu Malaterre wrote:
<br>> Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>> png file, we were able to divide the size of the installed tree to
<br>> 431524 kB
<br>>
<br>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br>> <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br><br>Is the 'convert' step part of the build process? (in debian/rules)
<br><br>Have you tried optipng instead? It's giving me further decreases over the
<br>compression already done in the latest package.
<br><br>--
<br>Nicolas
<br><br>I read mailing lists through Gmane. Please don't Cc me on replies; it makes
<br>me get one message on my newsreader and another on email.
<br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26499947&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26498935Re: Generated HTML pages are getting huge2009-11-24T08:18:11Z2009-11-24T08:18:11ZmalatOn Sat, Nov 21, 2009 at 3:01 AM, Nicolas Alvarez
<br><<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26498935&i=0" target="_top" rel="nofollow">nicolas.alvarez@...</a>> wrote:
<div class='shrinkable-quote'><br>> Nicolas Alvarez wrote:
<br>>> Mathieu Malaterre wrote:
<br>>>> Has anyone discover why using newer doxygen version increase the size
<br>>>> of the HTML output ?
<br>>>>
<br>>>> For instance a package used to be:
<br>>>> <a href="http://packages.debian.org/etch/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/etch/vtk-doc</a><br>>>> Installed Size 199724 kB
<br>>>>
<br>>>> became:
<br>>>>
<br>>>> <a href="http://packages.debian.org/lenny/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/lenny/vtk-doc</a><br>>>> Installed Size 247068 kB
<br>>>>
<br>>>> and is now:
<br>>>>
<br>>>> <a href="http://packages.debian.org/squeeze/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/squeeze/vtk-doc</a><br>>>> Installed Size 855380 kB
<br>>>
<br>>> I'm now downloading the packages (may take me an hour), and will
<br>>> investigate.
<br>>
<br>> It simply looks like the latest package enabled a **lot** more diagrams...
</div><br>Here is a short update.
<br><a href="http://packages.debian.org/sid/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/sid/vtk-doc</a><br><br>Using SEARCHENGINE=NO and using imagemagick/convert to compress the
<br>png file, we were able to divide the size of the installed tree to
<br>431524 kB
<br><br><a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557237</a><br><a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238" target="_top" rel="nofollow">http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=557238</a><br><br>Hopefully this will help anyone /else/ doing vtk-style doxygen doc
<br>package for debian.
<br><br>HTH
<br>--
<br>Mathieu
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26498935&i=1" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26475607Mis-located deprected.html2009-11-23T02:26:42Z2009-11-23T02:26:42ZNeil Bird<br> Just going through a cleaned up 1.6.1+ output (having fixed a slew of
<br>warnings, etc.), and I have just found an oddity with the deprecated.html file.
<br><br> tree.html was linking to dN/dNN/deprecated.html, which it couldn't find.
<br> I edited it to point to the top-level dir. (where it was), and it loaded
<br>OK. But then, all the code links were wrong: they're all '../../dN/dNN',
<br>as if deprecated.html really did want to be down in a sub directory.
<br><br> So, where should it have ended up?
<br><br>--
<br>[neil@fnx ~]# rm -f .signature
<br>[neil@fnx ~]# ls -l .signature
<br>ls: .signature: No such file or directory
<br>[neil@fnx ~]# exit
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26475607&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26453051Re: Generated HTML pages are getting huge2009-11-20T18:01:22Z2009-11-20T18:01:22ZNicolas Alvarez-2Nicolas Alvarez wrote:
<div class='shrinkable-quote'><br>> Mathieu Malaterre wrote:
<br>>> Has anyone discover why using newer doxygen version increase the size
<br>>> of the HTML output ?
<br>>>
<br>>> For instance a package used to be:
<br>>> <a href="http://packages.debian.org/etch/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/etch/vtk-doc</a><br>>> Installed Size 199724 kB
<br>>>
<br>>> became:
<br>>>
<br>>> <a href="http://packages.debian.org/lenny/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/lenny/vtk-doc</a><br>>> Installed Size 247068 kB
<br>>>
<br>>> and is now:
<br>>>
<br>>> <a href="http://packages.debian.org/squeeze/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/squeeze/vtk-doc</a><br>>> Installed Size 855380 kB
<br>>
<br>> I'm now downloading the packages (may take me an hour), and will
<br>> investigate.
</div><br>It simply looks like the latest package enabled a **lot** more diagrams...
<br><br>--
<br>Nicolas
<br><br>I read mailing lists through Gmane. Please don't Cc me on replies; it makes
<br>me get one message on my newsreader and another on email.
<br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26453051&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26452685Re: Generated HTML pages are getting huge2009-11-20T16:58:03Z2009-11-20T16:58:03ZNicolas Alvarez-2Mathieu Malaterre wrote:
<div class='shrinkable-quote'><br>> Has anyone discover why using newer doxygen version increase the size
<br>> of the HTML output ?
<br>>
<br>> For instance a package used to be:
<br>> <a href="http://packages.debian.org/etch/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/etch/vtk-doc</a><br>> Installed Size 199724 kB
<br>>
<br>> became:
<br>>
<br>> <a href="http://packages.debian.org/lenny/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/lenny/vtk-doc</a><br>> Installed Size 247068 kB
<br>>
<br>> and is now:
<br>>
<br>> <a href="http://packages.debian.org/squeeze/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/squeeze/vtk-doc</a><br>> Installed Size 855380 kB
</div><br>I'm now downloading the packages (may take me an hour), and will
<br>investigate.
<br><br>--
<br>Nicolas
<br><br>I read mailing lists through Gmane. Please don't Cc me on replies; it makes
<br>me get one message on my newsreader and another on email.
<br><br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26452685&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26446669Generated HTML pages are getting huge2009-11-20T08:52:02Z2009-11-20T08:52:02ZmalatHas anyone discover why using newer doxygen version increase the size
<br>of the HTML output ?
<br><br>For instance a package used to be:
<br><a href="http://packages.debian.org/etch/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/etch/vtk-doc</a><br>Installed Size 199724 kB
<br><br>became:
<br><br><a href="http://packages.debian.org/lenny/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/lenny/vtk-doc</a><br>Installed Size 247068 kB
<br><br>and is now:
<br><br><a href="http://packages.debian.org/squeeze/vtk-doc" target="_top" rel="nofollow">http://packages.debian.org/squeeze/vtk-doc</a><br>Installed Size 855380 kB
<br><br>--
<br>Mathieu
<br><br>------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br>_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26446669&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26446431Description in the main page of the html doc pages2009-11-20T08:37:20Z2009-11-20T08:37:20ZMarMarAbaThank you very much for your answers, I wanted to remove the comments from the code because all of theme are in the documentation files created with doxygen, but it is a good idea leaving the coments in the code for clarity purposes and, of course, the doxygen code is easily readable for a human, so it will clarify much concepts while reading the code.<br>
<br>OK, thank you once more.<br>MarMarAba<br><br>
<br />------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26446431&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26436591Re: Description in the main page of the html doc pages2009-11-19T16:12:53Z2009-11-19T16:12:53ZBradley Ward-2<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=utf-8">
<meta name=Generator content="Microsoft Word 12 (filtered medium)">
<!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple>
<div class=Section1>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>My suggestion - don't remove the Doxygen comments, but rather put
a comment in a noticeable place in your source code saying you are using
Doxygen for automatic documentation generation purposes, and include the URL to
the Doxygen web site. I know if I were a professor and saw that I would award
extra points! From what I have seen in industry for 35 years now, VERY few
software engineers coming out of school have any notion of how important good
comments and good documentation is to the life of a software product!<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'>Brad<o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<p class=MsoNormal><span style='font-size:11.0pt;font-family:"Calibri","sans-serif";
color:#1F497D'><o:p> </o:p></span></p>
<div style='border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in'>
<p class=MsoNormal><b><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'>From:</span></b><span style='font-size:10.0pt;font-family:"Tahoma","sans-serif"'> MarMarAba
[mailto:<a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26436591&i=0" target="_top" rel="nofollow">marmaraba@...</a>] <br>
<b>Sent:</b> Thursday, November 19, 2009 5:14 PM<br>
<b>To:</b> <a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26436591&i=1" target="_top" rel="nofollow">doxygen-users@...</a><br>
<b>Subject:</b> Re: [Doxygen-users] Description in the main page of the html
doc pages<o:p></o:p></span></p>
</div>
<p class=MsoNormal><o:p> </o:p></p>
<p class=MsoNormal>Thank you very much! It was so ovious...<br>
<br>
Sorry for wasting your time with these stupid question, but I were looking for
that information since one month ago <span class=shorttext><span style='background:white'>sporadically</span></span> and I did not find that
special command.<br>
<br>
And other fast question is how can I remove all the doxygen-coments from my
complation, to submit the code clean of coments to my teachers? I were looking
for an option in the GUI frontend of doxygen or a program for do these
operation without success.<br>
<br>
Thanks again.<o:p></o:p></p>
</div>
</body>
</html>
<br />------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26436591&i=2" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26435087Re: Description in the main page of the html doc pages2009-11-19T14:14:10Z2009-11-19T14:14:10ZMarMarAbaThank you very much! It was so ovious...<br><br>Sorry for wasting your time with these stupid question, but I were looking for that information since one month ago <span id="result_box" class="short_text"><span style="background-color: rgb(255, 255, 255);" title="esporádicamente">sporadically</span></span> and I did not find that special command.<br>
<br>And other fast question is how can I remove all the doxygen-coments from my complation, to submit the code clean of coments to my teachers? I were looking for an option in the GUI frontend of doxygen or a program for do these operation without success.<br>
<br>Thanks again.<br>
<br />------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26435087&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>tag:old.nabble.com,2006:post-26434099Description in the main page of the html doc pages2009-11-19T13:01:48Z2009-11-19T13:01:48ZMarMarAba<div class="gmail_quote">Hello everybody.<br><br>I am developing an easy project for my carear and I would like to know how to put a description and some information of the application in the main page of the html documentation created with doxygen.<br>
<br>Thanks.<br><font color="#888888">MarMarAba<br>
</font></div><br>
<br />------------------------------------------------------------------------------
<br>Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
<br>trial. Simplify your report design, integration and deployment - and focus on
<br>what you do best, core application coding. Discover what's new with
<br>Crystal Reports now. <a href="http://p.sf.net/sfu/bobj-july" target="_top" rel="nofollow">http://p.sf.net/sfu/bobj-july</a><br />_______________________________________________
<br>Doxygen-users mailing list
<br><a href="http://old.nabble.com/user/SendEmail.jtp?type=post&post=26434099&i=0" target="_top" rel="nofollow">Doxygen-users@...</a>
<br><a href="https://lists.sourceforge.net/lists/listinfo/doxygen-users" target="_top" rel="nofollow">https://lists.sourceforge.net/lists/listinfo/doxygen-users</a><br><p>From forum: <a href="http://old.nabble.com/Doxygen---Users-f22198.html" embed="fixTarget[22198]" target="_top" >Doxygen - Users</a></p>