From owner-freebsd-questions@freebsd.org  Thu Oct 12 09:02:47 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 99004E48D8A
 for <freebsd-questions@mailman.ysv.freebsd.org>;
 Thu, 12 Oct 2017 09:02:47 +0000 (UTC) (envelope-from ik@sjmulder.nl)
Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com
 [66.111.4.25])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 6E05E6D9CF
 for <freebsd-questions@freebsd.org>; Thu, 12 Oct 2017 09:02:46 +0000 (UTC)
 (envelope-from ik@sjmulder.nl)
Received: from compute3.internal (compute3.nyi.internal [10.202.2.43])
 by mailout.nyi.internal (Postfix) with ESMTP id 63A8E20BF9
 for <freebsd-questions@freebsd.org>; Thu, 12 Oct 2017 05:02:45 -0400 (EDT)
Received: from frontend2 ([10.202.2.161])
 by compute3.internal (MEProxy); Thu, 12 Oct 2017 05:02:45 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sjmulder.nl; h=
 content-transfer-encoding:content-type:date:from:message-id
 :mime-version:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s=
 mesmtp; bh=/5rRjWEagMBQmAJTMA17yppuMCercpfFfxyZ98a37z0=; b=WgUNm
 xLpidJ/5IOThbku4Kz5HAkYvcsRGvVPfApqt9iE9UaUWmq3LHfIf7xFPFnpEam6P
 aTtSWG3C1/WmbMWlR8RHJvQxNUm8MdA8Ls7dD2dOLZepl1fs/9OGI1nChsS8NrJK
 UwpbLLM3gpmEExfua2Xmah1PqdB7vuCV/OpDkk=
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
 messagingengine.com; h=content-transfer-encoding:content-type
 :date:from:message-id:mime-version:subject:to:x-me-sender
 :x-me-sender:x-sasl-enc; s=fm1; bh=/5rRjWEagMBQmAJTMA17yppuMCerc
 pfFfxyZ98a37z0=; b=I++2lWS/ABvNTqaqSWa9WIJx9WPVGnGQXZKPOnZFachkL
 3nV/5Ws11cSdLzO+s6wSZPFinxCzEkjCDfB+1oeJfP/itQTb4v7nFns4qi+YDIWR
 kGRvIupJkJPPoUuHpZC6JlRFZsmJxfig0lpjk67kwnBLQmLgoGxSOas+96tNbo+E
 7m0qbiPbSROgxmeFE+ZtGycjada4G4PofMpDhqILzR60I5Z2YTXI9ucQ6/9ArBur
 HA5W0lHjEmznJoTzjLIoLrEpXoY6pmlpWAqTreMAyuK8mt1VPt2qzJ/DZEYrTyKR
 ErB8O3P7ep+O6zeWcPGZjbD8CGyQQVuQJZmdeoGuQ==
X-ME-Sender: <xms:tS_fWTHkgM-Sw-qTos5on16w5R-tPqL3CQs-5njxoTOEtiuC3-rtLg>
Received: from [10.50.6.46] (unknown [87.213.224.178])
 by mail.messagingengine.com (Postfix) with ESMTPA id E73E124732
 for <freebsd-questions@freebsd.org>; Thu, 12 Oct 2017 05:02:44 -0400 (EDT)
To: freebsd-questions@freebsd.org
From: "Sijmen J. Mulder" <ik@sjmulder.nl>
Subject: Should I use mdoc for user programs?
Message-ID: <cd1d3215-bfcd-57bf-89ec-c78981c60381@sjmulder.nl>
Date: Thu, 12 Oct 2017 11:02:49 +0200
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101
 Thunderbird/52.3.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Content-Language: nl
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 09:02:47 -0000

Hi,

Is it considered bad form to use mdoc, rather than some other man 
format, for documenting non-system programs?

I noticed that the required .Os macro (man 7 mdoc) outputs "FreeBSD 
General Commands Manual" which does not seem appropriate.

Regards,
Sijmen