From owner-freebsd-hackers Tue May 22 5:44:17 2001 Delivered-To: freebsd-hackers@freebsd.org Received: from mail.webmonster.de (datasink.webmonster.de [194.162.162.209]) by hub.freebsd.org (Postfix) with SMTP id 340DB37B424 for ; Tue, 22 May 2001 05:44:10 -0700 (PDT) (envelope-from karsten@rohrbach.de) Received: (qmail 93609 invoked by uid 1000); 22 May 2001 12:44:30 -0000 Date: Tue, 22 May 2001 14:44:30 +0200 From: "Karsten W. Rohrbach" To: freebsd-hackers@freebsd.org Cc: freebsd-doc@freebsd.org Subject: what is a good toolkit for multitarget documentation? Message-ID: <20010522144430.Q88529@mail.webmonster.de> Mail-Followup-To: "Karsten W. Rohrbach" , freebsd-hackers@freebsd.org, freebsd-doc@freebsd.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i X-Arbitrary-Number-Of-The-Day: 42 X-URL: http://www.webmonster.de/ X-Disclaimer: My opinions do not necessarily represent those of my employer Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG hey folks, i am currently evaluating different styles of implementing documentation for some multiplatform software stuff. first i though about html only docs, but this is not sufficient. then i thought about tex docs but this wont work out either. the idea is to have a single 'master repo' style document tree that can be used to dump out - html all-in-one-file and chapters - tex for pretty printing and pdf output - man pages - README, CHANGES and auxiliary documentation text files is sgml/docbook the way to go? i've seen that the freebsd handbook and other documents obviously are written using the docbook dtd, but i cannot find any pointers what software are involved in creating readable documents. i actually found a short editor/opensp/jadetex/tex howto but this would just replace the main functionality of latex, and that's not what i want. i guess my tex speaking skills are better than sgml ;-) as this seems to be arbitrary complicated, depending on the parsers and filters used, is there a) a simpler way of doing this? b) a recommended, standard, way? another question is, if it is possible to 'fold' certain paragraphs or whole chapters based on the assumption that we generate one handbook for beginners and a slightly different one for advanced users and one with source code snippets -- or even whole source files with annotations -- for developers. thx in advance! cheers, /k -- > Worry is interest paid before a debt is due. KR433/KR11-RIPE -- WebMonster Community Founder -- nGENn GmbH Senior Techie http://www.webmonster.de/ -- ftp://ftp.webmonster.de/ -- http://www.ngenn.net/ karsten&rohrbach.de -- alpha&ngenn.net -- alpha&scene.org -- catch@spam.de GnuPG 0x2964BF46 2001-03-15 42F9 9FFF 50D4 2F38 DBEE DF22 3340 4F4E 2964 BF46 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message