From owner-freebsd-doc@FreeBSD.ORG Sat Dec 1 06:10:00 2012 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id B7D271DD for ; Sat, 1 Dec 2012 06:10:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 8CB6F8FC0C for ; Sat, 1 Dec 2012 06:10:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qB16A0i6044563 for ; Sat, 1 Dec 2012 06:10:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.5/8.14.5/Submit) id qB16A0QL044562; Sat, 1 Dec 2012 06:10:00 GMT (envelope-from gnats) Resent-Date: Sat, 1 Dec 2012 06:10:00 GMT Resent-Message-Id: <201212010610.qB16A0QL044562@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, Derek Wood Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 939741CC for ; Sat, 1 Dec 2012 06:08:11 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22]) by mx1.freebsd.org (Postfix) with ESMTP id 7BF088FC13 for ; Sat, 1 Dec 2012 06:08:11 +0000 (UTC) Received: from red.freebsd.org (localhost [127.0.0.1]) by red.freebsd.org (8.14.5/8.14.5) with ESMTP id qB168BGH016462 for ; Sat, 1 Dec 2012 06:08:11 GMT (envelope-from nobody@red.freebsd.org) Received: (from nobody@localhost) by red.freebsd.org (8.14.5/8.14.5/Submit) id qB168BAd016461; Sat, 1 Dec 2012 06:08:11 GMT (envelope-from nobody) Message-Id: <201212010608.qB168BAd016461@red.freebsd.org> Date: Sat, 1 Dec 2012 06:08:11 GMT From: Derek Wood To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/174029: [patch] faq: update #minimal-sh X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 01 Dec 2012 06:10:00 -0000 >Number: 174029 >Category: docs >Synopsis: [patch] faq: update #minimal-sh >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Dec 01 06:10:00 UTC 2012 >Closed-Date: >Last-Modified: >Originator: Derek Wood >Release: >Organization: >Environment: >Description: The attached patch updates the #minimal-sh question in the FAQ to link to the sh(1) man page, include the fact that tcsh(1) is in the base FreeBSD installation (and link to its man page), and refill the text of the question to be 70 columns wide. >How-To-Repeat: >Fix: Patch attached with submission follows: Index: en_US.ISO8859-1/books/faq/book.xml =================================================================== --- en_US.ISO8859-1/books/faq/book.xml (revision 40165) +++ en_US.ISO8859-1/books/faq/book.xml (working copy) @@ -3975,8 +3975,8 @@ - Why is /bin/sh so minimal? Why does - &os; not use bash or another + Why is /bin/sh so minimal? Why + does &os; not use bash or another shell? @@ -3986,25 +3986,26 @@ The more complicated answer: many people need to write shell scripts which will be portable across many systems. - That is why &posix; specifies the shell and utility commands - in great detail. Most scripts are written in Bourne shell, - and because several important programming interfaces - (&man.make.1;, &man.system.3;, &man.popen.3;, and analogues - in higher-level scripting languages like Perl and Tcl) are - specified to use the Bourne shell to interpret commands. - Because the Bourne shell is so often and widely used, it is - important for it to be quick to start, be deterministic in - its behavior, and have a small memory footprint. + That is why &posix; specifies the shell and utility + commands in great detail. Most scripts are written in + Bourne shell (&man.sh.1;), and because several important + programming interfaces (&man.make.1;, &man.system.3;, + &man.popen.3;, and analogues in higher-level scripting + languages like Perl and Tcl) are specified to use the + Bourne shell to interpret commands. Because the Bourne + shell is so often and widely used, it is important for it + to be quick to start, be deterministic in its behavior, + and have a small memory footprint. The existing implementation is our best effort at meeting as many of these requirements simultaneously as we - can. In order to keep /bin/sh small, we - have not provided many of the convenience features that - other shells have. That is why the Ports Collection - includes more featureful shells like + can. In order to keep /bin/sh small, + we have not provided many of the convenience features that + other shells have. That is why &os; and the Ports + Collection include more featureful shells like bash, scsh, - tcsh, and zsh. (You - can compare for yourself the memory utilization of all these + &man.tcsh.1;, and zsh. (You can + compare for yourself the memory utilization of all these shells by looking at the VSZ and RSS columns in a ps listing.) >Release-Note: >Audit-Trail: >Unformatted: