From owner-freebsd-doc Mon Aug 28 03:28:49 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id DAA20270 for doc-outgoing; Mon, 28 Aug 1995 03:28:49 -0700 Received: from time.cdrom.com (time.cdrom.com [192.216.222.226]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id DAA20241 ; Mon, 28 Aug 1995 03:28:41 -0700 Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.6.12/8.6.9) with SMTP id DAA02874; Mon, 28 Aug 1995 03:28:38 -0700 To: doc@freebsd.org cc: hackers@freebsd.org Subject: Argh. I think we need to do a quick reality-check on our docs.. Date: Mon, 28 Aug 1995 03:28:38 -0700 Message-ID: <2872.809605718@time.cdrom.com> From: "Jordan K. Hubbard" Sender: doc-owner@freebsd.org Precedence: bulk I was responding to a user's message on the net today and he was having some trouble with the 3C509 ethernet card. "Aha!" says I. "I remember seeing something about this somewhere from Rod and it's in the docs, so I'll just point him at it!" Famous last words. I couldn't _find_ the bleedin' reference! After searching through the handbook and the FAQ, I came to two very quick conclusions: 1. There is a lot of redundancy between the two. 2. We really really need a permuted index!! If it's this much trouble for _me_ to find things, and I'm supposed to sort of know the lay of the land here, just imagine how hard it is for the poor user! I don't mean to sound like I'm whining, but this is a real problem and I'm coming to rely more and more heavily on the docs as the 2.1 install comes closer. Most people probably don't know that the 2.1 installation will have Lynx on the boot floppy and use it for browsing ALL the doc! This means that what's on the floppy will no longer be something that comes out of /usr/src/release/sysinstall/help/..., it will be a subset of the handbook itself! This was necessary due to the fact that much of sysinstall/help/* wound up migrating straight into the handbook and there's just no sense in maintaining two versions. We also need to bring the foreign-language versions over so that all that work isn't lost, and I daresay that John Fieber could use some help here! I hate to make this "help us with the docs, please!" plea so often in -hackers, but the docs really are becoming a significant keystone in how FreeBSD is presented, from install time onwards, and we ALL need to start taking them much more seriously! I think that this is a good thing since the docs will never really mature and grow without some "serious mission in life" like providing the initial install documentation, but putting this degree of pressure on them also has its price. Could I get some volunteers for the following projects? 1. Fill in the *'d topics in the Handbook. Some people have told me that they'd like to help with the docs if they just knew what needed doing, and I'd say that John has made it pretty clear at a glance if you just take a look at http://www.freebsd.org/Handbook and see which items have asterisks next to them. If you take a `*'d item, please also send a note to doc@FreeBSD.org so that work isn't unnecessarity duplicated. Please don't take something you won't finish, since by "adopting" it you're also essentially dissuading anyone else from doing so! 2. Look at /usr/src/release/sysinstall/help/${LANG}/* and see if you can help John create a language-specific section for whichever language it is you're most interested in. This is not only helpful to the multi-lingual boot floppy work but also helps our effort to eventually have versions of the Handbook available in multiple languages! Wouldn't you like to see future versions of the handbook available in German, French, Spanish or Russian? In time I may even have WC talked into printing a version of the handbook as an inside booklet in the CD, and I see no reason why country-specific versions of the CD shouldn't be produced. If you can sell a few thousand, say, spanish editions of the CD then it more than pays for the I18N work. This makes the local spanish market pretty happy too, so everyone wins. However, whether or not we get all of these nifty things really sort of depends on us, and only us, for now. I personally am really enthusiastic about the prospect of all of this coming together, but I know that neither John nor I have sufficent time to do all the work necessary. I'd like to keep myself focused on the boot floppy end of things so that we have a reasonable chance of the whole idea _working_ in the install, and I think John would probably like to look at the design issues surrounding the handbook as a whole (and in particular, I'm going to need his help with the production of the boot floppy version of the handbook) so that keeps him pretty busy. So. anyway... In case you didn't feel like reading all of the above, it can also be summarized as: "Help! Help! Help! Fire in docs! People with big feet needed!" Jordan From owner-freebsd-doc Mon Aug 28 04:21:46 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id EAA24433 for doc-outgoing; Mon, 28 Aug 1995 04:21:46 -0700 Received: from gndrsh.aac.dev.com (gndrsh.aac.dev.com [198.145.92.241]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id EAA24411 ; Mon, 28 Aug 1995 04:21:42 -0700 Received: (from rgrimes@localhost) by gndrsh.aac.dev.com (8.6.11/8.6.9) id EAA00923; Mon, 28 Aug 1995 04:21:31 -0700 From: "Rodney W. Grimes" Message-Id: <199508281121.EAA00923@gndrsh.aac.dev.com> Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. To: jkh@time.cdrom.com (Jordan K. Hubbard) Date: Mon, 28 Aug 1995 04:21:31 -0700 (PDT) Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <2872.809605718@time.cdrom.com> from "Jordan K. Hubbard" at Aug 28, 95 03:28:38 am X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 855 Sender: doc-owner@freebsd.org Precedence: bulk > > I was responding to a user's message on the net today and he was > having some trouble with the 3C509 ethernet card. "Aha!" says I. "I > remember seeing something about this somewhere from Rod and it's in > the docs, so I'll just point him at it!" Not me, I don't know squat about 3Com products (other than there is a lot of that junk out there :-)). I'm a SMC/Compex shop... > > So. anyway... In case you didn't feel like reading all of the above, > it can also be summarized as: "Help! Help! Help! Fire in docs! > People with big feet needed!" oh, you want to borrow the Halon system to help with the fire :-) :-) Sorry, no big feet, just big sticks :-) :-).... > Jordan > -- Rod Grimes rgrimes@gndrsh.aac.dev.com Accurate Automation Company Reliable computers for FreeBSD From owner-freebsd-doc Mon Aug 28 04:47:44 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id EAA26309 for doc-outgoing; Mon, 28 Aug 1995 04:47:44 -0700 Received: from time.cdrom.com (time.cdrom.com [192.216.222.226]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id EAA26289 ; Mon, 28 Aug 1995 04:47:41 -0700 Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.6.12/8.6.9) with SMTP id EAA03378; Mon, 28 Aug 1995 04:47:31 -0700 To: "Rodney W. Grimes" cc: doc@freebsd.org, hackers@freebsd.org Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. In-reply-to: Your message of "Mon, 28 Aug 1995 04:21:31 PDT." <199508281121.EAA00923@gndrsh.aac.dev.com> Date: Mon, 28 Aug 1995 04:47:31 -0700 Message-ID: <3376.809610451@time.cdrom.com> From: "Jordan K. Hubbard" Sender: doc-owner@freebsd.org Precedence: bulk > Not me, I don't know squat about 3Com products (other than there is > a lot of that junk out there :-)). Argh! Well, it was *somebody* that knew all of this. Care to step forward with your contribution for the hardware section of the Handbook? Please?? :-) People are having problems with the 3COM cards and they need their own section. Jordan From owner-freebsd-doc Mon Aug 28 07:24:15 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id HAA04001 for doc-outgoing; Mon, 28 Aug 1995 07:24:15 -0700 Received: from irz301.inf.tu-dresden.de (irz301.inf.tu-dresden.de [141.76.1.11]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id HAA03933 ; Mon, 28 Aug 1995 07:23:19 -0700 Received: from sax.sax.de by irz301.inf.tu-dresden.de (8.6.12/8.6.12-s1) with ESMTP id QAA15400; Mon, 28 Aug 1995 16:22:08 +0200 Received: by sax.sax.de (8.6.11/8.6.12-s1) with UUCP id QAA13407; Mon, 28 Aug 1995 16:22:08 +0200 Received: (from j@localhost) by uriah.heep.sax.de (8.6.11/8.6.9) id PAA22021; Mon, 28 Aug 1995 15:59:32 +0200 From: J Wunsch Message-Id: <199508281359.PAA22021@uriah.heep.sax.de> Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. To: doc@freebsd.org, hackers@freebsd.org Date: Mon, 28 Aug 1995 15:59:30 +0200 (MET DST) Reply-To: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <2872.809605718@time.cdrom.com> from "Jordan K. Hubbard" at Aug 28, 95 03:28:38 am Reply-To: joerg_wunsch@uriah.heep.sax.de (Joerg Wunsch) X-Phone: +49-351-2012 669 X-Mailer: ELM [version 2.4 PL23] MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 8bit Content-Length: 528 Sender: doc-owner@freebsd.org Precedence: bulk As Jordan K. Hubbard wrote: > > 2. Look at /usr/src/release/sysinstall/help/${LANG}/* and see if you > can help John create a language-specific section for whichever > language it is you're most interested in. This is not only helpful I volunteer for German again, but due to the job change, i'm afraid i won't be able to spend that much time into the subject as previously. -- cheers, J"org joerg_wunsch@uriah.heep.sax.de -- http://www.sax.de/~joerg/ Never trust an operating system you don't have sources for. ;-) From owner-freebsd-doc Mon Aug 28 07:42:51 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id HAA05403 for doc-outgoing; Mon, 28 Aug 1995 07:42:51 -0700 Received: from localhost (localhost [127.0.0.1]) by freefall.FreeBSD.org (8.6.11/8.6.6) with SMTP id HAA05392 ; Mon, 28 Aug 1995 07:42:48 -0700 Message-Id: <199508281442.HAA05392@freefall.FreeBSD.org> X-Authentication-Warning: freefall.FreeBSD.org: Host localhost didn't use HELO protocol To: "Jordan K. Hubbard" cc: "Rodney W. Grimes" , doc@freebsd.org, hackers@freebsd.org Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. In-reply-to: Your message of "Mon, 28 Aug 95 04:47:31 PDT." <3376.809610451@time.cdrom.com> Date: Mon, 28 Aug 1995 07:42:47 -0700 From: "Justin T. Gibbs" Sender: doc-owner@freebsd.org Precedence: bulk >> Not me, I don't know squat about 3Com products (other than there is >> a lot of that junk out there :-)). > >Argh! Well, it was *somebody* that knew all of this. Care to step >forward with your contribution for the hardware section of the >Handbook? Please?? :-) People are having problems with the 3COM cards >and they need their own section. > > Jordan Talk to Serge Babkin. I belive we still have an outstanding patch from him for this driver as well. -- Justin T. Gibbs =========================================== Software Developer - Walnut Creek CDROM FreeBSD: Turning PCs into workstations =========================================== From owner-freebsd-doc Mon Aug 28 15:17:05 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id PAA02102 for doc-outgoing; Mon, 28 Aug 1995 15:17:05 -0700 Received: from cabri.obs-besancon.fr (cabri.obs-besancon.fr [193.52.184.3]) by freefall.FreeBSD.org (8.6.11/8.6.6) with SMTP id PAA02096 ; Mon, 28 Aug 1995 15:17:02 -0700 Received: by cabri.obs-besancon.fr (5.57/Ultrix3.0-C) id AA04038; Tue, 29 Aug 95 00:19:05 +0100 Date: Tue, 29 Aug 95 00:19:05 +0100 Message-Id: <9508282319.AA04038@cabri.obs-besancon.fr> From: Jean-Marc Zucconi To: jkh@time.cdrom.com Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <2872.809605718@time.cdrom.com> (jkh@time.cdrom.com) Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. X-Mailer: Emacs Sender: doc-owner@freebsd.org Precedence: bulk >>>>> Jordan K Hubbard writes: > 2. Look at /usr/src/release/sysinstall/help/${LANG}/* and see if you > can help John create a language-specific section for whichever > language it is you're most interested in. This is not only helpful > to the multi-lingual boot floppy work but also helps our effort to > eventually have versions of the Handbook available in multiple > languages! Wouldn't you like to see future versions of the > handbook available in German, French, Spanish or Russian? OK, I will continue the french translations!!! Jean-Marc _____________________________________________________________________________ Jean-Marc Zucconi Observatoire de Besancon F 25010 Besancon cedex PGP Key: finger jmz@cabri.obs-besancon.fr ============================================================================= From owner-freebsd-doc Mon Aug 28 18:51:59 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id SAA05253 for doc-outgoing; Mon, 28 Aug 1995 18:51:59 -0700 Received: from hq.icb.chel.su (icb-rich-gw.icb.chel.su [193.125.10.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id SAA05231 ; Mon, 28 Aug 1995 18:51:35 -0700 Received: from localhost (babkin@localhost) by hq.icb.chel.su (8.6.5/8.6.5) id HAA13655; Tue, 29 Aug 1995 07:52:07 +0600 From: "Serge A. Babkin" Message-Id: <199508290152.HAA13655@hq.icb.chel.su> Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. To: jkh@time.cdrom.com (Jordan K. Hubbard) Date: Tue, 29 Aug 1995 07:52:06 +0600 (GMT+0600) Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <2872.809605718@time.cdrom.com> from "Jordan K. Hubbard" at Aug 28, 95 03:28:38 am X-Mailer: ELM [version 2.4 PL23] Content-Type: text Content-Length: 764 Sender: doc-owner@freebsd.org Precedence: bulk > > Could I get some volunteers for the following projects? > > 2. Look at /usr/src/release/sysinstall/help/${LANG}/* and see if you > can help John create a language-specific section for whichever > language it is you're most interested in. This is not only helpful > to the multi-lingual boot floppy work but also helps our effort to > eventually have versions of the Handbook available in multiple > languages! Wouldn't you like to see future versions of the > handbook available in German, French, Spanish or Russian? I can take the translation to Russian. Should I send my translations to you or somebody else ? Serge Babkin ! (babkin@hq.icb.chel.su) ! Headquarter of Joint Stock Commercial Bank "Chelindbank" ! Chelyabinsk, Russia From owner-freebsd-doc Mon Aug 28 19:52:29 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id TAA07360 for doc-outgoing; Mon, 28 Aug 1995 19:52:29 -0700 Received: from time.cdrom.com (time.cdrom.com [192.216.222.226]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id TAA07336 ; Mon, 28 Aug 1995 19:52:19 -0700 Received: from localhost (localhost [127.0.0.1]) by time.cdrom.com (8.6.12/8.6.9) with SMTP id TAA19249; Mon, 28 Aug 1995 19:51:31 -0700 To: "Serge A. Babkin" cc: doc@freebsd.org, hackers@freebsd.org Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. In-reply-to: Your message of "Tue, 29 Aug 1995 07:52:06 +0600." <199508290152.HAA13655@hq.icb.chel.su> Date: Mon, 28 Aug 1995 19:51:30 -0700 Message-ID: <19247.809664690@time.cdrom.com> From: "Jordan K. Hubbard" Sender: doc-owner@freebsd.org Precedence: bulk > I can take the translation to Russian. Should I send my translations to > you or somebody else ? Straight to doc, I'd say! Jordan From owner-freebsd-doc Mon Aug 28 20:24:43 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id UAA08550 for doc-outgoing; Mon, 28 Aug 1995 20:24:43 -0700 Received: from healer.com (healer-gw.Empire.Net [205.164.80.204]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id UAA08530 ; Mon, 28 Aug 1995 20:24:33 -0700 Received: (from gryphon@localhost) by healer.com (8.6.11/8.6.9.1) id XAA27927; Mon, 28 Aug 1995 23:29:26 -0400 Date: Mon, 28 Aug 1995 23:29:26 -0400 From: Coranth Gryphon Message-Id: <199508290329.XAA27927@healer.com> To: hackers@freebsd.org Subject: Handbook ToDo... Cc: doc@freebsd.org Sender: doc-owner@freebsd.org Precedence: bulk > I hate to make this "help us with the docs, please!" plea so often in Keep it up until everyone says that the docs are fine :-) > Could I get some volunteers for the following projects? > 1. Fill in the *'d topics in the Handbook. Some people have told me >... > If you take a `*'d item, please also send a note to doc@FreeBSD.org Ok. I'll take "Basic Networking", and "Gateways and Routes". What level of technical detail (or what volume of text) do we want? -coranth ------------------------------------------+------------------------+ Coranth Gryphon | "Faith Manages." | | - Satai Delenn | Phone: 603-598-3440 Fax: 603-598-3430 +------------------------+ USMail: 11 Carver St, Nashua, NH 03060 Disclaimer: All these words are yours, except Europa... From owner-freebsd-doc Mon Aug 28 20:38:22 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id UAA09197 for doc-outgoing; Mon, 28 Aug 1995 20:38:22 -0700 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id UAA09178 ; Mon, 28 Aug 1995 20:38:17 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id WAA10861; Mon, 28 Aug 1995 22:37:50 -0500 From: John Fieber Message-Id: <199508290337.WAA10861@fieber-john.campusview.indiana.edu> Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. To: jkh@time.cdrom.com (Jordan K. Hubbard) Date: Mon, 28 Aug 1995 22:37:49 -0500 (EST) Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <2872.809605718@time.cdrom.com> from "Jordan K. Hubbard" at Aug 28, 95 03:28:38 am X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 3539 Sender: doc-owner@freebsd.org Precedence: bulk Jordan K. Hubbard writes: > 1. There is a lot of redundancy between the two. Yes, and as the handbook becomes more complete, so does the redundancy. I was just scanning through today and noticed at least a dozen sections that could be replaced by a simple pointer to the appropriate handbook section. I think what may need to evolve is a "FAQ interface" to the handbook; basically an alternate table of contents for the impatient. Or put another way, we do our best to make sure that the handbook provides all the correct information, and the FAQ serves as an index of sorts... > 2. We really really need a permuted index!! One approach is to wire in some indexing to the sgml mechanism. The tags are already in the DTD, they just need to be attached to processing mechanism. If someone spends a lot of time indexing, this will produce the best results. Another approach I started a couple month back but never finished was to make wais index out of it. This has the disadvantage of not shipping with system (unless wais software and an http server are added to FreeBSD...BLOAT!BLOAT!BLOAT!). Finally, I think a large number of FAQs are hardware related. To that end, we should get cracking on the hardware section of the handbook. At this point it has some commentary from Rod on PCI chipsets, and a couple notes on Digiboard and Boca multiport boards. What is envision for the hardware section is this: At the beginning of each subsection, for example, Serial ports, there should be some general information including what driver(s) in the kernel are relevant and a sample line to add to a kernel config file. After that should be notes on particular hardware that is known to work very well (recommended), work okay with some twiddling, or not work at all (not recommended). > This means that what's on the floppy will no longer be something that > comes out of /usr/src/release/sysinstall/help/..., it will be a subset > of the handbook itself! Jordan, just let me know *exactly* which sections of the handbook you want. If you answer correctly, it will be a snap to generate a subset document (though we may have to deal with some dangling cross references). ;) > sense in maintaining two versions. We also need to bring the > foreign-language versions over so that all that work isn't lost, and I > daresay that John Fieber could use some help here! I'm not writing the foreign language stuff; I have enough problems with my native language. 8) However, In the next day or so, I'll have a switch added to sgmlfmt(1) to allow selective processing of documents. (i.e. to support multiple languages, multiple editions and the like.) Also, I won't be able to do SGML tagging on the foreign texts, seing as how I wouldn't know what I was tagging.... However, don't hesitate to email me if you have any questions about the tagging. > If you take a `*'d item, please also send a note to doc@FreeBSD.org > so that work isn't unnecessarity duplicated. Please don't take > something you won't finish, since by "adopting" it you're also > essentially dissuading anyone else from doing so! And if you take `*''d item, your name will go in the handbook under that item and show up with your mail address as a mailto: URL. That will make it easy for people to send reminders. ];> -john PS: my email address will be changing in a day or two... watch this space! == jfieber@cs.smith.edu ========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Mon Aug 28 20:52:54 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id UAA09654 for doc-outgoing; Mon, 28 Aug 1995 20:52:54 -0700 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id UAA09631 ; Mon, 28 Aug 1995 20:52:47 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id WAA10908; Mon, 28 Aug 1995 22:52:26 -0500 From: John Fieber Message-Id: <199508290352.WAA10908@fieber-john.campusview.indiana.edu> Subject: Re: Argh. I think we need to do a quick reality-check on our docs.. To: doc@freebsd.org, hackers@freebsd.org Date: Mon, 28 Aug 1995 22:52:26 -0500 (EST) Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <199508281359.PAA22021@uriah.heep.sax.de> from "J Wunsch" at Aug 28, 95 03:59:30 pm X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 776 Sender: doc-owner@freebsd.org Precedence: bulk J Wunsch writes: > I volunteer for German again, but due to the job change, i'm afraid i > won't be able to spend that much time into the subject as previously. Before translators get going, I think we need to take a good look at the english install docs. As they are probably one of the most influential factors in whether or not a new user starts with a good impression of FreeBSD, extra care needs to go into their writing. I would encourage anyone who has time to look over what we currently have (http://www.freebsd.org/How/handbook/install.html) and make comments and suggestions on the doc mailing list (doc@freebsd.org). -john == jfieber@cs.smith.edu ========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Mon Aug 28 21:06:36 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA10553 for doc-outgoing; Mon, 28 Aug 1995 21:06:36 -0700 Received: from distortion.eng.umd.edu (distortion.eng.umd.edu [129.2.98.6]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA10547 for ; Mon, 28 Aug 1995 21:06:34 -0700 Received: from latte.eng.umd.edu (latte.eng.umd.edu [129.2.98.15]) by distortion.eng.umd.edu (8.6.10/8.6.4) with ESMTP id AAA09261 for ; Tue, 29 Aug 1995 00:06:32 -0400 Received: (chuckr@localhost) by latte.eng.umd.edu (8.6.10/8.6.4) id AAA13095; Tue, 29 Aug 1995 00:06:31 -0400 Date: Tue, 29 Aug 1995 00:06:30 -0400 (EDT) From: Chuck Robey To: freebsd-doc@freebsd.org Subject: how to do this? Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: doc-owner@freebsd.org Precedence: bulk I only just discovered this list, and just after I had posted a question on FreeBSD-Questions about how to format these sgml-ized docs. I saw the dtd stuff in /usr/share/sgml, but I guess I need to things: 1) The mechanics of turning the sgml source code into various other things, like ascii and postscript. 2) Adescription of the formatting rules for the most important tags. This stuff in itself oughta go into an FAQ, I'd think, if you really want help. I am most definitely not any kind of FreeBSD content export, but I write well, and I hope after I learn how this works, to volunteer here. ----------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@eng.umd.edu | communications topic, C programming, and Unix. 9120 Edmonston Ct #302 | Greenbelt, MD 20770 | I run Journey2 and n3lxx, both FreeBSD (301) 220-2114 | version 2.2 current -- and great FUN! ----------------------------+----------------------------------------------- From owner-freebsd-doc Mon Aug 28 21:22:39 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA11148 for doc-outgoing; Mon, 28 Aug 1995 21:22:39 -0700 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA11142 for ; Mon, 28 Aug 1995 21:22:38 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id XAA11025; Mon, 28 Aug 1995 23:22:06 -0500 From: John Fieber Message-Id: <199508290422.XAA11025@fieber-john.campusview.indiana.edu> Subject: Re: how to do this? To: chuckr@Glue.umd.edu (Chuck Robey) Date: Mon, 28 Aug 1995 23:22:05 -0500 (EST) Cc: freebsd-doc@freebsd.org In-Reply-To: from "Chuck Robey" at Aug 29, 95 00:06:30 am X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 887 Sender: doc-owner@freebsd.org Precedence: bulk Chuck Robey writes: > 1) The mechanics of turning the sgml source code into various other things, > like ascii and postscript. A quick look at the sgmlfmt(1) man page should get you started. > 2) Adescription of the formatting rules for the most important tags. There is one, but it needs some editing. A large part of the document is spent discussing how to install and run the processing tools on Linux. I've since rewritten the tools for FreeBSD and the install document is moot since it comes with FreeBSD (as of 2.0.5) and the operational aspects are covered in the manual page. A quick look at some of the sgml files for the handbook should give you the basic idea and don't hesitate to email questions to me or to the doc group. -john == jfieber@cs.smith.edu ========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Mon Aug 28 21:28:03 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA11255 for doc-outgoing; Mon, 28 Aug 1995 21:28:03 -0700 Received: from distortion.eng.umd.edu (distortion.eng.umd.edu [129.2.98.6]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA11249 for ; Mon, 28 Aug 1995 21:28:01 -0700 Received: from latte.eng.umd.edu (latte.eng.umd.edu [129.2.98.15]) by distortion.eng.umd.edu (8.6.10/8.6.4) with ESMTP id AAA09447; Tue, 29 Aug 1995 00:27:58 -0400 Received: (chuckr@localhost) by latte.eng.umd.edu (8.6.10/8.6.4) id AAA13245; Tue, 29 Aug 1995 00:27:57 -0400 Date: Tue, 29 Aug 1995 00:27:57 -0400 (EDT) From: Chuck Robey To: John Fieber cc: freebsd-doc@freebsd.org Subject: Re: how to do this? In-Reply-To: <199508290422.XAA11025@fieber-john.campusview.indiana.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: doc-owner@freebsd.org Precedence: bulk I just noticed a file in incoming on wcarchive, named FBSD-linuxdoc.tar.gz, Does that have formatting stuff in it? ----------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@eng.umd.edu | communications topic, C programming, and Unix. 9120 Edmonston Ct #302 | Greenbelt, MD 20770 | I run Journey2 and n3lxx, both FreeBSD (301) 220-2114 | version 2.2 current -- and great FUN! ----------------------------+----------------------------------------------- From owner-freebsd-doc Mon Aug 28 21:31:50 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA11446 for doc-outgoing; Mon, 28 Aug 1995 21:31:50 -0700 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA11440 for ; Mon, 28 Aug 1995 21:31:49 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id XAA11080; Mon, 28 Aug 1995 23:31:22 -0500 From: John Fieber Message-Id: <199508290431.XAA11080@fieber-john.campusview.indiana.edu> Subject: Re: how to do this? To: chuckr@Glue.umd.edu (Chuck Robey) Date: Mon, 28 Aug 1995 23:31:21 -0500 (EST) Cc: doc@freebsd.org In-Reply-To: from "Chuck Robey" at Aug 29, 95 00:27:57 am X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 410 Sender: doc-owner@freebsd.org Precedence: bulk Chuck Robey writes: > I just noticed a file in incoming on wcarchive, named FBSD-linuxdoc.tar.gz, > Does that have formatting stuff in it? Yikes! I better delete that one, its ancient! The docs I mentioned are in /usr/src/share/sgml/FreeBSD/doc in 2.0.5 and later. -john == jfieber@cs.smith.edu ========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============ From owner-freebsd-doc Mon Aug 28 21:45:18 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA11694 for doc-outgoing; Mon, 28 Aug 1995 21:45:18 -0700 Received: from distortion.eng.umd.edu (distortion.eng.umd.edu [129.2.98.6]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA11688 for ; Mon, 28 Aug 1995 21:45:17 -0700 Received: from latte.eng.umd.edu (latte.eng.umd.edu [129.2.98.15]) by distortion.eng.umd.edu (8.6.10/8.6.4) with ESMTP id AAA09556; Tue, 29 Aug 1995 00:45:15 -0400 Received: (chuckr@localhost) by latte.eng.umd.edu (8.6.10/8.6.4) id AAA13298; Tue, 29 Aug 1995 00:45:14 -0400 Date: Tue, 29 Aug 1995 00:45:12 -0400 (EDT) From: Chuck Robey To: John Fieber cc: freebsd-doc@freebsd.org Subject: Re: how to do this? In-Reply-To: <199508290422.XAA11025@fieber-john.campusview.indiana.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: doc-owner@freebsd.org Precedence: bulk On Mon, 28 Aug 1995, John Fieber wrote: > Chuck Robey writes: > > 1) The mechanics of turning the sgml source code into various other things, > > like ascii and postscript. > > A quick look at the sgmlfmt(1) man page should get you started. The sgmlfmt page says the sgmlfmt command takes two sets of flags, -format and -links, but doesn't explain what the -links are.. Could you either explain, or tell me I don't need them? > > > 2) Adescription of the formatting rules for the most important tags. > > There is one, but it needs some editing. A large part of the > document is spent discussing how to install and run the > processing tools on Linux. I've since rewritten the tools for > FreeBSD and the install document is moot since it comes with > FreeBSD (as of 2.0.5) and the operational aspects are covered in > the manual page. > > A quick look at some of the sgml files for the handbook should > give you the basic idea and don't hesitate to email questions to > me or to the doc group. > > -john > > == jfieber@cs.smith.edu ========================================== > == http://fieber-john.campusview.indiana.edu/~jfieber ============ > ----------------------------+----------------------------------------------- Chuck Robey | Interests include any kind of voice or data chuckr@eng.umd.edu | communications topic, C programming, and Unix. 9120 Edmonston Ct #302 | Greenbelt, MD 20770 | I run Journey2 and n3lxx, both FreeBSD (301) 220-2114 | version 2.2 current -- and great FUN! ----------------------------+----------------------------------------------- From owner-freebsd-doc Mon Aug 28 21:53:29 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id VAA11848 for doc-outgoing; Mon, 28 Aug 1995 21:53:29 -0700 Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34]) by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id VAA11842 for ; Mon, 28 Aug 1995 21:53:27 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id XAA11178; Mon, 28 Aug 1995 23:53:03 -0500 From: John Fieber Message-Id: <199508290453.XAA11178@fieber-john.campusview.indiana.edu> Subject: Re: how to do this? To: chuckr@Glue.umd.edu (Chuck Robey) Date: Mon, 28 Aug 1995 23:53:02 -0500 (EST) Cc: doc@freebsd.org In-Reply-To: from "Chuck Robey" at Aug 29, 95 00:45:12 am X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 1330 Sender: doc-owner@freebsd.org Precedence: bulk Chuck Robey writes: > The sgmlfmt page says the sgmlfmt command takes two sets of flags, > -format and -links, but doesn't explain what the -links are.. Could you > either explain, or tell me I don't need them? Huh? It should say something. The -link option didn't exist in the version that came with 2.0.5. Anyway... -links When used with the -html option, for each