From owner-freebsd-questions@freebsd.org Thu Oct 12 18:40:00 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 BF49DE31950 for ; Thu, 12 Oct 2017 18:40:00 +0000 (UTC) (envelope-from yuripv@gmx.com) Received: from mout.gmx.net (mout.gmx.net [212.227.15.15]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "mout.gmx.net", Issuer "TeleSec ServerPass DE-2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 23BE03AFB for ; Thu, 12 Oct 2017 18:39:59 +0000 (UTC) (envelope-from yuripv@gmx.com) Received: from procyon.local ([5.138.255.62]) by mail.gmx.com (mrgmx003 [212.227.17.184]) with ESMTPSA (Nemesis) id 0LjZhg-1dRBic2EI4-00bYs9; Thu, 12 Oct 2017 20:39:54 +0200 Subject: Re: Should I use mdoc for user programs? To: Polytropon Cc: freebsd-questions@freebsd.org, "Sijmen J. Mulder" References: <20171012200941.49fed687.freebsd@edvax.de> From: Yuri Pankov Message-ID: <696e0fb1-7cbb-31d2-2105-8166a4c3d53e@gmx.com> Date: Thu, 12 Oct 2017 21:39:53 +0300 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: <20171012200941.49fed687.freebsd@edvax.de> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Provags-ID: V03:K0:1t7td4NQpw2MtXLnJ3f7olJh+F2Z5Ic5uvUTDVxDVqk7Dkm1Jev 9WBJF5mVUv4u+lrL1PwC8SaNAUkXunrLpZOMz/JQ4IYkIUGFK16HgaJIQdUQ83b2D1cyQ9t 2gC90f08LtyiKYz4ZPynRb2SdtK7yA8gcFSeJ8CNrXfrcSOV2zH/CiRZCzL+gHXsw78ROFm r+0BZwTB+6Wm7c5okP0sg== X-UI-Out-Filterresults: notjunk:1;V01:K0:KbNnHYOPbHo=:+GHwNmd6/zLkHKcqs6M3ru rxrgpzDijpR2GZojc14JnWdKEtD2Zh/rcYF+iCcNX+0MbnXQmgHkoKjcTAEhM8hHomaQrgSB3 IePDvJ2eG5VLTnamkflyvKC5TUDnx0tdfIQYVctTxVkQZl7majl017moKrXeEGwbH3Abf59C/ 7YjnLlKUTvmrWrq0YqY1TqgAtwr+v8OA5ss8OTzw1pz+9sj8yNs1KMHQqkL86RorjmLp63ICr CAhmCbKTZqRB60LWCiSNByXqrE96tGdW1vNe/HS4iGtigEFyO+t1s63H3740luisrZdd7MGBn 26vJxOvrkGlXrwl4oTieeOaTDjdGVHPBhuF1h/P8F09HHg24+NOrm5fByGWEZgzuTxxGQYt3W UBX4+UoktFKRxU4gOtJSDk2C9//JP6Sx06q/3hX+phBq5RvB8L+LB+huCqt4Cm7SpdzLYuw85 kotO/84f3aThdUO79J7fccQJzDwVxlFpInoLTF0Qt2Wq2MMtUTloTAj2NbPaQVjiE/aeZj77j x7OeP6rv9DhsdJhYc3inl39R4NWQrQF6quoR2bfDvffC2scOpHMejbqE4MT4CBkmeikwhTdh/ PQ+RM20jPqW63YyH5hkIsKFGMvEwxmiZYOfuJPMWtQpUCuxBY25/zq1ycD0zVVjael6zC5jif uHcoC61WivIbYxYM/2Ue9Z6qrFZCdb7FlsTdGHV0fpNmbwgeiHx+J/OL9tGUtWaqSU601AD73 td0k2Q2qIU88habMG9eBMRCUbnxfe/FdsRbO3EKhKv1TVL9XxwEV9XOhbmvZpvyPv8m3GiWEL c06vMdpYT4AqqtQFqiBx1mSyuP3ii6Cr1hOgDpZmMgITT/8uNI= 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: Thu, 12 Oct 2017 18:40:00 -0000 On Thu, 12 Oct 2017 20:09:41 +0200, Polytropon wrote: > On Thu, 12 Oct 2017 16:18:28 +0300, Yuri Pankov wrote: >> On Thu, 12 Oct 2017 11:02:49 +0200, Sijmen J. Mulder wrote: >> [...] >>> I noticed that the required .Os macro (man 7 mdoc) outputs "FreeBSD >>> General Commands Manual" which does not seem appropriate. >> >> It's not about the .Os macro, rather it's man-section-to-name mapping >> done by the formatter used, i.e. when using mandoc(1), on FreeBSD >> section 1 man pages would say "FreeBSD General Commands Manual", on >> illumos exactly the *same* man page would say just "User Commands" (for >> mandoc this can be customized editing one of the source files currently). > > According to "man mdoc", it's easy to redefine .Dt at the beginning > of the document (just like .Dt or Dd). Indeed, my answer was more about that output shouldn't stop the OP from using mdoc. And redefining the section name rarely serves any purpose; if you absolutely need it, go with a new section (yes, I know it's bad).