[Gtkradiant] Doxygen for the plugins

Timothee Besset gtkradiant@zerowing.idsoftware.com
Thu, 29 Nov 2001 09:21:04 +0100


You're right, it's easier to add the plugins/ directory directly to the
default generation. If we end up with 7-8 doxygen generations per branch
(core+plugins each time) it's not gonna be very easy to navigate.

TTimo

On Thu, 29 Nov 2001 18:52:26 +1100
Geoff Davis <gefdavis@dingoblue.net.au> wrote:

> The current script accepts targets & output directories on the command line,
> of they are omitted, then the default radiant/ include/ and libs/ is generated.
> So it would just be a matter of watching for commits in the plugins (?) and
> calling a second gendox with the command line plugins/ -o ../plugins or similar.
> 
> Although considering the amount of stuff thats being moved to plugins it
> would probably be a good option to add plugins/ to the default without
> adding too much to the total generation time. Since most of what is in
> the plugins dir, came out of radiant/ anyway.
> 
> Let me know which way you want to go and I'll submit a patch for it.
> 
> Gef :]
> 
> On Wed, 28 Nov 2001 16:25:31 +0100
> Timothee Besset <timo@qeradiant.com> wrote:
> 
> > I'm thinking that we would need to generate doxygen documentation for the
> > plugins too. For now we generate by scanning in libs/ include/ and
> > radiant/
> > 
> > I don't know what we should do about the plugins: in theory we could
> > generate with libs/ include/ plguins/modulename/ only, in a seperate area
> > (since the core and the modules are all independant pieces). But maybe
> > it's is more simple to just add plugins/ to the doxygen scan .. depends
> > how difficult it is to write a fully clean solution? Gef?
> > 
> > Another reason why I'd rather avoid adding plugins/ to the main doxygen
> > generation .. is that it already takes around 400 seconds on zerowing to
> > rebuild the doc each time there's a commit.
> > 
> > TTimo
> > 
> > On Wed, 28 Nov 2001 09:15:28 -0600
> > Timothee Besset <timo@zerowing.idsoftware.com> wrote:
> > 
> > > User   : timo
> > > Branch : md3-module
> > > Root   : zerowing:/cvs
> > > Date   : 2001/11/28  09:15:19
> > > 
> > > Linux fix
> > > 
> > > --
> > > 
> > >   GtkRadiant/docs/developer/CHANGES
> > >     1.174.2.6 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/docs/developer/CHANGES?rev=1.174.2.6
> > >     diff :
> > >       This is the changelog for developpers, != changelog for the end user 
> > >       that we distribute with the binaries. (see changelog)
> > >       
> > >     + 28/11/2001
> > >     +   TTimo - md3-module branch
> > >     +   - updated linux build
> > >     +   - fixed CEntityMiscModel and CEntityEclassModel destructors
> > >     +     (any destructor should be virtual)
> > >     + 
> > >       27/11/2001
> > >         Spog - md3-module branch
> > >         - stopped texturewindow showing shaders without the "textures/" path
> > > 
> > > 5 files modified :
> > > 
> > >   GtkRadiant/docs/developer/CHANGES
> > >     1.174.2.6 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/docs/developer/CHANGES?rev=1.174.2.6
> > >     1.174.2.5 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/docs/developer/CHANGES?rev=1.174.2.5
> > >     diff : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/docs/developer/CHANGES.diff?r1=text&tr1=1.174.2.5&r2=text&tr2=1.174.2.6&f=h
> > > 
> > >   GtkRadiant/plugins/md3model/Conscript
> > >     1.1.6.3 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/plugins/md3model/Conscript?rev=1.1.6.3
> > >     1.1.6.2 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/plugins/md3model/Conscript?rev=1.1.6.2
> > >     diff : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/plugins/md3model/Conscript.diff?r1=text&tr1=1.1.6.2&r2=text&tr2=1.1.6.3&f=h
> > > 
> > >   GtkRadiant/plugins/md3model/entitymodel.h
> > >     1.1.2.6 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/plugins/md3model/entitymodel.h?rev=1.1.2.6
> > >     1.1.2.5 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/plugins/md3model/entitymodel.h?rev=1.1.2.5
> > >     diff : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/plugins/md3model/entitymodel.h.diff?r1=text&tr1=1.1.2.5&r2=text&tr2=1.1.2.6&f=h
> > > 
> > >   GtkRadiant/vslick/Radiant.vpw
> > >     1.23.4.3 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/vslick/Radiant.vpw?rev=1.23.4.3
> > >     1.23.4.2 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/vslick/Radiant.vpw?rev=1.23.4.2
> > >     diff : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/vslick/Radiant.vpw.diff?r1=text&tr1=1.23.4.2&r2=text&tr2=1.23.4.3&f=h
> > > 
> > >   GtkRadiant/vslick/md3model.vpj
> > >     1.1.2.2 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/vslick/md3model.vpj?rev=1.1.2.2
> > >     1.1.2.1 : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/vslick/md3model.vpj?rev=1.1.2.1
> > >     diff : http://zerowing.idsoftware.com/viewcvs/viewcvs.cgi/GtkRadiant/vslick/md3model.vpj.diff?r1=text&tr1=1.1.2.1&r2=text&tr2=1.1.2.2&f=h
> > > 
> > > 
> > 
> > _______________________________________________
> > Gtkradiant mailing list
> > Gtkradiant@zerowing.idsoftware.com
> > http://zerowing.idsoftware.com/mailman/listinfo/gtkradiant
> 
> 
> --
> On SECOND thought, maybe I'll heat up some BAKED BEANS and watch REGIS
> PHILBIN ...  It's GREAT to be ALIVE!!
> 
> _______________________________________________
> Gtkradiant mailing list
> Gtkradiant@zerowing.idsoftware.com
> http://zerowing.idsoftware.com/mailman/listinfo/gtkradiant