From nobody@FreeBSD.org  Tue Oct 26 12:58:48 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id A82781065697
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 26 Oct 2010 12:58:48 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 964758FC0C
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 26 Oct 2010 12:58:48 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o9QCwmes034636
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 26 Oct 2010 12:58:48 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o9QCwmoL034635;
	Tue, 26 Oct 2010 12:58:48 GMT
	(envelope-from nobody)
Message-Id: <201010261258.o9QCwmoL034635@www.freebsd.org>
Date: Tue, 26 Oct 2010 12:58:48 GMT
From: Arseny Nasokin <eirnym@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: pw.conf(5) doesn't define format for file clearly
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         151752
>Category:       docs
>Synopsis:       pw.conf(5) doesn't define format for file clearly
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 26 13:00:18 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Arseny Nasokin
>Release:        
>Organization:
>Environment:
FreeBSD notebook 9.0-CURRENT FreeBSD 9.0-CURRENT #0 r214288: Mon Oct 25 00:26:24 MSD 2010     root@builder.eroese.org:/usr/obj/i386.i386/usr/src/sys/GENERIC  i386

>Description:
You can see following text in this manual about file format:
===%<---
     Each line in /etc/pw.conf is treated either a comment or as configuration
     data; blank lines and lines commencing with a `#' character are consid-
     ered comments, and any remaining lines are examined for a leading key-
     word, followed by corresponding data.
--->%===
what means "leading key-word, followed by corresponding data"?
for example how anybody can recognize it(common usages):
1) Keyword:Data
2) Keyword:"Data"
3) Keyword:'Data'
4) Keyword=Data
5) Keyword="Data"
6) Keyword='Data'
7) ...

what is delimiter? should/must quotes surround data? which quotes should be used? and so on

Also it is unclear with data for shells keyword: can this line contains any spaces between shell names?


>How-To-Repeat:
see pw.conf(5) and try to create new pw.conf from scratch without using pw(8) useradd -D command
>Fix:
describe format more clearly.

>Release-Note:
>Audit-Trail:
>Unformatted:
