From owner-freebsd-questions@freebsd.org  Thu Oct 12 18:09:52 2017
Return-Path: <owner-freebsd-questions@freebsd.org>
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 77AA8E30B74
 for <freebsd-questions@mailman.ysv.freebsd.org>;
 Thu, 12 Oct 2017 18:09:52 +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 E4D522515
 for <freebsd-questions@freebsd.org>; Thu, 12 Oct 2017 18:09:51 +0000 (UTC)
 (envelope-from freebsd@edvax.de)
Received: from mx01.qsc.de ([213.148.129.14]) by mailrelay11.qsc.de;
 Thu, 12 Oct 2017 20:09:43 +0200
Received: from r56.edvax.de (port-92-195-127-141.dynamic.qsc.de
 [92.195.127.141])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by mx01.qsc.de (Postfix) with ESMTPS id 4F79F3CBF9;
 Thu, 12 Oct 2017 20:09:42 +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 v9CI9fv1002069;
 Thu, 12 Oct 2017 20:09:41 +0200 (CEST)
 (envelope-from freebsd@edvax.de)
Date: Thu, 12 Oct 2017 20:09:41 +0200
From: Polytropon <freebsd@edvax.de>
To: Yuri Pankov <yuripv@gmx.com>
Cc: "Sijmen J. Mulder" <ik@sjmulder.nl>, freebsd-questions@freebsd.org
Subject: Re: Should I use mdoc for user programs?
Message-Id: <20171012200941.49fed687.freebsd@edvax.de>
In-Reply-To: <ad6d583f-db2e-a149-105d-b7c3b8894959@gmx.com>
References: <cd1d3215-bfcd-57bf-89ec-c78981c60381@sjmulder.nl>
 <ad6d583f-db2e-a149-105d-b7c3b8894959@gmx.com>
Reply-To: Polytropon <freebsd@edvax.de>
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 9A86D6A359F
X-cloud-security-connect: mx01.qsc.de[213.148.129.14], TLS=1, IP=213.148.129.14
X-cloud-security: scantime:.1540
X-BeenThere: freebsd-questions@freebsd.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: User questions <freebsd-questions.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-questions/>
List-Post: <mailto:freebsd-questions@freebsd.org>
List-Help: <mailto:freebsd-questions-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-questions>, 
 <mailto:freebsd-questions-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 12 Oct 2017 18:09:52 -0000

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).


-- 
Polytropon
Magdeburg, Germany
Happy FreeBSD user since 4.0
Andra moi ennepe, Mousa, ...