Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
Message-ID: <42DF97EA.5010308@byu.net>
Date: Thu, 21 Jul 2005 06:41:14 -0600
From: Eric Blake <ebb9 AT byu DOT net>
User-Agent: Mozilla Thunderbird 1.0.2 (Windows/20050317)
MIME-Version: 1.0
To: Jan Schormann <jan DOT schormann AT brainlab DOT com>
CC: cygwin AT cygwin DOT com
Subject: Re: Bug in bash 3.0-8: Removes its own manpage. [Attn: man maintainer]
References: <CCAC2F20421E784A87FAFDB3E0EC5572B324A9 AT DEVXCH1 DOT brainlab DOT net>
In-Reply-To: <CCAC2F20421E784A87FAFDB3E0EC5572B324A9@DEVXCH1.brainlab.net>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

According to Jan Schormann on 7/21/2005 5:57 AM:
> Hi,
> 
> in /etc/postinstall/00bash.sh, it says (unconditionally):
> 
> ----
> # Get rid of ash manpage, if it is in the way of our compressed page.
> rm -f /usr/share/man/man1/sh.1

Ash used to install (uncompressed) as sh.1.  Bash-3.0-7 installs
(compressed) as sh.1.gz (actually, a symlink to a compressed, but symlinks
in the man directory have to have the same extension as what they link
to).  Since `man sh' prefers sh.1 over sh.1.gz, my original postinstall
script was not nuking its own file, but getting rid of ash's to ensure
that its own sh.1.gz would succeed.

But you are indeed correct - in making bash-3.0-8, I changed from sh.1.gz
as a symlink, to the more appropriate sh.1 with contents ".so
man1/bash.1.gz", without updating the postinstall script accordingly.  I
made the swap because I learned that using .so in man pages is more
efficient for reuse of the /var/cache/man/cat*/* pages of pre-rendered
output.  While normal pages are compressed to save space, compressing the
single line link pages typically expands the file size (with compression
information overhead), and is wasteful for the time spent unpacking it.

[Man maintainer - I noticed that the default installation of
/usr/share/misc/man.conf does not disable caching, but that /var/cache/man
does not have any catN subdirectories so attempts to create cache files
fail.  Can you fix your installation be fixed to ensure the cache
directory structure exists?]

It will be fixed in bash-3.0-9; in the meantime, you can do the following
to placate `cygcheck -cv bash':
echo .so man1/bash.1.gz > /usr/share/man/man1/sh.1

- --
Life is short - so eat dessert first!

Eric Blake             ebb9 AT byu DOT net
volunteer cygwin bash maintainer
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (Cygwin)
Comment: Public key at home.comcast.net/~ericblake/eblake.gpg
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFC35fp84KuGfSFAYARAsLcAJ0SEYJn+A6oTIMG9UVL1EoPo8PBZgCeJPeA
zKZCJzoVbmJY+hwkZ9vUA90=
=NuXE
-----END PGP SIGNATURE-----

--
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple
Problem reports:       http://cygwin.com/problems.html
Documentation:         http://cygwin.com/docs.html
FAQ:                   http://cygwin.com/faq/