From nobody@FreeBSD.org  Fri Dec 20 17:54:53 2013
Return-Path: <nobody@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 547E6316
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 20 Dec 2013 17:54:53 +0000 (UTC)
Received: from oldred.freebsd.org (oldred.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by mx1.freebsd.org (Postfix) with ESMTPS id 4126F1A13
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 20 Dec 2013 17:54:53 +0000 (UTC)
Received: from oldred.freebsd.org ([127.0.1.6])
	by oldred.freebsd.org (8.14.5/8.14.7) with ESMTP id rBKHsrfm016013
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 20 Dec 2013 17:54:53 GMT
	(envelope-from nobody@oldred.freebsd.org)
Received: (from nobody@localhost)
	by oldred.freebsd.org (8.14.5/8.14.5/Submit) id rBKHsrRc016009;
	Fri, 20 Dec 2013 17:54:53 GMT
	(envelope-from nobody)
Message-Id: <201312201754.rBKHsrRc016009@oldred.freebsd.org>
Date: Fri, 20 Dec 2013 17:54:53 GMT
From: Warren Block <wblock@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: HTML rendering: replaceable elements are not distinguished
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         185041
>Category:       docs
>Synopsis:       HTML rendering: replaceable elements are not distinguished
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gabor
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 20 18:00:00 UTC 2013
>Closed-Date:    Wed Jan 22 10:29:07 UTC 2014
>Last-Modified:  Wed Jan 22 10:29:07 UTC 2014
>Originator:     Warren Block
>Release:        10-STABLE
>Organization:
>Environment:
FreeBSD lightning 10.0-PRERELEASE FreeBSD 10.0-PRERELEASE #2 r259630: Thu Dec 19 14:03:41 MST 2013     root@lightning:/usr/obj/usr/src/sys/LIGHTNING  amd64
>Description:
Replaceable elements were formerly shown in italic to indicate to the user that they should be replaced.  The current HTML does not do this.  Example:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html#preface-conventions

In the line that says "man -k keyword", keyword should be in italic.  The HTML source does not make "keyword" a separate class:

<code class="command">man -k
		  keyword</code>
>How-To-Repeat:
View http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html#preface-conventions
>Fix:


>Release-Note:
>Audit-Trail:

From: Warren Block <wblock@wonkity.com>
To: bug-followup@FreeBSD.org, wblock@FreeBSD.org
Cc:  
Subject: Re: docs/185041: HTML rendering: replaceable elements are not
 distinguished
Date: Fri, 20 Dec 2013 18:13:20 -0700 (MST)

 Further info: this problem seems to be limited to <replaceable> tags 
 inside <command> tags.

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/185041: commit references a PR
Date: Wed, 22 Jan 2014 10:07:25 +0000 (UTC)

 Author: gabor
 Date: Wed Jan 22 10:07:19 2014
 New Revision: 43623
 URL: http://svnweb.freebsd.org/changeset/doc/43623
 
 Log:
   - Mark a command part as replaceable
   
   PR:		docs/185041
   Submitted by:	wblock
 
 Modified:
   head/en_US.ISO8859-1/books/fdp-primer/book.xml
 
 Modified: head/en_US.ISO8859-1/books/fdp-primer/book.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/fdp-primer/book.xml	Tue Jan 21 23:41:48 2014	(r43622)
 +++ head/en_US.ISO8859-1/books/fdp-primer/book.xml	Wed Jan 22 10:07:19 2014	(r43623)
 @@ -181,7 +181,7 @@ The time is 09:18</screen></entry>
  
  	      <entry>To search for a keyword in the manual pages, type
  		<command>man -k
 -		  keyword</command></entry>
 +		  <replaceable>keyword</replaceable></command></entry>
  	    </row>
  
  	    <row>
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: gabor 
State-Changed-When: Wed Jan 22 10:28:17 UTC 2014 
State-Changed-Why:  
I have fixed this case, thanks! Unfortunately, some other replaceable elements 
may have been lost in the DB5 conversion. 


Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Wed Jan 22 10:28:17 UTC 2014 
Responsible-Changed-Why:  
I have fixed this case, thanks! Unfortunately, some other replaceable elements 
may have been lost in the DB5 conversion. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=185041 
>Unformatted:
