From owner-freebsd-questions@FreeBSD.ORG  Sat Oct 11 18:35:30 2014
Return-Path: <owner-freebsd-questions@FreeBSD.ORG>
Delivered-To: freebsd-questions@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 668A946C
 for <freebsd-questions@freebsd.org>; Sat, 11 Oct 2014 18:35:30 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 12DFE914
 for <freebsd-questions@freebsd.org>; Sat, 11 Oct 2014 18:35:29 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.9/8.14.9) with ESMTP id s9BIZRSE029311
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sat, 11 Oct 2014 12:35:28 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.9/8.14.9/Submit) with ESMTP id s9BIZR5A029308;
 Sat, 11 Oct 2014 12:35:27 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sat, 11 Oct 2014 12:35:27 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: "William A. Mahaffey III" <wam@hiwaay.net>
Subject: Re: sh man page ....
In-Reply-To: <54394775.9020303@hiwaay.net>
Message-ID: <alpine.BSF.2.11.1410111225240.17576@wonkity.com>
References: <5437FB8B.9080008@hiwaay.net> <20141011142538.45c9f45a@elena.home>
 <54394775.9020303@hiwaay.net>
User-Agent: Alpine 2.11 (BSF 23 2013-08-11)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sat, 11 Oct 2014 12:35:28 -0600 (MDT)
Cc: freebsd-questions@freebsd.org
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.18-1
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions/>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 11 Oct 2014 18:35:30 -0000

On Sat, 11 Oct 2014, William A. Mahaffey III wrote:

> I am only whining about the 'oversight' (my word) 
> since I came in the other direction (bash 1st, under Linux, followed by sh 
> under FBSD). I am making the suggestion from a purely logistical POV, since 
> bash is pretty widespread, & people coming to FBSD from Linux may bring their 
> bash scripts & such w/ them.

This is entirely reasonable.  We have programs that accept different 
options for Linux compatibility like find(1).  I'm pretty certain that 
we have man pages that document differences between native FreeBSD 
programs and others.  The documentation is there to help the user. 
Documenting differences and incompatibilities certainly falls into 
that category, particularly for the confusion surrounding a real sh(1) 
versus bash pretending to be sh.