From owner-freebsd-doc@FreeBSD.ORG Mon Sep 3 01:52:29 2007 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id E2ED616A47A for ; Mon, 3 Sep 2007 01:52:29 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.freebsd.org (Postfix) with ESMTP id 4493B13C467 for ; Mon, 3 Sep 2007 01:52:28 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (dialup237.ach.sch.gr [81.186.70.237]) (authenticated bits=128) by igloo.linux.gr (8.14.1/8.14.1/Debian-8) with ESMTP id l831pZK5015293 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 3 Sep 2007 04:51:43 +0300 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.1/8.14.1) with ESMTP id l831pTkR013052; Mon, 3 Sep 2007 04:51:29 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.1/8.14.1/Submit) id l831pS7b013051; Mon, 3 Sep 2007 04:51:28 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Mon, 3 Sep 2007 04:51:28 +0300 From: Giorgos Keramidas To: t_ziel@wp.pl Message-ID: <20070903015128.GA12449@kobe.laptop> References: <46db365ce36a3@wp.pl> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <46db365ce36a3@wp.pl> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.092, required 5, autolearn=not spam, ALL_TRUSTED -1.80, AWL 0.31, BAYES_00 -2.60) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org Subject: Re: man pages improvement X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 03 Sep 2007 01:52:30 -0000 On 2007-09-03 00:17, t_ziel wrote: > Hello > Is it possible to improve FreeBSD's man pages usability by removing > white background? White background? Are you referring to the web interface? I'm reading manpages with: % man foo and there's no background and/or colour support in my terminal :-) > Some man pages have large chunks of text with background -- for > example in a man pkg_add there is: > > ---begin of example-- > Since the pkg_add command may execute scripts or programs contained > within a package file, your system may be susceptible to ``trojan > horses'' or other subtle attacks from miscreants who create dangerous > package files. > > You are advised to verify the competence and identity of those who pro- > vide installable package files. For extra protection, use the -M flag to > extract the package file, and inspect its contents and scripts to ensure > it poses no danger to your system's integrity. Pay particular attention > to any +INSTALL, +POST-INSTALL, +DEINSTALL, +POST-DEINSTALL, +REQUIRE or > +MTREE_DIRS files, and inspect the +CONTENTS file for @cwd, @mode (check > for setuid), @dirrm, @exec, and @unexec directives, and/or use the > pkg_info(1) command to examine the package file. > ---end of example--- > > This part of pkg_add man page is hard to read. It would be useful to > remove white background and replace it with plain white text (without > changing its color; preserving very light white hue). My Firefox window uses a white background when I read this page: http://www.freebsd.org/cgi/man.cgi?query=pkg_add&apropos=0&sektion=0&manpath=FreeBSD+6.2-RELEASE&format=html My terminal is set up to show "underlined text" with a cyan colour, to make it stand out from plain text: http://people.freebsd.org/~keramida/files/pkg_add.png What you probably see as "white background" is underlined text, which xterm will show with "reverse video", unless you configure it otherwise. You can configure your xterm windows to use any other colour you prefer, by editing or creating the file .Xresources in your HOME directory. For example mine includes (among other settings): ! XTerm -- cursor & mouse pointer. XTerm*cursorColor: #c0b020 XTerm*cursorBlink: false XTerm*cursorOnTime: 600 XTerm*cursorOffTime: 400 XTerm*pointerColor: #a0a0a0 XTerm*pointerColorBackground: #222222 XTerm*pointerShape: left_ptr ! XTerm -- misc other colours. ! XTerm*background: #001d3d XTerm*background: #002030 XTerm*foreground: #a8a8a8 XTerm*underLine: off XTerm*colorULMode: on XTerm*colorUL: #00b0c0 XTerm*boldMode: off XTerm*colorBDMode: on XTerm*colorBD: #f0f0f0 > For reference you can see for example: > http://www.redhat.com/docs/manuals/linux/RHL-7-Manual/getting-started-guide/figs/basics/man.gif > This man page has not a such white background, only plain text and is > very easy to read and friendly for eyes. I also recommend to see > OpenBSD's man pages -- very aesthetic and easy to read. This manpage has underlined text shown as with a proper line displayed under the text. You can configure your X11 terminals to show text like this too. Or you can use settings similar to mine, and display bold text with a bright white colour, and underlined text with cyan, orange, magenta, yellow or whatever you prefer :-) I hope all this helps a bit, - Giorgos