From owner-freebsd-doc  Fri Oct 27  5: 6:46 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (unknown [194.128.198.234])
	by hub.freebsd.org (Postfix) with ESMTP id 876D037B479
	for <freebsd-doc@freebsd.org>; Fri, 27 Oct 2000 05:06:42 -0700 (PDT)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.11.0/8.11.0) id e9RC4tW41027;
	Fri, 27 Oct 2000 13:04:55 +0100 (BST)
	(envelope-from nik)
Date: Fri, 27 Oct 2000 13:04:53 +0100
From: Nik Clayton <nik@freebsd.org>
To: Jamie Heckford <heckfordj@psi-domain.co.uk>
Cc: freebsd-doc@freebsd.org
Subject: Re: documentation project
Message-ID: <20001027130452.C1773@canyon.nothing-going-on.org>
References: <00102712081300.00205@freefire.psi-domain.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5i
In-Reply-To: <00102712081300.00205@freefire.psi-domain.co.uk>; from heckfordj@psi-domain.co.uk on Fri, Oct 27, 2000 at 12:07:23PM +0100
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

Jamie,

On Fri, Oct 27, 2000 at 12:07:23PM +0100, Jamie Heckford wrote:
> I would be interested in writing documentation, do you have a "to-do" 
> or "wish list"?

[...]

> Jamie Heckford
> Chief Network Engineer
> Psi-Domain - Innovative Linux Solutions. Ask Us How.

I'd love to see a "FreeBSD for Linux users" document, that goes through how
a FreeBSD box is configured as compared to a Linux box.

For example.

   Section 16     Users, groups, and passwords

     FreeBSD has users, groups, and passwords, as do all Unix variants.
     Passwords are stored in /etc/master.passwd, while the other user
     information is stored /etc/passwd.  Group information is stored in
     /etc/group.

     16.1  Editing /etc/passwd

     Don't.  Because user information is stored in /etc/master.passwd and
     /etc/passwd, if you just edit one or the other they will get out of
     sync.  Instead, use the vipw(8) command, which will launch $EDITOR.

     When you have finished editing the password file, vipw(8) will ensure
     that changes you make are propogated correctly.

     16.2  Adding a new user

     On Redhat you would use ...

     On Debian you would use ...

     On SuSE you would use ...

     On FreeBSD, use the adduser(1) command.  A typical run would be ...

And so on, and so forth.

You don't need to write the whole thing.  Frankly, right now I'd just like
to a see skeleton document with some bits filled in.  Other people can
fill in specific sections as necessary.

How does that sound?

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message