From owner-freebsd-questions@freebsd.org Wed Oct 25 13:59:05 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 AE998E4B0A5 for ; Wed, 25 Oct 2017 13:59:05 +0000 (UTC) (envelope-from freebsd@edvax.de) Received: from mailrelay11.qsc.de (mailrelay11.qsc.de [212.99.187.252]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "*.antispameurope.com", Issuer "TeleSec ServerPass DE-2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 2294C6E518 for ; Wed, 25 Oct 2017 13:59:04 +0000 (UTC) (envelope-from freebsd@edvax.de) Received: from mx01.qsc.de ([213.148.129.14]) by mailrelay11.qsc.de; Wed, 25 Oct 2017 15:58:28 +0200 Received: from r56.edvax.de (port-92-195-74-193.dynamic.qsc.de [92.195.74.193]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx01.qsc.de (Postfix) with ESMTPS id C78913CBF9; Wed, 25 Oct 2017 15:58:25 +0200 (CEST) Received: from r56.edvax.de (localhost [127.0.0.1]) by r56.edvax.de (8.14.5/8.14.5) with SMTP id v9PDwO2C002628; Wed, 25 Oct 2017 15:58:24 +0200 (CEST) (envelope-from freebsd@edvax.de) Date: Wed, 25 Oct 2017 15:58:24 +0200 From: Polytropon To: Rafal Lukawiecki Cc: "James B. Byrne via freebsd-questions" Subject: Re: A request to segregate man pages for shell built-ins Message-Id: <20171025155824.f009b7a9.freebsd@edvax.de> In-Reply-To: <3A716B0D-8291-4CB1-9DE5-370ABA4CF583@rafal.net> References: <6f62db58-8220-0fe4-133b-410da2f58579@qeng-ho.org> <57bd52d4-bf61-454f-1b11-d7f96aa1c049@sjmulder.nl> <3A716B0D-8291-4CB1-9DE5-370ABA4CF583@rafal.net> Reply-To: Polytropon Organization: EDVAX X-Mailer: Sylpheed 3.1.1 (GTK+ 2.24.5; i386-portbld-freebsd8.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-cloud-security-sender: freebsd@edvax.de X-cloud-security-recipient: freebsd-questions@freebsd.org X-cloud-security-Virusscan: CLEAN X-cloud-security-disclaimer: This E-Mail was scanned by E-Mailservice on mailrelay11.qsc.de with 49C1B6A4AF5 X-cloud-security-connect: mx01.qsc.de[213.148.129.14], TLS=1, IP=213.148.129.14 X-cloud-security: scantime:1.448 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:59:05 -0000 On Wed, 25 Oct 2017 14:49:26 +0100, Rafal Lukawiecki wrote: > 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. This probably could be solved by incorporating shell-specific sections and "SEE ALSO" into the manpages which already exist for external commands (e. g., "man test"), and adding new pages for builtins (one could be "man for" or "man while" where there is a difference in sh/bash and csh syntax and usage). The general coverage provided by "man sh", "man csh" or "man bash" should not be distributed among "little man pages", as this also makes searching for context problematic (simply because what you're searching for is in another manpage, not in the one you validly used as an entry point). -- Polytropon Magdeburg, Germany Happy FreeBSD user since 4.0 Andra moi ennepe, Mousa, ...