Hi Allen,
On Sat, 2006-08-26 at 08:55 -0500, Allen Bierbaum wrote:
>
> I think referring to glBlendFunc is fine. It would be really great if
> it was a link that went to some online docs. :)
That should be doable. ;)
> I am not suggesting you give SVN write access to everyone. What I am
> suggesting is that if a user or part-time developer comes to you and
> says "I would like to help out with documentation, here is a sample",
> then we let them have svn access to help out. Initially it will
> probably be somewhat probationary but still, if someone wants to help it
> seems to me like we should let them.
>
> One of the other reasons I think this is a good idea is that, at least
> from my experience, I am much more likely to contribute documentation
> and other "small" changes to a project if I have commit access. Making
> a patch and submitting it may sound very simple (and it is), but it does
> take more time and effort then a simple "svn commit".
Hm, ok. Under these circumstances I could live with it. Gerrit?
> Not if he has mowed the lawn before and I have cameras all over the
> house watching him and if he does anything bad I can roll back the state
> of my house. :)
Yeah, the roll back is a little easier for svn than a house. Anybody up
for writing a version control for houses? I'd love to roll back to
"floor empty and books sorted". ;)
> >How do you do that? Can you include other pages into a united page?
> >
> >
> I think so.
Not yet, I think. So far you can only do single pages, but there seems
to be some development on this plugin. But currently I'm moving away
from that anyway, see my other mail.
> >>Examples, look into the doxygen example support. May just want to
> >>document the examples source code using doxygen and then include those
> >>examples into the documentation so they can link into the reference guide.
> >
> >Link into the ref guide or links to them from the ref guide?
> >
> Links from the reference API to a possibly included page that has the
> source of the example. I think doxygen supports this.
In a very simple manner (or a very painful one ;). For that to be useful
we should probably add an even higher level than the SSM, to make the
example code really minimal.
> If only doxygen were multi-threaded. :)
I spent some time on the weekend looking into that. Profiling doxygen
turned out to be a bigger problem than expected (valgrind segfaults...),
and looking at the code: making that MT-safe is going to be harder than
expected. Pretty much none of the classes can be copied, and there are
quite a lot of global variables. :(
> Related to this, I think we should setup a mailing list for
> notifications of all ticket adds and changes. That would be much easier
> then visiting the tickets everyday. :)
Does Trac support that? I couldn't find anything. There is a patch to
notify the owner, but how do you add a CC: to every ticket?
> See WikiInclude: http://trac.edgewall.org/wiki/MacroBazaar
Not sure how that helps.
> See PageToPdfPlugin: http://trac-hacks.org/wiki/PageToPdfPlugin
That's just for a single page, though.
Yours
Dirk
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Opensg-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/opensg-users
