From owner-freebsd-doc Sat Jun 16 14:35:18 2001 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (pc-62-31-42-140-hy.blueyonder.co.uk [62.31.42.140]) by hub.freebsd.org (Postfix) with ESMTP id E5FD237B415 for ; Sat, 16 Jun 2001 14:35:00 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: from clan.nothing-going-on.org (localhost [127.0.0.1]) by nothing-going-on.demon.co.uk (8.11.3/8.11.3) with SMTP id f5GLBx616080; Sat, 16 Jun 2001 22:11:59 +0100 (BST) (envelope-from nik@nothing-going-on.demon.co.uk) Content-Type: text/plain; charset="iso-8859-1" From: Nik Clayton To: "G. Adam Stanislav" , doc@freebsd.org Subject: Re: Writing man pages in sgml Date: Sat, 16 Jun 2001 22:11:58 +0100 X-Mailer: KMail [version 1.2] References: <3.0.6.32.20010616153509.00a9d9a0@mail85.pair.com> In-Reply-To: <3.0.6.32.20010616153509.00a9d9a0@mail85.pair.com> MIME-Version: 1.0 Message-Id: <01061622115811.01838@clan.nothing-going-on.org> Content-Transfer-Encoding: 8bit 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 -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Saturday 16 June 2001 9:35 pm, G. Adam Stanislav wrote: > I seem to recall someone once saying somewhere (possibly here) that > the DocBook sgml could be converted into a man page. If that is the > case, could someone please tell me how (and perhaps direct me to a > sample sgml for the creation of manpages)? There are a number of tools that can do this. Sun have already done this with Solaris, and they based it on dtm, available at http://www.oasis-open.org/docbook/tools/dtm/ This has also come up on the -doc list before. A search for the thread with the subject man, TOC, xml... should be instructive. What we call man pages, DocBook calls "RefEntry"s. You can see some examples at http://www.docbook.org/tdg/html/refentry.html Finally, I was having a chat with Ruslan (ru@FreeBSD.org) about this yesterday, and he's also interested in working on it. It would be a good idea to talk with him as well. N - -- FreeBSD: The Power to Serve http://www.freebsd.org/ FreeBSD Documentation Project http://www.freebsd.org/docproj/ --- 15B8 3FFC DDB4 34B0 AA5F 94B7 93A8 0764 2C37 E375 --- -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjsry58ACgkQk6gHZCw343XhlgCfVfeaMP9Pn8tSs7eMvwoBQzbD v2sAn2lD6ysXNmqFGTOYcgKlVfBob1WN =JnBv -----END PGP SIGNATURE----- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message