From owner-freebsd-doc@FreeBSD.ORG  Thu May  5 13:17:52 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id C79F016A4CF
	for <freebsd-doc@freebsd.org>; Thu,  5 May 2005 13:17:52 +0000 (GMT)
Received: from mail.freebsdmall.com (ns1.freebsdmall.com [69.50.233.146])
	by mx1.FreeBSD.org (Postfix) with ESMTP id AD2E343D3F
	for <freebsd-doc@freebsd.org>; Thu,  5 May 2005 13:17:52 +0000 (GMT)
	(envelope-from murray@freebsdmall.com)
Received: by mail.freebsdmall.com (Postfix, from userid 2074)
	id 094271CE08; Thu,  5 May 2005 06:24:12 -0700 (PDT)
Date: Thu, 5 May 2005 06:24:12 -0700
From: Murray Stokely <murray@freebsdmall.com>
To: freebsd-doc@freebsd.org
Message-ID: <20050505132411.GC6071@freebsdmall.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.4.2.1i
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
Subject: Turning on smartquotes for HTML output
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/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: Thu, 05 May 2005 13:17:52 -0000

I would like to use proper entities to generate smart quotes rather
than relying on double ``ticks''.  The following patch produces much
nicer looking quotes in FireFox and Opera on FreeBSD.  We didn't have
this option many years ago when the quote element was first added to
our stylesheets, but the smartquote entities are now well supported so
we should use them.  If there are no objections I'll commit the
following patch.

	- Murray

Index: release.dsl
===================================================================
RCS file: /home/ncvs/src/release/doc/share/sgml/release.dsl,v
retrieving revision 1.8
diff -u -r1.8 release.dsl
--- release.dsl	5 Sep 2004 13:50:38 -0000	1.8
+++ release.dsl	5 May 2005 13:12:19 -0000
@@ -117,9 +117,9 @@
 	<!-- Convert " ... " to `` ... '' in the HTML output. -->
 	(element quote
 	  (make sequence
-	    (literal "``")
+	    (literal "&#8220;")
 	    (process-children)
-	    (literal "''")))
+	    (literal "&#8221;")))
 
         <!-- Specify how to generate the man page link HREF -->
         (define ($create-refentry-xref-link$ #!optional (n (current-node)))

Index: freebsd.dsl
===================================================================
RCS file: /home/dcvs/doc/share/sgml/freebsd.dsl,v
retrieving revision 1.87
diff -u -r1.87 freebsd.dsl
--- freebsd.dsl	31 Dec 2004 22:34:52 -0000	1.87
+++ freebsd.dsl	5 May 2005 13:13:04 -0000
@@ -275,9 +275,9 @@
 	<!-- Convert " ... " to `` ... '' in the HTML output. -->
 	(element quote
 	  (make sequence
-	    (literal "``")
+	    (literal "&#8220;")
 	    (process-children)
-	    (literal "''")))
+	    (literal "&#8221;")))
 
 	;; The special FreeBSD version of the trademark tag handling.
 	;; This function was more or less taken from the DocBook DSSSL