From owner-freebsd-doc@FreeBSD.ORG Mon Apr 9 19:20:02 2007 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id ECC3316A402 for ; Mon, 9 Apr 2007 19:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [69.147.83.40]) by mx1.freebsd.org (Postfix) with ESMTP id B60EA13C4B9 for ; Mon, 9 Apr 2007 19:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id l39JK2SO074870 for ; Mon, 9 Apr 2007 19:20:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id l39JK2kD074869; Mon, 9 Apr 2007 19:20:02 GMT (envelope-from gnats) Resent-Date: Mon, 9 Apr 2007 19:20:02 GMT Resent-Message-Id: <200704091920.l39JK2kD074869@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Jerry Peek Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id B7A9C16A403 for ; Mon, 9 Apr 2007 19:10:40 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [69.147.83.33]) by mx1.freebsd.org (Postfix) with ESMTP id A1D5B13C465 for ; Mon, 9 Apr 2007 19:10:40 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id l39JAeeC008244 for ; Mon, 9 Apr 2007 19:10:40 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id l39J5ckG005636; Mon, 9 Apr 2007 19:05:38 GMT (envelope-from nobody) Message-Id: <200704091905.l39J5ckG005636@www.freebsd.org> Date: Mon, 9 Apr 2007 19:05:38 GMT From: Jerry Peek To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.0 Cc: Subject: docs/111425: Missing chunks of text in historical manpages X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 09 Apr 2007 19:20:03 -0000 >Number: 111425 >Category: docs >Synopsis: Missing chunks of text in historical manpages >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Apr 09 19:20:02 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Jerry Peek >Release: www.freebsd.org website >Organization: >Environment: using a Windows system with Firefox 2.0.0.3 web browser >Description: I've used the historical manpages -- especially 7th Edition and 4.3 Reno -- for years, thanks. Today I'm reading the 4.3 Reno page diff3(1), from http://www.freebsd.org/cgi/man.cgi?query=diff3&apropos=0&sektion=1&manpath=4.3BSD+Reno&format=html . It has a problem I've seen in some other pages (but not reported before): some small bits of text are missing. For instance, the second paragraph of DESCRIPTION begins like this: Options are: Produces output in a form suitable as an input script for the ed(1) utility. Which option does that describe? It doesn't say. Another example is in the FILES section: FILES temporary files. the executable. I think that section should include /tmp/XXX and /usr/bin/diff3, or something. >How-To-Repeat: Open the manual page I mentioned in Firefox 2.0.0.3, or probably in other browsers too. >Fix: I'm guessing that there's a macro call which isn't being read or handled by the man-to-html converter. For instance, the missing -e option might have been coded as: .XX -e >Release-Note: >Audit-Trail: >Unformatted: