Doxygen performance issues

classic Classic list List threaded Threaded
7 messages Options
Reply | Threaded
Open this post in threaded view
|

Doxygen performance issues

Neil Williams-2
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/


_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Doxygen performance issues

David Hampton-2
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
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: Doxygen performance issues

Stewart Wright
In reply to this post by Neil Williams-2
G'day Neil,

* Neil Williams <[hidden email]> [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.

_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

attachment0 (282 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Doxygen performance issues

Derek Atkins
"Stewart V. Wright" <[hidden email]> writes:

> G'day Neil,
>
> * Neil Williams <[hidden email]> [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
       [hidden email]                        PGP key available
_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: Doxygen performance issues

Derek Atkins
In reply to this post by David Hampton-2
David Hampton <[hidden email]> 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
       [hidden email]                        PGP key available
_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel
Reply | Threaded
Open this post in threaded view
|

Re: Doxygen performance issues

Neil Williams-2
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/


_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel

attachment0 (196 bytes) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Doxygen performance issues

Derek Atkins
Neil Williams <[hidden email]> 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
       [hidden email]                        PGP key available
_______________________________________________
gnucash-devel mailing list
[hidden email]
https://lists.gnucash.org/mailman/listinfo/gnucash-devel