X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=-2.5 required=5.0 	tests=AWL,BAYES_00
X-Spam-Check-By: sourceware.org
Message-ID: <49FABA9C.5060902@x-ray.at>
Date: Fri, 01 May 2009 11:02:20 +0200
From: Reini Urban <rurban AT x-ray DOT at>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; de-AT; rv:1.8.1.21) Gecko/20090403 SeaMonkey/1.1.16
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: Re: Perl ExtUtils::MakeMaker 'make install' not generating manual  page for script
References: <4B7C4091A00140B7BED5027BE49AA083 AT p43400e>
In-Reply-To: <4B7C4091A00140B7BED5027BE49AA083@p43400e>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-IsSubscribed: yes
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

David Christensen schrieb:
> Cygwin:
> 
> I've packaged a Perl script into a module distribution using
> ExtUtils::MakeMaker:
> 
>     http://www.holgerdanske.com/system/files/newest-1.012.tar.gz

Just a hint: Please do *NOT* use lowercase package
names for non-pragmas.
See http://www.cpan.org/modules/04pause.html#namespace
"newest" is certainly a very very bad name, if it does not relate to
something like "use blead;"

> When I build the module on a Linux machine, a manual page is created.
> But when I build the script on Cygwin (console session follows), a
> manual page is not created.  I was expecting a manual page to be created
> under Cygwin.
> 
> 
> Any suggestions?
> 
> 
> TIA,
> 
> David
> 
> 
> Note: software was already installed when the following was run, and
> Perl ExtUtils::MakeMaker's 'make uninstall' is unsupported/dangerous:

make uninstall is dangerous, but still supported because we
do write the .packlist into sitearch.

> 2009-04-30 09:43:24 Administrator AT p43400e ~/build
> $ tar -xzvf newest-1.012.tar.gz
> newest-1.012/
> newest-1.012/bin/
> newest-1.012/bin/newest
> newest-1.012/Changes
> newest-1.012/lib/
> newest-1.012/lib/newest.pm
> newest-1.012/LICENSE.txt
> newest-1.012/Makefile.PL
> newest-1.012/MANIFEST
> newest-1.012/META.yml
> newest-1.012/README
> newest-1.012/t/
> newest-1.012/t/newest.t
> 
> 2009-04-30 09:43:32 Administrator AT p43400e ~/build
> $ cd newest-1.012
> 
> 2009-04-30 09:43:35 Administrator AT p43400e ~/build/newest-1.012
> $ perl Makefile.PL
> Checking if your kit is complete...
> Looks good
> Writing Makefile for newest
> 
> 2009-04-30 09:43:39 Administrator AT p43400e ~/build/newest-1.012
> $ make
> cp lib/newest.pm blib/lib/newest.pm
> cp ./bin/newest blib/script/newest
> /usr/bin/perl.exe "-MExtUtils::MY" -e "MY->fixin(shift)"
> blib/script/newest
> 
> 2009-04-30 09:43:49 Administrator AT p43400e ~/build/newest-1.012
> $ make test
> /usr/bin/perl.exe "-MExtUtils::Command::MM" "-e" "test_harness(0,
> 'blib/lib', 'blib/arch')" t/*.t
> t/newest......bin/newest syntax OK
> t/newest......ok
> All tests successful.
> Files=1, Tests=1,  1 wallclock secs ( 0.00 usr  0.00 sys +  0.47 cusr
> 0.11 csys =  0.58 CPU)
> Result: PASS
> 
> 2009-04-30 09:43:54 Administrator AT p43400e ~/build/newest-1.012
> $ make install
> Writing /usr/lib/perl5/site_perl/5.10/i686-cygwin/auto/newest/.packlist
> Appending installation info to
> /usr/lib/perl5/5.10/i686-cygwin/perllocal.pod
> 
> 2009-04-30 09:45:13 Administrator AT p43400e ~/build/newest-1.012
> $ man newest
> No manual entry for newest

ExtUtils::MakeMaker doesn't include all :: manifypods on cygwin, because 
this is a unix extension only. See MM_Unix.pm
Please complain at ExtUtils::MakeMaker.
A patch would be trivial. Schwern just needs a kick.

For you: just do

   $ make manifypods

For Schwern:

diff -u MM_Cygwin.pm.orig MM_Cygwin.pm
--- MM_Cygwin.pm.orig   2008-12-19 09:13:57.000000000 +0000
+++ MM_Cygwin.pm        2009-05-01 08:44:11.125000000 +0000
@@ -98,6 +98,21 @@
      $self->{EXPORT_LIST}  ||= '';
  }

+=item all_target
+
+Build man pages, too
+
+=cut
+
+sub all_target {
+    my $self = shift;
+
+    return <<'MAKE_EXT';
+all :: pure_all manifypods
+       $(NOECHO) $(NOOP)
+MAKE_EXT
+}
+
  =back

  =cut


-- 
Reini Urban
http://phpwiki.org/  http://murbreak.at/

--
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/