From owner-freebsd-doc@FreeBSD.ORG  Mon Jan  2 03:09:54 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 4FDFE106564A
	for <doc@freebsd.org>; Mon,  2 Jan 2012 03:09:54 +0000 (UTC)
	(envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
	by mx1.freebsd.org (Postfix) with ESMTP id 1226A8FC0A
	for <doc@freebsd.org>; Mon,  2 Jan 2012 03:09:53 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
	by wonkity.com (8.14.5/8.14.5) with ESMTP id q0239rpV061263
	for <doc@freebsd.org>; Sun, 1 Jan 2012 20:09:53 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
	by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q0239rjw061260
	for <doc@freebsd.org>; Sun, 1 Jan 2012 20:09:53 -0700 (MST)
	(envelope-from wblock@wonkity.com)
Date: Sun, 1 Jan 2012 20:09:53 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: doc@freebsd.org
Message-ID: <alpine.BSF.2.00.1201011952230.61190@wonkity.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
	(wonkity.com [127.0.0.1]); Sun, 01 Jan 2012 20:09:53 -0700 (MST)
Cc: 
Subject: RFC: modifying the doc CSS
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
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: Mon, 02 Jan 2012 03:09:54 -0000

Feedback welcome on some proposed modifications to the default DocBook 
CSS (/usr/doc/share/misc/docbook.css).

Samples for side-by-side comparison:

Existing: http://www.wonkity.com/~wblock/porters-handbook-orig/book.html
Proposed: http://www.wonkity.com/~wblock/porters-handbook/book.html

The proposed CSS:
http://www.wonkity.com/~wblock/porters-handbook/docbook.css


Changes:

Left-align table headers.

Add rounded border corners.

Fix uneven margin spacing on notes and other blockquotes.

Remove padding entries from various blockquotes.

Reduce "body blockquote" line-spacing: from 1.5 to 1.3 so lines 
don't look double-spaced.

Set line-height: 1.1 in programlistings so descenders have a 
little clearance.