From owner-freebsd-questions@freebsd.org Wed Oct 25 09:08:46 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 530D2E438F9 for ; Wed, 25 Oct 2017 09:08:46 +0000 (UTC) (envelope-from matthew@FreeBSD.org) Received: from smtp.infracaninophile.co.uk (smtp.infracaninophile.co.uk [IPv6:2001:8b0:151:1:c4ea:bd49:619b:6cb3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "smtp.infracaninophile.co.uk", Issuer "infracaninophile.co.uk" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 159C76333E for ; Wed, 25 Oct 2017 09:08:46 +0000 (UTC) (envelope-from matthew@FreeBSD.org) Received: from leaf.local (unknown [88.202.132.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: m.seaman@infracaninophile.co.uk) by smtp.infracaninophile.co.uk (Postfix) with ESMTPSA id 7F38C14FD for ; Wed, 25 Oct 2017 09:08:44 +0000 (UTC) Authentication-Results: smtp.infracaninophile.co.uk; dmarc=none (p=none dis=none) header.from=FreeBSD.org Subject: Re: A request to segregate man pages for shell built-ins To: freebsd-questions@freebsd.org References: <6f62db58-8220-0fe4-133b-410da2f58579@qeng-ho.org> <57bd52d4-bf61-454f-1b11-d7f96aa1c049@sjmulder.nl> From: Matthew Seaman Message-ID: Date: Wed, 25 Oct 2017 10:08:44 +0100 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:52.0) Gecko/20100101 Thunderbird/52.4.0 MIME-Version: 1.0 In-Reply-To: <57bd52d4-bf61-454f-1b11-d7f96aa1c049@sjmulder.nl> Content-Type: text/plain; charset=utf-8 Content-Language: en-GB Content-Transfer-Encoding: 7bit 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 09:08:46 -0000 On 25/10/2017 09:56, Sijmen J. Mulder wrote: > Whilst I do appreciate builtin(1)'s comprehensiveness I too find it hard > to nagivate. > > Op 25-10-2017 om 10:10 schreef Matthew Seaman: >> In the case of eg. echo(1), I'd be happy to see the existing page for >> the stand-alone echo refactored to cover all of the different flavours >> of echo -- the behaviour is much the same in most use cases -- plus some >> discussion on how the variants differ. > > This seems like a good solution. But, how would shells in ports deal > with this? A builtin(1)-like foosh(1), or foosh_echo(1), foosh_case(1), > etc? Outside projects will do their own thing. We can (as the FreeBSD project) provide our own man pages for a FreeBSD port where we think that what upstream provides is deficient, and we can submit those pages upstream as good citizens are supposed to, but again, this relies entirely on someone volunteering to step up and do the work. However, it's unlikely that we'd want to try and integrate or combine man pages from external projects with base system manpages in any significant way. That's far too complex and fragile to be worth the effort. /usr/share/man and /usr/local/man are different worlds. Cheers, Matthew