From owner-freebsd-doc Fri Dec 4 08:11:35 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id IAA17498 for freebsd-doc-outgoing; Fri, 4 Dec 1998 08:11:35 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from pluto.plutotech.com (mail.plutotech.com [206.168.67.137]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id IAA17493 for ; Fri, 4 Dec 1998 08:11:32 -0800 (PST) (envelope-from kelly@plutotech.com) Received: from plutotech.com (tampopo.plutotech.com [206.168.67.161]) by pluto.plutotech.com (8.9.1/8.9.1) with ESMTP id JAA24009; Fri, 4 Dec 1998 09:11:09 -0700 (MST) (envelope-from kelly@plutotech.com) Message-ID: <3668099C.E9A94706@plutotech.com> Date: Fri, 04 Dec 1998 09:11:08 -0700 From: Sean Kelly Organization: Pluto Technologies X-Mailer: Mozilla 4.04 [en] (X11; I; FreeBSD 3.0-CURRENT i386) MIME-Version: 1.0 To: Kris Kirby CC: freebsd-doc@FreeBSD.ORG Subject: Re: Learning SGML for docs? References: <3667A4AB.9093BB17@airnet.net> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > After looking around I am considering psychiatric care because I _must_ > be crazy to think about learning this monster (SGML). Yes, you are crazy. :-) To be pedantic, SGML itself isn't too bad. It's the various Document Type Definitions (DTDs) that are defined using SGML that are monstrous, such as the huge, perhaps untamable, but enormously powerful Docbook. > Anyway, my > question is: What items do I specifically need to write acceptable SGML > docs? I would assume a text editor, but if there is a port running > around that makes life just a tad bit simpler. Easy: the One True Editor: GNU Emacs . Seriously, Emacs's PSGML mode and font highlighting does make the task more approachable. Even Justin Gibbs, a staunch vi'er, admitted to me that he fires up Emacs whenever he has to write documentation in Docbook. > Being SGML, I'm going to > assume that there is some master list of all the possible (applicable?) > tags. You mean Docbook, not SGML. (Yes, I'm definitely in pedantic mode today.) > I'd kinda like to know where I could get an electronic copy. For an excellent introduction, including mention of the various tools, see Nik Clayton's Docbook Primer: http://www.freebsd.org/~nik/primer/index.html --Sean To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message