rc

commit 6cccd7bc3b9ff1440e2e02bcdaff8bf6dcfb25d8
parent a7041ce4c119f290c4dc9f6a002966608c5d8827
Author: tjg <tjg>
Date:   Thu, 14 Oct 1999 10:14:57 +0000

  Feature: replace `-V' with `version' variable.
  Portability: exporting `path' causes indigestion in CygWin.  Since
  it's virtually impossible for a child `rc' process to inherit `path'
  (which I consider a bug, but it's not going to be fixed now), simply
  don't export `path'.

Diffstat:
M
rc.1
 | 
34
+++++++++++++++++++++++++---------

1 file changed, 25 insertions(+), 9 deletions(-)
diff --git a/rc.1 b/rc.1
@@ -161,7 +161,7 @@
 .if !"\\$4"" .Xf \\$2 \\$1 "\\$3\\f\\$1\\$4\\*(Xi" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
 .if "\\$4"" \\$3\fR\s10
 ..
-.TH RC 1 "1999-05-28"
+.TH RC 1 "1999-10-14"
 .SH NAME
 rc \- shell
 .SH SYNOPSIS
@@ -306,11 +306,6 @@ to read from standard input.  Any arguments are
 placed in
 .Cr $* .
 .TP
-.Cr \-V
-This flag causes
-.I rc
-to print a version string to standard output, and exit immediately.
-.TP
 .Cr \-v
 This flag causes
 .I rc
@@ -1195,7 +1190,9 @@ as its value.
 .SH "SPECIAL VARIABLES"
 Several variables are known to
 .I rc
-and are treated specially.
+and are treated specially.  In the following list,
+``(read only)'' indicates that an attempt to set the
+variable will silently have no effect.
 .TP
 .Cr *
 The argument list of
@@ -1225,7 +1222,7 @@ command.
 .Cr apid
 The process ID of the last process started in the background.
 .TP
-.Cr apids
+.Cr apids " (read only)"
 The process IDs of any background processes which are outstanding
 or which have died and have not been waited for yet.
 .TP
@@ -1357,7 +1354,7 @@ If this function is set, then it gets executed every time
 is about to print
 .Cr "$prompt(1)" .
 .TP
-.Cr status
+.Cr status " (read only)"
 The exit status of the last command.
 If the command exited with a numeric value,
 that number is the status.
@@ -1380,6 +1377,11 @@ usually sets
 .Cr $status
 to
 .Cr "(0 0)" .
+.TP
+.Cr version " (read only)"
+This variable contains a string which identifies this
+version of
+.IR rc .
 .PP
 The values of
 .Cr "$path" ,
@@ -1950,6 +1952,20 @@ processes.
 .PP
 List definitions in exported functions are "noisier" than they need to be.
 .PP
+If both
+.Cr $PATH
+and
+.Cr $path
+are set,
+.I rc
+believes the former.  Arguably this is a bug, since although
+.I rc
+can quite happily deal with path elements that contain
+.Cr : ,
+such elements will be split at the colon in descendant
+.I rc
+processes.
+.PP
 Bug reports should be mailed to
 .Cr "<tjg@star.le.ac.uk>" .
 .SH INCOMPATIBILITIES