From owner-freebsd-doc Sun Apr 2 05:46:45 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id FAA02969 for doc-outgoing; Sun, 2 Apr 1995 05:46:45 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id FAA02963; Sun, 2 Apr 1995 05:46:43 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id IAA01318; Sun, 2 Apr 1995 08:47:22 -0400 From: jfieber@cs.smith.edu (John Fieber) Message-Id: <199504021247.IAA01318@grendel.csc.smith.edu> Subject: Re: ptx man page? To: jmacd@freefall.cdrom.com (Joshua Peck Macdonald) Date: Sun, 2 Apr 1995 08:47:22 -0400 (EDT) Cc: doc@freebsd.org In-Reply-To: <199504010237.SAA15964@freefall.cdrom.com> from "Joshua Peck Macdonald" at Mar 31, 95 06:37:08 pm Content-Type: text Content-Length: 566 Sender: doc-owner@freebsd.org Precedence: bulk Joshua Peck Macdonald writes: > how come there is no man page for /usr/bin/ptx? Its a GNU program and comes with texinfo documentation rather than a man page. In FreeBSD-current, this can be found in /usr/share/info and read with the info mode in emacs, or the info reader. It might be good to provide a minmial man page (a slightly more verbose version of "ptx --help" with a refernce to the info page. -john === jfieber@cs.smith.edu ================================================ =================================== Come up and be a kite! --K. Bush === From owner-freebsd-doc Tue Apr 4 17:44:57 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id RAA27727 for doc-outgoing; Tue, 4 Apr 1995 17:44:57 -0700 Received: from localhost (localhost [127.0.0.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id RAA27718 for ; Tue, 4 Apr 1995 17:44:52 -0700 X-Authentication-Warning: freefall.cdrom.com: Host localhost didn't use HELO protocol Prev-Resent: Tue, 04 Apr 1995 17:44:51 -0700 Prev-Resent: "doc " Received: from mailhost.lanl.gov (mailhost.lanl.gov [128.165.3.12]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id JAA14809 for ; Tue, 4 Apr 1995 09:06:54 -0700 Received: from beta.lanl.gov by mailhost.lanl.gov (8.6.11/1.2) id KAA03972; Tue, 4 Apr 1995 10:06:28 -0600 Received: by beta.lanl.gov (5.57/Ultrix2.4-C) id AA18468; Tue, 4 Apr 95 10:05:53 -0600 Date: Tue, 4 Apr 95 10:05:53 -0600 From: crs@beta.lanl.gov (Charlie Sorsby) Message-Id: <9504041605.AA18468@beta.lanl.gov> To: jkh@freefall.cdrom.com Subject: Re: New Status Newsgroups: comp.unix.bsd.freebsd.announce In-Reply-To: Organization: Los Alamos Natn'l Laboratory Resent-To: doc@freefall.cdrom.com Resent-Date: Tue, 04 Apr 1995 17:44:52 -0700 Resent-Message-ID: <27717.797042692@freefall.cdrom.com> Resent-From: "Jordan K. Hubbard" Sender: doc-owner@freebsd.org Precedence: bulk Hi, Jordan, Just in case you're too busy to read news... :) In article , Jordan K. Hubbard wrote: = I promised to say something about this a week or so back and have = been too busy with my new status to talk much about it! :-) = = 3. Documentation. I'll be diving into the FreeBSD book and other assorted = documentation with a vengence just as soon as the 2.1 crunch is over. = More on this as it happens, since doc is something that's much talked = about and little done, so I'll just hope that actions will speak louder = than words here! I have a request for this department: How about a chapter for those of us who know a bit of Unix but next to nothing about PCs? I never much wanted a PC until I learned about the *BSDs and now I know so little about them, I'm not sure I can figure out how to put a suitable combination of hardware together. Perhaps some example systems as well as more general information. And do remember that not all of us have a key to Fort Knox. And good luck in your new endeavors... -- Best, Charlie "Older than dirt" Sorsby "I'm the NRA!" crs@lanl.gov From owner-freebsd-doc Tue Apr 4 19:14:53 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id TAA29508 for doc-outgoing; Tue, 4 Apr 1995 19:14:53 -0700 Received: from fslg8.fsl.noaa.gov (fslg8.fsl.noaa.gov [137.75.131.171]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id TAA29501 for ; Tue, 4 Apr 1995 19:14:49 -0700 Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA01701; Wed, 5 Apr 95 02:14:03 GMT Received: by junco.fsl.noaa.gov (1.38.193.4/SMI-4.1 (1.38.193.4)) id AA06265; Tue, 4 Apr 1995 20:14:07 -0600 Date: Tue, 4 Apr 1995 20:14:07 -0600 From: kelly@fsl.noaa.gov (Sean Kelly) Message-Id: <9504050214.AA06265@junco.fsl.noaa.gov> To: crs@beta.lanl.gov Cc: jkh@freefall.cdrom.com, doc@freebsd.org In-Reply-To: <9504041605.AA18468@beta.lanl.gov> (crs@beta.lanl.gov) Subject: Re: New Status Sender: doc-owner@freebsd.org Precedence: bulk >>>>> "Charlie" == Charlie Sorsby writes: Charlie> I have a request for this department: How about a chapter Charlie> for those of us who know a bit of Unix but next to Charlie> nothing about PCs? An excellent request, really. I've hacked Suns and HPs all my life and wanted an inexpensive BSD-style OS at home but couldn't begin to afford typical workstation hardware. The market that IBM and MS-DOS created though was much more in my price range---and there was FreeBSD to boot---literally! But I'm still clueless when it comes to motherboards, BIOS, PCI vs VLB and other trivia. Until FreeBSD docs can fill this niche, you might want to take a look at the PC Unix FAQ, available at rtfm.mit.edu or your favorite FAQ repository. It's a wee bit dated, but a good start. --k From owner-freebsd-doc Thu Apr 6 09:13:40 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id JAA00956 for doc-outgoing; Thu, 6 Apr 1995 09:13:40 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id JAA00938 ; Thu, 6 Apr 1995 09:13:32 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id MAA02149; Thu, 6 Apr 1995 12:14:18 -0400 From: jfieber@cs.smith.edu (John Fieber) Message-Id: <199504061614.MAA02149@grendel.csc.smith.edu> Subject: Documentation Project To: doc@freebsd.org, hackers@freebsd.org Date: Thu, 6 Apr 1995 12:14:17 -0400 (EDT) Content-Type: text Content-Length: 1231 Sender: doc-owner@freebsd.org Precedence: bulk Jordan has started waving the poited stick and ranting about the upcoming release of 2.1. Amazingly enough I got a few hours this week to bring some of the documentation ideas into a more concrete form. I have added a toplevel "help" page and *rough* outlines for a user manual, administration manual and reference manual. The latter is actually just a pointer to the man(1) command but if time permits, an html interface to the man command could be added. A tenative plan is to have lynx wired up as a "help" command pointing at the toplevel page. The other two sections are outlines that probably need some shuffling, additions, and deletions. I welcome you comments and suggestions on this. The outline is probably over-ambitious and some empty sections will probably get commented out for the release. My vision is to have what is currently listed under tutorials filter into the user and admin manuals. Now, there are a number of sections that various volunteers in the doc group agreed to work on. I may be coming after YOU with a pointed stick soon! ;) -john === jfieber@cs.smith.edu ================================================ =================================== Come up and be a kite! --K. Bush === From owner-freebsd-doc Thu Apr 6 09:19:09 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id JAA01184 for doc-outgoing; Thu, 6 Apr 1995 09:19:09 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id JAA01166 ; Thu, 6 Apr 1995 09:19:03 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id MAA02278; Thu, 6 Apr 1995 12:19:56 -0400 From: jfieber@cs.smith.edu (John Fieber) Message-Id: <199504061619.MAA02278@grendel.csc.smith.edu> Subject: Re: Documentation Project To: jfieber@cs.smith.edu (John Fieber) Date: Thu, 6 Apr 1995 12:19:55 -0400 (EDT) Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: <199504061614.MAA02149@grendel.csc.smith.edu> from "John Fieber" at Apr 6, 95 12:14:17 pm Content-Type: text Content-Length: 477 Sender: doc-owner@freebsd.org Precedence: bulk John Fieber writes: > I have added a toplevel "help" page and *rough* outlines for a > user manual, administration manual and reference manual. The Oh, I forgot to mention. A live copy of this is available via http://www.freebsd.org/~jfieber/FAQ. This is my working copy so at times it may be in a state of disarray. -john === jfieber@cs.smith.edu ================================================ =================================== Come up and be a kite! --K. Bush === From owner-freebsd-doc Thu Apr 6 10:10:11 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id KAA02258 for doc-outgoing; Thu, 6 Apr 1995 10:10:11 -0700 Received: from nomad.osmre.gov (nomad.osmre.gov [192.243.129.244]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id KAA02251 ; Thu, 6 Apr 1995 10:10:07 -0700 Received: (from gfoster@localhost) by nomad.osmre.gov (8.6.8/8.6.6) id NAA14187; Thu, 6 Apr 1995 13:07:40 -0400 Date: Thu, 6 Apr 1995 13:07:40 -0400 From: Glen Foster Message-Id: <199504061707.NAA14187@nomad.osmre.gov> To: jfieber@cs.smith.edu CC: doc@freebsd.org, hackers@freebsd.org In-reply-to: <199504061614.MAA02149@grendel.csc.smith.edu> (jfieber@cs.smith.edu) Subject: Re: Documentation Project Sender: doc-owner@freebsd.org Precedence: bulk Ouch! I must be one of the worst but I'll start working more on my sections soon, most likely Monday. I started the "Intro" and noticed that the outline I came up with was very much like http://www.freebsd.org/ so I move that we adopt that as the Introduction, perhaps adding a section or two, one on "what the Free in FreeBSD stands for," "what's in FreeBSD," "The Why of FreeBSD," and a little more on the history of FreeBSD, probably starting with 4.3bsd on VAXEN. What do you think of these ideas? Would you want me to convert the FreeBSD home page to LINUXDOC or have we "decided" to go with HTML for the release? Glen > From: jfieber@cs.smith.edu (John Fieber) > Date: Thu, 6 Apr 1995 12:14:17 -0400 (EDT) > > Now, there are a number of sections that various volunteers in > the doc group agreed to work on. I may be coming after YOU with > a pointed stick soon! ;) From owner-freebsd-doc Thu Apr 6 16:15:43 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id QAA12056 for doc-outgoing; Thu, 6 Apr 1995 16:15:43 -0700 Received: from localhost (localhost [127.0.0.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id QAA12049 ; Thu, 6 Apr 1995 16:15:42 -0700 X-Authentication-Warning: freefall.cdrom.com: Host localhost didn't use HELO protocol To: jfieber@cs.smith.edu (John Fieber) cc: doc@freebsd.org, hackers@freebsd.org Subject: Re: Documentation Project In-reply-to: Your message of "Thu, 06 Apr 95 12:14:17 EDT." <199504061614.MAA02149@grendel.csc.smith.edu> Date: Thu, 06 Apr 1995 16:15:42 -0700 Message-ID: <12047.797210142@freefall.cdrom.com> From: "Jordan K. Hubbard" Sender: doc-owner@freebsd.org Precedence: bulk > I have added a toplevel "help" page and *rough* outlines for a > user manual, administration manual and reference manual. The > latter is actually just a pointer to the man(1) command but if > time permits, an html interface to the man command could be > added. A tenative plan is to have lynx wired up as a "help" > command pointing at the toplevel page. Hoorah! And there was great rejoicing! > Now, there are a number of sections that various volunteers in > the doc group agreed to work on. I may be coming after YOU with > a pointed stick soon! ;) Excellent! The pointy doc stick is yours to wield, John - tell us what to do! :-) Jordan From owner-freebsd-doc Thu Apr 6 20:29:41 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id UAA20670 for doc-outgoing; Thu, 6 Apr 1995 20:29:41 -0700 Received: from localhost (localhost [127.0.0.1]) by freefall.cdrom.com (8.6.10/8.6.6) with SMTP id UAA20661 for ; Thu, 6 Apr 1995 20:29:40 -0700 X-Authentication-Warning: freefall.cdrom.com: Host localhost didn't use HELO protocol Prev-Resent: Thu, 06 Apr 1995 20:29:40 -0700 Prev-Resent: "docs@freebsd.org " Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id TAA18110 for hackers-outgoing; Thu, 6 Apr 1995 19:07:33 -0700 Received: from ix2.ix.netcom.com (ix2.ix.netcom.com [199.182.120.3]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id TAA18100 for ; Thu, 6 Apr 1995 19:07:31 -0700 Received: from by ix2.ix.netcom.com (8.6.12/SMI-4.1/Netcom) id TAA14880; Thu, 6 Apr 1995 19:04:16 -0700 Date: Thu, 6 Apr 1995 19:04:16 -0700 Message-Id: <199504070204.TAA14880@ix2.ix.netcom.com> From: PVinci@ix.netcom.com (Paul Vinciguerra) Subject: Who's handling DOC's and how can I help... To: hackers@freebsd.org Resent-To: docs@freebsd.org Resent-Date: Thu, 06 Apr 1995 20:29:40 -0700 Resent-Message-ID: <20660.797225380@freefall.cdrom.com> Resent-From: "Jordan K. Hubbard" Sender: doc-owner@freebsd.org Precedence: bulk I saw something about somebody owning the DOC. I'd like to help. Let me know what I can do to help. Are the docs going to be in html? If so, I can convert existing docs, or whatever. I figure this is the best way to really learn the OS. Paul From owner-freebsd-doc Thu Apr 6 22:23:36 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id WAA23142 for doc-outgoing; Thu, 6 Apr 1995 22:23:36 -0700 Received: from aries.ibms.sinica.edu.tw ([140.109.40.248]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id WAA23134 ; Thu, 6 Apr 1995 22:23:33 -0700 Received: (from taob@localhost) by aries.ibms.sinica.edu.tw (8.6.11/8.6.9) id NAA17930; Fri, 7 Apr 1995 13:23:02 +0800 Date: Fri, 7 Apr 1995 13:23:00 +0800 (CST) From: Brian Tao To: John Fieber cc: doc@freebsd.org, hackers@freebsd.org Subject: Re: Documentation Project In-Reply-To: <199504061614.MAA02149@grendel.csc.smith.edu> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: doc-owner@freebsd.org Precedence: bulk On Thu, 6 Apr 1995, John Fieber wrote: > > an html interface to the man command could be > added. A tenative plan is to have lynx wired up as a "help" > command pointing at the toplevel page. Now I remember what it was I wanted to bring up over the past week... :( I'd like to toss in another candidate for HTTP server, with particular regard to this business of creating a friendly documentation interface for our users. The server is WN and its home page is at http://hopf.math.nwu.edu/. It has several standard features which I think make it an ideal engine to back-end our HTML documentation. The server itself can perform a wide variety of searches, both context-based and index- based, without farming out the job to a CGI. It is also capable of merging two HTML documents together, e.g.: a standard display header or a set of navigation buttons appended to the end of each man page or search result. You can also assign a filter to any document, allowing you to bring up raw man pages in HTML without need for a second set of HTMLified ones wasting disk space. Again, it does this internally without the aid of a CGI script. I'll leave the details out of this message to keep it short. Check out the Web page for full documentation and specifications. Source code is, of course, freely available and has been placed under GPL (for those who need to worry about such things). I should have some time this weekend to play around with it, assuming I manage to grab the source by then (FTP's running at 300 bytes/sec at the moment, ugh...) > Now, there are a number of sections that various volunteers in > the doc group agreed to work on. I may be coming after YOU with > a pointed stick soon! ;) Waving of pointed sticks is a healthy thing here. :) It gets things done and benefits the whole FreeBSD community. Thanks, John. -- Brian ("Though this be madness, yet there is method in't") Tao taob@gate.sinica.edu.tw <-- work ........ play --> taob@io.org From owner-freebsd-doc Sat Apr 8 11:51:22 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id LAA20487 for doc-outgoing; Sat, 8 Apr 1995 11:51:22 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id LAA20460 ; Sat, 8 Apr 1995 11:51:00 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id OAA16704; Sat, 8 Apr 1995 14:46:54 -0400 From: jfieber@cs.smith.edu (John Fieber) Message-Id: <199504081846.OAA16704@grendel.csc.smith.edu> Subject: Re: Documentation Project To: taob@gate.sinica.edu.tw (Brian Tao) Date: Sat, 8 Apr 1995 14:46:53 -0400 (EDT) Cc: doc@freebsd.org, hackers@freebsd.org In-Reply-To: from "Brian Tao" at Apr 7, 95 01:23:00 pm Content-Type: text Content-Length: 672 Sender: doc-owner@freebsd.org Precedence: bulk Brian Tao writes: > Now I remember what it was I wanted to bring up over the past > week... :( I'd like to toss in another candidate for HTTP server, > with particular regard to this business of creating a friendly > documentation interface for our users. The server is WN and its home > page is at http://hopf.math.nwu.edu/. [lots of whiz-bang features] I'll take a look at it, but I'm not entirely conviced that a swiss army knife httpd server is that good of a thing. I think CGI scripts work just fine. -john === jfieber@cs.smith.edu ================================================ =================================== Come up and be a kite! --K. Bush === From owner-freebsd-doc Sat Apr 8 12:01:09 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id MAA20613 for doc-outgoing; Sat, 8 Apr 1995 12:01:09 -0700 Received: from grendel.csc.smith.edu (grendel.csc.smith.edu [131.229.222.23]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id MAA20589 ; Sat, 8 Apr 1995 12:00:48 -0700 Received: from localhost (jfieber@localhost) by grendel.csc.smith.edu (8.6.5/8.6.5) id PAA16861; Sat, 8 Apr 1995 15:01:43 -0400 From: jfieber@cs.smith.edu (John Fieber) Message-Id: <199504081901.PAA16861@grendel.csc.smith.edu> Subject: Documentation project update To: doc@freebsd.org, hackers@freebsd.org Date: Sat, 8 Apr 1995 15:01:42 -0400 (EDT) Content-Type: text Content-Length: 397 Sender: doc-owner@freebsd.org Precedence: bulk I've put together a page a WWW for people interested in working on the documentation project. It is http://www.freebsd.org/~jfieber/doc. Included are links to the various tools that are helpful for composing things using the linuxdoc DTD. -john === jfieber@cs.smith.edu ================================================ =================================== Come up and be a kite! --K. Bush === From owner-freebsd-doc Sat Apr 8 15:32:06 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id PAA28164 for doc-outgoing; Sat, 8 Apr 1995 15:32:06 -0700 Received: from ix3.ix.netcom.com (ix3.ix.netcom.com [199.182.120.5]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id PAA28158 for ; Sat, 8 Apr 1995 15:32:05 -0700 Received: from by ix3.ix.netcom.com (8.6.12/SMI-4.1/Netcom) id PAA06950; Sat, 8 Apr 1995 15:31:31 -0700 Date: Sat, 8 Apr 1995 15:31:31 -0700 Message-Id: <199504082231.PAA06950@ix3.ix.netcom.com> From: PVinci@ix.netcom.com (Paul Vinciguerra) Subject: linuxdoc.dtd... To: doc@freebsd.org Sender: doc-owner@freebsd.org Precedence: bulk I have psgml set up on xwindows ... that's how I wrote rebuild.html. After I read your mail, I started writing config.html .. to explain the config file. I since got your mail on linuxdoc and downloaded the dtd. my question is... How do you get psgml to use linucdoc.dtd? get me going & I'll refornat config.html to config.??? according to linuxdoc. thanks, Paul