From owner-freebsd-doc@FreeBSD.ORG  Tue Feb  4 03:36:23 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@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 D3425AC8
 for <freebsd-doc@FreeBSD.org>; Tue,  4 Feb 2014 03:36:23 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 899101B60
 for <freebsd-doc@FreeBSD.org>; Tue,  4 Feb 2014 03:36:23 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id s143aMGr031917
 for <freebsd-doc@FreeBSD.org>; Mon, 3 Feb 2014 20:36:22 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id s143aMIM031914
 for <freebsd-doc@FreeBSD.org>; Mon, 3 Feb 2014 20:36:22 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Mon, 3 Feb 2014 20:36:22 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: freebsd-doc@FreeBSD.org
Subject: Re: Improving callout lists in HTML (CSS)
In-Reply-To: <alpine.BSF.2.00.1402022150320.19166@wonkity.com>
Message-ID: <alpine.BSF.2.00.1402032028350.31566@wonkity.com>
References: <alpine.BSF.2.00.1402022150320.19166@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.4.3
 (wonkity.com [127.0.0.1]); Mon, 03 Feb 2014 20:36:22 -0700 (MST)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/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: Tue, 04 Feb 2014 03:36:23 -0000

On Sun, 2 Feb 2014, Warren Block wrote:

> The attached patch, created with the help of Allan Jude, tightens up the 
> spacing in HTML callout lists, making them easier to read.
>
> After applying it, I did not see any problems with the callout lists in the 
> Handbook.
>
> Unless problems are reported, I'll commit it in a day or two.

It's been pointed out that there were few specifics and no example of 
what this patch does, so here is one:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-wireless.html#co-tls-ssid

Look at the callout list after the programlisting.  The numbers on the 
left are far from the descriptions, and there is a lot of vertical space 
between the entries.

Building the Handbook copies doc/share/misc/docbook.css into the 
Handbook directory.  So patch the original, do a 'make clean' for the 
Handbook, then refresh the browser to view the new version.