1 b2cfc4e2 2003-09-30 devnull .TH REGEXP9 7
  2 b2cfc4e2 2003-09-30 devnull .de EX
  3 b2cfc4e2 2003-09-30 devnull .nf
  4 b2cfc4e2 2003-09-30 devnull .ft B
  5 b2cfc4e2 2003-09-30 devnull ..
  6 b2cfc4e2 2003-09-30 devnull .de EE
  7 b2cfc4e2 2003-09-30 devnull .fi
  8 b2cfc4e2 2003-09-30 devnull .ft R
  9 b2cfc4e2 2003-09-30 devnull ..
 10 b2cfc4e2 2003-09-30 devnull .de LR
 11 b2cfc4e2 2003-09-30 devnull .if t .BR \\$1 \\$2
 12 b2cfc4e2 2003-09-30 devnull .if n .RB ` \\$1 '\\$2
 13 b2cfc4e2 2003-09-30 devnull ..
 14 b2cfc4e2 2003-09-30 devnull .de L
 15 b2cfc4e2 2003-09-30 devnull .nh
 16 b2cfc4e2 2003-09-30 devnull .if t .B \\$1
 17 b2cfc4e2 2003-09-30 devnull .if n .RB ` \\$1 '
 18 b2cfc4e2 2003-09-30 devnull ..
 19 b2cfc4e2 2003-09-30 devnull .SH NAME
 20 b2cfc4e2 2003-09-30 devnull regexp9 \- Plan 9 regular expression notation
 21 b2cfc4e2 2003-09-30 devnull .SH DESCRIPTION
 22 b2cfc4e2 2003-09-30 devnull This manual page describes the regular expression
 23 b2cfc4e2 2003-09-30 devnull syntax used by the Plan 9 regular expression library
 24 b2cfc4e2 2003-09-30 devnull .IR regexp9 (3).
 25 b2cfc4e2 2003-09-30 devnull It is the form used by
 26 b2cfc4e2 2003-09-30 devnull .IR egrep (1)
 27 b2cfc4e2 2003-09-30 devnull before
 28 b2cfc4e2 2003-09-30 devnull .I egrep
 29 b2cfc4e2 2003-09-30 devnull got complicated.
 30 b2cfc4e2 2003-09-30 devnull .PP
 31 b2cfc4e2 2003-09-30 devnull A 
 32 b2cfc4e2 2003-09-30 devnull .I "regular expression"
 33 b2cfc4e2 2003-09-30 devnull specifies
 34 b2cfc4e2 2003-09-30 devnull a set of strings of characters.
 35 b2cfc4e2 2003-09-30 devnull A member of this set of strings is said to be
 36 b2cfc4e2 2003-09-30 devnull .I matched
 37 b2cfc4e2 2003-09-30 devnull by the regular expression.  In many applications
 38 b2cfc4e2 2003-09-30 devnull a delimiter character, commonly
 39 b2cfc4e2 2003-09-30 devnull .LR / ,
 40 b2cfc4e2 2003-09-30 devnull bounds a regular expression.
 41 b2cfc4e2 2003-09-30 devnull In the following specification for regular expressions
 42 b2cfc4e2 2003-09-30 devnull the word `character' means any character (rune) but newline.
 43 b2cfc4e2 2003-09-30 devnull .PP
 44 b2cfc4e2 2003-09-30 devnull The syntax for a regular expression
 45 b2cfc4e2 2003-09-30 devnull .B e0
 46 b2cfc4e2 2003-09-30 devnull is
 47 b2cfc4e2 2003-09-30 devnull .IP
 48 b2cfc4e2 2003-09-30 devnull .EX
 49 b2cfc4e2 2003-09-30 devnull e3:  literal | charclass | '.' | '^' | '$' | '(' e0 ')'
 50 b2cfc4e2 2003-09-30 devnull 
 51 b2cfc4e2 2003-09-30 devnull e2:  e3
 52 b2cfc4e2 2003-09-30 devnull   |  e2 REP
 53 b2cfc4e2 2003-09-30 devnull 
 54 b2cfc4e2 2003-09-30 devnull REP: '*' | '+' | '?'
 55 b2cfc4e2 2003-09-30 devnull 
 56 b2cfc4e2 2003-09-30 devnull e1:  e2
 57 b2cfc4e2 2003-09-30 devnull   |  e1 e2
 58 b2cfc4e2 2003-09-30 devnull 
 59 b2cfc4e2 2003-09-30 devnull e0:  e1
 60 b2cfc4e2 2003-09-30 devnull   |  e0 '|' e1
 61 b2cfc4e2 2003-09-30 devnull .EE
 62 b2cfc4e2 2003-09-30 devnull .PP
 63 b2cfc4e2 2003-09-30 devnull A
 64 b2cfc4e2 2003-09-30 devnull .B literal
 65 b2cfc4e2 2003-09-30 devnull is any non-metacharacter, or a metacharacter
 66 b2cfc4e2 2003-09-30 devnull (one of
 67 b2cfc4e2 2003-09-30 devnull .BR .*+?[]()|\e^$ ),
 68 b2cfc4e2 2003-09-30 devnull or the delimiter
 69 b2cfc4e2 2003-09-30 devnull preceded by 
 70 b2cfc4e2 2003-09-30 devnull .LR \e .
 71 b2cfc4e2 2003-09-30 devnull .PP
 72 b2cfc4e2 2003-09-30 devnull A
 73 b2cfc4e2 2003-09-30 devnull .B charclass
 74 b2cfc4e2 2003-09-30 devnull is a nonempty string
 75 b2cfc4e2 2003-09-30 devnull .I s
 76 b2cfc4e2 2003-09-30 devnull bracketed
 77 b2cfc4e2 2003-09-30 devnull .BI [ \|s\| ]
 78 b2cfc4e2 2003-09-30 devnull (or
 79 b2cfc4e2 2003-09-30 devnull .BI [^ s\| ]\fR);
 80 b2cfc4e2 2003-09-30 devnull it matches any character in (or not in)
 81 b2cfc4e2 2003-09-30 devnull .IR s .
 82 b2cfc4e2 2003-09-30 devnull A negated character class never
 83 b2cfc4e2 2003-09-30 devnull matches newline.
 84 b2cfc4e2 2003-09-30 devnull A substring 
 85 b2cfc4e2 2003-09-30 devnull .IB a - b\f1,
 86 b2cfc4e2 2003-09-30 devnull with
 87 b2cfc4e2 2003-09-30 devnull .I a
 88 b2cfc4e2 2003-09-30 devnull and
 89 b2cfc4e2 2003-09-30 devnull .I b
 90 b2cfc4e2 2003-09-30 devnull in ascending
 91 b2cfc4e2 2003-09-30 devnull order, stands for the inclusive
 92 b2cfc4e2 2003-09-30 devnull range of
 93 b2cfc4e2 2003-09-30 devnull characters between
 94 b2cfc4e2 2003-09-30 devnull .I a
 95 b2cfc4e2 2003-09-30 devnull and
 96 b2cfc4e2 2003-09-30 devnull .IR b .
 97 b2cfc4e2 2003-09-30 devnull In 
 98 b2cfc4e2 2003-09-30 devnull .IR s ,
 99 b2cfc4e2 2003-09-30 devnull the metacharacters
100 b2cfc4e2 2003-09-30 devnull .LR - ,
101 b2cfc4e2 2003-09-30 devnull .LR ] ,
102 b2cfc4e2 2003-09-30 devnull an initial
103 b2cfc4e2 2003-09-30 devnull .LR ^ ,
104 b2cfc4e2 2003-09-30 devnull and the regular expression delimiter
105 b2cfc4e2 2003-09-30 devnull must be preceded by a
106 b2cfc4e2 2003-09-30 devnull .LR \e ;
107 b2cfc4e2 2003-09-30 devnull other metacharacters 
108 b2cfc4e2 2003-09-30 devnull have no special meaning and
109 b2cfc4e2 2003-09-30 devnull may appear unescaped.
110 b2cfc4e2 2003-09-30 devnull .PP
111 b2cfc4e2 2003-09-30 devnull A 
112 b2cfc4e2 2003-09-30 devnull .L .
113 b2cfc4e2 2003-09-30 devnull matches any character.
114 b2cfc4e2 2003-09-30 devnull .PP
115 b2cfc4e2 2003-09-30 devnull A
116 b2cfc4e2 2003-09-30 devnull .L ^
117 b2cfc4e2 2003-09-30 devnull matches the beginning of a line;
118 b2cfc4e2 2003-09-30 devnull .L $
119 b2cfc4e2 2003-09-30 devnull matches the end of the line.
120 b2cfc4e2 2003-09-30 devnull .PP
121 b2cfc4e2 2003-09-30 devnull The 
122 b2cfc4e2 2003-09-30 devnull .B REP
123 b2cfc4e2 2003-09-30 devnull operators match zero or more
124 b2cfc4e2 2003-09-30 devnull .RB ( * ),
125 b2cfc4e2 2003-09-30 devnull one or more
126 b2cfc4e2 2003-09-30 devnull .RB ( + ),
127 b2cfc4e2 2003-09-30 devnull zero or one
128 b2cfc4e2 2003-09-30 devnull .RB ( ? ),
129 b2cfc4e2 2003-09-30 devnull instances respectively of the preceding regular expression 
130 b2cfc4e2 2003-09-30 devnull .BR e2 .
131 b2cfc4e2 2003-09-30 devnull .PP
132 b2cfc4e2 2003-09-30 devnull A concatenated regular expression,
133 b2cfc4e2 2003-09-30 devnull .BR "e1\|e2" ,
134 b2cfc4e2 2003-09-30 devnull matches a match to 
135 b2cfc4e2 2003-09-30 devnull .B e1
136 b2cfc4e2 2003-09-30 devnull followed by a match to
137 b2cfc4e2 2003-09-30 devnull .BR e2 .
138 b2cfc4e2 2003-09-30 devnull .PP
139 b2cfc4e2 2003-09-30 devnull An alternative regular expression,
140 b2cfc4e2 2003-09-30 devnull .BR "e0\||\|e1" ,
141 b2cfc4e2 2003-09-30 devnull matches either a match to
142 b2cfc4e2 2003-09-30 devnull .B e0
143 b2cfc4e2 2003-09-30 devnull or a match to
144 b2cfc4e2 2003-09-30 devnull .BR e1 .
145 b2cfc4e2 2003-09-30 devnull .PP
146 b2cfc4e2 2003-09-30 devnull A match to any part of a regular expression
147 b2cfc4e2 2003-09-30 devnull extends as far as possible without preventing
148 b2cfc4e2 2003-09-30 devnull a match to the remainder of the regular expression.
149 b2cfc4e2 2003-09-30 devnull .SH "SEE ALSO"
150 b2cfc4e2 2003-09-30 devnull .IR regexp9 (3)