Feature Request: A small change would make doxygen fit for incremental SVN updates

View: New views
4 Messages — Rating Filter:   Alert me  

Feature Request: A small change would make doxygen fit for incremental SVN updates

by Thomas T.-2 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Hello,

We are using doxygen quite successfully in our project, thanks for a
great tool!

I have a little feature request that could probably be implemented
almost instantly. We need to store the doxygen HTML output in a
Subversion repository, since users do not want to create the
documentation for themselves and we distribute the code via SVN, so we
check the HTML files produced by doxygen into the SVN repository. I know
SVN is not a conventional place to put documentation, but in our project
it is the only convenient way to keep it updated.

However, doxygen even for unchanged pages produces new files that are
not identical in content (mainly the footer), so each time the
documentation needs to be reproduced, the whole documentation is
uploaded to the SVN server. So my request is to make an option to
disable these "Generated on <date> <tim> for <project> by <doxygen
version>" footers from the files so they do no longer differ in content
and Subversion will recognize them as same.

That would really be a relief!

Thanks,
Thomas

-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

Re: Feature Request: A small change would make doxygen fit for incremental SVN updates

by Andrew Finkenstadt :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

I second the request.  I have a nightly job that regenerates the documentation for a pretty big tool, it takes the better part of 4-6 hours when done from scratch.  I would check-in the files to our perforce depot to make them available via p4web, if they didn't generate gabillions of changed files "for no reason".

--andy


On Fri, Aug 29, 2008 at 11:02 PM, Thomas T. <doxygen-develop@...> wrote:
So my request is to make an option to
disable these "Generated on <date> <tim> for <project> by <doxygen
version>" footers from the files so they do no longer differ in content
and Subversion will recognize them as same.


-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

Re: Feature Request: A small change would make doxygen fit for incremental SVN updates

by Erik Zeek :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

On Friday 29 August 2008, Thomas T. wrote:

> Hello,
>
> We are using doxygen quite successfully in our project, thanks for a
> great tool!
>
> I have a little feature request that could probably be implemented
> almost instantly. We need to store the doxygen HTML output in a
> Subversion repository, since users do not want to create the
> documentation for themselves and we distribute the code via SVN, so we
> check the HTML files produced by doxygen into the SVN repository. I know
> SVN is not a conventional place to put documentation, but in our project
> it is the only convenient way to keep it updated.
>
> However, doxygen even for unchanged pages produces new files that are
> not identical in content (mainly the footer), so each time the
> documentation needs to be reproduced, the whole documentation is
> uploaded to the SVN server. So my request is to make an option to
> disable these "Generated on <date> <tim> for <project> by <doxygen
> version>" footers from the files so they do no longer differ in content
> and Subversion will recognize them as same.
>
> That would really be a relief!
>
> Thanks,
> Thomas

Perhaps your looking for HTML_HEADER and HTML_FOOTER?
http://www.stack.nl/~dimitri/doxygen/config.html#cfg_html_header

Erik

--
*******************************************
Erik Zeek
Email: mailto:zeekec@...
Html:  http://www.physast.uga.edu/~zeekec
*******************************************
Against stupidity the very gods
Themselves contend in vain.
 - Johann Christoph Friedrich von Schiller (1801)
*******************************************

-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop

Re: Feature Request: A small change would makedoxygen fit for incremental SVN updates

by Thomas T.-2 :: Rate this Message:

Reply to Author | View Threaded | Show Only this Message

Great, that worked! Thanks so much, Thomas

Erik Zeek wrote:
Re: [Doxygen-develop] Feature Request: A small change would makedoxygen fit for incremental SVN updates

Perhaps your looking for HTML_HEADER and HTML_FOOTER?
http://www.stack.nl/~dimitri/doxygen/config.html#cfg_html_header

Erik



-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Doxygen-develop mailing list
Doxygen-develop@...
https://lists.sourceforge.net/lists/listinfo/doxygen-develop
LightInTheBox - Buy quality products at wholesale price!