From owner-freebsd-doc Sat Aug 17 13: 7:24 2002 Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E057937B400 for ; Sat, 17 Aug 2002 13:07:19 -0700 (PDT) Received: from flamingo.mail.pas.earthlink.net (flamingo.mail.pas.earthlink.net [207.217.120.232]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8A42843E77 for ; Sat, 17 Aug 2002 13:07:19 -0700 (PDT) (envelope-from absinthe@pobox.com) Received: from dhcp068-64-151-24.nt01-c4.cpe.charter-ne.com ([24.151.64.68] helo=laredo.retrovertigo.com) by flamingo.mail.pas.earthlink.net with esmtp (Exim 3.33 #1) id 17g9qm-0003y9-00 for freebsd-doc@freebsd.org; Sat, 17 Aug 2002 13:07:09 -0700 Content-Type: text/plain; charset="iso-8859-1" From: Dylan Carlson Reply-To: absinthe@pobox.com Subject: Fwd: Please review: new Java Project docs Date: Sat, 17 Aug 2002 16:07:12 -0400 User-Agent: KMail/1.4.2 To: freebsd-doc@freebsd.org MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Message-Id: <200208171607.12234.absinthe@pobox.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Hello, I'm new to DocBook/FDP and I've put together pages to replace the ones at http://www.freebsd.org/java/, which have not been updated in a while. It would be nice to have anyone review the pages (details are attached below). The only problems I have had in transforming to HTML thus far are: 1. &man.command.section doesn't build links, it just builds plaintext. Here is what I have set in book.sgml: %man; ... ]> 2. I haven't figured out how to include a footer with a "Last modified" date/time stamp based on the source .sgml mtime. 3. I couldn't get tags to work with id's set inside of . 4. There were a few places I would have liked to insert a
on the output. It looks that DocBook doesn't support this, however I am curious if there are solutions. 5. numbers and bullets format strange on Konqueror browsers (the number/bullet is shifted up slightly from the ) ... otherwise everything else on Konqueror looks better vs. Mozilla 1.0. 6. I wanted some more control over how get laid out. I wanted to have 's build as separate pages with indexes of and 's nested underneath but was unsure how to do this ... so I was forced to flatten the document structure out at whenever possible. As an aside, I used JEdit 4.0 [ /usr/ports/editors/jedit ] to build these pages and did so rather easily. I would recommend this editor for anyone who has not tried it. Appreciate your help. Thanks, ---------- Forwarded Message ---------- Subject: Please review: new Java Project docs Date: Sat, 17 Aug 2002 09:58:14 -0400 From: Dylan Carlson To: freebsd-java@FreeBSD.ORG Hello, I have finished a 1st-pass at rewriting the FreeBSD Java Project documentation into DocBook/SGML source format. I have transformed the preview version into HTML. I would like volunteers to do basic fact-checking and give me their opinions on where the docs can use improvement. Specifically, contributions are needed in the following areas, in order of importance: 1. Adding items to the FAQ (I know I missed some). 2. Filling out the "Known Issues" portion of the Release Info sections ... I know there are open issues currently. 3. Authors for the following articles: 3a. Basics of setting up a Java environment 3b. Basics of running and troubleshooting Java applications 3c. Benchmarks (ones that we can legally publish) 4. Artists needed for a logo and other decorations. Primarily, it would be nice to have a Project logo for the index page. Probably nothing bigger than 300 x 300, royalty-free. Vector graphics need to be in EPS format, and bitmaps in PNG. [ http://home.earthlink.net/~dylancarlson/projects/freebsd/javadoc/ ] Looking forward to your feedback. Cheers, -- Dylan Carlson [absinthe@pobox.com] To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message ------------------------------------------------------- -- Dylan Carlson [absinthe@pobox.com] To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message