From owner-freebsd-www@FreeBSD.ORG Tue Jul 10 22:00:19 2007 Return-Path: X-Original-To: freebsd-www@hub.freebsd.org Delivered-To: freebsd-www@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 2995B16A469 for ; Tue, 10 Jul 2007 22:00:19 +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 0BEC913C459 for ; Tue, 10 Jul 2007 22:00:19 +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 l6AM0Ie6050578 for ; Tue, 10 Jul 2007 22:00:18 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id l6AM0IFr050574; Tue, 10 Jul 2007 22:00:18 GMT (envelope-from gnats) Resent-Date: Tue, 10 Jul 2007 22:00:18 GMT Resent-Message-Id: <200707102200.l6AM0IFr050574@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-www@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Ben Kaduk Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 0FFD916A46D for ; Tue, 10 Jul 2007 21:56:26 +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 00F3E13C459 for ; Tue, 10 Jul 2007 21:56:26 +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 l6ALuPZV047597 for ; Tue, 10 Jul 2007 21:56:25 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id l6ALuPij047596; Tue, 10 Jul 2007 21:56:25 GMT (envelope-from nobody) Message-Id: <200707102156.l6ALuPij047596@www.freebsd.org> Date: Tue, 10 Jul 2007 21:56:25 GMT From: Ben Kaduk To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.0 Cc: Subject: www/114487: html man pages break with underscore characters X-BeenThere: freebsd-www@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: FreeBSD Project Webmasters List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 10 Jul 2007 22:00:19 -0000 >Number: 114487 >Category: www >Synopsis: html man pages break with underscore characters >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-www >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Tue Jul 10 22:00:18 GMT 2007 >Closed-Date: >Last-Modified: >Originator: Ben Kaduk >Release: 7.0-CURRENT >Organization: >Environment: the internet. That is, I don't know what the www/ build machine is running, or even if it's the same machine that does the conversion from mdoc to html for the man.cgi page. >Description: Sorry to be so brief, but my time is a bit limited at the moment. I have found a couple man pages which, when displayed using the man.cgi web interface, do not render properly. I have no reason to believe that this problem is limited in scope to these particular pages; I think it is more general, and involves the software that converts the man pages from mdoc to html. The snd_ess(4) page http://www.freebsd.org/cgi/man.cgi?query=snd_ess&sektion=4&apropos=0&manpath=FreeBSD+6.2-RELEASE shows how to add the audio driver to your kernel configuration, that is, by adding: device sound device snd_ess device snd_sbc however, in the two lines with underscores, only the portion before the underscore is highlighted as a configuration declaration. Similarly, in the roff(7) man page: http://www.freebsd.org/cgi/man.cgi?query=roff the text mentions the groff_out(5) utility. However, only the portion after the underscore (``out(5)'') is active as a link, and the link attempts to point to a man page for the nonexistant out(5) man page: http://www.freebsd.org/cgi/man.cgi?query=out&sektion=5&apropos=0&manpath=FreeBSD+6.2-RELEASE which is not a valid link (because there is no such man page). Unfortunately, I have not been able to find the source for this page in cvsweb (presumably, I'm looking in the wrong place), and I don't have more time to track down this case, or other possible pages with underscores that break rendering. >How-To-Repeat: http://www.freebsd.org/cgi/man.cgi?query=snd_ess&sektion=4&apropos=0&manpath=FreeBSD+6.2-RELEASE http://www.freebsd.org/cgi/man.cgi?query=roff >Fix: I don't know of anything at the moment; in fact, I only know a symptom of a problem, not what the problem itself is. >Release-Note: >Audit-Trail: >Unformatted: