new version from Rick Adams; rick@seismo.css.gov

[unix-history] / usr / src / bin / csh / csh.1

diff --git a/usr/src/bin/csh/csh.1 b/usr/src/bin/csh/csh.1
index e7828d0..463cbf6 100644 (file)
--- a/usr/src/bin/csh/csh.1
+++ b/usr/src/bin/csh/csh.1
@@ -2,7 +2,7 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)csh.1       6.5 (Berkeley) %G%
+.\"    @(#)csh.1       6.10 (Berkeley) %G%

 .\"
 .TH CSH 1 ""
 .UC 4
 .\"
 .TH CSH 1 ""
 .UC 4


@@ -124,7 +124,7 @@ like:
 .DT
        [1] 1234
 .PP
 .DT
        [1] 1234
 .PP

-indicating that the jobs which was started asynchronously was job number
+indicating that the job which was started asynchronously was job number

 1 and had one (top-level) process, whose process id was 1234.
 .PP
 If you are running a job and wish to do something else you may hit the key
 1 and had one (top-level) process, whose process id was 1234.
 .PP
 If you are running a job and wish to do something else you may hit the key


@@ -225,7 +225,7 @@ However, given
 .br
        % vi DSC.
 .br
 .br
        % vi DSC.
 .br

-and will sound the terminal bell to indicate the expansion is
+and will sound the terminal bell to indicate that the expansion is

 incomplete, since there are two file names matching the prefix ``D''.
 .PP
 If a partial file name is followed by the end-of-file character
 incomplete, since there are two file names matching the prefix ``D''.
 .PP
 If a partial file name is followed by the end-of-file character


@@ -339,7 +339,7 @@ alone is essentially a
 .PP
 To select words from an event we can follow the event specification by
 a `:' and a designator for the desired words.
 .PP
 To select words from an event we can follow the event specification by
 a `:' and a designator for the desired words.

-The words of a input line are numbered from 0,
+The words of an input line are numbered from 0,

 the first (usually command) word being 0, the second word (first argument)
 being 1, etc.
 The basic word designators are:
 the first (usually command) word being 0, the second word (first argument)
 being 1, etc.
 The basic word designators are:


@@ -374,7 +374,7 @@ The following modifiers are defined:
        t       Remove all leading pathname components, leaving the tail.
        &       Repeat the previous substitution.
        g       Apply the change globally, prefixing the above, e.g. `g&'.
        t       Remove all leading pathname components, leaving the tail.
        &       Repeat the previous substitution.
        g       Apply the change globally, prefixing the above, e.g. `g&'.

-       p       Print the new command but do not execute it.
+       p       Print the new command line but do not execute it.

        q       Quote the substituted words, preventing further substitutions.
        x       Like q, but break into words at blanks, tabs and newlines.
 .fi
        q       Quote the substituted words, preventing further substitutions.
        x       Like q, but break into words at blanks, tabs and newlines.
 .fi


@@ -524,7 +524,7 @@ and the rest of which become arguments.
 .PP
 Unless enclosed in `"' or given the `:q' modifier the results of variable
 substitution may eventually be command and filename substituted.
 .PP
 Unless enclosed in `"' or given the `:q' modifier the results of variable
 substitution may eventually be command and filename substituted.

-Within `"' a variable whose value consists of multiple words expands to a
+Within `"', a variable whose value consists of multiple words expands to a

 (portion of) a single word, with the words of the variables value
 separated by blanks.
 When the `:q' modifier is applied to a substitution
 (portion of) a single word, with the words of the variables value
 separated by blanks.
 When the `:q' modifier is applied to a substitution


@@ -599,7 +599,7 @@ $*
 .br
 Equivalent to `$argv[*]'.
 .PP
 .br
 Equivalent to `$argv[*]'.
 .PP

-The modifiers `:h', `:t', `:r', `:q' and `:x' may be applied to
+The modifiers `:e', `:h', `:t', `:r', `:q' and `:x' may be applied to

 the substitutions above as may `:gh', `:gt' and `:gr'.
 If braces `{' '}' appear in the command form then the modifiers
 must appear within the braces.
 the substitutions above as may `:gh', `:gt' and `:gr'.
 If braces `{' '}' appear in the command form then the modifiers
 must appear within the braces.


@@ -795,7 +795,7 @@ remains as the original standard input of the shell.  If this is a terminal
 and if the process attempts to read from the terminal, then the process
 will block and the user will be notified (see
 .B Jobs
 and if the process attempts to read from the terminal, then the process
 will block and the user will be notified (see
 .B Jobs

-above.)
+above).

 .PP
 Diagnostic output may be directed through a pipe with the standard output.
 Simply use the form `|\|&' rather than just `|'.
 .PP
 Diagnostic output may be directed through a pipe with the standard output.
 Simply use the form `|\|&' rather than just `|'.


@@ -924,12 +924,12 @@ or
 .HP 5
 .B  alloc
 .br
 .HP 5
 .B  alloc
 .br

-Shows the amount of dynamic core in use, broken down into used and
-free core, and address of the last location in the heap.
-With an argument shows each used and free block on the internal dynamic
-memory chain indicating its address, size, and whether it is used or free.
-This is a debugging command and may not work in production versions of the
-shell; it requires a modified version of the system memory allocator.
+Shows the amount of dynamic memory acquired, broken down into used and
+free memory.
+With an argument shows the number of free and used blocks in each size
+category.  The categories start at size 8 and double at each step.
+This command's output may vary across system types, since
+systems other than the VAX may use a different memory allocator.

 .HP 5
 .B bg
 .br
 .HP 5
 .B bg
 .br


@@ -978,7 +978,7 @@ statement as discussed below.
 .HP 5
 .BR chdir " name"
 .br
 .HP 5
 .BR chdir " name"
 .br

-Change the shells working directory to directory
+Change the shell's working directory to directory

 .I name.
 If no argument is given then change to the home directory of the user.
 .br
 .I name.
 If no argument is given then change to the home directory of the user.
 .br


@@ -1230,10 +1230,10 @@ If the specified
 .IR expr ""
 is true then the commands to the first
 .I else
 .IR expr ""
 is true then the commands to the first
 .I else

-are executed; else if
+are executed; otherwise if

 .IR expr2 ""
 is true then the commands to the
 .IR expr2 ""
 is true then the commands to the

-second else are executed, etc.
+second \fIelse\fR are executed, etc.

 Any number of
 .I else-if
 pairs are possible; only one
 Any number of
 .I else-if
 pairs are possible; only one


@@ -1363,7 +1363,7 @@ is set.
 .br
 .ns
 .HP 5
 .br
 .ns
 .HP 5

-.BR nice " \+number"
+.BR nice " +number"

 .br
 .ns
 .HP 5
 .br
 .ns
 .HP 5


@@ -1371,18 +1371,19 @@ is set.
 .br
 .ns
 .HP 5
 .br
 .ns
 .HP 5

-.BR nice " \+number command"
+.BR nice " +number command"

 .br
 The first form sets the
 .br
 The first form sets the

-.I nice
+scheduling priority

 for this shell to 4.
 The second form sets the
 for this shell to 4.
 The second form sets the

-.I nice
+priority

 to the given number.
 The final two forms run command at priority 4 and
 .I number
 respectively.
 to the given number.
 The final two forms run command at priority 4 and
 .I number
 respectively.

-The super-user may specify negative niceness by using `nice \-number ...'.
+The greater the number, the less cpu the process will get.
+The super-user may specify negative priority by using `nice \-number ...'.

 Command is always executed in a sub-shell, and the restrictions
 placed on commands in simple
 .I if
 Command is always executed in a sub-shell, and the restrictions
 placed on commands in simple
 .I if


@@ -1445,7 +1446,7 @@ continue to be ignored by the shell and all invoked commands.
 .BR "popd" " +n"
 .br
 Pops the directory stack, returning to the new top directory.
 .BR "popd" " +n"
 .br
 Pops the directory stack, returning to the new top directory.

-With a argument `+\fIn\fR' discards the \fIn\fR\|th
+With an argument `+\fIn\fR' discards the \fIn\fR\|th

 entry in the stack.
 The elements of the directory stack are numbered from 0 starting at the top.
 .HP 5
 entry in the stack.
 The elements of the directory stack are numbered from 0 starting at the top.
 .HP 5


@@ -2146,7 +2147,7 @@ or yields a non-zero exit status.
 \c
 The shell will start faster, because it will neither search for nor
 execute commands from the file
 \c
 The shell will start faster, because it will neither search for nor
 execute commands from the file

-`\&.cshrc' in the invokers home directory.
+`\&.cshrc' in the invoker's home directory.

 .TP 5
 .B  \-i
 \c
 .TP 5
 .B  \-i
 \c


@@ -2198,13 +2199,13 @@ as
 is to
 .B \-v.
 .PP
 is to
 .B \-v.
 .PP

-After processing of flag arguments if arguments remain but none of the
+After processing of flag arguments, if arguments remain but none of the

 .B \-c,
 .B \-i,
 .B \-s,
 or
 .B \-t
 .B \-c,
 .B \-i,
 .B \-s,
 or
 .B \-t

-options was given the first argument is taken as the name of a file of
+options was given, the first argument is taken as the name of a file of

 commands to be executed.
 The shell opens this file, and saves its name for possible resubstitution
 by `$0'.
 commands to be executed.
 The shell opens this file, and saves its name for possible resubstitution
 by `$0'.


@@ -2294,3 +2295,7 @@ to be combined with `|', and to be used with `&' and `;' metasyntax.
 It should be possible to use the `:' modifiers on the output of command
 substitutions.
 All and more than one `:' modifier should be allowed on `$' substitutions.
 It should be possible to use the `:' modifiers on the output of command
 substitutions.
 All and more than one `:' modifier should be allowed on `$' substitutions.

+.PP
+The way the
+.B filec
+facility is implemented is ugly and expensive.