[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Doxygen/LXR output best practices? Put in src repo?

From: Matt England <mengland_at_mengland.net>
Date: 2006-02-19 02:03:56 CET

Hello,

My project is generating Doxygen (<http://doxygen.org/>) and LXR
(<http://sourceforge.net/projects/lxr/>) output from our svn-based source
code automatically.

Question: does anyone have experience with
controlling/distributing/publicizing this content (from Doxygen and/or LXR
or related auto-generated-docs-from source files stuff)? More importantly,
does the Subversion community consider it good practice to put this output
under repo control, namely the same repo that has the source? eg, make the
following subdirs in the repo:

svnrepo-name/trunk/autodoc/doxygen
svnrepo-name/trunk/autodoc/lxr
svnrepo-name/trunk/autodoc/uml

? Is it possibly better to have:

svnrepo-name-doc/trunk/doxygen
svnrepo-name-doc/trunk/lxr
svnrepo-name-doc/trunk/uml

My experience has taught me that it's generally easier to have one or at
least fewer repositories then more of them (having funneled many repos to
fewer to one a few reorgs through already).

Again, I'm planning to take this project open source in less then a couple
months. I haven't yet seen any of this referenced in Mr. Fogel's
"Producing Open Source Software" book (eg,
<http://producingoss.com/html-chunk/vc.html>), so I though it best to ask here.

I may be posting similar notes to the Doxygen and LXR communities if I can
find time.

-Matt

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Sun Feb 19 02:05:11 2006

This is an archived mail posted to the Subversion Users mailing list.