Doxygen performance issues
How many of us build the Doxygen HTML regularly? I lurk on the doxygen mailing list and the speed of doxygen has come up. There are a few issues we can look at ourselves. 1. Our doxygen.cfg.in is out of date compared to Doxygen itself. Running: $ doxygen -u doxygen.cfg.in updates the config file to your currently installed Doxygen version. 2. In the new config file, there are options available that may speed up our doxygen generation immensely. Currently, it is SO bad that my (admittedly underpowered) FC3 box runs out of memory when processing G2 Doxygen and restarts X! Some of the newer options address these speed / memory issues. The biggest problem is that our config forces doxygen to accumulate all the diffs in memory until dumping the HTML in a single directory. It is in this stage that my FC3 box falls over and I've noticed performance issues on other boxes where large file writes are impaired compared to a desktop box. I'd hope that doxygen would not update the config in such a way as to make it incompatible with earlier versions but I'm cautious about testing any changes on FC3. Would someone with FC3 be willing to do a before and after time-comparison if I send them a doxygen.cfg.in patch? (And let me know if any config options produce errors like "Unknown option in config")? -- Neil Williams = http://www.data-freedom.org/ http://www.nosoftwarepatents.com/ http://www.linux.codehelp.co.uk/ pgpIon2hWP8L5.pgp Description: PGP signature ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: Doxygen performance issues
On Fri, 2005-10-28 at 22:32 +0100, Neil Williams wrote: > How many of us build the Doxygen HTML regularly? Semi-regularly. > I'd hope that doxygen would not update the config in such a way as to make it > incompatible with earlier versions but I'm cautious about testing any changes > on FC3. Would someone with FC3 be willing to do a before and after > time-comparison if I send them a doxygen.cfg.in patch? (And let me know if > any config options produce errors like "Unknown option in config")? I don't have an FC3 development system, but I can test it on FC4 if you like. David ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: Doxygen performance issues
G'day Neil, * Neil Williams <[EMAIL PROTECTED]> [051028 16:34]: > 1. Our doxygen.cfg.in is out of date compared to Doxygen itself. Running: > $ doxygen -u doxygen.cfg.in > updates the config file to your currently installed Doxygen version. I really think this relates to the question that was doing the rounds recently (I can't remember the answer) relating to the base release version. Has it been updated to FC 2/3/4 or will the G2 branch remain at RH7.3 ? ;-) We need to ensure that the doxygen version is at most the default version for the base release of the G2 port. My FC3 box is running v1.4.4 currently. I notice that the latest release is 1.4.5, but I'm not sure if/when that will be released for FC3... > I'd hope that doxygen would not update the config in such a way as to make it > incompatible with earlier versions but I'm cautious about testing any changes > on FC3. Would someone with FC3 be willing to do a before and after > time-comparison if I send them a doxygen.cfg.in patch? (And let me know if > any config options produce errors like "Unknown option in config")? I'd be willing to help out with this. (Assuming my FC3 box doesn't die like yours does!) Cheers, S. pgpnYc3FN08XG.pgp Description: PGP signature ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: Doxygen performance issues
"Stewart V. Wright" <[EMAIL PROTECTED]> writes: > G'day Neil, > > * Neil Williams <[EMAIL PROTECTED]> [051028 16:34]: >> 1. Our doxygen.cfg.in is out of date compared to Doxygen itself. Running: >> $ doxygen -u doxygen.cfg.in >> updates the config file to your currently installed Doxygen version. > > I really think this relates to the question that was doing the rounds > recently (I can't remember the answer) relating to the base release > version. Has it been updated to FC 2/3/4 or will the G2 branch remain > at RH7.3 ? ;-) We need to ensure that the doxygen version is at > most the default version for the base release of the G2 port. G2 release is targetted at FC3/RHEL4 -derek -- Derek Atkins, SB '93 MIT EE, SM '95 MIT Media Laboratory Member, MIT Student Information Processing Board (SIPB) URL: http://web.mit.edu/warlord/PP-ASEL-IA N1NWH [EMAIL PROTECTED]PGP key available ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: Doxygen performance issues
David Hampton <[EMAIL PROTECTED]> writes: > On Fri, 2005-10-28 at 22:32 +0100, Neil Williams wrote: >> How many of us build the Doxygen HTML regularly? > > Semi-regularly. > >> I'd hope that doxygen would not update the config in such a way as to make >> it >> incompatible with earlier versions but I'm cautious about testing any >> changes >> on FC3. Would someone with FC3 be willing to do a before and after >> time-comparison if I send them a doxygen.cfg.in patch? (And let me know if >> any config options produce errors like "Unknown option in config")? > > I don't have an FC3 development system, but I can test it on FC4 if you > like. I do have an FC3 dev system, so I can test this for you.. However, keep in mind that the CVS/SVN server is running FC1, where the nightly doc build is done... I'm willing to update doxygen to a more recent version if necessary, but just keep that in mind when making changes. I don't plan to update the CVS/SVN machine from FC1 anytime soon. > David -derek -- Derek Atkins, SB '93 MIT EE, SM '95 MIT Media Laboratory Member, MIT Student Information Processing Board (SIPB) URL: http://web.mit.edu/warlord/PP-ASEL-IA N1NWH [EMAIL PROTECTED]PGP key available ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: Doxygen performance issues
On Monday 31 October 2005 9:31 pm, Derek Atkins wrote: > I do have an FC3 dev system, so I can test this for you.. However, > keep in mind that the CVS/SVN server is running FC1, where the nightly > doc build is done... I'm willing to update doxygen to a more recent > version if necessary, but just keep that in mind when making changes. I have now had feedback on the update and any performance problems appear to be due to my relatively underpowered systems - David's machine manages a doxygen build 500% faster than mine. Patching did make that a little faster but the main performance hit seems to be my P3 700MHz. It's just as well that all my other work is on much smaller projects! > I don't plan to update the CVS/SVN machine from FC1 anytime soon. That's understandable - I'll leave the doxygen config as is. Any performance gain is likely to be small compared to the actual hardware. I was disappointed that my iBook didn't compare favourably though. It was only a few percentage points better than my P3. :-( Maybe this also explains why rebuilding the gnucash tree from a make distclean every time is such a PITA for me and less of an issue for David! My current bash script to rebuild G2 takes an hour to go from make distclean, through autogen, make, make clean and make install to make dist. -- Neil Williams = http://www.data-freedom.org/ http://www.nosoftwarepatents.com/ http://www.linux.codehelp.co.uk/ pgp3HRtW3Y2q5.pgp Description: PGP signature ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: Doxygen performance issues
Neil Williams <[EMAIL PROTECTED]> writes: > Maybe this also explains why rebuilding the gnucash tree from a make > distclean every time is such a PITA for me and less of an issue for > David! > > My current bash script to rebuild G2 takes an hour to go from make > distclean, through autogen, make, make clean and make install to > make dist. WOW! On my laptop a full lndir, autogen, make, make install takes maybe 20 minutes.. Maybe.. I didn't actually time it. It might be closer to 10. -derek -- Derek Atkins, SB '93 MIT EE, SM '95 MIT Media Laboratory Member, MIT Student Information Processing Board (SIPB) URL: http://web.mit.edu/warlord/PP-ASEL-IA N1NWH [EMAIL PROTECTED]PGP key available ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
FW: Re: Doxygen performance issues
- Forwarded message from Neil Williams <[EMAIL PROTECTED]> - > > My FC3 box is running v1.4.4 currently. I notice that the latest > > release is 1.4.5 > > Correct. That's what I'm using on Debian unstable. There are number of new > options from 1.4.4 to 1.4.5. So is there a consensus in the devs WRT what version of doxygen we are aiming for? > You haven't tried to build "cd src/doc/ && make doc" yet? Yup, didn't take too long and didn't crash my machine. You must have a REALLY underpowered setup! ;-) I have "time"ed a "make doc" and from a clean autogen.sh run on my directory, I get the following... real1m53.387s user1m31.535s sys 0m5.951s I'm really surprised you are having problems with doxygen, I honestly don't see anything that is vaguely necessitating any changes. By that I mean "make doc" is relatively fast and there are no obvious errors. Are you sure you haven't done something to cause your doxygen to play up? > Patch for src/doc/doxygen.cfg.in is attached. I'll apply it when it becomes clear to me what version of doxygen we/you/the collective will of the devs are talking about. Cheers, S. pgpBqggpsnzrP.pgp Description: PGP signature ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Re: FW: Re: Doxygen performance issues
"Stewart V. Wright" <[EMAIL PROTECTED]> writes: > - Forwarded message from Neil Williams <[EMAIL PROTECTED]> - > >> > My FC3 box is running v1.4.4 currently. I notice that the latest >> > release is 1.4.5 >> >> Correct. That's what I'm using on Debian unstable. There are number of new >> options from 1.4.4 to 1.4.5. > > So is there a consensus in the devs WRT what version of doxygen we are > aiming for? G2 release (including docs) is aimed at FC3 == doxygen 1.4.4. -derek -- Derek Atkins, SB '93 MIT EE, SM '95 MIT Media Laboratory Member, MIT Student Information Processing Board (SIPB) URL: http://web.mit.edu/warlord/PP-ASEL-IA N1NWH [EMAIL PROTECTED]PGP key available ___ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel