This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Switch from meta-3.0at70b to meta-3.5-20
authorH.Merijn Brand <h.m.brand@xs4all.nl>
Fri, 21 Mar 2008 09:56:58 +0000 (09:56 +0000)
committerH.Merijn Brand <h.m.brand@xs4all.nl>
Fri, 21 Mar 2008 09:56:58 +0000 (09:56 +0000)
p4raw-id: //depot/metaconfig@33545

README

diff --git a/README b/README
index b805b4c..a261539 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-       Jarkko's How to build Configure tweaked by Nick.
+       Jarkko's How to build Configure tweaked by Nick and Merijn.
 
 The Configure script and config_h.SH file in the Perl distribution are
 generated by a program called metaconfig.  Metaconfig was originally 
@@ -31,30 +31,43 @@ Contents of this directory:
                to this tree.  If someone with perforce access wants to change
                the name of the directory, that'd be fine.  Otherwise, it really 
                doesn't matter.
+    dist-3.5-20:
+               dist-3.5-20 is almost meta-4.0, still maintained by Raphael
+               Manfredi, but with a lot of fixes over 3.0, some changes
+               from the perl modifications merged and a much better metalint
+    dist:
+               a symlink to the lib you actually use. For Merijn that is
+               metaconfig/dist -> ../lib/dist
 
 (a) You need to have dist installed so that you have metalint and metaconfig
     in your $PATH.
-    The dist version used for perl is dist-3.0at70b in this directory.
+    The dist version used for perl is dist-3.5-20 in this directory, which is
+    a slightly modified version of the original, which you can get at the SVN
+    repository https://dist.svn.sourceforge.net/svnroot/dist/trunk
     Unsurprisingly 'dist' uses (its) Configure to generate itself:
 
-    cd dist-3.0at70b
+    cd dist-3.5-20
     chmod -R +w .     # We have derived files in perforce :-(
     ./Configure
     make
     make install
 
-    dist's 'Configure' is similar to perl's but perhaps not
-    quite as polished.
+    After make install, remove lib/U/d_debugging.U in your target lib, as perl
+    uses it's own way to set/define debugging (see INSTALL)
+
+    the dist-3.5-20 installation as used by Merijn is available on his CPAN as
+    perl-meta-3.5-20.tgz
+
+    dist's 'Configure' is similar to perl's but perhaps not quite as polished.
 
     There are some perl specific "dist units" in the 'U' directory.
-    The U directory also contains some patches to 'dist' which
-    have already been applied to dist-3.0at70b directory.
-    We have not yet arranged for metaconfig to use perl's versions
-    of the 'units' by default so you need some housekeeping
-    in the perl directory...
-
-(b) You need to be in a/the Perl directory, i.e. either
-    something from //depot/perl/... or one of its branches
+    The U directory also contains some patches to 'dist' which have already
+    been applied to dist-3.5-20 directory.
+    We have not yet arranged for metaconfig to use perl's versions of the
+    'units' by default so you need some housekeeping in the perl directory...
+
+(b) You need to be in a/the Perl directory, i.e. either something from
+    //depot/perl/... or one of its branches
     (e.g. Nick I-S is usually in //depot/perlio/...)
     and you need:
      1) have a symlink to ../metaconfig/U called U
@@ -73,6 +86,10 @@ Contents of this directory:
       Your private U/modified/voidflags.U overrides the public one.
     due to the perl special units
 
+    an alias to something like
+    $ metalint      |& grep -v -e '^    Your private U/'
+    will make the process silence up on that
+
     and
 
     "End.U": stale ?MAKE: dependency '$W'.