From owner-freebsd-doc@FreeBSD.ORG Wed Jun 25 00:44:47 2014 Return-Path: Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 3769181C for ; Wed, 25 Jun 2014 00:44:47 +0000 (UTC) Received: from alogt.com (alogt.com [69.36.191.58]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 0F4CF21FC for ; Wed, 25 Jun 2014 00:44:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=alogt.com; s=default; h=Content-Transfer-Encoding:Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date; bh=nSiKTTT4wqYohmiocjWQaK6IVeNFMxdqoNpiWjEzwl4=; b=IMY6sy7SqvuHBx/YCQbOdgtVEKLuh6mF3PVfk/ubzF3rYjXg0AJ1A1gHajzjuvrVuGr4NqnLqszm313AdejbSLqMeh5h7Ix3mgOaprODIyymg8rgrWEavGvE69trEvWtBc1+AiyT6BEe/fcnzYtXLDev8Yv6Z5nNmtxVGeV+QS8=; Received: from [182.9.167.108] (port=44161 helo=X220.alogt.com) by sl-508-2.slc.westdc.net with esmtpsa (SSLv3:DHE-RSA-AES128-SHA:128) (Exim 4.82) (envelope-from ) id 1WzbKI-0005cZ-5r; Tue, 24 Jun 2014 18:44:38 -0600 Date: Wed, 25 Jun 2014 08:44:33 +0800 From: Erich Dollansky To: Warren Block Subject: Re: appearance in HTML Message-ID: <20140625084433.4fa7e1bb@X220.alogt.com> In-Reply-To: References: X-Mailer: Claws Mail 3.9.3 (GTK+ 2.24.22; amd64-portbld-freebsd10.0) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - sl-508-2.slc.westdc.net X-AntiAbuse: Original Domain - freebsd.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - alogt.com X-Get-Message-Sender-Via: sl-508-2.slc.westdc.net: authenticated_id: erichsfreebsdlist@alogt.com X-Source: X-Source-Args: X-Source-Dir: Cc: freebsd-doc@FreeBSD.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 25 Jun 2014 00:44:47 -0000 Hi, On Tue, 24 Jun 2014 10:38:08 -0600 (MDT) Warren Block wrote: > The current CSS makes elements appear in bold text in > XHTML. For example: > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/desktop-browsers.html > > This repeated use of bold makes for uncomfortable and fatiguing > reading. > > Allan and I have searched for less severe forms of highlighting. > Without resorting to color, there are not many options. The best > I've seen so far is font-variant: small-caps;, but that is quickly > annoying also. > > My suggestion at this point is to just remove the CSS entry for > applications. The application names are names, and recognizably > distinct from other words on their own. > > Unless there are complaints, I will plan to remove the .application > entry from docbook.css before the end of this week. I would keep it and I would keep it as bold. I would only recommend a consequent use of it. Using bold helps to find important locations a bit faster without reading the whole sentence. The example is a bit confusing as the highlighting is randomly used for trademarks like Java and Adobe. While Flash is the application, Adobe is the manufacturer's trademark. The moment the highlighting will only be used for the application and not for the manufacturer, it will be very helpful for the reader. Erich