X-Recipient: archive-cygwin AT delorie DOT com
X-Spam-Check-By: sourceware.org
Message-ID: <48AF247F.2050300@users.sourceforge.net>
Date: Fri, 22 Aug 2008 15:41:35 -0500
From: "Yaakov (Cygwin Ports)" <yselkowitz AT users DOT sourceforge DOT net>
User-Agent: Thunderbird 2.0.0.16 (Windows/20080708)
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: man: cygwin 1.7.0 and special filename chars
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
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

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

Currently man(1) and perl work around Cygwin's inability to handle
illegal DOS filename characters by substituting '.' for '::', IOW:

$ man ExtUtils::Depends

will display ExtUtils.Depends.3pm, which is created by perl on Cygwin
instead of ExtUtils::Depends.3pm as on Linux.

With 1.7, however, ':' is legal, but man still indiscriminately replaces
'::' with '.'.  The major difference is with the gtk2-perl bindings,
which have their own process for manpage generation, and create manpages
with '::' without exception.  Of course, this didn't work on 1.5, so
there was a workaround in cygport, but with 1.7 the manpages build OOTB.
 But man won't display them because it's looking for, e.g.
Glib.index.3pm instead of the real Glib::index.3pm:

$ ls /usr/share/man/man3/Glib::index.3pm.gz
/usr/share/man/man3/Glib::index.3pm.gz

$ man Glib::index
No manual entry for Glib::index

So AFAICS there are two options:

1) Completely remove the /::/./ substitution in both man and perl for 1.7;
2) Have man look for both '.' and '::'.


Yaakov
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (Cygwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEAREIAAYFAkivJH8ACgkQpiWmPGlmQSMMPwCgnIjTcPLomNSGVqKdfwZ+SZla
SXkAn048w6IEWv8fYA9OqH/l3HIKmebv
=tiyw
-----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/