From owner-freebsd-arch@freebsd.org  Tue Nov 14 14:42:14 2017
Return-Path: <owner-freebsd-arch@freebsd.org>
Delivered-To: freebsd-arch@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 AB666DC0BF3
 for <freebsd-arch@mailman.ysv.freebsd.org>;
 Tue, 14 Nov 2017 14:42:14 +0000 (UTC) (envelope-from lm@mcvoy.com)
Received: from mcvoy.com (mcvoy.com [192.169.23.250])
 (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 9CE2C135A
 for <freebsd-arch@freebsd.org>; Tue, 14 Nov 2017 14:42:14 +0000 (UTC)
 (envelope-from lm@mcvoy.com)
Received: by mcvoy.com (Postfix, from userid 3546)
 id E8D5F35E130; Tue, 14 Nov 2017 06:42:13 -0800 (PST)
Date: Tue, 14 Nov 2017 06:42:13 -0800
From: Larry McVoy <lm@mcvoy.com>
To: Ravi Pokala <rpokala@mac.com>
Cc: Larry McVoy <lm@mcvoy.com>, freebsd-arch@freebsd.org,
 scottl@netflix.com, kbowling@llnw.com, gallatin@netflix.com
Subject: Re: small patch for numactl.  Comments?
Message-ID: <20171114144213.GA6265@mcvoy.com>
References: <20171114020138.GA18863@mcvoy.com>
 <BD0DB3A0-BBAF-438C-B91E-5F016140F8CD@mac.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <BD0DB3A0-BBAF-438C-B91E-5F016140F8CD@mac.com>
User-Agent: Mutt/1.5.24 (2015-08-30)
X-BeenThere: freebsd-arch@freebsd.org
X-Mailman-Version: 2.1.25
Precedence: list
List-Id: Discussion related to FreeBSD architecture <freebsd-arch.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-arch>,
 <mailto:freebsd-arch-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-arch/>
List-Post: <mailto:freebsd-arch@freebsd.org>
List-Help: <mailto:freebsd-arch-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-arch>,
 <mailto:freebsd-arch-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 14 Nov 2017 14:42:14 -0000

So is there some reason for the igor name?  Why not doc-lint or something
that someone would have some chance of finding?

I like the program, especially this:

     -e      Verify that sentences start on a new line.  mdoc(7) does not
             enforce this, it is a style issue.

because that style means that if you version control your docs you get
much nicer diffs.  I've got a little perl script that does that for me.

On Mon, Nov 13, 2017 at 08:35:02PM -0800, Ravi Pokala wrote:
> Also, I recommend installing textproc/igor, and using it to scan the manpage for common mistakes.