From owner-freebsd-doc@FreeBSD.ORG Sun Jan 5 04:00:00 2014 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id CC3DE1D9 for ; Sun, 5 Jan 2014 04:00:00 +0000 (UTC) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 9109E1CFD for ; Sun, 5 Jan 2014 04:00:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id s05400Vk075599 for ; Sun, 5 Jan 2014 04:00:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id s05400uM075596; Sun, 5 Jan 2014 04:00:00 GMT (envelope-from gnats) Resent-Date: Sun, 5 Jan 2014 04:00:00 GMT Resent-Message-Id: <201401050400.s05400uM075596@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, "Ronald F.Guilmette" Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 19B2A191 for ; Sun, 5 Jan 2014 03:51:11 +0000 (UTC) Received: from outgoing.tristatelogic.com (segfault.tristatelogic.com [69.62.255.118]) by mx1.freebsd.org (Postfix) with ESMTP id ED7791CDA for ; Sun, 5 Jan 2014 03:51:09 +0000 (UTC) Received: by segfault.tristatelogic.com (Postfix, from userid 1237) id 9A1FC3B29A; Sat, 4 Jan 2014 19:45:19 -0800 (PST) Message-Id: <20140105034519.9A1FC3B29A@segfault.tristatelogic.com> Date: Sat, 4 Jan 2014 19:45:19 -0800 (PST) From: "Ronald F.Guilmette" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/185481: sh/bash Parameter Expansion +/- syntax not documented Cc: rfg@tristatelogic.com X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list Reply-To: "Ronald F.Guilmette" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 05 Jan 2014 04:00:00 -0000 >Number: 185481 >Category: docs >Synopsis: sh/bash Parameter Expansion +/- syntax not documented >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sun Jan 05 04:00:00 UTC 2014 >Closed-Date: >Last-Modified: >Originator: Ronald F. Guilmette >Release: FreeBSD 9.1-RELEASE amd64 >Organization: entr0py >Environment: FreeBSD 9.1-RELEASE FreeBSD amd64 >Description: Both /bin/sh and /usr/local/bin/bash appear to correctly implement the following forms of shell parameter expansion syntax, as required by POSIX ISO/IEC 9945-2 & ANSI/IEEE Std 1003.3 (1993-12-22): ${parameter-word} ${parameter+word} These forms are not however documented in the "Parameter Expansion" sections of either the man page for sh or the man page for bash. (I should perhaps be filing this PR as two separate PRs, one for sh and one for bash, and will do so upon request. However my hope is that whoever fixes one of the two relevant man pages will also have the courtesy to fix the other as well.) Note: The semantics of the two forms of parameter expansion syntax mentioned above are helpfully and briefly described on the following web page: http://serverfault.com/questions/7503/how-to-determine-if-a-bash-variable-is-empty >How-To-Repeat: man 1 sh man 1 bash >Fix: The author of this PR will provide diffs/patches for the relevant man pages upon request, however the fix in each case (sh and bash) should be both trivial and obvious, I believe. >Release-Note: >Audit-Trail: >Unformatted: