From owner-freebsd-doc@FreeBSD.ORG  Mon Dec 16 21:33:44 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 78C5C46F;
 Mon, 16 Dec 2013 21:33:44 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 27C601FCE;
 Mon, 16 Dec 2013 21:33:43 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id rBGLXUmZ051795;
 Mon, 16 Dec 2013 14:33:30 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id rBGLXUIs051792;
 Mon, 16 Dec 2013 14:33:30 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Mon, 16 Dec 2013 14:33:30 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Jamie Landeg Jones <jamie@dyslexicfish.net>
Subject: Re: docs/184791: [patch] man page for 'diff3' references 'info diff'
 instead of 'info diff3'
In-Reply-To: <201312160621.rBG6LOZ1070718@catnip.dyslexicfish.net>
Message-ID: <alpine.BSF.2.00.1312161428240.51221@wonkity.com>
References: <201312160621.rBG6LOZ1070718@catnip.dyslexicfish.net>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Mon, 16 Dec 2013 14:33:30 -0700 (MST)
Cc: freebsd-doc@FreeBSD.org, FreeBSD-gnats-submit@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 16 Dec 2013 21:33:44 -0000

> Most obsessive/pedantic/picky PR of the year goes to me, with:
>
> The man page for diff3(1) refers to 'info diff' instead of
> 'info diff3'
>
>
>> How-To-Repeat:
>
> % man diff3
>
> Compare the similarity of the end of this page with the end of the
> 'man diff' page.
>
> Both refer to 'info diff' for more information, but if you compare
> the results of 'info diff' and 'info diff3' you'll clearly see that
> the man page for diff3 should be referencing 'info diff3'.

Agreed.  However, this is "contrib" software from an external source, 
and we generally prefer to get them patched upstream to avoid having to 
maintain local patches.  I think this is the project page:
http://www.gnu.org/software/diffutils/

It's not clear how they prefer to get bug reports, but maybe a post to 
their mailing list would help.