reorg, move ms macro pieces

[unix-history] / usr / src / old / lex / lex.1

diff --git a/usr/src/old/lex/lex.1 b/usr/src/old/lex/lex.1
index 15f1449..5aa62f0 100644 (file)
--- a/usr/src/old/lex/lex.1
+++ b/usr/src/old/lex/lex.1
@@ -1,6 +1,6 @@
-.\"    @(#)lex.1       4.1 (Berkeley) %G%
+.\"    @(#)lex.1       6.2 (Berkeley) %G%

 .\"
 .\"

-.TH LEX 1 
+.TH LEX 1 ""

 .AT 3
 .SH NAME
 lex \- generator of lexical analysis programs
 .AT 3
 .SH NAME
 lex \- generator of lexical analysis programs


@@ -14,39 +14,22 @@ lex \- generator of lexical analysis programs
 generates programs to be used in simple lexical analyis of text.
 The input
 .I files
 generates programs to be used in simple lexical analyis of text.
 The input
 .I files

-(standard input default)
-contain regular expressions
+(standard input default) contain regular expressions

 to be searched for, and actions written in C to be executed when
 expressions are found.
 .PP
 to be searched for, and actions written in C to be executed when
 expressions are found.
 .PP

-A C source program, `lex.yy.c' is generated, to be compiled thus:
+A C source program, 'lex.yy.c' is generated, to be compiled thus:

 .IP
 cc lex.yy.c \-ll
 .LP
 This program, when run, copies unrecognized portions of
 .IP
 cc lex.yy.c \-ll
 .LP
 This program, when run, copies unrecognized portions of

-the input to the output,
-and executes the associated
+the input to the output, and executes the associated

 C action for each regular expression that is recognized.
 .PP
 C action for each regular expression that is recognized.
 .PP

-The following 
-.I lex
-program converts upper case to lower,
-removes blanks at the end of lines,
-and replaces multiple blanks by single blanks.
-.IP ""
-.nf
-.ta \w'[A\-Z] 'u
-%%
-[A\-Z] putchar(yytext[0]+\'a\'\-\'A\');
-[ ]+$
-[ ]+   putchar(\' \');
-.fi
-.PP

 The options have the following meanings.
 .TP
 .B \-t
 The options have the following meanings.
 .TP
 .B \-t

-Place the result on the standard output instead of in file
-`lex.yy.c'.
+Place the result on the standard output instead of in file "lex.yy.c".

 .TP
 .B \-v
 Print a one-line summary of statistics of the generated analyzer.
 .TP
 .B \-v
 Print a one-line summary of statistics of the generated analyzer.


@@ -58,8 +41,34 @@ Opposite of
 is default.
 .TP
 .B \-f
 is default.
 .TP
 .B \-f

-`Faster' compilation: don't bother to pack
+"Faster" compilation: don't bother to pack

 the resulting tables; limited to small programs.
 the resulting tables; limited to small programs.

+.SH EXAMPLE
+.IP
+lex lexcommands
+.PP
+would draw
+.I lex
+instructions from the file
+.I lexcommands,
+and place the output in
+.I lex.yy.c
+.IP ""
+.nf
+.ta \w'[A\-Z] 'u
+%%
+[A\-Z] putchar(yytext[0]+\'a\'\-\'A\');
+[ ]+$  ;
+[ ]+   putchar(\' \');
+.fi
+.PP
+is an example of a
+.I lex
+program that would be put into a
+.I lex
+command file.  This program converts upper case to lower,
+removes blanks at the end of lines,
+and replaces multiple blanks by single blanks.

 .SH "SEE ALSO"
 yacc(1), sed(1)
 .br
 .SH "SEE ALSO"
 yacc(1), sed(1)
 .br