[Mono-docs-list] RE: Organizing docs, DocBook?

Norman Lorrain normanlorrain@telusplanet.net
Thu, 19 Dec 2002 23:00:52 -0700


Felix,

I'm trying Borges now, but it's geared towards Linux, which causes
problems for me (mainly in the structure of the makefiles, even using
GNU/make).  Perhaps we can adapt it, I'm sure Mono has addressed this
problem for their makefiles.

Perhaps we can address this later.  Better to get started on this.  I
might try to get a Linux box working over Christmas.

The raw tools (OpenJade, etc.) are definitely cross-platform, it's the
extra stuff (document tracking, work-in-progress) that might be
questionable.

I still think Docbook is a good idea.




> -----Original Message-----
> From: mono-docs-list-admin@ximian.com [mailto:mono-docs-list-
> admin@ximian.com] On Behalf Of Felix Faassen
> Sent: December 19, 2002 8:13 PM
> To: Mono Docs List
> Cc: Norman Lorrain
> Subject: [Mono-docs-list] RE: Organizing docs, DocBook?
> 
> Hi Norman,
> 
> How's it going with your framework? Can't wait to see more.
> 
> I came by a Docbook publishing system also. It's called Borges, which
is
> the framework which has been created by Mandrake and it's used for the
> creation
> of the mandrake docs. It supports a multilangual and modulair setup.
> When you create a new project it can be copied into a CVS repository
and
> everybody can start working on different parts.
> 
> I had it up and running in 10 minutes
> 
> More about it on  http://linux-mandrake.com/en/doc/project/Borges/
> 
> 
> Good luck!
> 
> Felix
> 
> 
> On Wed, 2002-12-18 at 21:54, Norman Lorrain wrote:
> > This page is from the FreeBSD project (they use docbook)
> > http://www.freebsd.org/docproj/sgml.html
> >
> > They have an excellent primer here:
> >
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/index.html
> >
> > I happen to use FreeBSD here; I'll try to set up a skeleton project
and
> > see how tough it can be.  When it's up I'll post a link.
> >
> >
> > I'd also be happy to convert the Gnome.net tutorial, if that's what
we
> > decide.
> >
> >
> >
> > ---
> > Outgoing mail is certified Virus Free.
> > Checked by AVG anti-virus system (http://www.grisoft.com).
> > Version: 6.0.427 / Virus Database: 240 - Release Date: 12/06/02
> >
> >
> >
> 
> 
> 
> _______________________________________________
> Mono-docs-list maillist  -  Mono-docs-list@ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-docs-list
> 
> ---
> Incoming mail is certified Virus Free.
> Checked by AVG anti-virus system (http://www.grisoft.com).
> Version: 6.0.427 / Virus Database: 240 - Release Date: 12/06/02
> 

---
Outgoing mail is certified Virus Free.
Checked by AVG anti-virus system (http://www.grisoft.com).
Version: 6.0.427 / Virus Database: 240 - Release Date: 12/06/02