Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 3 Jul 2002 15:39:58 -0400
From:      Dylan Carlson <absinthe@pobox.com>
To:        Andrew Boothman <andrew@cream.org>
Cc:        K.J.Koster@kpn.com, inonit@inonit.com, freebsd-java@FreeBSD.ORG
Subject:   Re: Docs and bug reporting (was: A Call to Action)
Message-ID:  <200207031539.58702.absinthe@pobox.com>
In-Reply-To: <3D233A50.5020900@cream.org>
References:  <59063B5B4D98D311BC0D0001FA7E452205FDA7EE@l04.research.kpn.com> <200206280801.17849.absinthe@pobox.com> <3D233A50.5020900@cream.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Wednesday 03 July 2002 01:54pm, Andrew Boothman wrote:
>
> I have (some) experience at writing DocBook for the FDP, and have the
> FDPs toolchain running successfully for testing local changes to FreeBSD
> docs.
>
> Did you reach any conclusions over what/how you want to move into the FDP?
>

Hi Andrew,

Congrats getting the tools set up, that's a minor miracle in itself.   I've 
had problems with jade and sgmltools bailing out because of catalog problems 
(even though I'm pretty sure I have fixed the catalog).  

The 'docproj' port does anything but work out-of-the-box.  :)

Currently I am getting the docs for JDK 1.3.1 started up based on the source 
material I have right now (KJ's docs, the mailing list, PRs, Greg's website).  
Initial form is plaintext, using a structure as close to the Handbook as I 
can get it.   These should have be done by Sunday.  Once finished, they will 
go out to the team for review.   

It's going to be a while before I grep DocBook fully.  I need a mentor on the 
FDP for long-term reasons, not just related to Java.  There are no plans for 
me to be "The Man" for java docs.   I'm hoping to contribute enough to bring 
us up to date, get the docs pushed into the FDP, then see where that leads 
us.  

You can give me some pointers on how the doc needs to be improved for the FDP, 
and do the final DocBook markup on it.  

Cheers,
-- 
Dylan Carlson [absinthe@pobox.com]

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-java" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200207031539.58702.absinthe>