From owner-freebsd-doc@FreeBSD.ORG Tue Oct 26 13:00:23 2010 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 65D4310656AE for ; Tue, 26 Oct 2010 13:00:23 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 282808FC08 for ; Tue, 26 Oct 2010 13:00:23 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id o9QD0I39038140 for ; Tue, 26 Oct 2010 13:00:18 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id o9QD0IbS038131; Tue, 26 Oct 2010 13:00:18 GMT (envelope-from gnats) Resent-Date: Tue, 26 Oct 2010 13:00:18 GMT Resent-Message-Id: <201010261300.o9QD0IbS038131@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Arseny Nasokin Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id A82781065697 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/151752: pw.conf(5) doesn't define format for file clearly X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 26 Oct 2010 13:00:23 -0000 >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: