Return-Path: owner-linux-activists@joker.cs.hut.fi Received: from joker.cs.hut.fi (root@joker.cs.hut.fi [130.233.40.32]) by keos.Helsinki.FI (8.6.4/H45) with SMTP id IAA19442 for ; Tue, 8 Feb 1994 08:52:07 +0200 Received: from joker.cs.hut.fi by niksula.hut.fi id <50394-2>; Tue, 8 Feb 1994 08:50:19 +0200 From: "Linux Activists" To: "Linux-Activists" Reply-To: "Linux-Activists" X-Note1: Remember to put 'X-Mn-Key: DOC' to your mail body or header Subject: Linux-Activists - DOC Channel digest. 94-1-8-5:5 X-Mn-Key: DOC Sender: owner-linux-activists@joker.cs.hut.fi Message-Id: <94Feb8.085019eet.50394-2@niksula.hut.fi> Date: Tue, 8 Feb 1994 08:50:11 +0200 Status: RO X-Status: Topics: Re: LDP documentation and the FSF Re: LDP documentation and the FSF ---------------------------------------------------------------------- From: Lars Wirzenius Subject: Re: LDP documentation and the FSF Date: Mon, 7 Feb 1994 23:49:26 +0200 A few unstructured opinions: 1. Co-operating with the FSF is a good thing. 2. Using Texinfo is not an option, at least for me: very awkward markup notation, lousy hardcopy. (Automatic conversion to Texinfo I have nothing against, of course.) 3. Using SGML, HTML, or some other notation is not an option for me either, at this time: I have no tools, and no time to install or learn such. However, experimenting with other formats is a good thing, and after others have done it, I'll be happy to follow. (I still say the same thing I've said for a long time: the hard part is getting the stuff written, converting to other formats is easy in comparison.) 3a. My primary goal is writing a book; on-line documentation is a secondary goal. I won't mind if people want to view it on-line, but hardcopy is what I'm striving at. I'll think about on-line docs when the time comes. 4. Broadening the scope of the LDP docs: a good idea. I'll try to do that gradually with the SAG. 5. I've seen parts of this discussion mailed directly to me, parts in DOC, WORD, and NORMAL. Perhaps keeping it to DOC would be the most logical thing? 6. _Don't_ ask me when version ALPHA-2 of the SAG will come out. But it will hopefully come out before Linux 1.0. -- Lars.Wirzenius@helsinki.fi (finger wirzeniu@klaava.helsinki.fi) Humans are unreliable, computers are non-deterministically reliable. ------------------------------ From: mdw@cs.cornell.edu (Matt Welsh) Subject: Re: LDP documentation and the FSF Date: Mon, 7 Feb 1994 23:54:24 +0200 Lars Wirzenius writes: > 2. Using Texinfo is not an option, at least for me: very awkward markup > notation, lousy hardcopy. (Automatic conversion to Texinfo I have > nothing against, of course.) I agree. I'd like to be able to convert to texinfo, so that the GNU folks can use it, but I don't think that using texinfo as the base language is the best idea. > 3. Using SGML, HTML, or some other notation is not an option for me > either, at this time: I have no tools, and no time to install or > learn such. However, experimenting with other formats is a good thing, > and after others have done it, I'll be happy to follow. I'm going to start looking at SGML. Once I have it all worked out, I can write up a short tutorial (it looks quite easy), even get a Linux binary distribution of the software you'll need. It looks like the HOWTOs are going to move to SGML, so that will be my guinea pig. :) > 3a. My primary goal is writing a book; on-line documentation is a > secondary goal. Same here. ------------------------------ End of DOC Digest ***************** ------- .