From owner-freebsd-questions@freebsd.org Wed Oct 25 14:10:11 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 87FBBE4B52E for ; Wed, 25 Oct 2017 14:10:11 +0000 (UTC) (envelope-from zgreenfelder@gmail.com) Received: from mail-qt0-x230.google.com (mail-qt0-x230.google.com [IPv6:2607:f8b0:400d:c0d::230]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 3B9C36E9FD for ; Wed, 25 Oct 2017 14:10:11 +0000 (UTC) (envelope-from zgreenfelder@gmail.com) Received: by mail-qt0-x230.google.com with SMTP id 31so140409qtz.9 for ; Wed, 25 Oct 2017 07:10:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-transfer-encoding:content-language; bh=412e9Rq6yKQluotDnhVgdSAE3aE12mYIj266vzeQeh0=; b=e4PCLoO0FbDirzugvG3owZLY4mT9CKqa3E7Jvin2Km1lOk8/YtnLmQpbDmmQiPfmuj 65EZZDCrYJTBN+FmdFyD9DLg/c4K4f6NSbHsaGPVXCwtowgC3uPP4h4ylbz90EIhml5b M1U54Bhj3+qdckxr+cyBjkd+8TLlM1UR9fqdoRcOxA8D3sVIztWFQCcbZc9aHBF8oUch a100wk7pKDkpsGhrLrt7N6g93CvuoOj36iARZMnIB5O58TQiTVQuPvLi5J2mtDLNKCir IVyz+AprzGgrd7ibFaxCgX24XMMaayHgQf5gjBsQr5phYPtbWEDuybEPHvpX70AW2vIG LwUQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=412e9Rq6yKQluotDnhVgdSAE3aE12mYIj266vzeQeh0=; b=LVMUSqmqXAoSrchObY2ynPCFstD1vJp/xLFGD2Ffg7i63ZjqOuapHnO8FIXBcxBr5H Yok4oDlMVdMpZVqXmGU4geUsBw99oeZrQtAyxMplgzoyZhEZbcmWuCwHBnwYOSMrVONE 6jvfClNLEs9RkS89nloiGOl58a8IQpGhnREpDVG3SZDSEh4LIGVPYMiTpSuRsRf/P3hU sorbCZoK5OaptKjtypM2gpEOsEXV2i2fgxuItEkOoLjn8+v4tdTi0Rtgt5YlthgOn4ko c0xFgpJ4/DXuMjmMwpka/x85ej7ATfHfyGnHrnkZfRWFGGQD4w8fwDw6gXdetXymTn+6 e4nQ== X-Gm-Message-State: AMCzsaX9w6oaObBaLAR4eVPdXQ12IE3IpN5mXoY06ikPfvpZCC/63iM4 FhrF7Vy4Mir+u0GhYzGj1NMAeYhx X-Google-Smtp-Source: ABhQp+S9dL52OGX7D3trkh7Gjomb7vi+0+QRyIlO8ZOnphFLgGV3+hDbwRHRCvl9EuUWBff2jFoJ4g== X-Received: by 10.237.38.36 with SMTP id z33mr15548483qtc.258.1508940609873; Wed, 25 Oct 2017 07:10:09 -0700 (PDT) Received: from [192.168.10.31] (pool-71-178-8-115.washdc.fios.verizon.net. [71.178.8.115]) by smtp.gmail.com with ESMTPSA id u14sm1997468qtc.84.2017.10.25.07.10.08 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 25 Oct 2017 07:10:08 -0700 (PDT) Subject: Re: A request to segregate man pages for shell built-ins To: freebsd-questions@freebsd.org References: <15f52853ee8.2787.c09309b3b9b6c7ba483efefa0c51d672@rail.eu.org> <20171025152240.b83f20e5.freebsd@edvax.de> From: zep Message-ID: <590388f5-6c80-fe60-1370-a071ffef5649@gmail.com> Date: Wed, 25 Oct 2017 10:10:05 -0400 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.4.0 MIME-Version: 1.0 In-Reply-To: <20171025152240.b83f20e5.freebsd@edvax.de> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Content-Language: en-US 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 14:10:11 -0000 On 10/25/2017 09:22 AM, Polytropon wrote: > On Wed, 25 Oct 2017 08:03:03 +0000, Manish Jain wrote: >> >> On 10/25/17 13:23, Erwan DAVID wrote: >>> That would mean doing a new section per shell eg (1bash) (1csh) (1zsh) >>> each shell has its own builtins, Hicham can differ (compare set in bash >>> and csh ) >> Perhaps a new, unique section of man pages (something like section 99) >> implemented for sh only and which can be called by any shell with the >> same syntax : 'man 99 set' > Or like pkg's "sub-manpages", with a hyphen: > > % man echo-csh > > compared to > > % man test-bash > > And for "identical implementations", compound manuals just as if > you'd use "man 3 malloc" or "man 3 calloc" to take you to the same > manual page. > you could also build a 'smarter' man in such a case - e.g. as a shell script wrapper kinda thing, it could do a which first, find out if the shell you're currently running it from has a builtin, if there's a binary, then chose the right one for how it's called and possibly include a caveat about other versions. not that I'm saying I'm ready to take on such a task, just offering some suggestions. --