Date: Wed, 25 Oct 2017 15:58:24 +0200 From: Polytropon <freebsd@edvax.de> To: Rafal Lukawiecki <raf@rafal.net> Cc: "James B. Byrne via freebsd-questions" <freebsd-questions@freebsd.org> 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: <VI1PR02MB1200817E0E2CDD2A2A42E1A5F6440@VI1PR02MB1200.eurprd02.prod.outlook.com> <f88cd63e-3cbc-4463-5219-99d204742b85@FreeBSD.org> <6f62db58-8220-0fe4-133b-410da2f58579@qeng-ho.org> <f88bce52-b120-c9cf-05bf-3c99ab99c522@FreeBSD.org> <57bd52d4-bf61-454f-1b11-d7f96aa1c049@sjmulder.nl> <3A716B0D-8291-4CB1-9DE5-370ABA4CF583@rafal.net>
next in thread | previous in thread | raw e-mail | index | archive | help
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, ...
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20171025155824.f009b7a9.freebsd>