bin/sh/USD.doc/t4

   1 .\"     $NetBSD: t4,v 1.3 2010/08/22 02:19:07 perry Exp $
   2 .\"
   3 .\" Copyright (C) Caldera International Inc. 2001-2002.  All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions are
   7 .\" met:
   8 .\"
   9 .\" Redistributions of source code and documentation must retain the above
  10 .\" copyright notice, this list of conditions and the following
  11 .\" disclaimer.
  12 .\"
  13 .\" Redistributions in binary form must reproduce the above copyright
  14 .\" notice, this list of conditions and the following disclaimer in the
  15 .\" documentation and/or other materials provided with the distribution.
  16 .\"
  17 .\" All advertising materials mentioning features or use of this software
  18 .\" must display the following acknowledgement:
  19 .\"
  20 .\" This product includes software developed or owned by Caldera
  21 .\" International, Inc.  Neither the name of Caldera International, Inc.
  22 .\" nor the names of other contributors may be used to endorse or promote
  23 .\" products derived from this software without specific prior written
  24 .\" permission.
  25 .\"
  26 .\" USE OF THE SOFTWARE PROVIDED FOR UNDER THIS LICENSE BY CALDERA
  27 .\" INTERNATIONAL, INC.  AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR
  28 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  29 .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  30 .\" DISCLAIMED.  IN NO EVENT SHALL CALDERA INTERNATIONAL, INC. BE LIABLE
  31 .\" FOR ANY DIRECT, INDIRECT INCIDENTAL, SPECIAL, EXEMPLARY, OR
  32 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  33 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
  34 .\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  35 .\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  36 .\" OR OTHERWISE) RISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
  37 .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38 .\"
  39 .\"     @(#)t4  8.1 (Berkeley) 8/14/93
  40 .\"
  41 .bp
  42 .SH
  43 Appendix\ A\ -\ Grammar
  44 .LP
  45 Note: This grammar needs updating, it is obsolete.
  46 .LP
  47 .LD
  48 \fIitem:                word
  49                 input-output
  50                 name = value
  51 .sp 0.7
  52 simple-command: item
  53                 simple-command item
  54 .sp 0.7
  55 command:        simple-command
  56                 \fB( \fIcommand-list \fB)
  57                 \fB{ \fIcommand-list \fB}
  58                 \fBfor \fIname \fBdo \fIcommand-list \fBdone
  59                 \fBfor \fIname \fBin \fIword \*(ZZ \fBdo \fIcommand-list \fBdone
  60                 \fBwhile \fIcommand-list \fBdo \fIcommand-list \fBdone
  61                 \fBuntil \fIcommand-list \fBdo \fIcommand-list \fBdone
  62                 \fBcase \fIword \fBin \fIcase-part \*(ZZ \fBesac
  63                 \fBif \fIcommand-list \fBthen \fIcommand-list \fIelse-part \fBfi
  64 .sp 0.7
  65 \fIpipeline:    command
  66                 pipeline \fB\*(VT\fI command
  67 .sp 0.7
  68 andor:  pipeline
  69                 andor \fB&&\fI pipeline
  70                 andor \fB\*(VT\*(VT\fI pipeline
  71 .sp 0.7
  72 command-list:   andor
  73                 command-list \fB;\fI
  74                 command-list \fB&\fI
  75                 command-list \fB;\fI andor
  76                 command-list \fB&\fI andor
  77 .sp 0.7
  78 input-output:   \fB> \fIfile
  79                 \fB< \fIfile
  80                 \fB\*(AP \fIword
  81                 \fB\*(HE \fIword
  82 .sp 0.7
  83 file:           word
  84                 \fB&\fI digit
  85                 \fB&\fI \(mi
  86 .sp 0.7
  87 case-part:      pattern\fB ) \fIcommand-list\fB ;;
  88 .sp 0.7
  89 \fIpattern:     word
  90                 pattern \fB\*(VT\fI word
  91 .sp 0.7
  92 \fIelse-part:   \fBelif \fIcommand-list\fB then\fI command-list else-part\fP
  93                 \fBelse \fIcommand-list\fI
  94                 empty
  95 .sp 0.7
  96 empty:
  97 .sp 0.7
  98 word:           \fRa sequence of non-blank characters\fI
  99 .sp 0.7
 100 name:           \fRa sequence of letters, digits or underscores starting with a letter\fI
 101 .sp 0.7
 102 digit:          \fB0 1 2 3 4 5 6 7 8 9\fP
 103 .DE
 104 .LP
 105 .bp
 106 .SH
 107 Appendix\ B\ -\ Meta-characters\ and\ Reserved\ Words
 108 .LP
 109 a) syntactic
 110 .RS
 111 .IP \fB\*(VT\fR 6
 112 pipe symbol
 113 .IP \fB&&\fR 6
 114 `andf' symbol
 115 .IP \fB\*(VT\*(VT\fR 6
 116 `orf' symbol
 117 .IP \fB;\fP 8
 118 command separator
 119 .IP \fB;;\fP 8
 120 case delimiter
 121 .IP \fB&\fP 8
 122 background commands
 123 .IP \fB(\ )\fP 8
 124 command grouping
 125 .IP \fB<\fP 8
 126 input redirection
 127 .IP \fB\*(HE\fP 8
 128 input from a here document
 129 .IP \fB>\fP 8
 130 output creation
 131 .IP \fB\*(AP\fP 8
 132 output append
 133 .sp 2
 134 .RE
 135 .LP
 136 b) patterns
 137 .RS
 138 .IP \fB\*(ST\fP 8
 139 match any character(s) including none
 140 .IP \fB?\fP 8
 141 match any single character
 142 .IP \fB[...]\fP 8
 143 match any of the enclosed characters
 144 .sp 2
 145 .RE
 146 .LP
 147 c) substitution
 148 .RS
 149 .IP \fB${...}\fP 8
 150 substitute shell variable
 151 .IP \fB$(...)\fP 8
 152 substitute command output
 153 .IP \fB\`...\`\fP 8
 154 substitute command output
 155 .IP \fB$((...))\fP 8
 156 substitute arithmetic expression
 157 .sp 2
 158 .RE
 159 .LP
 160 d) quoting
 161 .RS
 162 .IP \fB\e\fP 8
 163 quote the next character
 164 .IP \fB\'...\'\fP 8
 165 quote the enclosed characters except for \'
 166 .IP \fB"\&..."\fP 8
 167 quote the enclosed characters except
 168 for \fB$ \` \e "\fP
 169 .sp 2
 170 .RE
 171 .LP
 172 e) reserved words
 173 .DS
 174 .ft B
 175 if then else elif fi
 176 case in esac
 177 for while until do done
 178 ! {  }
 179 .ft
 180 .DE