From owner-freebsd-chat Wed Nov 4 23:25:45 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id XAA27184 for freebsd-chat-outgoing; Wed, 4 Nov 1998 23:25:45 -0800 (PST) (envelope-from owner-freebsd-chat@FreeBSD.ORG) Received: from dingo.cdrom.com (castles186.castles.com [208.214.165.186]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id XAA27173 for ; Wed, 4 Nov 1998 23:25:40 -0800 (PST) (envelope-from mike@dingo.cdrom.com) Received: from dingo.cdrom.com (LOCALHOST [127.0.0.1]) by dingo.cdrom.com (8.9.1/8.8.8) with ESMTP id XAA00456; Wed, 4 Nov 1998 23:24:59 -0800 (PST) (envelope-from mike@dingo.cdrom.com) Message-Id: <199811050724.XAA00456@dingo.cdrom.com> X-Mailer: exmh version 2.0.2 2/24/98 To: "Jason C. Wells" cc: FreeBSD-chat Subject: Re: Why SGML for docs? In-reply-to: Your message of "Wed, 04 Nov 1998 22:45:45 PST." Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Date: Wed, 04 Nov 1998 23:24:58 -0800 From: Mike Smith Sender: owner-freebsd-chat@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > I have seen that FreeBSD makes calls for SGML documentation. I know HTML > and it is easy and pretty powerful with HTML 4.0 and CSS. > > I took a peek and SGML and my hair turned white. My brief look at SGML led > me to think HTML is pretty good. I don't need to look at SGML. I am happy > with this small subset. > > What makes SGML useful for docs? Is it conversion tools for different > formats? Is it the power? It's the fact that no other toolset exists that's up to the job. > I guess the short question would be, "Why should I learn SGML?" You don't want to learn SGML unless you want to hack the doc tools. You want to learn the DTD that we're using (DocBook, the same one that ORA use for many of their books). Consider the relative merits of learning how to drive a car vs. how to make one from scratch from a pile of rusting sardine tins. The latter may make a driver out of you, and it'll teach you a lot about how the car goes together, but if all you want to do is go from A to B ... -- \\ Sometimes you're ahead, \\ Mike Smith \\ sometimes you're behind. \\ mike@smith.net.au \\ The race is long, and in the \\ msmith@freebsd.org \\ end it's only with yourself. \\ msmith@cdrom.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-chat" in the body of the message