From owner-freebsd-doc Tue Jun 4 19:02:10 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.5/8.7.3) id TAA02193 for doc-outgoing; Tue, 4 Jun 1996 19:02:10 -0700 (PDT) Received: from time.cdrom.com (time.cdrom.com [204.216.27.226]) by freefall.freebsd.org (8.7.5/8.7.3) with ESMTP id TAA02184 for ; Tue, 4 Jun 1996 19:02:04 -0700 (PDT) Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.7.5/8.6.9) with SMTP id SAA07008; Tue, 4 Jun 1996 18:58:27 -0700 (PDT) To: Chuck Robey cc: FreeBSD-doc@FreeBSD.org Subject: Re: Linuxdoc In-reply-to: Your message of "Tue, 04 Jun 1996 21:40:23 EDT." Date: Tue, 04 Jun 1996 18:58:27 -0700 Message-ID: <7005.833939907@time.cdrom.com> From: "Jordan K. Hubbard" Sender: owner-doc@FreeBSD.org X-Loop: FreeBSD.org Precedence: bulk > I sent this to John Fieber, then I realized I should have let the list in > on it. I was noting that the idea of making an intermediate language > like linuxdoc is a good one, the only bad part (for me) is the specific > choice of linuxdoc. The reasons that I can't use it are (1) I've never > been able to undersatnd sgml all that well, and (2) linuxdoc seems to be > undocumented. My understanding is that linuxdoc is just a DTD, and poorly documented or not only one part of our SGML environment. The choice of SGML itself seems to be a non-issue. Everyone from Sun to HP to DEC (I live with a tech writer who's a docs project manager for Sun and worked everywhere else before that) is moving to SGML and some DTD, O'Reilly and associates has all of its authors writing in SGML using their own DTD (which they'll provide to anyone for free, BTW) and the world in general is just moving away from groff and TeX. So we're on the right train, let's not let the color of the upholstery motivate us into switching back to the more familiar yet outmoded horse and buggy. :-) Jordan