This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Remove spurious LINT: directives
[metaconfig.git] / README
diff --git a/README b/README
index a68cc5b..b805b4c 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-       Jarrko's How to build Configure tweaked by Nick.
+       Jarkko's How to build Configure tweaked by Nick.
 
 The Configure script and config_h.SH file in the Perl distribution are
 generated by a program called metaconfig.  Metaconfig was originally 
@@ -38,7 +38,7 @@ Contents of this directory:
     Unsurprisingly 'dist' uses (its) Configure to generate itself:
 
     cd dist-3.0at70b
-    chmod +w -R .     # We have derived files in perforce :-(
+    chmod -R +w .     # We have derived files in perforce :-(
     ./Configure
     make
     make install
@@ -83,26 +83,39 @@ Contents of this directory:
 
 (f) metaconfig -m to regenerate Configure
 
-(g) The messy not-yet-automated part is that the knowledge of the new symbol
-    needs to be propagated to non-Configure lands like Win32, Netware,
-    VMS, VOS, ...  see previous Configure changes to see which are these
-    heathen lands
+(g) metaconfig does not deal with depends in config_h.SH, so some
+    reorganization is needed.
+
+    perl Porting/config_h.SH
+
+    will fix the ordering
+    
+(h) The messy not-yet-automated part is that the knowledge of the new symbol
+    needs to be propagated to non-Configure lands like Win32, WinCE, Netware,
+    VMS, VOS, EPOC, ...  see previous Configure changes to see which are these
+    heathen lands.  Files to take care of are
+    {win32,wince,NetWare}/config_[hH]*, (Win32, WinCE, NetWare),
+    configure.com (VMS), VOS/config* (since 5.9 VOS uses Configure, though),
+    epoc/config.sh (EPOC).  Depending on the kind of patch djgpp/config*
+    might also need adjusting (for example when adding/changing the list
+    of extensions)
 
     For Win32 the process is semi-automated - if you have a Win32
     machine to run dmake on ...
 
-(h) Edit U/mkglossary (right near the top) to point to where you keep
+(i) Edit U/mkglossary (right near the top) to point to where you keep
     dist's standard metaconfig units as well as your perl-specific ones.
 
-(i) Run U/mksample to freshen the Porting/config* and Porting/Glossary.
+(j) Run U/mksample to freshen the Porting/config* and Porting/Glossary.
     Adjust the various compile-time options (e.g. 64bit, threads) as
     you see fit.
     You can skip this phase, it's not essential, just good housekeeping.
 
-(j) make veryclean;sh Configure -des -Dusedevel;make all test
+(k) make veryclean;sh Configure -des -Dusedevel;make all test
 
-(k) p4 add ../metaconfig/foo/bar.U when you are ready ...
+(l) p4 add ../metaconfig/foo/bar.U when you are ready ...
 
-(l) p4 submit
-    Be sure to have EDITOR set to something that does NOT start
-    in the background like 'elvis -fork' or 'gvim'
+(m) p4 submit
+    IF your $EDITOR and/or $VISUAL start a background edit session
+    ('elvis -fork' or 'gvim'), be sure to set $P4EDITOR to an
+    editor call that is waited for.