Forum OpenACS Development: Is the documentation in CVS?

Posted by Pascal Scheffers on 03/28/01 03:37 PM

The ACS documentation is part of the openacs-4 CVS repository. Is
there a similar facility for the OpenACS installation documentation?
I could not find it... It would seem appropriate to me.

Roberto, should we all start using DocBook for the documentation as
you are doing with the install docs? If so, I would find it mighty
convenient if you were to publish the xml or sgml sources somewhere.
That would make copy-catting you that much simpler for me.

2: Response to Is the documentation in CVS? (response to 1)

Posted by Roberto Mello on 03/28/01 05:03 PM

The SGML/xml (whatever extension you want to use. right now it's
.sgml) sources are on the SourceForge repository, where they have
always been.

I haven't done anything with the documentation for OpenACS 4 yet,
because a) the kernel wasn't ported, b) only Ben, Don and Dan have
commit access to the openacs-4 tree for now.

3: Response to Is the documentation in CVS? (response to 1)

Posted by Pascal Scheffers on 03/28/01 10:13 PM

Durn. I can't find the sgml sources on source forge and a 'find *sgml'
on my local copy doesn't find anything either. I could only find the
htmls in acs3-pg/www/doc/openacs... help me.

Is there a map with the of where all the sources are? The 'what you
need to run...' section only contains the download locations, not
their CVS locations.

4: Response to Is the documentation in CVS? (response to 1)

Posted by Roberto Mello on 03/29/01 12:32 AM

Ops! Sorry Pascal. I thought I had committed the source .sgml files but it looks like I didn't. I must have had a brain short-circuit.

Anyhow, I just commited the source files, with an accompanying small README for your reading pleasure :)

Disclaimer: I am no DocBook expert, so if you find a better way to do these things, please let me know.

5: Response to Is the documentation in CVS? (response to 1)

Posted by Don Baccus on 03/29/01 12:43 AM

We need to get the documentation moved over to the openacs box, along with the driver, that's for sure ...

6: Response to Is the documentation in CVS? (response to 1)

Posted by Pascal Scheffers on 03/29/01 10:14 AM

Roberto,

thanks for the sgml sources. I will look into it and change the 'PG 7.0.3 & 7.1 on the same box' guide to docbook format. I'll keep the same conventions you've been using, for now.

Don, shouldn't the driver be part of the OpenNSD project?

7: Response to Is the documentation in CVS? (response to 1)

Posted by Don Baccus on 03/29/01 02:43 PM

OpenNSD's the logical place for the driver once the CVS tree is up and
running properly, but I'll want to keep an up-to-date copy for
downloading here as well.