From owner-freebsd-doc Mon Apr 15 12:05:33 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id MAA23692 for doc-outgoing; Mon, 15 Apr 1996 12:05:33 -0700 (PDT) Received: from solair1.inter.NL.net (solair1.inter.NL.net [193.78.240.13]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id MAA23681 for ; Mon, 15 Apr 1996 12:05:27 -0700 (PDT) Received: from ldn51-0.Leiden.NL.net by solair1.inter.NL.net (5.65b/solair1.Inter.NL.net-1.31) id AA03342; Mon, 15 Apr 1996 20:57:50 +0200 Message-Id: <9604151857.AA03342@solair1.inter.NL.net> Date: Mon, 15 Apr 1996 16:40:24 +0200 (MET DST) To: doc@freebsd.org Subject: documentation project From: J.P.Jansen@net.HCC.nl Reply-To: J.P.Jansen@net.HCC.nl X-Sender: jos Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Tell me more about taking part in the FreeBSD documentation project. I may have a few items to contribute. Immediately available are some hints on PPP configuration (the result of some work I did on my own home page) and on the configuration of E-mail systems for users of dial-up IP accounts. I have in the not-too-distant past written and published (in Dutch, for limited circulation) on the configuration of printer spoolers. I have also written in English and in Dutch about the installation and maintenance of uucp. I'd be willing to assist in preparing a chapter on PC Cards. Things I cannot write about include the weird and magic goings-on inside the kernel, name servers, routing and SCSI. I suppose that you have guidelines for writing documentation; I'd appreciate a copy if you think I can help. Some background: I am considerably older than Bill Gates and I have been playing around with Unix for ~7 years, on Altos-68K, Xenix-386, SVR4 (Consensys, > /dev/trash), Linux and FreeBSD (starting from 2.0). I made the switch from Linux to BSD because, while I'm always ready to tolerate or even encourage a measure of anarchy, I do not always enjoy the resulting mess. I have little formal training in CS and am not employed in this industry. I just happen to like computers as long as they run Unix. I cannot be bothered to learn C++ and program, if and when necessary, in C, Perl or (preferably) Tcl. cheers -- Jos Jansen J.P.Jansen@net.HCC.nl +31 71 3415740 *** FreeBSD 2.1 Inside *** From owner-freebsd-doc Mon Apr 15 15:18:08 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id PAA12344 for doc-outgoing; Mon, 15 Apr 1996 15:18:08 -0700 (PDT) Received: from andrsn.stanford.edu (andrsn.Stanford.EDU [36.33.0.163]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id PAA12324 for ; Mon, 15 Apr 1996 15:18:05 -0700 (PDT) Received: (from andrsn@localhost) by andrsn.stanford.edu (8.6.11/8.6.9) id PAA10905; Mon, 15 Apr 1996 15:17:14 GMT Date: Mon, 15 Apr 1996 15:17:13 +0000 () From: Annelise Anderson X-Sender: andrsn@andrsn To: jfieber@indiana.edu cc: freebsd-doc@freebsd.org Subject: FreeBSD Help for Users New to FreeBSD & Unix In-Reply-To: <01I3KND5BB8Y001WHQ@HOOVER.STANFORD.EDU> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk > On Thu, 4 Apr 1996, Annelise Anderson wrote: > > > There doesn't seem to be anything directed specifically at > > these dual-new users. It might be helpful to them and also > > possibly reduce some of the repeat question on the questions > > group. > > > > Would you be interested, or does this in effect already exist? > > Interested, yes. Does it exist? No, not in our documentation. > Are thinking of something that could fill out the currently > anorexic section in Part 1 of the current handbook called "Unix > Basics"? Currently it just explains how to get to the man pages > which is the ultimate, but all to frequent, copout. > > So, yes, we would be very interested in such a document! Some > common questions that should be addressed is "Okay, now I have > this login: prompt, what do I do" which entails a short > description of the root account, why it exists, how it should > (and should not!) be used. Then touch on the key differences > between unix and mac/windoze/os2(/vms?). Basic commands, > Important basic philosophies and customs should be identified > (simple tools with pipelines, shells, .dotfiles in your home > directory, your home directory...). And so on. > > If you hack up an outline, I'd love to see it, or just send it > off to doc@freebsd.org. > > -john > > == jfieber@indiana.edu =========================================== > == http://fallout.campusview.indiana.edu/~jfieber ================ Here is the outline as it currently exists (early draft): 1) Logging in, getting out 2) Creating a new user, su to root 3) Looking around (id, pwd, ls & variants, view, cat) 4) Getting help and information (apropos, man, which, locate, whatis, whereis....running maintenance to update data bases (system administration) 5) Editing text--vi basics 6) Printing FreeBSD files from dos 7) Other useful commands 8) Next steps--ports from cdrom, a few other common problems This little guide is intended for people new to *both* FreeBSD and any variety of Unix; at some points it's a walk-through, at others it tries to provide the tools by which people can learn more for themselves. Any analogies are to DOS; I don't know enough about the Mac or VMS to handle these (I think OS/2 users probably also know MSDOS). It covers more than the outline suggests. I didn't see it as an expansion of what's now in the handbook about basic Unix commands and didn't want this to try to substitute for a Unix tutorial (there are some on the Net to which people could be referred, in addition to many books). Rather it is special guide for people in a peculiar (and somewhat unusual) situation. I replied on the questions group to one of those questions that goes "Now that I've installed it, what do I do?" by sending this document by electronic mail, and a couple of other people requested it (one who said he was just about ready to give up). It asks for feedback and I was hoping to get some to polish it up a little. It will also need feedback from those who know more about FreeBSD than I do at this point. I can post the entire document to this group for comment and consideration if you want me to do that, or send anyone who requests it a copy by electronic mail. It's about 15K now and there are a couple of things I still want to add. There's also a copy of it on my web page at http://andrsn.stanford.edu/FreeBSD/newuser.html. --Annelise ----------------------------------------------------------------------------- Annelise Anderson |"If to please the people we offer The Hoover Institution | what we ourselves disapprove, Stanford University | how can we afterward defend our work?" http://andrsn.stanford.edu/ | --George Washington, to the andrsn@hoover.stanford.edu | Constitutional Convention delegates ----------------------------------------------------------------------------- From owner-freebsd-doc Mon Apr 15 16:07:08 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id QAA15018 for doc-outgoing; Mon, 15 Apr 1996 16:07:08 -0700 (PDT) Received: from dfw-ix7.ix.netcom.com (dfw-ix7.ix.netcom.com [206.214.98.7]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id QAA15012 for ; Mon, 15 Apr 1996 16:07:06 -0700 (PDT) Received: from danielpf (ix-oly-wa2-20.ix.netcom.com [205.184.155.84]) by dfw-ix7.ix.netcom.com (8.6.13/8.6.12) with SMTP id QAA00541; Mon, 15 Apr 1996 16:04:10 -0700 Message-ID: <31725B0D.649@ix.netcom.com> Date: Mon, 15 Apr 1996 15:19:57 +0100 From: "Daniel P. Pflager" Organization: Universal Bankcard Software, Inc. X-Mailer: Mozilla 2.0 (Win95; U) MIME-Version: 1.0 To: freebsd-doc@FREEBSD.ORG CC: dpflag@ix.netcom.com Subject: [Fwd: Re: Colorado QFA 500] Content-Type: message/rfc822 Content-Transfer-Encoding: 7bit Content-Disposition: inline Sender: owner-doc@FREEBSD.ORG X-Loop: FreeBSD.org Precedence: bulk Return-Path: Received: from phaeton.artisoft.com by ix8.ix.netcom.com (8.6.13/SMI-4.1/Netcom) id QAA25968; Sat, 13 Apr 1996 16:23:24 -0700 Received: (from terry@localhost) by phaeton.artisoft.com (8.6.11/8.6.9) id QAA05914; Sat, 13 Apr 1996 16:21:21 -0700 From: Terry Lambert Message-Id: <199604132321.QAA05914@phaeton.artisoft.com> Subject: Re: Colorado QFA 500 To: dpflag@ix.netcom.com (Daniel P. Pflager) Date: Sat, 13 Apr 1996 16:21:21 -0700 (MST) Cc: questions@FreeBSD.org, dpflag@ix.netcom.com In-Reply-To: <316F8CD9.1D7F@ix.netcom.com> from "Daniel P. Pflager" at Apr 13, 96 12:15:37 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: 974 Status: U X-Mozilla-Status: 0011 > I guess I've answered my own question. The QFA 500 > appears to work with the wt0 driver just fine. > > 1) Should I let the doc project know? Heavens no! They would just document it, and then we wouldn't be able to answer "does the QFA 500 work?" questions with things like "yes, use the wt0 driver -- it works just fine". 8-) 8-). > 2) Is there a test suite which I could run to ensure > it is "really" compatible. (I've just been using > tar with it). Maybe step through all of the MT commands. I haven't seen a tape driver validation suite outside of a lab at NCR before AT&T bought them. > 3) How can I make /dev/rwt0 the default tape device > (for tar, mt, etc?). Point me to the doc... Recompile it. The default is /dev/rst0 (see the man page). This should probably be install-time configurable... anyone? Terry Lambert terry@lambert.org --- Any opinions in this posting are my own and not those of my present or previous employers. From owner-freebsd-doc Mon Apr 15 23:18:02 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id XAA15974 for doc-outgoing; Mon, 15 Apr 1996 23:18:02 -0700 (PDT) Received: from nixpbe.pdb.sni.de (mail.sni.de [192.109.2.33]) by freefall.freebsd.org (8.7.3/8.7.3) with ESMTP id XAA15966 for ; Mon, 15 Apr 1996 23:17:53 -0700 (PDT) Received: (from nerv@localhost) by nixpbe.pdb.sni.de (8.6.12/8.6.12) id IAA20140 for freebsd-doc@freebsd.org; Tue, 16 Apr 1996 08:18:47 +0200 Message-Id: <199604160618.IAA20140@nixpbe.pdb.sni.de> Subject: Re: [Fwd: Re: Colorado QFA 500] To: dpflag@ix.netcom.com (Daniel P. Pflager) Date: Tue, 16 Apr 96 8:17:39 MDT From: Greg Lehey Cc: freebsd-doc@freebsd.org, dpflag@ix.netcom.com In-Reply-To: <31725B0D.649@ix.netcom.com>; from "Daniel P. Pflager" at Apr 15, 96 3:19 pm X-Mailer: xmail 2.4 (based on ELM 2.2 PL16) Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk >> 3) How can I make /dev/rwt0 the default tape device >> (for tar, mt, etc?). Point me to the doc... > > Recompile it. The default is /dev/rst0 (see the man page). > > This should probably be install-time configurable... anyone? It is. Set the environment variable TAPE to the desired tape device name. For example (Bourne shell and descendants): TAPE=/dev/nrst1 export TAPE tar c . (archive the current directory) tar t (list the tape in /dev/nrst1) Greg From owner-freebsd-doc Tue Apr 16 08:41:42 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id IAA19944 for doc-outgoing; Tue, 16 Apr 1996 08:41:42 -0700 (PDT) Received: from fslg8.fsl.noaa.gov (fslg8.fsl.noaa.gov [137.75.131.171]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id IAA19936 for ; Tue, 16 Apr 1996 08:41:39 -0700 (PDT) Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA09509; Tue, 16 Apr 96 15:41:27 GMT Message-Id: <9604161541.AA09509@fslg8.fsl.noaa.gov> Received: by emu.fsl.noaa.gov (1.40.112.3/16.2) id AA105319337; Tue, 16 Apr 1996 09:42:17 -0600 Date: Tue, 16 Apr 1996 09:42:17 -0600 From: Sean Kelly To: J.P.Jansen@net.hcc.nl Cc: doc@freebsd.org In-Reply-To: <9604151857.AA03342@solair1.inter.NL.net> (J.P.Jansen@net.hcc.nl) Subject: Re: documentation project Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk >>>>> "Jos" == J P Jansen writes: Jos> Tell me more about taking part in the FreeBSD documentation Jos> project. I may have a few items to contribute. The more, the better. Thanks for being willing to contribute! Jos> Immediately available are some hints on PPP configuration Jos> (the result of some work I did on my own home page) and on Jos> the configuration of E-mail systems for users of dial-up IP Jos> accounts. We already do have some documentation on PPP configuration, but it wouldn't hurt to have some supplementary material---particularly if you could provide more examples with dynamic and static IP assignment, PAP authentication, etc. As for email config for dial-up IP users, I don't think there's any material yet in the handbook. It'd be nice to have some! Jos> I have also written in English and in Dutch about the Jos> installation and maintenance of uucp. I'd be willing to Jos> assist in preparing a chapter on PC Cards. UUCP! Yes! We need that! Jos> I suppose that you have guidelines for writing documentation; Jos> I'd appreciate a copy if you think I can help. We don't have a style sheet or wordlist, so your best bet for style is just to read what already exists in the handbook (file:/usr/share/doc/handbook/handbook.html or on the FreeBSD home page http://www.freebsd.org/handbook/handbook.html). Also see the FreeBSD doc project page, at: http://www.freebsd.org/docproj.html Then, learn how to use SGML, the linuxdoc DTD, sgmlfmt, and start writing! Best wishes! -- Sean Kelly NOAA Forecast Systems Laboratory kelly@fsl.noaa.gov Boulder Colorado USA http://www-sdd.fsl.noaa.gov/~kelly/ From owner-freebsd-doc Thu Apr 18 10:41:12 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id KAA24195 for doc-outgoing; Thu, 18 Apr 1996 10:41:12 -0700 (PDT) Received: from dfw-ix12.ix.netcom.com (dfw-ix12.ix.netcom.com [206.214.98.12]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id KAA24189 for ; Thu, 18 Apr 1996 10:41:10 -0700 (PDT) Received: from danielpf (ix-oly-wa1-17.ix.netcom.com [205.184.155.49]) by dfw-ix12.ix.netcom.com (8.6.13/8.6.12) with SMTP id KAA23802; Thu, 18 Apr 1996 10:39:32 -0700 Message-ID: <3176036F.45E7@ix.netcom.com> Date: Thu, 18 Apr 1996 09:55:11 +0100 From: "Daniel P. Pflager" Organization: Universal Bankcard Software, Inc. X-Mailer: Mozilla 2.0 (Win95; U) MIME-Version: 1.0 To: doc@freebsd.org CC: dpflag@ix.netcom.com Subject: WYSIWYG Word Processor X-URL: http://www.freebsd.org/docproj.html Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk So what was the consensus on a WYSIWYG Word Processor? Have we adopted one as a possible FreeBSD standard? Is one in the ports? Can Word 6.0 be used on an interim basis (converting to RTF or something)? I saw some of the discussion a while ago, but I didn't see what the conclusions were. John F? Daniel From owner-freebsd-doc Thu Apr 18 11:45:51 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id LAA28464 for doc-outgoing; Thu, 18 Apr 1996 11:45:51 -0700 (PDT) Received: from fslg8.fsl.noaa.gov (fslg8.fsl.noaa.gov [137.75.131.171]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id LAA28457 for ; Thu, 18 Apr 1996 11:45:42 -0700 (PDT) Received: by fslg8.fsl.noaa.gov (5.57/Ultrix3.0-C) id AA26543; Thu, 18 Apr 96 18:45:39 GMT Message-Id: <9604181845.AA26543@fslg8.fsl.noaa.gov> Received: by emu.fsl.noaa.gov (1.40.112.3/16.2) id AA219793248; Thu, 18 Apr 1996 12:47:28 -0600 Date: Thu, 18 Apr 1996 12:47:28 -0600 From: Sean Kelly To: dpflag@ix.netcom.com Cc: doc@freebsd.org, dpflag@ix.netcom.com In-Reply-To: <3176036F.45E7@ix.netcom.com> (dpflag@ix.netcom.com) Subject: Re: WYSIWYG Word Processor Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk >>>>> "Daniel" == "Daniel P Pflager" writes: Daniel> So what was the consensus on a WYSIWYG Word Processor? Daniel> Have we adopted one as a possible FreeBSD standard? WYSIWYG word processor? I've been listening to the -doc list constantly for quite some time and never heard of such a topic. Daniel> Is one in the ports? I don't think so. I think the Hungry Programmers are working on one---but it's dependent on their Motif-workalike-API, so I'm not sure if it's ready yet. Daniel> Can Word 6.0 be used on an interim basis (converting to Daniel> RTF or something)? Word 6.0? Isn't that some kind of a Mac- and Windows-only product? Daniel> I saw some of the discussion a while ago, but I didn't see Daniel> what the conclusions were. John F? I don't think I ever saw the discussion. Clue me in, people! -- Sean Kelly NOAA Forecast Systems Laboratory kelly@fsl.noaa.gov Boulder Colorado USA http://www-sdd.fsl.noaa.gov/~kelly/ From owner-freebsd-doc Thu Apr 18 15:35:40 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id PAA14025 for doc-outgoing; Thu, 18 Apr 1996 15:35:40 -0700 (PDT) Received: from becker1.u.washington.edu (spaz@becker1.u.washington.edu [140.142.12.67]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id PAA14020 for ; Thu, 18 Apr 1996 15:35:38 -0700 (PDT) Received: from localhost by becker1.u.washington.edu (5.65+UW96.04/UW-NDC Revision: 2.33 ) id AA14671; Thu, 18 Apr 96 15:35:12 -0700 Date: Thu, 18 Apr 1996 15:35:11 -0700 (PDT) From: John Utz To: "Daniel P. Pflager" Cc: doc@freebsd.org Subject: Re: WYSIWYG Word Processor In-Reply-To: <3176036F.45E7@ix.netcom.com> Message-Id: Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Well there is also LyX, which uses LAtex. It is more advanced than XWord, which is the hungry guys unproduct. XWord Also requires guile, which is really big. That kinda blows. I thought i saw a little rtf wp on sunsite, i will go take a peek and get back to you all... Currently, i think the only reasonable choice would be LyX, because it seems mighty silly to be doing freebsd docs with a com product that is not free. I mean, god, i dont own word... i have works, whaddya want me to do? steal a copy? ******************************************************************************* John Utz spaz@u.washington.edu idiocy is the impulse function in the convolution of life From owner-freebsd-doc Thu Apr 18 15:47:54 1996 Return-Path: owner-doc Received: (from root@localhost) by freefall.freebsd.org (8.7.3/8.7.3) id PAA14588 for doc-outgoing; Thu, 18 Apr 1996 15:47:54 -0700 (PDT) Received: from becker1.u.washington.edu (spaz@becker1.u.washington.edu [140.142.12.67]) by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id PAA14582 for ; Thu, 18 Apr 1996 15:47:42 -0700 (PDT) Received: from localhost by becker1.u.washington.edu (5.65+UW96.04/UW-NDC Revision: 2.33 ) id AA15996; Thu, 18 Apr 96 15:47:39 -0700 Date: Thu, 18 Apr 1996 15:47:38 -0700 (PDT) From: John Utz To: doc@freebsd.org Subject: Network Fundamentals, well, Fundamentals period. Message-Id: Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-doc@freebsd.org X-Loop: FreeBSD.org Precedence: bulk Hi All; I was wondering if anybody had signed up to do the ethernet portion of the hand book? It is remarkably terse! :-) I just did an ethernet install and am now running my two machines, one running freebsd ( and sometimes win31 ) and the other running win31. I have succeeded ( with some really notable help from someone who i will ask first if wants to be named before i splash his name far and near as a helpful net guy ) in getting the win31 machine to visit and execute win31 apps on the /dos directory of the dual boot machine. All it takes is samba and the Free MSoft Lanman client. The ethernet part was pretty tuff, due to my satanic soundcard ( yes, really !! ) and made me realize that a discussion concerning interrupts, ports and probes would be useful as well. I would be willing to share, if it would be needed. Let me know, doc deity's..! ******************************************************************************* John Utz spaz@u.washington.edu idiocy is the impulse function in the convolution of life