From owner-svn-src-all@freebsd.org Sun Apr 19 23:59:49 2020 Return-Path: Delivered-To: svn-src-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id B5E442AF61C; Sun, 19 Apr 2020 23:59:49 +0000 (UTC) (envelope-from cse.cem@gmail.com) Received: from mail-oo1-f65.google.com (mail-oo1-f65.google.com [209.85.161.65]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) server-signature RSA-PSS (4096 bits) client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1O1" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4956JP44YJz4FM5; Sun, 19 Apr 2020 23:59:49 +0000 (UTC) (envelope-from cse.cem@gmail.com) Received: by mail-oo1-f65.google.com with SMTP id g14so1738326ooa.4; Sun, 19 Apr 2020 16:59:49 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:reply-to :from:date:message-id:subject:to:cc; bh=OAvZqJ5DDepgmLJQTCLa/wR0N/CV6sM5OU1LUp4v+RU=; b=P+fXfj4NF6QzDV+QC5YEu0JS3sIAVH925uDHoZXGMuihw7DsbXz+1Oidww4B2mzcVB XhxA3JYb1Swha5mEV4l6SqF+NyyXJHGWwtE60FaZZWaPtzTv1HpzFA3uJCSqAQgA20Ys qmz16AJ/ARyxq7MDCWQ/9M0M316B+TN/x0cfgTY86j0obk0lODjTlKGrRUC56bjpJXuZ +uvj1Ekp8So2jnnVEohCRntRAaUGFxe/zrTrnd0SuQknhk3Rq04PmvjJ5bRZ/onbhXPm k3yU2n0MwpIag3+bw75m5K3Ipz7nv0D0kCHcCPwIiw8KgHfocCrZSF3BqtkcK4JZhL85 kP1Q== X-Gm-Message-State: AGi0PuYgdQx7saSuFdm4qMugfkiVhLX8VS/+NYmIznN8Y8Es2NE6uZ0r oyQmUMRfpe9tR8umh1JZ2bPq03iz X-Google-Smtp-Source: APiQypLOwBMgsUdAnioQ/73Fs0pxGwytma4dxwqr0KeoMgDvnEkZXR0Ahs8+oit37hbo7rweT1ZvaQ== X-Received: by 2002:a4a:a5d0:: with SMTP id k16mr10917145oom.41.1587340788595; Sun, 19 Apr 2020 16:59:48 -0700 (PDT) Received: from mail-oo1-f47.google.com (mail-oo1-f47.google.com. [209.85.161.47]) by smtp.gmail.com with ESMTPSA id k13sm9090882oou.27.2020.04.19.16.59.48 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 19 Apr 2020 16:59:48 -0700 (PDT) Received: by mail-oo1-f47.google.com with SMTP id e18so1732389oot.9; Sun, 19 Apr 2020 16:59:48 -0700 (PDT) X-Received: by 2002:a4a:b38d:: with SMTP id p13mr10891875ooo.22.1587340788125; Sun, 19 Apr 2020 16:59:48 -0700 (PDT) MIME-Version: 1.0 References: <202004181953.03IJrlA0090967@repo.freebsd.org> <530b4960-9735-15da-84b4-2fdda9930fc6@fastmail.com> <35522470-1b08-0eaa-e12e-d0cbd6b652e9@FreeBSD.org> In-Reply-To: <35522470-1b08-0eaa-e12e-d0cbd6b652e9@FreeBSD.org> Reply-To: cem@freebsd.org From: Conrad Meyer Date: Sun, 19 Apr 2020 16:59:37 -0700 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: svn commit: r360078 - in head: sbin/bectl share/man/man8 To: Mateusz Piotrowski <0mp@freebsd.org> Cc: Yuri Pankov , src-committers , svn-src-all , svn-src-head Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 4956JP44YJz4FM5 X-Spamd-Bar: ----- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-6.00 / 15.00]; NEURAL_HAM_MEDIUM(-1.00)[-1.000,0]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000,0] X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 Apr 2020 23:59:49 -0000 There is also mdoc(7), which describes the same thing: SEE ALSO References other manuals with related topics. This section should exist for most manuals. Cross-references should conventionally be ordered first by section, then alphabetically (ignoring case). I consult mdoc(7) frequently when writing or editing manual pages. In addition to 'mandoc -Tlint', there is a tool in ports called 'igor' which can be used to perform some style checking of manual pages. Hope that helps! Regards, Conrad On Sun, Apr 19, 2020 at 3:36 AM Mateusz Piotrowski <0mp@freebsd.org> wrote: > > On 4/18/20 11:11 PM, Yuri Pankov wrote: > > We don't have the man style guide (that I know of, at least) > We have style.mdoc(5)!