From owner-freebsd-questions@freebsd.org Wed Oct 25 13:49:42 2017 Return-Path: Delivered-To: freebsd-questions@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 9C1A5E4ACE0 for ; Wed, 25 Oct 2017 13:49:42 +0000 (UTC) (envelope-from raf@rafal.net) Received: from mxout-08.mxes.net (mxout-08.mxes.net [216.86.168.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 7605B6DF91 for ; Wed, 25 Oct 2017 13:49:41 +0000 (UTC) (envelope-from raf@rafal.net) Received: from [192.168.40.37] (86-40-118-125-dynamic.agg2.bri.bbh-prp.eircom.net [86.40.118.125]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.mxes.net (Postfix) with ESMTPSA id 26F57509BF for ; Wed, 25 Oct 2017 09:49:28 -0400 (EDT) From: Rafal Lukawiecki Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Mime-Version: 1.0 (Mac OS X Mail 11.0 \(3445.1.7\)) Subject: Re: A request to segregate man pages for shell built-ins Date: Wed, 25 Oct 2017 14:49:26 +0100 References: <6f62db58-8220-0fe4-133b-410da2f58579@qeng-ho.org> <57bd52d4-bf61-454f-1b11-d7f96aa1c049@sjmulder.nl> To: "James B. Byrne via freebsd-questions" In-Reply-To: <57bd52d4-bf61-454f-1b11-d7f96aa1c049@sjmulder.nl> Message-Id: <3A716B0D-8291-4CB1-9DE5-370ABA4CF583@rafal.net> X-Mailer: Apple Mail (2.3445.1.7) X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 25 Oct 2017 13:49:42 -0000 For what it is worth, I would have found this segregated access to man = for shell built-ins very useful in the last two months, as I have been = rapidly re-skilling from bash/Linux to sh/FreeBSD. I spent too much time = browsing the net while, ideally, most of it could have come from man. Anything that makes it easier to get up to speed with sh is going to = make FreeBSD more accessible, especially to those coming from bash, in = my opinion. However, it is also quite useful to have a single, long document on sh, = which is capable of covering the more general issues such as variable = scope and flow control. I wonder if there is a risk that a segregated = approach could remove that important benefit. -- Rafal Lukawiecki Data Scientist=20 Project Botticelli Ltd