From owner-freebsd-doc  Tue Jul 18 23: 0: 8 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0DDF237BD85
	for <freebsd-doc@freebsd.org>; Tue, 18 Jul 2000 23:00:03 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id XAA88535;
	Tue, 18 Jul 2000 23:00:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from minya.sea.one-eyed-alien.net (minya.sea.one-eyed-alien.net [216.39.168.226])
	by hub.freebsd.org (Postfix) with ESMTP id C4ED237BD7F
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 18 Jul 2000 22:53:27 -0700 (PDT)
	(envelope-from brooks@minya.sea.one-eyed-alien.net)
Received: (from brooks@localhost)
	by minya.sea.one-eyed-alien.net (8.9.3/8.9.3) id WAA12534;
	Tue, 18 Jul 2000 22:54:04 -0700 (PDT)
	(envelope-from brooks)
Message-Id: <200007190554.WAA12534@minya.sea.one-eyed-alien.net>
Date: Tue, 18 Jul 2000 22:54:04 -0700 (PDT)
From: brooks@one-eyed-alien.net
Reply-To: brooks@one-eyed-alien.net
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/20028: ASCII docs should reflect <emphasis> tags in the source
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20028
>Category:       docs
>Synopsis:       ASCII docs should reflect <emphasis> tags in the source
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jul 18 23:00:01 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Brooks Davis
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:

All versions of FreeBSD

>Description:

When the <emphasis> tag is used in DocBook, this is translated to a
variant on the <i> tag in HTML vi the style sheets.  The HTML docs are
then processed by w3m to produce ASCII versions.  w3m appears to
compleatly ignore <i> tags even in interative mode and it ignores both
<i> and <b> tags in -dump mode.  This means that no indication of
emphasis is transmitted to the ASCII form which potentialy distorts the
text's meaning.

>How-To-Repeat:

Create ASCII docs.

>Fix:

The fix is going to be something like patching w3m to have a mode where
it emphasises things like *this* or something.


>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message