# This is the sam package.
# To extract it, run /bin/sh on the part below --Cut Here--
# in a directory where the directory . exists
# or can be made with mkdir.
#
#--Cut Here--
f test -d . ; then echo . exists
else echo mkdir .; mkdir . ; fi
f test -d ./doc ; then echo ./doc exists
else echo mkdir ./doc; mkdir ./doc ; fi
f test -d ./include ; then echo ./include exists
else echo mkdir ./include; mkdir ./include ; fi
f test -d ./libXg ; then echo ./libXg exists
else echo mkdir ./libXg; mkdir ./libXg ; fi
f test -d ./libframe ; then echo ./libframe exists
else echo mkdir ./libframe; mkdir ./libframe ; fi
f test -d ./libregexp ; then echo ./libregexp exists
else echo mkdir ./libregexp; mkdir ./libregexp ; fi
f test -d ./sam ; then echo ./sam exists
else echo mkdir ./sam; mkdir ./sam ; fi
f test -d ./samterm ; then echo ./samterm exists
else echo mkdir ./samterm; mkdir ./samterm ; fi
echo ./version
-Version 4.3 built Wed May 6 14:45:00 EDT 1998
//GO.SYSIN DD ./version
echo ./README
-
- * The authors of this software are Rob Pike and Howard Trickey.
- * Copyright (c) 1998 by Lucent Technologies.
- * Permission to use, copy, modify, and distribute this software for any
- * purpose without fee is hereby granted, provided that this entire notice
- * is included in all copies of any software which is or includes a copy
- * or modification of this software and in all copies of the supporting
- * documentation for such software.
- * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
- * WARRANTY. IN PARTICULAR, NEITHER THE AUTHORS NOR LUCENT TECHNOLOGIES MAKE ANY
- * REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY
- * OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.
-
-This is an X11 version of Rob Pike's editor, sam. Documentation describing
-its use and construction are provided in subdirectory doc. The file doc/sam.1
-contains the manual page; doc/sam.tut.ms is a tutorial that can be
-formatted with troff -ms. It substitutes Bold and Italics for the
-fonts named CW and CS; if your system has these fonts, remove the
-CW and CS macros at the beginning of the file. The files doc/sam.ps
-and doc/se.ps are postscript versions of published papers describing
-sam and structural regular expressions. These papers reflect sam's
-capabilities at the time of publication several years ago; while the
-general description remains accurate, some functions may have changed
-or been removed. Other files in the doc directory contain manual pages
-for the library packages used by sam.
-
-Sam is composed of two programs: sam itself, which does the command processing
-and file manipulation; and samterm, which controls the display and
-interacts with the user. You can run sam on one machine and samterm on another
-connected via remote execution.
-
-This version of sam is based on the Plan 9 implementation. Its
-design and expression reflect the functionality of the Plan 9 environment;
-most notably, characters are represented internally by 16-bit values called
-Runes. Header files include/u.h and include/libc.h and source files
-libframe/misc.c, libXg/rune.c, sam/unix.c and samterm/unix.c contain
-code that insinuates sam into the Unix world. Two other files,
-sam/plan9.c and samterm/plan9.c, contain Plan 9-specific code; they
-are not used in the Unix version of sam and are provided as examples
-of the Plan 9 interface.
-
-Sam requires an ANSI/POSIX-compatible C compiler and libraries. We have
-found that some commercial compilers which claim to meet this standard are
-deficient. For our sanity, we only port sam to the standard; it is up to
-you to modify it for non-standard aspects of your local environment.
-Hints for some non-standard systems are provided at the end of this file.
-The handling of varargs is the source of many porting problems. We advise
-you to inspect the functions dprint and fprint in the files sam/unix.c and
-libframe/misc.c to ensure the accuracy of the implementation. We also
-encourage you to look at function newtmp() in sam/unix.c which creates
-a sam temporary file. We prefer to use the tempnam() function; it allows
-us to select the directory where the temp file is placed, a useful
-optimization for systems with small local disks. However, tempnam() is
-not a POSIX function, so you may have to use tmpfile() or a similar
-function to create the temporary file.
-
-The typedefs for uchar, ushort, and ulong defined in include/u.h, may conflict
-with exisiting definitions in include file <sys/types.h> on some systems.
-If this occurs, remove the offending definitions from include/u.h.
-
-The distribution consists of seven directories:
-
- sam - The source for sam. It loads against libXg to pick
- up some utility routines.
-
- samterm - The source for samterm. It loads against libframe,
- libXg, and your local X11 libraries.
-
- libframe - The source for the frame library. This library is used
- by samterm so it must be made first.
-
- libXg - The source code of the graphics library and some general
- utility modules. Header file u.h provides much of the
- interface between sam and the local environment. It is
- included in every source file. Sam's graphics
- operations are implemented by Plan 9 libg functions. This
- library emulates those functions using X11 operations.
- You might find libXg to be independently useful to tame the
- horrors of X11 programming. You can put it anywhere; the
- samterm makefiles assume it is in ../libXg. libXg must
- be made first.
-
- libregexp - The source code for Dave Presotto's implementation of
- the Plan 9 regular expression library. This library is
- not used by sam. It is provided as an example of a
- regular expression package that differs from sam's
- structured regular expression functionality.
-
- include - header files.
-
- doc - The documentation for sam and the libraries.
-
-Each source directory contains makefiles for several typical architectures.
-The master makefile in the top directory builds the subdirectories in
-proper order. Since the regular expression library is not used by
-sam, it is not built automatically from the top level.
-
-Most customization effort is confined to configuring the makefiles.
-You can usually minimize your work by copying the makefile for
-your architecture to Makefile and then editing a couple of lines.
-For example, to install sam on a Sun, go to each source subdirectory,
-copy Make.sun to Makefile, and customize each Makefile.
-
-Most of the time only the makefiles need configuration. Occasionally, it may
-be necessary to twiddle some of the macros and pre-processor magic in
-include/u.h or include/libc.h. In unusual cases, you may have to massage
-system-dependent code in files libXg/misc.c, sam/unix.c, or samterm/unix.c.
-Of course, systems with non-standard compilers or libraries may require
-minor modifications to any or all of the source files.
-
-Variables in each makefile define most configuration-dependent parameters; each
-is explained by a comment in the makefile. The RSAMNAME variable in
-sam/Makefile contains the name of the sam executable; this is only used when
-executing sam remotely. If sam is stored in the same path on every machine in
-your network or you use symbolic links to make it look like it is, this variable
-should specify the full path name of the executable. If sam resides in various
-directories on different machines, you've got a problem. The best strategy is to
-simply set the name of the file containing sam (usually, "sam") without a path
-component and rely on the users to set the directory in their PATH on the remote
-system. Unfortunately, this fails when the Berkeley rsh is used as the remote
-execution agent because it neglects to evaluate the user's profile in some
-situations.
-
-If a sam session terminates abnormally, sam creates a shell script named
-sam.save in the user's home directory. When this file is executed, it asks
-the user about each file and restores those selected. The files are restored
-with the names as they were known to sam; usually you will want to move
-sam.save to the last directory you had changed to in sam and restore the files
-from that point. The restoration script relies on a second script provided
-in sam/samsave. The SAMSAVEDIR variable in the sam Makefile contains the name
-of a directory to hold this script. The SAMSAVE variable contains the shell
-command to unpack each file; the command works with both the Bourne shell or
-Tom Duff's 'rc'.
-
-After configuring the makefiles, change to the top-level directory and
-type "make". Typing "make install" installs sam, samterm and samsave in
-their permanent homes.
-
-During testing, the path of samterm may be specified using the -t command line
-option to sam. Similarly, the path of sam itself may be specified using the
--s command line option; this is handy for testing the remote execution feature.
-
-You may want to install Sam.ad as "Sam" in the system application
-defaults library (which will have some name like /usr/lib/X11/app-defaults)
-or your own home directory, if you don't have permission to write in
-app-defaults. Sam.ad can be edited to give default values for things
-like the starting height and width, the font, and the foreground and
-background colors. Currently, only the -geom X11 parameter can be
-specified on the command line. New X11 parameters can be easily added
-by including the first character of the parameter in the switch statement
-in main() in file sam/sam.c. Valid parameter strings are passed to
-samterm and then directly to X11 for interpretation.
-
-The scripts 'B.sh' and and 'B.rc' for the Bourne Shell and 'rc', respectively,
-send a 'B' command to a runninng instance of sam and optionally position the
-file to a selected line. The scripts are located in the sam subdirectory;
-install one or both in the appropriate directory depending on the conventions
-of your site. There is no installation target for them in the makefiles.
-These commands require a POSIX-compliant named pipe facility; if your
-system lacks this capability, replace the code in exstart() in
-samterm/unix.c with a 'return' statement and throw away B.sh and B.rc.
-
-We have successfully made this distribution for IRIX 5.3 and SunOs 4.1.1
-in our lab. Additionally, Rich Salz, Dan McDonald,
-Alain Kagi and Ed Kubaitis have contributed prototype makefiles for
-other architectures. We are unable to test and verify them but
-they provide a good starting point for customizing a makefile.
-
-The original protocol between sam and samterm assumed that memory addresses
-and longs were 32 bits. Dave Hanson removed this dependency from the
-protocol allowing sam to run on 64-bit processors. However, other
-dependencies on structure alignment remain. If you are installing sam
-on a processor with 64-bit addresses, please read the comment immediately
-preceding the declaration of the Block data structure in file sam/sam.h
-(at approximately line 85), and fiddle with the declaration appropriately.
-
-Rob Pike designed and implemented the original Unix version of sam and the
-current version ported from Plan 9. Howard Trickey provided the X
-version of the graphics library, libXg. Matty Farrow and his colleagues
-at the University of Sydney extended libXg to support Runes. Boyd Roberts
-supplied the external command interface and the shell scripts for
-the 'B' command. Doug Gwyn contributed many useful ideas to the X
-implementation of sam. James Clark provided the simulations of the V10
-Unix Man macros at the beginning of each manual page.
-
-Matty Farrow of the University of Sydney has implemented 9term, an X11
-version of a Plan 9 window. It is available via anonymous FTP from
-ftp.cs.su.oz.au in directory /matty/unicode. Chris Siebenmann of the University
-of Toronto runs the sam-fans mailing list, a source of tips, bug patches,
-controversy and gossip among sam users. Send your e-mail address to
-sam-fans-request@hawkwind.utcs.toronto.edu to enroll in the list.
-
-Andrew Hume has written tcs, a Unix utility which converts input
-text in one user-specified character set to output text in another
-user-specified character set. It is useful for converting text represented
-in a variety of standard character set encodings to UTF, the standard
-character set accepted by sam. The tcs source package is available
-via ftp in file dist/tcs.shar.Z on research.att.com.
-
-In general, we are uninterested in adding further capabilities to sam; we
-provide the source to allow you to customize it if you wish to "improve" it.
-Please send bug fixes and comments to:
-
-Bob Flandrena, bobf@research.bell-labs.com
-
------------------------------------------------------------------------------------
- Following are modifications necessary to paper over compiler or
- library deficiencies to complying with the ANSI/POSIX standard. Please
- inform us of any other changes.
------------------------------------------------------------------------------------
-
- SUNOS Release 4.1.1
-
-The implementation of realloc does not conform to ANSI semantics.
-Sam assumes
-
- realloc(0, n);
-
-is equivalent to malloc(n). Replace each occurrence of
-
- p = realloc(p, n);
-
-with:
- p = ((p == 0) ? malloc(n) : realloc(p, n));
-
-or something equivalent. Several files that include the X11
-Intrinsics header file must have the variable SYSV defined
-before the inclusion. The shell script sun.ed attempts to
-automatically apply these patches when run from the top directory.
-
-Older versions of gcc lack the '-fno-builtin'. If this describes
-your site, remove the flag from the CFLAGS variable in Make.sun.
-
-Because the standard Sun compiler is not Ansi-compatible, frantic
-Sun users have been forced to cobble together their own compiling
-environment. Unfortunately, the resulting system configurations
-have little in common and it is virtually impossible to provide a
-universal build procedure. We suggest the use of gcc; other
-than that, Sun users are, as always, in the dark and on their own.
-
------------------------------------------------------------------------------------
-
- MIPS OS Release 4.5.2
- (and DEC ULTRIX Version 4.2A)
-
-There are two major deficiencies with the Mips implementation: the use of the
-old System V implementation of varargs and a compiler bug that botches the
-parsing of certain typedeffed parameters in function prototypes.
-
-The following changes are required:
-
-In sam/unix.c, replace function dprint with the following code:
- void
- dprint(char *fmt, int va_alist)
- va_dcl
- {
- va_list args;
- char buf[BLOCKSIZE];
-
- va_start(args);
- vsprintf(buf, fmt, args);
- termwrite(buf);
- va_end(args);
- }
-
-In libframe/misc.c, replace function fprint with the following code:
- void
- fprint(int fd, char *fmt, int va_alist)
- va_dcl
- {
- va_list args;
- char buf[2048]; /* pick reasonable blocksize */
-
- va_start(args);
- vsprintf(buf, fmt, args);
- write(fd, buf, strlen(buf));
- va_end(args);
- }
-
-In samterm/flayer.h, replace the declaration of the member named
-textfn (near line 20) in structure Flayer, currently declared as:
-
- Rune *(*textfn)(Flayer*, long, ulong*);
-
-with
- Rune *(*textfn)(Flayer*, long, unsigned long*);
-
-In sam/parse.h, replace the declaration of the member named fn
-(near line 46) in structure cmdtab, currently declared as:
-
- int (*fn)(File*, Cmd*); /* function to call with parse tree */
-with
- int (*fn)(File*, struct Cmd*); /* function to call with parse tree */
-
-In sam/sam.h, replace the declaration of function dprint (near line 245) with:
-
- void dprint();
-
-In include/libc.h, replace the declaration of function fprint (near line 53) with:
-
- void fprint();
-
-Near line 71 of samterm/samterm.h, change the declaration of function gettext from:
-
- Rune *gettext(Flayer*, long, ulong*);
-to
- Rune *gettext(Flayer*, long, unsigned long*);
-
-The shell script mips.ed attempts to automatically apply these patches when
-run from the top directory.
-
------------------------------------------------------------------------------------
-
- Convex ConvexOS 9.1
-
-In libXg/latin1.c, the Convex compiler requires room for a NULL at the end
-of the 2-byte character field in struct latin. This can be fixed by
-changing the dimension of the character array named 'c' near line 6 to
-3 from 2. This bug appears to be fixed in the compiler for Release 10.1.
-
------------------------------------------------------------------------------------
-
- Sequent PTX V2.0.3
-
-The calls to _exits() in sam/io.c near lines 184 and 205 clash with the
-prototype for a system function of the same name. Replace the statements
-
- _exits("damn");
-with
- _exits('d');
-
------------------------------------------------------------------------------------
-
- IBM AIX V3.2.3
-
-AIX xlc V1.2.1 generates bad code in the second call to border()
-in samterm/flayer.c:flborder() causing a core dump. Fix is to
-upgrade to later version of xlc (V1.2.1.4). Or, compile
-samterm/flayer.c (at least) with '-O'.
//GO.SYSIN DD ./README
echo ./boilerplate
-
-/*
- * The authors of this software are Rob Pike and Howard Trickey.
- * Copyright (c) 1998 by Lucent Technologies.
- * Permission to use, copy, modify, and distribute this software for any
- * purpose without fee is hereby granted, provided that this entire notice
- * is included in all copies of any software which is or includes a copy
- * or modification of this software and in all copies of the supporting
- * documentation for such software.
- * THIS SOFTWARE IS BEING PROVIDED "AS IS", WITHOUT ANY EXPRESS OR IMPLIED
- * WARRANTY. IN PARTICULAR, NEITHER THE AUTHORS NOR LUCENT TECHNOLOGIES MAKE ANY
- * REPRESENTATION OR WARRANTY OF ANY KIND CONCERNING THE MERCHANTABILITY
- * OF THIS SOFTWARE OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.
- */
//GO.SYSIN DD ./boilerplate
echo ./sam/samsave
-#!/bin/sh
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-PATH=/bin:/usr/bin
-file=$1
-case "$2" in
--f) echo "$file"
- cat > $file
- ;;
-"") echo "$file?"
- read yn < /dev/tty
- case "$yn" in
- [Yy]*) cat > $file
- esac
-esac
//GO.SYSIN DD ./sam/samsave
echo ./sam/B.sh
-#!/bin/sh
-
-files=
-line="none"
-
-if [ $# = 0 ]; then
- echo 'usage: B [-nnnn] files...' 1>&2
- exit 1
-fi
-
-dir=`/bin/pwd`
-if [ "$USER" = "" ]; then
- USER=$LOGNAME
-fi
-pipe=/tmp/.sam.$USER
-
-case "$DISPLAY" in
- *:[0-9]*\.[0-9]*)
- pipe=$pipe.$DISPLAY
- if [ ! -r $pipe ]; then
- pipe=`echo $pipe | sed 's/\.[0-9]*$//'`
- fi
- ;;
- *:[0-9]*)
- pipe=$pipe.$DISPLAY
- if [ ! -r $pipe ]; then
- pipe=$pipe.0
- fi
- ;;
- "")
- ;;
- *) pipe=$pipe.$DISPLAY
- ;;
-esac
-if [ ! -r $pipe ]; then
- echo `basename $0`": No pipe \""$pipe"\" to sam." 1>&2
- exit 1
-fi
-
-for i in $*
-do
- case "$i" in
- /*) files="$files $i"
- ;;
- -*) line=`echo $i | sed 's/.//'`
- ;;
- *) files="$files $dir/$i"
- ;;
- esac
-done
-
-echo "B $files" >> $pipe
-if [ $line != "none" ]; then
- echo $line >> $pipe
-fi
-
//GO.SYSIN DD ./sam/B.sh
echo ./sam/B.rc
-#!/bin/rc
-
-files=()
-line=''
-
-if (~ $#* 0) {
- echo 'usage: B [-nnn] files...' >[1=2]
- exit 1
-}
-
-dir=`{/bin/pwd}
-
-if (~ $#USER 0)
- USER=$LOGNAME
-pipe=/tmp/.sam.$USER
-
-switch($DISPLAY) {
- case *:[0-9]*.[0-9]*
- pipe=$pipe.$DISPLAY
- if (! test -r $pipe)
- pipe=`{echo $pipe | sed 's/\.[0-9]*$//'}
- case *:[0-9]*
- pipe=$pipe.$DISPLAY
- if (! test -r $pipe)
- pipe=$pipe.0
- case ""
- case *
- pipe=$pipe.$DISPLAY
-}
-
-if (! test -r $pipe) {
- echo `{basename $0}^': No pipe "'$pipe'" to sam.' >[1=2]
- exit 1
-}
-
-for (i) {
- switch($i) {
- case /*
- files = ( $files $i )
- case -*
- line = `{echo $i | sed 's/.//'}
- case *
- files = ( $files $dir/$i )
- }
-}
-
-if (! ~ $#files 0)
- echo B $files >> $pipe
-
-if (! ~ $line '')
- echo $line >> $pipe
//GO.SYSIN DD ./sam/B.rc
echo ./mips.ed
-#!/bin/sh
-
-echo "patching sam/unix.c"
-ed sam/unix.c << EOF
-/^dprint/,$ c
-dprint(char *fmt, int va_alist)
-va_dcl
-{
- va_list args;
- char buf[BLOCKSIZE];
-
- va_start(args);
- vsprintf(buf, fmt, args);
- termwrite(buf);
- va_end(args);
-}
-.
-w
-q
-EOF
-echo "patching libframe/misc.c"
-ed libframe/misc.c << EOF
-/^fprint/,/^}/c
-fprint(int fd, char *fmt, int va_alist)
-va_dcl
-{
- va_list args;
- char buf[2048]; /* pick reasonable blocksize */
-
- va_start(args);
- vsprintf(buf, fmt, args);
- write(fd, buf, strlen(buf));
- va_end(args);
-}
-.
-w
-q
-EOF
-echo "patching samterm/flayer.h"
-ed samterm/flayer.h << EOF
-/ Rune.*\*(\*textfn/s/ulong/unsigned long/
-w
-q
-EOF
-echo "patching sam/parse.h"
-ed sam/parse.h << EOF
-/ int.*(\*fn)/s/Cmd/struct Cmd/
-w
-q
-EOF
-echo "patching sam/sam.h"
-ed sam/sam.h << EOF
-/dprint/s/(.*)/()/
-w
-q
-EOF
-echo "patching include/libc.h"
-ed include/libc.h << EOF
-/fprint/s/(.*)/()/
-w
-q
-EOF
-echo "patching samterm/samterm.h"
-ed samterm/samterm.h << EOF
-/^Rune.*\*gettext/s/ulong/unsigned long/
-w
-q
-EOF
//GO.SYSIN DD ./mips.ed
echo ./sun.ed
-#!/bin/sh
-
-echo "patching sam/unix.c"
-ed sam/unix.c << EOF
-/ p.*=.*realloc/c
- p = p ? realloc(p, n) : malloc(n);
-.
-w
-q
-EOF
-echo "patching samterm/flayer.c"
-ed samterm/flayer.c << EOF
-/llist = realloc/c
- llist = llist ? realloc(llist, nlalloc*sizeof(Flayer**)) : malloc(nlalloc*sizeof(Flayer**));
-.
-w
-q
-EOF
-echo "patching samterm/mesg.c"
-ed samterm/mesg.c << EOF
-/s1 = realloc/c
- s1 = s1 ? realloc(s1, n+1) : malloc(n+1);
-.
-w
-q
-EOF
-echo "patching libframe/frbox.c"
-ed libframe/frbox.c << EOF
-/.*f->box.*=.*realloc/c
- f->box = f->box ? realloc(f->box, f->nalloc*sizeof(Frbox)) : malloc(f->nalloc*sizeof(Frbox));
-.
-w
-q
-EOF
-echo "patching libframe/frinsert.c"
-ed libframe/frinsert.c << EOF
-/[ ]*pts.*=.*realloc/c
- pts = pts ? realloc(pts, (npts+DELTA)*sizeof(pts[0])) : malloc((npts+DELTA)*sizeof(pts[0]));
-.
-w
-q
-EOF
-for i in 9term/display.c libXg/gwin.c libXg/wrbitmap.c libXg/xtbinit.c
-do
- echo "patching $i"
- ed $i << EOF
-/^#include.*Intrinsic/i
-#define SYSV
-.
-/^#include.*Intrinsic/a
-#undef SYSV
-.
-w
-q
-EOF
-done
//GO.SYSIN DD ./sun.ed
echo ./doc/sam.1
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.br
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.ds a \fR*\ \fP
-.TH SAM 1
-.CT 1 editor
-.SH NAME
-sam \- screen editor with structural regular expressions
-.SH SYNOPSIS
-.B sam
-[
-.I option .\|.\|.
-] [
-.I files
-]
-.PP
-.B sam
-.B \-r
-.I machine
-.PP
-.B sam.save
-.PP
-.B B
-[
-.BI \-nnnn
-]
-.I file .\|.\|.
-.SH DESCRIPTION
-.I Sam
-is a multi-file editor.
-It modifies a local copy of an external file.
-The copy is here called a
-.IR file .
-The files are listed in a menu available through mouse button 3
-or the
-.B n
-command.
-Each file has an associated name, usually the name of the
-external file from which it was read, and a `modified' bit that indicates whether
-the editor's file agrees with the external file.
-The external file is not read into
-the editor's file until it first becomes the current file\(emthat to
-which editing commands apply\(emwhereupon its menu entry is printed.
-The options are
-.TF "\-r machine "
-.TP
-.B \-d
-Do not download the terminal part of
-.I sam.
-Editing will be done with the command language only, as in
-.IR ed (1).
-.TP
-.BI \-r " machine
-Run the host part remotely
-on the specified machine, the terminal part locally.
-.TP
-.BI \-s " file
-Start the host part from the indicated file on the
-remote host. Only meaningful with the
-.BI \-r
-option.
-.TP
-.BI \-t " path
-Start the terminal part from the indicated file.
-Useful for debugging.
-.PP
-The standard X11
-.BI \-geom
-toolkit option can be used
-to select the desired window geometry.
-.SS Regular expressions
-Regular expressions are as in
-.IR regexp (6)
-with the addition of
-.BR \en
-to represent newlines.
-A regular expression may never contain a literal newline character.
-The elements of regular expressions are:
-.TF "[^abc] "
-.TP
-.B .
-Match any character except newline.
-.TP
-.B \en
-Match newline.
-.TP
-.B \ex
-For any character except
-.B n
-match the character (here
-.BR x ).
-.TP
-.B [abc]
-Match any character in the square brackets.
-.B \en
-may be mentioned.
-.TP
-.B [^abc]
-Match any character not in the square brackets, but never a newline.
-Both these forms accept a range of
-.SM ASCII
-characters indicated by
-a dash, as in
-.BR a\-z .
-.TP
-.B ^
-Match the null string immediately after a newline.
-.TP
-.B $
-Match the null string immediately before a newline.
-.PP
-Any other character except newline matches itself.
-.PP
-In the following,
-.I r1
-and
-.I r2
-are regular expressions.
-.TF "r1|r2 "
-.TP
-.BI ( r1 )
-Match what
-.I r1
-matches.
-.TP
-.IB r1 | r2
-Match what
-.I r1
-or what
-.IR r2
-matches.
-.TP
-.IB r1 *
-Match zero or more adjacent matches
-of
-.IR r1 .
-.TP
-.IB r1 +
-Match one or more adjacent matches of
-.IR r1 .
-.TP
-.IB r1 ?
-Match zero or one matches of
-.IR r1 .
-.PP
-The operators
-.BR * ,
-.B +
-and
-.B ?
-are highest precedence, then catenation, then
-.B |
-is lowest.
-The empty
-regular expression stands for the last complete expression encountered.
-A regular expression in
-.I sam
-matches the longest leftmost substring formally
-matched by the expression.
-Searching in the reverse direction is equivalent
-to searching backwards with the catenation operations reversed in
-the expression.
-.SS Addresses
-An address identifies a substring in a file.
-In the following, `character
-.IR n '
-means the null string
-after the
-\%\fIn\fP-th
-character in the file, with 1 the
-first character in the file.
-`Line
-.IR n '
-means the
-.IR n -th
-match,
-starting at the beginning of the file, of the regular expression
-.LR .*\en? .
-(The peculiar properties of a last line without a newline are
-temporarily undefined.)
-All files always have a current substring, called dot,
-that is the default address.
-.SS Simple Addresses
-.TF ?regexp?
-.TP
-.BI # n
-The empty string after character
-.IR n ;
-.B #0
-is the beginning of the file.
-.TP
-.I n
-Line
-.IR n .
-.TP
-.BI / regexp /
-.PD0
-.TP
-.BI ? regexp ?
-The substring that matches the regular expression,
-found by looking toward the end
-.RB ( / )
-or beginning
-.RB ( ? )
-of the file,
-and if necessary continuing the search from the other end to the
-starting point of the search.
-The matched substring may straddle
-the starting point.
-When entering a pattern containing a literal question mark
-for a backward search, the question mark should be
-specified as a member of a class.
-.PD
-.TP
-.B 0
-The string before the first full line.
-This is not necessarily
-the null string; see
-.B +
-and
-.B \-
-below.
-.TP
-.B $
-The null string at the end of the file.
-.TP
-.B .
-Dot.
-.TP
-.B \&'
-The mark in the file (see the
-.B k
-command below).
-.TP
-\f(CW"\f2regexp\f(CW"\f1\f1
-Preceding a simple address (default
-.BR . ),
-refers to the address evaluated in the unique file whose menu line
-matches the regular expression.
-.SS Compound Addresses
-In the following,
-.I a1
-and
-.I a2
-are addresses.
-.TF "a1+a2 "
-.TP
-.IB a1 + a2
-The address
-.I a2
-evaluated starting at the end of
-.IR a1 .
-.TP
-.IB a1 \- a2
-The address
-.I a2
-evaluated looking in the reverse direction
-starting at the beginning of
-.IR a1 .
-.TP
-.IB a1 ,\^ a2
-The substring from the beginning of
-.I a1
-to the end of
-.IR a2 .
-If
-.I a1
-is missing,
-.B 0
-is substituted.
-If
-.I a2
-is missing,
-.B $
-is substituted.
-.TP
-.IB a1 ;\^ a2
-Like
-.IB a1 ,\^ a2,
-but with
-.I a2
-evaluated at the end of, and dot set to,
-.IR a1 .
-.PP
-The operators
-.B +
-and
-.B \-
-are high precedence, while
-.B ,
-and
-.B ;
-are low precedence.
-.PP
-In both
-.B +
-and
-.B \-
-forms, if
-.I a2
-is a line or character address with a missing
-number, the number defaults to 1.
-If
-.I a1
-is missing,
-.L .
-is substituted.
-If both
-.I a1
-and
-.I a2
-are present and distinguishable,
-.B +
-may be elided.
-.I a2
-may be a regular
-expression; if it is delimited by
-.LR ? 's,
-the effect of the
-.B +
-or
-.B \-
-is reversed.
-.PP
-It is an error for a compound address to represent a malformed substring.
-Some useful idioms:
-.IB a1 +\^\-
-.RI ( a1 \&\f5\-\^+\fP )
-selects the line containing
-the end (beginning) of a1.
-.BI 0/ regexp /
-locates the first match of the expression in the file.
-(The form
-.B 0;\^//
-sets dot unnecessarily.)
-.BI .\^/ regexp ///
-finds the second following occurrence of the expression,
-and
-.BI .\^,\^/ regexp /
-extends dot.
-.SS Commands
-In the following, text demarcated by slashes represents text delimited
-by any printable
-.SM ASCII
-character except alphanumerics.
-Any number of
-trailing delimiters may be elided, with multiple elisions then representing
-null strings, but the first delimiter must always
-be present.
-In any delimited text,
-newline may not appear literally;
-.B \en
-may be typed for newline; and
-.B \e\^/
-quotes the delimiter, here
-.LR / .
-Backslash is otherwise interpreted literally, except in
-.B s
-commands.
-.PP
-Most commands may be prefixed by an address to indicate their range
-of operation.
-Those that may not are marked with a
-.L *
-below.
-If a command takes
-an address and none is supplied, dot is used.
-The sole exception is
-the
-.B w
-command, which defaults to
-.BR 0\^,\^$ .
-In the description, `range' is used
-to represent whatever address is supplied.
-Many commands set the
-value of dot as a side effect.
-If so, it is always set to the `result'
-of the change: the empty string for a deletion, the new text for an
-insertion, etc. (but see the
-.B s
-and
-.B e
-commands).
-.br
-.ne 1.2i
-.SS Text commands
-.PD0
-.TP
-.BI a/ text /
-.TP
-or
-.TP
-.B a
-.TP
-.I lines of text
-.TP
-.B .
-Insert the text into the file after the range.
-Set dot.
-.TP
-.B c\fP
-.br
-.ns
-.TP
-.B i\fP
-Same as
-.BR a ,
-but
-.B c
-replaces the text, while
-.B i
-inserts
-.I before
-the range.
-.TP
-.B d
-Delete the text in the range.
-Set dot.
-.TP
-.BI s/ regexp / text /
-Substitute
-.I text
-for the first match to the regular expression in the range.
-Set dot to the modified range.
-In
-.I text
-the character
-.B &
-stands for the string
-that matched the expression.
-Backslash behaves as usual unless followed by
-a digit:
-.BI \e \^d
-stands for the string that matched the
-subexpression begun by the
-.IR d -th
-left parenthesis.
-If
-.I s
-is followed immediately by a
-number
-.IR n ,
-as in
-.BR s2/x/y/ ,
-the
-.IR n -th
-match in the range is substituted.
-If the
-command is followed by a
-.BR g ,
-as in
-.BR s/x/y/g ,
-all matches in the range
-are substituted.
-.TP
-.BI m " a1
-.br
-.ns
-.TP
-.BI t " a1
-Move the range to after
-.I a1
-.RB ( m ),
-or copy it
-.RB ( t ).
-Set dot.
-.SS Display commands
-.TP
-.B p
-Print the text in the range.
-Set dot.
-.TP
-.B =
-Print the line address and character address of the range.
-.TP
-.B =#
-Print just the character address of the range.
-.SS File commands
-.TP
-.BI \*ab " file-list
-Set the current file to the first file named in the list
-that
-.I sam
-also has in its menu.
-The list may be expressed
-.BI < "shell command"
-in which case the file names are taken as words (in the shell sense)
-generated by the shell command.
-.TP
-.BI \*aB " file-list
-Same as
-.BR b ,
-except that file names not in the menu are entered there,
-and all file names in the list are examined.
-.TP
-.B \*an
-Print a menu of files.
-The format is:
-.RS
-.TF "XorXblankXX"
-.TP
-.BR ' " or blank"
-indicating the file is modified or clean,
-.TP
-.BR \- " or \&" +
-indicating the file is unread or has been read
-(in the terminal,
-.B *
-means more than one window is open),
-.TP
-.BR . " or blank
-indicating the current file,
-.TP
-a blank,
-.TP
-and the file name.
-.RE
-.TP 0
-.BI \*aD " file-list
-Delete the named files from the menu.
-If no files are named, the current file is deleted.
-It is an error to
-.B D
-a modified file, but a subsequent
-.B D
-will delete such a file.
-.SS I/O Commands
-.TP
-.BI \*ae " filename
-Replace the file by the contents of the named external file.
-Set dot to the beginning of the file.
-.TP
-.BI r " filename
-Replace the text in the range by the contents of the named external file.
-Set dot.
-.TP
-.BI w " filename
-Write the range (default
-.BR 0\^,\^$ )
-to the named external file.
-.TP
-.BI \*af " filename
-Set the file name and print the resulting menu entry.
-.PP
-If the file name is absent from any of these, the current file name is used.
-.B e
-always sets the file name,
-.B r
-and
-.B w
-do so if the file has no name.
-.TP
-.BI < " shell-command
-Replace the range by the standard output of the
-shell command.
-.TP
-.BI > " shell-command
-Sends the range to the standard input of the
-shell command.
-.TP
-.BI | " shell-command
-Send the range to the standard input, and replace it by
-the standard output, of the
-shell command.
-.TP
-.BI \*a! " shell-command
-Run the
-shell command.
-.TP
-.BI \*acd " directory
-Change working directory.
-If no directory is specified,
-.B $HOME
-is used.
-.PP
-In any of
-.BR < ,
-.BR > ,
-.B |
-or
-.BR ! ,
-if the
-.I shell command
-is omitted the last
-.I shell command
-(of any type) is substituted.
-If
-.I sam
-is downloaded,
-.B !
-sets standard input to
-.FR /dev/null ,
-and otherwise
-unassigned output
-.RB ( stdout
-for
-.B !
-and
-.BR > ,
-.B stderr
-for all) is placed in
-.F $HOME/sam.err
-and the first few lines are printed.
-.SS Loops and Conditionals
-.TP
-.BI x/ regexp / " command
-For each match of the regular expression in the range, run the command
-with dot set to the match.
-Set dot to the last match.
-If the regular
-expression and its slashes are omitted,
-.L /.*\en/
-is assumed.
-Null string matches potentially occur before every character
-of the range and at the end of the range.
-.TP
-.BI y/ regexp / " command
-Like
-.B x,
-but run the command for each substring that lies before, between,
-or after
-the matches that would be generated by
-.BR x .
-There is no default behavior.
-Null substrings potentially occur before every character
-in the range.
-.TP
-.BI \*aX/ regexp / " command
-For each file whose menu entry matches the regular expression,
-make that the current file and
-run the command.
-If the expression is omitted, the command is run
-in every file.
-.TP
-.BI \*aY/ regexp / " command
-Same as
-.BR X ,
-but for files that do not match the regular expression,
-and the expression is required.
-.TP
-.BI g/ regexp / " command
-.br
-.ns
-.TP
-.BI v/ regexp / " command
-If the range contains
-.RB ( g )
-or does not contain
-.RB ( v )
-a match for the expression,
-set dot to the range and run the command.
-.PP
-These may be nested arbitrarily deeply, but only one instance of either
-.B X
-or
-.B Y
-may appear in a \%single command.
-An empty command in an
-.B x
-or
-.B y
-defaults to
-.BR p ;
-an empty command in
-.B X
-or
-.B Y
-defaults to
-.BR f .
-.B g
-and
-.B v
-do not have defaults.
-.SS Miscellany
-.TP
-.B k
-Set the current file's mark to the range. Does not set dot.
-.TP
-.B \*aq
-Quit.
-It is an error to quit with modified files, but a second
-.B q
-will succeed.
-.TP
-.BI \*au " n
-Undo the last
-.I n
-(default 1)
-top-level commands that changed the contents or name of the
-current file, and any other file whose most recent change was simultaneous
-with the current file's change.
-Successive
-.BR u 's
-move further back in time.
-The only commands for which u is ineffective are
-.BR cd ,
-.BR u ,
-.BR q ,
-.B w
-and
-.BR D .
-.TP
-(empty)
-If the range is explicit, set dot to the range.
-If
-.I sam
-is downloaded, the resulting dot is selected on the screen;
-otherwise it is printed.
-If no address is specified (the
-command is a newline) dot is extended in either direction to
-line boundaries and printed.
-If dot is thereby unchanged, it is set to
-.B .+1
-and printed.
-.PD
-.SS Grouping and multiple changes
-Commands may be grouped by enclosing them in braces
-.BR {} .
-Commands within the braces must appear on separate lines (no backslashes are
-required between commands).
-Semantically, an opening brace is like a command:
-it takes an (optional) address and sets dot for each sub-command.
-Commands within the braces are executed sequentially, but changes made
-by one command are not visible to other commands (see the next paragraph).
-Braces may be nested arbitrarily.
-.PP
-When a command makes a number of changes to a file, as in
-.BR x/re/c/text/ ,
-the addresses of all changes to the file are computed in the original file.
-If the changes are in sequence,
-they are applied to the file.
-Successive insertions at the same address are catenated into a single
-insertion composed of the several insertions in the order applied.
-.SS The terminal
-What follows refers to behavior of
-.I sam
-when downloaded, that is, when
-operating as a display editor on a bitmap display.
-This is the default
-behavior; invoking
-.I sam
-with the
-.B \-d
-(no download) option provides access
-to the command language only.
-.PP
-Each file may have zero or more windows open.
-Each window is equivalent
-and is updated simultaneously with changes in other windows on the same file.
-Each window has an independent value of dot, indicated by a highlighted
-substring on the display.
-Dot may be in a region not within
-the window.
-There is usually a `current window',
-marked with a dark border, to which typed text and editing
-commands apply.
-The escape key (ESC) selects (sets dot to) text typed
-since the last mouse button hit.
-.PP
-The button 3 menu controls window operations.
-The top of the menu
-provides the following operators, each of which uses one or
-more cursors to prompt for selection of a window or sweeping
-of a rectangle.
-.TF "reshape "
-.TP
-.B new
-Create a new, empty file:
-Depress button 3 where one corner of the new rectangle should
-appear (box cursor), and move the mouse while holding down button 3 to the
-diagonally opposite corner.
-`Sweeping' a null rectangle gets a large window, disjoint
-from the command window or the whole sam window, depending on
-where the null rectangle is.
-.TP
-.B xerox
-Create a copy of an existing window.
-After selecting the window to copy with button 1,
-sweep out the window for the copy.
-.TP
-.B reshape
-Change the size and location of a window.
-First click button 3 in the window to be changed
-(gunsight cursor).
-Then sweep out a window as for the
-.B new
-menu selection.
-.TP
-.B close
-Delete the window.
-In the last window of a file,
-.B close
-is equivalent to a
-.B D
-for the file.
-.TP
-.B write
-Equivalent to a
-.B w
-for the file.
-.PD
-.PP
-Below these operators is a list of available files, starting with
-.BR ~~sam~~ ,
-the command window.
-Selecting a file from the list makes the most recently
-used window on that file current, unless it is already current, in which
-case selections cycle through the open windows.
-If no windows are open
-on the file, the user is prompted to open one.
-Files other than
-.B ~~sam~~
-are marked with one of the characters
-.B \-\^+*
-according as zero, one, or more windows
-are open on the file.
-A further mark
-.L .
-appears on the file in the current window and
-a single quote,
-.BR ' ,
-on a file modified since last write.
-.PP
-The command window, created automatically when
-.B sam
-starts, is an ordinary window except that text typed to it
-is interpreted as commands for the editor rather than passive text,
-and text printed by editor commands appears in it.
-There is an `output point' that separates commands being typed from
-previous output.
-Commands typed in the command window apply to the
-current open file\(emthe file in the most recently
-current window.
-.SS Manipulating text
-Typed characters replace the current selection (dot) in the current
-window.
-Backspace deletes the previous character.
-Escape selects (sets dot to) everything typed since the last mouse hit.
-.PP
-Button 1 changes selection.
-Pointing to a non-current window with button 1 makes it current;
-within the current window, button 1 selects text, thus setting dot.
-Double-clicking selects text to the boundaries of words, lines,
-quoted strings or bracketed strings, depending on the text at the click.
-.PP
-Button 2 provides a menu of editing commands:
-.TF "/regexp"
-.TP
-.B cut
-Delete dot and save the deleted text in the snarf buffer.
-.TP
-.B paste
-Replace the text in dot by the contents of the snarf buffer.
-.TP
-.B snarf
-Save the text in dot in the snarf buffer.
-.TP
-.B look
-Search forward for the next occurrence of the literal text in dot.
-If dot is the null string, the text in the snarf buffer is
-used.
-The snarf buffer is unaffected.
-.TP
-.B <exch>
-Exchange the snarf buffer with the current selection in another X11 window.
-The exchange of a large amount of selected text is truncated to the
-size of Sam's internal snarf buffer (currently 4K) without warning.
-.TP
-.BI / regexp
-Search forward for the next match of the last regular expression
-typed in a command.
-(Not in command window.)
-.TP
-.B send
-Send the text in dot, or the snarf buffer if
-dot is the null string, as if it were typed to the command window.
-Saves the sent text in the snarf buffer.
-(Command window only.)
-.PD
-.SS X11 resources
-Various attributes of
-.I sam
-can be set by giving values to X11 resources for the class
-.B Sam.
-There are various ways to do this; one is to have a file
-called
-.B Sam
-in your home directory, with entries in it like:
-.PP
-.CW
-.nf
- Sam*width: 500
- Sam*height: 600
- Sam*font: fixed
- Sam*scrollForwardR: true
-.fi
-.PP
-In addition to the usual X11 toolkit resources, the
-.B scrollForwardR
-resource says where the right button (button 3) scrolls
-forward or backward in the file.
-.SS Abnormal termination
-If
-.I sam
-terminates other than by a
-.B q
-command (by hangup, deleting its window, etc.), modified
-files are saved in an
-executable file,
-.FR $HOME/sam.save .
-This program, when executed, asks whether to write
-each file back to a external file.
-The answer
-.L y
-causes writing; anything else skips the file.
-If a machine crash prevents the creation of a
-.F sam.save
-file, all changes are lost.
-If an editing session is difficult to replicate,
-you should write your changed files often.
-.PP
-.I B
-is a shell-level command that causes an instance of
-.I sam
-running on the same terminal to load the named
-.I files.
-The option allows a line number to be specified for
-the initial position to display in the last named file.
-.SH FILES
-.F $HOME/sam.save
-.br
-.F $HOME/sam.err
-.br
-.B <system-dependent dirctory>/samsave
-the program called to unpack
-.BR $home/sam.save .
-.SH SEE ALSO
-.IR ed (1),
-.IR regexp (6)
-.SH BUGS
-.PP
-When a sam window is resized, the command window may have the wrong size.
//GO.SYSIN DD ./doc/sam.1
echo ./doc/sam.tut.ms
-.de P1
-.KS
-.DS
-.ft CW
-.ta 5n 10n 15n 20n 25n 30n 35n 40n 45n 50n 55n 60n 65n 70n 75n 80n
-..
-.de P2
-.ft 1
-.DE
-.KE
-..
-.de CW
-.lg 0
-\%\&\\$3\fB\\$1\fP\&\\$2
-.lg
-..
-.de WC
-.lg 0
-\%\&\\$3\fI\\$1\fP\&\\$2
-.lg
-..
-.TL
-A tutorial for the
-.CW sam
-.B
-command language
-.AU
-Rob Pike
-.AI
-.MH
-.AB
-.CW sam
-is an interactive text editor with a command language that makes heavy use
-of regular expressions.
-Although the language is syntactically similar to
-.CW ed (1),
-the details are interestingly different.
-This tutorial introduces the command language, but does not discuss
-the screen and mouse interface.
-With apologies to those unfamiliar with the Ninth Edition Blit software,
-it is assumed that the similarity of
-.CW sam
-to
-.CW mux (9)
-at this level makes
-.CW sam 's
-mouse language easy to learn.
-.PP
-The
-.CW sam
-command language applies identically to two environments:
-when running
-.CW sam
-on an ordinary terminal
-(\f2via\f1\f1
-.CW sam\ -d ),
-and in the command window of a
-.I downloaded
-.CW sam ,
-that is, one using the bitmap display and mouse.
-.AE
-.SH
-Introduction
-.PP
-This tutorial describes the command language of
-.CW sam ,
-an interactive text editor that runs on Blits and
-some computers with bitmap displays.
-For most editing tasks, the mouse-based editing features
-are sufficient, and they are easy to use and to learn.
-.PP
-The command language is often useful, however, particularly
-when making global changes.
-Unlike the commands in
-.CW ed ,
-which are necessary to make changes,
-.CW sam
-commands tend to be used
-only for complicated or repetitive editing tasks.
-It is in these more involved uses that
-the differences between
-.CW sam
-and other text editors are most evident.
-.PP
-.CW sam 's
-language makes it easy to do some things that other editors,
-including programs like
-.CW sed
-and
-.CW awk ,
-do not handle gracefully, so this tutorial serves partly as a
-lesson in
-.CW sam 's
-manner of manipulating text.
-The examples below therefore concentrate entirely on the language,
-assuming that facility with the use of the mouse in
-.CW sam
-is at worst easy to pick up.
-In fact,
-.CW sam
-can be run without the mouse at all (not
-.I downloaded ),
-by specifying the
-.CW -d
-flag, and it is this domain that the tutorial
-occupies; the command language in these modes
-are identical.
-.PP
-A word to the Unix adept:
-although
-.CW sam
-is syntactically very similar to
-.CW ed ,
-it is fundamentally and deliberately different in design and detailed semantics.
-You might use knowledge of
-.CW ed
-to predict how the substitute command works,
-but you'd only be right if you had used some understanding of
-.CW sam 's
-workings to influence your prediction.
-Be particularly careful about idioms.
-Idioms form in curious nooks of languages and depend on
-undependable peculiarities.
-.CW ed
-idioms simply don't work in
-.CW sam :
-.CW 1,$s/a/b/
-makes one substitution in the whole file, not one per line.
-.CW sam
-has its own idioms.
-Much of the purpose of this tutorial is to publish them
-and make fluency in
-.CW sam
-a matter of learning, not cunning.
-.PP
-The tutorial depends on familiarity with regular expressions, although
-some experience with a more traditional Unix editor may be helpful.
-To aid readers familiar with
-.CW ed ,
-I have pointed out in square brackets [] some of
-the relevant differences between
-.CW ed
-and
-.CW sam .
-Read these comments only if you wish
-to understand the differences; the lesson is about
-.CW sam ,
-not
-.CW sam
-.I vs.
-.CW ed .
-Another typographic convention is that output appears in
-.CW "this font,
-while typed input appears as
-.WC "slanty text.
-.PP
-Nomenclature:
-.CW sam
-keeps a copy of the text it is editing.
-This copy is called a
-.I file .
-To avoid confusion, I have called the permanent storage on disc a
-.I
-Unix file.
-.R
-.SH
-Text
-.PP
-To get started, we need some text to play with.
-Any text will do; try something from
-James Gosling's Emacs manual:
-.P1
-$ \fIsam -d
-a
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-\&.
-.ft
-.P2
-.WC "sam -d
-starts
-.CW sam
-running.
-The
-.CW a
-command adds text until a line containing just a period, and sets the
-.I
-current text
-.R
-(also called
-.I dot )
-to what was typed \(em everything between the
-.CW a
-and the period.
-.CW ed "" [
-would leave dot set to only the last line.]
-The
-.CW p
-command prints the current text:
-.P1
-.WC p
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-.P2
-[Again,
-.CW ed
-would print only the last line.]
-The
-.CW a
-command adds its text
-.I after
-dot; the
-.CW i
-command is like
-.CW a,
-but adds the text
-.I before
-dot.
-.P1
-.ft I
-i
-Introduction
-\&.
-p
-.ft
-Introduction
-.P2
-There is also a
-.CW c
-command that changes (replaces) the current text,
-and
-.CW d
-that deletes it; these are illustrated below.
-.PP
-To see all the text, we can specify what text to print;
-for the moment, suffice it to say that
-.WC 0,$
-specifies the entire file.
-.CW ed "" [
-users would probably type
-.WC 1,$ ,
-which in practice is the same thing, but see below.]
-.P1
-.WC 0,$p
-Introduction
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-.P2
-Except for the
-.CW w
-command described below,
-.I all
-commands,
-including
-.CW p ,
-set dot to the text they touch.
-Thus,
-.CW a
-and
-.CW i
-set dot to the new text,
-.CW p
-to the text printed, and so on.
-Similarly, all commands
-(except
-.CW w )
-by default operate on the current
-text [unlike
-.CW ed ,
-for which some commands (such as
-.CW g )
-default to the entire file].
-.PP
-Things are not going to get very interesting until we can
-set dot arbitrarily.
-This is done by
-.I addresses ,
-which specify a piece of the file.
-The address
-.CW 1 ,
-for example, sets dot to the first line of the file.
-.P1
-.WC 1p
-Introduction
-.WC c
-.WC Preamble
-.WC .
-.P2
-The
-.CW c
-command didn't need to specify dot; the
-.CW p
-left it on line one.
-It's therefore easy to delete the first line utterly;
-the last command left dot set to line one:
-.P1
-.WC d
-.WC 1p
-This manual is organized in a rather haphazard manner. The first
-.P2
-(Line numbers change
-to reflect changes to the file.)
-.PP
-The address \f(CW/\f2text\f(CW/\f1
-sets dot to the first appearance of
-.I text ,
-after dot.
-.CW ed "" [
-matches the first line containing
-.I text .]
-If
-.I text
-is not found, the search restarts at the beginning of the file
-and continues until dot.
-.P1
-.WC /Emacs/p
-Emacs
-.P2
-It's difficult to indicate typographically, but in this example no newline appears
-after
-.CW Emacs :
-the text to be printed is the string
-.CW Emacs ', `
-exactly.
-(The final
-.CW p
-may be left off \(em it is the default command.
-When downloaded, however, the default is instead to select the text,
-to highlight it,
-and to make it visible by moving the window on the file if necessary.
-Thus,
-.CW /Emacs/
-indicates on the display the next occurrence of the text.)
-.PP
-Imagine we wanted to change the word
-.CW haphazard
-to
-.CW thoughtless .
-Obviously, what's needed is another
-.CW c
-command, but the method used so far to insert text includes a newline.
-The syntax for including text without newlines is to surround the
-text with slashes (which is the same as the syntax for
-text searches, but what is going on should be clear from context).
-The text must appear immediately after the
-.CW c
-(or
-.CW a
-or
-.CW i ).
-Given this, it is easy to make the required change:
-.P1
-.WC /haphazard/c/thoughtless/
-1p
-This manual is organized in a rather thoughtless manner. The first
-.P2
-[Changes can always be done with a
-.CW c
-command, even if the text is smaller than a line].
-You'll find that this way of providing text to commands is much
-more common than is the multiple-lines syntax.
-If you want to include a slash
-.CW /
-in the text, just precede it with a backslash
-.CW \e ,
-and use a backslash to protect a backslash itself.
-.P1
-.WC /Emacs/c/Emacs\e\e360/
-.WC 4p
-general introduction to the commands in Emacs\e360 and to try to show
-.P2
-We could also make this particular change by
-.P1
-.WC /Emacs/a/\e\e360/
-.P2
-.PP
-This is as good a place as any to introduce the
-.CW u
-command, which undoes the last command.
-A second
-.CW u
-will undo the penultimate command, and so on.
-.P1
-.WC u
-.WC 4p
-general introduction to the commands in Emacs and to try to show
-.WC u
-.WC 3p
-This manual is organized in a rather haphazard manner. The first
-.P2
-Undoing can only back up; there is no way to undo a previous
-.CW u .
-.SH
-Addresses
-.PP
-We've seen the simplest forms of addresses, but there is more
-to learn before we can get too much further.
-An address selects a region in the file \(em a substring \(em
-and therefore must define the beginning and the end of a region.
-Thus, the address
-.CW 13
-selects from the beginning of line thirteen to the end of line thirteen, and
-.CW /Emacs/
-selects from the beginning of the word
-.CW Emacs ' `
-to the end.
-.PP
-Addresses may be combined with a comma:
-.P1
-13,15
-.P2
-selects lines thirteen through fifteen. The definition of the comma
-operator is to select from the beginning of the left hand address (the
-beginning of line 13) to the end of the right hand address (the
-end of line 15).
-.PP
-A few special simple addresses come in handy:
-.CW .
-(a period) represents dot, the current text,
-.CW 0
-(line zero) selects the null string at the beginning of the file, and
-.CW $
-selects the null string at the end of the file
-[not the last line of the file].
-Therefore,
-.P1
-0,13
-.P2
-selects from the beginning of the file to the end of line thirteen,
-.P1
-\&.,$
-.P2
-selects from the beginning of the current text to the end of the file, and
-.P1
-0,$
-.P2
-selects the whole file [that is, a single string containing the whole file,
-not a list of all the lines in the file].
-.PP
-These are all
-.I absolute
-addresses: they refer to specific places in the file.
-.CW sam
-also has relative addresses, which depend
-on the value of dot,
-and in fact we have already seen one form:
-.CW /Emacs/
-finds the first occurrence of
-.CW Emacs
-searching forwards from dot.
-Which occurrence of
-.CW Emacs
-it finds depends on the value of dot.
-What if you wanted the first occurrence
-.CW before
-dot? Just precede the pattern with a minus sign, which reverses the direction
-of the search:
-.P1
--/Emacs/
-.P2
-In fact, the complete syntax for forward searching is
-.P1
-+/Emacs/
-.P2
-but the plus sign is the default, and in practice is rarely used.
-Here is an example that includes it for clarity:
-.P1
-0+/Emacs/
-.P2
-selects the first occurrence of
-.CW Emacs
-in the file; read it as ``go to line 0, then search forwards for
-.CW Emacs .''
-Since the
-.CW +
-is optional, this can be written
-.CW 0/Emacs/ .
-Similarly,
-.P1
-$-/Emacs/
-.P2
-finds the last occurrence in the file, so
-.P1
-0/Emacs/,$-/Emacs/
-.P2
-selects the text from the first to last
-.CW Emacs ,
-inclusive.
-Slightly more interesting:
-.P1
-/Emacs/+/Emacs/
-.P2
-(there is an implicit
-.CW .+
-at the beginning) selects the second
-.CW Emacs
-following dot.
-.PP
-Line numbers may also be relative.
-.P1
--2
-.P2
-selects the second previous line, and
-.P1
-+5
-.P2
-selects the fifth following line (here the plus sign is obligatory).
-.PP
-Since addresses may select (and dot may be) more than one line,
-we need a definition of `previous' and `following:'
-`previous' means
-.I
-before the beginning
-.R
-of dot, and `following'
-means
-.I
-after the end
-.R
-of dot.
-For example, if the file contains \fBA\fIAA\fBA\f1,
-with dot set to the middle two
-.CW A 's
-(the slanting characters),
-.CW -/A/
-sets dot to the first
-.CW A ,
-and
-.CW +/A/
-sets dot to the last
-.CW A .
-Except under odd circumstances (such as when the only occurrence of the
-text in the file is already the current text), the text selected by a
-search will be disjoint from dot.
-.PP
-To select the
-.CW "troff -ms
-paragraph containing dot, however long it is, use
-.P1
--/.PP/,/.PP/-1
-.P2
-which will include the
-.CW .PP
-that begins the paragraph, and exclude the one that ends it.
-.PP
-When typing relative line number addresses, the default number is
-.CW 1 ,
-so the above could be written slightly more simply:
-.P1
--/.PP/,/.PP/-
-.P2
-.PP
-What does the address
-.CW +1-1
-or the equivalent
-.CW +-
-mean? It looks like it does nothing, but recall that dot need not be a
-complete line of text.
-.CW +1
-selects the line after the end of the current text, and
-.CW -1
-selects the line before the beginning. Therefore
-.CW +1-1
-selects the line before the line after the end of dot, that is,
-the complete line containing the end of dot.
-We can use this construction to expand a selection to include a complete line,
-say the first line in the file containing
-.CW Emacs :
-.P1
-.WC 0/Emacs/+-p
-general introduction to the commands in Emacs and to try to show
-.P2
-The address
-.CW +-
-is an idiom.
-.SH
-Loops
-.PP
-Above, we changed one occurrence of
-.CW Emacs
-to
-.CW Emacs\e360 ,
-but if the name of the editor is really changing, it would be useful
-to change
-.I all
-instances of the name in a single command.
-.CW sam
-provides a command,
-.CW x
-(extract), for just that job.
-The syntax is
-\f(CWx/\f2pattern\f(CW/\f2command\f1.
-For each occurrence of the pattern in the selected text,
-.CW x
-sets dot to the occurrence and runs command.
-For example, to change
-.CW Emacs
-to
-.CW vi,
-.P1
-.WC 0,$x/Emacs/c/vi/
-.WC 0,$p
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in vi and to try to show
-the method in the madness that is the vi command structure.
-.P2
-This
-works by subdividing the current text
-.CW 0,$ "" (
-\(em the whole file) into appearances of its textual argument
-.CW Emacs ), (
-and then running the command that follows
-.CW c/vi/ ) (
-with dot set to the text.
-We can read this example as, ``find all occurrences of
-.CW Emacs
-in the file, and for each one,
-set the current text to the occurrence and run the command
-.CW c/vi/ ,
-which will replace the current text by
-.CW vi. ''
-[This command is somewhat similar to
-.CW ed 's
-.CW g
-command. The differences will develop below, but note that the
-default address, as always, is dot rather than the whole file.]
-.PP
-A single
-.CW u
-command is sufficient to undo an
-.CW x
-command, regardless of how many individual changes the
-.CW x
-makes.
-.P1
-.WC u
-.WC 0,$p
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-.P2
-.PP
-Of course,
-.CW c
-is not the only command
-.CW x
-can run. An
-.CW a
-command can be used to put proprietary markings on
-.CW Emacs :
-.P1
-.WC 0,$x/Emacs/a/{TM}/
-.WC /Emacs/+-p
-general introduction to the commands in Emacs{TM} and to try to show
-.P2
-[There is no way to see the changes as they happen, as in
-.CW ed 's
-.CW g/Emacs/s//&{TM}/p ;
-see the section on Multiple Changes, below.]
-.PP
-The
-.CW p
-command is also useful when driven by an
-.CW x ,
-but be careful that you say what you mean;
-.P1
-.WC 0,$x/Emacs/p
-EmacsEmacs
-.P2
-since
-.CW x
-sets dot to the text in the slashes, printing only that text
-is not going to be very
-informative. But the command that
-.CW x
-runs can contain addresses. For example, if we want to print all
-lines containing
-.CW Emacs ,
-just use
-.CW +- :
-.P1
-.WC 0,$x/Emacs/+-p
-general introduction to the commands in Emacs{TM} and to try to show
-the method in the madness that is the Emacs{TM} command structure.
-.P2
-Finally, let's restore the state of the file with another
-.CW x
-command, and make use of a handy shorthand:
-a comma in an address has its left side default to
-.CW 0 ,
-and its right side default to
-.CW $ ,
-so the easy-to-type address
-.CW ,
-refers to the whole file:
-.P1
-.WC ",x/Emacs/ /{TM}/d
-.WC ,p
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-.P2
-Notice what this
-.CW x
-does: for each occurrence of Emacs,
-find the
-.CW {TM}
-that follows, and delete it.
-.PP
-The `text'
-.CW sam
-accepts
-for searches in addresses and in
-.CW x
-commands is not simple text, but rather
-.I regular\ expressions.
-Unix has several distinct interpretations of regular expressions.
-The form used by
-.CW sam
-is that of
-.CW regexp (6),
-including parentheses
-.CW ()
-for grouping and an `or' operator
-.CW |
-for matching strings in parallel.
-.CW sam
-also matches the character sequence
-.CW \en
-with a newline character.
-Replacement text, such as used in the
-.CW a
-and
-.CW c
-commands, is still plain text, but the sequence
-.CW \en
-represents newline in that context, too.
-.PP
-Here is an example. Say we wanted to double space the document, that is,
-turn every newline into two newlines.
-The following all do the job:
-.P1
-.WC ",x/\en/ a/\en/
-.WC ",x/\en/ c/\en\en/
-.WC ",x/$/ a/\en/
-.WC ",x/^/ i/\en/
-.P2
-The last example is slightly different, because it puts a newline
-.I before
-each line; the other examples place it after.
-The first two examples manipulate newlines directly
-[something outside
-.CW ed 's
-ken]; the last two
-use regular expressions:
-.CW $
-is the empty string at the end of a line, while
-.CW ^
-is the empty string at the beginning.
-.PP
-These solutions all have a possible drawback: if there is already a blank line
-(that is, two consecutive newlines), they make it much larger (four
-consecutive newlines).
-A better method is to extend every group of newlines by one:
-.P1
-.WC ",x/\en+/ a/\en/
-.P2
-The regular expression operator
-.CW +
-means `one or more;'
-.CW \en+
-is identical to
-.CW \en\en* .
-Thus, this example
-takes every sequence of newlines and adds another
-to the end.
-.PP
-A more common example is indenting a block of text by a tab stop.
-The following all work,
-although the first is arguably the cleanest (the blank text in slashes is a tab):
-.P1
-.WC ",x/^/a/ /
-.WC ",x/^/c/ /
-.WC ",x/.*\en/i/ /
-.P2
-The last example uses the pattern (idiom, really)
-.CW .*\en
-to match lines:
-.CW .*
-matches the longest possible string of non-newline characters.
-Taking initial tabs away is just as easy:
-.P1
-.WC ",x/^ /d
-.P2
-In these examples I have specified an address (the whole file), but
-in practice commands like these are more likely to be run without
-an address, using the value of dot set by selecting text with the mouse.
-.SH
-Conditionals
-.PP
-The
-.CW x
-command is a looping construct:
-for each match of a regular expression,
-it extracts (sets dot to) the match and runs a command.
-.CW sam
-also has a conditional,
-.CW g :
-\f(CWg/\f2pattern\f(CW/\f2command\f1
-runs the command if dot contains a match of the pattern
-.I
-without changing the value of dot.
-.R
-The inverse,
-.CW v ,
-runs the command if dot does
-.I not
-contain a match of the pattern.
-(The letters
-.CW g
-and
-.CW v
-are historical and have no mnemonic significance. You might
-think of
-.CW g
-as `guard.')
-.CW ed "" [
-users should read the above definitions very carefully; the
-.CW g
-command in
-.CW sam
-is fundamentally different from that in
-.CW ed .]
-Here is an example of the difference between
-.CW x
-and
-.CW g:
-.P1
-,x/Emacs/c/vi/
-.P2
-changes each occurrence of the word
-.CW Emacs
-in the file to the word
-.CW vi ,
-but
-.P1
-,g/Emacs/c/vi/
-.P2
-changes the
-.I "whole file
-to
-.CW vi
-if there is the word
-.CW Emacs
-anywhere in the file.
-.PP
-Neither of these commands is particularly interesting in isolation,
-but they are valuable when combined with
-.CW x
-and with themselves.
-.SH
-Composition
-.PP
-One way to think about the
-.CW x
-command is that, given a selection (a value of dot)
-it iterates through interesting subselections (values of dot within).
-In other words, it takes a piece of text and cuts it into smaller pieces.
-But the text that it cuts up may already be a piece cut by a previous
-.CW x
-command or selected by a
-.CW g .
-.CW sam 's
-most interesting property is the ability to define a sequence of commands
-to perform a particular task.\(dg
-.FS
-\(dg
-The obvious analogy with shell pipelines is only partially valid,
-because the individual
-.CW sam
-commands are all working on the same text; it is only how the text is
-sliced up that is changing.
-.FE
-A simple example is to change all occurrences of
-.CW Emacs
-to
-.CW emacs ;
-certainly the command
-.P1
-.WC ",x/Emacs/ c/emacs/
-.P2
-will work, but we can use an
-.CW x
-command to save retyping most of the word
-.CW Emacs :
-.P1
-.WC ",x/Emacs/ x/E/ c/e/
-.P2
-(Blanks can be used
-to separate commands on a line to make them easier to read.)
-What this command does is find all occurrences of
-.CW Emacs
-.CW ,x/Emacs/ ), (
-and then
-.I
-with dot set to that text,
-.R
-find all occurrences of the letter
-.CW E
-.CW x/E/ ), (
-and then
-.I
-with dot set to that text,
-.R
-run the command
-.CW c/e/
-to change the character to lower case.
-Note that the address for the command \(em the whole file, specified by a comma
-\(em is only given to the leftmost
-piece of the command; the rest of the pieces have dot set for them by
-the execution of the pieces to their left.
-.PP
-As another simple example, consider a problem
-solved above: printing all lines in the file containing the word
-.CW Emacs:
-.P1
-.WC ",x/.*\en/ g/Emacs/p
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-.P2
-This command says to break the file into lines
-.CW ,x/.*\en/ ), (
-and for each line that contains the string
-.CW Emacs
-.CW g/Emacs/ ), (
-run the command
-.CW p
-with dot set to the line (not the match of
-.CW Emacs ),
-which prints the line.
-To save typing, because
-.CW .*\en
-is a common pattern in
-.CW x
-commands,
-if the
-.CW x
-is followed immediately by a space, the pattern
-.CW .*\en
-is assumed.
-Therefore, the above could be written more succinctly:
-.P1
-.WC ",x g/Emacs/p
-.P2
-The solution we used before was
-.P1
-.WC ,x/Emacs/+-p
-.P2
-which runs the command
-.CW +-p
-with dot set to each match of
-.CW Emacs
-in the file (recall that the idiom
-.CW +-p
-prints the line containing the end of dot).
-.PP
-The two commands usually produce the same result
-(the
-.CW +-p
-form will print a line twice if it contains
-.CW Emacs
-twice). Which is better?
-.CW ,x/Emacs/+-p
-is easier to type and will be much faster if the file is large and
-there are few occurrences of the string, but it is really an odd special case.
-.CW ",x/.*\en/ g/Emacs/p
-is slower \(em it breaks each line out separately, then examines
-it for a match \(em but is conceptually cleaner, and generalizes more easily.
-For example, consider the following piece of the Emacs manual:
-.P1
-command name="append-to-file", key="[unbound]"
-Takes the contents of the current buffer and appends it to the
-named file. If the file doesn't exist, it will be created.
-
-command name="apropos", key="ESC-?"
-Prompts for a keyword and then prints a list of those commands
-whose short description contains that keyword. For example,
-if you forget which commands deal with windows, just type
-"@b[ESC-?]@t[window]@b[ESC]".
-
-\&\f2and so on\f(CW
-.P2
-This text consists of groups of non-empty lines, with a simple format
-for the text within each group.
-Imagine that we wanted to find the description of the `apropos'
-command.
-The problem is to break the file into individual descriptions,
-and then to find the description of `apropos' and to print it.
-The solution is straightforward:
-.P1
-.WC ,x/(.+\en)+/\ g/command\ name="apropos"/p
-command name="apropos", key="ESC-?"
-Prompts for a keyword and then prints a list of those commands
-whose short description contains that keyword. For example,
-if you forget which commands deal with windows, just type
-"@b[ESC-?]@t[window]@b[ESC]".
-.P2
-The regular expression
-.CW (.+\en)+
-matches one or more lines with one or more characters each, that is,
-the text between blank lines, so
-.CW ,x/(.+\en)+/
-extracts each description; then
-.CW g/command\ name="apropos"/
-selects the description for `apropos' and
-.CW p
-prints it.
-.PP
-Imagine that we had a C program containing the variable
-.CW n ,
-but we wanted to change it to
-.CW num .
-This command is a first cut:
-.P1
-.WC ",x/n/ c/num/
-.P2
-but is obviously flawed: it will change all
-.CW n 's
-in the file, not just the
-.I identifier
-.CW n .
-A better solution is to use an
-.CW x
-command to extract the identifiers, and then use
-.CW g
-to find the
-.CW n 's:
-.P1
-.WC ",x/[a-zA-Z_][a-zA-Z_0-9]*/ g/n/ v/../ c/num/
-.P2
-It looks awful, but it's fairly easy to understand when read
-left to right.
-A C identifier is an alphabetic or underscore followed by zero or more
-alphanumerics or underscores, that is, matches of the regular expression
-.CW [a-zA-Z_][a-zA-Z_0-9]* .
-The
-.CW g
-command selects those identifiers containing
-.CW n ,
-and the
-.CW v
-is a trick: it rejects those identifiers containing more than one
-character. Hence the
-.CW c/num/
-applies only to free-standing
-.CW n 's.
-.PP
-There is still a problem here:
-we don't want to change
-.CW n 's
-that are part of the character constant
-.CW \en .
-There is a command
-.CW y ,
-complementary to
-.CW x ,
-that is just what we need:
-\f(CWy/\f2pattern\f(CW/\f2command\f1
-runs the command on the pieces of text
-.I between
-matches of the pattern;
-if
-.CW x
-selects,
-.CW y
-rejects.
-Here is the final command:
-.P1
-.WC ",y/\e\en/ x/[a-zA-Z_][a-zA-Z_0-9]*/ g/n/ v/../ c/num/
-.P2
-The
-.CW y/\e\en/
-(with backslash doubled to make it a literal character)
-removes the two-character sequence
-.CW \en
-from consideration, so the rest of the command will not touch it.
-There is more we could do here; for example, another
-.CW y
-could be prefixed to protect comments in the code.
-I won't elaborate the example any further, but you should have
-an idea of the way in which the looping and conditional commands
-in
-.CW sam
-may be composed to do interesting things.
-.SH
-Grouping
-.PP
-There is another way to arrange commands.
-By enclosing them in brace brackets
-.CW {} ,
-commands may be applied in parallel.
-This example uses the
-.CW =
-command, which reports the line and character numbers of dot,
-together with
-.CW p ,
-to report on appearances of
-.CW Emacs
-in our original file:
-.P1
-.WC ,p
-This manual is organized in a rather haphazard manner. The first
-several sections were written hastily in an attempt to provide a
-general introduction to the commands in Emacs and to try to show
-the method in the madness that is the Emacs command structure.
-.ft I
-,x/Emacs/{
- =
- +-p
-}
-.ft
-3; #171,#176
-general introduction to the commands in Emacs and to try to show
-4; #234,#239
-the method in the madness that is the Emacs command structure.
-.P2
-(The number before the semicolon is the line number;
-the numbers beginning with
-.CW #
-are character numbers.)
-As a more interesting example, consider changing all occurrences of
-.CW Emacs
-to
-.CW vi
-and vice versa. We can type
-.P1
-.ft I
-,x/Emacs|vi/{
- g/Emacs/ c/vi/
- g/vi/ c/Emacs/
-}
-.ft
-.P2
-or even
-.P1
-.ft I
-,x/[a-zA-Z]+/{
- g/Emacs/ v/....../ c/vi/
- g/vi/ v/.../ c/Emacs/
-}
-.ft
-.P2
-to make sure we don't change strings embedded in words.
-.SH
-Multiple Changes
-.PP
-You might wonder why, once
-.CW Emacs
-has been changed to
-.CW vi
-in the above example,
-the second command in the braces doesn't put it back again.
-The reason is that the commands are run in parallel:
-within any top-level
-.CW sam
-command, all changes to the file refer to the state of the file
-before any of the changes in that command are made.
-After all the changes have been determined, they are all applied
-simultaneously.
-.PP
-This means, as mentioned, that commands within a compound
-command see the state of the file before any of the changes apply.
-This method of evaluation makes some things easier (such as the exchange of
-.CW Emacs
-and
-.CW vi ),
-and some things harder.
-For instance, it is impossible to use a
-.CW p
-command to print the changes as they happen,
-because they haven't happened when the
-.CW p
-is executed.
-An indirect ramification is that changes must occur in forward
-order through the file,
-and must not overlap.
-.SH
-Unix
-.PP
-.CW sam
-has a few commands to connect to Unix processes.
-The simplest is
-.CW ! ,
-which runs the command with input and output connected to the terminal.
-.P1
-.WC !date
-Wed May 28 23:25:21 EDT 1986
-!
-.P2
-(When downloaded, the input is connected to
-.CW /dev/null
-and only the first few lines of output are printed;
-any overflow is stored in
-.CW $HOME/sam.err .)
-The final
-.CW !
-is a prompt to indicate when the command completes.
-.PP
-Slightly more interesting is
-.CW > ,
-which provides the current text as standard input to the Unix command:
-.P1
-.WC "1,2 >wc
- 2 22 131
-!
-.P2
-The complement of
-.CW >
-is, naturally,
-.CW < :
-it replaces the current text with the standard output of the Unix command:
-.P1
-.WC "1 <date
-!
-.WC 1p
-Wed May 28 23:26:44 EDT 1986
-.P2
-The last command is
-.CW | ,
-which is a combination of
-.CW <
-and
-.CW > :
-the current text is provided as standard input to the Unix command,
-and the Unix command's standard output is collected and used to
-replace the original text.
-For example,
-.P1
-.WC ",| sort
-.P2
-runs
-.CW sort (1)
-on the file, sorting the lines of the text lexicographically.
-Note that
-.CW < ,
-.CW >
-and
-.CW |
-are
-.CW sam
-commands, not Unix shell operators.
-.PP
-The next example converts all appearances of
-.CW Emacs
-to upper case using
-.CW tr (1):
-.P1
-.WC ",x/Emacs/ | tr a-z A-Z
-.P2
-.CW tr
-is run once for each occurrence of
-.CW Emacs .
-Of course, you could do this example more efficiently with a simple
-.CW c
-command, but here's a trickier one:
-given a Unix mail box as input,
-convert all the
-.CW Subject
-headers to distinct fortunes:
-.P1
-.WC ",x/^Subject:.*\en/ x/[^:]*\en/ < /usr/games/fortune
-.P2
-(The regular expression
-.CW [^:]
-refers to any character
-.I except
-.CW :
-and newline; the negation operator
-.CW ^
-excludes newline from the list of characters.)
-Again,
-.CW /usr/games/fortune
-is run once for each
-.CW Subject
-line, so each
-.CW Subject
-line is changed to a different fortune.
-.SH
-A few other text commands
-.PP
-For completeness, I should mention three other commands that
-manipulate text. The
-.CW m
-command moves the current text to after the text specified by the
-(obligatory) address after the command.
-Thus
-.P1
-.WC "/Emacs/+- m 0
-.P2
-moves the next line containing
-.CW Emacs
-to the beginning of the file.
-Similarly,
-.CW t
-(another historic character) copies the text:
-.P1
-.WC "/Emacs/+- t 0
-.P2
-would make, at the beginning of the file, a copy of the next line
-containing
-.CW Emacs .
-.PP
-The third command is more interesting: it makes substitutions.
-Its syntax is
-\f(CWs/\f2pattern\f(CW/\f2replacement\f(CW/\f1.
-Within the current text, it finds the first occurrence of
-the pattern and replaces it by the replacement text,
-leaving dot set to the entire address of the substitution.
-.P1
-.WC 1p
-This manual is organized in a rather haphazard manner. The first
-.WC s/haphazard/thoughtless/
-.WC p
-This manual is organized in a rather thoughtless manner. The first
-.P2
-Occurrences of the character
-.CW &
-in the replacement text stand for the text matching the pattern.
-.P1
-.WC s/T/"&&&&"/
-.WC p
-"TTTT"his manual is organized in a rather thoughtless manner. The first
-.P2
-There are two variants. The first is that a number may be specified
-after the
-.CW s ,
-to indicate which occurrence of the pattern to substitute; the default
-is the first.
-.P1
-.WC s2/is/was/
-.WC p
-"TTTT"his manual was organized in a rather thoughtless manner. The first
-.P2
-The second is that suffixing a
-.CW g
-(global) causes replacement of all occurrences, not just the first.
-.P1
-.WC s/[a-zA-Z]/x/g
-.WC p
-"xxxx"xxx xxxxxx xxx xxxxxxxxx xx x xxxxxx xxxxxxxxxxx xxxxxxx xxx xxxxx
-.P2
-Notice that in all these examples
-dot is left
-set to the entire line.
-.PP
-[The substitute command is vital to
-.CW ed,
-because it is the only way to make changes within a line.
-It is less valuable in
-.CW sam ,
-in which the concept of a line is much less important.
-For example, many
-.CW ed
-substitution idioms are handled well by
-.CW sam 's
-basic commands. Consider the commands
-.P1
-s/good/bad/
-s/good//
-s/good/& bye/
-.P2
-which are equivalent in
-.CW sam
-to
-.P1
-/good/c/bad/
-/good/d
-/good/a/ bye/
-.P2
-and for which the context search is likely unnecessary because the desired
-text is already dot.
-Also, beware this
-.CW ed
-idiom:
-.P1
-1,$s/good/bad/
-.P2
-which changes the first
-.CW good
-on each line; the same command in
-.CW sam
-will only change the first one in the whole file.
-The correct
-.CW sam
-version is
-.P1
-,x s/good/bad/
-.P2
-but what is more likely meant is
-.P1
-,x/good/ c/bad/
-.P2
-.CW sam
-operates under different rules.]
-.SH
-Files
-.PP
-So far, we have only been working with a single file,
-but
-.CW sam
-is a multi-file editor.
-Only one file may be edited at a time, but
-it is easy to change which file is the `current' file for editing.
-To see how to do this, we need a
-.CW sam
-with a few files;
-the easiest way to do this is to start it
-with a list of Unix file names to edit.
-.P1
-$ \fIecho *.ms\f(CW
-conquest.ms death.ms emacs.ms famine.ms slaughter.ms
-$ \fIsam -d *.ms\f(CW
- -. conquest.ms
-.P2
-(I'm sorry the Horsemen don't appear in liturgical order.)
-The line printed by
-.CW sam
-is an indication that the Unix file
-.CW conquest.ms
-has been read, and is now the current file.
-.CW sam
-does not read the Unix file until
-the associated
-.CW sam
-file becomes current.
-.PP
-The
-.CW n
-command prints the names of all the files:
-.P1
-.WC n
- -. conquest.ms
- - death.ms
- - emacs.ms
- - famine.ms
- - slaughter.ms
-.P2
-This list is also available in the menu on mouse button 3.
-The command
-.CW f
-tells the name of just the current file:
-.P1
-.WC f
- -. conquest.ms
-.P2
-The characters to the left of the file name encode helpful information about
-the file.
-The minus sign becomes a plus sign if the file has a window open, and an
-asterisk if more than one is open.
-The period (another meaning of dot) identifies the current file.
-The leading blank changes to an apostrophe if the file is different
-from the contents of the associated Unix file, as far as
-.CW sam
-knows.
-This becomes evident if we make a change.
-.P1
-.WC 1d
-.WC f
-\&'-. conquest.ms
-.P2
-If the file is restored by an undo command, the apostrophe disappears.
-.P1
-.WC u
-.WC f
- -. conquest.ms
-.P2
-The file name may be changed by providing a new name with the
-.CW f
-command:
-.P1
-.CW "f pestilence.ms
-\&'-. pestilence.ms
-.P2
-.WC f
-prints the new status of the file,
-that is, it changes the name if one is provided, and prints the
-name regardless.
-A file name change may also be undone.
-.P1
-.WC u
-.WC f
- -. conquest.ms
-.P2
-.PP
-When
-.CW sam
-is downloaded, the current file may be changed simply by selecting
-the desired file from the menu (selecting the same file subsequently
-cycles through the windows opened on the file).
-Otherwise, the
-.CW b
-command can be used to choose the desired file:\(dg
-.FS
-\(dg A bug prevents the
-.CW b
-command from working when downloaded.
-Because the menu is more convenient anyway, and
-because the method
-of choosing files from the command language is slated to change,
-the bug hasn't been fixed.
-.FE
-.P1
-.WC "b emacs.ms
- -. emacs.ms
-.P2
-Again,
-.CW sam
-prints the name (actually, executes an implicit
-.CW f
-command) because the Unix file
-.CW emacs.ms
-is being read for the first time.
-It is an error to ask for a file
-.CW sam
-doesn't know about, but the
-.CW B
-command will prime
-.CW sam 's
-menu with a new file, and make it current.
-.P1
-.WC "b flood.pic
-?no such file `flood.pic'
-.WC "B flood.pic
- -. flood.pic
-.WC n
- - conquest.ms
- - death.ms
- - emacs.ms
- - famine.ms
- -. flood.pic
- - slaughter.ms
-.P2
-Both
-.CW b
-and
-.CW B
-will accept a list of file names.
-.CW b
-simply takes the first file in the list, but
-.CW B
-loads them all.
-The list may be typed on one line \(em
-.P1
-.WC "B devil.tex satan.tex 666.tex emacs.tex
-.P2
-\(em or generated by a Unix command \(em
-.P1
-.WC "B <echo *.tex
-.P2
-The latter form requires a Unix command;
-.CW sam
-does not understand the shell file name metacharacters, so
-.CW "B *.tex
-attempts to load a single file named
-.CW *.tex .
-(The
-.CW <
-form is of course derived from
-.CW sam 's
-.CW <
-command.)
-.CW echo
-is not the only useful command to run subservient to
-.CW B ;
-for example,
-.P1
-.WC "B <grep -l Emacs *
-.P2
-will load only those files containing the string
-.CW Emacs .
-Finally, a special case: a
-.CW B
-with no arguments creates an empty, nameless file within
-.CW sam .
-.PP
-The complement of
-.CW B
-is
-.CW D :
-.P1
-.WC "D devil.tex satan.tex 666.tex emacs.tex
-.P2
-eradicates the files from
-.CW sam 's
-memory (not from the Unix machine's disc).
-.CW D
-without any file names removes the current file from
-.CW sam .
-.PP
-There are three other commands that relate the current file
-to Unix files.
-The
-.CW w
-command writes the file to disc;
-without arguments, it writes the entire file to the Unix file associated
-with the current file in
-.CW sam
-(it is the only command whose default address is not dot).
-Of course, you can specify an address to be written,
-and a different file name, with the obvious syntax:
-.P1
-.WC "1,2w /tmp/revelations
-/tmp/revelations: #44
-.P2
-.CW sam
-responds with the file name and the number of characters written to the file.
-The
-.CW write
-command on the button 3 menu is identical in function to an unadorned
-.CW w
-command.
-.PP
-The other two commands,
-.CW e
-and
-.CW r ,
-read data from Unix files.
-The
-.CW e
-command clears out the current file,
-reads the data from the named file (or uses the current file's old name if
-none is explicitly provided), and sets the file name.
-It's much like a
-.CW B
-command, but puts the information in the current file instead of a new one.
-.CW e
-without any file name is therefore an easy way to refresh
-.CW sam 's
-copy of a Unix file.
-[Unlike in
-.CW ed ,
-.CW e
-doesn't complain if the file is modified. The principle is not
-to protect against things that can be undone if wrong.]
-Since its job is to replace the whole text,
-.CW e
-never takes an address.
-.PP
-The
-.CW r
-command is like
-.CW e ,
-but it doesn't clear the file:
-the text in the Unix file replaces dot, or the specified text if an
-address is given.
-.P1
-.WC "r emacs.ms
-.P2
-has essentially the effect of
-.P1
-.WC "<cat emacs.ms
-.P2
-The commands
-.CW r
-and
-.CW w
-will set the name of the file if the current file has no name already defined;
-.CW e
-sets the name even if the file already has one.
-.PP
-There is a command, analogous to
-.CW x ,
-that iterates over files instead of pieces of text:
-.CW X
-(capital
-.CW x ).
-The syntax is easy; it's just like that of
-.CW x
-\(em \f(CWX/\f2pattern\f(CW/\f2command\f1.
-(The complementary command is
-.CW Y ,
-analogous to
-.CW y .)
-The effect is to run the command in each file whose menu entry
-(that is, whose line printed by an
-.CW f
-command) matches the pattern.
-For example, since an apostrophe identifies modified files,
-.P1
-.WC "X/'/ w
-.P2
-writes the changed files out to disc.
-Here is a longer example: find all uses of a particular variable
-in the C source files:
-.P1
-.WC "X/\e.c$/ ,x/variable/+-p
-.P2
-We can use an
-.CW f
-command to identify which file the variable appears in:
-.P1
-.ft I
-X/\e.c$/ ,g/variable/ {
- f
- ,x/variable/+-{
- =
- p
- }
-}
-.ft
-.P2
-Here, the
-.CW g
-command guarantees that only the names of files containing the variable
-will be printed (but beware that
-.CW sam
-may confuse matters by printing the names of files it reads in during
-the command).
-The
-.CW =
-command shows where in the file the variable appears, and the
-.CW p
-command prints the line.
-.PP
-The
-.CW D
-command is handy as the target of an
-.CW X .
-This example deletes from the menu all C files that do not contain
-a particular variable:
-.P1
-.WC "X/\e.c$/ ,v/variable/ D
-.P2
-If no pattern is provided for the
-.CW X ,
-the command (which defaults to
-.CW f )
-is run in all files, so
-.P1
-.WC "X D
-.P2
-cleans
-.CW sam
-up for a fresh start.
-.PP
-But rather than working any further, let's stop now:
-.P1
-.WC q
-$
-.P2
-.fi
-.PP
-Some of the file manipulating commands can be undone:
-undoing a
-.CW f ,
-.CW e ,
-or
-.CW r
-restores the previous state of the file,
-but
-.CW w ,
-.CW B
-and
-.CW D
-are irrevocable.
-And, of course, so is
-.CW q .
//GO.SYSIN DD ./doc/sam.tut.ms
echo ./doc/Sam.ad
-*width: 500
-*height: 600
-*font: fixed
-*scrollForwardR: true
-*saveUnder: true
-*backingStore: WhenMapped
-
//GO.SYSIN DD ./doc/Sam.ad
echo ./doc/sam.ps
-%!PS
-%%Version: 3.3.2
-%%DocumentFonts: (atend)
-%%Pages: (atend)
-%%EndComments
-%
-% Version 3.3.2 prologue for troff files.
-%
-
-/#copies 1 store
-/aspectratio 1 def
-/formsperpage 1 def
-/landscape false def
-/linewidth .3 def
-/magnification 1 def
-/margin 0 def
-/orientation 0 def
-/resolution 720 def
-/rotation 1 def
-/xoffset 0 def
-/yoffset 0 def
-
-/roundpage true def
-/useclippath true def
-/pagebbox [0 0 612 792] def
-
-/R /Times-Roman def
-/I /Times-Italic def
-/B /Times-Bold def
-/BI /Times-BoldItalic def
-/H /Helvetica def
-/HI /Helvetica-Oblique def
-/HB /Helvetica-Bold def
-/HX /Helvetica-BoldOblique def
-/CW /Courier def
-/CO /Courier def
-/CI /Courier-Oblique def
-/CB /Courier-Bold def
-/CX /Courier-BoldOblique def
-/PA /Palatino-Roman def
-/PI /Palatino-Italic def
-/PB /Palatino-Bold def
-/PX /Palatino-BoldItalic def
-/Hr /Helvetica-Narrow def
-/Hi /Helvetica-Narrow-Oblique def
-/Hb /Helvetica-Narrow-Bold def
-/Hx /Helvetica-Narrow-BoldOblique def
-/KR /Bookman-Light def
-/KI /Bookman-LightItalic def
-/KB /Bookman-Demi def
-/KX /Bookman-DemiItalic def
-/AR /AvantGarde-Book def
-/AI /AvantGarde-BookOblique def
-/AB /AvantGarde-Demi def
-/AX /AvantGarde-DemiOblique def
-/NR /NewCenturySchlbk-Roman def
-/NI /NewCenturySchlbk-Italic def
-/NB /NewCenturySchlbk-Bold def
-/NX /NewCenturySchlbk-BoldItalic def
-/ZD /ZapfDingbats def
-/ZI /ZapfChancery-MediumItalic def
-/S /S def
-/S1 /S1 def
-/GR /Symbol def
-
-/inch {72 mul} bind def
-/min {2 copy gt {exch} if pop} bind def
-
-/show {show} bind def % so later references don't bind
-/widthshow {widthshow} bind def
-/stringwidth {stringwidth} bind def
-
-/setup {
- counttomark 2 idiv {def} repeat pop
-
- landscape {/orientation 90 orientation add def} if
- /scaling 72 resolution div def
- linewidth setlinewidth
- 1 setlinecap
-
- pagedimensions
- xcenter ycenter translate
- orientation rotation mul rotate
- width 2 div neg height 2 div translate
- xoffset inch yoffset inch neg translate
- margin 2 div dup neg translate
- magnification dup aspectratio mul scale
- scaling scaling scale
-
- addmetrics
- 0 0 moveto
-} def
-
-/pagedimensions {
- useclippath userdict /gotpagebbox known not and {
- /pagebbox [clippath pathbbox newpath] def
- roundpage currentdict /roundpagebbox known and {roundpagebbox} if
- } if
- pagebbox aload pop
- 4 -1 roll exch 4 1 roll 4 copy
- landscape {4 2 roll} if
- sub /width exch def
- sub /height exch def
- add 2 div /xcenter exch def
- add 2 div /ycenter exch def
- userdict /gotpagebbox true put
-} def
-
-/addmetrics {
- /Symbol /S null Sdefs cf
- /Times-Roman /S1 StandardEncoding dup length array copy S1defs cf
-} def
-
-/pagesetup {
- /page exch def
- currentdict /pagedict known currentdict page known and {
- page load pagedict exch get cvx exec
- } if
-} def
-
-/decodingdefs [
- {counttomark 2 idiv {y moveto show} repeat}
- {neg /y exch def counttomark 2 idiv {y moveto show} repeat}
- {neg moveto {2 index stringwidth pop sub exch div 0 32 4 -1 roll widthshow} repeat}
- {neg moveto {spacewidth sub 0.0 32 4 -1 roll widthshow} repeat}
- {counttomark 2 idiv {y moveto show} repeat}
- {neg setfunnytext}
-] def
-
-/setdecoding {/t decodingdefs 3 -1 roll get bind def} bind def
-
-/w {neg moveto show} bind def
-/m {neg dup /y exch def moveto} bind def
-/done {/lastpage where {pop lastpage} if} def
-
-/f {
- dup /font exch def findfont exch
- dup /ptsize exch def scaling div dup /size exch def scalefont setfont
- linewidth ptsize mul scaling 10 mul div setlinewidth
- /spacewidth ( ) stringwidth pop def
-} bind def
-
-/changefont {
- /fontheight exch def
- /fontslant exch def
- currentfont [
- 1 0
- fontheight ptsize div fontslant sin mul fontslant cos div
- fontheight ptsize div
- 0 0
- ] makefont setfont
-} bind def
-
-/sf {f} bind def
-
-/cf {
- dup length 2 idiv
- /entries exch def
- /chtab exch def
- /newencoding exch def
- /newfont exch def
-
- findfont dup length 1 add dict
- /newdict exch def
- {1 index /FID ne {newdict 3 1 roll put}{pop pop} ifelse} forall
-
- newencoding type /arraytype eq {newdict /Encoding newencoding put} if
-
- newdict /Metrics entries dict put
- newdict /Metrics get
- begin
- chtab aload pop
- 1 1 entries {pop def} for
- newfont newdict definefont pop
- end
-} bind def
-
-%
-% A few arrays used to adjust reference points and character widths in some
-% of the printer resident fonts. If square roots are too high try changing
-% the lines describing /radical and /radicalex to,
-%
-% /radical [0 -75 550 0]
-% /radicalex [-50 -75 500 0]
-%
-% Move braceleftbt a bit - default PostScript character is off a bit.
-%
-
-/Sdefs [
- /bracketlefttp [201 500]
- /bracketleftbt [201 500]
- /bracketrighttp [-81 380]
- /bracketrightbt [-83 380]
- /braceleftbt [203 490]
- /bracketrightex [220 -125 500 0]
- /radical [0 0 550 0]
- /radicalex [-50 0 500 0]
- /parenleftex [-20 -170 0 0]
- /integral [100 -50 500 0]
- /infinity [10 -75 730 0]
-] def
-
-/S1defs [
- /underscore [0 80 500 0]
- /endash [7 90 650 0]
-] def
-%
-% Tries to round clipping path dimensions, as stored in array pagebbox, so they
-% match one of the known sizes in the papersizes array. Lower left coordinates
-% are always set to 0.
-%
-
-/roundpagebbox {
- 7 dict begin
- /papersizes [8.5 inch 11 inch 14 inch 17 inch] def
-
- /mappapersize {
- /val exch def
- /slop .5 inch def
- /diff slop def
- /j 0 def
- 0 1 papersizes length 1 sub {
- /i exch def
- papersizes i get val sub abs
- dup diff le {/diff exch def /j i def} {pop} ifelse
- } for
- diff slop lt {papersizes j get} {val} ifelse
- } def
-
- pagebbox 0 0 put
- pagebbox 1 0 put
- pagebbox dup 2 get mappapersize 2 exch put
- pagebbox dup 3 get mappapersize 3 exch put
- end
-} bind def
-
-%%EndProlog
-%%BeginSetup
-mark
-/linewidth 0.5 def
-/#copies 1 store
-/landscape false def
-/resolution 720 def
-setup
-2 setdecoding
-%%EndSetup
-%%Page: 1 1
-/saveobj save def
-mark
-1 pagesetup
-12 B f
-(The Text Editor)2 827 1 2343 1230 t
-12 CW f
-(sam)3200 1230 w
-10 I f
-(ROB PIKE)1 441 1 2659 1470 t
-10 R f
-(AT&T Bell Laboratories)2 993 1 2383 1650 t
-(Murray Hill, New Jersey 07974)4 1267 1 2246 1770 t
-10 I f
-(ABSTRACT)2643 2150 w
-10 CW f
-(Sam)1080 2446 w
-10 R f
-( textual com-)2 541( A)1 129( text editor intended for bitmap displays.)6 1666(is an interactive multi-file)3 1053 4 1291 2446 t
-( the mouse-driven, cut-and-paste interface to make complex)7 2450(mand language supplements)2 1150 2 1080 2566 t
-( language is characterized by the composi-)6 1719( The)1 208( editing tasks easy to specify.)5 1186(or repetitive)1 487 4 1080 2686 t
-( treat-)1 237( The)1 207( regular expressions to describe the structure of the text being modified.)11 2889(tion of)1 267 4 1080 2806 t
-(ment of files as a database, with changes logged as atomic transactions, guides the imple-)14 3600 1 1080 2926 t
-(mentation and makes a general `undo' mechanism straightforward.)7 2672 1 1080 3046 t
-10 CW f
-(Sam)1330 3202 w
-10 R f
-( a low-bandwidth stream, one)4 1224(is implemented as two processes connected by)6 1912 2 1544 3202 t
-( it can run)3 435( Therefore)1 453( the other the editing algorithms.)5 1360(process handling the display and)4 1352 4 1080 3322 t
-( with both pro-)3 600(with the display process in a bitmap terminal and the editor on a local host,)14 3000 2 1080 3442 t
-( process in the terminal and the edi-)7 1442(cesses on a bitmap-equipped host, or with the display)8 2158 2 1080 3562 t
-( can even run without a bitmap)6 1243( suppressing the display process, it)5 1388( By)1 167(tor in a remote host.)4 802 4 1080 3682 t
-(terminal.)1080 3802 w
-( 17, number)2 502(This paper is reprinted from Software\320Practice and Experience, Vol)8 2848 2 1330 3958 t
-(11, pp. 813-845.)2 658 1 1080 4078 t
-6 R f
-(KEY WORDS)1 354 1 1080 4318 t
-8 R f
-( Undo)1 258( expressions)1 391( Caches Regular)2 642(Text editors)1 382 4 1494 4318 t
-10 B f
-(Introduction)720 4438 w
-10 CW f
-(Sam)720 4594 w
-10 R f
-( that combines cut-and-paste interactive editing with an unusual command)9 3025(is an interactive text editor)4 1085 2 930 4594 t
-( is written as two programs: one, the `host)8 1775( It)1 123( composition of regular expressions.)4 1499(language based on the)3 923 4 720 4714 t
-( the command language and provides file access; the other,)9 2428(part,' runs on a Unix* system and implements)7 1892 2 720 4834 t
-( bitmap display and supports the)5 1337(the `terminal part,' runs asynchronously on a machine with a mouse and)11 2983 2 720 4954 t
-( host part may be even run in isolation on an ordinary terminal to edit)14 2859( The)1 211(display and interactive editing.)3 1250 3 720 5074 t
-( command language, much like a traditional line editor, without assistance from a mouse or)14 3763(text using the)2 557 2 720 5194 t
-( runs on a Blit)4 583( often, the terminal part)4 952(display. Most)1 573 3 720 5314 t
-6 R f
-(1)2828 5264 w
-10 R f
-(terminal \(actually on a Teletype DMD 5620, the pro-)8 2153 1 2887 5314 t
-( Sun com-)2 423(duction version of the Blit\), whose host connection is an ordinary 9600 bps RS232 link; on the)16 3897 2 720 5434 t
-(puter the host and display processes run on a single machine, connected by a pipe.)14 3283 1 720 5554 t
-10 CW f
-(Sam)970 5710 w
-10 R f
-( unlike)1 282( has no facilities for multiple fonts, graphics or tables,)9 2210( It)1 117(edits uninterpreted ASCII text.)3 1250 4 1181 5710 t
-(MacWrite,)720 5830 w
-6 R f
-(2)1149 5780 w
-10 R f
-(Bravo,)1211 5830 w
-6 R f
-(3)1480 5780 w
-10 R f
-(Tioga)1542 5830 w
-6 R f
-(4)1775 5780 w
-10 R f
-(or Lara.)1 322 1 1837 5830 t
-6 R f
-(5)2159 5780 w
-10 R f
-( this)1 176( \(Throughout)1 561( has a rich command language.)5 1266(Also unlike them, it)3 816 4 2221 5830 t
-(paper, the phrase)2 708 1 720 5950 t
-10 I f
-(command language)1 800 1 1468 5950 t
-10 R f
-( commands activated from the mouse)5 1575(refers to textual commands;)3 1157 2 2308 5950 t
-(form the)1 344 1 720 6070 t
-10 I f
-(mouse language.)1 679 1 1092 6070 t
-10 R f
-(\))1771 6070 w
-10 CW f
-(Sam)1856 6070 w
-10 R f
-(developed as an editor for use by programmers, and tries to join the styles)13 2977 1 2063 6070 t
-(of the Unix text editor)4 968 1 720 6190 t
-10 CW f
-(ed)1733 6190 w
-6 R f
-(6,7)1853 6140 w
-10 R f
-( cut-and-paste editors by providing a comfortable)6 2100(with that of interactive)3 967 2 1973 6190 t
-( The)1 214( language driven by regular expressions.)5 1658(mouse-driven interface to a program with a solid command)8 2448 3 720 6310 t
-( language, and acquired a notation for describing the)8 2186(command language developed more than the mouse)6 2134 2 720 6430 t
-( a dataflow-like syntax for specifying)5 1594(structure of files more richly than as a sequence of lines, using)11 2726 2 720 6550 t
-(changes.)720 6670 w
-(The interactive style was influenced by)5 1576 1 970 6826 t
-10 CW f
-(jim)2573 6826 w
-10 R f
-(,)2753 6826 w
-6 R f
-(1)2778 6776 w
-10 R f
-( for the Blit, and by)5 798(an early cut-and-paste editor)3 1144 2 2835 6826 t
-10 CW f
-(mux)4805 6826 w
-10 R f
-(,)4985 6826 w
-6 R f
-(8)5010 6776 w
-10 R f
-(the Blit window system.)3 1000 1 720 6946 t
-10 CW f
-(Mux)1779 6946 w
-10 R f
-(merges the original Blit window system,)5 1662 1 1993 6946 t
-10 CW f
-(mpx)3688 6946 w
-10 R f
-(,)3868 6946 w
-6 R f
-(1)3893 6896 w
-10 R f
-(with cut-and-paste editing,)2 1084 1 3956 6946 t
-8 S1 f
-(__________________)720 7046 w
-8 R f
-(* Unix is a registered trademark of AT&T.)7 1365 1 720 7146 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 1 1
-%%Page: 2 2
-/saveobj save def
-mark
-2 pagesetup
-10 R f
-(- 2 -)2 166 1 2797 480 t
-( like a multiplexed version of)5 1199(forming something)1 768 2 720 840 t
-10 CW f
-(jim)2717 840 w
-10 R f
-(that edits the output of \(and input to\) command ses-)9 2113 1 2927 840 t
-(sions rather than files.)3 882 1 720 960 t
-( paper describes the command language, then the mouse language, and explains)11 3251(The first part of this)4 819 2 970 1116 t
-( first of the host part, then of the)8 1290( is followed by a description of the implementation,)8 2076( That)1 234(how they interact.)2 720 4 720 1236 t
-( influenced the design of)4 991( principle that)2 555( A)1 122(terminal part.)1 538 4 720 1356 t
-10 CW f
-(sam)2952 1356 w
-10 R f
-(is that it should have no explicit limits, such as)9 1882 1 3158 1356 t
-( honor these two)3 663( To)1 161( secondary consideration is that it be efficient.)7 1841( A)1 122( length.)1 300(upper limits on file size or line)6 1233 6 720 1476 t
-( breaking them into)3 783(goals together requires a method for efficiently manipulating huge strings \(files\) without)11 3537 2 720 1596 t
-( control of the command language.)5 1407(lines, perhaps while making thousands of changes under)7 2280 2 720 1716 t
-10 CW f
-(Sam)4460 1716 w
-10 R f
-('s method)1 400 1 4640 1716 t
-( updates may)2 541( These)1 295( as a transaction database, implementing changes as atomic updates.)9 2783(is to treat the file)4 701 4 720 1836 t
-( is achieved through a collection of caches that minimizes)9 2328( Efficiency)1 467( easily to `undo' changes.)4 1031(be unwound)1 494 4 720 1956 t
-(disc traffic and data motion, both within the two parts of the program and between them.)15 3542 1 720 2076 t
-(The terminal part of)3 804 1 970 2232 t
-10 CW f
-(sam)1800 2232 w
-10 R f
-( interesting is how the two halves of the edi-)9 1791( More)1 268(is fairly straightforward.)2 975 3 2006 2232 t
-( data structure that)3 746( is achieved through a)4 888( This)1 231(tor stay synchronized when either half may initiate a change.)9 2455 4 720 2352 t
-(organizes the communications and is maintained in parallel by both halves.)10 3005 1 720 2472 t
-(The last part of the paper chronicles the writing of)9 2067 1 970 2628 t
-10 CW f
-(sam)3069 2628 w
-10 R f
-( lessons that were learned)4 1057(and discusses the)2 702 2 3281 2628 t
-(through its development and use.)4 1324 1 720 2748 t
-( is composed largely of two papers of reasonable length: a description of the)13 3164(The paper is long, but)4 906 2 970 2904 t
-(user interface of)2 653 1 720 3024 t
-10 CW f
-(sam)1401 3024 w
-10 R f
-( are combined because the implementa-)5 1597( They)1 258(and a discussion of its implementation.)5 1576 3 1609 3024 t
-(tion is strongly influenced by the user interface, and vice versa.)10 2528 1 720 3144 t
-10 B f
-(The Interface)1 579 1 720 3384 t
-10 CW f
-(Sam)720 3540 w
-10 R f
-( names may be provided when it is invoked:)8 1765( File)1 206(is a text editor for multiple files.)6 1291 3 925 3540 t
-9 CW f
-(sam file1 file2 ...)3 1026 1 1008 3710 t
-10 R f
-( are not read until necessary to)6 1255( Files)1 251( files and discard unneeded ones.)5 1349(and there are commands to add new)6 1465 4 720 3890 t
-( file is read; the)4 673( operations apply to an internal copy made when the)9 2214( Editing)1 359(complete some command.)2 1074 4 720 4010 t
-( simplify the discussion, the)4 1124( To)1 162( is changed only by an explicit command.)7 1672(Unix file associated with the copy)5 1362 4 720 4130 t
-(internal copy is here called a)5 1144 1 720 4250 t
-10 I f
-(file)1889 4250 w
-10 R f
-(, while the disc-resident original is called a)7 1714 1 2017 4250 t
-10 I f
-(disc file.)1 339 1 3756 4250 t
-10 CW f
-(Sam)970 4406 w
-10 R f
-( connected to a bitmap display that presents a cut-and-paste editor driven by the)13 3446(is usually)1 400 2 1194 4406 t
-( special window, called the)4 1116( this mode, the command language is still available: text typed in a)12 2776(mouse. In)1 428 3 720 4526 t
-10 CW f
-(sam)720 4646 w
-10 I f
-(window,)930 4646 w
-10 R f
-( editing may be)3 637( Cut-and-paste)1 616( as commands to be executed in the current file.)9 1961(is interpreted)1 529 4 1297 4646 t
-(used in any window \320 even in the)7 1467 1 720 4766 t
-10 CW f
-(sam)2223 4766 w
-10 R f
-( mode of operation,)3 812( other)1 241( The)1 216(window to construct commands.)3 1332 4 2439 4766 t
-(invoked by starting)2 774 1 720 4886 t
-10 CW f
-(sam)1520 4886 w
-10 R f
-(with the option)2 608 1 1726 4886 t
-10 CW f
-(-d)2360 4886 w
-10 R f
-( the mouse or bitmap display,)5 1193(\(for `no download'\), does not use)5 1341 2 2506 4886 t
-( even on an ordinary terminal, interactively or)7 1849(but still permits editing using the textual command language,)8 2471 2 720 5006 t
-(from a script.)2 535 1 720 5126 t
-(The following sections describe first the command language \(under)8 2783 1 970 5282 t
-10 CW f
-(sam -d)1 360 1 3789 5282 t
-10 R f
-(and in the)2 418 1 4185 5282 t
-10 CW f
-(sam)4640 5282 w
-10 R f
-(win-)4857 5282 w
-( two languages are nearly independent, but connect through the)9 2573( These)1 293( the mouse interface.)3 846(dow\), and then)2 608 4 720 5402 t
-10 I f
-(current text,)1 488 1 720 5522 t
-10 R f
-(described below.)1 676 1 1233 5522 t
-10 B f
-(The Command Language)2 1090 1 720 5762 t
-10 R f
-( array of characters \(that is, a string\); the)8 1644(A file consists of its contents, which are an)8 1733 2 720 5918 t
-10 I f
-(name)4125 5918 w
-10 R f
-(of the associated)2 671 1 4369 5918 t
-(disc file; the)2 498 1 720 6038 t
-10 I f
-(modified bit)1 483 1 1245 6038 t
-10 R f
-( those of the disc file; and a substring of the)10 1758(that states whether the contents match)5 1527 2 1755 6038 t
-(contents, called the)2 786 1 720 6158 t
-10 I f
-(current text)1 472 1 1540 6158 t
-10 R f
-(or)2046 6158 w
-10 I f
-(dot)2163 6158 w
-10 R f
-( the current text is a null string, dot falls)9 1689( If)1 126( and 2\).)2 322(\(see Figures 1)2 578 4 2325 6158 t
-( The)1 211(between characters.)1 791 2 720 6278 t
-10 I f
-(value)1753 6278 w
-10 R f
-( the location of the current text; the)7 1441(of dot is)2 340 2 2000 6278 t
-10 I f
-(contents)3811 6278 w
-10 R f
-(of dot are the charac-)4 866 1 4174 6278 t
-(ters it contains.)2 610 1 720 6398 t
-10 CW f
-(Sam)1381 6398 w
-10 R f
-(imparts to the text no two-dimensional interpretation such as columns or fields; text is)13 3453 1 1587 6398 t
-( the idea of a `line' of text as understood by most Unix programs \320 a)15 3037( Even)1 272(always one-dimensional.)1 1011 3 720 6518 t
-(sequence of characters terminated by a newline character \320 is only weakly supported.)12 3454 1 720 6638 t
-(The)970 6794 w
-10 I f
-(current file)1 453 1 1156 6794 t
-10 R f
-( in the)2 264( current text is therefore dot)5 1141( The)1 211(is the file to which editing commands refer.)7 1784 4 1640 6794 t
-( explicitly name a particular file or piece of text, the command is)12 2827( a command doesn't)3 870( If)1 137(current file.)1 486 4 720 6914 t
-( presence of multiple files and consider)6 1629( the moment, ignore the)4 988( For)1 198(assumed to apply to the current text.)6 1505 4 720 7034 t
-(editing a single file.)3 794 1 720 7154 t
-( for non-editing commands such as writing the file to disc,)10 2354( Except)1 329(Commands have one-letter names.)3 1387 3 970 7310 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 2 2
-%%Page: 3 3
-/saveobj save def
-mark
-3 pagesetup
-10 R f
-(- 3 -)2 166 1 2797 480 t
-cleartomark
-saveobj restore
-%ps_include: begin
-save
-/ed {exch def} def
-{} /showpage ed
-{} /copypage ed
-{} /erasepage ed
-{} /letter ed
-currentdict /findfont known systemdict /findfont known and {
- /findfont systemdict /findfont get def
-} if
-36 dict dup /PS-include-dict-dw ed begin
-/context ed
-count array astore /o-stack ed
-%ps_include: variables begin
-/llx 24 def
-/lly 241 def
-/urx 587.76 def
-/ury 550.6 def
-/w 0 def
-/o 0 def
-/s 0 def
-/cx 2880 def
-/cy -2220 def
-/sx 4320 def
-/sy 2520 def
-/ax 0.5 def
-/ay 0.5 def
-/rot 0 def
-%ps_include: variables end
-{llx lly urx ury} /bbox ed
-{newpath 2 index exch 2 index exch dup 6 index exch
- moveto 3 {lineto} repeat closepath} /boxpath ed
-{dup mul exch dup mul add sqrt} /len ed
-{2 copy gt {exch} if pop} /min ed
-{2 copy lt {exch} if pop} /max ed
-{transform round exch round exch A itransform} /nice ed
-{6 array} /n ed
-n defaultmatrix n currentmatrix n invertmatrix n concatmatrix /A ed
-urx llx sub 0 A dtransform len /Sx ed
-0 ury lly sub A dtransform len /Sy ed
-llx urx add 2 div lly ury add 2 div A transform /Cy ed /Cx ed
-rot dup sin abs /S ed cos abs /C ed
-Sx S mul Sy C mul add /H ed
-Sx C mul Sy S mul add /W ed
-sy H div /Scaley ed
-sx W div /Scalex ed
-s 0 eq {Scalex Scaley min dup /Scalex ed /Scaley ed} if
-sx Scalex W mul sub 0 max ax 0.5 sub mul cx add /cx ed
-sy Scaley H mul sub 0 max ay 0.5 sub mul cy add /cy ed
-urx llx sub 0 A dtransform exch atan rot exch sub /rot ed
-n currentmatrix initgraphics setmatrix
-cx cy translate
-Scalex Scaley scale
-rot rotate
-Cx neg Cy neg translate
-A concat
-bbox boxpath clip newpath
-w 0 ne {gsave bbox boxpath 1 setgray fill grestore} if
-end
-gsave
-%ps_include: inclusion begin
-/picstr 98 string def
-24 241 translate
-563.76 309.60 scale
-
-783 430 1 [783 0 0 -430 0 430]
-{currentfile picstr readhexstring pop} image
-
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-02001fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfffffffe7fffffffe227ff0feffffffffffffff3ff87ff11ffcffffffff
-fffffffe7fe7ffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffde01ffffe7fffffffe227fe7f9f833900fffffef3ff3e0711ffcffdffff1
-e0fffffe7fe7ffe7f3e0ffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfcfffffe7fffffffe233fe7f3f3b39e7fffffcf9ff3e7311ffcff9fffe9
-ce7fffffffe7ffc7e3ce7fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfcfe3ffe4f879cfff773f80f3e7f3de7f0e73019fc0673bbffc8e03ffe9
-ce7ff3907f07ffa7d3ce7fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfcfe3ffe27339cfff779fe7e7e7f25e7e6673cfcff3e73bbffc479fffd9
-ce7ff3de7e67ff67b3fe7fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfcfe3ffe7279cdfff779fe7e7e7f25e7ce737cfcff3e73bbffce79fffd9
-ce7ff25e7ce7ffe7f3fe7fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02ffdfcfffffe7279c3fffffcfe7e7e7f25e7ce70fcfe7f3e67ffffce79fffb9
-ce7ff25e7ce7ffe7f3fcffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfffffe7279f7fffffcfe7e7e7f93e7c07dfcfe7f3e0fffffce79fff80
-ce7ff25e7ce7ffe7f3f9ffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcfffffe7279e1fffffe7e7e7e7f93e7cff87cff3f3e7fffffce79fff80
-ce7ff93e7ce7ffe7f3f3ffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfe3ffe7279d9fffffe7e7e7e7f93e7cff67cff3f3e7fffffce79ffff9
-ce7ff93e7ce7ffe7f3e7ffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcfe3ffe67339cffffff3e7e7f3b93e7e6673cff9f3e7fffffce79ffff9
-ce7ff93e7e47ffe7f3c07fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfe3ffe0f879cffffff381f3f8393e7f0e73e1f9c0e7fffffce7c3ffe0
-e0fff9300f27ff81c0c07fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889ffffffffffffffffffff9fff3fffffffffffffffcffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221ffffffffffffffffffff9fff9fffffffffffffffcffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889ffffffffffffffffffffffffeffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffe7fffffffe227ff0feffffffffffffff3ff87ff11ffcffffffff
-fffffffe7fe7fffffffffffcfffcffffffffffffffffffefffffffffffffffff
-fffffffffffffffffeffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e07ffffe7fffffffe227fe7f9f833903fffffff3ff3e0711ffcffdffff1
-e0fffffe7fe7ff83c1fffffcff7cfffffffffffffeffff9c03ffffffffffff3e
-0fffff00ffffffffff3fffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889e73ffffe7fffffffe233fe7f3f3b3939fffffff9ff3e7311ffcff9fffe9
-ce7fffffffe7ff399cfffffffe7cfffffffffffffcffff3f9ffffffffffffe3c
-e7ffffe7ffffffffff9fffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e73e3ffe4f879cfff773f80f3e7f3d39e0f07279fc0673bbffc8e03ffe9
-ce7ff3907f07ff399cffe720f80c8fffff9cfff0701fff3f9fffe1ffe73cfd3c
-ffffffe7fff87ff9cf9fffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889e73e3ffe27339cfff779fe7e7e7f2539ce67313cff3e73bbffc479fffd9
-ce7ff3de7e67ff399cffe7bcfe7c47ffff9effe73cfffe7f9fffccffe73cfb3c
-ffffffe7fff33ff9cfcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e77e3ffe7279cdfff779fe7e7e7f253bfe67f39cff3e73bbffce79fffd9
-ce7ff25e7ce7ff399cffe4bcfe7ce7ffff92ffff3cfffe7f9fff9cfff37cff3c
-ffffffe7ffe73ff9efcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889e0fffffe7279c3fffffcfe7e7e7f2507fe63f39e7f3e67ffffce79fffb9
-ce7ff25e7ce7ff819cffe4bcfe7ce7ffff92ffff3cfffe7f9fff9cfff0e01f3c
-0fffffe7ffe73ffccfcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e67ffffe7279f7fffffcfe7e7e7f9333e070739e7f3e0fffffce79fff80
-ce7ff25e7ce7fff99cffe4bcfe7ce7ffff92fff03cfffe7f9fff80fffde01f3c
-e7ffffe7ffe03ffcdfcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889e67ffffe7279e1fffffe7e7e7e7f9333ce7e339f3f3e7fffffce79fff80
-ce7ff93e7ce7fff99cfff27cfe7ce7ffffc9ffe73cfffe7f9fff9ffff87cff3c
-e7ffffe7ffe7fffcdfcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e73e3ffe7279d9fffffe7e7e7e7f9339ce7f339f3f3e7fffffce79ffff9
-ce7ff93e7ce7fff99cfff27cfe7ce7ffc7c9ffe73cfffe7f9fc79ff1f67cff3c
-e78fffe7f1e7fc7e3fcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889e73e3ffe67339cffffff3e7e7f3b9339cc67333f9f3e7fffffce79ffff9
-ce7ff93e7e47ff399cfff27cfe7ce7ffc7c9ffe63cfffe7f9fc7ccf1e73cff3c
-e78fffe7f1f33c7e3fcfffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e71e3ffe0f879cffffff381f3f839338e270707f9c0e7fffffce7c3ffe0
-e0fff9300f27ff83c1fff2601f0ce7ffc7c9fff13e1fff3f9fc7e1f1e73ffc0e
-0f8fffe7f1f87c7f3f9fffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889ffffffffffffffffffff9fff3ffffffffffff3ffcffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff3fffffffffffffffff
-ffcfffffffffffff7f9fffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221ffffffffffffffffffff9fff9ffffffffffff3ffcffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff9fffffffffffffffff
-ffcffffffffffffe7f3fffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889ffffffffffffffffffffffffeffffffffffff3fffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffefffffffffffffffff
-ff9ffffffffffffc7effffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889e0fe7ffffffff0fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfe7fffffffe7fffffffff807fffffffbfffff03ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcffffffffffe7ffffffffff3ffffffff3fffff39ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcf07c8f87ff80c670e5bfff3fffc3ffc070fff39ffe73fffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcfe7c4733ffe7e066601fff3fff99fff3e67ff39ffe7bfffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfe7ce673ffe7e64f249fff3fff39fff3cf3ff3bffe4bfffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcfe7ce673ffe7e7cf249fff3fff39fff3cf3ff07ffe4bfffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfe7ce603ffe7e7cf249fff3fff01fff3cf3ff33ffe4bfffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcfe7ce67fffe7e7cf249fff3fff3ffff3cf3ff33fff27fffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fcfe7ce67fffe7e7cf249fff3f8f3ffff3cf3ff39f1f27fffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fcfe7ce733ffe7e7e6649fff3f8f99fff3e67ff39f1f27fffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221e0100ce787ff81c1f0e49fff3f8fc3fff870fff38f1f27fffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffff80000000800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c00000000001fffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff3f80000001800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889c00000000001fff87ffffffffffffffffffffcfffcfffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff0f80078c67f00000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c00000000001fff3fffffffffc0ffffffffffcfffcffdfffc1f8fffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff1f800ccc61800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889c00000000001fff3fffffffffce7fffffffffffffcff9fff9cf4fffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff3f8018cc61800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c7c73398f0c7ffc0633872dffce7ffe1ffe320fe0c8e03ff9cf4fffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7d80180c61800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889cc63f1f998c3fff3f033300ffce7ffccfff03cfccc479ffffcecfffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffff980180c61800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c063319b0cdbfff3f327924ffcefff9cfff33cf9cce79ffffcecfffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffef080180c61800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889c06301830cdbfff3f3e7924ffc1fff9cfff3fcf9cce79ffff9dcfffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffce080180c61800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c7e301830cdbfff3f3e7924ffccfff80fff3fcf9cce79ffff3c07ffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fff8c0000ccee1800000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889cc6301830c6dfff3f3e7924ffccfff9ffff3fcf9cce79fffe7c07ffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fff08000078760f00000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221cc6301830c6dfff3f3e7924ffce7c79ffff3fcf9cce79fffcffcfffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe00000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889cce30181986dfff3f3f3324ffce7c7ccfff3fcfc8ce79fff80fcfffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffc10000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c767c3e0f06dffc0e0f8724ffce3c7e1ffe0e01e4ce7c3ff80f07ffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ff837ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889c00000000001ffffffffffffffffffffffffffffcffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffc77ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221c00000000001fffffffffffffffffffffffffff9cffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffef7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889c00000000001fffffffffffffffffffffffffffc1ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fffffffff7ffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffe7ffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889f3ffffffffcffffff9fffffc47ffffffcffffffffc47ffffe7ffe7fffff
-fffffffffffffffffcfffffe1ff83fffffffffffffffffffffffffffffffffff
-ffff7fc9f078380f0ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221f3ffffffffcffffff9fffffc47dfffffcfffffff7c47ffffe7fbe7fffff
-ffffffff7ffffffffcfffffcffff3ffffff7ffffffffffffffffffffffffffff
-ffff7fc4e7339e7e67feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889f3fffffffffffffffffffffc479fffffcffffffe7c47fffffff3e7fffff
-fffffffe7ffffffffcfffffcffff3fffffe7ffffffffffffffffffffffffffff
-ffff7fce7f33fe7ce7feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221f27c3ce7fe0f91ce41f83ffeee0387ffc8f0f8380eefff3907c0647ffff
-ce7ff8380fff8723e0fff0f01fff3f078380fff07198ce1e73ffffffffffffff
-ffff7fce7f31fe7ce7feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889f1399ce7ffcf88ce79f39ffeef9f33ffc466739e7eefff3de7f3e23ffff
-cf7ff39e7fff3311ccffe67cffff3e7339e7ffe7381c0cce7bffffffffffffff
-ffff7fce70383e7c07feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221f393ce6fffcf9ccf79f3fffeef9e79ffce4f33fe7eefff25e7f3e73ffff
-c97fff9e7ffe73399cffcf3cffff3ff33fe7ffff399cc9e64bffffffffffffff
-ffff7fce673f1e7cfffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889f393ce1fffcf9ce679f1ffffff9e79ffce4f31fe7fffff25e7f3e73ffff
-c97fff9e7ffe73399cffcf3cffff3ff31fe7ffff39fcf9e64bffffffffffffff
-ffff7fce673f9e7cfffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221f393cfbfffcf9ce6f9f83fffff9e79ffce4f383e7fffff25e7f3e73ffff
-c97ff81e7ffe03399cffcf3cffff3f0383e7fff039fcf9e64bffffffffffffff
-ffff7fcce6339e7e67feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889f393cf0fffcf9ce6f9ff1fffff9e79ffce4f3f1e7fffff93e7f3e73ffff
-e4fff39e7ffe7f399cffcf3cffff3e73f1e7ffe739fcf9e727ffffffffffffff
-ffff7fc1f1383f0f0ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221f393cecfffcf9cf1f9ff9fffff9e79ffce4f3f9e7fffff93e7f3e73ffe3
-e4fff39e7ffe7f399cffcf3cffff3e73f9e7ffe739fcf9e727ffffffffffffff
-ffff7fcffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889f3399ce7ffcf9cf1f9f39fffff9f33ffce66739e7fffff93e7f3e73ffe3
-e4fff31e7fff3339c8ffe67cffff3e6339e7ffe639fcfccf27ffffffffffffff
-ffff7fcffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221f07c3ce7fe019cf1c0383fffffc387ffce70f83f0fffff9300f8673ffe3
-e4fff89f0fff8739e4fff0f03ff8071383f0fff130783e1f27ffffffffffffff
-ffff7fcffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fffffffffff87feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fffffffffff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fffffffffff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fe0e47838cc07feffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fce62339c0f3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fcfe73f9ccf3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fc7e73f9cff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fe0e7381cff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffc67339cff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffe67339cff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-02001fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fce67331cff3ffeffffffffffffffffffffffffffffffffffffffffffff
-ff81
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-00007fe0e738983c0ffe00000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-00007ffffffffffffffe00000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-00007ffffffffffffffe00000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-00007ffffffffffffffe00000000000000000000000000000000000000000000
-0001
-0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffc1fffffcffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e001fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9fffffcffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffe1e7ffffffffff3ffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9fffffcffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffcfe7fff03fffff3ffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9f87c3ce7ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffcffffff03ffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9f3399cefffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffff0107f077fff9383f87fffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9e793ccdfffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffcfe7e677fff89f3f33fffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9e793ccbfffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffcfe7ce71fff9cf3e73fffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9e793cc3fffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fff80fffffcfe7ce7c7ff9cf3e7ffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9e793cc9fffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fff80fffffcfe7ce7f3ff9cf3e7ffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9e793cccfffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffcfe7ce7f3ff9cf3e7ffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fff9f3399ce7ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffff1fffcfe7ce7f3c79cf3e7ffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffc0387c3ce7ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffff1fffcfe7e4673c799f3f33fffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffff1fff0300f2707c78380787fffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffe7ffff9fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffce7ffff9fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffffffe0fffff9fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffefffffffefffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ff9ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffcfffffffe7ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ff9ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ff9cb7399cf3ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ff3ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ff3c03399cf9ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ff3c1c6633879cfffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fe7c9339cdfcffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fe79ce0703339efffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fc7c9339c3fc7feffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fe7fce67327992fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fe7c9339f7fcffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fcffce7f3e7992fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ff3c9339e1f9ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fcfc0e7f3e7992fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ff9c9339d9f3ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f9f9ce7f3e79c9fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffcc93119ce7ffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f9f9ce7f3e79c9fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffec93899cefffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f3f98e7f3f33c9fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f3fc4c1e0f87c9fffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221e7fffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889e7fffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7ffffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fe7fffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fe7fffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fcffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7fcf07198ce1e73effffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7f9e7381c0cce7beffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7f9ff399cc9e64beffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7f3ff39fcf9e64beffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7f3f039fcf9e64beffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7e7e739fcf9e727effffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7e7e739fcf9e727effffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7cfe639fcfccf27effffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff7cff130783e1f27effffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff79fffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff79fffffffffffffeffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff0000000000000000ffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221dffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e001fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-00000000000000000000000000000000000000000000077fef81fffff3ffffff
-fceec00c0303e633f060300060060fc77ffe7feffff8f07fffff3ff3fff3f9f0
-7fffff3fdf3fffffffffffffffdfff80e07ff01c1f8ffffffffffffffe000000
-0001
-0ffffffffffffffffffffffffffffffffffffffffffff77fef9ffffff3ffffff
-fcee600c060626330000300030060c677ffe7fcffff4e73ffffffff3ffe3f1e7
-3fffffff9f3fffffffffffffff9fff80e07ff019cf4ffffffffffffffeffffff
-ffe1
-0ffffffffffffffffffffffffffffffffffffffffffff77fef9ff1fff27c3ce7
-fc44603f860c061303e0301e301fcc622ffe4701fff4e73ff9c83f83ffd3e9e7
-3ff9c83e0323ffffe4739ffe0e03fffeefffffd9cf4ffffffffffffffeffffff
-ffe1
-0e001ffffffffffffffffffffffffffffffffffffffff77fef9ff1fff1399ce7
-fc44300c0c0c06d30060303318060c622ffe23cfffece73ff9ef3f33ffb3d9ff
-3ff9ef3f9f11ffffe233dffce79ffffcefffff99cecffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffcffffe7fffff77fef9ff1fff393ce6f
-fc44300c0c0c06d30060306318060c622ffe73cfffece73ff92f3e73fff3f9ff
-3ff92f3f9f39ffffe7325fffe79ffff9e3ffff39cecffffffffffffffeffffff
-ffe1
-0e221fffffffffffffffbffffffffffffcffffe7fffff77fef83fffff393ce1f
-fc00180c0c0c06d3e06030630c060cc00ffe73cfffdce73ff92f3e73fff3f9fe
-7ff92f3f9f39ffffe7325fffe79ffff3f8fffe79cdcffffffffffffffeffffff
-ffe1
-0e889fffffffffffffff3fffffffffffffffffe7fffff77fef9ffffff393cfbf
-fc00180c0c0c03630060307f0c060f800ffe73cfffc0673ff92f3e73fff3f9fc
-fff92f3f9f39ffffe7325ffe079fffe7fe7ffcf9cc07fffffffffffffeffffff
-ffe1
-0e221f19e1f0673c3c1c0707ffc1ffe720f91f070f39f77fef9ffffff393cf0f
-fc000c0c0c0c03630060306006060c000ffe73cfffc0673ffc9f3e73fff3f9f9
-fffc9f3f9f39ffffe7393ffce79fffe7fe7ffcf9cc07fffffffffffffeffffff
-ffe1
-0e889f81cce6673999cf3e73ff9cffe7bcf88e66673df77fef9ff1fff393cecf
-fc000c0c0c0c03630060306006060c000ffe73cffffce73ffc9f3e73fff3f9f3
-fffc9f3f9f39fff1e7393ffce79fffcffe78f9f9cfcffffffffffffffeffffff
-ffe1
-0e221f999cce673399ff3e7ffffcffe4bcf9cce4f325f77fef9ff1fff3399ce7
-fc00060c0c0623630060303303060c000ffe73cffffce73ffc9f3f23fff3f9e0
-3ffc9f3f9f39fff1e7393ffcc79fffcfce78f9f9cfcffffffffffffffeffffff
-ffe1
-0e889f9f9cce673398ff3e3ffffcffe4bcf9cce4f325f77fef9ff1fff07c3ce7
-fc00063f0603e36303fdfe1e031f8c000ffe73e1fff0707ffc980793ffc0e060
-3ffc9807c339fff1e7393ffe27c3ffcfe0f8f9fc1f07fffffffffffffeffffff
-ffe1
-0e221f9f80ce67301c1f3f07ffc0ffe4bcf9cce4f325f77fefffffffffffffff
-fc0003000600000000000000018000000fffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffcfffffffffffffffffffffeffffff
-ffe1
-0e889f9f9fce6733ff8f3fe3ff9cfff27cf9cce4f393f77fefffffffffffffff
-fc0003000300000000000000018000000fffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffcfffffffffffffffffffffeffffff
-ffe1
-0e221f9f9fce6733ffcf3ff3ff9cfff27cf9cce4f393f77fefffffffffffffff
-fc0000000080000000000000000000000fffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffff9fffffffffffffffffffffeffffff
-ffe1
-0e889f9fcce4623999cf3e73ff98fff27cf9ce466793f77fefffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221f07e1f2713c3c1f8707ffc4fff26019cf270f93f77fefffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffe7ffffffffffffffffffffffffffffffff77fefffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221ffffffe7ffffffffffffffffffffffffffffffff77fefffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffe7ffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221ffffffffffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fffe0ce7ffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fffcece7ffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fff9fcf7ff23e1ce7fffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fff9fc97ff11cccf7fffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fff9fc97ff399cc97fffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fff9fc97ff399cc97fffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fff9fe4fff3980c97fffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fff9fe4fff399fe4ffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fc79fe4fff399fe4fffc7fffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fc7cee4fff39cce4fffc7fffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fc7e0e4fff39e1e4fffc7fffffffffffffffffff7222f07f3ffffffff87
-fffffffffffffffffffffffffffff3ffff87c3ffffffffffff0f87ffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fffffffffffffffffffe7fffffffffffffffffff7088fe7f3ffffffff3f
-ffffffffe0f83fffffffefffffe733ffff3f9fffffffe07ffe7f3fffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fffffffffffffffffffe7fffffffffffffffffff7222fe7ffffffffff3f
-ffffffffe6739fffffffcfffffe733ffff3f9fffffffe73ffe7f3fffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fffffffffffffffffffcffffffffffffffffffff7088fe783e47c3ffc06
-33872dffe7339ffc8fff01c3ffe23279cc0603c38cffe733980c078719ffe0ff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221ffffffffffffffffffffffffffffffffffffffff7222fe7f3e2399fff3f
-033300ffe73f9ffc47ffcf99ffe23139cf3f9f99c0ffe7339e7f3f3381ffce7f
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffffffffffff7088fe7f3e7339fff3f
-327924ffe73f9ffce7ffcf3cffe93399cf3f9f39ccffe7739e7f3e7399ffcfff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fffe0ce7ffffffffffffffffffffffffffffffff7222fe7f3e7339fff3f
-3e7924ffe73f3ffce7ffcf3cffe93399cf3f9f39cfffe0f39e7f3e739fffc7ff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fffcece7ffffffffffffffffffffffffffffffff7088fe7f3e7301fff3f
-3e7924ffe73e7ffce7ffcf3cffe93399cf3f9f01cfffe7739e7f3e039fffe0ff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fff9fcf7ff39e1c670f39fffffffffffffffffff7222fe7f3e733ffff3f
-3e7924ffe73cfffce7ffcf3cffe93399cf3f9f3fcfffe7339e7f3e7f9ffffc7f
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fff9fc97ff39cce066739fffffffffffffffffff7088fe7f3e733ffff3f
-3e7924ffe739fe3ce7ffcf3cffef3399cf3f9f3fcff1e7339e7f3e7f9fe3fe7f
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fff9fc97ff9b9ce64f39bfffffffffffffffffff7222fe7f3e7399fff3f
-3f3324ffe6701e3ce7ffcf99ffef33388f3f9f99cff1e7311e7f3f339fe3ce7f
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fff9fc97ff879ce7cf387fffffffffffffffffff7088f0080673c3ffc0e
-0f8724ffe0f01e3ce7ffe1c3ffef307c4c0e07c383f1e078981c0f8707e3e0ff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fff9fe4fffef80e7cf3effffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fff9fe4fffc39fe7cf3c3fffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fc79fe4fffb39fe7cf3b3fffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889fc7cee4fff39cce7e6739fffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221fc7e0e4fff39e1c1f0f39fffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221ffffffffffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221ffffffffffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221ffffffffffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221f878cfffffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889f33c0fffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221e79ccfffffffffffffffffffffffffffffffffff7222fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889e79cffffffffffffffffffffffffffffffffffff7088fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221e79cffffffffffffffffffffffffffffffffffff7000fffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889e79cffffffffffffffffffffffffffffffffffff7ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e221e79cffffffffffffffffffffffffffffffffffff7ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffffffffffffffffffffeffffff
-ffe1
-0e889f33cffffffffffffffffffffffffffffffffffff0000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000ffffff
-ffe1
-0e221f8783ffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffffe7fffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffe0ce7ffffffffe7fffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffcece7ffffffffe7fffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fff9fcf7ff19e1e0e478393f0ffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fff9fc97ff81ccce6233989e67fffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfff9fc97ff999ccfe73f99cce7fffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0effdfff9fc97ff9f9cc7e73f99cce7fffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fff9fe4fff9f80e0e73819cc07fffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fff9fe4fff9f9ffc673399ccfffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fc79fe4fff9f9ffe673399ccffffc7fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fc7cee4fff9fccce6733199e67ffc7fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fc7e0e4fff07e1e0e738983f0fffc7fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffff9ffffffe7fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffff9ffffffe7fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffff9ffffffcffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fcffffffff3fffffffffffffffff3ffffffffffffffffffffffffffffff
-fffffe1fffffffffffcfffffffffffffff07fffffffffffffffffffffffffffc
-fffffffffff9fff9ffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fcff7fffff3fffffffffffffffdf3ffffffffffffffffffffffffffffff
-fffffcfffffffffff7cfffffffffffffffe7fffffffffffffffff7fffffffffc
-fffffffffff9fef9ffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffe7fffff3fffffffffffffff9f3ffffffffffffffffffffffffffffff
-fffffcffffffffffe7cfffffffffffffffe7ffffffffffffffffe7fffffffffc
-fffffffffffffcf9ffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221e0f80fff8723c1c8f83c3c1ffe0323e1ffcb7879ce0f87ffe1ce63383c3
-c67ff018ce1cb7ff80c8f87ff9ce0e7383e7fff07198ce1e73ff80e1fff83ffc
-9f0f39ffce41f0191fffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fcfe7fff33119cc4733999cfff9f11ccffc03339cce733ffccce7033999
-e07ffcfc0ccc03ffe7c4733ff9cce67339e7ffe7381c0cce7bffe7ccfff39ffc
-4e6739ffcf79fcf88fffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fcfe7ffe7339fcce673399ffff9f399cffc92799ccfe73ff9cce7333f3c
-e67ffcfcc9e493ffe7ce673ff9ccfe73f9e7ffff399cc9e64bffe79e7fff9ffc
-e4f39bffc979fcf9cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fcfe7ffe7f39fcce673398ffff9f399cffc92799cc7e73ff9fce73f1f3c
-e7fffcfcf9e493ffe7ce673ff9cc7e73f9e7ffff39fcf9e64bffe79e7fff9ffc
-e4f387ffc979fcf9cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fcfe7ffe7f39c0ce67301c1fff9f3980ffc92799ce0e03ff9fce73f833c
-e7fffcfcf9e493ffe7ce603ff9ce0e7381e7fff039fcf9e64bffe79e7ff81ffc
-e4f3efffc979fcf9cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fcfe7ffe7f399cce6733ff8fff9f399fffc92799cfc67fff9fce73ff13c
-e7fffcfcf9e493ffe7ce67fff9cfc67339e7ffe739fcf9e727ffe79e7ff39ffc
-e4f3c3ffe4f9fcf9cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fcfe7ffe7f399cce6733ffcfff9f399fffc92799cfe67fff9fce73ff93c
-e7fffcfcf9e493ffe7ce67fff9cfe67339e7ffe739fcf9e727ffe79e7ff39ffc
-e4f3b3ffe4f9fcf9cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fcfe7fff333998ce723999cfff9f39ccffc933388ce733ffccc473f3999
-e7fffcfcfccc93ffe7ce733ff88ce62331e7ffe639fcfccf27ffe7ccfff31ffc
-ce6739ffe4f9fcf9cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221e01f0fff8739c4ce793c3c1fffc339e1ffc9387c4e0f87ffe1e260f83c3
-c1fff0383e1c93fff0ce787ffc4e0f138900fff130783e1f27fff0e1fff89ffc
-1f0f39ffe4c03e19cfffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffffff3ffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffffffffe73ffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffff07ffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffff0783fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffffe7f3fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffe7f3fffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f83ffe0cb783e7f3fff838cc670f39fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f39ffce40339e7f3fff39c0e06673dfffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ff9ffcfc93f9e7f3ffff9cce64f325fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ff9ffc7c93f9e7f3ffff9cfe7cf325fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f81ffe0c9381e7f3fff81cfe7cf325fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f39fffc49339e7f3fff39cfe7cf393fffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f39fffe49339e7f3fff39cfe7cf393e3fffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f31ffce49331e7f3fff31cfe7e6793e3fffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f89ffe0c938900807ff8983c1f0f93e3fffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffc00000
-000000000000001fffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffff3fe7fffffffffffffffffffffff3fffffffffffffffffffff
-fffffff9ffffffffffffff3fffffffffcffffe79ffffffffffffffffffc00003
-006000000000001ffffffffffffffffff07fffff3fffffffffffffffffffffff
-ffe1
-0e221f03fffffdf3fe7ffffffff7fffdffffffffdf3fffffffffffffffffffff
-fffffff9ffffffffffffff3fff7fffffcffffe79ffffffbfffffffffffc00003
-006010000000001ffffffffff7fffffffe7fffff3fffffffffffffffffffffff
-ffe1
-0e889fcffffff9f3ffffffffffe7fff9ffffffff9f3fffffffffffffffffffff
-fffffff9ffffffffffffff3ffe7ffffffffffe7fffffff3fffffffffffc00003
-000030000000001fffffffffe7fffffffe7fffff3fffffffffffffffffffffff
-ffe1
-0e221fcf91ffe032307e0fff8380e0e03c3ffffe0323e1ffcb7879ce0f87ff2d
-e0e73ff93f0fff39c1f0f83ff80e1ffe0f91f041fc3c1c0787ffc1c8ffc7c733
-63e0fe731f1ccc7ffc6787c380e0e47c1e7f0fff279cffffffffffffffffffff
-ffe1
-0e889fcf88fff9f11e7ce7ff39e7ce79f99fffff9f11ccffc03339cce733ff00
-ce673ff89e67ff399ce6733ffe7ccfffcf88e679f999cf3f33ff9cc47fcc63f3
-b060303f318fcc7ffe073399e7ce62399e7e67ff139cffffffffffffffffffff
-ffe1
-0e221fcf9cfff9f39e7cffff3fe7fe79f39fffff9f399cffc92799ccfe73ff24
-fe67bff9cce7ff399fce673ffe79e7ffcf9cce79f39fcf3e73fffcce7fc06333
-18603033018ccc3ffe667339e7fe67339e7ce7ff399effffffffffffffffffff
-ffe1
-0e889fcf9cfff9f39e7c7fff1fe7fe79f39fffff9f399cffc92799cc7e73ff24
-fe733ff9cce7ff398fce673ffe79e7ffcf9cce79f3ffcf3e73fffcce7fc06303
-18603030018c067ffe7e733fe7fe67339e7ce7ff39ccffffffffffffffffffff
-ffe1
-0e221fcf9cfff9f39e7e0fff83e7e079f01fffff9f3980ffc92799ce0e03ff24
-e0737ff9cc07ff39c1c0673ffe79e7ffcf9cce79f3fc0f3e03ffc0ce7fc7e303
-186030301f8c065ffe7e033fe7e067339e7c07ff39cdffffffffffffffffffff
-ffe1
-0e889fcf9cfff9f39e7fc7fff1e7ce79f3ffffff9f399fffc92799cfc67fff24
-ce737ff9ccffff39f8cfe73ffe79e7ffcf9cce79f3f9cf3e7fff9cce7fcc6303
-18603030318c065ffe7e7f3fe7ce67339e7cffff39cdffffffffffffffffffff
-ffe1
-0e221fcf9cfff9f39e7fe7fff9e7ce79f3fe3fff9f399fffc92799cfe67fff24
-ce78fff9ccffff39fccfe73ffe79e7ffcf9cce79f3f9cf3e7fff9cce7fcc6303
-18603030318c039ffe7e7f3fe7ce67339e7cffff39e3ffffffffffffffffffff
-ffe1
-0e889fcf9cfff9f39e7ce7ff39e7cc79f99e3fff9f39ccffc933388ce733ff24
-cc78fff99e67ff119ce6723ffe7ccfffcf9ce479f9998f3f33ff98ce7fcce303
-30603030338c039ffe7f3399e7cc67391e7e67ff33e3ffffffffffffffffffff
-ffe1
-0e221f039cfffc33900e0fff83f0e27c3c3e3fffc339e1ffc9387c4e0f87ff24
-e27cfff83f0fff89c1f0f93fff0e1ffe019cf2403c3c4f8787ffc4ce7fc767c3
-e3fc1e7c1d9f019ffc1f87c3f0e2673c900f0fff07f3ffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffff3fffffffffffffffffffffffffff
-fffdffffffffffffffffffffffffffffffffffffffffffffffffffffffc00000
-000000000000011fffffffffffffffff9ffffffffff7ffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffff3fffffffffffffffffffffffffff
-fff9ffffffffffffffffffffffffffffffffffffffffffffffffffffffc00000
-000000000000031ffffffffffffffff39fffffffffe7ffffffffffffffffffff
-ffe1
-0e889ffffffffffffffffffffffffffffffe7fffffffffffffffffffffffffff
-fff1ffffffffffffffffffffffffffffffffffffffffffffffffffffffc00000
-000000000000071ffffffffffffffff83fffffffffc7ffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffe7fffffff9fffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffe7ffffff83ffffffff3ffffffff3ffffffffffffff9ff
-fffffffffffffffe7fffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffffe7fffffff9ffffdfeffffffff83fffffdffffffffffffff
-fffffffffffffffffffe7fffffff3ffffffff3ffffffff3fdffffffbfffef9ff
-fffffffffffffffe7fbfffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffff9ffff9fcffffffff39fffff9ffffffffffffff
-fffffffffffffffffffe7fffffff3fffffffffffffffffff9ffffff3fffcf9ff
-ffffffffffffffffff3fffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f278cf0f078307c8f83ff93ce60301c3c8fff39ffe0e03ffc3c8f87ffe1
-e1e3323e1c67ff8391f07ff19e1f3f8783c183e47c1ff83e03ffc1c07ff0191f
-0fff8793c9f0f8307c0787ffe1e1e3323e1c67ffffffffffffffffffffffffff
-ffe1
-0e889f13c0e667339e7c4733ff89ce79fcf99c47fff9ffce79fff99c4733ffcc
-ccf0311cce07ff3988e67ff81ccf3f33399cf3e2399fff3f9fff9cf3fffcf88e
-67ff3389c4e6739e7f3f33ffccccf0311cce07ffffffffffffffffffffffffff
-ffe1
-0e221f39ccce67f3fe7ce673ff9cce79fcf3cce7fff9fffe79fff3cce673ff9c
-9e733399ce67fff99cce7ff999cf3e73f99ff3e7339fff3f9ffffcf3fffcf9cc
-e7fe799cce4f33fe7f3e73ff9c9e733399ce67ffffffffffffffffffffffffff
-ffe1
-0e889f39cfce63f1fe7ce673ff9cce79fcf3cce7ffc7fffe79fff3cce673ff9f
-9e73f399ce7ffff99cce7ff9f9cf3e73f98ff3e7339fff3f9ffffcf3fffcf9cc
-e7fe799cce4f31fe7f3e73ff9f9e73f399ce7fffffffffffffffffffffffffff
-ffe1
-0e221f39cfc070783e7ce673ff9cce79fcf3cce7fff9ffe079fff3cce603ff9f
-9e73f3980e7fff819cce7ff9f80f3e0381c1f3e7339fff3f9fffc0f3fffcf9cc
-07fe799cce4f383e7f3e03ff9f9e73f3980e7fffffffffffffffffffffffffff
-ffe1
-0e889f39cfcffe3f1e7ce673ff9cce79fcf3cce7fff9ffce79fff3cce67fff9f
-9e73f399fe7fff399cce7ff9f9ff3e7f39f8f3e7339fff3f9fff9cf3fffcf9cc
-fffe799cce4f3f1e7f3e7fff9f9e73f399fe7fffffffffffffffffffffffffff
-ffe1
-0e221f39cfcfff3f9e7ce673ff9cce79fcf3cce7fff9ffce79fff3cce67fff9f
-9e73f399fe7fff399cce7ff9f9ff3e7f39fcf3e7339fff3f9fff9cf3fffcf9cc
-fffe799cce4f3f9e7f3e7fff9f9e73f399fe7f8fffffffffffffffffffffffff
-ffe1
-0e889f33cfe667339e7ce723ff99c479fcf99ce7ff39ffcc79fff99ce733ffcc
-ccf3f39cce7fff319ce47ff9fccf3f33319cf3e7391fff3f9fff98f3fffcf9ce
-67ff3399cce6739e7f3f33ffccccf3f39cce7f8fffffffffffffffffffffffff
-ffe1
-0e221f0783f0f078300ce793ff83e27c3e1c3ce7ff83ffe27c3ffc3ce787ffe1
-e1e0f39e1c1fff899cf27ff07e18078789c180673c9ff807c3ffc4f87ffe19cf
-0fff8783c1f0f8300f8787ffe1e1e0f39e1c1f8fffffffffffffffffffffffff
-ffe1
-0e889f3ffffffffffffffff3ffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffff9fffffffffffffffffffff
-ffffff9fcfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f3ffffffffffffffe73ffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffff39fffffffffffffffffffff
-ffffff9fcfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f3fffffffffffffff07ffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffffffffffffffffff83fffffffffffffffffffff
-ffffff9fcfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffffffffffffff9fffffffc1fffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f39fffffffffffffffffffffff9ffffffbf9fffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f39ffffffffffffffffffffffffffffff3f9fffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f11c3c6787ffe1e1e4739e1c8c1fc391c079f39ffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f1199e0733ffcccce2339ccc479f9988f3f9f39ffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f493ce6673ff9c9e6733d9cce79f399cf3f9f3dffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f493ce7e73ff9f9e673999cce79f399cf3f9f99ffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f493ce7e03ff9f9e6739b80ce79f019cf3f9f9bffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f493ce7e7fff9f9e6739b9fce79f3f9cf3f9f9bffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f793ce7e7fff9f9e673c79fce79f3f9cf3f9fc7e3ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f7999e7f33ffcccce73c7ccce79f999cf3f9fc7e3ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f79c3c1f87ffe1e1e73c7e1ce403c39cf8403e7e3ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffeff3ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffcff3ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffff8fe7ffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f3fffffffffffffffffffffffffffffff3fffff07fffff3fffffffe0fe7
-ffe7ffffcfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f3ffffbfdffffffff07ffffffffffffff3fffffe7fffff3ffffffffcfe7
-ffe7ffffcfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f3ffff3f9fffffffe73ffffffffffffffffffffe7fffff3ffffffffcfff
-ffe7ffffcfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f279cc06038791ffe73ff2de0e73ffc183cb727e7ce7ff27e1fff87cf07
-f0e73c3e0fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f139cf3f9f3388ffff3ff00ce673ff9cf3c0313e7ce7ff13ccfff33cfe7
-e667799ccfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f399cf3f9e799cffff3ff24fe67bff9ff3c9339e7cf7ff399cffe73cfe7
-ce66f399cfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f399cf3f9e799cfff8fff24fe733ff8ff3c9339e7e67ff399cffe7fcfe7
-cfe5f399cfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f399cf3f9e799cffff3ff24e0737ffc1f3c9339e7e6fff3980ffe7fcfe7
-cfe1f019cfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f399cf3f9e799cffff3ff24ce737fff8f3c9339e7e6fff399fffe7fcfe7
-cfe4f3f9cfffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f399cf3f9e799cffff3ff24ce78ffffcf3c9339e7f1fff399fffe7fcfe7
-cfe673f9cf1fffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f3388f3f9f339cffe73ff24cc78fff9cf3c9333e7f1fff33ccfff33cfe7
-e667399c8f1fffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f07c4f87c3879cfff07ff24e27cfffc1804930700f9fff07e1fff860100
-f0e73c3e4f1fffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffffffffffffffdffffffffff3ffffbffffffffffffffff
-ffffffffff9fffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffffffffffffffffff9ffffffffff3ffff3ffffffffffffffff
-ffffffffff9fffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffffffffffffff1ffffffffff3fffe3ffffffffffffffff
-ffffffffff3fffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fff9fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fff9fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fff9fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f3991f0e33c39cc9f0f23ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f3d88e6703999cc4e6711ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f259cce733399cce4f339ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f259cce73f399cce4f339ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f259cc073f019cce4f339ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f939ccff3f3f9cce4f339ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f939ccff3f3f9cce4f339ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889f939ce673f9988cce6739ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221f939cf0e0fc3c4c1f0f39ffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffcffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221ffffffffffffffcffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889ffffffffffffffcffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e221fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e889fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0e001fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffe1
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-0001
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffff
-showpage
-%ps_include: inclusion end
-grestore
-PS-include-dict-dw begin
-o 0 ne {gsave A defaultmatrix /A ed llx lly nice urx ury nice
- initgraphics 0.1 setlinewidth boxpath stroke grestore} if
-clear o-stack aload pop
-context end restore
-%ps_include: end
-/saveobj save def
-mark
-8 I f
-(Figure 1. A typical)3 623 1 720 3580 t
-8 CW f
-(sam)1370 3580 w
-8 I f
-( The)1 167(screen, with the editing menu presented.)5 1320 2 1541 3580 t
-8 CW f
-(sam)3055 3580 w
-8 I f
-(\(command language\) window is in the middle, with file)8 1814 1 3226 3580 t
-( partially obscured window is a)5 1029( The)1 164( user interface makes it easy to create these abutting windows.\))10 2059( \(The)1 191(windows above and below.)3 877 5 720 3680 t
-( Each)1 206( typing and mouse operations apply, as indicated by its heavy border.)11 2242( uppermost window is that to which)6 1143( The)1 161(third file window.)2 568 5 720 3780 t
-( The)1 162(window has its current text highlighted in reverse video.)8 1810 2 720 3880 t
-8 CW f
-(sam)2714 3880 w
-8 I f
-( string on the last visible line, indi-)7 1121(window's current text is the null)5 1039 2 2880 3880 t
-( also Figure 2.)3 470( See)1 150(cated by a vertical bar.)4 740 3 720 3980 t
-10 R f
-( and leave dot set to the text resulting from the change.)11 2202(most commands make some change to the text in dot)9 2118 2 720 4220 t
-(For example, the delete command,)4 1389 1 720 4340 t
-10 CW f
-(d)2135 4340 w
-10 R f
-(, deletes the text in dot, replacing it by the null string and setting dot to)15 2845 1 2195 4340 t
-( change command,)2 767( The)1 213(the result.)1 402 3 720 4460 t
-10 CW f
-(c)2135 4460 w
-10 R f
-(, replaces dot by text delimited by an arbitrary punctuation character,)10 2845 1 2195 4460 t
-( Thus,)1 275(conventionally a slash.)2 913 2 720 4580 t
-9 CW f
-(c/Peter/)1008 4750 w
-10 R f
-(replaces the text in dot by the string)7 1429 1 720 4930 t
-10 CW f
-(Peter)2174 4930 w
-10 R f
-(. Similarly,)1 473 1 2474 4930 t
-9 CW f
-(a/Peter/)1008 5100 w
-10 R f
-(\(append\) adds the string after dot, and)6 1516 1 720 5280 t
-9 CW f
-(i/Peter/)1008 5450 w
-10 R f
-( three leave dot set to the new text,)8 1389( All)1 178(\(insert\) inserts before dot.)3 1031 3 720 5630 t
-10 CW f
-(Peter)3343 5630 w
-10 R f
-(.)3643 5630 w
-( lexically terminates a command.)4 1335(Newlines are part of the syntax of commands: the newline character)10 2735 2 970 5786 t
-( it is often convenient to insert)6 1282( since)1 242( But)1 207(Within the inserted text, however, newlines are never implicit.)8 2589 4 720 5906 t
-(multiple lines of text,)3 856 1 720 6026 t
-10 CW f
-(sam)1601 6026 w
-10 R f
-(has a special syntax for that case:)6 1330 1 1806 6026 t
-9 CW f
-(a)1008 6196 w
-(some lines of text)3 972 1 1008 6306 t
-(to be inserted in the file,)5 1458 1 1008 6416 t
-(terminated by a period)3 1188 1 1008 6526 t
-(on a line by itself)4 1026 1 1008 6636 t
-(.)1008 6746 w
-10 R f
-(In the one-line syntax, a newline character may be specified by a C-like escape, so)14 3291 1 720 6926 t
-9 CW f
-(c/\\n/)1008 7096 w
-10 R f
-(replaces dot by a single newline character.)6 1692 1 720 7276 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 3 3
-%%Page: 4 4
-/saveobj save def
-mark
-4 pagesetup
-10 R f
-(- 4 -)2 166 1 2797 480 t
-10 CW f
-(Sam)970 840 w
-10 R f
-(also has a substitute command,)4 1241 1 1175 840 t
-10 CW f
-(s)2441 840 w
-10 R f
-(:)2501 840 w
-9 CW f
-(s/)1008 1010 w
-9 I f
-(expression)1116 1010 w
-9 CW f
-(/)1501 1010 w
-9 I f
-(replacement)1555 1010 w
-9 CW f
-(/)2000 1010 w
-10 R f
-( if dot is the)4 530( Thus,)1 288( expression.)1 490(substitutes the replacement text for the first match, in dot, of the regular)12 3012 4 720 1190 t
-(string)720 1310 w
-10 CW f
-(Peter)973 1310 w
-10 R f
-(, the command)2 591 1 1273 1310 t
-9 CW f
-(s/t/st/)1008 1480 w
-10 R f
-(changes it to)2 517 1 720 1660 t
-10 CW f
-(Pester)1268 1660 w
-10 R f
-( general,)1 349(. In)1 164 2 1628 1660 t
-10 CW f
-(s)2172 1660 w
-10 R f
-(is unnecessary, but it was inherited from)6 1653 1 2263 1660 t
-10 CW f
-(ed)3947 1660 w
-10 R f
-( has some conve-)3 711(and it)1 231 2 4098 1660 t
-( instance, the replacement text may include the matched text, specified by)11 2947( For)1 189(nient variations.)1 644 3 720 1780 t
-10 CW f
-(&)4525 1780 w
-10 R f
-(:)4585 1780 w
-9 CW f
-(s/Peter/Oh, &, &, &, &!/)4 1296 1 1008 1950 t
-10 R f
-(There are also three commands that apply programs to text:)9 2376 1 970 2166 t
-9 CW f
-(<)1008 2336 w
-9 I f
-(Unix program)1 513 1 1116 2336 t
-10 R f
-( the)1 149( Similarly,)1 450(replaces dot by the output of the Unix program.)8 1908 3 720 2516 t
-10 CW f
-(>)3254 2516 w
-10 R f
-(command runs the program with dot as its)7 1699 1 3341 2516 t
-(standard input, and)2 763 1 720 2636 t
-10 CW f
-(|)1508 2636 w
-10 R f
-( example,)1 388( For)1 189(does both.)1 411 3 1593 2636 t
-9 CW f
-(| sort)1 324 1 1008 2806 t
-10 R f
-( special sig-)2 483( newlines have no)3 724( Again,)1 321(replaces dot by the result of applying the standard sorting utility to it.)12 2792 4 720 2986 t
-( these)1 235(nificance for)1 512 2 720 3106 t
-10 CW f
-(sam)1497 3106 w
-10 R f
-( text acted upon and resulting from these commands is not neces-)11 2665(commands. The)1 668 2 1707 3106 t
-(sarily bounded by newlines, although for connection with Unix programs, newlines may be necessary to)14 4320 1 720 3226 t
-(obey conventions.)1 727 1 720 3346 t
-(One more command:)2 843 1 970 3502 t
-10 CW f
-(p)1838 3502 w
-10 R f
-( I summarizes)2 560( Table)1 277(prints the contents of dot.)4 1019 3 1923 3502 t
-10 CW f
-(sam)3804 3502 w
-10 R f
-('s commands.)1 555 1 3984 3502 t
-(The value of dot may be changed by specifying an)9 2015 1 970 3658 t
-10 I f
-(address)3010 3658 w
-10 R f
-( simplest address is)3 778( The)1 206(for the command.)2 709 3 3347 3658 t
-(a line number:)2 577 1 720 3778 t
-9 CW f
-(3)1008 3948 w
-10 R f
-(refers to the third line of the file, so)8 1417 1 720 4128 t
-9 CW f
-(3d)1008 4298 w
-10 R f
-( 3.)1 111(deletes the third line of the file, and implicitly renumbers the lines so the old line 4 is now numbered)19 4209 2 720 4478 t
-(\(This is one of the few places where)7 1485 1 720 4598 t
-10 CW f
-(sam)2236 4598 w
-10 R f
-( Line)1 239(deals with lines directly.\))3 1028 2 2447 4598 t
-10 CW f
-(0)3745 4598 w
-10 R f
-( string at the begin-)4 797(is the null)2 407 2 3836 4598 t
-( a command consists of only an address, a)8 1846( If)1 137(ning of the file.)3 679 3 720 4718 t
-10 CW f
-(p)3429 4718 w
-10 R f
-(command is assumed, so typing an)5 1504 1 3536 4718 t
-(unadorned)720 4838 w
-10 CW f
-(3)1173 4838 w
-10 R f
-( are a couple of other basic addresses: a period addresses)10 2325( There)1 288(prints line 3 on the terminal.)5 1163 3 1264 4838 t
-(dot itself; and a dollar sign \()6 1127 1 720 4958 t
-10 CW f
-($)1847 4958 w
-10 R f
-(\) addresses the null string at the end of the file.)10 1872 1 1907 4958 t
-( the address)2 477( Thus,)1 278( single substring of the file.)5 1109(An address is always a)4 917 4 970 5114 t
-10 CW f
-(3)3779 5114 w
-10 R f
-(addresses the characters after)3 1173 1 3867 5114 t
-( A)1 125( file.)1 186(the second newline of the file through the third newline of the)11 2515 3 720 5234 t
-10 I f
-(compound address)1 755 1 3574 5234 t
-10 R f
-(is constructed by)2 683 1 4357 5234 t
-(the comma operator)2 798 1 720 5354 t
-9 I f
-(address1)1008 5524 w
-9 CW f
-(,)1333 5524 w
-9 I f
-(address2)1387 5524 w
-10 R f
-( the substring of the file from the beginning of)9 1860(and addresses)1 551 2 720 5704 t
-10 I f
-(address1)3157 5704 w
-10 R f
-(to the end of)3 505 1 3544 5704 t
-10 I f
-(address2)4075 5704 w
-10 R f
-( example,)1 389(. For)1 215 2 4436 5704 t
-(the command)1 543 1 720 5824 t
-10 CW f
-(3,5p)1290 5824 w
-10 R f
-(prints the third through fifth lines of the file and)9 1936 1 1557 5824 t
-10 CW f
-(.,$d)3520 5824 w
-10 R f
-( the begin-)2 429(deletes the text from)3 824 2 3787 5824 t
-(ning of dot to the end of the file.)8 1296 1 720 5944 t
-(These addresses are all absolute positions in the file, but)9 2247 1 970 6100 t
-10 CW f
-(sam)3242 6100 w
-10 R f
-( indicated by)2 518(also has relative addresses,)3 1075 2 3447 6100 t
-10 CW f
-(+)720 6220 w
-10 R f
-(or)805 6220 w
-10 CW f
-(-)913 6220 w
-10 R f
-( example,)1 388(. For)1 214 2 973 6220 t
-9 CW f
-($-3)1008 6390 w
-10 R f
-(is the third line before the end of the file and)10 1780 1 720 6570 t
-9 CW f
-(.+1)1008 6740 w
-10 R f
-( no address appears to the left of the)8 1457( If)1 118(is the line after dot.)4 782 3 720 6920 t
-10 CW f
-(+)3104 6920 w
-10 R f
-(or)3191 6920 w
-10 CW f
-(-)3301 6920 w
-10 R f
-(, dot is assumed; if nothing appears to the)8 1679 1 3361 6920 t
-(right,)720 7040 w
-10 CW f
-(1)959 7040 w
-10 R f
-( Therefore,)1 467(is assumed.)1 461 2 1044 7040 t
-10 CW f
-(.+1)1997 7040 w
-10 R f
-(may be abbreviated to just a plus sign.)7 1532 1 2202 7040 t
-(The)970 7196 w
-10 CW f
-(+)1156 7196 w
-10 R f
-(operator acts relative to the end of its first argument, while the)11 2556 1 1247 7196 t
-10 CW f
-(-)3834 7196 w
-10 R f
-(operator acts relative to the)4 1114 1 3926 7196 t
-(beginning. Thus)1 679 1 720 7316 t
-10 CW f
-(.+1)1428 7316 w
-10 R f
-( first line after dot,)4 758(addresses the)1 533 2 1637 7316 t
-10 CW f
-(.-)2956 7316 w
-10 R f
-(addresses the first line before dot, and)6 1534 1 3104 7316 t
-10 CW f
-(+-)4666 7316 w
-10 R f
-(refers)4814 7316 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 4 4
-%%Page: 5 5
-/saveobj save def
-mark
-5 pagesetup
-10 R f
-(- 5 -)2 166 1 2797 480 t
-(Table I.)1 310 1 2393 900 t
-10 CW f
-(Sam)2728 900 w
-10 R f
-(commands)2933 900 w
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 968 t
-10 R f
-(Text commands)1 641 1 1077 1136 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 1204 t
-10 CW f
-(a/)1077 1372 w
-10 I f
-(text)1197 1372 w
-10 CW f
-(/)1341 1372 w
-10 R f
-(Append text after dot)3 851 1 2160 1372 t
-10 CW f
-(c/)1077 1492 w
-10 I f
-(text)1197 1492 w
-10 CW f
-(/)1341 1492 w
-10 R f
-(Change text in dot)3 736 1 2160 1492 t
-10 CW f
-(i/)1077 1612 w
-10 I f
-(text)1197 1612 w
-10 CW f
-(/)1341 1612 w
-10 R f
-(Insert text before dot)3 834 1 2160 1612 t
-10 CW f
-(d)1077 1732 w
-10 R f
-(Delete text in dot)3 691 1 2160 1732 t
-10 CW f
-(s/)1077 1852 w
-10 I f
-(regexp)1197 1852 w
-10 CW f
-(/)1468 1852 w
-10 I f
-(text)1528 1852 w
-10 CW f
-(/)1672 1852 w
-10 R f
-(Substitute text for match of regular expression in dot)8 2109 1 2160 1852 t
-10 CW f
-(m)1077 1972 w
-10 I f
-(address)1197 1972 w
-10 R f
-(Move text in dot after address)5 1195 1 2160 1972 t
-10 CW f
-(t)1077 2092 w
-10 I f
-(address)1197 2092 w
-10 R f
-(Copy text in dot after address)5 1179 1 2160 2092 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 2160 t
-10 R f
-(Display commands)1 769 1 1077 2328 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 2396 t
-10 CW f
-(p)1077 2540 w
-10 R f
-(Print contents of dot)3 814 1 2160 2540 t
-10 CW f
-(=)1077 2660 w
-10 R f
-(Print value \(line numbers and character numbers\) of dot)8 2234 1 2160 2660 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 2728 t
-10 R f
-(File commands)1 614 1 1077 2896 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 2964 t
-10 CW f
-(b)1077 3108 w
-10 I f
-(file-list)1197 3108 w
-10 R f
-(Set current file to first file in list that)8 1466 1 2160 3108 t
-10 CW f
-(sam)3651 3108 w
-10 R f
-(has in menu)2 483 1 3856 3108 t
-10 CW f
-(B)1077 3228 w
-10 I f
-(file-list)1197 3228 w
-10 R f
-(Same as)1 330 1 2160 3228 t
-10 CW f
-(b)2515 3228 w
-10 R f
-(, but load new files)4 763 1 2575 3228 t
-10 CW f
-(n)1077 3348 w
-10 R f
-(Print menu lines of all files)5 1086 1 2160 3348 t
-10 CW f
-(D)1077 3468 w
-10 I f
-(file-list)1197 3468 w
-10 R f
-(Delete named files from)3 967 1 2160 3468 t
-10 CW f
-(sam)3152 3468 w
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 3536 t
-10 R f
-(I/O commands)1 591 1 1077 3704 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 3772 t
-10 CW f
-(e)1077 3916 w
-10 I f
-(filename)1197 3916 w
-10 R f
-(Replace file with named disc file)5 1317 1 2160 3916 t
-10 CW f
-(r)1077 4036 w
-10 I f
-(filename)1197 4036 w
-10 R f
-(Replace dot by contents of named disc file)7 1700 1 2160 4036 t
-10 CW f
-(w)1077 4156 w
-10 I f
-(filename)1197 4156 w
-10 R f
-(Write file to named disc file)5 1123 1 2160 4156 t
-10 CW f
-(f)1077 4276 w
-10 I f
-(filename)1197 4276 w
-10 R f
-(Set file name and print new menu line)7 1523 1 2160 4276 t
-10 CW f
-(<)1077 4396 w
-10 I f
-(Unix-command)1197 4396 w
-10 R f
-(Replace dot by standard output of command)6 1770 1 2160 4396 t
-10 CW f
-(>)1077 4516 w
-10 I f
-(Unix-command)1197 4516 w
-10 R f
-(Send dot to standard input of command)6 1577 1 2160 4516 t
-10 CW f
-(|)1077 4636 w
-10 I f
-(Unix-command)1197 4636 w
-10 R f
-(Replace dot by result of command applied to dot)8 1948 1 2160 4636 t
-10 CW f
-(!)1077 4756 w
-10 I f
-(Unix-command)1197 4756 w
-10 R f
-(Run the command)2 733 1 2160 4756 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 4824 t
-10 R f
-(Loops and conditionals)2 933 1 1077 4992 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 5060 t
-10 CW f
-(x/)1077 5204 w
-10 I f
-(regexp)1197 5204 w
-10 CW f
-(/)1468 5204 w
-10 I f
-(command)1588 5204 w
-10 R f
-(For each match of regexp, set dot and run command)9 2079 1 2160 5204 t
-10 CW f
-(y/)1077 5324 w
-10 I f
-(regexp)1197 5324 w
-10 CW f
-(/)1468 5324 w
-10 I f
-(command)1588 5324 w
-10 R f
-(Between adjacent matches of regexp, set dot and run command)9 2522 1 2160 5324 t
-10 CW f
-(X/)1077 5444 w
-10 I f
-(regexp)1197 5444 w
-10 CW f
-(/)1468 5444 w
-10 I f
-(command)1588 5444 w
-10 R f
-(Run command in each file whose menu line matches regexp)9 2404 1 2160 5444 t
-10 CW f
-(Y/)1077 5564 w
-10 I f
-(regexp)1197 5564 w
-10 CW f
-(/)1468 5564 w
-10 I f
-(command)1588 5564 w
-10 R f
-(Run command in each file whose menu line does not match)10 2386 1 2160 5564 t
-10 CW f
-(g/)1077 5684 w
-10 I f
-(regexp)1197 5684 w
-10 CW f
-(/)1468 5684 w
-10 I f
-(command)1588 5684 w
-10 R f
-(If dot contains a match of regexp, run command)8 1921 1 2160 5684 t
-10 CW f
-(v/)1077 5804 w
-10 I f
-(regexp)1197 5804 w
-10 CW f
-(/)1468 5804 w
-10 I f
-(command)1588 5804 w
-10 R f
-(If dot does not contain a match of regexp, run command)10 2243 1 2160 5804 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 5872 t
-10 R f
-(Miscellany)1077 6040 w
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 6108 t
-10 CW f
-(k)1077 6252 w
-10 R f
-(Set address mark to value of dot)6 1287 1 2160 6252 t
-10 CW f
-(q)1077 6372 w
-10 R f
-(Quit)2160 6372 w
-10 CW f
-(u)1077 6492 w
-10 I f
-(n)1197 6492 w
-10 R f
-(Undo last)1 386 1 2160 6492 t
-10 I f
-(n)2571 6492 w
-10 R f
-(\(default 1\) changes)2 764 1 2646 6492 t
-10 CW f
-({ })1 180 1 1077 6612 t
-10 R f
-(Braces group commands)2 987 1 2160 6612 t
-10 S f
-(_ ________________________________________________________________________)1 3605 1 1077 6668 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 5 5
-%%Page: 6 6
-/saveobj save def
-mark
-6 pagesetup
-10 R f
-(- 6 -)2 166 1 2797 480 t
-( multiple lines, and)3 788( may span)2 417( \(Dot)1 239(to the line containing the end of dot.)7 1491 4 720 840 t
-10 CW f
-(+)3687 840 w
-10 R f
-(selects the line after the end of)6 1261 1 3779 840 t
-(dot, then)1 350 1 720 960 t
-10 CW f
-(-)1095 960 w
-10 R f
-(backs up one line.\))3 754 1 1180 960 t
-( addresses the text matched by the expression.)7 1855(The final type of address is a regular expression, which)9 2215 2 970 1116 t
-(The expression is enclosed in slashes, as in)7 1720 1 720 1236 t
-9 CW f
-(/)1008 1406 w
-9 I f
-(expression)1062 1406 w
-9 CW f
-(/)1447 1406 w
-10 R f
-( the same as those in the Unix program)8 1647(The expressions are)2 812 2 720 1586 t
-10 CW f
-(egrep)3215 1586 w
-10 R f
-(,)3515 1586 w
-6 R f
-(6,7)3540 1536 w
-10 R f
-(and include closures, alternations,)3 1389 1 3651 1586 t
-( find the)2 335( They)1 256(and so on.)2 410 3 720 1706 t
-10 I f
-(leftmost longest)1 632 1 1747 1706 t
-10 R f
-( match after the)3 623(string that matches the expression, that is, the first)8 2012 2 2405 1706 t
-( the search is started, and if more than one match begins at the same spot, the longest such)18 3834(point where)1 486 2 720 1826 t
-( assume familiarity with the syntax for regular expressions in Unix programs.)11 3096(match. \(I)1 385 2 720 1946 t
-6 R f
-(9)4201 1896 w
-10 R f
-(\) For example,)2 585 1 4231 1946 t
-9 CW f
-(/x/)1008 2116 w
-10 R f
-(matches the next)2 671 1 720 2296 t
-10 CW f
-(x)1416 2296 w
-10 R f
-(character in the file,)3 797 1 1501 2296 t
-9 CW f
-(/xx*/)1008 2466 w
-10 R f
-(matches the next run of one or more)7 1444 1 720 2646 t
-10 CW f
-(x)2189 2646 w
-10 R f
-('s, and)1 266 1 2249 2646 t
-9 CW f
-(/x|Peter/)1008 2816 w
-10 R f
-(matches the next)2 677 1 720 2996 t
-10 CW f
-(x)1425 2996 w
-10 R f
-(or)1513 2996 w
-10 CW f
-(Peter)1624 2996 w
-10 R f
-( character' operator, a)3 885( compatibility with other Unix programs, the `any)7 2014(. For)1 217 3 1924 2996 t
-(period, does not match a newline, so)6 1459 1 720 3116 t
-9 CW f
-(/.*/)1008 3286 w
-10 R f
-( from dot to the end of the line, but excludes the newline and so will not match across the)19 3663(matches the text)2 657 2 720 3466 t
-(line boundary.)1 577 1 720 3586 t
-( is forwards by default, so)5 1222( direction)1 416( The)1 241(Regular expressions are always relative addresses.)5 2191 4 970 3742 t
-10 CW f
-(/Peter/)720 3862 w
-10 R f
-(is really an abbreviation for)4 1103 1 1165 3862 t
-10 CW f
-(+/Peter/)2293 3862 w
-10 R f
-( search can be reversed with a minus sign, so)9 1796(. The)1 230 2 2773 3862 t
-9 CW f
-(-/Peter/)1008 4032 w
-10 R f
-(finds the first)2 595 1 720 4212 t
-10 CW f
-(Peter)1371 4212 w
-10 R f
-( with other address forms, so)5 1314( expressions may be used)4 1139( Regular)1 397(before dot.)1 463 4 1727 4212 t
-10 CW f
-(0+/Peter/)720 4332 w
-10 R f
-(finds the first)2 539 1 1288 4332 t
-10 CW f
-(Peter)1855 4332 w
-10 R f
-(in the file and)3 561 1 2183 4332 t
-10 CW f
-($-/Peter/)2772 4332 w
-10 R f
-( II summarizes)2 599( Table)1 280(finds the last.)2 542 3 3340 4332 t
-10 CW f
-(sam)4788 4332 w
-10 R f
-('s)4968 4332 w
-(addresses.)720 4452 w
-( who use Unix text editors such as)7 1389(The language discussed so far will not seem novel to people)10 2422 2 970 4608 t
-10 CW f
-(ed)4809 4608 w
-10 R f
-(or)4957 4608 w
-10 CW f
-(vi)720 4728 w
-10 R f
-(.)840 4728 w
-6 R f
-(9)865 4678 w
-10 R f
-( operations these commands allow, with the exception of regular expres-)10 2897(Moreover, the kinds of editing)4 1222 2 921 4728 t
-( Indeed,)1 351( a mouse-based interface.)3 1028(sions and line numbers, are clearly more conveniently handled by)9 2659 3 720 4848 t
-10 CW f
-(sam)4788 4848 w
-10 R f
-('s)4968 4848 w
-( For)1 194( usually made.)2 590(mouse language \(discussed at length below\) is the means by which simple changes are)13 3536 3 720 4968 t
-(large or repetitive changes, however, a textual language outperforms a manual interface.)11 3523 1 720 5088 t
-(Imagine that, instead of deleting just one occurrence of the string)10 2708 1 970 5244 t
-10 CW f
-(Peter)3714 5244 w
-10 R f
-( wanted to eliminate)3 849(, we)1 177 2 4014 5244 t
-(every)720 5364 w
-10 CW f
-(Peter)970 5364 w
-10 R f
-( some text.)2 442( needed is an iterator that runs a command for each occurrence of)12 2656(. What's)1 367 3 1270 5364 t
-10 CW f
-(Sam)4788 5364 w
-10 R f
-('s)4968 5364 w
-(iterator is called)2 643 1 720 5484 t
-10 CW f
-(x)1388 5484 w
-10 R f
-(, for extract:)2 490 1 1448 5484 t
-9 CW f
-(x/)1008 5654 w
-9 I f
-(expression)1116 5654 w
-9 CW f
-(/)1501 5654 w
-9 I f
-(command)1609 5654 w
-10 R f
-( text matched)2 554(finds all matches in dot of the specified expression, and for each such match, sets dot to the)17 3766 2 720 5834 t
-( to delete all the)4 638( So)1 156(and runs the command.)3 932 3 720 5954 t
-10 CW f
-(Peters:)2471 5954 w
-9 CW f
-(0,$ x/Peter/ d)2 756 1 1008 6124 t
-10 R f
-( are to improve readability;)4 1163(\(Blanks in these examples)3 1100 2 720 6304 t
-10 CW f
-(sam)3027 6304 w
-10 R f
-( This)1 247(neither requires nor interprets them.\))4 1542 2 3251 6304 t
-(searches the entire file \()4 964 1 720 6424 t
-10 CW f
-(0,$)1684 6424 w
-10 R f
-( of the string)3 514(\) for occurrences)2 680 2 1864 6424 t
-10 CW f
-(Peter)3085 6424 w
-10 R f
-(, and runs the)3 544 1 3385 6424 t
-10 CW f
-(d)3956 6424 w
-10 R f
-(command with dot set to)4 997 1 4043 6424 t
-( contrast, the comparable)3 1003( \(By)1 200(each such occurrence.)2 876 3 720 6544 t
-10 CW f
-(ed)2824 6544 w
-10 R f
-(command would delete all)3 1057 1 2969 6544 t
-10 I f
-(lines)4051 6544 w
-10 R f
-(containing)4265 6544 w
-10 CW f
-(Peter)4712 6544 w
-10 R f
-(;)5012 6544 w
-10 CW f
-(sam)720 6664 w
-10 R f
-(deletes only the)2 653 1 938 6664 t
-10 CW f
-(Peters)1629 6664 w
-10 R f
-( address)1 337(.\) The)1 276 2 1989 6664 t
-10 CW f
-(0,$)2640 6664 w
-10 R f
-( be abbreviated to just a)5 1011(is commonly used, and may)4 1171 2 2858 6664 t
-( another example,)2 712(comma. As)1 480 2 720 6784 t
-9 CW f
-(, x/Peter/ p)2 648 1 1008 6954 t
-10 R f
-(prints a list of)3 556 1 720 7134 t
-10 CW f
-(Peters,)1303 7134 w
-10 R f
-(one for each appearance in the file, with no intervening text \(not even newlines to)14 3290 1 1750 7134 t
-(separate the instances\).)2 922 1 720 7254 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 6 6
-%%Page: 7 7
-/saveobj save def
-mark
-7 pagesetup
-10 R f
-(- 7 -)2 166 1 2797 480 t
-(Table II.)1 343 1 2402 900 t
-10 CW f
-(Sam)2770 900 w
-10 R f
-(addresses)2975 900 w
-10 S f
-(_ _________________________________________________________________)1 3264 1 1248 968 t
-10 R f
-(Simple addresses)1 691 1 1248 1136 t
-10 S f
-(_ _________________________________________________________________)1 3264 1 1248 1204 t
-10 CW f
-(#)1248 1348 w
-10 I f
-(n)1308 1348 w
-10 R f
-(The empty string after character)4 1279 1 2250 1348 t
-10 I f
-(n)3554 1348 w
-(n)1248 1468 w
-10 R f
-(Line)2250 1468 w
-10 I f
-(n)2458 1468 w
-10 R f
-(.)2508 1468 w
-10 CW f
-(/)1248 1588 w
-10 I f
-(regexp)1308 1588 w
-10 CW f
-(/)1579 1588 w
-10 R f
-(The first following match of the regular expression)7 2038 1 2250 1588 t
-10 CW f
-(-/)1248 1708 w
-10 I f
-(regexp)1368 1708 w
-10 CW f
-(/)1639 1708 w
-10 R f
-(The first previous match of the regular expression)7 1993 1 2250 1708 t
-10 CW f
-($)1248 1828 w
-10 R f
-(The null string at the end of the file)8 1415 1 2250 1828 t
-10 CW f
-(.)1248 1948 w
-10 R f
-(Dot)2250 1948 w
-10 CW f
-(')1248 2068 w
-10 R f
-(The address mark, set by)4 995 1 2250 2068 t
-10 CW f
-(k)3270 2068 w
-10 R f
-(command)3355 2068 w
-10 CW f
-(")1248 2188 w
-10 I f
-(regexp)1308 2188 w
-10 CW f
-(")1579 2188 w
-10 R f
-(Dot in the file whose menu line matches regexp)8 1908 1 2250 2188 t
-10 S f
-(_ _________________________________________________________________)1 3264 1 1248 2256 t
-10 R f
-(Compound addresses)1 852 1 1248 2424 t
-10 S f
-(_ _________________________________________________________________)1 3264 1 1248 2492 t
-10 I f
-(a1)1248 2636 w
-10 CW f
-(+)1348 2636 w
-10 I f
-(a2)1408 2636 w
-10 R f
-(The address)1 479 1 2250 2636 t
-10 I f
-(a2)2754 2636 w
-10 R f
-(evaluated starting at right of)4 1126 1 2879 2636 t
-10 I f
-(a1)4030 2636 w
-(a1)1248 2756 w
-10 CW f
-(-)1348 2756 w
-10 I f
-(a2 a2)1 942 1 1408 2756 t
-10 R f
-(evaluated in the reverse direction starting at left of)8 2012 1 2375 2756 t
-10 I f
-(a1)4412 2756 w
-(a1)1248 2876 w
-10 CW f
-(,)1348 2876 w
-10 I f
-(a2)1408 2876 w
-10 R f
-(From the left of)3 630 1 2250 2876 t
-10 I f
-(a1)2905 2876 w
-10 R f
-(to the right of)3 547 1 3030 2876 t
-10 I f
-(a2)3602 2876 w
-10 R f
-(\(default)3727 2876 w
-10 CW f
-(0,$)4062 2876 w
-10 R f
-(\))4242 2876 w
-10 I f
-(a1)1248 2996 w
-10 CW f
-(;)1348 2996 w
-10 I f
-(a2)1408 2996 w
-10 R f
-(Like)2250 2996 w
-10 CW f
-(,)2458 2996 w
-10 R f
-(but sets dot after evaluating)4 1104 1 2543 2996 t
-10 I f
-(a1)3672 2996 w
-10 S f
-(_ _________________________________________________________________)1 3264 1 1248 3064 t
-10 R f
-(The operators)1 569 1 1440 3232 t
-10 CW f
-(+)2052 3232 w
-10 R f
-(and)2155 3232 w
-10 CW f
-(-)2342 3232 w
-10 R f
-(are high precedence, while)3 1122 1 2445 3232 t
-10 CW f
-(,)3610 3232 w
-10 R f
-(and)3713 3232 w
-10 CW f
-(;)3901 3232 w
-10 R f
-(are low)1 315 1 4005 3232 t
-( both)1 208(precedence. In)1 610 2 1440 3352 t
-10 CW f
-(+)2288 3352 w
-10 R f
-(and)2378 3352 w
-10 CW f
-(-)2552 3352 w
-10 R f
-(forms,)2642 3352 w
-10 I f
-(a2)2930 3352 w
-10 R f
-(defaults to 1 and)3 678 1 3060 3352 t
-10 I f
-(a1)3768 3352 w
-10 R f
-(defaults to)1 423 1 3897 3352 t
-( both)1 203(dot. If)1 269 2 1440 3472 t
-10 I f
-(a1)1937 3472 w
-10 R f
-(and)2062 3472 w
-10 I f
-(a2)2231 3472 w
-10 R f
-(are present,)1 459 1 2356 3472 t
-10 CW f
-(+)2840 3472 w
-10 R f
-(may be elided.)2 585 1 2925 3472 t
-10 S f
-(_ _________________________________________________________________)1 3264 1 1248 3552 t
-10 R f
-(Of course, the text extracted by)5 1267 1 970 3852 t
-10 CW f
-(x)2265 3852 w
-10 R f
-(may be selected by a regular expression, which complicates decid-)9 2687 1 2353 3852 t
-( is resolved by generating the matches)6 1597( This)1 240( matches is chosen \320 matches may overlap.)7 1853(ing what set of)3 630 4 720 3972 t
-( starting)1 338(starting from the beginning of dot using the leftmost-longest rule, and searching for each match)14 3982 2 720 4092 t
-( adja-)1 228( expressions may also match null strings, but a null match)10 2363( Regular)1 371(from the end of the previous one.)6 1358 4 720 4212 t
-( example,)1 388( For)1 189(cent to a non-null match is never selected; at least one character must intervene.)13 3187 3 720 4332 t
-9 CW f
-(, c/AAA/)1 432 1 1008 4502 t
-(x/B*/ c/-/)1 540 1 1008 4612 t
-(, p)1 162 1 1008 4722 t
-10 R f
-(produces as output)2 749 1 720 4902 t
-9 CW f
-(-A-A-A-)1008 5072 w
-10 R f
-(because the pattern)2 764 1 720 5252 t
-10 CW f
-(B*)1509 5252 w
-10 R f
-(matches the null strings separating the)5 1529 1 1654 5252 t
-10 CW f
-(A)3208 5252 w
-10 R f
-('s.)3268 5252 w
-(The)970 5408 w
-10 CW f
-(x)1150 5408 w
-10 R f
-(command has a complement,)3 1165 1 1235 5408 t
-10 CW f
-(y)2425 5408 w
-10 R f
-( syntax, that executes the command with dot set to)9 2024(, with similar)2 531 2 2485 5408 t
-(the text)1 297 1 720 5528 t
-10 I f
-(between)1042 5528 w
-10 R f
-( example,)1 388( For)1 189(the matches of the expression.)4 1206 3 1394 5528 t
-9 CW f
-(, c/AAA/)1 432 1 1008 5698 t
-(y/A/ c/-/)1 486 1 1008 5808 t
-(, p)1 162 1 1008 5918 t
-10 R f
-(produces the same result as the example above.)7 1890 1 720 6098 t
-(The)970 6254 w
-10 CW f
-(x)1158 6254 w
-10 R f
-(and)1251 6254 w
-10 CW f
-(y)1428 6254 w
-10 R f
-(commands are looping constructs, and)4 1566 1 1521 6254 t
-10 CW f
-(sam)3120 6254 w
-10 R f
-(has a pair of conditional commands to go)7 1707 1 3333 6254 t
-( have similar syntax:)3 830( They)1 255(with them.)1 428 3 720 6374 t
-9 CW f
-(g/)1008 6544 w
-9 I f
-(expression)1116 6544 w
-9 CW f
-(/)1501 6544 w
-9 I f
-(command)1609 6544 w
-10 R f
-( is different from)3 688( This)1 231(\(guard\) runs the command exactly once if dot contains a match of the expression.)13 3288 3 720 6724 t
-10 CW f
-(x)4955 6724 w
-10 R f
-(,)5015 6724 w
-(which runs the command for)4 1148 1 720 6844 t
-10 I f
-(each)1893 6844 w
-10 R f
-(match:)2106 6844 w
-10 CW f
-(x)2403 6844 w
-10 R f
-(loops;)2488 6844 w
-10 CW f
-(g)2758 6844 w
-10 R f
-( Thus,)1 275(merely tests, without changing the value of dot.)7 1901 2 2843 6844 t
-9 CW f
-(, x/Peter/ d)2 648 1 1008 7014 t
-10 R f
-(deletes all occurrences of)3 1010 1 720 7194 t
-10 CW f
-(Peter)1755 7194 w
-10 R f
-(, but)1 178 1 2055 7194 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 7 7
-%%Page: 8 8
-/saveobj save def
-mark
-8 pagesetup
-10 R f
-(- 8 -)2 166 1 2797 480 t
-9 CW f
-(, g/Peter/ d)2 648 1 1008 830 t
-10 R f
-( string\) if)2 384(deletes the whole file \(reduces it to a null)8 1687 2 720 1010 t
-10 CW f
-(Peter)2822 1010 w
-10 R f
-( complemen-)1 530( The)1 211(occurs anywhere in the text.)4 1146 3 3153 1010 t
-(tary conditional is)2 722 1 720 1130 t
-10 CW f
-(v)1467 1130 w
-10 R f
-(, which runs the command if there is)7 1459 1 1527 1130 t
-10 I f
-(no)3011 1130 w
-10 R f
-(match of the expression.)3 976 1 3136 1130 t
-( For)1 190(These control-structure-like commands may be composed to construct more involved operations.)10 3880 2 970 1286 t
-(example, to print those lines of text that contain the string)10 2307 1 720 1406 t
-10 CW f
-(Peter)3052 1406 w
-10 R f
-(:)3352 1406 w
-9 CW f
-(, x/.*\\n/ g/Peter/ p)3 1080 1 1008 1576 t
-10 R f
-(The)720 1756 w
-10 CW f
-(x)908 1756 w
-10 R f
-( file into lines, the)4 761(breaks the)1 415 2 1001 1756 t
-10 CW f
-(g)2211 1756 w
-10 R f
-(selects those lines containing)3 1190 1 2305 1756 t
-10 CW f
-(Peter)3529 1756 w
-10 R f
-(, and the)2 359 1 3829 1756 t
-10 CW f
-(p)4222 1756 w
-10 R f
-( This)1 237(prints them.)1 487 2 4316 1756 t
-(command gives an address for the)5 1416 1 720 1876 t
-10 CW f
-(x)2172 1876 w
-10 R f
-(command \(the whole file\), but because)5 1607 1 2268 1876 t
-10 CW f
-(g)3911 1876 w
-10 R f
-(does not have an explicit)4 1033 1 4007 1876 t
-( the value of dot produced by the)7 1359(address, it applies to)3 831 2 720 1996 t
-10 CW f
-(x)2941 1996 w
-10 R f
-( commands in)2 573( All)1 184(command, that is, to each line.)5 1251 3 3032 1996 t
-10 CW f
-(sam)720 2116 w
-10 R f
-(except for the command to write a file to disc use dot for the default address.)15 3066 1 925 2116 t
-(Composition may be continued indefinitely.)4 1764 1 970 2272 t
-9 CW f
-(, x/.*\\n/ g/Peter/ v/SaltPeter/ p)4 1782 1 1008 2442 t
-10 R f
-(prints those lines containing)3 1125 1 720 2622 t
-10 CW f
-(Peter)1870 2622 w
-10 R f
-(but)2195 2622 w
-10 I f
-(not)2348 2622 w
-10 R f
-(those containing)1 658 1 2501 2622 t
-10 CW f
-(SaltPeter)3184 2622 w
-10 R f
-(.)3724 2622 w
-10 B f
-(Structural Regular Expressions)2 1350 1 720 2862 t
-10 R f
-( non-interactive ones such as)4 1177(Unlike other Unix text editors, including the)6 1804 2 720 3018 t
-10 CW f
-(sed)3732 3018 w
-10 R f
-(and)3943 3018 w
-10 CW f
-(awk)4118 3018 w
-10 R f
-(,)4298 3018 w
-6 R f
-(7)4323 2968 w
-10 CW f
-(sam)4384 3018 w
-10 R f
-(is good for)2 445 1 4595 3018 t
-( on-line phone book composed of records,)6 1737( example is an)3 604( An)1 182(manipulating files with multi-line `records.')4 1797 4 720 3138 t
-(separated by blank lines, of the form)6 1461 1 720 3258 t
-9 CW f
-(Herbert Tic)1 594 1 1008 3428 t
-(44 Turnip Ave., Endive, NJ)4 1404 1 1008 3538 t
-(201-5555642)1008 3648 w
-(Norbert Twinge)1 756 1 1008 3868 t
-(16 Potato St., Cabbagetown, NJ)4 1620 1 1008 3978 t
-(201-5553145)1008 4088 w
-(...)1008 4308 w
-10 R f
-(The format may be encoded as a regular expression:)8 2083 1 720 4488 t
-9 CW f
-(\(.+\\n\)+)1008 4658 w
-10 R f
-( command to print Mr. Tic's entire record is then)9 1958( The)1 205(that is, a sequence of one or more non-blank lines.)9 2010 3 720 4838 t
-9 CW f
-(, x/\(.+\\n\)+/ g/\303Herbert Tic$/ p)4 1674 1 1008 5008 t
-10 R f
-(and that to extract just the phone number is)8 1726 1 720 5188 t
-9 CW f
-(, x/\(.+\\n\)+/ g/\303Herbert Tic$/ x/\303[0-9]*-[0-9]*\\n/ p)5 2754 1 1008 5358 t
-10 R f
-( Tic's record, extracts the phone number from)7 1862(The latter command breaks the file into records, chooses Mr.)9 2458 2 720 5538 t
-(the record, and finally prints the number.)6 1636 1 720 5658 t
-(A more involved problem is that of renaming a particular variable, say)11 2927 1 970 5814 t
-10 CW f
-(n)3932 5814 w
-10 R f
-(, to)1 138 1 3992 5814 t
-10 CW f
-(num)4165 5814 w
-10 R f
-(in a C program.)3 660 1 4380 5814 t
-(The obvious first attempt,)3 1033 1 720 5934 t
-9 CW f
-(, x/n/ c/num/)2 702 1 1008 6104 t
-10 R f
-( flawed: it changes not only the variable)7 1628(is badly)1 317 2 720 6284 t
-10 CW f
-(n)2694 6284 w
-10 R f
-(but any letter)2 535 1 2783 6284 t
-10 CW f
-(n)3347 6284 w
-10 R f
-( need to extract all the)5 904( We)1 192(that appears.)1 508 3 3436 6284 t
-(variables, and select those that match)5 1486 1 720 6404 t
-10 CW f
-(n)2231 6404 w
-10 R f
-(and only)1 347 1 2316 6404 t
-10 CW f
-(n)2688 6404 w
-10 R f
-(:)2748 6404 w
-9 CW f
-(, x/[A-Za-z_][A-Za-z_0-9]*/ g/n/ v/../ c/num/)4 2430 1 1008 6574 t
-10 R f
-(The pattern)1 458 1 720 6754 t
-10 CW f
-([A-Za-z_][A-Za-z_0-9]*)1204 6754 w
-10 R f
-( Next)1 246(matches C identifiers.)2 876 2 2550 6754 t
-10 CW f
-(g/n/)3699 6754 w
-10 R f
-(selects those containing an)3 1074 1 3966 6754 t
-10 CW f
-(n)720 6874 w
-10 R f
-(. Then)1 303 1 780 6874 t
-10 CW f
-(v/../)1131 6874 w
-10 R f
-(rejects those containing two \(or more\) characters, and finally)8 2614 1 1479 6874 t
-10 CW f
-(c/num/)4141 6874 w
-10 R f
-(changes the)1 491 1 4549 6874 t
-(remainder \(identifiers)1 871 1 720 6994 t
-10 CW f
-(n)1620 6994 w
-10 R f
-(\) to)1 140 1 1680 6994 t
-10 CW f
-(num)1849 6994 w
-10 R f
-( version clearly works much better, but there may still be problems.)11 2754(. This)1 257 2 2029 6994 t
-(For example, in C character and string constants, the sequence)9 2510 1 720 7114 t
-10 CW f
-(\\n)3257 7114 w
-10 R f
-( and)1 170(is interpreted as a newline character,)5 1466 2 3404 7114 t
-(we don't want to change it to)6 1165 1 720 7234 t
-10 CW f
-(\\num.)1910 7234 w
-10 R f
-(This problem can be forestalled with a)6 1536 1 2235 7234 t
-10 CW f
-(y)3796 7234 w
-10 R f
-(command:)3881 7234 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 8 8
-%%Page: 9 9
-/saveobj save def
-mark
-9 pagesetup
-10 R f
-(- 9 -)2 166 1 2797 480 t
-9 CW f
-(, y/\\\\n/ x/[A-Za-z_][A-Za-z_0-9]*/ g/n/ v/../ c/num/)5 2808 1 1008 830 t
-10 R f
-(\(the second)1 464 1 720 1010 t
-10 CW f
-(\\)1216 1010 w
-10 R f
-( reject)1 254(is necessary because of lexical conventions in regular expressions\), or we could even)12 3478 2 1308 1010 t
-(character constants and strings outright:)4 1592 1 720 1130 t
-9 CW f
-(, y/'[\303']*'/ y/"[\303"]*"/ x/[A-Za-z_][A-Za-z_0-9]*/ g/n/ v/../ c/num/)6 3618 1 1008 1300 t
-10 R f
-(The)720 1480 w
-10 CW f
-(y)907 1480 w
-10 R f
-( only)1 211( The)1 213( strings.)1 325(commands in this version exclude from consideration all character constants and)10 3292 4 999 1480 t
-(remaining problem is to deal with the possible occurrence of)9 2439 1 720 1600 t
-10 CW f
-(\\')3186 1600 w
-10 R f
-(or)3332 1600 w
-10 CW f
-(\\")3441 1600 w
-10 R f
-(within these sequences, but it's easy)5 1453 1 3587 1600 t
-(to see how to resolve this difficulty.)6 1435 1 720 1720 t
-( of the command)3 683( simple version)2 615( A)1 124(The point of these composed commands is successive refinement.)8 2648 4 970 1876 t
-( can be undone;)3 644( \(Mistakes)1 449( it can be honed by adding a clause or two.)10 1755(is tried, and if it's not good enough,)7 1472 4 720 1996 t
-( result-)1 283( The)1 208( the mouse language makes it unnecessary to retype the command each time.\))12 3138( Also,)1 267(see below.)1 424 5 720 2116 t
-(ing chains of commands are somewhat reminiscent of shell pipelines.)9 2783 1 720 2236 t
-6 R f
-(7)3503 2186 w
-10 R f
-(Unlike pipelines, though, which pass)4 1481 1 3559 2236 t
-(along modified)1 612 1 720 2356 t
-10 I f
-(data)1361 2356 w
-10 R f
-(,)1539 2356 w
-10 CW f
-(sam)1593 2356 w
-10 R f
-(commands pass a)2 707 1 1802 2356 t
-10 I f
-(view)2538 2356 w
-10 R f
-( text at each step of the command is the)9 1623( The)1 210(of the data.)2 456 3 2751 2356 t
-( by step until the correct piece is available to the final)11 2237(same, but which pieces are selected is refined step)8 2083 2 720 2476 t
-(step of the command line, which ultimately makes the change.)9 2494 1 720 2596 t
-(In other Unix programs, regular expressions are used only for selection, as in the)13 3315 1 970 2752 t
-10 CW f
-(sam g)1 272 1 4317 2752 t
-10 R f
-(command,)4621 2752 w
-(never for extraction as in the)5 1159 1 720 2872 t
-10 CW f
-(x)1907 2872 w
-10 R f
-(or)1995 2872 w
-10 CW f
-(y)2106 2872 w
-10 R f
-( patterns in)2 448( example,)1 391(command. For)1 611 3 2194 2872 t
-10 CW f
-(awk)3671 2872 w
-6 R f
-(7)3851 2822 w
-10 R f
-(are used to select lines to be)6 1132 1 3908 2872 t
-( The)1 207( but cannot be used to describe the format of the input text, or to handle newline-free text.)17 3619(operated on,)1 494 3 720 2992 t
-( the structure of a piece of text rather than its contents, as in the)14 2671(use of regular expressions to describe)5 1554 2 720 3112 t
-10 CW f
-(x)4980 3112 w
-10 R f
-(command, has been given a name:)5 1455 1 720 3232 t
-10 I f
-(structural regular expressions.)2 1268 1 2216 3232 t
-10 R f
-(When they are composed, as in the)6 1490 1 3550 3232 t
-( use is discussed at greater length elsewhere.)7 1779( Their)1 266(above example, they are pleasantly expressive.)5 1870 3 720 3352 t
-6 R f
-(10)4635 3302 w
-10 B f
-(Multiple files)1 564 1 720 3628 t
-10 CW f
-(Sam)720 3784 w
-10 R f
-(has a few other commands, mostly relating to input and output.)10 2526 1 925 3784 t
-9 CW f
-(e discfilename)1 756 1 1008 3954 t
-10 R f
-(replaces the contents and name of the current file with those of the named disc file;)15 3318 1 720 4134 t
-9 CW f
-(w discfilename)1 756 1 1008 4304 t
-10 R f
-(writes the contents to the named disc file; and)8 1831 1 720 4484 t
-9 CW f
-(r discfilename)1 756 1 1008 4654 t
-10 R f
-( file's name if)3 590( these commands use the current)5 1350( All)1 188(replaces dot with the contents of the named disc file.)9 2192 4 720 4834 t
-( Finally,)1 359(none is specified.)2 696 2 720 4954 t
-9 CW f
-(f discfilename)1 756 1 1008 5124 t
-10 R f
-(changes the name associated with the file and displays the result:)10 2596 1 720 5304 t
-9 CW f
-('-. discfilename)1 864 1 1008 5474 t
-10 R f
-(This output is called the file's)5 1226 1 720 5654 t
-10 I f
-(menu line,)1 423 1 1978 5654 t
-10 R f
-( contents of the file's line in the button 3 menu)10 1951(because it is the)3 656 2 2433 5654 t
-( The)1 205( first three characters are a concise notation for the state of the file.)13 2677( The)1 206(\(described in the next section\).)4 1232 4 720 5774 t
-( sign indicates the number of windows open on the)9 2052( minus)1 271( The)1 206(apostrophe signifies that the file is modified.)6 1791 4 720 5894 t
-(file \(see the next section\):)4 1071 1 720 6014 t
-10 CW f
-(-)1826 6014 w
-10 R f
-(means none,)1 509 1 1921 6014 t
-10 CW f
-(+)2465 6014 w
-10 R f
-(means one, and)2 636 1 2560 6014 t
-10 CW f
-(*)3230 6014 w
-10 R f
-( the period)2 445( Finally,)1 368(means more than one.)3 903 3 3324 6014 t
-( are useful for controlling the)5 1192( characters)1 432( These)1 292(indicates that this is the current file.)6 1453 4 720 6134 t
-10 CW f
-(X)4119 6134 w
-10 R f
-(command, described)1 831 1 4209 6134 t
-(shortly.)720 6254 w
-10 CW f
-(Sam)970 6410 w
-10 R f
-( \(such as all the source for a program\) by invoking it with a)13 2384(may be started with a set of disc files)8 1481 2 1175 6410 t
-(list of file names as arguments, and more may be added or deleted on demand.)14 3133 1 720 6530 t
-9 CW f
-(B discfile1 discfile2 ...)3 1350 1 1008 6700 t
-10 R f
-(adds the named files to)4 921 1 720 6880 t
-10 CW f
-(sam)1666 6880 w
-10 R f
-('s list, and)2 414 1 1846 6880 t
-9 CW f
-(D discfile1 discfile2 ...)3 1350 1 1008 7050 t
-10 R f
-(removes them from)2 790 1 720 7230 t
-10 CW f
-(sam)1539 7230 w
-10 R f
-( these commands have a)4 990( Both)1 250('s memory \(without effect on associated disc files\).)7 2081 3 1719 7230 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 9 9
-%%Page: 10 10
-/saveobj save def
-mark
-10 pagesetup
-10 R f
-(- 10 -)2 216 1 2772 480 t
-(syntax for using the shell)4 1005 1 720 840 t
-6 R f
-(7)1725 790 w
-10 R f
-(\(the Unix command interpreter\) to generate the lists:)7 2099 1 1780 840 t
-9 CW f
-(B <echo *.c)2 594 1 1008 1010 t
-10 R f
-(will add all C source files, and)6 1218 1 720 1190 t
-9 CW f
-(B <grep -l variable *.c)4 1242 1 1008 1360 t
-10 R f
-( files referencing a particular variable \(the Unix command)8 2377(will add all C source)4 851 2 720 1540 t
-10 CW f
-(grep -l)1 420 1 3980 1540 t
-10 R f
-(lists all files in)3 608 1 4432 1540 t
-( Finally,)1 379( the specified regular expression\).)4 1429(its arguments that contain matches of)5 1595 3 720 1660 t
-10 CW f
-(D)4168 1660 w
-10 R f
-(without arguments)1 767 1 4273 1660 t
-(deletes the current file.)3 914 1 720 1780 t
-(There are two ways to change which file is current:)9 2047 1 970 1936 t
-9 CW f
-(b filename)1 540 1 1008 2106 t
-10 R f
-( The)1 213(makes the named file current.)4 1215 2 720 2286 t
-10 CW f
-(B)2181 2286 w
-10 R f
-( but also adds any new files to)7 1270(command does the same,)3 1028 2 2274 2286 t
-10 CW f
-(sam)4606 2286 w
-10 R f
-('s list.)1 254 1 4786 2286 t
-( The)1 208( mouse actions, not by textual commands.\))6 1728(\(In practice, of course, the current file is usually chosen by)10 2384 3 720 2406 t
-(other way is to use a form of address that refers to files:)12 2223 1 720 2526 t
-9 CW f
-(")1008 2696 w
-9 I f
-(expression)1062 2696 w
-9 CW f
-(")1447 2696 w
-9 I f
-(address)1555 2696 w
-10 R f
-( matches the expression \(there must be exactly)7 1923(refers to the address evaluated in the file whose menu line)10 2397 2 720 2876 t
-( example,)1 388( For)1 189(one match\).)1 471 3 720 2996 t
-9 CW f
-("peter.c" 3)1 594 1 1008 3166 t
-10 R f
-( whose name matches)3 885(refers to the third line of the file)7 1299 2 720 3346 t
-10 CW f
-(peter.c)2933 3346 w
-10 R f
-( is most useful in the move \()7 1164(. This)1 257 2 3353 3346 t
-10 CW f
-(m)4774 3346 w
-10 R f
-(\) and)1 206 1 4834 3346 t
-(copy \()1 252 1 720 3466 t
-10 CW f
-(t)972 3466 w
-10 R f
-(\) commands:)1 519 1 1032 3466 t
-9 CW f
-(0,$ t "peter.c" 0)3 918 1 1008 3636 t
-10 R f
-(makes a copy of the current file at the beginning of)10 2040 1 720 3816 t
-10 CW f
-(peter.c)2785 3816 w
-10 R f
-(.)3205 3816 w
-(The)970 3972 w
-10 CW f
-(X)1150 3972 w
-10 R f
-(command is a looping construct, like)5 1477 1 1235 3972 t
-10 CW f
-(x)2737 3972 w
-10 R f
-(, that refers to files instead of strings:)7 1487 1 2797 3972 t
-9 CW f
-(X/)1008 4142 w
-9 I f
-(expression)1116 4142 w
-9 CW f
-(/)1501 4142 w
-9 I f
-(command)1609 4142 w
-10 R f
-( best example is)3 641( The)1 205(runs the command in all files whose menu lines match the expression.)11 2797 3 720 4322 t
-9 CW f
-(X/'/ w)1 324 1 1008 4492 t
-10 R f
-(which writes to disc all modified files.)6 1571 1 720 4672 t
-10 CW f
-(Y)2347 4672 w
-10 R f
-(is the complement of)3 859 1 2438 4672 t
-10 CW f
-(X)3328 4672 w
-10 R f
-( command on all files whose)5 1181(: it runs the)3 471 2 3388 4672 t
-(menu lines don't match the expression:)5 1568 1 720 4792 t
-9 CW f
-(Y/\\.c/ D)1 432 1 1008 4962 t
-10 R f
-(deletes all files that don't have)5 1223 1 720 5142 t
-10 CW f
-(.c)1968 5142 w
-10 R f
-(in their names, that is, it keeps all C source files and deletes the rest.)14 2727 1 2113 5142 t
-(Braces allow commands to be grouped, so)6 1689 1 970 5298 t
-9 CW f
-({)1008 5468 w
-9 I f
-(command1)1440 5578 w
-(command2)1440 5688 w
-9 CW f
-(})1008 5798 w
-10 R f
-( Thus,)1 275(is syntactically a single command that runs two commands.)8 2379 2 720 5978 t
-9 CW f
-(X/\\.c/ ,g/variable/ {)2 1134 1 1008 6148 t
-(f)1440 6258 w
-(, x/.*\\n/ g/variable/ p)3 1242 1 1440 6368 t
-(})1008 6478 w
-10 R f
-(finds all occurrences of)3 936 1 720 6658 t
-10 CW f
-(variable)1682 6658 w
-10 R f
-( out the file names and lines of each match.)9 1748(in C source files, and prints)5 1104 2 2188 6658 t
-(The precise semantics of compound operations is discussed in the implementation sections below.)12 3921 1 720 6778 t
-(Finally, the undo command,)3 1152 1 970 6934 t
-10 CW f
-(u)2156 6934 w
-10 R f
-( files were affected.)3 815(, undoes the last command, no matter how many)8 2009 2 2216 6934 t
-(Multiple undo operations move further back in time, so)8 2212 1 720 7054 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 10 10
-%%Page: 11 11
-/saveobj save def
-mark
-11 pagesetup
-10 R f
-(- 11 -)2 216 1 2772 480 t
-9 CW f
-(u)1008 830 w
-(u)1008 940 w
-10 R f
-(\(which may be abbreviated)3 1086 1 720 1120 t
-10 CW f
-(u2)1832 1120 w
-10 R f
-( be undone, however, nor)4 1022( undo may not)3 578( An)1 173(\) undoes the last two commands.)5 1315 4 1952 1120 t
-( though, including for example)4 1243( else is undoable,)3 697( Everything)1 497(may any command that adds or deletes files.)7 1796 4 720 1240 t
-10 CW f
-(e)4980 1240 w
-10 R f
-(commands:)720 1360 w
-9 CW f
-(e filename)1 540 1 1008 1530 t
-(u)1008 1640 w
-10 R f
-( of the undo,)3 538( Because)1 393( file completely, including its name, dot, and modified bit.)9 2429(restores the state of the)4 960 4 720 1820 t
-( Only)1 259(potentially dangerous commands are not guarded by confirmations.)7 2759 2 720 1940 t
-10 CW f
-(D)3772 1940 w
-10 R f
-( informa-)1 382(, which destroys the)3 826 2 3832 1940 t
-( a modified file, but a second)6 1210( will not delete)3 618( It)1 118(tion necessary to restore itself, is protected.)6 1772 4 720 2060 t
-10 CW f
-(D)4471 2060 w
-10 R f
-(of the same)2 476 1 4564 2060 t
-( The)1 205(file will succeed regardless.)3 1108 2 720 2180 t
-10 CW f
-(q)2058 2180 w
-10 R f
-(command, which exits)2 902 1 2143 2180 t
-10 CW f
-(sam)3070 2180 w
-10 R f
-(, is similarly guarded.)3 869 1 3250 2180 t
-10 B f
-(Mouse Interface)1 695 1 720 2420 t
-10 CW f
-(Sam)720 2576 w
-10 R f
-( dif-)1 173( only)1 206( The)1 208(is most commonly run connected to a bitmap display and mouse for interactive editing.)13 3525 4 928 2576 t
-(ference in the command language between regular, mouse-driven)7 2637 1 720 2696 t
-10 CW f
-(sam)3386 2696 w
-10 R f
-(and)3595 2696 w
-10 CW f
-(sam -d)1 360 1 3768 2696 t
-10 R f
-(is that if an address is)5 883 1 4157 2696 t
-(provided without a command,)3 1217 1 720 2816 t
-10 CW f
-(sam -d)1 360 1 1968 2816 t
-10 R f
-(will print the text referenced by the address, but regular)9 2280 1 2360 2816 t
-10 CW f
-(sam)4672 2816 w
-10 R f
-(will)4884 2816 w
-(highlight it on the screen \320 in fact, dot is always highlighted \(see Figure 2\).)14 3053 1 720 2936 t
-cleartomark
-saveobj restore
-%ps_include: begin
-save
-/ed {exch def} def
-{} /showpage ed
-{} /copypage ed
-{} /erasepage ed
-{} /letter ed
-currentdict /findfont known systemdict /findfont known and {
- /findfont systemdict /findfont get def
-} if
-36 dict dup /PS-include-dict-dw ed begin
-/context ed
-count array astore /o-stack ed
-%ps_include: variables begin
-/llx 80 def
-/lly 322 def
-/urx 531.44 def
-/ury 468.88 def
-/w 0 def
-/o 0 def
-/s 0 def
-/cx 2880 def
-/cy -3910 def
-/sx 4320 def
-/sy 1468 def
-/ax 0.5 def
-/ay 0.5 def
-/rot 0 def
-%ps_include: variables end
-{llx lly urx ury} /bbox ed
-{newpath 2 index exch 2 index exch dup 6 index exch
- moveto 3 {lineto} repeat closepath} /boxpath ed
-{dup mul exch dup mul add sqrt} /len ed
-{2 copy gt {exch} if pop} /min ed
-{2 copy lt {exch} if pop} /max ed
-{transform round exch round exch A itransform} /nice ed
-{6 array} /n ed
-n defaultmatrix n currentmatrix n invertmatrix n concatmatrix /A ed
-urx llx sub 0 A dtransform len /Sx ed
-0 ury lly sub A dtransform len /Sy ed
-llx urx add 2 div lly ury add 2 div A transform /Cy ed /Cx ed
-rot dup sin abs /S ed cos abs /C ed
-Sx S mul Sy C mul add /H ed
-Sx C mul Sy S mul add /W ed
-sy H div /Scaley ed
-sx W div /Scalex ed
-s 0 eq {Scalex Scaley min dup /Scalex ed /Scaley ed} if
-sx Scalex W mul sub 0 max ax 0.5 sub mul cx add /cx ed
-sy Scaley H mul sub 0 max ay 0.5 sub mul cy add /cy ed
-urx llx sub 0 A dtransform exch atan rot exch sub /rot ed
-n currentmatrix initgraphics setmatrix
-cx cy translate
-Scalex Scaley scale
-rot rotate
-Cx neg Cy neg translate
-A concat
-bbox boxpath clip newpath
-w 0 ne {gsave bbox boxpath 1 setgray fill grestore} if
-end
-gsave
-%ps_include: inclusion begin
-/picstr 79 string def
-80 322 translate
-451.44 146.88 scale
-
-627 204 1 [627 0 0 -204 0 204]
-{currentfile picstr readhexstring pop} image
-
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-fe00000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe00000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe00000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2001ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff3fffffff3cffffffffffffffffffffdfe7f3bff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff3fffefff3cffffffff07ffffffffff3fe7f3cff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff3fffe7ff3fffffffff33fffffffffe7fe7f3e7f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff27fff3f820fc1f0fff39c3c9f8723e7f0783e7e
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff13fff9f33cf9ce66033999c4f3311cfe6733f3e
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff39fffce73cf9fce603393cce67339cfce673f3e
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff3980fc673cf8fcffff393cce67339cfce673f3f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffff3980fce73cfc1cffff393cce60339cfce673f3f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffff39fff9e73cff8cfe03393cce67f39cfce673f3f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffff39fff3e73cffccfe03393cce67f39cfce673f3e
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffff33ffe7f23cf9ce67ff3399ccf3339cfe4723f3e
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffff07ffeff9201c1f0fff07c3c1f8739e7f2793e7e
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffffffffffffffffffffffffffcffffffe7fffffe7f
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffffffffffffffffffffffffffcfffffff3fffffcff
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdfffffffffffffffffffffffffffffffffffffffffcfffffffdfffffbfe
-7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2ffdffffffffffffffffffffffffff9fffe7ffff7ff9ffffffffffffe7fffd
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffff7fff9fffe7fbfcf0f9ffff7fffffffe7fffe
-7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffffffe7ffffffffff3f9e679ffff3fffffffe7ffff
-3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff8380c641f2307c079e6793fff9fc3c1f0e47c3f
-3f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff39e7e079f11e7f3f3e6f89fffcf999ce662399f
-9f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff3fe7e679f39e7f3f3f1f9cfffe739fcce67339f
-9f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff1fe7e7f9f39e7f3f3f499cc07e33ffccfe7339f
-9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff83e7e7f9f39e7f3f3e4b9cc07e73fc0cfe7301f
-9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffff1e7e7f9f39e7f3f3e679cfffcf3f9ccfe733ff
-9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffff9e7e7f9f39e7f3f3e679cfff9f3f9ccfe733ff
-9f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff39e7e7f9f39e7f3f3e2399fff3f9998e667399f
-9f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff83f0c1c033900f879f1183fff7fc3c4f0e73c3f
-3f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffffffffffffffffffff9ffffffffffffffffffffff
-3f9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffffffffffffffffffffcfffffffffffffffffffffe
-7f9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffffffffffffff7ffffffffffffffffffffd
-ff3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffffffffffffe7ffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffbfffffffffe7ffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffff3fffffffffe7ffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff19e1c06731991ffe4fc7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff81ccf3e738188ffe27c7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff999cf3e73999cffe73c7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff9f9cf3e739f9cffe73fffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff9f80f3e739f9cffe73fffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff9f9ff3e739f9cffe73fffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff9f9ff3e739f9cffe73c7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff9fccf3e239f9cffe67c7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff07e1f8713079cffe0fc7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffffffffffffffffffffffe7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffffffffffffffffffffffe7fffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffffffffffffffffffffffcffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f8ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fc7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe3fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f8ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffff83ffffffffee7fbffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f03fff3ffffffff9e7fcffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f39fff3ffffffff3e7fe7fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f39e1f3f0f83e1f3e4fe7fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f39ccf3e6739cce7e27f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f3b9cf3cf33f9ce7e73f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f079ff3cf31f9ce7e73f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f3b9ff3cf38380e7e73f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f399ff3cf3f19fe7e73f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f399ff3cf3f99fe7e73f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f39ccf3e6739cce7e67f3fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f03e18070f83e1f3e0fe7fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffff3fffe7fffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffff9fffcffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffefffbffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffff9fffffffffffffffffc3e1fffffffff9
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffff9ffff7fffffff81fff9fcffffffffff9
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffffffffe7fffffff9cfff9fcffffffffff9
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff19e1f041f8380f0e33ff9cce60301e1c67ffef9
-3f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff81cce679f39e7e6703ff9cce79fcfcce07ffab8
-9f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff999cce79f3fe7ce733ff9dce79fcf9ce67ffc79
-cf1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff9f9cce79f1fe7ce73fff83ce79fcf9ce7fff119
-cfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff9f80ce79f83e7c073fff9dce79fcf80e7fffc79
-cfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff9f9fce79ff1e7cff3fff9cce79fcf9fe7fffab9
-cfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff9f9fce79ff9e7cff3fff9cce79fcf9fe7fffef9
-cf1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffff9fcce479f39e7e673fff9cc479fcfcce7fffff9
-9f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffff07e1f240383f0f0e0fff81e260703e1c1fffff8
-3f1fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffe7ffffffffffffffffffffffffffffffff
-ff9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fffffffffffffffffffffffce7ffffffffffffffffffffffffffffffff
-ff9fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fffffffffffffffffffffffe0fffffffffffffffffffffffffffffffff
-ff3fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe3fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221f8ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe3fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffc000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffc00007c000000001180000001860000010000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffcf8000c00000000618000200186000000c000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffccc000c00000000c180003001800000006000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffcc61e0c0f07c1e0c1b000180fbe07c1e06070000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffcc6330c198c633181d8000c19860c63303070000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffcc6630c30cc0631818c000631860c06303070000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffcc6600c30ce0631818cfe0731860e06003000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffcc6600c30c7c7f1818cfe06318607c6003000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffcc6600c30c0e601818c000c318600e6003000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffcc6600c30c06601818c001831860066003070000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffccc330c198c6331819800301b860c63303070000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffcf81e7f8f07c1e0c1f000200dbfc7c1e06070000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffc00000000000000c000000000000000006030000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221ffffffffffffffffffc00000000000000600000000000000000c030000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889ffffffffffffffffffc000000000000001000000000000000010060000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c000000000000000000000000001f00000000040030000000000000c00
-0100000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c000000000000000000000800000300000000187830000400000000c00
-00c0000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c00000000000000000000180000030000000030cc30000600000000c00
-0060000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c0000000000000000007c7f39878303c1f07830cc36000301e1f078dc1
-e060700000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c000000000000000000c6181f8cc3066318cc60c83b0001833318ccee3
-3030700000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c000000000000000000c0181998c30c33018c6070318000c630198cc66
-3030700000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c000000000000000000e0181818030c33818c605b319fc0e6001980c66
-3030000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c0000000000000000007c181818030c31f1fc60da319fc0c601f980c67
-f030000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c0000000000000000000e181818030c30398060cc31800186031980c66
-0030000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c00000000000000000006181818030c30198060cc31800306031980c66
-0030700000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c000000000000000000c618180cc3066318cc60ee330006033338ccc63
-3030700000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c0000000000000000007c0f3e079fe3c1f07830773e000401e1d878c61
-e060700000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c000000000000000000000000000000000000300000000000000000000
-0060300000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c000000000000000000000000000000000000180000000000000000000
-00c0300000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2889c000000000000000000000000000000000000040000000000000000000
-0100600000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe2221c00000000000000000000000000000000000000000000000000000001f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c0000000000000000001e0000000040200000c0000000000203008001f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c000000000000000000300000000180c00000c0000000000183006001f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c000000000000000000300000000301800000c00000000000c3003001f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c000000000000000000fe730f078301831878dc3e39800100c3603039f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c000000000000000000303f198cc6030318ccee631f80054063b01839f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c00000000000000000030333198c60303198cc6031980038063181839f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c00000000000000000030303198c603031980c60318000ee063181801f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c00000000000000000030303f9fc603031980c63f1800038063181801f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c000000000000000000303030180603031980c6631800054063181801f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c000000000000000000303030180603031980c6631800010063181839f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c0000000000000000003030198cc60303b8ccc6671800000063301839f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c000000000000000000fc7c0f07830181d878c63b3e000000c3e03039f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c000000000000000000000000000301800000000000000000c0003019f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221c000000000000000000000000000180c0000000000000000180006019f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889c00000000000000000000000000004020000000000000000200008031f
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f8ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fc7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe3fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fcffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221fe7fffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889f8ffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2889ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2221ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe2001ffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-fffffffffffffffffffffffffe3fff
-fe00000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe00000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-fe00000000000000000000000000000000000000000000000000000000000000
-0000000000000000000000000000000000000000000000000000000000000000
-000000000000000000000000003fff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffff
-showpage
-%ps_include: inclusion end
-grestore
-PS-include-dict-dw begin
-o 0 ne {gsave A defaultmatrix /A ed llx lly nice urx ury nice
- initgraphics 0.1 setlinewidth boxpath stroke grestore} if
-clear o-stack aload pop
-context end restore
-%ps_include: end
-/saveobj save def
-mark
-8 I f
-(Figure 2. A)2 370 1 720 4744 t
-8 CW f
-(sam)1112 4744 w
-8 I f
-( bar down the left represents the file, with the bubble showing the fraction visible in the window.)17 3127( scroll)1 203(window. The)1 432 3 1278 4744 t
-( current text, which is highlighted, need not fit on a)10 1703( The)1 167( be manipulated by the mouse for convenient browsing.)8 1821(The scroll bar may)3 629 4 720 4844 t
-( it consists of one partial line, one complete line, and final partial line.)13 2252(line. Here)1 338 2 720 4944 t
-10 R f
-( in all)2 236( any time, only one window)5 1131( At)1 153(Each file may have zero or more windows open on the display.)11 2550 4 970 5220 t
-(of)720 5340 w
-10 CW f
-(sam)830 5340 w
-10 R f
-(is the)1 216 1 1037 5340 t
-10 I f
-(current window,)1 658 1 1280 5340 t
-10 R f
-( may be the)3 466(that is, the window to which typing and mouse actions refer; this)11 2609 2 1965 5340 t
-10 CW f
-(sam)720 5460 w
-10 R f
-( a file has multiple)4 752( When)1 290( file windows.)2 573(window \(that in which commands may be typed\) or one of the)11 2499 4 926 5460 t
-( current file is the last file)6 1074( The)1 213(windows, the image of the file in each window is always kept up to date.)14 3033 3 720 5580 t
-(affected by a command, so if the)6 1401 1 720 5700 t
-10 CW f
-(sam)2162 5700 w
-10 R f
-( the)1 164(window is current, the current window is not a window on)10 2493 2 2383 5700 t
-( window on a file has its own value of dot, and when switching between)14 3148( each)1 227( However,)1 460(current file.)1 485 4 720 5820 t
-( flipping between)2 711( Thus,)1 281( file, the file's value of dot is changed to that of the window.)13 2494(windows on a single)3 834 4 720 5940 t
-(windows behaves in the obvious, convenient way.)6 2003 1 720 6060 t
-( 3 has a list of commands to)7 1154( Button)1 328( numbered left to right.)4 944(The mouse on the Blit has three buttons,)7 1644 4 970 6216 t
-( as printed by the)4 708(manipulate windows, followed by a list of `menu lines' exactly)9 2579 2 720 6336 t
-10 CW f
-(f)4037 6336 w
-10 R f
-(command, one per file)3 913 1 4127 6336 t
-( the list is long, the Blit menu software)8 1577( If)1 119( file name.)2 430( menu lines are sorted by)5 1011( These)1 290(\(not one per window\).)3 893 6 720 6456 t
-( the)1 153( Using)1 295( manageable by generating a scrolling menu instead of an unwieldy long list.)12 3143(will make it more)3 729 4 720 6576 t
-( makes that file the current file, and the most recently current window in)13 2967(menu to select a file from the list)7 1353 2 720 6696 t
-( if that file is already current, selecting it in the menu cycles through the)14 2960( But)1 201( the current window.)3 844(that file)1 315 4 720 6816 t
-( is no)2 239( there)1 234( If)1 126(windows on the file; this simple trick avoids a special menu to choose windows on a file.)16 3721 4 720 6936 t
-(window open on the file,)4 996 1 720 7056 t
-10 CW f
-(sam)1741 7056 w
-10 R f
-(changes the mouse cursor to prompt the user to create one.)10 2342 1 1946 7056 t
-( commands)1 465(The commands on the button 3 menu are straightforward \(see Figure 3\), and are like the)15 3605 2 970 7212 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 11 11
-%%Page: 12 12
-/saveobj save def
-mark
-12 pagesetup
-10 R f
-(- 12 -)2 216 1 2772 480 t
-(to manipulate windows in)3 1048 1 720 840 t
-10 CW f
-(mux)1797 840 w
-10 R f
-(,)1977 840 w
-6 R f
-(8)2002 790 w
-10 R f
-(the Blit's window system.)3 1057 1 2061 840 t
-10 CW f
-(New)3172 840 w
-10 R f
-( empty)1 278(makes a new file, and gives it one)7 1381 2 3381 840 t
-(window, whose size is determined by a rectangle swept by the mouse.)11 2820 1 720 960 t
-10 CW f
-(Xerox)3592 960 w
-10 R f
-( a window to be)4 650(prompts for)1 471 2 3919 960 t
-( multiple windows are created on one file.)7 1848(selected, and makes a clone of that window; this is how)10 2472 2 720 1080 t
-10 CW f
-(Reshape)720 1200 w
-10 R f
-( and)1 172(changes the size of the indicated window,)6 1678 2 1167 1200 t
-10 CW f
-(close)3045 1200 w
-10 R f
-( that is the last window open)6 1162( If)1 119(deletes it.)1 386 3 3373 1200 t
-(on the file,)2 434 1 720 1320 t
-10 CW f
-(close)1180 1320 w
-10 R f
-(first does a)2 440 1 1506 1320 t
-10 CW f
-(D)1972 1320 w
-10 R f
-(command on the file.)3 852 1 2058 1320 t
-10 CW f
-(Write)2961 1320 w
-10 R f
-(is identical to a)3 611 1 3287 1320 t
-10 CW f
-(w)3924 1320 w
-10 R f
-(command on the file; it is)5 1030 1 4010 1320 t
-( Finally,)1 373(in the menu purely for convenience.)5 1511 2 720 1440 t
-10 CW f
-(\304\304sam\304\304)2643 1440 w
-10 R f
-( the com-)2 407(is a menu item that appears between)6 1531 2 3102 1440 t
-( it makes the)3 544( Selecting)1 434(mands and the file names.)4 1088 3 720 1560 t
-10 CW f
-(sam)2822 1560 w
-10 R f
-(window the current window, causing subsequent)5 2002 1 3038 1560 t
-(typing to be interpreted as commands.)5 1526 1 720 1680 t
-cleartomark
-saveobj restore
-%ps_include: begin
-save
-/ed {exch def} def
-{} /showpage ed
-{} /copypage ed
-{} /erasepage ed
-{} /letter ed
-currentdict /findfont known systemdict /findfont known and {
- /findfont systemdict /findfont get def
-} if
-36 dict dup /PS-include-dict-dw ed begin
-/context ed
-count array astore /o-stack ed
-%ps_include: variables begin
-/llx 242 def
-/lly 297 def
-/urx 369.44 def
-/ury 494.28 def
-/w 0 def
-/o 0 def
-/s 0 def
-/cx 2880 def
-/cy -2906 def
-/sx 4320 def
-/sy 1972 def
-/ax 0.5 def
-/ay 0.5 def
-/rot 0 def
-%ps_include: variables end
-{llx lly urx ury} /bbox ed
-{newpath 2 index exch 2 index exch dup 6 index exch
- moveto 3 {lineto} repeat closepath} /boxpath ed
-{dup mul exch dup mul add sqrt} /len ed
-{2 copy gt {exch} if pop} /min ed
-{2 copy lt {exch} if pop} /max ed
-{transform round exch round exch A itransform} /nice ed
-{6 array} /n ed
-n defaultmatrix n currentmatrix n invertmatrix n concatmatrix /A ed
-urx llx sub 0 A dtransform len /Sx ed
-0 ury lly sub A dtransform len /Sy ed
-llx urx add 2 div lly ury add 2 div A transform /Cy ed /Cx ed
-rot dup sin abs /S ed cos abs /C ed
-Sx S mul Sy C mul add /H ed
-Sx C mul Sy S mul add /W ed
-sy H div /Scaley ed
-sx W div /Scalex ed
-s 0 eq {Scalex Scaley min dup /Scalex ed /Scaley ed} if
-sx Scalex W mul sub 0 max ax 0.5 sub mul cx add /cx ed
-sy Scaley H mul sub 0 max ay 0.5 sub mul cy add /cy ed
-urx llx sub 0 A dtransform exch atan rot exch sub /rot ed
-n currentmatrix initgraphics setmatrix
-cx cy translate
-Scalex Scaley scale
-rot rotate
-Cx neg Cy neg translate
-A concat
-bbox boxpath clip newpath
-w 0 ne {gsave bbox boxpath 1 setgray fill grestore} if
-end
-gsave
-%ps_include: inclusion begin
-/picstr 23 string def
-242 297 translate
-127.44 197.28 scale
-
-177 274 1 [177 0 0 -274 0 274]
-{currentfile picstr readhexstring pop} image
-
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffc00000000000000000000000000000000000000fffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffe47c39cfffffffffffffefffff
-ffc0000fffffffffffffe23999efffffffffffffefffff
-ffc0000fffffffffffffe733992fffffffffffffefffff
-ffc0000fffffffffffffe733992fffffffffffffefffff
-ffc0000fffffffffffffe730192fffffffffffffefffff
-ffc0000fffffffffffffe733fc9fffffffffffffefffff
-ffc0000fffffffffffffe733fc9fffffffffffffefffff
-ffc0000fffffffffffffe7399c9fffffffffffffefffff
-ffc0000fffffffffffffe73c3c9fffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffce78719c3ce7ffffffffffefffff
-ffc0000fffffffffffce7338199ce7ffffffffffefffff
-ffc0000fffffffffffe6e73993ce6fffffffffffefffff
-ffc0000fffffffffffe1e739f3ce1fffffffffffefffff
-ffc0000ffffffffffffbe039f3cfbfffffffffffefffff
-ffc0000ffffffffffff0e7f9f3cf0fffffffffffefffff
-ffc0000fffffffffffece7f9f3cecfffffffffffefffff
-ffc0000fffffffffffce7339f99ce7ffffffffffefffff
-ffc0000fffffffffffce78707c3ce7ffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000ffffffffffffffff3ffffffffffffffffefffff
-ffc0000ffffffffffffffff3ffffffffffffffffefffff
-ffc0000ffffffffffffffff3ffffffffffffffffefffff
-ffc0000fffffffff8cf0f0723c1c9f87ffffffffefffff
-ffc0000fffffffffc0e6673119cc4f33ffffffffefffff
-ffc0000fffffffffccce67f39fcce673ffffffffefffff
-ffc0000fffffffffcfce63f39fcce673ffffffffefffff
-ffc0000fffffffffcfc070739c0ce603ffffffffefffff
-ffc0000fffffffffcfcffe3399cce67fffffffffefffff
-ffc0000fffffffffcfcfff3399cce67fffffffffefffff
-ffc0000fffffffffcfe66733998ccf33ffffffffefffff
-ffc0000fffffffff83f0f0739c4c1f87ffffffffefffff
-ffc0000ffffffffffffffffffffcffffffffffffefffff
-ffc0000ffffffffffffffffffffcffffffffffffefffff
-ffc0000ffffffffffffffffffffcffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffc1ffffffffffffffffffefffff
-ffc0000ffffffffffffff9ffffffffffffffffffefffff
-ffc0000ffffffffffffff9ffffffffffffffffffefffff
-ffc0000ffffffffffff0f9f87c1f0fffffffffffefffff
-ffc0000fffffffffffe679f339ce67ffffffffffefffff
-ffc0000fffffffffffce79e799fce7ffffffffffefffff
-ffc0000fffffffffffcff9e798fce7ffffffffffefffff
-ffc0000fffffffffffcff9e79c1c07ffffffffffefffff
-ffc0000fffffffffffcff9e79f8cffffffffffffefffff
-ffc0000fffffffffffcff9e79fccffffffffffffefffff
-ffc0000fffffffffffe679f339ce67ffffffffffefffff
-ffc0000ffffffffffff0c0387c1f0fffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc00008000000000000000000000000000000000fffff
-ffc00008000000000000000000000000000000000fffff
-ffc00008000000000000000300000000000000000fffff
-ffc00008000000000000000300800000000000000fffff
-ffc00008000000000000000001800000000000000fffff
-ffc000080000000000319cdf07f0f000000000000fffff
-ffc000080000000000308fc301819800000000000fffff
-ffc000080000000000368cc30183180000ff80000fffff
-ffc000080000000000368c030183180000fe00000fffff
-ffc000080000000000368c030183f80000f800000fffff
-ffc0000800000000001b0c030183000000fc00000fffff
-ffc0000800000000001b0c030183000000fe00000fffff
-ffc0000800000000001b0c030181980000df00000fffff
-ffc0000800000000001b1f1fe0f0f00000cf80000fffff
-ffc000080000000000000000000000000087c0000fffff
-ffc000080000000000000000000000000083e0000fffff
-ffc0000ffffffffffffffffffffffffffffe0fffefffff
-ffc0000fffffffffffffffffffffffffffff07ffefffff
-ffc0000fffffffffffffffffffffffffffff83ffefffff
-ffc0000fffffffffffffffffffffffffffffc1ffefffff
-ffc0000fffffffffffffffffffffffffffffe0ffefffff
-ffc0000ffffffffffffff07832dffffffffff1ffefffff
-ffc0000fffffffffeef76733900f77bbfffffbffefffff
-ffc0000fffffffffc6e367ff924e371bffffffffefffff
-ffc0000fffffffff80c063ff924c0603ffffffffefffff
-ffc0000fffffffffb1d8f078124d8ec7ffffffffefffff
-ffc0000fffffffffbbddfe33924ddeefffffffffefffff
-ffc0000fffffffffffffff33924fffffffffffffefffff
-ffc0000fffffffffffffe733124fffffffffffffefffff
-ffc0000ffffffffffffff078924fffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000ffffffffffffff3f9ffffffffffffffffefffff
-ffc0000ffffffffffffff3f9ffffffffffffffffefffff
-ffc0000ffffffffffffff3f9ffffffffffffffffefffff
-ffc0000ffff9fffffe0f83c18cf0f0783fff0fffefffff
-ffc0000ffff9fffffce73399c0e667339ffe67ffefffff
-ffc0000ffff9ffffffe67339ccce67f3fffce7ffefffff
-ffc0000fffc03fffffe67339cfce63f1fffcffffefffff
-ffc0000fffc03ffffe067339cfc070783ffcffffefffff
-ffc0000ffff9fffffce67339cfcffe3f1ffcffffefffff
-ffc0000ffff9fc7ffce67339cfcfff3f9e3cffffefffff
-ffc0000ffff9fc7ffcc72391cfe667339e3e67ffefffff
-ffc0000ffffffc7ffe2793c983f0f0783e3f0fffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000fffffffffffffffffffffffffffffffffefffff
-ffc0000ffffffffffffc1e0fffffffffffffffffefffff
-ffc0000fffffffffffff9fcfffffffffffffffffefffff
-ffc0000fffffffffffff9fcfffffffffffffffffefffff
-ffc0000ffffffffffe0f9fcfc3f0fffc3fffffffefffff
-ffc0000ffffffffffce79fcf99e67ff99fffffffefffff
-ffc0000fffffffffffe79fcf3cce7ff39fffffffefffff
-ffc0000fffe03fffffe79fcf3ccffff3ffffffffefffff
-ffc0000fffe03ffffe079fcf3ccffff3ffffffffefffff
-ffc0000ffffffffffce79fcf3ccffff3ffffffffefffff
-ffc0000ffffffffffce79fcf3ccff8f3ffffffffefffff
-ffdffffffffffffffcc79fcf99e678f99fffffffefffff
-ffdffffffffffffffe240201c3f0f8fc3fffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdffffffffffffffcffffe1f0ffffffffffffffefffff
-ffdffffffffffffffcffffcfe7ffffffffffffffefffff
-ffdffffffffffffffcffffcfe7ffffffffffffffefffff
-ffdffffffffdfffffc9e730180f0e33ffe1fffffefffff
-ffdffffffff57ffffc4e73cfe7e6703ffccfffffefffff
-ffdffffffff8fffffce673cfe7ce733ff9cfffffefffff
-ffdfffffffe23ffffce673cfe7ce73fff9ffffffefffff
-ffdffffffff8fffffce673cfe7c073fff9ffffffefffff
-ffdffffffff57ffffce673cfe7cff3fff9ffffffefffff
-ffdffffffffdfffffce673cfe7cff3fc79ffffffefffff
-ffdffffffffffffffcce23cfe7e673fc7ccfffffefffff
-ffdffffffffffffffc1f130381f0e0fc7e1fffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdffffffffffffffffffff9ffffffffffffffffefffff
-ffdffffffffffffffffffff9ffffffffffffffffefffff
-ffdffffffffffffffffffff9ffffffffffffffffefffff
-ffdfffffffffffffff0cb7c1fff0ffffffffffffefffff
-ffdffffffffffffffe640399ffe67fffffffffffefffff
-ffdffffffffffffffce49339ffce7fffffffffffefffff
-ffdfffffffe03ffffcfc9339ffcfffffffffffffefffff
-ffdfffffffe03ffffcfc9339ffcfffffffffffffefffff
-ffdffffffffffffffcfc9339ffcfffffffffffffefffff
-ffdffffffffffffffcfc9339e3cfffffffffffffefffff
-ffdffffffffffffffe649391e3e67fffffffffffefffff
-ffdfffffffffffffff0c93c9e3f0ffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdffffff1ffffffffe79fffffffffffffffffffefffff
-ffdffffff1ffffffffe79fffffffffffffffffffefffff
-ffdffffff1ffffffffe7ffffffffffffffffffffefffff
-ffdffffff9f9ffffff041f83e1fff87fffffffffefffff
-ffdffffff9f9fffffe679f39ccfff33fffffffffefffff
-ffdffffff3f9fffffce79f3f9cffe73fffffffffefffff
-ffdfffffffc03ffffce79f1f9fffe7ffffffffffefffff
-ffdfffffffc03ffffce79f839fffe7ffffffffffefffff
-ffdffffffff9fffffce79ff19fffe7ffffffffffefffff
-ffdffffffff9fffffce79ff99ff1e7ffffffffffefffff
-ffdffffffff9fffffe479f39ccf1f33fffffffffefffff
-ffdfffffffffffffff240383e1f1f87fffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffff0e3319c3c67ffc3fffffffefffff
-ffdffffffffffffffe67038199e07ff99fffffffefffff
-ffdffffffffffffffce733993ce67ff39fffffffefffff
-ffdfffffffe03ffffce73f9f3ce7fff3ffffffffefffff
-ffdfffffffe03ffffc073f9f3ce7fff3ffffffffefffff
-ffdffffffffffffffcff3f9f3ce7fff3ffffffffefffff
-ffdffffffffffffffcff3f9f3ce7f8f3ffffffffefffff
-ffdffffffffffffffe673f9f99e7f8f99fffffffefffff
-ffdfffffffffffffff0e0f07c3c1f8fc3fffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdffffffffffffffffffffffffffffff9ffffffefffff
-ffdffffffffffffffffffffffffffffff9ffffffefffff
-ffdffffffffffffffffffffffffffffff9ffffffefffff
-ffdfffffffffffffff0e3319c3c6707ff91fffffefffff
-ffdffffffffffffffe67038199e0673ff88fffffefffff
-ffdffffffffffffffce733993ce667fff9cfffffefffff
-ffdfffffffe03ffffce73f9f3ce7e3fff9cfffffefffff
-ffdfffffffe03ffffc073f9f3ce7f07ff9cfffffefffff
-ffdffffffffffffffcff3f9f3ce7fe3ff9cfffffefffff
-ffdffffffffffffffcff3f9f3ce7ff3c79cfffffefffff
-ffdffffffffffffffe673f9f99e7e73c79cfffffefffff
-ffdfffffffffffffff0e0f07c3c1f07c79cfffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffff879e0fffffffffffffffffefffff
-ffdfffffffffffffff3f9fcfffffffffffffffffefffff
-ffdfffffffffffffff3fffcfffffffffffffffffefffff
-ffdffffffffffffffc041fcfe1fff87fffffffffefffff
-ffdfffffffffffffff3f9fcfccfff33fffffffffefffff
-ffdfffffffffffffff3f9fcf9cffe73fffffffffefffff
-ffdfffffffe03fffff3f9fcf9cffe7ffffffffffefffff
-ffdfffffffe03fffff3f9fcf80ffe7ffffffffffefffff
-ffdfffffffffffffff3f9fcf9fffe7ffffffffffefffff
-ffdfffffffffffffff3f9fcf9ff1e7ffffffffffefffff
-ffdfffffffffffffff3f9fcfccf1f33fffffffffefffff
-ffdffffffffffffffc0c0201e1f1f87fffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffff0783ffffffffffffefffff
-ffdfffffffffffffffffffffe7f3ffffffffffffefffff
-ffdfffffffffffffffffffffe7f3ffffffffffffefffff
-ffdfffffffffffffff078783e7f3f0fc3fff0fffefffff
-ffdffffffffffffffe673339e7f3e6799ffe67ffefffff
-ffdffffffffffffffce673f9e7f3cf339ffce7ffefffff
-ffdfffffffe03ffffce67ff9e7f3cf33fffcffffefffff
-ffdfffffffe03ffffce67f81e7f3cf33fffcffffefffff
-ffdffffffffffffffce67f39e7f3cf33fffcffffefffff
-ffdffffffffffffffce67f39e7f3cf33fe3cffffefffff
-ffdffffffffffffffe473331e7f3e6799e3e67ffefffff
-ffdfffffffffffffff278789008070fc3e3f0fffefffff
-ffdfffffffffffffffe7ffffffffffffffffffffefffff
-ffdffffffffffffffce7ffffffffffffffffffffefffff
-ffdffffffffffffffe0fffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffff3fffffffffffffffffffffefffff
-ffdfffffffffffffff3fffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdffffffffffffff83f0fffe1ffffffffffffffefffff
-ffdfffffffffffffff3e67ffccffffffffffffffefffff
-ffdfffffffffffffff3cf3ff9cffffffffffffffefffff
-ffdfffffffe03fffff3cf3ff9fffffffffffffffefffff
-ffdfffffffe03fffff3cf3ff9fffffffffffffffefffff
-ffdfffffffffffffff3cf3ff9fffffffffffffffefffff
-ffdfffffffffffffff3cf3c79fffffffffffffffefffff
-ffdfffffffffffffff3e67c7ccffffffffffffffefffff
-ffdffffffffffffff8070fc7e1ffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffdfffffffffffffffffffffffffffffffffffffefffff
-ffc00000000000000000000000000000000000000fffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-ffffffffffffffffffffffffffffffffffffffffffffff
-showpage
-%ps_include: inclusion end
-grestore
-PS-include-dict-dw begin
-o 0 ne {gsave A defaultmatrix /A ed llx lly nice urx ury nice
- initgraphics 0.1 setlinewidth boxpath stroke grestore} if
-clear o-stack aload pop
-context end restore
-%ps_include: end
-/saveobj save def
-mark
-8 I f
-( prevent its)2 361( black rectangle on the left is a scroll bar; the menu is limited to the length shown to)18 2744( The)1 163(Figure 3. The menu on button 3.)6 1052 4 720 3992 t
-( the)1 121( Above)1 243(becoming unwieldy.)1 642 3 720 4092 t
-8 CW f
-(\304\304sam\304\304)1750 4092 w
-8 I f
-( a list of files, presented exactly as with the)9 1397(line is a list of commands; beneath it is)8 1280 2 2110 4092 t
-8 CW f
-(f)4810 4092 w
-8 I f
-(com-)4881 4092 w
-(mand.)720 4192 w
-10 R f
-(When)970 4468 w
-10 CW f
-(sam)1241 4468 w
-10 R f
-(requests that a window be swept, in response to)8 1972 1 1454 4468 t
-10 CW f
-(new)3460 4468 w
-10 R f
-(,)3640 4468 w
-10 CW f
-(xerox)3699 4468 w
-10 R f
-(or)4033 4468 w
-10 CW f
-(reshape)4150 4468 w
-10 R f
-(, it changes)2 470 1 4570 4468 t
-( may be used to)4 631( this state, the mouse)4 844( In)1 135(the mouse cursor from the usual arrow to a box with a small arrow.)13 2710 4 720 4588 t
-( one corner and releasing it at the opposite corner.)9 2103(indicate an arbitrary rectangle by pressing button 3 at)8 2217 2 720 4708 t
-( button 3 may simply be clicked, whereupon)7 1860(More conveniently,)1 795 2 720 4828 t
-10 CW f
-(sam)3412 4828 w
-10 R f
-(creates the maximal rectangle that)4 1411 1 3629 4828 t
-( the)1 155(contains the cursor and abuts)4 1187 2 720 4948 t
-10 CW f
-(sam)2095 4948 w
-10 R f
-( placing the)2 482(window. By)1 522 2 2308 4948 t
-10 CW f
-(sam)3345 4948 w
-10 R f
-(window in the middle of the screen,)6 1482 1 3558 4948 t
-( stacked fully-overlapping windows can be)5 1721(the user can define two regions \(one above, one below\) in which)11 2599 2 720 5068 t
-( simple user interface trick makes window creation notice-)8 2403( This)1 236(created with minimal fuss \(see Figure 1\).)6 1681 3 720 5188 t
-(ably easier.)1 454 1 720 5308 t
-(The cut-and-paste editor is essentially the same as that in Smalltalk-80.)10 2944 1 970 5464 t
-6 R f
-(11)3914 5414 w
-10 R f
-( always)1 313(The text in dot is)4 718 2 4009 5464 t
-( after the)2 358( a character is typed it replaces dot, and sets dot to the null string)14 2630( When)1 291(highlighted on the screen.)3 1041 4 720 5584 t
-( button, moving)2 657( 1 is used for selection: pressing the)7 1492( Button)1 332( ordinary typing inserts text.)4 1166(character. Thus,)1 673 5 720 5704 t
-( to\) the text between the points where the button was)10 2248(the mouse, and lifting the button selects \(sets dot)8 2072 2 720 5824 t
-( a null string; this is called clicking.)7 1477( and releasing at the same point selects)7 1592( Pressing)1 395(pressed and released.)2 856 4 720 5944 t
-(Clicking twice quickly, or)3 1077 1 720 6064 t
-10 I f
-(double clicking,)1 648 1 1833 6064 t
-10 R f
-(selects larger objects; for example, double clicking in a word)9 2524 1 2516 6064 t
-( clicking just inside an opening bracket selects the text contained in the brackets)13 3328(selects the word, double)3 992 2 720 6184 t
-( double-clicking)1 656( The)1 209( similarly for parentheses, quotes, and so on.)7 1809(\(handling nested brackets correctly\), and)4 1646 4 720 6304 t
-( If)1 127(rules reflect a bias toward programmers.)5 1667 2 720 6424 t
-10 CW f
-(sam)2550 6424 w
-10 R f
-( more for word processing, double-clicks)5 1701(were intended)1 573 2 2766 6424 t
-(would probably select linguistic structures such as sentences.)7 2441 1 720 6544 t
-( is the)2 245( This)1 231( outside the current window, it makes the indicated window current.)10 2748(If button 1 is pressed)4 846 4 970 6700 t
-(easiest way to switch between windows and files.)7 1980 1 720 6820 t
-( mostly apply to the)4 835( These)1 298( of editing functions \(see Figure 4\).)6 1472(Pressing button 2 brings up a menu)6 1465 4 970 6976 t
-(selected text:)1 537 1 720 7096 t
-10 CW f
-(cut)1295 7096 w
-10 R f
-( remembers it in a hidden buffer called the)8 1792(deletes the selected text, and)4 1191 2 1513 7096 t
-10 I f
-(snarf buffer,)1 507 1 4533 7096 t
-10 CW f
-(paste)720 7216 w
-10 R f
-(replaces the selected text by the contents of the snarf buffer,)10 2426 1 1047 7216 t
-10 CW f
-(snarf)3501 7216 w
-10 R f
-(just copies the selected text to)5 1211 1 3829 7216 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 12 12
-%%Page: 13 13
-/saveobj save def
-mark
-13 pagesetup
-10 R f
-(- 13 -)2 216 1 2772 480 t
-(the snarf buffer,)2 667 1 720 840 t
-10 CW f
-(look)1426 840 w
-10 R f
-( next literal occurrence of the selected text, and)8 1990(searches forward for the)3 1007 2 1705 840 t
-10 CW f
-(<mux>)4740 840 w
-10 R f
-(exchanges snarf buffers with the window system in which)8 2510 1 720 960 t
-10 CW f
-(sam)3280 960 w
-10 R f
-( the last regular)3 693( Finally,)1 384(is running.)1 453 3 3510 960 t
-( occurrence of a match for the)6 1291(expression used appears as a menu entry to search forward for the next)12 3029 2 720 1080 t
-(expression.)720 1200 w
-cleartomark
-saveobj restore
-%ps_include: begin
-save
-/ed {exch def} def
-{} /showpage ed
-{} /copypage ed
-{} /erasepage ed
-{} /letter ed
-currentdict /findfont known systemdict /findfont known and {
- /findfont systemdict /findfont get def
-} if
-36 dict dup /PS-include-dict-dw ed begin
-/context ed
-count array astore /o-stack ed
-%ps_include: variables begin
-/llx 268 def
-/lly 352 def
-/urx 342.16 def
-/ury 438.4 def
-/w 0 def
-/o 0 def
-/s 0 def
-/cx 2880 def
-/cy -1872 def
-/sx 4320 def
-/sy 864 def
-/ax 0.5 def
-/ay 0.5 def
-/rot 0 def
-%ps_include: variables end
-{llx lly urx ury} /bbox ed
-{newpath 2 index exch 2 index exch dup 6 index exch
- moveto 3 {lineto} repeat closepath} /boxpath ed
-{dup mul exch dup mul add sqrt} /len ed
-{2 copy gt {exch} if pop} /min ed
-{2 copy lt {exch} if pop} /max ed
-{transform round exch round exch A itransform} /nice ed
-{6 array} /n ed
-n defaultmatrix n currentmatrix n invertmatrix n concatmatrix /A ed
-urx llx sub 0 A dtransform len /Sx ed
-0 ury lly sub A dtransform len /Sy ed
-llx urx add 2 div lly ury add 2 div A transform /Cy ed /Cx ed
-rot dup sin abs /S ed cos abs /C ed
-Sx S mul Sy C mul add /H ed
-Sx C mul Sy S mul add /W ed
-sy H div /Scaley ed
-sx W div /Scalex ed
-s 0 eq {Scalex Scaley min dup /Scalex ed /Scaley ed} if
-sx Scalex W mul sub 0 max ax 0.5 sub mul cx add /cx ed
-sy Scaley H mul sub 0 max ay 0.5 sub mul cy add /cy ed
-urx llx sub 0 A dtransform exch atan rot exch sub /rot ed
-n currentmatrix initgraphics setmatrix
-cx cy translate
-Scalex Scaley scale
-rot rotate
-Cx neg Cy neg translate
-A concat
-bbox boxpath clip newpath
-w 0 ne {gsave bbox boxpath 1 setgray fill grestore} if
-end
-gsave
-%ps_include: inclusion begin
-/picstr 13 string def
-268 352 translate
- 74.16 86.40 scale
-
-103 120 1 [103 0 0 -120 0 120]
-{currentfile picstr readhexstring pop} image
-
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-f800000000000000000001ffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffdfffffffdffff
-fbfffffffffff9fffffffdffff
-fbffffffe1ce603ffffffdffff
-fbffffffccce79fffffffdffff
-fbffffff9cce79fffffffdffff
-fbffffff9fce79fffffffdffff
-fbffffff9fce79fffffffdffff
-fbffffff9fce79fffffffdffff
-fbffffff9fce79fffffffdffff
-fbffffffccc479fffffffdffff
-fbffffffe1e27c3ffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffdfffffffdffff
-fbfffffffffff9fffffffdffff
-fbffff27c1e0e03c3ffffdffff
-fbffff139cce79f99ffffdffff
-fbffff39fccff9f39ffffdffff
-fbffff39fcc7f9f39ffffdffff
-fbffff39c0e0f9f01ffffdffff
-fbffff399cfc79f3fffffdffff
-fbffff399cfe79f3fffffdffff
-fbffff3398ce79f99ffffdffff
-fbffff07c4e0fc3c3ffffdffff
-fbffff3ffffffffffffffdffff
-fbffff3ffffffffffffffdffff
-fbffff3ffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffe1ffffdffff
-fbfffffffffffffcfffffdffff
-fbfffffffffffffcfffffdffff
-fbffff8391e0e3301ffffdffff
-fbffff3988ce703cfffffdffff
-fbffff3f9cfe733cfffffdffff
-fbffff1f9cfe73fcfffffdffff
-fbffff839ce073fcfffffdffff
-fbfffff19cce73fcfffffdffff
-fbfffff99cce73fcfffffdffff
-fbffff399ccc73fcfffffdffff
-fbffff839ce260f03ffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffff07fffff3ffffffdffff
-fbfffffe7fffff3ffffffdffff
-fbfffffe7fffff3ffffffdffff
-fbfffffe7e1f0f39fffffdffff
-fbfffffe7cce673bfffffdffff
-fbfffffe79e4f337fffffdffff
-fbfffffe79e4f32ffffffdffff
-fbfffffe79e4f30ffffffdffff
-fbfffffe79e4f327fffffdffff
-fbfffffe79e4f333fffffdffff
-fbfffffe7cce6739fffffdffff
-fbfffff00e1f0f39fffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-fbfffffbfffffffbfffffdffff
-fbfffff3fffffff9fffffdffff
-fbffffe72dce673cfffffdffff
-fbffffcf00ce673e7ffffdffff
-fbffff9f24ce737f3ffffdffff
-fbffff1f24ce70ff1ffffdffff
-fbffff9f24ce7dff3ffffdffff
-fbffffcf24ce787e7ffffdffff
-fbffffe724ce767cfffffdffff
-fbfffff324c46739fffffdffff
-fbfffffb24e2673bfffffdffff
-fbfffffffffffffffffffdffff
-fbfffffffffffffffffffdffff
-f800000000000000000001ffff
-f800000000000000000001ffff
-f800c04000030000200001ffff
-f800c18000030000180001ffff
-f8018300000180000c0001ffff
-f801830000c180dc0c0c01ffff
-f803060000c0c0ee060c01ffff
-f803060000c0c0c6060c01ffff
-f806060007f860c6067f81ffff
-f806060007f860c6067f81ffff
-f80c060000c030c6060c01ffff
-f80c0601c0c030c6060c01ffff
-f8180601c0c018c6060c01ffff
-f8180301c00018c60c001e0fff
-f830030000000c000c001e3fff
-f830018000000c0018001effff
-f80000400000000020001e7fff
-ffffffffffffffffffffe03fff
-ffffffffffffffffffffe41fff
-ffffffffffffffffffffe60fff
-ffffffffffffffffffffef07ff
-ffffffffffffffffffffef83ff
-ffffffffffffffffffffffc1ff
-ffffffffffffffffffffffe0ff
-fffffffffffffffffffffff07f
-fffffffffffffffffffffff83f
-fffffffffffffffffffffffc1f
-fffffffffffffffffffffffe3f
-ffffffffffffffffffffffff7f
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-ffffffffffffffffffffffffff
-showpage
-%ps_include: inclusion end
-grestore
-PS-include-dict-dw begin
-o 0 ne {gsave A defaultmatrix /A ed llx lly nice urx ury nice
- initgraphics 0.1 setlinewidth boxpath stroke grestore} if
-clear o-stack aload pop
-context end restore
-%ps_include: end
-/saveobj save def
-mark
-8 I f
-( bottom entry tracks the most recently used regular expression, which may be literal text.)14 2834( The)1 160(Figure 4. The menu on button 2.)6 1034 3 720 2404 t
-10 R f
-( mouse language is entirely due to the equal-)8 1794(The relationship between the command language and the)7 2276 2 970 2680 t
-( example, to make a set of changes)7 1419( For)1 193( button 1 on the mouse.)5 959(ity of dot and the selected text chosen with)8 1749 4 720 2800 t
-( be set by double clicking on the left brace that begins the subroutine, which sets)15 3278(in a C subroutine, dot can)5 1042 2 720 2920 t
-( address-free command then typed in the)6 1660( An)1 178(dot for the command language.)4 1269 3 720 3040 t
-10 CW f
-(sam)3858 3040 w
-10 R f
-(window will apply only)3 971 1 4069 3040 t
-( idea is to select what you want, and)8 1453( The)1 206( text between the opening and closing braces of the function.)10 2436(to the)1 225 4 720 3160 t
-( of)1 108( And)1 222( want to do with it, whether invoked by a menu selection or by a typed command.)16 3263(then say what you)3 727 4 720 3280 t
-( relationship)1 516( This)1 247( command completes.)2 912(course, the value of dot is highlighted on the display after the)11 2645 4 720 3400 t
-( to explain, but comfortable, even natural, in)7 1859(between mouse interface and command language is clumsy)7 2461 2 720 3520 t
-(practice.)720 3640 w
-10 B f
-(The Implementation)1 875 1 720 3880 t
-10 R f
-(The next few sections describe how)5 1447 1 720 4036 t
-10 CW f
-(sam)2196 4036 w
-10 R f
-( together, first the host part, then the inter-component com-)9 2411(is put)1 224 2 2405 4036 t
-( dis-)1 181( explaining how the command language is implemented, the)8 2462( After)1 267(munication, then the terminal part.)4 1410 4 720 4156 t
-( presen-)1 320( The)1 207(cussion follows \(roughly\) the path of a character from the temporary file on disc to the screen.)16 3793 3 720 4276 t
-( because that is how the program was designed and because the algo-)12 2844(tation centers on the data structures,)5 1476 2 720 4396 t
-(rithms are easy to provide, given the right data structures.)9 2299 1 720 4516 t
-10 B f
-(Parsing and execution)2 945 1 720 4756 t
-10 R f
-( recursive descent)2 754(The command language is interpreted by parsing each command with a table-driven)11 3566 2 720 4912 t
-( editors instead)2 617( Most)1 262( top-down executor.)2 813(parser, and when a complete command is assembled, invoking a)9 2628 4 720 5032 t
-( and unambiguous to)3 875( of a parser makes it easy)6 1080( Use)1 217(employ a simple character-at-a-time lexical scanner.)5 2148 4 720 5152 t
-( conventions such as back-)4 1102( escape)1 299( First,)1 268(detect when a command is complete, which has two advantages.)9 2651 4 720 5272 t
-( the command isn't finished, the parser keeps)7 1850( if)1 117( multiple-line commands are unnecessary;)4 1710(slashes to quote)2 643 4 720 5392 t
-( example, a multiple-line append driven by an)7 1836(reading. For)1 513 2 720 5512 t
-10 CW f
-(x)3094 5512 w
-10 R f
-(command is straightforward:)2 1154 1 3179 5512 t
-9 CW f
-(x/.*\\n/ g/Peter/ a)2 972 1 1008 5682 t
-(one line about Peter)3 1080 1 1008 5792 t
-(another line about Peter)3 1296 1 1008 5902 t
-(.)1008 6012 w
-10 R f
-(Other Unix editors would require a backslash after all but the last line.)12 2809 1 720 6192 t
-( advantage is specific to the two-process structure of)8 2167(The other)1 393 2 970 6348 t
-10 CW f
-(sam)3564 6348 w
-10 R f
-( host process must decide)4 1057(. The)1 239 2 3744 6348 t
-( easily resolved)2 631( problem is)2 462( This)1 234(when a command is completed so the command interpreter can be called.)11 2993 4 720 6468 t
-(by having the lexical analyzer read the single stream of events from the terminal, directly executing all typ-)17 4320 1 720 6588 t
-(ing and mouse commands, but passing to the parser characters typed to the)12 3071 1 720 6708 t
-10 CW f
-(sam)3823 6708 w
-10 R f
-( This)1 234(command window.)1 772 2 4034 6708 t
-( complicated by the availability of cut-and-paste editing in the)9 2510(scheme is slightly)2 721 2 720 6828 t
-10 CW f
-(sam)3979 6828 w
-10 R f
-(window, but that dif-)3 853 1 4187 6828 t
-(ficulty is resolved by applying the rules used in)8 1925 1 720 6948 t
-10 CW f
-(mux)2674 6948 w
-10 R f
-(: when a newline is typed to the)7 1296 1 2854 6948 t
-10 CW f
-(sam)4179 6948 w
-10 R f
-(window, all text)2 653 1 4387 6948 t
-( permits arbi-)2 554( This)1 236( newline is made available to the parser.)7 1658(between the newline and the previously typed)6 1872 4 720 7068 t
-(trary editing to be done to a command before typing newline and thereby requesting execution.)14 3796 1 720 7188 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 13 13
-%%Page: 14 14
-/saveobj save def
-mark
-14 pagesetup
-10 R f
-(- 14 -)2 216 1 2772 480 t
-( and commands is regular enough to be)7 1574(The parser is driven by a table because the syntax of addresses)11 2496 2 970 840 t
-( replacement text in a substitution, so the syn-)8 1859( are few special cases, such as the)7 1373( There)1 286(encoded compactly.)1 802 4 720 960 t
-( include whether the command allows)5 1542( These)1 293( can be encoded with a few flags.)7 1364(tax of almost all commands)4 1121 4 720 1080 t
-(an address \(for example,)3 989 1 720 1200 t
-10 CW f
-(e)1737 1200 w
-10 R f
-( in)1 105(does not\), whether it takes a regular expression \(as)8 2044 2 1825 1200 t
-10 CW f
-(x)4001 1200 w
-10 R f
-(and)4088 1200 w
-10 CW f
-(s)4259 1200 w
-10 R f
-(\), whether it takes)3 721 1 4319 1200 t
-(replacement text \(as in)3 915 1 720 1320 t
-10 CW f
-(c)1663 1320 w
-10 R f
-(or)1751 1320 w
-10 CW f
-(i)1862 1320 w
-10 R f
-( syntax of regular expres-)4 1035( internal)1 333( The)1 208(\), which may be multi-line, and so on.)7 1542 4 1922 1320 t
-( Regular)1 377( parser; a regular expression is a leaf of the command parse tree.)12 2699(sions is handled by a separate)5 1244 3 720 1440 t
-(expressions are discussed fully in the next section.)7 2014 1 720 1560 t
-( a com-)2 315(The parser table also has information about defaults, so the interpreter is always called with)14 3755 2 970 1716 t
-( example, the parser fills in the implicit)7 1676( For)1 204(plete tree.)1 408 3 720 1836 t
-10 CW f
-(0)3048 1836 w
-10 R f
-(and)3148 1836 w
-10 CW f
-($)3332 1836 w
-10 R f
-(in the abbreviated address)3 1084 1 3432 1836 t
-10 CW f
-(,)4556 1836 w
-10 R f
-(\(comma\),)4655 1836 w
-(inserts a)1 345 1 720 1956 t
-10 CW f
-(+)1105 1956 w
-10 R f
-( default)1 318(to the left of an unadorned regular expression in an address, and provides the usual)14 3517 2 1205 1956 t
-(address)720 2076 w
-10 CW f
-(.)1044 2076 w
-10 R f
-(\(dot\) for commands that expect an address but are not given one.)11 2589 1 1129 2076 t
-( address is evaluated left-to-right)4 1358( The)1 216( complete command is parsed, the evaluation is easy.)8 2207(Once a)1 289 4 970 2232 t
-( the)1 156( like many of)3 560( Addresses,)1 495(starting from the value of dot, with a mostly ordinary expression evaluator.)11 3109 4 720 2352 t
-(data structures in)2 682 1 720 2472 t
-10 CW f
-(sam)1427 2472 w
-10 R f
-(, are held in a C structure and passed around by value:)11 2162 1 1607 2472 t
-9 CW f
-( Position in a file */)5 1188( /*)1 270( Posn;)1 918(typedef long)1 648 4 1008 2642 t
-(typedef struct Range{)2 1134 1 1008 2752 t
-( p2;)1 216(Posn p1,)1 1026 2 1440 2862 t
-(}Range;)1008 2972 w
-(typedef struct Address{)2 1242 1 1008 3082 t
-(Range r;)1 540 1 1440 3192 t
-(File *f;)1 1026 1 1440 3302 t
-(}Address;)1008 3412 w
-10 R f
-( encoded as a substring \(character positions)6 1795(An address is)2 556 2 720 3592 t
-10 CW f
-(p1)3106 3592 w
-10 R f
-(to)3261 3592 w
-10 CW f
-(p2)3374 3592 w
-10 R f
-(\) in a file)3 393 1 3494 3592 t
-10 CW f
-(f)3922 3592 w
-10 R f
-( data type)2 408(. \(The)1 273 2 3982 3592 t
-10 CW f
-(File)4698 3592 w
-10 R f
-(is)4973 3592 w
-(described in detail below.\))3 1059 1 720 3712 t
-( interpreter is an)3 690(The address)1 491 2 970 3868 t
-10 CW f
-(Address)2189 3868 w
-10 R f
-(-valued function that traverses the parse tree describing an)8 2431 1 2609 3868 t
-(address \(the parse tree for the address has type)8 1855 1 720 3988 t
-10 CW f
-(Addrtree)2600 3988 w
-10 R f
-(\):)3080 3988 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 14 14
-%%Page: 15 15
-/saveobj save def
-mark
-15 pagesetup
-10 R f
-(- 15 -)2 216 1 2772 480 t
-9 CW f
-(Address)1008 830 w
-(address\(ap, a, sign\))2 1080 1 1008 940 t
-(Addrtree *ap;)1 702 1 1440 1050 t
-(Address a;)1 540 1 1440 1160 t
-(int sign;)1 486 1 1440 1270 t
-({)1008 1380 w
-(Address a2;)1 594 1 1440 1490 t
-(do)1440 1600 w
-(switch\(ap->type\){)1872 1710 w
-(case '.':)1 486 1 1872 1820 t
-(a=a.f->dot;)2304 1930 w
-(break;)2304 2040 w
-(case '$':)1 486 1 1872 2150 t
-(a.r.p1=a.r.p2=a.f->nbytes;)2304 2260 w
-(break;)2304 2370 w
-(case '"':)1 486 1 1872 2480 t
-(a=matchfile\(a, ap->aregexp\)->dot;)1 1782 1 2304 2590 t
-(break;)2304 2700 w
-(case ',':)1 486 1 1872 2810 t
-(a2=address\(ap->right, a, 0\);)2 1512 1 2304 2920 t
-(a=address\(ap->left, a, 0\);)2 1404 1 2304 3030 t
-(if\(a.f!=a2.f || a2.r.p2<a.r.p1\))2 1674 1 2304 3140 t
-(error\(Eorder\);)2736 3250 w
-(a.r.p2=a2.r.p2;)2304 3360 w
-(return a;)1 486 1 2304 3470 t
-(/* and so on */)4 810 1 1872 3580 t
-(})1872 3690 w
-(while\(\(ap=ap->right\)!=0\);)1440 3800 w
-(return a;)1 486 1 1440 3910 t
-(})1008 4020 w
-10 R f
-( non-local)1 408(Throughout, errors are handled by a)5 1460 2 970 4236 t
-10 CW f
-(goto)2869 4236 w
-10 R f
-(\(a)3140 4236 w
-10 CW f
-(setjmp/longjmp)3248 4236 w
-10 R f
-(in C terminology\) hid-)3 921 1 4119 4236 t
-( routine called)2 587(den in a)2 334 2 720 4356 t
-10 CW f
-(error)1674 4356 w
-10 R f
-(that immediately aborts the execution, retracts any partially made changes)9 3033 1 2007 4356 t
-( argument to)2 513( The)1 209( level of the parser.)4 783(\(see the section below on `undoing'\), and returns to the top)10 2390 4 720 4476 t
-10 CW f
-(error)4644 4476 w
-10 R f
-(is)4973 4476 w
-( possibly helpful message such as `?addresses out of)8 2179(an enumeration type that is translated to a terse but)9 2141 2 720 4596 t
-( common messages are kept short; for example the message for a failed regular expression)14 3790(order.' Very)1 530 2 720 4716 t
-(search is `?search.')2 760 1 720 4836 t
-(Character addresses such as)3 1125 1 970 4992 t
-10 CW f
-(#3)2126 4992 w
-10 R f
-(are trivial to implement, as the)5 1251 1 2277 4992 t
-10 CW f
-(File)3559 4992 w
-10 R f
-(data structure is accessible by)4 1210 1 3830 4992 t
-( However,)1 447(character number.)1 726 2 720 5112 t
-10 CW f
-(sam)1925 5112 w
-10 R f
-( of newlines \320 it is too expen-)7 1277(keeps no information about the position)5 1626 2 2137 5112 t
-( Except)1 330( are computed by reading the file, counting newlines.)8 2148(sive to track dynamically \320 so line addresses)7 1842 3 720 5232 t
-( access is fast enough to make the technique practical, and)10 2325(in very large files, this has proven acceptable: file)8 1995 2 720 5352 t
-(lines are not central to the structure of the command language.)10 2492 1 720 5472 t
-(The command interpreter, called)3 1308 1 970 5628 t
-10 CW f
-(cmdexec)2305 5628 w
-10 R f
-( parse table includes a func-)5 1131( The)1 208( also straightforward.)2 857(, is)1 119 4 2725 5628 t
-( as arguments the calculated address)5 1484( function receives)2 725( That)1 241(tion to call to interpret a particular command.)7 1870 4 720 5748 t
-( command and the command tree \(of type)7 1729(for the)1 271 2 720 5868 t
-10 CW f
-(Cmdtree)2754 5868 w
-10 R f
-(\), which may contain information such as the)7 1866 1 3174 5868 t
-( for example, is the function for the)7 1414( Here,)1 268(subtree for compound commands.)3 1359 3 720 5988 t
-10 CW f
-(g)3786 5988 w
-10 R f
-(and)3871 5988 w
-10 CW f
-(v)4040 5988 w
-10 R f
-(commands:)4125 5988 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 15 15
-%%Page: 16 16
-/saveobj save def
-mark
-16 pagesetup
-10 R f
-(- 16 -)2 216 1 2772 480 t
-9 CW f
-(int)1008 830 w
-(g_cmd\(a, cp\))1 648 1 1008 940 t
-(Address a;)1 540 1 1440 1050 t
-(Cmdtree *cp;)1 648 1 1440 1160 t
-({)1008 1270 w
-(compile\(cp->regexp\);)1440 1380 w
-(if\(execute\(a.f, a.r.p1, a.r.p2\) != \(cp->cmdchar=='v'\)\){)4 2970 1 1440 1490 t
-(a.f->dot=a;)1872 1600 w
-(return cmdexec\(a, cp->subcmd\);)2 1620 1 1872 1710 t
-(})1440 1820 w
-( indicate that execution is to continue */)7 2268( /*)1 324(return TRUE;)1 648 3 1440 1930 t
-(})1008 2040 w
-10 R f
-(\()720 2220 w
-10 CW f
-(Compile)753 2220 w
-10 R f
-(and)1202 2220 w
-10 CW f
-(execute)1375 2220 w
-10 R f
-( Because)1 387(are part of the regular expression code, described in the next section.\))11 2828 2 1825 2220 t
-(the parser and the)3 706 1 720 2340 t
-10 CW f
-(File)1451 2340 w
-10 R f
-(data structure do most of the work, most commands are similarly brief.)11 2838 1 1716 2340 t
-10 B f
-(Regular expressions)1 858 1 720 2580 t
-10 R f
-(The regular expression code in)4 1266 1 720 2736 t
-10 CW f
-(sam)2020 2736 w
-10 R f
-( than compiled on-the-fly, implementation of)5 1854(is an interpreted, rather)3 952 2 2234 2736 t
-(Thompson's non-deterministic finite automaton algorithm.)4 2392 1 720 2856 t
-6 R f
-(12)3112 2806 w
-10 R f
-( the expressions)2 656(The syntax and semantics of)4 1177 2 3207 2856 t
-(are as in the Unix program)5 1092 1 720 2976 t
-10 CW f
-(egrep)1842 2976 w
-10 R f
-( only)1 209( The)1 211( alternation, closures, character classes, and so on.)7 2045(, including)1 433 4 2142 2976 t
-(changes in the notation are two additions:)6 1755 1 720 3096 t
-10 CW f
-(\\n)2515 3096 w
-10 R f
-( and)1 183(is translated to, and matches, a newline character,)7 2083 2 2675 3096 t
-10 CW f
-(@)4980 3096 w
-10 R f
-( In)1 140(matches any character.)2 924 2 720 3216 t
-10 CW f
-(egrep)1816 3216 w
-10 R f
-(, the character)2 575 1 2116 3216 t
-10 CW f
-(.)2723 3216 w
-10 R f
-(matches any character except newline, and in)6 1856 1 2816 3216 t
-10 CW f
-(sam)4705 3216 w
-10 R f
-(the)4918 3216 w
-(same rule seemed safest, to prevent idioms like)7 2033 1 720 3336 t
-10 CW f
-(.*)2799 3336 w
-10 R f
-(from spanning newlines.)2 1027 1 2965 3336 t
-10 CW f
-(Egrep)4063 3336 w
-10 R f
-(expressions are)1 632 1 4408 3336 t
-( certainly it would make sense if all the special charac-)10 2209(arguably too complicated for an interactive editor \320)7 2111 2 720 3456 t
-( wouldn't have peculiar mean-)4 1223(ters were two-character sequences, so that most of the punctuation characters)10 3097 2 720 3576 t
-( regular expressions are necessary, and)5 1660(ings \320 but for an interesting command language, full)8 2313 2 720 3696 t
-10 CW f
-(egrep)4740 3696 w
-10 R f
-( it seemed superfluous to define a new)7 1568( Also,)1 269( Unix programs.)2 662(defines the full regular expression syntax for)6 1821 4 720 3816 t
-(syntax, since various Unix programs \()5 1520 1 720 3936 t
-10 CW f
-(ed)2240 3936 w
-10 R f
-(,)2360 3936 w
-10 CW f
-(egrep)2410 3936 w
-10 R f
-(and)2735 3936 w
-10 CW f
-(vi)2904 3936 w
-10 R f
-(\) define too many already.)4 1050 1 3024 3936 t
-(The expressions are compiled by a routine,)6 1812 1 970 4092 t
-10 CW f
-(compile)2823 4092 w
-10 R f
-( the description of the non-)5 1164(, that generates)2 633 2 3243 4092 t
-( second routine,)2 669( A)1 139(deterministic finite state machine.)3 1405 3 720 4212 t
-10 CW f
-(execute)2975 4212 w
-10 R f
-(, interprets the machine to generate the)6 1645 1 3395 4212 t
-( else-)1 238( algorithm is described)3 985( The)1 229(leftmost-longest match of the expression in a substring of the file.)10 2868 4 720 4332 t
-(where.)720 4452 w
-6 R f
-(12,13)988 4402 w
-10 CW f
-(Execute)1152 4452 w
-10 R f
-( sets a global variable, of type)6 1213(reports whether a match was found, and)6 1617 2 1601 4452 t
-10 CW f
-(Range)4459 4452 w
-10 R f
-(, to the)2 281 1 4759 4452 t
-(substring matched.)1 755 1 720 4572 t
-( such as when searching backwards for an)7 1752(A trick is required to evaluate the expression in reverse,)9 2318 2 970 4728 t
-( example,)1 388(expression. For)1 641 2 720 4848 t
-9 CW f
-(-/P.*r/)1008 5018 w
-10 R f
-( expression, however, is defined for a)6 1532( The)1 211( file for a match of the expression.)7 1411(looks backwards through the)3 1166 4 720 5198 t
-( solution is to construct a machine identical to the machine for a forward search except)15 3492( The)1 207(forward search.)1 621 3 720 5318 t
-( the concatenation operators \(the other operators are symmetric under direction reversal\),)11 3562(for a reversal of all)4 758 2 720 5438 t
-(to exchange the meaning of the operators)6 1652 1 720 5558 t
-10 CW f
-(\303)2398 5558 w
-10 R f
-(and)2484 5558 w
-10 CW f
-($)2654 5558 w
-10 R f
-(, and then to read the file backwards, looking for the usual)11 2326 1 2714 5558 t
-(earliest longest match.)2 896 1 720 5678 t
-10 CW f
-(Execute)970 5834 w
-10 R f
-( as)1 118( interpret looping constructs such)4 1368( To)1 170(generates only one match each time it is called.)8 1960 4 1424 5834 t
-(the)720 5954 w
-10 CW f
-(x)874 5954 w
-10 R f
-(command,)966 5954 w
-10 CW f
-(sam)1417 5954 w
-10 R f
-(must therefore synchronize between calls of)5 1794 1 1629 5954 t
-10 CW f
-(execute)3455 5954 w
-10 R f
-( null)1 187(to avoid problems with)3 946 2 3907 5954 t
-( example, even given the leftmost-longest rule, the expression)8 2522(matches. For)1 547 2 720 6074 t
-10 CW f
-(a*)3820 6074 w
-10 R f
-( in the)2 264(matches three times)2 805 2 3971 6074 t
-(string)720 6194 w
-10 CW f
-(ab)978 6194 w
-10 R f
-(\(the character)1 549 1 1128 6194 t
-10 CW f
-(a)1706 6194 w
-10 R f
-(, the null string between the)5 1130 1 1766 6194 t
-10 CW f
-(a)2925 6194 w
-10 R f
-(and)3014 6194 w
-10 CW f
-(b)3187 6194 w
-10 R f
-( returning a)2 468( After)1 264(, and the final null string\).)5 1061 3 3247 6194 t
-(match for the)2 532 1 720 6314 t
-10 CW f
-(a)1277 6314 w
-10 R f
-(,)1337 6314 w
-10 CW f
-(sam)1387 6314 w
-10 R f
-(must not match the null string before the)7 1624 1 1592 6314 t
-10 CW f
-(b)3241 6314 w
-10 R f
-( algorithm starts)2 650(. The)1 230 2 3301 6314 t
-10 CW f
-(execute)4206 6314 w
-10 R f
-( end)1 170(at the)1 219 2 4651 6314 t
-( match, and if the match it returns is null and abuts the previous match, rejects the match and)18 3742(of its previous)2 578 2 720 6434 t
-(advances the initial position one character.)5 1702 1 720 6554 t
-10 B f
-(Memory allocation)1 807 1 720 6794 t
-10 R f
-(The C language has no memory allocation primitives, although a standard library routine,)12 3699 1 720 6950 t
-10 CW f
-(malloc)4454 6950 w
-10 R f
-(, pro-)1 226 1 4814 6950 t
-( however, it can be better to write a custom)9 1769( specific uses,)2 569( For)1 195(vides adequate service for simple programs.)5 1787 4 720 7070 t
-( rather, pair of allocators\) described here work in both the terminal and host)13 3190( allocator \(or)2 539(allocator. The)1 591 3 720 7190 t
-(parts of)1 325 1 720 7310 t
-10 CW f
-(sam)1093 7310 w
-10 R f
-( are designed for efficient manipulation of strings, which are allocated and freed)12 3464(. They)1 303 2 1273 7310 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 16 16
-%%Page: 17 17
-/saveobj save def
-mark
-17 pagesetup
-10 R f
-(- 17 -)2 216 1 2772 480 t
-( \(very large strings are written to disc\).)7 1643(frequently and vary in length from essentially zero to 32 Kbytes)10 2677 2 720 840 t
-(More important, strings may be large and change size often, so to minimize memory usage it is helpful to)18 4320 1 720 960 t
-(reclaim and to coalesce the unused portions of strings when they are truncated.)12 3146 1 720 1080 t
-(Objects to be allocated in)4 1023 1 970 1236 t
-10 CW f
-(sam)2020 1236 w
-10 R f
-( the first is C)4 529(are of two flavors:)3 740 2 2227 1236 t
-10 CW f
-(structs)3524 1236 w
-10 R f
-(, which are small and often)5 1096 1 3944 1236 t
-( integers whose base)3 868(addressed by pointer variables; the second is variable-sized arrays of characters or)11 3452 2 720 1356 t
-( memory allocator in)3 841( The)1 207( used to access them.)4 848(pointer is always)2 679 4 720 1476 t
-10 CW f
-(sam)3322 1476 w
-10 R f
-(is therefore in two parts: first, a tradi-)7 1511 1 3529 1476 t
-(tional first-fit allocator that provides fixed storage for)7 2145 1 720 1596 t
-10 CW f
-(structs)2891 1596 w
-10 R f
-( second, a garbage-compacting alloca-)4 1531(; and)1 198 2 3311 1596 t
-( two)1 190( The)1 220( reduces storage overhead for variable-sized objects, at the cost of some bookkeeping.)12 3610(tor that)1 300 4 720 1716 t
-( allocator controlling the)3 997(types of objects are allocated from adjoining arenas, with the garbage-compacting)10 3323 2 720 1836 t
-( prevents fragmentation)2 958( into two arenas simplifies compaction and)6 1739( Separating)1 481(arena with higher addresses.)3 1142 4 720 1956 t
-( garbage-compactable objects \(discussed in the next para-)7 2358( access rules for)3 666( The)1 214(due to immovable objects.)3 1082 4 720 2076 t
-( so when the first-fit arena needs space, it moves the garbage-compacted)11 2936(graph\) allow them to be relocated,)5 1384 2 720 2196 t
-( is therefore created only at successively higher addresses,)8 2340( Storage)1 357( higher addresses to make room.)5 1302(arena to)1 321 4 720 2316 t
-(either when more garbage-compacted space is needed or when the first-fit arena pushes up the other arena.)16 4256 1 720 2436 t
-( the sole reposi-)3 647(Objects that may be compacted declare to the allocator a cell that is guaranteed to be)15 3423 2 970 2592 t
-( then update the)3 668( compactor can)2 633( The)1 217(tory of the address of the object whenever a compaction can occur.)11 2802 4 720 2712 t
-( type)1 199( example, the implementation of)4 1300( For)1 190(address when the object is moved.)5 1375 4 720 2832 t
-10 CW f
-(List)3811 2832 w
-10 R f
-(\(really a variable-length)2 962 1 4078 2832 t
-(array\) is:)1 357 1 720 2952 t
-9 CW f
-(typedef struct List{)2 1080 1 1008 3122 t
-(int nused;)1 1188 1 1440 3232 t
-(long *ptr;)1 1134 1 1440 3342 t
-(}List;)1008 3452 w
-10 R f
-(The)720 3632 w
-10 CW f
-(ptr)910 3632 w
-10 R f
-( a)1 79( When)1 298(cell must always be used directly, and never copied.)8 2159 3 1125 3632 t
-10 CW f
-(List)3696 3632 w
-10 R f
-(is to be created the)4 792 1 3972 3632 t
-10 CW f
-(List)4800 3632 w
-10 R f
-(structure is allocated in the ordinary first-fit arena and its)9 2303 1 720 3752 t
-10 CW f
-(ptr)3051 3752 w
-10 R f
-(is allocated in the garbage-compacted arena.)5 1782 1 3258 3752 t
-(A similar data type for strings, called)6 1520 1 720 3872 t
-10 CW f
-(String)2271 3872 w
-10 R f
-( ele-)1 181(, stores variable-length character arrays of up to 32767)8 2228 2 2631 3872 t
-(ments.)720 3992 w
-( matter of programming style:)4 1227(A related)1 374 2 970 4148 t
-10 CW f
-(sam)2603 4148 w
-10 R f
-(frequently passes structures by value, which simplifies)6 2225 1 2815 4148 t
-( programs have passed structures by reference, but implicit allocation on the)11 3220( C)1 109( Traditionally,)1 614(the code.)1 377 4 720 4268 t
-( passing is a relatively new feature of C \(it is not in the standard reference)15 3036( Structure)1 422( to use.)2 298(stack is easier)2 564 4 720 4388 t
-(manual for C)2 537 1 720 4508 t
-6 R f
-(14)1257 4458 w
-10 R f
-( convenient and expressive,)3 1115( It's)1 187( commercial C compilers.)3 1044(\), and is poorly supported in most)6 1377 4 1317 4508 t
-(though, and simplifies memory management by avoiding the allocator altogether and eliminating pointer)12 4320 1 720 4628 t
-(aliases.)720 4748 w
-10 B f
-(Data structures for manipulating files)4 1610 1 720 4988 t
-10 R f
-(Experience with)1 651 1 720 5144 t
-10 CW f
-(jim)1396 5144 w
-10 R f
-( files)1 198( First,)1 260( requirements of the file data structure were few, but strict.)10 2354(showed that the)2 627 4 1601 5144 t
-( the implementation must)3 1026( Second,)1 371( read and written quickly; adding a fresh file must be painless.)11 2507(need to be)2 416 4 720 5264 t
-( should be practical to edit many files, and)8 1719( \(It)1 147( sizes of files.)3 558(place no arbitrary upper limit on the number or)8 1896 4 720 5384 t
-( implies that files be stored on disc, not)8 1593( This)1 231(files up to megabytes in length should be handled gracefully.\))9 2496 3 720 5504 t
-( of virtual memory may argue otherwise, but the implementation of virtual)11 3046( \(Aficionados)1 577( memory.)1 389(in main)1 308 4 720 5624 t
-( changes to files need)4 879( Third,)1 302( system is not something to depend on for good performance.\))10 2533(memory in our)2 606 4 720 5744 t
-( are inverses of each other, which simplifies)7 1785( These)1 292( only two primitives: deletion and insertion.)6 1777(be made by)2 466 4 720 5864 t
-( the file, either)3 609( it must be easy and efficient to access)8 1610( Finally,)1 369(the implementation of the undo operation.)5 1732 4 720 5984 t
-(forwards or backwards, a byte at a time.)7 1598 1 720 6104 t
-(The)970 6260 w
-10 CW f
-(File)1157 6260 w
-10 R f
-( characters.)1 461(data type is constructed from three simpler data structures that hold arrays of)12 3150 2 1429 6260 t
-( has an insertion and deletion operator, and the insertion and deletion operators of the)14 3520(Each of these types)3 800 2 720 6380 t
-10 CW f
-(File)720 6500 w
-10 R f
-(type itself are constructed from them.)5 1497 1 985 6500 t
-(The simplest type is the)4 950 1 970 6656 t
-10 CW f
-(String)1945 6656 w
-10 R f
-( code that man-)3 621( The)1 206( hold strings in main memory.)5 1211(, which is used to)4 697 4 2305 6656 t
-(ages)720 6776 w
-10 CW f
-(Strings)926 6776 w
-10 R f
-( some moderate size, and in practice they are)8 1816(guarantees that they will never be longer than)7 1849 2 1375 6776 t
-(rarely larger than 8 Kbytes.)4 1098 1 720 6896 t
-10 CW f
-(Strings)1869 6896 w
-10 R f
-( little)1 211(have two purposes: they hold short strings like file names with)10 2514 2 2315 6896 t
-( are therefore used as)4 862( They)1 259( efficient to modify.)3 811(overhead, and because they are deliberately small, they are)8 2388 4 720 7016 t
-(the data structure for in-memory caches.)5 1612 1 720 7136 t
-(The disc copy of the file is managed by a data structure called a)13 2749 1 970 7292 t
-10 CW f
-(Disc)3760 7292 w
-10 R f
-( corresponds to a)3 730(, which)1 310 2 4000 7292 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 17 17
-%%Page: 18 18
-/saveobj save def
-mark
-18 pagesetup
-10 R f
-(- 18 -)2 216 1 2772 480 t
-( A)1 133(temporary file.)1 604 2 720 840 t
-10 CW f
-(Disc)1493 840 w
-10 R f
-( storage in main memory other than bookkeeping information; the actual)10 3002(has no)1 269 2 1769 840 t
-( reduce the number of open files needed,)7 1665( To)1 167(data being held is all on the disc.)7 1352 3 720 960 t
-10 CW f
-(sam)3935 960 w
-10 R f
-(opens a dozen tempo-)3 894 1 4146 960 t
-(rary Unix files and multiplexes the)5 1395 1 720 1080 t
-10 CW f
-(Discs)2141 1080 w
-10 R f
-( many files to be edited; the entire)7 1362( permits)1 326( This)1 229(upon them.)1 451 4 2467 1080 t
-10 CW f
-(sam)4860 1080 w
-10 R f
-(source \(48 files\) may be edited comfortably with a single instance of)11 2819 1 720 1200 t
-10 CW f
-(sam)3571 1200 w
-10 R f
-( temporary file)2 609( one)1 176(. Allocating)1 504 3 3751 1200 t
-(per)720 1320 w
-10 CW f
-(Disc)874 1320 w
-10 R f
-( spreading the traffic)3 831( Also,)1 265( on the number of open files.)6 1157(would strain the operating system's limit)5 1646 4 1141 1320 t
-(among temporary files keeps the files shorter, and shorter files are more efficiently implemented by the)15 4320 1 720 1440 t
-(Unix I/O subsystem.)2 825 1 720 1560 t
-(A)970 1716 w
-10 CW f
-(Disc)1070 1716 w
-10 R f
-( between 1 and 4096 characters of)6 1386(is an array of fixed-length blocks, each of which contains)9 2316 2 1338 1716 t
-( block addresses within the tempo-)5 1400( The)1 207( file system is 4096 bytes.\))5 1082( block size of our Unix)5 933( \(The)1 241(active data.)1 457 6 720 1836 t
-( stored in a)3 450(rary file and the length of each block are)8 1633 2 720 1956 t
-10 CW f
-(List)2831 1956 w
-10 R f
-( changes are made the live part of blocks)8 1653(. When)1 316 2 3071 1956 t
-( to keep the sizes between 2048)6 1300( are created and coalesced when necessary to try)8 1987( Blocks)1 335(may change size.)2 698 4 720 2076 t
-( actively changing part of the)5 1172( An)1 173(and 4096 bytes.)2 632 3 720 2196 t
-10 CW f
-(Disc)2723 2196 w
-10 R f
-( has about a kilobyte of slop that)7 1316(therefore typically)1 735 2 2989 2196 t
-( an)1 130( When)1 299( inserted or deleted without changing more than one block or affecting the block order.)14 3622(can be)1 269 4 720 2316 t
-( one is allocated to receive the overflow, and the)9 1970(insertion would overflow a block, the block is split, a new)10 2350 2 720 2436 t
-(memory-resident list of blocks is rearranged to reflect the insertion of the new block.)13 3388 1 720 2556 t
-( data)1 200( The)1 214( modification to the file is prohibitively expensive.)7 2090(Obviously, going to the disc for every)6 1566 4 970 2712 t
-(type)720 2832 w
-10 CW f
-(Buffer)921 2832 w
-10 R f
-(consists of a)2 502 1 1310 2832 t
-10 CW f
-(Disc)1841 2832 w
-10 R f
-(to hold the data and a)5 872 1 2109 2832 t
-10 CW f
-(String)3009 2832 w
-10 R f
-( is the first of a)5 617( This)1 231(that acts as a cache.)4 795 3 3397 2832 t
-( throughout the data structures in)5 1378(series of caches)2 647 2 720 2952 t
-10 CW f
-(sam.)2782 2952 w
-10 R f
-(The caches not only improve performance, they)6 1981 1 3059 2952 t
-( the flow of data, particularly in the communication between the host and termi-)13 3260(provide a way to organize)4 1060 2 720 3072 t
-( idea is developed below, in the section on communications.)9 2406(nal. This)1 375 2 720 3192 t
-( traffic, changes to a)4 855(To reduce disc)2 607 2 970 3348 t
-10 CW f
-(Buffer)2468 3348 w
-10 R f
-(are mediated by a variable-length string, in memory,)7 2176 1 2864 3348 t
-( an insertion or deletion is made to a)8 1502( When)1 294(that acts as a cache.)4 807 3 720 3468 t
-10 CW f
-(Buffer)3354 3468 w
-10 R f
-( can be accommo-)3 743(, if the change)3 583 2 3714 3468 t
-( cache becomes bigger than a block because of an insertion, some)11 2643( the)1 148( If)1 117(dated by the cache, it is done there.)7 1412 4 720 3588 t
-( written to the)3 558(of it is)2 258 2 720 3708 t
-10 CW f
-(Disc)1561 3708 w
-10 R f
-( the change does not intersect the cache, the cache)9 1999( If)1 116(and deleted from the cache.)4 1099 3 1826 3708 t
-( the new position if the change is smaller than a block; otherwise, it)13 2749( cache is only loaded at)5 949( The)1 208(is flushed.)1 414 4 720 3828 t
-( the)1 158(is sent directly to)3 722 2 720 3948 t
-10 CW f
-(Disc)1636 3948 w
-10 R f
-( is because large changes are typically sequential, whereupon the next)10 2900(. This)1 264 2 1876 3948 t
-(change is unlikely to overlap the current one.)7 1802 1 720 4068 t
-(A)970 4224 w
-10 CW f
-(File)1067 4224 w
-10 R f
-(comprises a)1 474 1 1332 4224 t
-10 CW f
-(String)1831 4224 w
-10 R f
-( such as dot and the mod-)6 1027(to hold the file name and some ancillary data)8 1797 2 2216 4224 t
-( most important components, though, are a pair of)8 2006( The)1 206(ified bit.)1 340 3 720 4344 t
-10 CW f
-(Buffers)3298 4344 w
-10 R f
-(, one called the transcript and the)6 1322 1 3718 4344 t
-( use is described in the next section.)7 1437( Their)1 266(other the contents.)2 735 3 720 4464 t
-( times)1 243( it may seem that the data is touched many)9 1701( Although)1 428(The overall structure is shown in Figure 5.)7 1698 4 970 4620 t
-(on its way from the)4 825 1 720 4740 t
-10 CW f
-(Disc)1582 4740 w
-10 R f
-( \(by one Unix system call\) directly into the cache of the associated)12 2788(, it is read)3 430 2 1822 4740 t
-10 CW f
-(Buffer)720 4860 w
-10 R f
-( the cache, the text is written directly from the)9 1922( when flushing)2 610( Similarly,)1 456(; no extra copy is done.)5 972 4 1080 4860 t
-( principle applied throughout)3 1172( A)1 125( operations act directly on the text in the cache.)9 1912( Most)1 260(cache to disc.)2 548 5 720 4980 t
-10 CW f
-(sam)4765 4980 w
-10 R f
-(is)4973 4980 w
-(that the fewer times the data is copied, the faster the program will run \(see also the paper by Waite)19 3930 1 720 5100 t
-6 R f
-(15)4650 5050 w
-10 R f
-(\).)4710 5100 w
-cleartomark
-saveobj restore
-%%BeginGlobal
-%
-% Version 3.3.2 drawing procedures for dpost. Automatically pulled in when
-% needed.
-%
-
-/inpath false def
-/savematrix matrix def
-
-/Dl {
- inpath
- {pop pop neg lineto}
- {newpath neg moveto neg lineto stroke}
- ifelse
-} bind def
-
-/De {
- /y1 exch 2 div def
- /x1 exch 2 div def
- /savematrix savematrix currentmatrix def
- neg exch x1 add exch translate
- x1 y1 scale
- 0 0 1 0 360
- inpath
- {1 0 moveto arc savematrix setmatrix}
- {newpath arc savematrix setmatrix stroke}
- ifelse
-} bind def
-
-/Da {
- /dy2 exch def
- /dx2 exch def
- /dy1 exch def
- /dx1 exch def
- dy1 add neg exch dx1 add exch
- dx1 dx1 mul dy1 dy1 mul add sqrt
- dy1 dx1 neg atan
- dy2 neg dx2 atan
- inpath
- {arc}
- {newpath arc stroke}
- ifelse
-} bind def
-
-/DA {
- /dy2 exch def
- /dx2 exch def
- /dy1 exch def
- /dx1 exch def
- dy1 add neg exch dx1 add exch
- dx1 dx1 mul dy1 dy1 mul add sqrt
- dy1 dx1 neg atan
- dy2 neg dx2 atan
- inpath
- {arcn}
- {newpath arcn stroke}
- ifelse
-} bind def
-
-/Ds {
- /y2 exch def
- /x2 exch def
- /y1 exch def
- /x1 exch def
- /y0 exch def
- /x0 exch def
- x0 5 x1 mul add 6 div
- y0 5 y1 mul add -6 div
- x2 5 x1 mul add 6 div
- y2 5 y1 mul add -6 div
- x1 x2 add 2 div
- y1 y2 add -2 div
- inpath
- {curveto}
- {newpath x0 x1 add 2 div y0 y1 add -2 div moveto curveto stroke}
- ifelse
-} bind def
-%%EndGlobal
-/saveobj save def
-mark
-10 R f
-2966 6183 2966 6471 Dl
-3599 6183 2966 6183 Dl
-3600 6471 3600 6183 Dl
-2967 6471 3600 6471 Dl
-10 CW f
-(Disc)3163 6347 w
-2966 6586 2966 6874 Dl
-3599 6586 2966 6586 Dl
-3600 6874 3600 6586 Dl
-2967 6874 3600 6874 Dl
-10 R f
-(temp. file)1 383 1 3092 6750 t
-3283 6471 3283 6586 Dl
-1642 6183 1642 6471 Dl
-2275 6183 1642 6183 Dl
-2275 6471 2275 6183 Dl
-1642 6471 2275 6471 Dl
-10 CW f
-(Disc)1838 6347 w
-1642 6586 1642 6874 Dl
-2275 6586 1642 6586 Dl
-2275 6874 2275 6586 Dl
-1642 6874 2275 6874 Dl
-10 R f
-(temp. file)1 383 1 1767 6750 t
-1958 6471 1958 6586 Dl
-1642 5722 1642 6010 Dl
-2275 5722 1642 5722 Dl
-2275 6010 2275 5722 Dl
-1642 6010 2275 6010 Dl
-10 CW f
-(Buffer)1778 5826 w
-10 R f
-(\(transcript\))1737 5946 w
-2390 5722 2390 6010 Dl
-2793 5722 2390 5722 Dl
-2794 6010 2794 5722 Dl
-2391 6010 2794 6010 Dl
-10 CW f
-(String)2412 5826 w
-10 R f
-(\(cache\))2446 5946 w
-2275 5866 2390 5866 Dl
-2966 5722 2966 6010 Dl
-3599 5722 2966 5722 Dl
-3600 6010 3600 5722 Dl
-2967 6010 3600 6010 Dl
-10 CW f
-(Buffer)3103 5826 w
-10 R f
-(\(contents\))3084 5946 w
-3715 5722 3715 6010 Dl
-4118 5722 3715 5722 Dl
-4118 6010 4118 5722 Dl
-3715 6010 4118 6010 Dl
-10 CW f
-(String)3737 5826 w
-10 R f
-(\(cache\))3771 5946 w
-3600 5866 3715 5866 Dl
-2182 5262 2182 5550 Dl
-2988 5262 2182 5262 Dl
-2988 5550 2988 5262 Dl
-2182 5550 2988 5550 Dl
-10 CW f
-(File)2465 5426 w
-1958 6011 1958 6183 Dl
-3283 6011 3283 6183 Dl
-1958 5636 1958 5722 Dl
-2318 5636 1958 5636 Dl
-2318 5550 2318 5636 Dl
-3283 5636 3283 5722 Dl
-2851 5636 3283 5636 Dl
-2851 5550 2851 5636 Dl
-8 I f
-( temporary files are stored in the standard repository for such files on the host system.)15 2752( The)1 160(Figure 5. File data structures.)4 965 3 720 7052 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 18 18
-%%Page: 19 19
-/saveobj save def
-mark
-19 pagesetup
-10 R f
-(- 19 -)2 216 1 2772 480 t
-( a)1 73(The contents of)2 627 2 970 840 t
-10 CW f
-(File)1699 840 w
-10 R f
-(are accessed by a routine that copies to a buffer a substring of a file starting)15 3072 1 1968 840 t
-( read a byte at a time, a per-)8 1166( To)1 168(at a specified offset.)3 824 3 720 960 t
-10 CW f
-(File)2878 960 w
-10 R f
-( a specified initial)3 731(array is loaded starting from)4 1159 2 3150 960 t
-( implementation is done by a macro similar to the)9 2012( The)1 208(position, and bytes may then be read from the array.)9 2100 3 720 1080 t
-(C standard I/O)2 616 1 720 1200 t
-10 CW f
-(getc)1375 1200 w
-10 R f
-(macro.)1654 1200 w
-6 R f
-(14)1928 1150 w
-10 R f
-( reading may be done at any address, a minor change to the)12 2520(Because the)1 493 2 2027 1200 t
-( array is read-only; there is no)6 1197( This)1 228(macro allows the file to be read backwards.)7 1734 3 720 1320 t
-10 CW f
-(putc)3904 1320 w
-10 R f
-(.)4144 1320 w
-10 B f
-(Doing and undoing)2 820 1 720 1560 t
-10 CW f
-(Sam)720 1716 w
-10 R f
-( command language makes it easy to spec-)7 1733( The)1 209( to files.)2 333(has an unusual method for managing changes)6 1837 4 928 1716 t
-( variable-length changes to a file millions of bytes long, and such changes must be made effi-)16 3842(ify multiple)1 478 2 720 1836 t
-( usual techniques for inserting and deleting strings are inadequate)9 2633( The)1 207( to be practical.)3 621(ciently if the editor is)4 859 4 720 1956 t
-( The)1 207(under these conditions.)2 930 2 720 2076 t
-10 CW f
-(Buffer)1884 2076 w
-10 R f
-(and)2271 2076 w
-10 CW f
-(Disc)2442 2076 w
-10 R f
-(data structures are designed for efficient random access to)8 2331 1 2709 2076 t
-( be taken to avoid super-linear behavior when making many changes simultane-)11 3246(long strings, but care must)4 1074 2 720 2196 t
-(ously.)720 2316 w
-10 CW f
-(Sam)970 2472 w
-10 R f
-(uses a two-pass algorithm for making changes, and treats each file as a database against which)15 3859 1 1181 2472 t
-( when a command is)4 865( Instead,)1 374( the contents.)2 552( are not made directly to)5 1033( Changes)1 406(transactions are registered.)2 1090 6 720 2592 t
-(started, a `mark' containing a sequence number is placed in the transcript)11 2965 1 720 2712 t
-10 CW f
-(Buffer)3714 2712 w
-10 R f
-( made)1 246(, and each change)3 720 2 4074 2712 t
-( name, is appended to the end of the tran-)9 1715(to the file, either an insertion or deletion or a change to the file)13 2605 2 720 2832 t
-( the command is complete, the transcript is rewound to the mark and applied to the contents.)16 3690(script. When)1 535 2 720 2952 t
-( is to simplify tracking the)5 1198(One reason for separating evaluation from application in this way)9 2872 2 970 3108 t
-( two-pass algorithm also allows all)5 1481( The)1 224(addresses of changes made in the middle of a long sequence.)10 2615 3 720 3228 t
-(changes to apply to the)4 965 1 720 3348 t
-10 I f
-(original)1721 3348 w
-10 R f
-( the same command.)3 857(data: no change can affect another change made in)8 2103 2 2080 3348 t
-( evaluating an)2 606(This is particularly important when)4 1506 2 720 3468 t
-10 CW f
-(x)2880 3468 w
-10 R f
-(command because it prevents regular expression)5 2052 1 2988 3468 t
-( is)1 114( the two-pass algorithm)3 1004( Also,)1 285(matches from stumbling over changes made earlier in the execution.)9 2917 4 720 3588 t
-( to affect each other; for example,)6 1366(cleaner than the way other Unix editors allow changes)8 2199 2 720 3708 t
-10 CW f
-(ed)4313 3708 w
-10 R f
-('s idioms to do)3 607 1 4433 3708 t
-( Instead,)1 364( on the implementation.)3 953(things like delete every other line depend critically)7 2027 3 720 3828 t
-10 CW f
-(sam)4090 3828 w
-10 R f
-('s simple model, in)3 770 1 4270 3828 t
-(which all changes in a command occur effectively simultaneously, is easy to explain and to understand.)15 4135 1 720 3948 t
-( substring from locations 123 to 456'' and)7 1825(The records in the transcript are of the form ``delete)9 2245 2 970 4104 t
-( changes are not at monotonically)5 1370( is an error if the)5 692( \(It)1 150(``insert 11 characters `hello there' at location 789.'')7 2108 4 720 4224 t
-( the update is occurring, these numbers must be offset by earlier)11 2633( While)1 301(greater positions through the file.\))4 1386 3 720 4344 t
-( to the update routine; moreover, all the numbers have been)10 2466(changes, but that is straightforward and local)6 1854 2 720 4464 t
-(computed before the first is examined.)5 1536 1 720 4584 t
-( it takes is to)4 566( All)1 193(Treating the file as a transaction system has another advantage: undo is trivial.)12 3311 3 970 4740 t
-( deletions and vice versa, and)5 1200(invert the transcript after it has been implemented, converting insertions into)10 3120 2 720 4860 t
-(saving them in a holding)4 989 1 720 4980 t
-10 CW f
-(Buffer)1734 4980 w
-10 R f
-( can then be deleted from the transcript)7 1567( `do' transcript)2 593(. The)1 230 3 2094 4980 t
-10 CW f
-(Buffer)4510 4980 w
-10 R f
-(and)4896 4980 w
-( an undo is requested, the transcript is rewound and the undo transcript)12 2862( If)1 119(replaced by the `undo' transcript.)4 1339 3 720 5100 t
-( the transcript)2 561(executed. Because)1 767 2 720 5220 t
-10 CW f
-(Buffer)2079 5220 w
-10 R f
-( it accumulates successive)3 1066(is not truncated after each command,)5 1504 2 2470 5220 t
-( can therefore back up the file arbitrarily, which is more helpful)11 2626( sequence of undo commands)4 1217(changes. A)1 477 3 720 5340 t
-( \()1 87( form of undo.)3 589(than the more commonly implemented self-inverse)5 2054 3 720 5460 t
-10 CW f
-(Sam)3450 5460 w
-10 R f
-(provides no way to undo an undo,)6 1381 1 3659 5460 t
-( mark in the)3 495( Each)1 254( re-interpreting the `do' transcript.\))4 1419(but if it were desired, it would be easy to provide by)11 2152 4 720 5580 t
-( offset into the transcript of the previous mark, to aid in)11 2390(transcript contains a sequence number and the)6 1930 2 720 5700 t
-( also contain the value of dot and the modified bit so these can be restored)15 3004( Marks)1 308(unwinding the transcript.)2 1008 3 720 5820 t
-( merely demands undoing all files whose latest change has the)10 2625( multiple files is easy; it)5 1024(easily. Undoing)1 671 3 720 5940 t
-(same sequence number as the current file.)6 1670 1 720 6060 t
-( encountered in the middle of a complicated com-)8 2017(Another benefit of having a transcript is that errors)8 2053 2 970 6216 t
-( rewinding the transcript to the mark beginning)7 1933( By)1 174( files in an intermediate state.)5 1211(mand need not leave the)4 1002 4 720 6336 t
-(the command, the partial command can be trivially undone.)8 2380 1 720 6456 t
-( implemented, it was unacceptably slow, so a cache was added to)11 2614(When the update algorithm was first)5 1456 2 970 6612 t
-( reduced the number)3 820( This)1 229( small changes by a single larger one.)7 1504(coalesce nearby changes, replacing multiple)4 1767 4 720 6732 t
-(of insertions into the transaction)4 1308 1 720 6852 t
-10 CW f
-(Buffer)2058 6852 w
-10 R f
-( in performance, but made it)5 1161(, and made a dramatic improvement)5 1461 2 2418 6852 t
-( the caching method only works if changes)7 1718(impossible to handle changes in non-monotonic order in the file;)9 2602 2 720 6972 t
-( cache was added, the transaction could in principle be sorted if the changes were)14 3286( the)1 149( Before)1 323(don't overlap.)1 562 4 720 7092 t
-( therefore acceptable performance with a)5 1664( current status is)3 676( The)1 213(out of order, although this was never done.)7 1767 4 720 7212 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 19 19
-%%Page: 20 20
-/saveobj save def
-mark
-20 pagesetup
-10 R f
-(- 20 -)2 216 1 2772 480 t
-(minor restriction on global changes, which is sometimes, but rarely, an annoyance.)11 3309 1 720 840 t
-( simpler algorithms, but it is not pro-)7 1627(The update algorithm obviously paws the data more than)8 2443 2 970 996 t
-( principle of avoiding copying the data is still honored here,)10 2519( \(The)1 251( help.)1 235(hibitively expensive; the caches)3 1315 4 720 1116 t
-( through)1 343(although not as piously: the data is moved from contents' cache to the transcript's all at once and)17 3977 2 720 1236 t
-( dead start a hundred)4 839( read from a)3 493( To)1 164( figures confirm the efficiency.)4 1250( Performance)1 562(only one internal buffer.\))3 1012 6 720 1356 t
-( a VAX-11/750 takes 1.4 seconds of user time, 2.5 seconds of system time, and 5 seconds of)17 3709(kilobyte file on)2 611 2 720 1476 t
-( the same file in)4 670( Reading)1 391(real time.)1 385 3 720 1596 t
-10 CW f
-(ed)2199 1596 w
-10 R f
-( of system time, and 8)5 918(takes 6.0 seconds of user time, 1.7 seconds)7 1770 2 2352 1596 t
-(seconds of real time.)3 862 1 720 1716 t
-10 CW f
-(Sam)1644 1716 w
-10 R f
-( stated)1 271( more interesting example is the one)6 1520( A)1 134(uses about half the CPU time.)5 1254 4 1861 1716 t
-( The)1 205(above: inserting a character between every pair of characters in the file.)11 2851 2 720 1836 t
-10 CW f
-(sam)3801 1836 w
-10 R f
-(command is)1 486 1 4006 1836 t
-9 CW f
-(,y/@/ a/x/)1 540 1 1008 2006 t
-10 R f
-( 3 CPU seconds per kilobyte of input file, of which about a third is spent in the regular expression)19 3945(and takes)1 375 2 720 2186 t
-( translates to about 500 changes per second.)7 1759(code. This)1 442 2 720 2306 t
-10 CW f
-(Ed)2972 2306 w
-10 R f
-( make a similar)3 613(takes 1.5 seconds per kilobyte to)5 1309 2 3118 2306 t
-( same example in)3 702( The)1 207(change \(ignoring newlines\), but cannot undo it.)6 1898 3 720 2426 t
-10 CW f
-(ex)3554 2426 w
-10 R f
-(,)3674 2426 w
-6 R f
-(9)3699 2376 w
-10 R f
-(a variant of)2 458 1 3756 2426 t
-10 CW f
-(ed)4241 2426 w
-10 R f
-(done at the Uni-)3 652 1 4388 2426 t
-( summary,)1 428( In)1 139( takes 3 seconds.)3 689(versity of California at Berkeley, which allows one level of undoing, again)11 3064 4 720 2546 t
-10 CW f
-(sam)720 2666 w
-10 R f
-('s performance is comparable to that of other Unix editors, although it solves a harder problem.)15 3807 1 900 2666 t
-10 B f
-(Communications)720 2906 w
-10 R f
-(The discussion so far has described the implementation of the host part of)12 3138 1 720 3062 t
-10 CW f
-(sam)3899 3062 w
-10 R f
-(; the next few sections)4 961 1 4079 3062 t
-( machine with mouse and bitmap display can be engaged to improve interaction.)12 3263(explain how a)2 570 2 720 3182 t
-10 CW f
-(Sam)4607 3182 w
-10 R f
-(is not)1 224 1 4816 3182 t
-(the first editor to be written as two processes,)8 1811 1 720 3302 t
-6 R f
-(16)2531 3252 w
-10 R f
-(but its implementation has some unusual aspects.)6 1969 1 2616 3302 t
-(There are several ways)3 924 1 970 3458 t
-10 CW f
-(sam)1922 3458 w
-10 R f
-( first and simplest is to)5 929( The)1 208('s host and terminal parts may be connected.)7 1801 3 2102 3458 t
-( This)1 229( command language to edit text on an ordinary terminal.)9 2256(forgo the terminal part and use the host part's)8 1835 3 720 3578 t
-(mode is invoked by starting)4 1111 1 720 3698 t
-10 CW f
-(sam)1856 3698 w
-10 R f
-(with the)1 325 1 2061 3698 t
-10 CW f
-(-d)2412 3698 w
-10 R f
-( no options,)2 472(option. With)1 532 2 2558 3698 t
-10 CW f
-(sam)3588 3698 w
-10 R f
-(runs separate host and terminal)4 1246 1 3794 3698 t
-( Typically,)1 458( over the physical connection that joins them.)7 1815(programs, communicating with a message protocol)5 2047 3 720 3818 t
-( display for)2 469(the connection is an RS-232 link between a Blit \(the prototypical)10 2658 2 720 3938 t
-10 CW f
-(sam)3879 3938 w
-10 R f
-(\) and a host running the)5 981 1 4059 3938 t
-(Ninth Edition of the Unix operating system.)6 1782 1 720 4058 t
-6 R f
-(8)2502 4008 w
-10 R f
-(\(This is the version of the system used in the Computing Sci-)11 2480 1 2560 4058 t
-( are discussed in the)4 828( relevant aspects)2 669( Its)1 155(ences Research Center at AT&T Bell Laboratories, where I work.)9 2668 4 720 4178 t
-(Blit paper.)1 432 1 720 4298 t
-6 R f
-(1)1152 4248 w
-10 R f
-( implementation of)2 779(\) The)1 223 2 1182 4298 t
-10 CW f
-(sam)2218 4298 w
-10 R f
-(for the Sun computer runs both processes on the same machine)10 2608 1 2432 4298 t
-(and connects them by a pipe.)5 1159 1 720 4418 t
-( division)1 351( The)1 208( of an RS-232 link necessitated the split between the two programs.)11 2730(The low bandwidth)2 781 4 970 4574 t
-( a self-contained one,)3 859(is a mixed blessing: a program in two parts is much harder to write and to debug than)17 3461 2 720 4694 t
-( terminal may be physically separated from)6 1736( The)1 206( configurations possible.)2 982(but the split makes several unusual)5 1396 4 720 4814 t
-( to be taken home while leaving the files)8 1628(the host, allowing the conveniences of a mouse and bitmap display)10 2692 2 720 4934 t
-( is also possible to run the host part on a remote machine:)12 2298( It)1 111(at work.)1 327 3 720 5054 t
-9 CW f
-(sam -r host)2 594 1 1008 5224 t
-10 R f
-( the network to establish the host part)7 1503(connects to the terminal in the usual way, and then makes a call across)13 2817 2 720 5404 t
-(of)720 5524 w
-10 CW f
-(sam)831 5524 w
-10 R f
-( allows)1 288( This)1 230( parts.)1 246( it cross-connects the I/O to join the two)8 1628( Finally,)1 362(on the named machine.)3 935 6 1039 5524 t
-10 CW f
-(sam)4755 5524 w
-10 R f
-(to)4962 5524 w
-(be run on machines that do not support bitmap displays; for example,)11 2869 1 720 5644 t
-10 CW f
-(sam)3623 5644 w
-10 R f
-( our)1 168(is the editor of choice on)5 1035 2 3837 5644 t
-(Cray X-MP/24.)1 632 1 720 5764 t
-10 CW f
-(Sam -r)1 334 1 1412 5764 t
-10 R f
-(involves)1780 5764 w
-10 I f
-(three)2153 5764 w
-10 R f
-( The)1 214(machines: the remote host, the terminal, and the local host.)9 2434 2 2392 5764 t
-(local host's job is simple but vital: it passes the data between the remote host and terminal.)16 3628 1 720 5884 t
-( exchange messages asynchronously \(rather than, say, as remote procedure)9 3145(The host and terminal)3 925 2 970 6040 t
-( correction because, whatever the configuration, the connection is)8 2709(calls\) but there is no error detection or)7 1611 2 720 6160 t
-( mundane interaction tasks such as popping up menus and interpret-)10 2763( the terminal handles)3 847(reliable. Because)1 710 3 720 6280 t
-( example, the host knows nothing about)6 1657( For)1 200( not actions.)2 508(ing the responses, the messages are about data,)7 1955 4 720 6400 t
-( says)1 211(what is displayed on the screen, and when the user types a character, the message sent to the host)18 4109 2 720 6520 t
-( position in the)3 601(``insert a one-byte string at location 123 in file 7,'' not ``a character was typed at the current)17 3719 2 720 6640 t
-( other words, the messages look very much like the transaction records in the transcripts.)14 3544( In)1 133(current file.'')1 531 3 720 6760 t
-( host or terminal part of)5 961(Either the)1 393 2 970 6916 t
-10 CW f
-(sam)2352 6916 w
-10 R f
-( command language oper-)3 1048( The)1 208(may initiate a change to a file.)6 1224 3 2560 6916 t
-( mouse operations are executed directly in the terminal to optimize)10 2708(ates on the host, while typing and some)7 1612 2 720 7036 t
-( \(A)1 165( the terminal, and vice versa.)5 1200( initiated by the host program must be transmitted to)9 2178(response. Changes)1 777 4 720 7156 t
-( which means that characters typed while a time-)8 1999(token is exchanged to determine which end is in control,)9 2321 2 720 7276 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 20 20
-%%Page: 21 21
-/saveobj save def
-mark
-21 pagesetup
-10 R f
-(- 21 -)2 216 1 2772 480 t
-( main-)1 264( To)1 167( buffered and do not appear until the command is complete.\))10 2475(consuming command runs must be)4 1414 4 720 840 t
-( track changes through a per-file data structure that records)9 2351(tain consistent information, the host and terminal)6 1969 2 720 960 t
-( data structure, called a)4 954( The)1 213(what portions of the file the terminal has received.)8 2074 3 720 1080 t
-10 CW f
-(Rasp)3994 1080 w
-10 R f
-(\(a weak pun: it's a)4 773 1 4267 1080 t
-( A)1 128(file with holes\) is held and updated by both the host and terminal.)12 2695 2 720 1200 t
-10 CW f
-(Rasp)3574 1200 w
-10 R f
-( of)1 113(is a list)2 296 2 3845 1200 t
-10 CW f
-(Strings)4284 1200 w
-10 R f
-(holding)4734 1200 w
-( number of bytes in the interstices.)6 1415(those parts of the file known to the terminal, separated by counts of the)13 2905 2 720 1320 t
-( needs the lengths of the various pieces\),)7 1619(Of course, the host doesn't keep a separate copy of the data \(it only)13 2701 2 720 1440 t
-(but the structure is the same on both ends.)8 1679 1 720 1560 t
-(The)970 1716 w
-10 CW f
-(Rasp)1158 1716 w
-10 R f
-( the terminal keeps the text for portions of the)9 1909( Since)1 280(in the terminal doubles as a cache.)6 1420 3 1431 1716 t
-(file it has displayed, it need not request data from the host when revisiting old parts of the file or redrawing)20 4320 1 720 1836 t
-(obscured windows, which speeds things up considerably over low-speed links.)9 3143 1 720 1956 t
-(It's trivial for the terminal to maintain its)7 1683 1 970 2112 t
-10 CW f
-(Rasp)2684 2112 w
-10 R f
-( on the terminal apply to)5 1015(, because all changes made)4 1101 2 2924 2112 t
-( made by the host are compared against the)8 1740( Changes)1 396( already loaded there.)3 864(parts of the file)3 616 4 720 2232 t
-10 CW f
-(Rasp)4363 2232 w
-10 R f
-(during the)1 410 1 4630 2232 t
-( changes to pieces of the file loaded in the terminal are sent in)13 2509( Small)1 287( each command.)2 657(update sequence after)2 867 4 720 2352 t
-( in the holes, are transmitted as messages with-)8 1894( changes, and changes that fall entirely)6 1567( Larger)1 318(their entirety.)1 541 4 720 2472 t
-( a command is)3 610( When)1 298( the lengths of the deleted and inserted strings are transmitted.)10 2577(out literal data: only)3 835 4 720 2592 t
-( in their)2 319(completed, the terminal examines its visible windows to see if any holes)11 2947 2 720 2712 t
-10 CW f
-(Rasps)4015 2712 w
-10 R f
-(intersect the visi-)2 696 1 4344 2712 t
-( 512 bytes of sur-)4 731( then requests the missing data from the host, along with up to)12 2569( It)1 118(ble portion of the file.)4 902 4 720 2832 t
-( technique)1 414( This)1 229( the file.)2 332(rounding data, to minimize the number of messages when visiting a new portion of)13 3345 4 720 2952 t
-( first level sends a minimum of informa-)7 1646( The)1 209(provides a kind of two-level lazy evaluation for the terminal.)9 2465 3 720 3072 t
-( the file not being edited interactively; the second level waits until a change is displayed)15 3575(tion about parts of)3 745 2 720 3192 t
-( is also helped by having the terminal respond)8 1933( course, performance)2 860( Of)1 166(before transmitting the new data.)4 1361 4 720 3312 t
-( for small changes to active pieces of the file,)9 1906( Except)1 338( and simple mouse requests.)4 1168(immediately to typing)2 908 4 720 3432 t
-(which are transmitted to the terminal without negotiation, the terminal is wholly responsible for deciding)14 4320 1 720 3552 t
-(what is displayed; the host uses the)6 1405 1 720 3672 t
-10 CW f
-(Rasp)2150 3672 w
-10 R f
-(only to tell the terminal what might be relevant.)8 1907 1 2415 3672 t
-( host, the messages to the terminal describing the change are gener-)11 2727(When a change is initiated by the)6 1343 2 970 3828 t
-( the transcript of the changes to the contents of the)10 2023(ated by the routine that applies)5 1239 2 720 3948 t
-10 CW f
-(File)4008 3948 w
-10 R f
-( changes are)2 494(. Since)1 298 2 4248 3948 t
-( no extra code in the communications; the usual mes-)9 2173(undone by the same update routine, undoing requires)7 2147 2 720 4068 t
-(sages describing changes to the file are sufficient to back up the screen image.)13 3120 1 720 4188 t
-(The)970 4344 w
-10 CW f
-(Rasp)1164 4344 w
-10 R f
-(is a particularly good example of the way caches are used in)11 2556 1 1443 4344 t
-10 CW f
-(sam)4038 4344 w
-10 R f
-( it facilitates)2 524(. First,)1 298 2 4218 4344 t
-( so doing, it provides)4 870( In)1 140( portion of the text by placing the busy text in main memory.)12 2519(access to the active)3 791 4 720 4464 t
-( be)1 138( the form of data is to)6 968( Since)1 290(efficient access to a large data structure that does not fit in memory.)12 2924 4 720 4584 t
-( characters will frequently be scanned sequentially,)6 2090(imposed by the user, not by the program, and because)9 2230 2 720 4704 t
-( help keep performance good and linear when working with such)10 2724( Caches)1 350(files are stored as flat objects.)5 1246 3 720 4824 t
-(data.)720 4944 w
-(Second, the)1 468 1 970 5100 t
-10 CW f
-(Rasp)1465 5100 w
-10 R f
-(and several of the other caches have some)7 1696 1 1732 5100 t
-10 I f
-(read-ahead;)3456 5100 w
-10 R f
-(that is, the cache is loaded)5 1063 1 3977 5100 t
-( manipulating linear struc-)3 1090( When)1 299( than is needed for the job immediately at hand.)9 2002(with more information)2 929 4 720 5220 t
-( time to access)3 588(tures, the accesses are usually sequential, and read-ahead can significantly reduce the average)12 3732 2 720 5340 t
-( mode for people as well as programs; con-)8 1764( access is a common)4 839( Sequential)1 478(the next element of the object.)5 1239 4 720 5460 t
-(sider scrolling through a document while looking for something.)8 2579 1 720 5580 t
-( at least the implementation.)4 1158(Finally, like any good data structure, the cache guides the algorithm, or)11 2912 2 970 5736 t
-(The)720 5856 w
-10 CW f
-(Rasp)906 5856 w
-10 R f
-( between the host and terminal parts, but I)8 1718(was actually invented to control the communications)6 2145 2 1177 5856 t
-( caches were more explicitly intended to serve a)8 1957( Other)1 282( was also a form of cache.)6 1068(realized very early that it)4 1013 4 720 5976 t
-(double purpose: for example, the caches in)6 1728 1 720 6096 t
-10 CW f
-(Files)2476 6096 w
-10 R f
-(that coalesce updates not only reduce traffic to the tran-)9 2237 1 2803 6096 t
-(script and contents)2 749 1 720 6216 t
-10 CW f
-(Buffers)1494 6216 w
-10 R f
-( clump screen updates so that complicated changes to the screen are)11 2718(, they also)2 408 2 1914 6216 t
-( not need to write)4 715( saved me considerable work: I did)6 1427( This)1 233(achieved in just a few messages to the terminal.)8 1945 4 720 6336 t
-( they)1 200( Also,)1 267( pay off in surprising ways.)5 1108( Caches)1 341( optimize the message traffic to the terminal.)7 1807(special code to)2 597 6 720 6456 t
-(tend to be independent, so their performance improvements are multiplicative.)9 3131 1 720 6576 t
-10 B f
-(Data structures in the terminal)4 1320 1 720 6816 t
-10 R f
-(The terminal's job is to display and to maintain a consistent image of pieces of the files being edited.)18 4320 1 720 6972 t
-( text is always in memory, the data structures are considerably simpler than those in the host)16 3831(Because the)1 489 2 720 7092 t
-(part.)720 7212 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 21 21
-%%Page: 22 22
-/saveobj save def
-mark
-22 pagesetup
-10 R f
-(- 22 -)2 216 1 2772 480 t
-10 CW f
-(Sam)970 840 w
-10 R f
-( does)1 211(typically has far more windows than)5 1466 2 1177 840 t
-10 CW f
-(mux)2882 840 w
-10 R f
-(, the window system within which its Blit imple-)8 1978 1 3062 840 t
-(mentation runs.)1 633 1 720 960 t
-10 CW f
-(Mux)1414 960 w
-10 R f
-(has a fairly small number of asynchronously updated windows;)8 2618 1 1630 960 t
-10 CW f
-(sam)4284 960 w
-10 R f
-(needs a large)2 540 1 4500 960 t
-( different)1 376( The)1 213( static and often fully obscured.)5 1299(number of synchronously updated windows that are usually)7 2432 4 720 1080 t
-(tradeoffs guided)1 670 1 720 1200 t
-10 CW f
-(sam)1434 1200 w
-10 R f
-( windows, called)2 710(away from the memory-intensive implementation of)5 2184 2 1658 1200 t
-10 CW f
-(Layers)4595 1200 w
-10 R f
-(,)4955 1200 w
-6 R f
-(17)4980 1150 w
-10 R f
-(used in)1 297 1 720 1320 t
-10 CW f
-(mux.)1053 1320 w
-10 R f
-( window,)1 384(Rather than depending on a complete bitmap image of the display for each)12 3110 2 1329 1320 t
-10 CW f
-(sam)4860 1320 w
-10 R f
-( image from its in-memory text \(stored in the)8 1876(regenerates the)1 610 2 720 1440 t
-10 CW f
-(Rasp)3240 1440 w
-10 R f
-(\) when necessary, although it will use)6 1560 1 3480 1440 t
-( Like)1 243(such an image if it is available.)6 1300 2 720 1560 t
-10 CW f
-(Layers)2299 1560 w
-10 R f
-(, though,)1 364 1 2659 1560 t
-10 CW f
-(sam)3059 1560 w
-10 R f
-(uses the screen bitmap as active storage in)7 1765 1 3275 1560 t
-(which to update the image using)5 1306 1 720 1680 t
-10 CW f
-(bitblt)2053 1680 w
-10 R f
-(.)2413 1680 w
-6 R f
-(18,19)2438 1630 w
-10 R f
-(The resulting organization, pictured in Figure 6, has a global)9 2440 1 2600 1680 t
-(array of windows, called)3 989 1 720 1800 t
-10 CW f
-(Flayers)1735 1800 w
-10 R f
-( structure)1 376(, each of which holds an image of a piece of text held in a data)15 2509 2 2155 1800 t
-(called a)1 319 1 720 1920 t
-10 CW f
-(Frame)1076 1920 w
-10 R f
-( rectangular window full of text displayed in some)8 2102(, which in turn represents a)5 1141 2 1376 1920 t
-10 CW f
-(Bitmap)4655 1920 w
-10 R f
-(.)5015 1920 w
-(Each)720 2040 w
-10 CW f
-(Flayer)947 2040 w
-10 R f
-( display, and simultaneously)3 1151(appears in a global list that orders them all front-to-back on the)11 2554 2 1335 2040 t
-( in the termi-)3 519( complement)1 520( The)1 206(as an element of a per-file array that holds all the open windows for that file.)15 3075 4 720 2160 t
-(nal of the)2 377 1 720 2280 t
-10 CW f
-(File)1122 2280 w
-10 R f
-(on the host is called a)5 863 1 1387 2280 t
-10 CW f
-(Text)2275 2280 w
-10 R f
-(; each connects its)3 729 1 2515 2280 t
-10 CW f
-(Flayers)3269 2280 w
-10 R f
-(to the associated)2 660 1 3714 2280 t
-10 CW f
-(Rasp)4399 2280 w
-10 R f
-(.)4639 2280 w
-1800 2478 1800 2766 Dl
-2606 2478 1800 2478 Dl
-2606 2766 2606 2478 Dl
-1800 2766 2606 2766 Dl
-10 CW f
-(Text)2083 2642 w
-2722 2478 2722 2766 Dl
-3370 2478 2722 2478 Dl
-3370 2766 3370 2478 Dl
-2722 2766 3370 2766 Dl
-(Rasp)2926 2642 w
-2721 2622 2606 2622 Dl
-3542 2622 3370 2622 Dl
-3542 2622 3470 2640 Dl
-3542 2622 3470 2604 Dl
-10 R f
-(to host)1 270 1 3677 2642 t
-2203 2881 2203 2766 Dl
-1987 2881 2203 2881 Dl
-1987 3097 1987 2881 Dl
-2102 3097 1987 3097 Dl
-2102 2953 2102 3241 Dl
-2642 2953 2102 2953 Dl
-2642 3241 2642 2953 Dl
-2102 3241 2642 3241 Dl
-10 CW f
-(Flayer)2192 3117 w
-2642 2953 2642 3241 Dl
-3182 2953 2642 2953 Dl
-3182 3241 3182 2953 Dl
-2642 3241 3182 3241 Dl
-3182 2953 3182 3241 Dl
-3722 2953 3182 2953 Dl
-3722 3241 3722 2953 Dl
-3182 3241 3722 3241 Dl
-3722 2953 3722 3241 Dl
-4262 2953 3722 2953 Dl
-4262 3241 4262 2953 Dl
-3722 3241 4262 3241 Dl
-(...)3902 3117 w
-(...)2822 3578 w
-2102 3414 2102 3702 Dl
-2642 3414 2102 3414 Dl
-2642 3702 2642 3414 Dl
-2102 3702 2642 3702 Dl
-(Frame)2222 3578 w
-2372 3413 2372 3241 Dl
-2912 3413 2912 3241 Dl
-3452 3413 3452 3241 Dl
-3992 3413 3992 3241 Dl
-1498 3414 1498 3702 Dl
-1930 3414 1498 3414 Dl
-1930 3702 1930 3414 Dl
-1498 3702 1930 3702 Dl
-(Bitmap)1534 3518 w
-10 R f
-(\(cache\))1568 3638 w
-2102 3558 1930 3558 Dl
-2372 3817 2372 3702 Dl
-2012 3817 2372 3817 Dl
-2012 4033 2012 3817 Dl
-2127 4033 2012 4033 Dl
-2128 3889 2128 4177 Dl
-2452 3889 2128 3889 Dl
-2452 4177 2452 3889 Dl
-2128 4177 2452 4177 Dl
-10 CW f
-(Box)2200 4053 w
-2452 3889 2452 4177 Dl
-2776 3889 2452 3889 Dl
-2776 4177 2776 3889 Dl
-2452 4177 2776 4177 Dl
-2776 3889 2776 4177 Dl
-3100 3889 2776 3889 Dl
-3100 4177 3100 3889 Dl
-2776 4177 3100 4177 Dl
-3100 3889 3100 4177 Dl
-3424 3889 3100 3889 Dl
-3424 4177 3424 3889 Dl
-3100 4177 3424 4177 Dl
-(...)3172 4053 w
-8 I f
-(Figure 6. Data structures in the terminal.)6 1360 1 720 4355 t
-8 CW f
-(Flayers)2126 4355 w
-8 I f
-(are also linked together into a front-to-back list.)7 1587 1 2488 4355 t
-8 CW f
-(Boxes)4122 4355 w
-8 I f
-(are discussed in the)3 651 1 4389 4355 t
-(next section.)1 397 1 720 4455 t
-10 R f
-(The)970 4731 w
-10 CW f
-(Bitmap)1155 4731 w
-10 R f
-(for a)1 190 1 1545 4731 t
-10 CW f
-(Frame)1765 4731 w
-10 R f
-( a fully visible window, the)5 1124( For)1 195(contains the image of the text.)5 1234 3 2096 4731 t
-10 CW f
-(Bitmap)4680 4731 w
-10 R f
-(will be the screen \(or at least the)7 1315 1 720 4851 t
-10 CW f
-(Layer)2063 4851 w
-10 R f
-(in which)1 350 1 2391 4851 t
-10 CW f
-(sam)2769 4851 w
-10 R f
-( while for partially obscured windows)5 1527(is being run\),)2 536 2 2977 4851 t
-(the)720 4971 w
-10 CW f
-(Bitmap)867 4971 w
-10 R f
-( the window is fully obscured, the)6 1357( If)1 116(will be off-screen.)2 728 3 1252 4971 t
-10 CW f
-(Bitmap)3478 4971 w
-10 R f
-(will be null.)2 481 1 3863 4971 t
-(The)970 5127 w
-10 CW f
-(Bitmap)1159 5127 w
-10 R f
-( image)1 279( making changes to the display, most of the original)9 2152( When)1 297(is a kind of cache.)4 759 4 1553 5127 t
-( The)1 207( this.)1 197(will look the same in the final image, and the update algorithms exploit)12 2887 3 720 5247 t
-10 CW f
-(Frame)4038 5247 w
-10 R f
-(software updates)1 675 1 4365 5247 t
-(the image in the)3 644 1 720 5367 t
-10 CW f
-(Bitmap)1390 5367 w
-10 R f
-(incrementally; the)1 725 1 1776 5367 t
-10 CW f
-(Bitmap)2528 5367 w
-10 R f
-(is not just an image, it is a data structure.)9 1653 1 2915 5367 t
-6 R f
-(18,19)4568 5317 w
-10 R f
-(The job)1 310 1 4730 5367 t
-( therefore to use as much as possible of the existing image \(con-)12 2622(of the software that updates the display is)7 1698 2 720 5487 t
-( a sort of two-dimensional string insertion)6 1713(verting the text from ASCII characters to pixels is expensive\) in)10 2607 2 720 5607 t
-( details of this process are described in the next section.)10 2221(algorithm. The)1 619 2 720 5727 t
-(The)970 5883 w
-10 CW f
-(Frame)1173 5883 w
-10 R f
-(software has no code to support overlapping windows; its job is to keep a single)14 3519 1 1521 5883 t
-10 CW f
-(Bitmap)720 6003 w
-10 R f
-( falls to the)3 471( It)1 119(up to date.)2 435 3 1113 6003 t
-10 CW f
-(Flayer)2171 6003 w
-10 R f
-(software to multiplex the various)4 1349 1 2564 6003 t
-10 CW f
-(Bitmaps)3945 6003 w
-10 R f
-(onto the screen.)2 643 1 4397 6003 t
-(The problem of maintaining overlapping)4 1638 1 720 6123 t
-10 CW f
-(Flayers)2386 6123 w
-10 R f
-(is easier than for)3 671 1 2834 6123 t
-10 CW f
-(Layers)3533 6123 w
-6 R f
-(17)3893 6073 w
-10 R f
-( are made)2 395(because changes)1 664 2 3981 6123 t
-( reconstructed from the data stored in the)7 1722(synchronously and because the contents of the window can be)9 2598 2 720 6243 t
-10 CW f
-(Frame)720 6363 w
-10 R f
-(; the)1 180 1 1020 6363 t
-10 CW f
-(Layers)1231 6363 w
-10 R f
-( In)1 139(software makes no such assumptions.)4 1525 2 1622 6363 t
-10 CW f
-(sam)3317 6363 w
-10 R f
-(, the window being changed is almost)6 1543 1 3497 6363 t
-( when)1 247( However,)1 446(always fully visible, because the current window is always fully visible, by construction.)12 3627 3 720 6483 t
-( it may be necessary to)5 927(multi-file changes are being made, or when more than one window is open on a file,)15 3393 2 720 6603 t
-(update partially obscured windows.)3 1420 1 720 6723 t
-( If)1 125( fully visible, invisible \(fully obscured\), or partially visible.)8 2446(There are three cases: the window is)6 1499 3 970 6879 t
-(fully visible, the)2 687 1 720 6999 t
-10 CW f
-(Bitmap)1449 6999 w
-10 R f
-(is part of the screen, so when the)7 1427 1 1851 6999 t
-10 CW f
-(Flayer)3320 6999 w
-10 R f
-(update routine calls the)3 977 1 3722 6999 t
-10 CW f
-(Frame)4740 6999 w
-10 R f
-( is invisible, there is no associated)6 1489( the window)2 534( If)1 136(update routine, the screen will be updated directly.)7 2161 4 720 7119 t
-10 CW f
-(Bitmap)720 7239 w
-10 R f
-( necessary is to update the)5 1075(, and all that is)4 614 2 1080 7239 t
-10 CW f
-(Frame)2800 7239 w
-10 R f
-( the window is)3 604( If)1 122(data structure, not the image.)4 1183 3 3131 7239 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 22 22
-%%Page: 23 23
-/saveobj save def
-mark
-23 pagesetup
-10 R f
-(- 23 -)2 216 1 2772 480 t
-(partially visible, the)2 817 1 720 840 t
-10 CW f
-(Frame)1572 840 w
-10 R f
-( called to update the image in the off-screen)8 1839(routine is)1 385 2 1907 840 t
-10 CW f
-(Bitmap)4167 840 w
-10 R f
-(, which may)2 513 1 4527 840 t
-( The)1 207(require regenerating it from the text of the window.)8 2078 2 720 960 t
-10 CW f
-(Flayer)3032 960 w
-10 R f
-(code then clips this)3 775 1 3419 960 t
-10 CW f
-(Bitmap)4221 960 w
-10 R f
-(against the)1 432 1 4608 960 t
-10 CW f
-(Bitmaps)720 1080 w
-10 R f
-(of all)1 208 1 1165 1080 t
-10 CW f
-(Frames)1398 1080 w
-10 R f
-(in front of the)3 552 1 1783 1080 t
-10 CW f
-(Frame)2360 1080 w
-10 R f
-(being modified, and the remainder is copied to the display.)9 2350 1 2685 1080 t
-( than recreating the image off-screen for every change, or clipping all the changes)13 3301(This is much faster)3 769 2 970 1236 t
-( amounts of)2 476( these caches can also consume prohibitive)6 1731( Unfortunately,)1 638(made to the image during its update.)6 1475 4 720 1356 t
-( freed fairly liberally \320 after every change to the front-to-back order of the)13 3030(memory, so they are)3 818 2 720 1476 t
-10 CW f
-(Flayers)4595 1476 w
-10 R f
-(.)5015 1476 w
-(The result is that the off-screen)5 1274 1 720 1596 t
-10 CW f
-(Bitmaps)2025 1596 w
-10 R f
-(exist only while multi-window changes are occurring, which is)8 2564 1 2476 1596 t
-( the user interface causes fully-)5 1278( Also,)1 271( improvement they provide is needed.)5 1544(the only time the performance)4 1227 4 720 1716 t
-( creating a canonically sized and placed window requires)8 2357(obscured windows to be the easiest to make \320)8 1963 2 720 1836 t
-(only a button click \320 which reduces the need for caching still further.)12 2803 1 720 1956 t
-10 B f
-(Screen update)1 608 1 720 2232 t
-10 R f
-( update:)1 321(Only two low-level primitives are needed for incremental)7 2305 2 720 2388 t
-10 CW f
-(bitblt)3373 2388 w
-10 R f
-(, which copies rectangles of pix-)5 1307 1 3733 2388 t
-(els, and)1 328 1 720 2508 t
-10 CW f
-(string)1096 2508 w
-10 R f
-(\(which in turn calls)3 840 1 1503 2508 t
-10 CW f
-(bitblt)2390 2508 w
-10 R f
-(\), which draws a null-terminated character string in a)8 2290 1 2750 2508 t
-10 CW f
-(Bitmap)720 2628 w
-10 R f
-(. A)1 153 1 1080 2628 t
-10 CW f
-(Frame)1264 2628 w
-10 R f
-(contains a list of)3 676 1 1595 2628 t
-10 CW f
-(Boxes)2302 2628 w
-10 R f
-( win-)1 215(, each of which defines a horizontal strip of text in the)11 2223 2 2602 2628 t
-( A)1 126(dow \(see Figure 7\).)3 788 2 720 2748 t
-10 CW f
-(Box)1663 2748 w
-10 R f
-(has a character string)3 856 1 1872 2748 t
-10 CW f
-(str)2757 2748 w
-10 R f
-(, and a)2 271 1 2937 2748 t
-10 CW f
-(Rectangle rect)1 809 1 3237 2748 t
-10 R f
-(that defines the location)3 966 1 4074 2748 t
-( text in)2 280( \(The)1 239(of the strip in the window.)5 1060 3 720 2868 t
-10 CW f
-(str)2325 2868 w
-10 R f
-(is stored in the)3 592 1 2531 2868 t
-10 CW f
-(Box)3150 2868 w
-10 R f
-(separately from the)2 774 1 3357 2868 t
-10 CW f
-(Rasp)4158 2868 w
-10 R f
-(associated with)1 615 1 4425 2868 t
-(the window's file, so)3 853 1 720 2988 t
-10 CW f
-(Boxes)1603 2988 w
-10 R f
-( the)1 151( invariant is that the image of)6 1201( The)1 210(are self-contained.\))1 774 4 1933 2988 t
-10 CW f
-(Box)4298 2988 w
-10 R f
-(can be repro-)2 533 1 4507 2988 t
-(duced by calling)2 660 1 720 3108 t
-10 CW f
-(string)1405 3108 w
-10 R f
-(with argument)1 581 1 1790 3108 t
-10 CW f
-(str)2397 3108 w
-10 R f
-(to draw the string in)4 809 1 2603 3108 t
-10 CW f
-(rect)3438 3108 w
-10 R f
-(, and the resulting picture fits per-)6 1362 1 3678 3108 t
-(fectly within)1 509 1 720 3228 t
-10 CW f
-(rect)1255 3228 w
-10 R f
-( other words, the)3 674(. In)1 159 2 1495 3228 t
-10 CW f
-(Boxes)2354 3228 w
-10 R f
-( tiling may be compli-)4 889( The)1 206(define the tiling of the window.)5 1265 3 2680 3228 t
-( editors use horizontal scrolling to)5 1413( Some)1 288( of text, which are folded onto the next line.)9 1840(cated by long lines)3 779 4 720 3348 t
-( be)1 119(avoid this complication, but to be comfortable this technique requires that lines not)12 3329 2 720 3468 t
-10 I f
-(too)4193 3468 w
-10 R f
-(long;)4346 3468 w
-10 CW f
-(sam)4577 3468 w
-10 R f
-(has no)1 258 1 4782 3468 t
-( programs and terminals traditionally fold long)6 1907( and perhaps more importantly, Unix)5 1501( Also,)1 269(such restriction.)1 643 4 720 3588 t
-(lines to make their contents fully visible.)6 1630 1 720 3708 t
-(Two special kinds of)3 841 1 970 3864 t
-10 CW f
-(Boxes)1839 3864 w
-10 R f
-( and tabs)2 361( Newlines)1 430(contain a single character: either a newline or a tab.)9 2082 3 2167 3864 t
-( newline)1 353( A)1 134(are white space.)2 663 3 720 3984 t
-10 CW f
-(Box)1907 3984 w
-10 R f
-( following)1 425(always extends to the right edge of the window, forcing the)10 2491 2 2124 3984 t
-10 CW f
-(Box)720 4104 w
-10 R f
-( on where it is located: it forces the next)9 1618( width of a tab depends)5 934( The)1 206(to the next line.)3 625 4 926 4104 t
-10 CW f
-(Box)4336 4104 w
-10 R f
-(to begin at a)3 497 1 4543 4104 t
-( a minimum width equivalent to a blank \(blanks are drawn by)11 2472( also have)2 403( Tabs)1 246(tab location.)1 496 4 720 4224 t
-10 CW f
-(string)4363 4224 w
-10 R f
-(and are)1 291 1 4749 4224 t
-(not treated specially\); newlines have a minimum width of zero.)9 2524 1 720 4344 t
-929 4506 929 4614 Dl
-1505 4506 929 4506 Dl
-1505 4614 1505 4506 Dl
-929 4614 1505 4614 Dl
-1505 4506 1505 4614 Dl
-2700 4506 1505 4506 Dl
-2700 4614 2700 4506 Dl
-1505 4614 2700 4614 Dl
-10 CW f
-(for\(i=0; i<NL; i++\){)2 1200 1 1502 4580 t
-2700 4506 2700 4614 Dl
-3132 4506 2700 4506 Dl
-3132 4614 3132 4506 Dl
-2700 4614 3132 4614 Dl
-3132 4506 3132 4614 Dl
-4471 4506 3132 4506 Dl
-4471 4614 4471 4506 Dl
-3132 4614 4471 4614 Dl
-(/* for each element */)4 1320 1 3141 4580 t
-4471 4506 4471 4614 Dl
-4831 4506 4471 4506 Dl
-4831 4614 4831 4506 Dl
-4471 4614 4831 4614 Dl
-8 I f
-( line of text showing its)5 747(Figure 7. A)2 368 2 720 4852 t
-8 CW f
-(Boxes)1857 4852 w
-8 I f
-( first two blank)3 487(. The)1 182 2 2097 4852 t
-8 CW f
-(Boxes)2788 4852 w
-8 I f
-( are handled)2 407( Spaces)1 263(contain tabs; the last contains a newline.)6 1320 3 3050 4852 t
-(as ordinary characters.)2 750 1 720 4952 t
-10 R f
-(The update algorithms always use the)5 1631 1 970 5228 t
-10 CW f
-(Bitmap)2651 5228 w
-10 R f
-(image of the text \(either the display or cache)8 1979 1 3061 5228 t
-10 CW f
-(Bitmap)720 5348 w
-10 R f
-( examine the characters within a)5 1318(\); they never)2 518 2 1080 5348 t
-10 CW f
-(Box)2947 5348 w
-10 R f
-(except when the)2 660 1 3158 5348 t
-10 CW f
-(Box)3849 5348 w
-10 R f
-(needs to be split in two.)5 980 1 4060 5348 t
-( the window consists of a tiling of)7 1365(Before a change,)2 672 2 720 5468 t
-10 CW f
-(Boxes)2783 5468 w
-10 R f
-(; after the change the window is tiled differently.)8 1957 1 3083 5468 t
-( algorithms are not strictly)4 1075( The)1 210( rearrange the tiles in place, without backup storage.)8 2124(The update algorithms)2 911 4 720 5588 t
-( move)1 250(optimal \320 for example, they can clear a pixel that is later going to be written upon \320 but they never)20 4070 2 720 5708 t
-( that doesn't need to be moved, and they move each tile at most once.)14 2975(a tile)1 212 2 720 5828 t
-10 CW f
-(Frinsert)3971 5828 w
-10 R f
-(on a Blit can)3 550 1 4490 5828 t
-(absorb over a thousand characters a second if the strings being inserted are a few tens of characters long.)18 4174 1 720 5948 t
-(Consider)970 6104 w
-10 CW f
-(frdelete)1368 6104 w
-10 R f
-( job is to delete a substring from a)8 1456(. Its)1 187 2 1848 6104 t
-10 CW f
-(Frame)3528 6104 w
-10 R f
-( the image of the)4 723(and restore)1 452 2 3865 6104 t
-10 CW f
-(Frame)720 6224 w
-10 R f
-( comprising possibly a partial line,)5 1428( image of a substring has a peculiar shape \(see Figure 2\))11 2352(. The)1 240 3 1020 6224 t
-( reference, call this the)4 937( For)1 197( line.)1 208(zero or more full lines, and possibly a final partial)9 2060 4 720 6344 t
-10 I f
-(Z-shape.)4155 6344 w
-10 CW f
-(Frdelete)4560 6344 w
-10 R f
-( necessary, the)2 584(begins by splitting, if)3 854 2 720 6464 t
-10 CW f
-(Boxes)2183 6464 w
-10 R f
-(containing the ends of the substring so the substring begins and)10 2532 1 2508 6464 t
-(ends on)1 311 1 720 6584 t
-10 CW f
-(Box)1059 6584 w
-10 R f
-( Z-shape is)2 446( the substring is being deleted, its image is not needed, so the)12 2479(boundaries. Because)1 848 3 1267 6584 t
-( tiles \(that is, the images of)6 1092( Then,)1 282(then cleared.)1 511 3 720 6704 t
-10 CW f
-(Boxes)2632 6704 w
-10 R f
-(\) are copied, using)3 743 1 2932 6704 t
-10 CW f
-(bitblt)3701 6704 w
-10 R f
-(, from immediately after)3 979 1 4061 6704 t
-( \()1 92(the Z-shape to the beginning of the Z-shape, resulting in a new Z-shape.)12 2986 2 720 6824 t
-10 CW f
-(Boxes)3798 6824 w
-10 R f
-(whose contents would)2 908 1 4132 6824 t
-(span two lines in the new position must first be split.\))10 2142 1 720 6944 t
-( the)1 158(Copying the remainder of)3 1059 2 970 7100 t
-10 CW f
-(Frame)2223 7100 w
-10 R f
-(tile by tile this way will clearly accomplish the deletion but)10 2481 1 2559 7100 t
-( new)1 221(eventually, typically when the copying algorithm encounters a tab or newline, the old and)13 3984 2 720 7220 t
-10 CW f
-(x)4980 7220 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 23 23
-%%Page: 24 24
-/saveobj save def
-mark
-24 pagesetup
-10 R f
-(- 24 -)2 216 1 2772 480 t
-( correspondence implies that the Z-shape has its)7 2021( This)1 243( same.)1 270(coordinates of the tile to be copied are the)8 1786 4 720 840 t
-( aligned vertically, and a sequence of at most two)9 2073(beginning and ending edges)3 1154 2 720 960 t
-10 CW f
-(bitblts)3983 960 w
-10 R f
-(can be used to)3 601 1 4439 960 t
-( clear out the resulting empty space at the bottom of the win-)12 2526( last step is to)4 573( The)1 212(copy the remaining tiles.)3 1009 4 720 1080 t
-( number of complete lines in the Z-shape closed by the final)11 2476(dow; the number of lines to be cleared is the)9 1844 2 720 1200 t
-10 CW f
-(bitblts.)720 1320 w
-10 R f
-( horizontally adjacent)2 877(The final step is to merge)5 1043 2 1230 1320 t
-10 CW f
-(Boxes)3181 1320 w
-10 R f
-( complete source to)3 797( The)1 211(of plain text.)2 520 3 3512 1320 t
-10 CW f
-(frdelete)720 1440 w
-10 R f
-(is less than 100 lines of C.)6 1053 1 1225 1440 t
-10 CW f
-(frinsert)970 1596 w
-10 R f
-( the)1 150(is more complicated because it must do four passes: one to construct)11 2760 2 1477 1596 t
-10 CW f
-(Box)4415 1596 w
-10 R f
-(list for the)2 417 1 4623 1596 t
-( one to reconnoitre, one to copy \(in opposite order to)10 2175(inserted string,)1 602 2 720 1716 t
-10 CW f
-(frdelete)3529 1716 w
-10 R f
-(\) the)1 187 1 4009 1716 t
-10 CW f
-(Boxes)4228 1716 w
-10 R f
-(to make the)2 480 1 4560 1716 t
-( though,)1 335( Overall,)1 381(hole for the new text, and finally one to copy the new text into place.)14 2849 3 720 1836 t
-10 CW f
-(frinsert)4317 1836 w
-10 R f
-(has a)1 210 1 4830 1836 t
-(similar flavor to)2 676 1 720 1956 t
-10 CW f
-(frdelete)1437 1956 w
-10 R f
-(, and needn't be described further.)5 1445 1 1917 1956 t
-10 CW f
-(Frinsert)3428 1956 w
-10 R f
-(and its subsidiary routines)3 1092 1 3948 1956 t
-(comprise 211 lines of C.)4 980 1 720 2076 t
-(The terminal source code is 3024 lines of C, and the host source is 5797 lines.)15 3116 1 970 2232 t
-10 B f
-(Discussion)720 2472 w
-(History)720 2712 w
-10 R f
-( of)1 113(The immediate ancestor)2 967 2 720 2868 t
-10 CW f
-(sam)1830 2868 w
-10 R f
-(was the original text editor for the Blit, called)8 1863 1 2040 2868 t
-10 CW f
-(jim)3933 2868 w
-10 R f
-(.)4113 2868 w
-10 CW f
-(Sam)4193 2868 w
-10 R f
-(inherited)4403 2868 w
-10 CW f
-(jim)4788 2868 w
-10 R f
-('s)4968 2868 w
-(two-process structure and mouse language almost unchanged, but)7 2721 1 720 2988 t
-10 CW f
-(jim)3480 2988 w
-10 R f
-(suffered from several drawbacks)3 1342 1 3698 2988 t
-( addressed in the design of)5 1112(that were)1 377 2 720 3108 t
-10 CW f
-(sam)2244 3108 w
-10 R f
-( most important of these was the lack of a command lan-)11 2376(. The)1 240 2 2424 3108 t
-(guage. Although)1 694 1 720 3228 t
-10 CW f
-(jim)1442 3228 w
-10 R f
-( direct help with large or repetitive)6 1398(was easy to use for simple editing, it provided no)9 1992 2 1650 3228 t
-( but this was no)4 640( it provided a command to pass selected text through a shell pipeline,)12 2785( Instead,)1 365(editing tasks.)1 530 4 720 3348 t
-(more satisfactory than could be expected of a stopgap measure.)9 2527 1 720 3468 t
-10 CW f
-(Jim)970 3624 w
-10 R f
-( interface to text, and)4 877(was written primarily as a vehicle for experimenting with a mouse-based)10 2981 2 1182 3624 t
-(the experiment was successful.)3 1263 1 720 3744 t
-10 CW f
-(Jim)2041 3744 w
-10 R f
-(had some spin-offs:)2 804 1 2254 3744 t
-10 CW f
-(mux)3091 3744 w
-10 R f
-(, the second window system for the Blit, is)8 1769 1 3271 3744 t
-( the terminal part of)4 829(essentially a multiplexed version of)4 1453 2 720 3864 t
-10 CW f
-(jim)3036 3864 w
-10 R f
-(; and the debugger)3 767 1 3216 3864 t
-10 CW f
-(pi)4017 3864 w
-10 R f
-('s user interface)2 654 1 4137 3864 t
-6 R f
-(20)4791 3814 w
-10 R f
-(was)4885 3864 w
-(closely modeled on)2 785 1 720 3984 t
-10 CW f
-(jim)1534 3984 w
-10 R f
-( after a couple of years,)5 955('s. But)1 296 2 1714 3984 t
-10 CW f
-(jim)2994 3984 w
-10 R f
-( maintain and limiting)3 896(had become difficult to)3 941 2 3203 3984 t
-(to use, and its replacement was overdue.)6 1613 1 720 4104 t
-(I began the design of)4 837 1 970 4260 t
-10 CW f
-(sam)1832 4260 w
-10 R f
-(by asking)1 386 1 2037 4260 t
-10 CW f
-(jim)2448 4260 w
-10 R f
-( was probably a mistake;)4 997( This)1 229( they wanted.)2 537(customers what)1 624 4 2653 4260 t
-( of the)2 259(the answers were essentially a list of features to be found in other editors, which did not provide any)18 4061 2 720 4380 t
-( for a ``global substitute,'' but no)6 1359( instance, one common request was)5 1434( For)1 193(guiding principles I was seeking.)4 1334 4 720 4500 t
-( was looking for a scheme that would sup-)8 1724( I)1 87( it within a cut-and-paste editor.)5 1296(one suggested how to provide)4 1213 4 720 4620 t
-( were)1 225( Ideas)1 267( context of some general command language.)6 1852(port such specialized features comfortably in the)6 1976 4 720 4740 t
-( line lengths)2 499(not forthcoming, though, particularly given my insistence on removing all limits on file sizes,)13 3821 2 720 4860 t
-( a region of the screen that)6 1088( worse, I recognized that, since the mouse could easily indicate)10 2557( Even)1 259(and so on.)2 416 4 720 4980 t
-(was not an integral number of lines, the command language would best forget about newlines altogether,)15 4320 1 720 5100 t
-(and that meant the command language had to treat the file as a single string, not an array of lines.)19 3885 1 720 5220 t
-( I)1 96( very far and it was time to try building.)9 1710(Eventually, I decided that thinking was not getting me)8 2264 3 970 5376 t
-( of)1 115(knew that the terminal part could be built easily \320 that part)11 2477 2 720 5496 t
-10 CW f
-(jim)3344 5496 w
-10 R f
-(behaved acceptably well \320 and that)5 1484 1 3556 5496 t
-( hard work was going to be in the host part: the file interface, command interpreter and so on.)18 3858(most of the)2 462 2 720 5616 t
-(Moreover, I had some ideas about how the architecture of)9 2386 1 720 5736 t
-10 CW f
-(jim)3140 5736 w
-10 R f
-(could be improved without destroying its)5 1687 1 3353 5736 t
-( I began)2 331( So)1 161( worked out as well as I had hoped.)8 1451(basic structure, which I liked in principle but which hadn't)9 2377 4 720 5856 t
-( with the way)3 556(by designing the file data structure, starting)6 1770 2 720 5976 t
-10 CW f
-(jim)3076 5976 w
-10 R f
-(worked \320 comparable to a single structure)6 1754 1 3286 5976 t
-(merging)720 6096 w
-10 CW f
-(Disc)1080 6096 w
-10 R f
-(and)1347 6096 w
-10 CW f
-(Buffer)1518 6096 w
-10 R f
-( cache more general \320 and thinking about how glo-)9 2109(, which I split to make the)6 1053 2 1878 6096 t
-( answer was clearly that it had to be done in two passes, and the)14 2618( The)1 210( implemented.)1 577(bal substitute could be)3 915 4 720 6216 t
-(transcript-oriented implementation fell out naturally.)4 2106 1 720 6336 t
-10 CW f
-(Sam)970 6492 w
-10 R f
-( data structures and algorithms for manipulating text,)7 2190(was written bottom-up, starting from the)5 1666 2 1184 6492 t
-( retrospect, it turned out)4 973( In)1 138(through the command language and up to the code for maintaining the display.)12 3209 3 720 6612 t
-( were several times when I had)6 1247( There)1 284( general.)1 345(well, but this implementation method is not recommended in)8 2444 4 720 6732 t
-( command language, in)3 938( The)1 207( proceed with it.)3 655(a large body of interesting code assembled and no clue how to)11 2520 4 720 6852 t
-( beginning)1 429(particular, took almost a year to figure out, but can be implemented \(given what was there at the)17 3891 2 720 6972 t
-( inventing the)2 568( Similarly,)1 457(of that year\) in a day or two.)7 1199 3 720 7092 t
-10 CW f
-(Rasp)2978 7092 w
-10 R f
-(data structure delayed the connection of the)6 1788 1 3252 7092 t
-(host and terminal pieces by another few months.)7 1978 1 720 7212 t
-10 CW f
-(Sam)2754 7212 w
-10 R f
-(took about two years to write, although only about)8 2074 1 2966 7212 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 24 24
-%%Page: 25 25
-/saveobj save def
-mark
-25 pagesetup
-10 R f
-(- 25 -)2 216 1 2772 480 t
-(four months were spent actually working on it.)7 1870 1 720 840 t
-( process was unusual: the subset of the protocol that maintains the)11 2661(Part of the design)3 705 2 970 996 t
-10 CW f
-(Rasp)4363 996 w
-10 R f
-(was simu-)1 410 1 4630 996 t
-(lated, debugged and verified by an automatic protocol analyzer,)8 2568 1 720 1116 t
-6 R f
-(21)3288 1066 w
-10 R f
-( rest)1 171( The)1 207( from the start.)3 594(and was bug-free)2 692 4 3376 1116 t
-( keeping menus up to date, was unfortunately too unwieldy for such)11 2757(of the protocol, concerned mostly with)5 1563 2 720 1236 t
-( in and)2 276(analysis, and was debugged by more traditional methods, primarily by logging in a file all messages)15 4044 2 720 1356 t
-(out of the host.)3 600 1 720 1476 t
-10 B f
-(Reflections)720 1716 w
-10 CW f
-(Sam)720 1872 w
-10 R f
-( of the computing science)4 1078(is essentially the only interactive editor used by the sixty or so members)12 3025 2 937 1872 t
-( same could not be said of)6 1055( The)1 207(research center in which I work.)5 1294 3 720 1992 t
-10 CW f
-(jim)3303 1992 w
-10 R f
-( kept)1 198(; the lack of a command language)6 1359 2 3483 1992 t
-( of a user interface as comfortable as)7 1485( union)1 255( The)1 207(some people from adopting it.)4 1210 4 720 2112 t
-10 CW f
-(jim)3905 2112 w
-10 R f
-('s with a command lan-)4 955 1 4085 2112 t
-(guage as powerful as)3 851 1 720 2232 t
-10 CW f
-(ed)1600 2232 w
-10 R f
-( to)1 108('s\262 is essential)2 591 2 1720 2232 t
-10 CW f
-(sam)2449 2232 w
-10 R f
-( When)1 293('s success.)1 426 2 2629 2232 t
-10 CW f
-(sam)3378 2232 w
-10 R f
-(was first made available to the)5 1242 1 3588 2232 t
-10 CW f
-(jim)4860 2232 w
-10 R f
-( the months that followed, even)5 1315( In)1 144( to it within two or three days.)7 1282(community, almost everyone switched)3 1579 4 720 2352 t
-(people who had never adopted)4 1219 1 720 2472 t
-10 CW f
-(jim)1964 2472 w
-10 R f
-(started using)1 508 1 2169 2472 t
-10 CW f
-(sam)2702 2472 w
-10 R f
-(exclusively.)2907 2472 w
-(To be honest,)2 555 1 970 2628 t
-10 CW f
-(ed)1558 2628 w
-10 R f
-(still gets occasional use, but usually when something quick needs to be done and)13 3329 1 1711 2628 t
-(the overhead of downloading the terminal part of)7 1981 1 720 2748 t
-10 CW f
-(sam)2729 2748 w
-10 R f
-( as a `line' editor,)4 709( Also,)1 266(isn't worth the trouble.)3 922 3 2936 2748 t
-10 CW f
-(sam)4860 2748 w
-(-d)720 2868 w
-10 R f
-( it is)2 183( But)1 200( line editor.)2 468(is a bit odd; when using a good old ASCII terminal, it's comforting to have a true)16 3320 4 869 2868 t
-(fair to say that)3 598 1 720 2988 t
-10 CW f
-(sam)1351 2988 w
-10 R f
-('s command language has displaced)4 1464 1 1531 2988 t
-10 CW f
-(ed)3027 2988 w
-10 R f
-('s for most of the complicated editing that has)8 1893 1 3147 2988 t
-(kept line editors \(that is, command-driven editors\) with us.)8 2348 1 720 3108 t
-10 CW f
-(Sam)970 3264 w
-10 R f
-('s command language is even fancier than)6 1745 1 1150 3264 t
-10 CW f
-(ed)2931 3264 w
-10 R f
-('s, and most)2 508 1 3051 3264 t
-10 CW f
-(sam)3595 3264 w
-10 R f
-(customers don't come near to)4 1229 1 3811 3264 t
-( think the answer is yes, for two reasons.)8 1625( I)1 83( it need to be so sophisticated?)6 1221( Does)1 255(using all its capabilities.)3 967 5 720 3384 t
-(First, the)1 362 1 970 3540 t
-10 I f
-(model)1363 3540 w
-10 R f
-(for)1638 3540 w
-10 CW f
-(sam)1786 3540 w
-10 R f
-('s command language is really relatively simple, and certainly simpler than)10 3074 1 1966 3540 t
-(that of)1 262 1 720 3660 t
-10 CW f
-(ed)1011 3660 w
-10 R f
-( instance, there is only one kind of textual loop in)10 2009(. For)1 217 2 1131 3660 t
-10 CW f
-(sam)3385 3660 w
-10 R f
-(\320 the)1 250 1 3593 3660 t
-10 CW f
-(x)3871 3660 w
-10 R f
-(command \320 while)2 772 1 3959 3660 t
-10 CW f
-(ed)4759 3660 w
-10 R f
-(has)4907 3660 w
-(three \(the)1 381 1 720 3780 t
-10 CW f
-(g)1128 3780 w
-10 R f
-( implicit loop over lines in multi-line substi-)7 1792(command, the global flag on substitutions, and the)7 2033 2 1215 3780 t
-(tutions\). Also,)1 598 1 720 3900 t
-10 CW f
-(ed)1346 3900 w
-10 R f
-( within lines, but in)4 784('s substitute command is necessary to make changes)7 2115 2 1466 3900 t
-10 CW f
-(sam)4392 3900 w
-10 R f
-(the)4599 3900 w
-10 CW f
-(s)4748 3900 w
-10 R f
-(com-)4835 3900 w
-(mand is more of a familiar convenience than a necessity;)9 2270 1 720 4020 t
-10 CW f
-(c)3015 4020 w
-10 R f
-(and)3100 4020 w
-10 CW f
-(t)3269 4020 w
-10 R f
-(can do all the work.)4 790 1 3354 4020 t
-( to be about as powerful as)6 1082(Second, given a community that expects an editor)7 1999 2 970 4176 t
-10 CW f
-(ed)4078 4176 w
-10 R f
-(, it's hard to see how)5 842 1 4198 4176 t
-10 CW f
-(sam)720 4296 w
-10 R f
-( want to do ``global substi-)5 1150( People)1 336( that expectation.)2 713(could really be much simpler and still satisfy)7 1901 4 940 4296 t
-( sophistication)1 587( The)1 211( fancy changes.)2 629(tutes,'' and most are content to have the recipe for that and a few other)14 2893 4 720 4416 t
-( do global substitutes)3 848(of the command language is really just a veneer over a design that makes it possible to)16 3472 2 720 4536 t
-( always want something more, however, and it's gratifying to be able)11 2831( people will)2 482( Some)1 283(in a screen editor.)3 724 4 720 4656 t
-( real power of)3 595( The)1 218(to provide it.)2 542 3 720 4776 t
-10 CW f
-(sam)2113 4776 w
-10 R f
-('s command language comes from composability of the operators,)8 2747 1 2293 4776 t
-( other words,)2 542( In)1 142( orthogonal to the underlying model.)5 1511(which is by nature)3 759 4 720 4896 t
-10 CW f
-(sam)3708 4896 w
-10 R f
-(is not itself complex, but it)5 1118 1 3922 4896 t
-( you don't want to do anything complex, you can ignore the complexity)12 2915( If)1 120( things possible.)2 656(makes complex)1 629 4 720 5016 t
-(altogether, and many people do so.)5 1395 1 720 5136 t
-(Sometimes I am asked the opposite question: why didn't I just make)11 2801 1 970 5292 t
-10 CW f
-(sam)3802 5292 w
-10 R f
-(a real programmable edi-)3 1026 1 4014 5292 t
-( main reason is a matter of taste: I like the editor to be the)14 2400( The)1 212( macros and variables and so on?)6 1361(tor, with)1 347 4 720 5412 t
-( a wor-)2 284( is one technical reason, though: programmability in editors is largely)10 2778( There)1 282(same every time I use it.)5 976 4 720 5532 t
-( usually short-)2 604( editors are used to make particular,)6 1529( Programmable)1 655(karound for insufficient interactivity.)3 1532 4 720 5652 t
-( things are generally easy)4 1038( If)1 122( providing shorthands for common actions.)5 1751(term, things easy to do, such as by)7 1409 4 720 5772 t
-(to do in the first place, shorthands are not as helpful.)10 2197 1 720 5892 t
-10 CW f
-(Sam)2977 5892 w
-10 R f
-(makes common editing operations very easy,)5 1848 1 3192 5892 t
-( Also,)1 274( to complex editing problems seem commensurate with the problems themselves.)10 3350(and the solutions)2 696 3 720 6012 t
-(the ability to edit the)4 840 1 720 6132 t
-10 CW f
-(sam)1588 6132 w
-10 R f
-( only takes a mouse button click)6 1300(window makes it easy to repeat commands \320 it)8 1944 2 1796 6132 t
-(to execute a command again.)4 1161 1 720 6252 t
-8 S1 f
-(__________________)720 6900 w
-8 R f
-(\262 The people who criticize)4 872 1 720 6990 t
-8 CW f
-(ed)1618 6990 w
-8 R f
-( and its close relative)4 698(as an interactive program often forget that it)7 1441 2 1740 6990 t
-8 CW f
-(sed)3906 6990 w
-4 R f
-(7)4050 6950 w
-8 R f
-(still thrive as pro-)3 583 1 4097 6990 t
-( strength of these programs is independent of their convenience for interactive editing.)12 2742( The)1 164(grammable editors.)1 613 3 720 7080 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 25 25
-%%Page: 26 26
-/saveobj save def
-mark
-26 pagesetup
-10 R f
-(- 26 -)2 216 1 2772 480 t
-10 B f
-(Pros and cons)2 595 1 720 840 t
-10 CW f
-(Sam)720 996 w
-10 R f
-( the good things is the idea of struc-)8 1472( Among)1 355( its share of problems.)4 905(has several other good points, and)5 1379 4 929 996 t
-( were arrived at serendipi-)4 1054( They)1 258(tural regular expressions, whose usefulness has only begun to be explored.)10 3008 3 720 1116 t
-(tously when I attempted to distill the essence of)8 1936 1 720 1236 t
-10 CW f
-(ed)2685 1236 w
-10 R f
-( global substitution and recognized that)5 1599('s way of doing)3 636 2 2805 1236 t
-(the looping command in)3 975 1 720 1356 t
-10 CW f
-(ed)1720 1356 w
-10 R f
-(was implicitly imposing a structure \(an array of lines\) on the file.)11 2602 1 1865 1356 t
-(Another of)1 444 1 970 1512 t
-10 CW f
-(sam)1448 1512 w
-10 R f
-( used an editor with a true)6 1097( had never before)3 721( I)1 92('s good things is its undo capability.)6 1502 4 1628 1512 t
-( Undo)1 276(undo, but I would never go back now.)7 1545 2 720 1632 t
-10 I f
-(must)2570 1632 w
-10 R f
-( exam-)1 278( For)1 193(be done well, but if it is, it can be relied on.)11 1781 3 2788 1632 t
-( not sure how to write some intricate command, because if you make a)13 2869(ple, it's safe to experiment if you're)6 1451 2 720 1752 t
-( from writing)2 545( learned two things about undo)5 1270( I)1 90(mistake, it can be fixed simply and reliably.)7 1800 4 720 1872 t
-10 CW f
-(sam)4456 1872 w
-10 R f
-(: first, it's)2 404 1 4636 1872 t
-( the system)2 458(easy to provide if you design it in from the beginning, and second, it's necessary, particularly if)16 3862 2 720 1992 t
-(has some subtle properties that may be unfamiliar or error-prone for users.)11 2971 1 720 2112 t
-10 CW f
-(Sam)970 2268 w
-10 R f
-( avoids all fixed-size tables and data)6 1519( it)1 92( Because)1 393('s lack of internal limits and sizes is a virtue.)9 1886 4 1150 2268 t
-(structures,)720 2388 w
-10 CW f
-(sam)1159 2388 w
-10 R f
-( More-)1 299( to make global changes to files that some of our other tools cannot even read.)15 3117(is able)1 259 3 1365 2388 t
-( admit)1 255(over, the design keeps the performance linear when doing such operations, although I must)13 3648 2 720 2508 t
-10 CW f
-(sam)4650 2508 w
-10 R f
-(does)4857 2508 w
-(get slow when editing a huge file.)6 1351 1 720 2628 t
-( is poorly integrated into the surrounding)6 1680( the most obvious is that it)6 1093( Externally,)1 497(Now, the problems.)2 800 4 970 2784 t
-( design, the user interface in)5 1135( By)1 169(window system.)1 653 3 720 2904 t
-10 CW f
-(sam)2704 2904 w
-10 R f
-(feels almost identical to that of)5 1245 1 2911 2904 t
-10 CW f
-(mux)4183 2904 w
-10 R f
-(, but a thick wall)4 677 1 4363 2904 t
-(separates text in)2 655 1 720 3024 t
-10 CW f
-(sam)1406 3024 w
-10 R f
-(from the programs running in)4 1206 1 1617 3024 t
-10 CW f
-(mux)2854 3024 w
-10 R f
-( instance, the `snarf buffer' in)5 1220(. For)1 221 2 3034 3024 t
-10 CW f
-(sam)4507 3024 w
-10 R f
-(must be)1 321 1 4719 3024 t
-( that in)2 284(maintained separately from)2 1100 2 720 3144 t
-10 CW f
-(mux)2132 3144 w
-10 R f
-( is regrettable, but probably necessary given the unusual con-)9 2472(. This)1 256 2 2312 3144 t
-(figuration of the system, with a programmable terminal on the far end of an RS-232 link.)15 3554 1 720 3264 t
-10 CW f
-(Sam)970 3420 w
-10 R f
-( it was written over such a long time, and has)10 1846( But)1 199( it.)1 110(is reliable; otherwise, people wouldn't use)5 1707 4 1178 3420 t
-( to clean up the code and remove)7 1323(so many new \(to me\) ideas in it, that I would like to see it done over again)17 2997 2 720 3540 t
-( worst part is in the interconnection of the host)9 1898( The)1 209( problems in the implementation.)4 1341(many of the lingering)3 872 4 720 3660 t
-( a redesign for a more conventional window sys-)8 1946(and terminal parts, which might even be able to go away in)11 2374 2 720 3780 t
-( of the connec-)3 598( program must be split in two to use the terminal effectively, but the low bandwidth)15 3342(tem. The)1 380 3 720 3900 t
-( design if performance is to be acceptable.)7 1712(tion forces the separation to occur in an inconvenient part of the)11 2608 2 720 4020 t
-( procedure call protocol driven by the host, emitting only graphics commands, would be)13 3638(A simple remote)2 682 2 720 4140 t
-( the other hand, if the terminal)6 1284( On)1 184(easy to write but wouldn't have nearly the necessary responsiveness.)9 2852 3 720 4260 t
-( simpler file services from the host, regular expression searches would)10 2868(were in control and requested much)5 1452 2 720 4380 t
-( A)1 131( would be unreasonably slow.)4 1226(require that the terminal read the entire file over its RS-232 link, which)12 2963 3 720 4500 t
-( retrospect, the communications protocol)4 1658( In)1 139(compromise in which either end can take control is necessary.)9 2523 3 720 4620 t
-( designed and verified formally, although I do not know of any tool that can adequately)15 3609(should have been)2 711 2 720 4740 t
-(relate the protocol to its implementation.)5 1627 1 720 4860 t
-(Not all of)2 385 1 970 5016 t
-10 CW f
-(sam)1382 5016 w
-10 R f
-( \(vener-)1 314( Some)1 280('s users are comfortable with its command language, and few are adept.)11 2884 3 1562 5016 t
-( a sort of ``)4 471(able\) people use)2 664 2 720 5136 t
-10 CW f
-(ed)1855 5136 w
-10 R f
-(subset'' of)1 431 1 2007 5136 t
-10 CW f
-(sam)2470 5136 w
-10 R f
-('s command language, and even ask why)6 1680 1 2650 5136 t
-10 CW f
-(sam)4362 5136 w
-10 R f
-('s command)1 498 1 4542 5136 t
-(language is not exactly)3 942 1 720 5256 t
-10 CW f
-(ed)1695 5256 w
-10 R f
-( course, is that)3 604( reason, of)2 434('s. \(The)1 343 3 1815 5256 t
-10 CW f
-(sam)3230 5256 w
-10 R f
-('s model for text does not include new-)7 1630 1 3410 5256 t
-( central to)2 399(lines, which are)2 631 2 720 5376 t
-10 CW f
-(ed)1775 5376 w
-10 R f
-( the text an array of newlines to the command language would be too)13 2759(. Making)1 386 2 1895 5376 t
-( editors, such as)3 647( Some)1 281( mouse.)1 314(much of a break from the seamless model provided by the)10 2338 4 720 5496 t
-10 CW f
-(vi)4328 5496 w
-10 R f
-(, are willing to)3 592 1 4448 5496 t
-( difficulty is that)3 706( The)1 219( though.\))1 375(make this break,)2 687 4 720 5616 t
-10 CW f
-(sam)2746 5616 w
-10 R f
-('s syntax is so close to)5 967 1 2926 5616 t
-10 CW f
-(ed)3932 5616 w
-10 R f
-('s that people believe it)4 988 1 4052 5616 t
-10 I f
-(should)720 5736 w
-10 R f
-( in hindsight, that making)4 1050( thought, with some justification)4 1318( I)1 88(be the same.)2 506 4 1017 5736 t
-10 CW f
-(sam)4010 5736 w
-10 R f
-(similar to)1 387 1 4221 5736 t
-10 CW f
-(ed)4639 5736 w
-10 R f
-(would)4790 5736 w
-( and raised the users' expectations too)6 1573( I may have overstepped)4 1015( But)1 205(make it easier to learn and to accept.)7 1527 4 720 5856 t
-( hard to decide which way to resolve this problem.)9 2019(much. It's)1 430 2 720 5976 t
-(Finally, there is a tradeoff in)5 1187 1 970 6132 t
-10 CW f
-(sam)2192 6132 w
-10 R f
-(that was decided by the environment in which it runs:)9 2235 1 2407 6132 t
-10 CW f
-(sam)4677 6132 w
-10 R f
-(is a)1 147 1 4893 6132 t
-( The)1 220( system there might instead be multiple single-file editors.)8 2444(multi-file editor, although in a different)5 1656 3 720 6252 t
-( choice)1 298( the)1 159( If)1 128(decision was made primarily because starting a new program in a Blit is time-consuming.)13 3735 4 720 6372 t
-( still choose the multi-file architecture, because it allows groups of)10 2700(could be made freely, however, I would)6 1620 2 720 6492 t
-( is delightful)2 518( It)1 117( a unit; the usefulness of the multi-file commands is incontrovertible.)10 2822(files to be handled as)4 863 4 720 6612 t
-(to have the source to an entire program available at your fingertips.)11 2683 1 720 6732 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 26 26
-%%Page: 27 27
-/saveobj save def
-mark
-27 pagesetup
-10 R f
-(- 27 -)2 216 1 2772 480 t
-10 B f
-(Acknowledgements)720 840 w
-10 R f
-(Tom Cargill suggested the idea behind the)6 1699 1 720 996 t
-10 CW f
-(Rasp)2445 996 w
-10 R f
-( Wilson and Ken Thompson influ-)5 1384( Norman)1 379(data structure.)1 566 3 2711 996 t
-( improved by comments from Al Aho, Jon Bentley, Chris)9 2392( paper was)2 448( This)1 239(enced the command language.)3 1241 4 720 1116 t
-(Fraser, Gerard Holzmann, Brian Kernighan, Ted Kowalski, Doug McIlroy and Dennis Ritchie.)11 3787 1 720 1236 t
-9 B f
-(REFERENCES)720 1476 w
-8 R f
-( Pike, `The Blit: a multiplexed graphics terminal,')7 1588(1. R.)1 184 2 760 1648 t
-8 I f
-(AT&T Bell Labs. Tech. J.,)4 835 1 2552 1648 t
-8 B f
-(63)3407 1648 w
-8 R f
-(, \(8\), 1607-1631 \(1984\).)3 770 1 3487 1648 t
-( Johnson,)1 302(2. L.)1 179 2 760 1784 t
-8 I f
-(MacWrite,)1261 1784 w
-8 R f
-(Apple Computer Inc., Cupertino, Calif. 1983.)5 1453 1 1618 1784 t
-( Lampson, `Bravo Manual,' in)4 969(3. B.)1 184 2 760 1920 t
-8 I f
-(Alto User's Handbook,)2 738 1 1933 1920 t
-8 R f
-( 1979.)1 220(pp. 31-62, Xerox Palo Alto Research Center, Palo Alto, Calif.)9 1975 2 2691 1920 t
-( Teitelman, `A tour through Cedar,')5 1138(4. W.)1 205 2 760 2056 t
-8 I f
-(IEEE Software,)1 497 1 2123 2056 t
-8 B f
-(1)2640 2056 w
-8 R f
-(\(2\), 44-73 \(1984\).)2 570 1 2700 2056 t
-( Gutknecht, `Concepts of the text editor Lara,')7 1473(5. J.)1 161 2 760 2192 t
-8 I f
-(Comm. ACM,)1 439 1 2414 2192 t
-8 B f
-(28)2873 2192 w
-8 R f
-(, \(9\), 942-960 \(1985\).)3 690 1 2953 2192 t
-( Telephone Laboratories,)2 797(6. Bell)1 243 2 760 2328 t
-8 I f
-(UNIX Programmer's Manual,)2 965 1 1820 2328 t
-8 R f
-(Holt, Rinehart and Winston, New York 1983.)6 1456 1 2805 2328 t
-( W. Kernighan and R. Pike,)5 882(7. B.)1 184 2 760 2464 t
-8 I f
-(The Unix Programming Environment,)3 1216 1 1846 2464 t
-8 R f
-(Prentice-Hall, Englewood Cliffs, New Jersey 1984.)5 1637 1 3082 2464 t
-(8.)760 2600 w
-8 I f
-( Programmer's Manual, Research Version, Ninth Edition, Volume 1,)8 2215(Unix Time-Sharing System)2 857 2 870 2600 t
-8 R f
-(AT&T Bell Laboratories, Murray)3 1076 1 3964 2600 t
-(Hill, New Jersey 1986.)3 733 1 870 2700 t
-(9.)760 2836 w
-8 I f
-( Distribution, Volumes 1 and 2C,)5 1174(Unix Time-Sharing System Programmer's Manual, 4.1 Berkeley Software)7 2508 2 870 2836 t
-8 R f
-(University of)1 445 1 4595 2836 t
-(California, Berkeley, Calif. 1981.)3 1068 1 870 2936 t
-( Pike, `Structural Regular Expressions,')4 1264(10. R.)1 224 2 720 3072 t
-8 I f
-(Proc. EUUG Spring Conf., Helsinki 1987,)5 1357 1 2229 3072 t
-8 R f
-(Eur. Unix User's Group, Buntingford, Herts,)5 1433 1 3607 3072 t
-(UK 1987.)1 316 1 870 3172 t
-( Goldberg,)1 341(11. A.)1 228 2 720 3308 t
-8 I f
-(Smalltalk-80 \261 The Interactive Programming Environment,)5 1891 1 1309 3308 t
-8 R f
-(Addison-Wesley, Reading, Mass. 1984.)3 1269 1 3220 3308 t
-( Thompson, `Regular expression search algorithm,')5 1637(12. K.)1 228 2 720 3444 t
-8 I f
-(Comm. ACM,)1 439 1 2605 3444 t
-8 B f
-(11)3064 3444 w
-8 R f
-(, \(6\), 419-422 \(1968\).)3 690 1 3144 3444 t
-( V. Aho, J. E. Hopcroft and J. D. Ullman,)9 1344(13. A.)1 228 2 720 3580 t
-8 I f
-( of Computer Algorithms,)3 826(The Design and Analysis)3 802 2 2314 3580 t
-8 R f
-(Addison-Wesley, Reading, Mass.)2 1075 1 3965 3580 t
-(1974.)870 3680 w
-( W. Kernighan and D. M. Ritchie,)6 1085(14. B.)1 224 2 720 3816 t
-8 I f
-(The C Programming Language,)3 1023 1 2049 3816 t
-8 R f
-(Prentice-Hall, Englewood Cliffs, New Jersey 1978.)5 1637 1 3092 3816 t
-( M. Waite, `The cost of lexical analysis,')7 1297(15. W.)1 245 2 720 3952 t
-8 I f
-(Softw. Pract. Exp.,)2 599 1 2282 3952 t
-8 B f
-(16)2901 3952 w
-8 R f
-(, \(5\), 473-488 \(1986\).)3 690 1 2981 3952 t
-( W. Fraser, `A generalized text editor,')6 1232(16. C.)1 224 2 720 4088 t
-8 I f
-(Comm. ACM,)1 439 1 2196 4088 t
-8 B f
-(23)2655 4088 w
-8 R f
-(, \(3\), 154-158 \(1980\).)3 690 1 2735 4088 t
-( Pike, `Graphics in overlapping bitmap layers,')6 1493(17. R.)1 224 2 720 4224 t
-8 I f
-(ACM Trans. on Graph.,)3 765 1 2457 4224 t
-8 B f
-(2)3242 4224 w
-8 R f
-(, \(2\) 135-160 \(1983\).)3 670 1 3282 4224 t
-( J. Guibas and J. Stolfi, `A language for bitmap manipulation,')10 1990(18. L.)1 219 2 720 4360 t
-8 I f
-(ACM Trans. on Graph.,)3 765 1 2949 4360 t
-8 B f
-(1)3734 4360 w
-8 R f
-(, \(3\), 191-214 \(1982\).)3 690 1 3774 4360 t
-( Pike, B. Locanthi and J. Reiser, `Hardware/software trade-offs for bitmap graphics on the Blit,')14 3180(19. R.)1 224 2 720 4496 t
-8 I f
-(Softw. Pract. Exp.,)2 617 1 4153 4496 t
-8 B f
-(15)4799 4496 w
-8 R f
-(, \(2\),)1 161 1 4879 4496 t
-(131-151 \(1985\).)1 518 1 870 4596 t
-( A. Cargill, `The feel of Pi,')6 886(20. T.)1 219 2 720 4732 t
-8 I f
-(Winter USENIX Conference Proceedings, Denver 1986,)5 1791 1 1845 4732 t
-8 R f
-(62-71, USENIX Assoc., El Cerrito, CA.)5 1283 1 3656 4732 t
-( J. Holzmann, `Tracing protocols,')4 1098(21. G.)1 228 2 720 4868 t
-8 I f
-(AT&T Tech. J.,)2 491 1 2066 4868 t
-8 B f
-(64)2577 4868 w
-8 R f
-(, \(10\), 2413-2434 \(1985\).)3 810 1 2657 4868 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 27 27
-%%Trailer
-done
-%%Pages: 27
-%%DocumentFonts: Courier Times-Bold Times-Italic Times-Roman Times-Roman Symbol
//GO.SYSIN DD ./doc/sam.ps
echo ./doc/se.ps
-%!PS
-%%Version: 3.3.2
-%%DocumentFonts: (atend)
-%%Pages: (atend)
-%%EndComments
-%
-% Version 3.3.2 prologue for troff files.
-%
-
-/#copies 1 store
-/aspectratio 1 def
-/formsperpage 1 def
-/landscape false def
-/linewidth .3 def
-/magnification 1 def
-/margin 0 def
-/orientation 0 def
-/resolution 720 def
-/rotation 1 def
-/xoffset 0 def
-/yoffset 0 def
-
-/roundpage true def
-/useclippath true def
-/pagebbox [0 0 612 792] def
-
-/R /Times-Roman def
-/I /Times-Italic def
-/B /Times-Bold def
-/BI /Times-BoldItalic def
-/H /Helvetica def
-/HI /Helvetica-Oblique def
-/HB /Helvetica-Bold def
-/HX /Helvetica-BoldOblique def
-/CW /Courier def
-/CO /Courier def
-/CI /Courier-Oblique def
-/CB /Courier-Bold def
-/CX /Courier-BoldOblique def
-/PA /Palatino-Roman def
-/PI /Palatino-Italic def
-/PB /Palatino-Bold def
-/PX /Palatino-BoldItalic def
-/Hr /Helvetica-Narrow def
-/Hi /Helvetica-Narrow-Oblique def
-/Hb /Helvetica-Narrow-Bold def
-/Hx /Helvetica-Narrow-BoldOblique def
-/KR /Bookman-Light def
-/KI /Bookman-LightItalic def
-/KB /Bookman-Demi def
-/KX /Bookman-DemiItalic def
-/AR /AvantGarde-Book def
-/AI /AvantGarde-BookOblique def
-/AB /AvantGarde-Demi def
-/AX /AvantGarde-DemiOblique def
-/NR /NewCenturySchlbk-Roman def
-/NI /NewCenturySchlbk-Italic def
-/NB /NewCenturySchlbk-Bold def
-/NX /NewCenturySchlbk-BoldItalic def
-/ZD /ZapfDingbats def
-/ZI /ZapfChancery-MediumItalic def
-/S /S def
-/S1 /S1 def
-/GR /Symbol def
-
-/inch {72 mul} bind def
-/min {2 copy gt {exch} if pop} bind def
-
-/show {show} bind def % so later references don't bind
-/widthshow {widthshow} bind def
-/stringwidth {stringwidth} bind def
-
-/setup {
- counttomark 2 idiv {def} repeat pop
-
- landscape {/orientation 90 orientation add def} if
- /scaling 72 resolution div def
- linewidth setlinewidth
- 1 setlinecap
-
- pagedimensions
- xcenter ycenter translate
- orientation rotation mul rotate
- width 2 div neg height 2 div translate
- xoffset inch yoffset inch neg translate
- margin 2 div dup neg translate
- magnification dup aspectratio mul scale
- scaling scaling scale
-
- addmetrics
- 0 0 moveto
-} def
-
-/pagedimensions {
- useclippath userdict /gotpagebbox known not and {
- /pagebbox [clippath pathbbox newpath] def
- roundpage currentdict /roundpagebbox known and {roundpagebbox} if
- } if
- pagebbox aload pop
- 4 -1 roll exch 4 1 roll 4 copy
- landscape {4 2 roll} if
- sub /width exch def
- sub /height exch def
- add 2 div /xcenter exch def
- add 2 div /ycenter exch def
- userdict /gotpagebbox true put
-} def
-
-/addmetrics {
- /Symbol /S null Sdefs cf
- /Times-Roman /S1 StandardEncoding dup length array copy S1defs cf
-} def
-
-/pagesetup {
- /page exch def
- currentdict /pagedict known currentdict page known and {
- page load pagedict exch get cvx exec
- } if
-} def
-
-/decodingdefs [
- {counttomark 2 idiv {y moveto show} repeat}
- {neg /y exch def counttomark 2 idiv {y moveto show} repeat}
- {neg moveto {2 index stringwidth pop sub exch div 0 32 4 -1 roll widthshow} repeat}
- {neg moveto {spacewidth sub 0.0 32 4 -1 roll widthshow} repeat}
- {counttomark 2 idiv {y moveto show} repeat}
- {neg setfunnytext}
-] def
-
-/setdecoding {/t decodingdefs 3 -1 roll get bind def} bind def
-
-/w {neg moveto show} bind def
-/m {neg dup /y exch def moveto} bind def
-/done {/lastpage where {pop lastpage} if} def
-
-/f {
- dup /font exch def findfont exch
- dup /ptsize exch def scaling div dup /size exch def scalefont setfont
- linewidth ptsize mul scaling 10 mul div setlinewidth
- /spacewidth ( ) stringwidth pop def
-} bind def
-
-/changefont {
- /fontheight exch def
- /fontslant exch def
- currentfont [
- 1 0
- fontheight ptsize div fontslant sin mul fontslant cos div
- fontheight ptsize div
- 0 0
- ] makefont setfont
-} bind def
-
-/sf {f} bind def
-
-/cf {
- dup length 2 idiv
- /entries exch def
- /chtab exch def
- /newencoding exch def
- /newfont exch def
-
- findfont dup length 1 add dict
- /newdict exch def
- {1 index /FID ne {newdict 3 1 roll put}{pop pop} ifelse} forall
-
- newencoding type /arraytype eq {newdict /Encoding newencoding put} if
-
- newdict /Metrics entries dict put
- newdict /Metrics get
- begin
- chtab aload pop
- 1 1 entries {pop def} for
- newfont newdict definefont pop
- end
-} bind def
-
-%
-% A few arrays used to adjust reference points and character widths in some
-% of the printer resident fonts. If square roots are too high try changing
-% the lines describing /radical and /radicalex to,
-%
-% /radical [0 -75 550 0]
-% /radicalex [-50 -75 500 0]
-%
-% Move braceleftbt a bit - default PostScript character is off a bit.
-%
-
-/Sdefs [
- /bracketlefttp [201 500]
- /bracketleftbt [201 500]
- /bracketrighttp [-81 380]
- /bracketrightbt [-83 380]
- /braceleftbt [203 490]
- /bracketrightex [220 -125 500 0]
- /radical [0 0 550 0]
- /radicalex [-50 0 500 0]
- /parenleftex [-20 -170 0 0]
- /integral [100 -50 500 0]
- /infinity [10 -75 730 0]
-] def
-
-/S1defs [
- /underscore [0 80 500 0]
- /endash [7 90 650 0]
-] def
-%
-% Tries to round clipping path dimensions, as stored in array pagebbox, so they
-% match one of the known sizes in the papersizes array. Lower left coordinates
-% are always set to 0.
-%
-
-/roundpagebbox {
- 7 dict begin
- /papersizes [8.5 inch 11 inch 14 inch 17 inch] def
-
- /mappapersize {
- /val exch def
- /slop .5 inch def
- /diff slop def
- /j 0 def
- 0 1 papersizes length 1 sub {
- /i exch def
- papersizes i get val sub abs
- dup diff le {/diff exch def /j i def} {pop} ifelse
- } for
- diff slop lt {papersizes j get} {val} ifelse
- } def
-
- pagebbox 0 0 put
- pagebbox 1 0 put
- pagebbox dup 2 get mappapersize 2 exch put
- pagebbox dup 3 get mappapersize 3 exch put
- end
-} bind def
-
-%%EndProlog
-%%BeginSetup
-mark
-/linewidth 0.5 def
-/#copies 1 store
-/landscape false def
-/resolution 720 def
-%
-% Encoding vector and redefinition of findfont for the ISO Latin1 standard.
-% The 18 characters missing from ROM based fonts on older printers are noted
-% below.
-%
-
-/ISOLatin1Encoding [
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /space
- /exclam
- /quotedbl
- /numbersign
- /dollar
- /percent
- /ampersand
- /quoteright
- /parenleft
- /parenright
- /asterisk
- /plus
- /comma
- /minus
- /period
- /slash
- /zero
- /one
- /two
- /three
- /four
- /five
- /six
- /seven
- /eight
- /nine
- /colon
- /semicolon
- /less
- /equal
- /greater
- /question
- /at
- /A
- /B
- /C
- /D
- /E
- /F
- /G
- /H
- /I
- /J
- /K
- /L
- /M
- /N
- /O
- /P
- /Q
- /R
- /S
- /T
- /U
- /V
- /W
- /X
- /Y
- /Z
- /bracketleft
- /backslash
- /bracketright
- /asciicircum
- /underscore
- /quoteleft
- /a
- /b
- /c
- /d
- /e
- /f
- /g
- /h
- /i
- /j
- /k
- /l
- /m
- /n
- /o
- /p
- /q
- /r
- /s
- /t
- /u
- /v
- /w
- /x
- /y
- /z
- /braceleft
- /bar
- /braceright
- /asciitilde
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /.notdef
- /dotlessi
- /grave
- /acute
- /circumflex
- /tilde
- /macron
- /breve
- /dotaccent
- /dieresis
- /.notdef
- /ring
- /cedilla
- /.notdef
- /hungarumlaut
- /ogonek
- /caron
- /space
- /exclamdown
- /cent
- /sterling
- /currency
- /yen
- /brokenbar % missing
- /section
- /dieresis
- /copyright
- /ordfeminine
- /guillemotleft
- /logicalnot
- /hyphen
- /registered
- /macron
- /degree % missing
- /plusminus % missing
- /twosuperior % missing
- /threesuperior % missing
- /acute
- /mu % missing
- /paragraph
- /periodcentered
- /cedilla
- /onesuperior % missing
- /ordmasculine
- /guillemotright
- /onequarter % missing
- /onehalf % missing
- /threequarters % missing
- /questiondown
- /Agrave
- /Aacute
- /Acircumflex
- /Atilde
- /Adieresis
- /Aring
- /AE
- /Ccedilla
- /Egrave
- /Eacute
- /Ecircumflex
- /Edieresis
- /Igrave
- /Iacute
- /Icircumflex
- /Idieresis
- /Eth % missing
- /Ntilde
- /Ograve
- /Oacute
- /Ocircumflex
- /Otilde
- /Odieresis
- /multiply % missing
- /Oslash
- /Ugrave
- /Uacute
- /Ucircumflex
- /Udieresis
- /Yacute % missing
- /Thorn % missing
- /germandbls
- /agrave
- /aacute
- /acircumflex
- /atilde
- /adieresis
- /aring
- /ae
- /ccedilla
- /egrave
- /eacute
- /ecircumflex
- /edieresis
- /igrave
- /iacute
- /icircumflex
- /idieresis
- /eth % missing
- /ntilde
- /ograve
- /oacute
- /ocircumflex
- /otilde
- /odieresis
- /divide % missing
- /oslash
- /ugrave
- /uacute
- /ucircumflex
- /udieresis
- /yacute % missing
- /thorn % missing
- /ydieresis
-] def
-
-/NewFontDirectory FontDirectory maxlength dict def
-
-%
-% Apparently no guarantee findfont is defined in systemdict so the obvious
-%
-% systemdict /findfont get exec
-%
-% can generate an error. So far the only exception is a VT600 (version 48.0).
-%
-
-userdict /@RealFindfont known not {
- userdict begin
- /@RealFindfont systemdict begin /findfont load end def
- end
-} if
-
-/findfont {
- dup NewFontDirectory exch known not {
- dup
- %dup systemdict /findfont get exec % not always in systemdict
- dup userdict /@RealFindfont get exec
- dup /Encoding get StandardEncoding eq {
- dup length dict begin
- {1 index /FID ne {def}{pop pop} ifelse} forall
- /Encoding ISOLatin1Encoding def
- currentdict
- end
- /DummyFontName exch definefont
- } if
- NewFontDirectory 3 1 roll put
- } if
- NewFontDirectory exch get
-} bind def
-
-setup
-2 setdecoding
-%%EndSetup
-%%Page: 1 1
-/saveobj save def
-mark
-1 pagesetup
-12 B f
-(Structural Regular Expressions)2 1622 1 2069 1230 t
-10 I f
-(Rob Pike)1 363 1 2698 1470 t
-10 R f
-(AT&T Bell Laboratories)2 993 1 2383 1650 t
-(Murray Hill, New Jersey 07974)4 1267 1 2246 1770 t
-10 I f
-(ABSTRACT)2643 2150 w
-10 R f
-(The current)1 465 1 1330 2410 t
-9 R f
-(UNIX)1821 2410 w
-10 R f
-( the built\255in concept of a)5 999(\256 text processing tools are weakened by)6 1635 2 2046 2410 t
-( describe the `shape' of files when the typical)8 1908( is a simple notation that can)6 1222(line. There)1 470 3 1080 2530 t
-( regular)1 316( Using)1 298( is regular expressions.)3 942( notation)1 361( That)1 241(array\255of\255lines picture is inadequate.)3 1442 6 1080 2650 t
-( files has interesting)3 841(expressions to describe the structure in addition to the contents of)10 2759 2 1080 2770 t
-(applications, and yields elegant methods for dealing with some problems the current tools)12 3600 1 1080 2890 t
-( are composed, the result is)5 1157( operations using these expressions)4 1464( When)1 303(handle clumsily.)1 676 4 1080 3010 t
-(reminiscent of shell pipelines.)3 1199 1 1080 3130 t
-10 B f
-(The Peter\255On\255Silicon Problem)2 1299 1 720 3490 t
-10 R f
-( model,)1 301(In the traditional)2 666 2 970 3646 t
-9 R f
-(UNIX)1961 3646 w
-10 R f
-(text files are arrays of lines, and all the familiar tools)10 2120 1 2212 3646 t
-10 S1 f
-(\320)4358 3646 w
-10 CW f
-(grep)4484 3646 w
-10 R f
-(,)4724 3646 w
-10 CW f
-(sort)4775 3646 w
-10 R f
-(,)5015 3646 w
-10 CW f
-(awk)720 3766 w
-10 R f
-(, etc.)1 197 1 900 3766 t
-10 S1 f
-(\320)1128 3766 w
-10 R f
-( of)1 113( output)1 287( The)1 211(expect arrays of lines as input.)5 1244 4 1259 3766 t
-10 CW f
-(ls)3144 3766 w
-10 R f
-(\(regardless of options\) is a list of files, one)8 1746 1 3294 3766 t
-(per line, that may be selected by tools such as)9 1825 1 720 3886 t
-10 CW f
-(grep)2570 3886 w
-10 R f
-(:)2810 3886 w
-10 CW f
-(ls \255l /usr/ken/bin | grep 'rws.*root')5 2220 1 1080 4066 t
-10 R f
-(\(I assume that the reader is familiar with the)8 1803 1 720 4246 t
-9 R f
-(UNIX)2551 4246 w
-10 R f
-( model is powerful, but it is also pervasive,)8 1769(tools.\) The)1 464 2 2807 4246 t
-( Many)1 298(sometimes overly so.)2 877 2 720 4366 t
-9 R f
-(UNIX)1933 4366 w
-10 R f
-( more general, and more useful, if they could be)9 2041(programs would be)2 801 2 2198 4366 t
-( example,)1 400( For)1 201(applied to arbitrarily structured input.)4 1549 3 720 4486 t
-10 CW f
-(diff)2907 4486 w
-10 R f
-( C)1 105(could in principle report differences at the)6 1751 2 3184 4486 t
-( if the interesting quantum of information isn't a line, most of)11 2537( But)1 202( level.)1 251(function level instead of the line)5 1330 4 720 4606 t
-(the tools \(including)2 804 1 720 4726 t
-10 CW f
-(diff)1562 4726 w
-10 R f
-( solution so the line\255)4 873( perverting the)2 608( Worse,)1 348(\) don't help, or at best do poorly.)7 1409 4 1802 4726 t
-(oriented tools can implement it often obscures the original problem.)9 2714 1 720 4846 t
-( consider the problem of turning)5 1320(To see how a line oriented view of text can introduce complication,)11 2750 2 970 5002 t
-( input is an array of blank and non\255blank characters, like this:)11 2451( The)1 205(Peter into silicon.)2 703 3 720 5122 t
-10 CW f
-(#######)1320 5252 w
-(#########)1260 5322 w
-(#### #####)1 660 1 1200 5392 t
-( #)1 180(#### ####)1 720 2 1140 5462 t
-(#### #####)1 840 1 1140 5532 t
-(#### ###)1 840 1 1080 5602 t
-(######## #####)1 960 1 1080 5672 t
-(#### #########)1 840 1 1080 5742 t
-( ####)1 300( #)1 180(#### #)1 360 3 1080 5812 t
-( ##)1 300( ###)1 300(## #)1 240 3 1080 5882 t
-( ###)1 300(### #)1 480 2 1080 5952 t
-(### ##)1 540 1 1080 6022 t
-(## #)1 360 1 1140 6092 t
-(# ####)1 480 1 1200 6162 t
-(# #)1 180 1 1200 6232 t
-(## # ##)2 660 1 1080 6302 t
-10 R f
-(The output is to be statements in a language for laying out integrated circuits:)13 3094 1 720 6482 t
-10 CW f
-(rect minx miny maxx maxy)4 1440 1 1080 6662 t
-10 R f
-( simplify the problem slightly,)4 1247( To)1 169(The statements encode where the non\255blank characters are in the input.)10 2904 3 720 6842 t
-(the coordinate system has)3 1032 1 720 6962 t
-10 I f
-(x)1778 6962 w
-10 R f
-(positive to the right and)4 954 1 1848 6962 t
-10 I f
-(y)2828 6962 w
-10 R f
-( output need not be efficient in its)7 1346( The)1 206(positive down.)1 590 3 2898 6962 t
-(use of rectangles.)2 723 1 720 7082 t
-10 CW f
-(Awk)1507 7082 w
-10 R f
-( which is a mixture of text processing and)8 1790(is the obvious language for the task,)6 1524 2 1726 7082 t
-( the input is an array of lines, as)8 1345( Since)1 281(geometry, hence arithmetic.)2 1132 3 720 7202 t
-10 CW f
-(awk)3511 7202 w
-10 R f
-(expects, the job should be fairly)5 1316 1 3724 7202 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 1 1
-%%Page: 2 2
-/saveobj save def
-mark
-2 pagesetup
-10 R f
-(\255 2 \255)2 166 1 2797 480 t
-( is an)2 211( Here)1 243(easy, and in fact it is.)5 846 3 720 840 t
-10 CW f
-(awk)2045 840 w
-10 R f
-(program for the job:)3 807 1 2250 840 t
-10 CW f
-(BEGIN{)1080 1020 w
-(y=1)1330 1140 w
-(})1080 1260 w
-(/^/{)1080 1380 w
-(for\(x=1; x<=length\($0\); x++\))2 1680 1 1330 1500 t
-(if\(substr\($0, x, 1\)=="#"\))2 1500 1 1580 1620 t
-(print "rect", x, y, x+1, y+1)5 1680 1 1830 1740 t
-(y++)1330 1860 w
-(})1080 1980 w
-10 R f
-(Although it is certainly easy to write, there is something odd about this program: the line\255driven nature of)17 4320 1 720 2160 t
-10 CW f
-(awk)720 2280 w
-10 R f
-(results in only one obvious advantage)5 1512 1 926 2280 t
-10 S1 f
-(\320)2464 2280 w
-10 R f
-(the ease of tracking)3 781 1 2590 2280 t
-10 CW f
-(y)3397 2280 w
-10 R f
-( breaking out the pieces of)5 1056( task of)2 296(. The)1 231 3 3457 2280 t
-( simple procedural code that does not use any advanced technology such as)12 3077(the line is left to explicit code,)6 1243 2 720 2400 t
-( peculiarity becomes more evident if the problem is)8 2234( This)1 250( manipulation.)1 600(regular expressions for string)3 1236 4 720 2520 t
-(rephrased to demand that each horizontal run of rectangles be folded into a single rectangle:)14 3669 1 720 2640 t
-10 CW f
-(BEGIN{)1080 2820 w
-(y=1)1330 2940 w
-(})1080 3060 w
-(/^/{)1080 3180 w
-(for\(x=1; x<=length\($0\); x++\))2 1680 1 1330 3300 t
-(if\(substr\($0, x, 1\)=="#"\){)2 1560 1 1580 3420 t
-(x0=x;)1830 3540 w
-(while\(++x<=length\($0\) && substr\($0, x, 1\)=="#"\))4 2820 1 1830 3660 t
-(;)2080 3780 w
-(print "rect", x0, y, x, y+1)5 1620 1 1830 3900 t
-(})1580 4020 w
-(y++)1330 4140 w
-(})1080 4260 w
-10 R f
-( In)1 133(Here a considerable amount of code is being spent to do a job a regular expression could do very simply.)19 4187 2 720 4440 t
-(fact, the only regular expression in the program is)8 2044 1 720 4560 t
-10 CW f
-(^)2796 4560 w
-10 R f
-( ver\255)1 191( \(Newer)1 354( input.)1 262(, which is almost irrelevant to the)6 1377 4 2856 4560 t
-(sions of)1 324 1 720 4680 t
-10 CW f
-(awk)1079 4680 w
-10 R f
-(have mechanisms to use regular expressions within actions, but even there the relationship)12 3746 1 1294 4680 t
-(between the patterns that match text and the actions that manipulate the text is still too weak.\))16 3743 1 720 4800 t
-10 CW f
-(Awk's)970 4956 w
-10 R f
-(patterns)1302 4956 w
-10 S1 f
-(\320)1650 4956 w
-10 R f
-( in slashes)2 427(the text)1 304 2 1782 4956 t
-10 CW f
-(//)2546 4956 w
-10 R f
-(that select the input on which to run the actions, the pro\255)11 2341 1 2699 4956 t
-( braces)1 280(grams in the)2 498 2 720 5076 t
-10 CW f
-({})1524 5076 w
-10 S1 f
-(\320)1670 5076 w
-10 R f
-( But)1 196(pass to the actions the entire line containing the text matched by the pattern.)13 3048 2 1796 5076 t
-( that)1 176( Imagine)1 378( can only be a line.)5 759(much of the power of this idea is being wasted, since the matched text)13 2801 4 720 5196 t
-10 CW f
-(awk)4860 5196 w
-10 R f
-( so the patterns instead passed precisely the text they matched, with no implicit line bound\255)15 3761(were changed)1 559 2 720 5316 t
-( first program could then be written:)6 1448(aries. Our)1 418 2 720 5436 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 2 2
-%%Page: 3 3
-/saveobj save def
-mark
-3 pagesetup
-10 R f
-(\255 3 \255)2 166 1 2797 480 t
-10 CW f
-(BEGIN{)1080 900 w
-(x=1)1330 1020 w
-(y=1)1330 1140 w
-(})1080 1260 w
-(/ /{)1 240 1 1080 1380 t
-(x++)1330 1500 w
-(})1080 1620 w
-(/#/{)1080 1740 w
-(print "rect", x, x+1, y, y+1)5 1680 1 1330 1860 t
-(x++)1330 1980 w
-(})1080 2100 w
-(/\\n/{)1080 2220 w
-(x=1)1330 2340 w
-(y++)1330 2460 w
-(})1080 2580 w
-10 R f
-( regular expressions to break out complete strings of blanks and)10 2606(and the second version could use)5 1342 2 720 2760 t
-10 CW f
-(#)4699 2760 w
-10 R f
-('s sim\255)1 281 1 4759 2760 t
-(ply:)720 2880 w
-10 CW f
-(BEGIN{)1080 3060 w
-(x=1)1330 3180 w
-(y=1)1330 3300 w
-(})1080 3420 w
-(/ +/{)1 300 1 1080 3540 t
-(x+=length\($0\))1330 3660 w
-(})1080 3780 w
-(/#+/{)1080 3900 w
-(print "rect", x, x+length\($0\), y, y+1)5 2220 1 1330 4020 t
-(x+=length\($0\))1330 4140 w
-(})1080 4260 w
-(/\\n/{)1080 4380 w
-(x=1)1330 4500 w
-(y++)1330 4620 w
-(})1080 4740 w
-10 R f
-( are)1 148(In these programs, regular expressions are being used to do more than just select the input, the way they)18 4172 2 720 4920 t
-(used in all the traditional)4 1050 1 720 5040 t
-9 R f
-(UNIX)1806 5040 w
-10 R f
-( the expressions are doing a simple parsing \(or at least a)11 2375(tools. Instead,)1 596 2 2069 5040 t
-( expressions are called)3 900( Such)1 250(breaking into lexical tokens\) of the input.)6 1651 3 720 5160 t
-10 I f
-(structural regular expressions)2 1213 1 3547 5160 t
-10 R f
-(or just)1 254 1 4786 5160 t
-10 I f
-(structural expressions.)1 911 1 720 5280 t
-10 R f
-( notably shorter than the originals, but they are conceptually simpler, because)11 3125(These programs are not)3 945 2 970 5436 t
-( The)1 208(the structure of the input is expressed in the structure of the programs, rather than in procedural code.)17 4112 2 720 5556 t
-( between the patterns and the actions: the patterns select portions of the input)13 3102(labor has been cleanly divided)4 1218 2 720 5676 t
-( actions contain no code to disassemble the input.)8 1979( The)1 205(while the actions operate on them.)5 1370 3 720 5796 t
-(The lexical analysis generator)3 1233 1 970 5952 t
-10 CW f
-(lex)2241 5952 w
-10 R f
-( but its)2 301(uses regular expressions to define the structure of text,)8 2280 2 2459 5952 t
-( \(its output must be run through the C)8 1594(implementation is poor, and since it is not an interactive program)10 2726 2 720 6072 t
-( conve\255)1 302( even ignoring issues of speed and)6 1400( But)1 200(compiler\) it has largely been forgotten as a day\255to\255day tool.)9 2418 4 720 6192 t
-(nience,)720 6312 w
-10 CW f
-(lex)1041 6312 w
-10 R f
-( the next)2 364( As)1 171( structural expressions.)2 938(still misses out on one of the most important aspects of)10 2310 4 1257 6312 t
-( be nested to describe the structure of a file recursively, with)11 2510(section illustrates, structural expressions can)4 1810 2 720 6432 t
-(surprising results.)1 711 1 720 6552 t
-10 B f
-(Interactive Text Editing)2 1027 1 720 6792 t
-10 R f
-(It is ironic that)3 589 1 970 6948 t
-9 R f
-(UNIX)1583 6948 w
-10 R f
-( typ\255)1 188(files are uninterpreted byte streams, yet the style of programming that most)11 3018 2 1834 6948 t
-(ifies)720 7068 w
-9 R f
-(UNIX)925 7068 w
-10 R f
-( imposed on files)3 713(has a fairly rigid structure)4 1071 2 1185 7068 t
-10 S1 f
-(\320)3003 7068 w
-10 R f
-( silent limits)2 514( \(The)1 247(arrays of not\255too\255long lines.)3 1142 3 3137 7068 t
-( the)1 153( Although)1 434( line lengths by most tools can be frustrating.\))8 1883(placed on)1 390 4 720 7188 t
-10 CW f
-(awk)3611 7188 w
-10 R f
-(variant introduced above does)3 1218 1 3822 7188 t
-(not exist, there is an interactive text editor,)7 1706 1 720 7308 t
-10 CW f
-(sam)2451 7308 w
-10 R f
-(, that treats its files as simple byte streams.)8 1710 1 2631 7308 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 3 3
-%%Page: 4 4
-/saveobj save def
-mark
-4 pagesetup
-10 R f
-(\255 4 \255)2 166 1 2797 480 t
-(The)970 840 w
-10 CW f
-(sam)1153 840 w
-10 R f
-(command language looks much like that of)6 1744 1 1361 840 t
-10 CW f
-(ed)3133 840 w
-10 R f
-(, but the details are different because)6 1483 1 3253 840 t
-10 CW f
-(sam)4764 840 w
-10 R f
-(is)4973 840 w
-( example, the simple address)4 1151( For)1 189(not line\255oriented.)1 688 3 720 960 t
-10 CW f
-(/string/)1080 1140 w
-10 R f
-( there are short\255)3 646( Although)1 434( not the next line containing ``string''.)6 1565(matches the next occurrence of ``string'',)5 1675 4 720 1320 t
-(hands to simplify common actions, the idea of a line must be stated explicitly in)14 3196 1 720 1440 t
-10 CW f
-(sam)3941 1440 w
-10 R f
-(.)4121 1440 w
-10 CW f
-(Sam)970 1596 w
-10 R f
-(has the same simple text addition and modification commands)8 2509 1 1177 1596 t
-10 CW f
-(ed)3713 1596 w
-10 R f
-(has:)3860 1596 w
-10 CW f
-(a)4048 1596 w
-10 R f
-(adds text after the cur\255)4 905 1 4135 1596 t
-(rent location,)1 527 1 720 1716 t
-10 CW f
-(i)1272 1716 w
-10 R f
-(adds text before it,)3 743 1 1357 1716 t
-10 CW f
-(d)2125 1716 w
-10 R f
-(deletes it, and)2 552 1 2210 1716 t
-10 CW f
-(c)2787 1716 w
-10 R f
-(replaces it.)1 432 1 2872 1716 t
-(Unlike in)1 376 1 970 1872 t
-10 CW f
-(ed)1372 1872 w
-10 R f
-(, the current location in)4 933 1 1492 1872 t
-10 CW f
-(sam)2451 1872 w
-10 R f
-( simplifies some)2 660( This)1 230( \(and usually isn't\) a line.)5 1031(need not be)2 462 4 2657 1872 t
-( example,)1 397( For)1 198(operations considerably.)1 985 3 720 1992 t
-10 CW f
-(ed)2334 1992 w
-10 R f
-( a file.)2 268(has several ways to delete all occurrences of a string in)10 2284 2 2488 1992 t
-(One method is)2 583 1 720 2112 t
-10 CW f
-(g/string/ s///g)1 900 1 1080 2292 t
-10 R f
-( substitute command is used to delete text within a line, while a delete command is)15 3369(It is symptomatic that a)4 951 2 720 2472 t
-( deleted contains a newline, this technique doesn't work.)8 2271( if the string to be)5 718( Also,)1 266(used to delete whole lines.)4 1065 4 720 2592 t
-( just an array of characters, but some characters are more equal than others.\))13 3310(\(A file is)2 395 2 720 2712 t
-10 CW f
-(Sam)4496 2712 w
-10 R f
-(is more)1 318 1 4722 2712 t
-(forthright:)720 2832 w
-10 CW f
-(x/string/d)1080 3012 w
-10 R f
-(The)720 3192 w
-10 CW f
-(x)905 3192 w
-10 R f
-( runs the subsequent command)4 1256(\(`extract'\) command searches for each occurrence of the pattern, and)9 2789 2 995 3192 t
-( that this is subtly different)5 1075( Note)1 244( \(not to the line containing the match\).)7 1532(with the current text set to the match)7 1469 4 720 3312 t
-(from)720 3432 w
-10 CW f
-(ed)940 3432 w
-10 R f
-('s)1060 3432 w
-10 CW f
-(g)1159 3432 w
-10 R f
-(command:)1246 3432 w
-10 CW f
-(x)1695 3432 w
-10 R f
-(extracts the complete text for the command,)6 1767 1 1782 3432 t
-10 CW f
-(g)3576 3432 w
-10 R f
-( is also)2 282( There)1 284(merely selects lines.)2 811 3 3663 3432 t
-(a complement to)2 666 1 720 3552 t
-10 CW f
-(x)1411 3552 w
-10 R f
-(, called)1 288 1 1471 3552 t
-10 CW f
-(y)1784 3552 w
-10 R f
-(, that extracts the pieces)4 956 1 1844 3552 t
-10 I f
-(between)2825 3552 w
-10 R f
-(the matches of the pattern.)4 1056 1 3177 3552 t
-(The)970 3708 w
-10 CW f
-(x)1151 3708 w
-10 R f
-(command is a loop, and)4 956 1 1237 3708 t
-10 CW f
-(sam)2220 3708 w
-10 R f
-(has a corresponding conditional command, called)5 1990 1 2427 3708 t
-10 CW f
-(g)4444 3708 w
-10 R f
-(\(unrelated to)1 509 1 4531 3708 t
-10 CW f
-(ed)720 3828 w
-10 R f
-('s)840 3828 w
-10 CW f
-(g)937 3828 w
-10 R f
-(\):)997 3828 w
-10 CW f
-(g/pattern/command)1080 4008 w
-10 R f
-( that it does not loop, and it does not change)10 1783( Note)1 246( matches the pattern.)3 832(runs the command if the current text)6 1459 4 720 4188 t
-( lines con\255)2 424( the command to print all)5 1033( Hence)1 309(the current text; it merely selects whether a command will run.)10 2554 4 720 4308 t
-(taining a string is)3 692 1 720 4428 t
-10 CW f
-(x/.*\\n/ g/string/p)1 1080 1 1080 4608 t
-10 S1 f
-(\320)720 4788 w
-10 R f
-( reverse conditional is)3 891( The)1 209( contains the string.)3 795(extract all the lines, and print each one that)8 1740 4 848 4788 t
-10 CW f
-(v)4512 4788 w
-10 R f
-(, so to print)3 468 1 4572 4788 t
-(all lines containing `rob' but not `robot':)6 1621 1 720 4908 t
-10 CW f
-(x/.*\\n/ g/rob/ v/robot/p)2 1440 1 1080 5088 t
-10 R f
-(A more dramatic example is to capitalize all occurrences of words `i':)11 2790 1 720 5268 t
-10 CW f
-(x/[A\255Za\255z]+/ g/i/ v/../ c/I/)3 1680 1 1080 5448 t
-10 S1 f
-(\320)720 5628 w
-10 R f
-( more characters, and change the)5 1316(extract all the words, find those that contain `i', reject those with two or)13 2878 2 846 5628 t
-( people have overcome the dif\255)5 1253( Some)1 282(string to `I' \(borrowing a little syntax from the substitute command\).)10 2785 3 720 5748 t
-( expressions,)1 530(ficulty of selecting words or identifiers using regular expressions by adding notation to the)13 3790 2 720 5868 t
-( the precise definition of `identifier' is immutable in the implementation.)10 3006(which has the disadvantage that)4 1314 2 720 5988 t
-(With)720 6108 w
-10 CW f
-(sam)945 6108 w
-10 R f
-(, the definition is part of the program and easy to change, although more long\255winded.)14 3442 1 1125 6108 t
-(The program to capitalize `i's should be writable as)8 2057 1 970 6264 t
-10 CW f
-(x/[A\255Za\255z]+/ g/^i$/ c/I/)2 1440 1 1080 6444 t
-10 R f
-(That is, the definition of)4 977 1 720 6624 t
-10 CW f
-(^)1724 6624 w
-10 R f
-(and)1811 6624 w
-10 CW f
-($)1982 6624 w
-10 R f
-( compatibility and because of)4 1188( For)1 192( input.)1 259(should reflect the structure of the)5 1332 4 2069 6624 t
-(some problems in the implementation, however,)5 1929 1 720 6744 t
-10 CW f
-(^)2674 6744 w
-10 R f
-(and)2759 6744 w
-10 CW f
-($)2928 6744 w
-10 R f
-(in)3013 6744 w
-10 CW f
-(sam)3116 6744 w
-10 R f
-(always match line boundaries.)3 1209 1 3321 6744 t
-(In)970 6900 w
-10 CW f
-(ed)1078 6900 w
-10 R f
-( each global is still)4 754(, it would not be very useful to nest global commands because the `output' of)14 3088 2 1198 6900 t
-( However,)1 445(a line.)1 249 2 720 7020 t
-10 CW f
-(sam)1444 7020 w
-10 R f
-( benefit comes from separating)4 1256( \(This)1 266('s extract commands can be nested effectively.)6 1894 3 1624 7020 t
-( problem of changing all occurrences of the variable)8 2131( the)1 152( Consider)1 416(the notions of looping and matching.\))5 1530 4 720 7140 t
-10 CW f
-(n)4980 7140 w
-10 R f
-(in a C program to some other name, say)8 1595 1 720 7260 t
-10 CW f
-(num)2340 7260 w
-10 R f
-( method above will work)4 999(. The)1 230 2 2520 7260 t
-10 S1 f
-(\320)3774 7260 w
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 4 4
-%%Page: 5 5
-/saveobj save def
-mark
-5 pagesetup
-10 R f
-(\255 5 \255)2 166 1 2797 480 t
-10 CW f
-(x/[a\255zA\255Z0\2559]+/ g/n/ v/../ c/num/)3 1980 1 1080 900 t
-10 S1 f
-(\320)720 1080 w
-10 R f
-( are places in C where the `identifier')7 1508(except that there)2 663 2 847 1080 t
-10 CW f
-(n)3046 1080 w
-10 R f
-(occurs but not as a variable, in particular as the)9 1906 1 3134 1080 t
-(constant)720 1200 w
-10 CW f
-(\\n)1081 1200 w
-10 R f
-( cou\255)1 204( prevent incorrect changes, the command can be prefixed by a)10 2503( To)1 164(in characters or strings.)3 940 4 1229 1200 t
-(ple of)1 230 1 720 1320 t
-10 CW f
-(y)975 1320 w
-10 R f
-(commands to weed out characters and strings:)6 1841 1 1060 1320 t
-10 CW f
-(y/".*"/ y/'.*'/ x/[a\255zA\255Z0\2559]+/ g/n/ v/../ c/num/)5 2940 1 1080 1500 t
-10 R f
-(This example illustrates the power of composing extractions and conditionals, but it is not artificial: it)15 4070 1 970 1716 t
-(was encountered when editing a real program \(in fact,)8 2192 1 720 1836 t
-10 CW f
-(sam)2942 1836 w
-10 R f
-( with shell pipe\255)3 659( is an obvious analogy)4 914(\). There)1 345 3 3122 1836 t
-(lines, but these command)3 1019 1 720 1956 t
-10 I f
-(chains)1765 1956 w
-10 R f
-(are subtly)1 393 1 2052 1956 t
-10 S1 f
-(\320)2472 1956 w
-10 R f
-(and importantly)1 638 1 2599 1956 t
-10 S1 f
-(\320)3264 1956 w
-10 R f
-( flows into)2 432( Data)1 240(different from pipelines.)2 977 3 3391 1956 t
-( chains, the data flow is implicit:)6 1338( In)1 138( pipeline and emerges transformed from the right end.)8 2194(the left end of a)4 650 4 720 2076 t
-( commands are operating on the same data \(except that the last element of the chain may modify the)18 4070(all the)1 250 2 720 2196 t
-( is being)2 345( What)1 269( flows through the chain.)4 1008(text\); the complete operation is done in place; and no data actually)11 2698 4 720 2316 t
-( in the)2 262(passed from link to link in the chain is a view of the data, until it looks right for the final command)21 4058 2 720 2436 t
-( data stays the same, only the structure is modified.)9 2045(chain. The)1 446 2 720 2556 t
-10 B f
-(More than one line, and less than one line)8 1771 1 720 2796 t
-10 R f
-(The standard)1 532 1 970 2952 t
-9 R f
-(UNIX)1539 2952 w
-10 R f
-(tools have difficulty handling several lines at a time, if they can do so at all.)15 3237 1 1803 2952 t
-10 CW f
-(Grep)720 3072 w
-10 R f
-(,)960 3072 w
-10 CW f
-(sort)1022 3072 w
-10 R f
-(and)1299 3072 w
-10 CW f
-(diff)1480 3072 w
-10 R f
-( if they could operate on larger)6 1296(work on lines only, although it would be useful)8 1987 2 1757 3072 t
-( as a)2 197(pieces, such)1 491 2 720 3192 t
-10 CW f
-(refer)1443 3192 w
-10 R f
-(database.)1778 3192 w
-10 CW f
-(awk)2206 3192 w
-10 R f
-(can be tricked into accepting multiple\255line records, but then the)9 2619 1 2421 3192 t
-( sub\255pieces \(typically ordinary lines\) by explicit code.)7 2236(actions must break out the)4 1101 2 720 3312 t
-10 CW f
-(sed)4119 3312 w
-10 R f
-(has a unique and)3 704 1 4336 3312 t
-(clumsy mechanism for manipulating multiple lines, which few have mastered.)9 3127 1 720 3432 t
-( a)1 84( Consider)1 426(Structural expressions make it easy to specify multiple\255line actions.)8 2812 3 970 3588 t
-10 CW f
-(refer)4332 3588 w
-10 R f
-(database,)4672 3588 w
-( percent sign and)3 685( line of a record begins with a)7 1210( Each)1 252(which has multi\255line records separated by blank lines.)7 2173 4 720 3708 t
-( the line:)2 366(a character indicating the type of information on)7 1981 2 720 3828 t
-10 CW f
-(A)3100 3828 w
-10 R f
-(for author,)1 429 1 3193 3828 t
-10 CW f
-(T)3655 3828 w
-10 R f
-( with)1 211( Staying)1 364(for title, etc.)2 504 3 3748 3828 t
-10 CW f
-(sam)4860 3828 w
-10 R f
-(notation, the command to search a)5 1370 1 720 3948 t
-10 CW f
-(refer)2115 3948 w
-10 R f
-(database for all papers written by Bimmler is:)7 1828 1 2440 3948 t
-10 CW f
-(x/\(.+\\n\)+/ g/%A.*Bimmler/p)1 1560 1 1080 4128 t
-10 S1 f
-(\320)720 4308 w
-10 R f
-( set of lines containing `Bimm\255)5 1257(break the file into non\255empty sequences of non\255empty lines and print any)11 2937 2 846 4308 t
-( be compatible with the other tools, a `)8 1572( \(To)1 198( after `%A'.)2 486(ler' on a line)3 522 4 720 4428 t
-10 CW f
-(.)3498 4428 w
-10 R f
-( Except)1 331(' does not match a newline.\))5 1151 2 3558 4428 t
-(for the structural expression, this is a regular)7 1836 1 720 4548 t
-10 CW f
-(grep)2589 4548 w
-10 R f
-( that)1 184(operation, implying)1 797 2 2862 4548 t
-10 CW f
-(grep)3877 4548 w
-10 R f
-(could benefit from an)3 889 1 4151 4548 t
-( `stream)1 339( the short term, however, a)5 1147( In)1 149(additional regular expression to define the structure of its input.)9 2685 4 720 4668 t
-10 CW f
-(sam)720 4788 w
-10 R f
-(,' analogous to)2 591 1 900 4788 t
-10 CW f
-(sed,)1516 4788 w
-10 R f
-(would be convenient, and is currently being implemented.)7 2322 1 1781 4788 t
-( example, we can)3 713( For)1 196( search program.)2 681(The ability to compose expressions makes it easy to tune the)10 2480 4 970 4944 t
-(select just the)2 544 1 720 5064 t
-10 I f
-(titles)1289 5064 w
-10 R f
-(of the papers written by Bimmler by applying another extraction:)9 2605 1 1509 5064 t
-10 CW f
-(x/\(.+\\n\)+/ g/%A.*Bimmler/ x/.*\\n/ g/%T/p)3 2400 1 1080 5244 t
-10 R f
-( into individual lines, then prints the lines con\255)8 1912(This program breaks the records with author Bimmler back)8 2408 2 720 5424 t
-(taining)720 5544 w
-10 CW f
-(%T)1023 5544 w
-10 R f
-(.)1143 5544 w
-( examples of multiple\255line components of files that may profitably be extracted,)11 3212(There are many other)3 858 2 970 5700 t
-(such as C functions, messages in mail boxes, paragraphs in)9 2415 1 720 5820 t
-10 CW f
-(troff)3166 5820 w
-10 R f
-( records in on\255line telephone)4 1162(input and)1 381 2 3497 5820 t
-( that, unlike in systems that define file structures)8 1948(books. Note)1 509 2 720 5940 t
-10 I f
-(a priori)1 310 1 3203 5940 t
-10 R f
-(, the structures are applied by the pro\255)7 1527 1 3513 5940 t
-( sometimes a C)3 644( means the structure can change from application to application;)9 2658( This)1 239(gram, not the data.)3 779 4 720 6060 t
-( and sometimes it is just a byte)7 1343(program is an array of functions, but sometimes it is an array of lines,)13 2977 2 720 6180 t
-(stream.)720 6300 w
-( determine the appearance of their input,)6 1627(If the standard commands admitted a structural expression to)8 2443 2 970 6456 t
-( a version of)3 553(many currently annoying problems could become simple: imagine)7 2790 2 720 6576 t
-10 CW f
-(diff)4107 6576 w
-10 R f
-(that could print)2 649 1 4391 6576 t
-( or functions instead of changed lines, or a)8 1710(changed sentences)1 740 2 720 6696 t
-10 CW f
-(sort)3197 6696 w
-10 R f
-(that could sort a)3 647 1 3464 6696 t
-10 CW f
-(refer)4138 6696 w
-10 R f
-(database. The)1 575 1 4465 6696 t
-(case of)1 281 1 720 6816 t
-10 CW f
-(sort)1028 6816 w
-10 R f
-( the input records be described by a struc\255)8 1676(is particularly interesting: not only can the shape of)8 2069 2 1295 6816 t
-( current bewildering maze of options to control the)8 2062( The)1 209(tural expression, but also the shape of the sort key.)9 2049 3 720 6936 t
-( be largely replaced by a structural expression to extract the key from the record, with)15 3434(sort could in principle)3 886 2 720 7056 t
-(multiple expressions to define multiple keys.)5 1794 1 720 7176 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 5 5
-%%Page: 6 6
-/saveobj save def
-mark
-6 pagesetup
-10 R f
-(\255 6 \255)2 166 1 2797 480 t
-10 B f
-(The)720 840 w
-10 CW f
-(awk)912 840 w
-10 B f
-(of the future?)2 582 1 1117 840 t
-10 R f
-(It is entertaining to imagine a version of)7 1622 1 970 996 t
-10 CW f
-(awk)2621 996 w
-10 R f
-( as discussed)2 524( First,)1 263(that applies these ideas throughout.)4 1423 3 2830 996 t
-( For)1 199( to the actions would be defined, rather than merely selected, by the patterns.)13 3196(earlier, the text passed)3 925 3 720 1116 t
-(example,)720 1236 w
-10 CW f
-(/#+/ { print })3 840 1 1080 1416 t
-10 R f
-(would print only)2 667 1 720 1596 t
-10 CW f
-(#)1412 1596 w
-10 R f
-(characters; conventional)1 972 1 1497 1596 t
-10 CW f
-(awk)2494 1596 w
-10 R f
-(would instead print every line containing)5 1640 1 2699 1596 t
-10 CW f
-(#)4364 1596 w
-10 R f
-(characters.)4449 1596 w
-( of using the restrictive idea of a)7 1317( Instead)1 342( parsed.)1 314(Next, the expressions would define how the input is)8 2097 4 970 1752 t
-( instance, in)2 496( For)1 197( demarcate fields.)2 722(field separator, the iterations implied by closures in the expression can)10 2905 4 720 1872 t
-(the program)1 485 1 720 1992 t
-10 CW f
-(/\(.+\\n\)+/ {)1 660 1 1080 2172 t
-10 I f
-(action)1800 2172 w
-10 CW f
-(})2110 2172 w
-10 R f
-( lines, but the outermost closure \(the)6 1481(the action sees groups of)4 999 2 720 2352 t
-10 CW f
-(+)3229 2352 w
-10 R f
-(operator\) examines, and hence can extract,)5 1722 1 3318 2352 t
-(the individual lines.)2 802 1 720 2472 t
-10 CW f
-(ed)1577 2472 w
-10 R f
-( We)1 192( back\255referencing operators.)2 1128(uses parentheses to define sub\255expressions for its)6 1993 3 1727 2472 t
-( to define the `fields' in)5 980(can modify this idea)3 834 2 720 2592 t
-10 CW f
-(awk)2567 2592 w
-10 R f
-(, so)1 147 1 2747 2592 t
-10 CW f
-($1)2927 2592 w
-10 R f
-(defines the first element of the closure \(the first)8 1960 1 3080 2592 t
-(line\),)720 2712 w
-10 CW f
-($2)961 2712 w
-10 R f
-( arrays, so the)3 575( interestingly, the closures could generate indices for)7 2163( More)1 274(the second, and so on.)4 914 4 1114 2712 t
-( say,)1 191(fields would be called,)3 925 2 720 2832 t
-10 CW f
-(input[1])1869 2832 w
-10 R f
-(and so on, perhaps with the unadorned identifier)7 1986 1 2382 2832 t
-10 CW f
-(input)4401 2832 w
-10 R f
-(holding)4734 2832 w
-( generate multi\255dimensional)2 1163( has the advantage that nested closures can)7 1858( This)1 250(the original intact string.)3 1049 4 720 2952 t
-( is some subtlety involving the relationship between)7 2192( \(There)1 331(arrays, which is notationally clean.)4 1456 3 720 3072 t
-10 CW f
-(input)4740 3072 w
-10 R f
-(indices and the order of the closures in the pattern, but the details are not important here.\))16 3571 1 720 3192 t
-(Finally, as in)2 524 1 970 3348 t
-10 CW f
-(sam)1521 3348 w
-10 R f
-( expressions would be applicable to the output of structural expressions;)10 2910(, structural)1 429 2 1701 3348 t
-( following program computes)3 1185( The)1 205( actions.)1 333(that is, we would be able to nest structural expressions inside the)11 2597 4 720 3468 t
-(how many pages of articles Bimmler has written:)7 1967 1 720 3588 t
-10 CW f
-( break into records)3 1140(/\(.+\\n\)+/{ #)1 900 2 1080 3768 t
-( is Bimmler author? \(see text\))5 1800( #)1 300(input ~ /%A.*Bimmler/{)2 1320 3 1330 3888 t
-( extract page numbers)3 1260(/%P.*\([0\2559]+\)\255\([0\2559]+\)/{ #)1 1740 2 1580 4008 t
-(pages+=input[2]\255input[1]+1)1830 4128 w
-(})1580 4248 w
-(})1330 4368 w
-(})1080 4488 w
-(END{)1080 4608 w
-(print pages)1 660 1 1330 4728 t
-(})1080 4848 w
-10 R f
-(Real)720 5028 w
-10 CW f
-(awk)935 5028 w
-10 R f
-( \(that is, regular expressions\) only like)6 1582(uses patterns)1 520 2 1147 5028 t
-10 CW f
-(sam)3282 5028 w
-10 R f
-('s)3462 5028 w
-10 CW f
-(g)3567 5028 w
-10 R f
-(command, but our)2 746 1 3660 5028 t
-10 CW f
-(awk)4439 5028 w
-10 R f
-('s patterns)1 421 1 4619 5028 t
-(are)720 5148 w
-10 CW f
-(x)871 5148 w
-10 R f
-( is why in the pro\255)5 750( This)1 232( we need both to exploit structural expressions well.)8 2110(expressions. Obviously,)1 987 4 961 5148 t
-(gram above the test for whether)5 1276 1 720 5268 t
-10 CW f
-(input)2024 5268 w
-10 R f
-(contains a paper by Bimmler must be written as an explicit pattern)11 2688 1 2352 5268 t
-( separated by a dash, which is how)7 1393( innermost pattern searches for lines containing two numbers)8 2451(match. The)1 476 3 720 5388 t
-10 CW f
-(refer)720 5508 w
-10 R f
-(stores the starting and ending pages of the article.)8 1977 1 1045 5508 t
-( real)1 178( The)1 209(This is a contrived example, of course, but it illustrates the basic ideas.)12 2875 3 970 5664 t
-10 CW f
-(awk)4261 5664 w
-10 R f
-(suffers from a)2 569 1 4471 5664 t
-( making the parsing actions of the)6 1366( would be improved by)4 939( It)1 114(mismatch between the patterns and the actions.)6 1901 4 720 5784 t
-( lan\255)1 185( A)1 127( pattern\255matching abilities available in the actions.)6 2047(patterns visible in the actions, and by having the)8 1961 4 720 5904 t
-(guage with regular expressions should not base its text manipulation on a)11 2928 1 720 6024 t
-10 CW f
-(substr)3673 6024 w
-10 R f
-(function.)4058 6024 w
-10 B f
-(Comments)720 6264 w
-10 R f
-( is a powerful and convenient, if unfa\255)7 1545(The use of regular expressions to describe the structure of files)10 2525 2 970 6420 t
-( current)1 308(miliar, way to address a number of difficulties the)8 2010 2 720 6540 t
-9 R f
-(UNIX)3062 6540 w
-10 R f
-( is obviously around this)4 988( There)1 283(tools share.)1 456 3 3313 6540 t
-( all.)1 172(new notation a number of interesting problems, and I am not pretending to have addressed them)15 4148 2 720 6660 t
-( the possibilities,)2 678(Rather, I have skipped enthusiastically from example to example to indicate the breadth of)13 3642 2 720 6780 t
-( these ideas, and perhaps to)5 1117( hope is to encourage others to think about)8 1730( My)1 193(not the depth of the difficulties.)5 1280 4 720 6900 t
-(apply them to old tools as well as new ones.)9 1760 1 720 7020 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 6 6
-%%Page: 7 7
-/saveobj save def
-mark
-7 pagesetup
-10 R f
-(\255 7 \255)2 166 1 2797 480 t
-10 B f
-(Acknowledgements)720 840 w
-10 R f
-( some of their ideas)4 806(John Linderman, Chris Van Wyk, Tom Duff and Norman Wilson will recognize)11 3264 2 970 996 t
-( hope I have not misrepresented them.)6 1522( I)1 83(in these notes.)2 569 3 720 1116 t
-cleartomark
-showpage
-saveobj restore
-%%EndPage: 7 7
-%%Trailer
-done
-%%Pages: 7
-%%DocumentFonts: Times-Roman Times-Bold Times-Italic Times-Roman Courier
//GO.SYSIN DD ./doc/se.ps
echo ./doc/add.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH ADD 3G
-.SH NAME
-add, sub, mul, divpt, raddp, rsubp, rmul, rdiv, rshift, inset, rcanon, eqpt, eqrect, ptinrect, rectinrect, rectXrect, rectclip, Dx, Dy, Pt, Rect, Rpt \- arithmetic on points and rectangles
-.SH SYNOPSIS
-.nf
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.B
-.ta 12n +12n +12n +12n +12n
-Point add(Point p, Point q)
-.PP
-.B
-Point sub(Point p, Point q)
-.PP
-.B
-Point mul(Point p, int a)
-.PP
-.B
-Point divpt(Point p, int a)
-.PP
-.B
-Rectangle raddp(Rectangle r, Point p)
-.PP
-.B
-Rectangle rsubp(Rectangle r, Point p)
-.PP
-.B
-Rectangle rmul(Rectangle r, int a)
-.PP
-.B
-Rectangle rdiv(Rectangle r, int a)
-.PP
-.B
-Rectangle rshift(Rectangle r, int a)
-.PP
-.B
-Rectangle inset(Rectangle r, int n)
-.PP
-.B
-Rectangle rcanon(Rectangle r)
-.PP
-.B
-int eqpt(Point p, Point q)
-.PP
-.B
-int eqrect(Rectangle r, Rectangle s)
-.PP
-.B
-int ptinrect(Point p, Rectangle r)
-.PP
-.B
-int rectinrect(Rectangle r, Rectangle s)
-.PP
-.B
-int rectXrect(Rectangle r, Rectangle s)
-.PP
-.B
-int rectclip(Rectangle *rp, Rectangle b)
-.PP
-.B
-int Dx(Rectangle r);
-.PP
-.B
-int Dy(Rectangle r);
-.PP
-.B
-Point Pt(int x, int y)
-.PP
-.B
-Rectangle Rect(int x0, int y0, int x1, int y1)
-.PP
-.B
-Rectangle Rpt(Point p, Point q)
-.fi
-.SH DESCRIPTION
-The functions
-.IR Pt ,
-.I Rect
-and
-.I Rpt
-construct geometrical data types from their components.
-These are implemented as functions. (Under Plan 9
-these are implemented as macros.)
-.PP
-.I Add
-returns the Point
-sum of its arguments:
-.BI Pt( p .x+ q .x,
-.IB p .y+ q .y).
-.I Sub
-returns the Point
-difference of its arguments:
-.BI Pt( p .x- q .x,
-.IB p .y- q .y).
-.I Mul
-returns the Point
-.BI Pt( p .x* a ,
-.IB p .y* a ).
-.I Divpt
-returns the Point
-.BI Pt( p .x/ a ,
-.IB p .y/ a ).
-.PP
-.I Raddp
-returns the Rectangle
-.BI Rect(add( r .min,
-.IB p ),
-.BI add( r .max,
-.IB p ))\fR;
-.I rsubp
-returns the Rectangle
-.BI Rpt(sub( r .min,
-.IB p ),
-.BI sub( r .max,
-.IB p ))\fR.
-.I Rmul
-returns the Rectangle
-.BI Rpt(mul( r .min, a ),
-.BI mul( r .max, a ))\fR;
-.I Rdiv
-returns the Rectangle
-.BI Rpt(div( r .min, a ),
-.BI div( r .max, a ))\fR.
-.PP
-.I Rshift
-returns the rectangle
-.I r
-with all coordinates either left-shifted or right-shifted by
-.IR a ,
-depending on whether
-.I a
-is positive or negative, respectively.
-.PP
-.I Inset
-returns the Rectangle
-.BI Rect( r .min.x+ n ,
-.IB r .min.y+ n ,
-.IB r .max.x- n ,
-.IB r .max.y- n ) .
-.PP
-.I Rcanon
-returns a rectangle with the same extent as
-.IR r ,
-canonicalized so that
-.B min.x
-.if t \(<=
-.if n <=
-.BR max.x ,
-and
-.B min.y
-.if t \(<=
-.if n <=
-.BR max.y .
-.PP
-.I Eqpt
-compares its argument Points and returns
-0 if unequal,
-1 if equal.
-.I Eqrect
-does the same for its argument Rectangles.
-.PP
-.I Ptinrect
-returns 1 if
-.I p
-is a point within
-.IR r ,
-and 0 otherwise.
-.PP
-.I Rectinrect
-returns 1 if all the pixels in
-.I r
-are also in
-.IR s ,
-and 0 otherwise.
-.PP
-.I RectXrect
-returns 1 if
-.I r
-and
-.I s
-share any point, and 0 otherwise.
-.PP
-.I Rectclip
-clips in place
-the Rectangle pointed to by
-.I rp
-so that it is completely contained within
-.IR b .
-The return value is 1 if any part of
-.RI * rp
-is within
-.IR b .
-Otherwise, the return value is 0 and
-.RI * rp
-is unchanged.
-.PP
-The functions
-.I Dx
-and
-.I Dy
-give the width (delta x) and height (delta y) of a Rectangle.
-They are implemented as macros.
-.SH SEE ALSO
-.IR graphics (3).
//GO.SYSIN DD ./doc/add.3
echo ./doc/balloc.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH BALLOC 3G
-.SH NAME
-balloc, bfree, rdbitmap, wrbitmap, rdbitmapfile, wrbitmapfile \- allocating, freeing, reading, writing bitmaps
-.SH SYNOPSIS
-.nf
-.PP
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.ta \w'\fLBitmap 'u
-.B
-Bitmap *balloc(Rectangle r, int ldepth)
-.PP
-.B
-void bfree(Bitmap *b)
-.PP
-.B
-void rdbitmap(Bitmap *b, int miny, int maxy, uchar *data)
-.PP
-.B
-void wrbitmap(Bitmap *b, int miny, int maxy, uchar *data)
-.PP
-.B
-Bitmap *rdbitmapfile(int fd)
-.PP
-.B
-void wrbitmapfile(int fd, Bitmap *b)
-.SH DESCRIPTION
-A new bitmap is allocated with
-.BR balloc ;
-it will have the extent and depth given by its arguments,
-and will be filled with zeros. The
-.I id
-field contains the handle of the X
-.B Pixmap
-associated with the bitmap
-and the
-.I cache
-field is zero.
-.I Balloc
-returns 0 if the server has run out of bitmap resources.
-.B Bfree
-frees the resources used by its argument bitmap.
-.PP
-The remaining functions deal with moving groups of pixel
-values between bitmaps and user space or external files.
-There is a fixed format for the bitmap data in user space or on
-external files.
-A pixel with x-coordinate =
-.I x
-in a bitmap with
-.B ldepth
-=
-.I l
-will appear as
-.if t \fIw\fP = 2\u\s8\fIl\fP\s10\d
-.if n w = 2^l
-contiguous bits in a byte, with the pixel's high order bit
-starting at the byte's bit number
-.if t \fIw\fP\(mu(\fIx\fP mod 8/\fIw\fP),
-.if n w*(x mod 8/w),
-where bits within a byte are numbered 0 to 7 from the
-high order to the low order bit.
-If
-.I w
-is greater than 8, it is a multiple of 8, so
-pixel values take up an integral number of bytes.
-A
-.I row
-of bitmap
-.I b
-consists of the byte containing pixel
-.IB b .r.min.x
-and all the bytes up to and including the byte containing pixel
-.IB b .r.max.x\fR\(mi1.
-.PP
-.I Rdbitmap
-reads rows of pixels from bitmap
-.I b
-into
-.IR data .
-The rows read have
-.IR y = ymin , ymin "+1, ... "
-.IR ymax \(mi1.
-Those rows must be within the range allowed by
-.IB b .r.
-.PP
-.B Wrbitmap
-replaces the specified rows of pixels in bitmap
-.I b
-with
-.IR data .
-.PP
-.I Rdbitmapfile
-creates a bitmap from data contained an external file;
-.I fd
-should be a file descriptor obtained by opening such a file for reading.
-The external file should start with 5 ASCII integers:
-.BR ldepth ,
-.BR r.min.x ,
-.BR r.min.y ,
-.BR r.max.x ,
-and
-.BR r.max.y .
-Each number is right-justified in 11 characters, followed by a blank.
-The rows of bitmap data, formatted as described above,
-follow the header.
-The returned bitmap is allocated using
-.I balloc .
-.I Rdbitmapfile
-returns 0 if the server has run out of bitmap resources.
-.PP
-.I Wrbitmapfile
-writes bitmap
-.I b
-onto file descriptor
-.IR fd ,
-which should be open for writing.
-The format is as just described for
-.IR rdbitmapfile .
-.PP
-.I Rdbitmapfile
-and
-.I wrbitmapfile
-don't close
-.IR fd .
-.PP
-.SH DIAGNOSTICS
-Some errors can occur when accessing the internal bitmaps,
-when trying to malloc, or when trying to read or write the
-argument file descriptors;
-the graphics error function (see
-.IR graphics (3))
-is called when this happens.
-.SH "SEE ALSO"
-.IR bitmap (6),
-.IR graphics (3),
-.IR bitblt (3).
//GO.SYSIN DD ./doc/balloc.3
echo ./doc/bitblt.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH BITBLT 3G
-.SH NAME
-bitblt, bitbltclip, copymasked, clipline, point, segment, polysegment, arc, circle, disc, ellipse, texture, border, string, strsize, strwidth, Fcode \- graphics functions
-.SH SYNOPSIS
-.nf
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.ta \w'\fLPoint 'u
-.B
-void bitblt(Bitmap *db, Point dp, Bitmap *sb,
-.B
- Rectangle sr, Fcode f)
-.PP
-.B
-int bitbltclip(void *)
-.PP
-.B
-void copymasked(Bitmap *db, Point dp, Bitmap *sb, Bitmap *mb, Rectangle sr)
-.PP
-.B
-int clipline(Rectangle r, Point *p0, Point *p1);
-.PP
-.B
-void point(Bitmap *b, Point p, int v, Fcode f);
-.PP
-.B
-void segment(Bitmap *b, Point p, Point q, int v, Fcode f)
-.PP
-.B
-void polysegment(Bitmap *b, int n, Point *pp, int v, Fcode f)
-.PP
-.B
-void circle(Bitmap *b, Point p, int r, int v, Fcode f);
-.PP
-.B
-void arc(Bitmap *b, Point p0, Point p1, Point p2, int v, Fcode f);
-.PP
-.B
-void disc(Bitmap *b, Point p, int r, int v, Fcode f);
-.PP
-.B
-void ellipse(Bitmap *b, Point p, int a, int b, int v, Fcode f);
-.PP
-.B
-void texture(Bitmap *b, Rectangle r, Bitmap *t, Fcode f)
-.PP
-.B
-void border(Bitmap *b, Rectangle r, int w, Fcode f)
-.PP
-.B
-Point string(Bitmap *b, Point p, Font *ft, char *s, Fcode f)
-.PP
-.B
-Point strsize(Font *ft, char *s)
-.PP
-.B
-long strwidth(Font *ft, char *s)
-.PP
-.ft L
-.ta 8n +\w'xxxxxxxxxx'u +\w'xxxxxxxxxx'u +\w'xxxxxxxxxx'u +\w'xxxxxxxxxx'u
-enum Fcode {
- Zero, DnorS, DandnotS, notS,
- notDandS, notD, DxorS, DnandS,
- DandS, DxnorS, D, DornotS,
- S, notDorS, DorS, F
-} Fcode;
-.ft P
-.fi
-.SH DESCRIPTION
-.I Bitblt
-(bit-block transfer)
-takes bits from rectangle
-.I sr
-in the
-.I source
-Bitmap,
-.IR sb,
-and overlays them on a congruent rectangle with the
-.B min
-corner at point
-.B dp
-in the
-.I destination
-bitmap,
-.IR db .
-The
-.I f
-parameter says how to compute each destination pixel
-as a function of the source and destination pixels.
-The first sixteen codes in
-.B Fcode
-give all possible boolean operations
-on the source,
-.B S
-and destination
-.BR D .
-The code values have been arranged so that they may be expressed as
-boolean operations on the values
-.B S
-and
-.BR D.
-So, for example,
-.B D|S
-computes the result as the logical
-.I or
-of the destination pixel's old value and the overlaying source pixel's value.
-If pixels are more than one bit deep, the operations are bitwise.
-The
-.B Zero
-and
-.B F
-codes result in new pixel values that are all zeros or all ones, respectively.
-.PP
-If the source and destination bitmaps have different depths,
-the source rectangle is first converted to have the same depth as the
-destination, as follows:
-conversion to a smaller number of bits per pixel is accomplished by
-taking the desired number of high order bits;
-conversion to a larger number of bits per pixel is accomplished by
-putting the small value into the high order bits, and replicating it as many times
-as necessary to fill the lower order bits.
-.PP
-.I Copymasked
-copies rectangle
-.I sr
-in the source bitmap
-.I sb
-to the congruent rectangle with the
-.B min
-corner at point
-.B dp
-in the destination bitmap
-.IR db ,
-masked by
-bitmap
-.I mb .
-This means that
-.I mb
-is overlayed on the destination rectangle, and only pixels corresponding to 1 bits
-in the mask are changed.
-.I Mb
-must be a 1-bit-deep bitmap with origin (0,0) and congruent to
-.IR sr .
-Bitmaps
-.I sb
-and
-.I db
-must have the same depth.
-.PP
-All of the drawing graphics functions clip the rectangle against the
-source and destination bitmaps, so that only
-pixels within the destination bitmap are changed, and none are changed
-that would have come from areas outside the source bitmap.
-.I Bitbltclip
-takes a pointer to the first argument of a
-.I bitblt
-argument list, and modifies
-.I dp
-and
-.I sr
-so that no more clipping is needed.
-.PP
-.I Point
-changes the value of the destination point
-.I p
-in bitmap
-.I b
-according to function code
-.IR f .
-The source is a pixel with
-value
-.IR v .
-It is useful to use
-.B "~0"
-when the maximum pixel value is desired for the source.
-.PP
-.IR Segment ,
-.IR circle ,
-.IR disc ,
-and
-.I ellipse
-all draw in bitmap
-.I b
-with function code
-.I f
-and a source pixel with value
-.IR v .
-.I Arc
-draws a circular arc centered on
-.IR p0 ,
-traveling clockwise from
-.I p1
-to
-.I p2
-or a point on the circle near
-.IR p2 .
-.I Segment
-draws a line segment in bitmap
-.I b
-from point
-.I p
-to
-.IR q .
-The segment is half-open:
-.I p
-is the first point of the segment and
-.I q
-is the first point beyond the segment,
-so adjacent segments sharing endpoints abut.
-.PP
-.I Polysegment
-draws the
-.IR n \-1
-segments joining the
-.I n
-points in the array pointed to by
-.I pp.
-.I Clipline
-clips the line segment from
-.RI * p0
-to
-.RI * p1
-.RI ( p0
-is closed,
-.I p1
-is open)
-to rectangle
-.IR r ,
-adjusting
-.I p0
-and
-.I p1
-so that the segment is within the rectangle and
-.RI * p1
-is closed.
-It returns 0 if none of the segment is in the rectangle, 1 otherwise.
-.PP
-.I Circle
-draws a circle with radius
-.I r
-and center at point
-.IR p .
-.I Disc
-is the same except that it fills the circle.
-.I Ellipse
-draws an ellipse with horizontal semi-axis
-.I a
-and vertical semi-axis
-.IR b.
-.PP
-.I Border
-draws, with function
-.I f
-in bitmap
-.IR b ,
-the rectangular outline with lines of width
-.IR w ,
-fitting just inside rectangle
-.IR r .
-.PP
-.I Texture
-draws, with function
-.I f
-in bitmap
-.IR b ,
-a texture using the
-bitmap specified by
-.IR t .
-The texture bitmap is aligned on
-.IR b 's
-coordinate system so that (0,0) in both coordinate systems coincide,
-and then
-.I t
-is replicated to form a tiling of
-.IR b .
-The tiling is clipped to rectangle
-.I r
-in
-.IR b ,
-and then transferred to
-.I b
-using the specified function.
-.PP
-.I String
-draws the text characters given by the null-terminated (UTF
-encoded) string
-.I s
-into bitmap
-.IR b ,
-using font
-.IR ft.
-The upper left corner of the first character (i.e., a point
-that is
-.IB ft ->ascent
-above the baseline) is placed at point
-.IR p ,
-and subsequent characters are placed on the same baseline, displaced to
-the right by the previous character's
-.BR width .
-The individual characters are
-.IR bitblt 'ed
-into the destination, using drawing function
-.IR f .
-.I String
-returns the point in the destination bitmap after the final character of
-.I s
-(or where the final character would be drawn, assuming no clipping;
-the returned value might be outside the destination bitmap).
-.PP
-The bounding box for text to be drawn with
-.I string
-in font
-.I ft
-can be found with
-.IR strsize ;
-it returns the
-.B max
-point of the bounding box, assuming a
-.B min
-point of (0,0).
-.I Strwidth
-returns the
-.IR x -component
-of the
-.B max
-point.
-.SH SEE ALSO
-.IR graphics (3),
-.IT utf (4).
//GO.SYSIN DD ./doc/bitblt.3
echo ./doc/bitmap.6
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH BITMAP 6
-.SH NAME
-bitmap \- external format for bitmaps
-.SH SYNOPSIS
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.SH DESCRIPTION
-Bitmaps are described in
-.IR graphics (3).
-Fonts and bitmaps are stored in external files
-in machine-independent formats.
-.PP
-Bitmap files are read and written using
-.I rdbitmapfile
-and
-.I wrbitmapfile
-(see
-.IR balloc (3)).
-A bitmap file starts with 5
-decimal strings:
-.BR ldepth ,
-.BR r.min.x ,
-.BR r.min.y ,
-.BR r.max.x ,
-and
-.BR r.max.y .
-Each number is right-justified and blank padded in 11 characters, followed by a blank.
-The rest of the file contains the
-.BR r.max.y \- r.min.y
-rows of bitmap data.
-A
-.I row
-consists of the byte containing pixel
-.B r.min.x
-and all the bytes up to and including the byte containing pixel
-.B r.max.x\fR\(mi1.
-A pixel with x-coordinate =
-.I x
-in a bitmap with
-.B ldepth
-=
-.I l
-will appear as
-.if t \fIw\fP = 2\u\s8\fIl\fP\s10\d
-.if n w = 2^l
-contiguous bits in a byte, with the pixel's high order bit
-starting at the byte's bit number
-.if t \fIw\fP\(mu((\fIx\fP mod 8)/\fIw\fP),
-.if n w*(x mod 8/w),
-where bits within a byte are numbered 0 to 7 from the
-high order to the low order bit.
-If
-.I w
-is greater than 8, it is a multiple of 8, so
-pixel values take up an integral number of bytes.
-Rows contain integral number of bytes, so there may be some unused
-pixels at either end of a row.
-.PP
-The
-.I rdbitmap
-and
-.I wrbitmap
-functions described in
-.IR balloc (3)
-also deal with rows in this format, stored in user memory.
-.PP
-Some small images, in particular 48\(mu48 face files
-and 16\(mu16
-cursors, are stored textually, suitable for inclusion in C source.
-Each line of text represents one scan line as a
-comma-separated sequence of hexadecimal
-bytes, shorts, or words in C format.
-For cursors, each line defines a pair of bytes.
-(It takes two images to define a cursor; each must be stored separately.)
-Face files of one bit per pixel are stored as a sequence of shorts,
-those of larger pixel sizes as a sequence of longs.
-Software that reads these files must deduce the image size from
-the input; there is no header.
-These formats reflect history rather than design.
-.SH "SEE ALSO"
-.IR graphics (3),
-.IR bitblt (3),
-.IR balloc (3),
-.IR font (6)
//GO.SYSIN DD ./doc/bitmap.6
echo ./doc/cachechars.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH CACHECHARS 3G
-.SH NAME
-cachechars, Subfont, Cachesubf, Fontchar, Font \- font utilities
-.SH SYNOPSIS
-.nf
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.ta \w'\fLCacheinfo 'u
-.PP
-.B
-int cachechars(Font *f, char **s, XChar2b *c, int n, int *widp, ushort *fp)
-.fi
-.SH DESCRIPTION
-A
-.I Font
-may contain too many characters to hold in memory
-simultaneously.
-The graphics library and X server
-cooperate to solve this problem by maintaining a cache of recently used
-character images.
-The details of this cooperation need not be known by most programs:
-.I xtbinit
-and its associated
-.I *p9font
-X resource,
-.I rdfontfile,
-.I charwidth,
-.I string,
-and
-.I ffree
-are sufficient for most purposes.
-The routines described below are used internally by the graphics library
-to maintain the font cache.
-.PP
-A
-.B Subfont
-may be considered to be a set of images for a contiguous range of characters,
-stored as a single bitmap
-with the characters
-placed side-by-side on a common baseline.
-It is described by the following data structures.
-.IP
-.EX
-.ta 6n +\w'Fontchar 'u +\w'bottom; 'u
-typedef
-struct Fontchar {
- ushort cwidth; /* width of glyph */
- uchar top; /* first non-zero scan-line */
- uchar bottom; /* last non-zero scan-line */
- char left; /* offset of baseline */
- uchar width; /* advance to next char's origin */
-} Fontchar;
-
-typedef
-struct Subfont {
- short minrow; /* first character row in font (for X subfonts) */
- short mincol; /* first character col in font (for X subfonts) */
- short minchar; /* first char code in font (for X subfonts) */
- short maxchar; /* last char code in font (for X subfonts) */
- short width; /* number of chars in row (for X subfonts) */
- short n; /* number of chars in subfont */
- unsigned char height; /* height of bitmap */
- char ascent; /* top of bitmap to baseline */
- Fontchar *info; /* n+1 character descriptors */
- int id; /* of font */
-} Subfont;
-
-.EE
-.PP
-The actual bitmap for each character is stored on the server
-but the metrics associated with character
-.I c
-are cached locally in
-.B
-subfont->info[\fIc\fP]\fR.
-When a character is displayed at
-.B Point
-.B p
-in a bitmap,
-the character rectangle is placed at
-.BI (p.x+ i ->left,
-.B p.y)
-and the next character of the string is displayed at
-.BI (p.x+ i ->width+( i +1)->left,
-.BR p.y) .
-The baseline of the characters is
-.L ascent
-rows down from the top of the subfont bitmap.
-Each
-.B Fontchar
-has two widths associated with it:
-.I width
-is the width of the rectangular bitmap
-to contain the character;
-.I cwidth
-is the true width of the character, that is,
-the number of pixels between the leftmost and
-rightmost pixels of the character glyph.
-.PP
-A
-.B Font
-consists of an overall height and ascent
-and a collection of subfonts together with the ranges of runes (see
-.IR utf (4))
-they represent.
-Fonts are described by the following structures.
-.IP
-.EX
-.ta 6n +\w'Cachesubf 'u +\w'height; 'u
-typedef
-struct Cachesubf {
- Rune min; /* rune value of 0th char in subfont */
- Rune max; /* rune value+1 of last char in subfont */
- char *name;
- Subfont *f; /* attached subfont */
-} Cachefont;
-
-typedef
-struct Font {
- char *name;
- uchar height; /* max height of bitmap, interline spacing */
- char ascent; /* top of bitmap to baseline */
- char width; /* widest so far; used in caching only */
- char ldepth; /* of images */
- short id; /* of font */
- short nsubf; /* number of subfonts */
- Cachesubf *subf; /* as read from file */
-} Font;
-.EE
-.PP
-The
-.LR height ,
-.LR ascent ,
-and
-.L ldepth
-fields of Font are described in
-.IR graphics (3).
-.L Subf
-contains
-.L nsubf
-pointers to
-.BR Cachesubfs .
-A
-.B Cachesubf
-connects runes
-.L min
-through
-.LR max ,
-inclusive, to the subfont
-.LR name ;
-it corresponds to a line of the file describing the font.
-.PP
-The image for rune
-.I r
-is found in position \fIr\fR\(mi\fLmin\fR\(pl\fLminchar\fR of the subfont.
-.PP
-For each font, the library, with support from the
-graphics server,
-maintains a list of
-subfonts.
-The
-.L width
-of a font is the maximum of the horizontal extents of the characters
-in the cache. [
-.L width
-is unused in the X implementation of libg.]
-.I String
-draws a string by calling
-.I cachechars
-and emitting a sequence of
-X font indices to draw.
-.I Cachechars
-calculates the subfont/index pairs for the characters pointed to by
-.IR *s .
-It calls
-.I getsubfont
-to fetch subfonts which are not yet in the subfont list of
-.IR f .
-.I Cachechars
-translates the character string into a set of subfont/index pairs.
-It loads the character indices into the array
-.IR c ,
-up to a maximum of
-.I n
-indices or the length of the string.
-It also loads the corresponding element of
-.I fp
-with the subfont index for each character.
-.I Cachechars
-returns in
-.I c
-the number of subfont indices emitted,
-updates
-.I *s
-to point to the next character to be processed, and sets
-.I *widp
-to the total width of the characters processed.
-.I Cachechars
-may return before the end of the string if it cannot
-proceed.
-It can return zero if it is unable to make progress because
-a character code does not covered by any subfont range.
-.SH SEE ALSO
-.IR graphics (3),
-.IR balloc (3),
-.IR bitblt (3),
-.IR font (4).
-.SH DIAGNOSTICS
-All of the functions use the graphics error function (see
-.IR graphics (3)).
//GO.SYSIN DD ./doc/cachechars.3
echo ./doc/event.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH EVENT 3G
-.SH NAME
-event, einit, estart, etimer, eread, emouse, ekbd, ecanread, ecanmouse, ecankbd, ereshaped, getrect, menuhit, Event, Mouse, Menu \- graphics events
-.SH SYNOPSIS
-.nf
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.ta \w'\fLunsigned long 'u
-.PP
-.B
-void einit(ulong keys)
-.PP
-.B
-unsigned long event(Event *e)
-.PP
-.B
-Mouse emouse(void)
-.PP
-.B
-int ekbd(void)
-.PP
-.B
-int ecanmouse(void)
-.PP
-.B
-int ecankbd(void)
-.PP
-.B
-unsigned long estart(ulong key, int fd, int n)
-.PP
-.B
-unsigned long etimer(ulong key, int n)
-.PP
-.B
-unsigned long eread(ulong keys, Event *e)
-.PP
-.B
-int ecanread(ulong keys)
-.PP
-.B
-void ereshaped(Rectangle r)
-.PP
-.B
-Rectangle getrect(int but, Mouse *m)
-.PP
-.B
-int menuhit(int but, Mouse *m, Menu *menu)
-.PP
-.ft L
-enum{
- Emouse = 1,
- Ekeyboard = 2,
-}
-.ft P
-.fi
-.SH DESCRIPTION
-These routines provide an interface to multiple sources of input.
-To use them,
-.I einit
-must be called.
-If the argument to
-.I enit
-has the
-.B Emouse
-and
-.B Ekeyboard
-bits set,
-the mouse and keyboard events will be enabled;
-in this case,
-.IR xtbinit
-(see
-.IR graphics (3))
-must have already been called.
-The user must provide a function called
-.IR ereshaped ,
-which will be called whenever the window in which the process
-is running has been reshaped; the argument will be the Rectangle
-for the new window shape, including the border.
-.PP
-As characters are typed on the keyboard, they are read by the
-event mechanism and put in a queue.
-.I Ekbd
-returns the next character from the queue, blocking until the
-queue is non-empty.
-The characters are read by the event mechanism from the keyboard
-so they are available as soon as they are typed.
-.PP
-When the mouse moves or a mouse button is depressed or released,
-a new mouse event is queued by the event mechanism.
-.I Emouse
-returns the next mouse event from the queue, blocking until the
-queue is non-empty.
-.I Emouse
-returns a
-.B Mouse
-structure:
-.IP
-.EX
-.ta 6n +\w'unsigned long 'u
-struct Mouse
-{
- int buttons;
- Point xy;
- unsigned long msec;
-};
-.EE
-.PP
-.B Buttons
-is a bit field;
-.B buttons&1
-is set when the left mouse button is depressed,
-.B buttons&2
-when the middle button is depressed,
-and
-.B buttons&4
-when the right button is depressed.
-The current mouse position is always returned in
-.BR xy .
-.BR Msec
-is the time stamp of the mouse event in units of milliseconds.
-.PP
-.I Ecankbd
-and
-.I ecanmouse
-return non-zero when there are keyboard or mouse events to available
-to be read.
-.PP
-.I Estart
-can be used to register additional file descriptors.
-It takes as arguments the file descriptor to register,
-the maximum length of an event message on that descriptor,
-and a key to be used in accessing the event.
-The key must be a power of 2 and must not confilict with any previous keys.
-If a zero key is given, one which is not used will be chosen and returned.
-.B
-Ekeyboard
-and
-.B Emouse
-are the mouse and keyboard event keys.
-.PP
-.I Etimer
-starts a repeating timer with a period of n milliseconds (default 1 second).
-Only one timer can be started.
-Extra timer events are not queued and the timer channel has no associated data.
-.PP
-.I Eread
-waits for the next event specified by the mask
-.B keys
-of event keys submitted to estart.
-It fills in the appropriate field of the argument
-.B Event
-structure, which looks like:
-.IP
-.EX
-struct Event
-{
- int kbdc;
- Mouse mouse;
- int n;
- uchar data[EMAXMSG];
-}
-.EE
-.PP
-.B Data
-is an array which is large enough to hold a plan 9 protocol message.
-.I Eread
-returns the key for the event which was chosen.
-For example, if a mouse event was read,
-.I Emouse
-will be returned.
-.PP
-.I Event
-waits for the next event of any kind.
-The return is the same as for
-.IR eread .
-.PP
-As described in
-.IR graphics (3),
-the graphics functions are buffered.
-.IR Event ,
-.IR eread ,
-.IR emouse ,
-and
-.I ekbd
-all cause a buffer flush unless there is an event of the
-appropriate type ready to return.
-.PP
-.I Getrect
-is used to prompt the user to sweep a rectangle.
-It should be called with
-.I m
-holding the mouse event that triggered the
-.I getrect
-(or, if none, a
-.B Mouse
-with
-.B buttons
-set to 7).
-It changes to the sweep cursor,
-waits for the buttons to all go up,
-and then waits for button number
-.I but
-to be depressed, marking the initial corner.
-If another button is depressed instead,
-.I getrect
-returns a rectangle
-with zero for both x-coordinates, after
-waiting for all the buttons to be released.
-Otherwise,
-.I getrect
-continually draws the swept rectangle
-until the button is released again, and returns the swept rectangle.
-The mouse structure pointed to by
-.I m
-will contain the final mouse event.
-.PP
-.I Menuhit
-displays a menu and returns a seleced menu item number.
-It should be called with
-.I m
-holding the mouse event that triggered the
-.I menuhit .
-A
-.B Menu
-is a structure:
-.IP
-.EX
-struct Menu
-{
- char **item;
- char *(*gen)(int);
- int lasthit;
-}
-.EE
-.PP
-If
-.B item
-is nonzero, it should be a null-terminated array of the character strings
-to be displayed as menu items.
-Otherwise,
-.B gen
-should be a function that, given an item number, returns the character
-string for that item, or zero if the number is past the end of the list.
-Items are numbered starting at zero.
-.I Menuhit
-waits until
-.I but
-is released, and then returns the number of the selection,
-or \(mi1 for no selection.
-The
-.I m
-argument is filled in with the final mouse event.
-.SH "SEE ALSO"
-.IR graphics (3).
//GO.SYSIN DD ./doc/event.3
echo ./doc/font.4
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH FONT 4
-.SH NAME
-font, subfont \- external format for fonts and subfonts
-.SH SYNOPSIS
-.nf
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.fi
-.SH DESCRIPTION
-Fonts and subfonts are described in
-.IR cachechars (3).
-.PP
-External fonts are described by a plain text file that can be read using
-.I rdfontfile.
-The format of the file is a header followed by any number of
-subfont range specifications.
-The header contains two numbers: the height and the ascent.
-The height is the inter-line spacing and the ascent is the distance
-from the top of the line to the baseline. These numbers are chosen
-to display consistently all the subfonts of the font.
-A subfont range specification contains two numbers and a font name.
-The numbers are the inclusive range of characters covered by the subfont,
-and name specifies the name of an X font suitable for
-.IR getsubfont .
-The minimum number of a covered range is mapped to the first defined
-character of the corresponding subfont.
-Each field must be followed by some white space.
-Each numeric field may be C-format decimal, octal, or hexadecimal.
-.PP
-Subfonts may be loaded using
-.IR getsubfont ,
-see
-.IR graphics (3).
-.SH BUGS
-Some X font names contain spaces which will terminate the field.
-For some fonts this can be worked around by replacing the spaces
-with
-.L `*'
-characters in an attempt to fool the X font name pattern matching mechanism.
-.SH "SEE ALSO"
-.IR graphics (3),
-.IR bitblt (3),
-.IR cachechars (3).
//GO.SYSIN DD ./doc/font.4
echo ./doc/frame.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH FRINIT 3G
-.SH NAME
-frinit, frsetrects, frclear, frcharofpt, frptofchar, frinsert, frdelete, frselect, frselectp, frselectf, frgetmouse \- frames of text
-.SH SYNOPSIS
-.nf
-.B
-#include <u.h>
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.B
-#include <frame.h>
-.PP
-.B
-void frinit(Frame *f, Rectangle r, Font *ft, Bitmap *b);
-.PP
-.B
-void frsetrects(Frame *f, Rectangle r, Bitmap *b);
-.PP
-.B
-void frclear(Frame *f);
-.PP
-.B
-ulong frcharofpt(Frame *f, Point pt);
-.PP
-.B
-Point frptofchar(Frame *f, ulong p);
-.PP
-.B
-void frinsert(Frame *f, Rune *r0, Rune *r1, ulong p);
-.PP
-.B
-int frdelete(Frame *f, ulong p0, ulong p1);
-.PP
-.B
-void frselect(Frame *f, Mouse *m);
-.PP
-.B
-void frselectp(Frame *f, Fcode fc);
-.PP
-.B
-void frselectf(Frame *f, Point p0, Point p1, Fcode c);
-.PP
-.B
-extern void frgetmouse(void);
-.fi
-.SH DESCRIPTION
-This library supports
-.I frames
-of editable text in a single font on bitmap displays, such as in
-.IR sam (1),
-.IR 8\(12 (1),
-and
-.IR 9term (1).
-Frames may hold any character except NUL.
-Long lines are folded and tabs are at fixed intervals.
-.PP
-The user-visible data structure, a
-.BR Frame ,
-is defined in
-.BR <frame.h> :
-.IP
-.EX
-.ta 6n +\w'Rectangle 'u +\w'lastlinefull; 'u
-typedef struct Frame Frame;
-struct Frame
-{
- Font *font; /* of chars in the frame */
- Bitmap *b; /* on which frame appears */
- Rectangle r; /* in which text appears */
- Rectangle entire; /* of full frame */
- Frbox *box;
- ulong p0, p1; /* selection */
- short left; /* left edge of text */
- ushort nbox, nalloc;
- ushort maxtab; /* max size of tab, in pixels */
- ushort nchars; /* # runes in frame */
- ushort nlines; /* # lines with text */
- ushort maxlines; /* total # lines in frame */
- ushort lastlinefull; /* last line fills frame */
- ushort modified; /* changed since frselect() */
-};
-.EE
-.PP
-.B Frbox
-is an internal type and is not used by the interface.
-.B P0
-and
-.B p1
-may be changed by the application provided the selection routines are called
-afterwards to maintain a consistent display.
-.I Maxtab
-determines the size of tab stops.
-.I Frinit
-sets it to 8 times the width of a
-.B 1
-character in the font;
-it may be changed before any text is added to the frame.
-The other elements of the structure are maintained by the library and
-should not be modified directly.
-.PP
-There are no routines in the library to allocate
-.BR Frames ;
-instead the interface assumes that
-.B Frames
-will be components of larger structures.
-.I Frinit
-prepares the
-.B Frame
-.I f
-so characters drawn in it will appear
-in the single
-.B Font
-.I ft.
-It then calls
-.B frsetrects
-to initialize the geometry for the
-.B Frame.
-The
-.B Bitmap
-.I b
-is where the
-.B Frame
-is to be drawn;
-.B Rectangle
-.I r
-defines the limit of the portion of the
-.B Bitmap
-the text will occupy.
-The
-.B Bitmap
-pointer
-may be null, allowing the other routines to be called to maintain the
-associated data structure in, for example, an obscured window.
-.PP
-.I Frclear
-frees the internal structures associated with
-.I f,
-permitting another
-.I frinit
-or
-.I frsetrects
-on the
-.BR Frame .
-If
-.I f
-is to be deallocated, the associated
-.B Font
-and
-.B Bitmap
-must be freed separately.
-.PP
-To reshape a
-.B Frame,
-use
-.I frclear
-and
-.I frinit
-and then
-.I frinsert
-(q.v.) to recreate the display.
-If a
-.B Frame
-is being moved but not reshaped, that is, if the shape of its containing
-rectangle is unchanged, it is sufficient to
-.IR bitblt (3)
-the containing rectangle from the old to the new location and then call
-.I frsetrects
-to establish the new geometry.
-No redrawing is necessary.
-.PP
-.B Frames
-hold text as runes,
-not as bytes.
-.I Frptofchar
-returns the location of the upper left corner of the
-.I p'th
-rune in the
-.B Frame
-.I f.
-If
-.I f
-holds fewer than
-.I p
-runes,
-.I frptofchar
-returns the location of the upper right corner of the last character in
-.I f.
-.I Frcharofpt
-is the inverse: it
-returns the index of the closest rune whose image's upper left corner
-is up and to the left of
-.I pt.
-.PP
-.I Frinsert
-inserts into
-.B Frame
-.I f
-starting at rune index
-.I p
-the runes between
-.I r0
-and
-.I r1.
-.PP
-.I Frdelete
-deletes from the
-.B Frame
-the text between
-.I p0
-and
-.I p1.
-.PP
-.I Frselect
-tracks the mouse to select a contiguous string of text in the
-.BR Frame .
-When called, mouse button 1 should be depressed.
-It will return when the button is released and will set
-.IB f ->p0
-and
-.IB f ->p1
-to the selected range of text.
-.I Frselectf
-and
-.I Frselectp
-modify the display of the selected text.
-.I Frselectf
-highlights the text between
-.I p0
-and
-.I p1
-(which must have been returned by
-.IR frptofochar )
-using
-.B bitblt
-in mode
-.I c.
-.I Frselectp
-is similar but highlights the text from
-.IB f ->p0
-to
-.IB f ->p1 .
-Neither
-.I frselectf
-nor
-.I frselectp
-modifies
-.IB f ->p0
-or
-.IB f ->p1 .
-.PP
-Upon return from
-.I frinsert
-or
-.I frdelete,
-the display will be consistent but
-.IB f ->p0
-and
-.IB f ->p1
-may not point to the desired selection.
-It may be necessary to adjust the selection and use
-.I frselectf
-or
-.I frselectp
-to fix the display.
-.PP
-.I Frgetmouse
-must be provided by the application;
-.I frselect
-calls it to get mouse updates.
-Each call to
-.I frgetmouse
-should update
-the
-.B Mouse
-structure pointed to by
-.I frselect's
-argument
-.I m.
-.I Frgetmouse
-should block until the mouse status has changed.
-.PP
-The text within frames
-is not directly addressable; instead frames are designed to work alongside
-another structure that holds the text.
-The typical application is to display a section of a longer document such
-as a text file or terminal session.
-Only the text that is visible is held by the
-.BR Frame ;
-the application must check
-.BR maxlines ,
-.BR nlines ,
-and
-.B lastlinefull
-to determine, for example, whether new text needs to be appended
-at the end of the
-.B Frame
-after calling
-.BR frdelete .
-.SH SEE ALSO
-.IR graphics (3),
-.IR bitblt (3),
-.IR event (3),
-.IR cachechar (3).
//GO.SYSIN DD ./doc/frame.3
echo ./doc/graphics.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH GRAPHICS 3G
-.SH NAME
-Point, Rectangle, Bitmap, Cursor, xtbinit, bclose, berror, bscreenrect, bflush, clipr, cursorswitch, cursorset, rdfontfile, ffree, charwidth, getsubfont, mkfont, scrollfwdbut \- graphics
-.SH SYNOPSIS
-.nf
-.PP
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.ta \w'\fLRectangle 'u
-.B
-void xtbinit(void (*errfun)(char *), char *class, int *pargc,
-.B
-char **argv, char **fallbacks)
-.PP
-.B
-void bclose(void)
-.PP
-.B
-void berror(char *msg)
-.PP
-.B
-Rectangle bscreenrect(Rectangle *clipr)
-.PP
-.B
-void bflush(void)
-.PP
-.B
-int clipr(Bitmap *b, Rectangle cr)
-.PP
-.B
-void cursorswitch(Cursor *curs)
-.PP
-.B
-void cursorset(Point p)
-.PP
-.B
-Font* rdfontfile(char *name, int ldepth)
-.PP
-.B
-void ffree(Font *f)
-.PP
-.B
-int charwidth(Font *f, Rune r)
-.PP
-.B
-Subfont *getsubfont(char *name)
-.PP
-.B
-Font *mkfont(Subfont *subfont);
-.PP
-.B
-int scrollfwdbut(void);
-.PP
-.B
-extern Bitmap screen
-.PP
-.B
-extern Font *font
-.fi
-.SH DESCRIPTION
-A
-.B Point
-is a location in a bitmap
-(see below),
-such as the screen, and is defined as:
-.IP
-.EX
-.ta 6n
-typedef
-struct Point {
- int x;
- int y;
-} Point;
-.EE
-.PP
-The coordinate system has
-.I x
-increasing to the right and
-.I y
-increasing down.
-.PP
-A
-.B Rectangle
-is a rectangular area in a bitmap.
-.IP
-.EX
-.ta 6n
-typedef
-struct Rectangle {
- Point min; /* upper left */
- Point max; /* lower right */
-} Rectangle;
-.EE
-.PP
-By definition,
-.B min.x <= max.x
-and
-.BR "min.y <= max.y" .
-By convention, the right (maximum
-.IR x )
-and bottom (maximum
-.IR y )
-edges are
-excluded from the represented rectangle, so abutting rectangles have no
-points in common.
-Thus,
-.B max
-contains the coordinates of the first point beyond the rectangle.
-.PP
-A
-.B Bitmap
-holds a rectangular image.
-.IP
-.EX
-.ta 6n +\w'Rectangle 'u +\w'ldepth; 'u
-typedef
-struct Bitmap {
- Rectangle r; /* rectangle in data area, local coords */
- Rectangle clipr; /* clipping region */
- int ldepth; /* log base 2 of number of bits per pixel */
- int id; /* id as known in the X server */
- Bitmap* cache; /* zero; distinguishes bitmap from layer */
- int flag; /* flag used by X implementation of libg */
-} Bitmap;
-.EE
-.PP
-.B R.min
-is the location in the bitmap
-of the upper-leftmost point in the image.
-There are
-.if t .I 2\u\s8ldepth\s10\d
-.if n 2^ldepth
-contiguous bits for each pixel of the image;
-the bits form a binary number giving the pixel value.
-.L Clipr
-is the clipping rectangle; typically it is the same as
-.B r
-except in a window, where it is inset by the width of
-the border.
-Graphical operations on the
-.B Bitmap
-will be confined to the clipping rectangle.
-The subroutine
-.I Clipr
-sets the clipping rectangle of
-.B b
-to the intersection of
-.B cr
-and
-.BR b->r .
-If
-.I cr
-does not intersect
-.BR b->r
-it does nothing.
-.I Clipr
-returns 1 if the clipping region was set,
-0 if it was not.
-.PP
-A
-.B Font
-is a set of character images, indexed by runes (see
-.IR utf (4)).
-The images are organized into
-.BR Subfont s,
-each containing the images for a small, contiguous set of runes.
-.B Font
-and
-.B Subfont
-structures contain two related fields:
-.LR ascent ,
-the distance from the top of the highest character
-(actually the top of the bitmap holding all the characters)
-to the baseline,
-and
-.LR height ,
-the distance from the top of the highest character to the bottom of
-the lowest character (and hence, the interline spacing).
-The width of any particular character
-.L r
-in a font is returned by
-.IR charwidth.
-The width is defined as the amount to add to the horizontal position
-after drawing the character.
-.I Charwidth
-calls the graphics error function if
-.B r
-is zero (NUL) because
-.B string
-(see
-.IR bitblt (3))
-cannot draw a NUL.
-The other fields are used internally by the text-drawing functions.
-See
-.IR cachechars (3)
-for a detailed description.
-.PP
-.I Rdfontfile
-reads the font description in file
-.I name
-and returns a pointer that can by used by
-.I string
-(see
-.IR bitblt (3))
-to draw characters from the font.
-The
-.I ldepth
-argument specifies how characters will be cached; it should usually
-be the ldepth of the bitmap that will most often be the target of
-.IR string .
-[
-.I ldepth
-is unused in the X implementation of libg.]
-.I Ffree
-frees a font.
-The convention for naming font files is:
-.IP
-.B \fIfontdir\fP/\fIname\fP.\fIrange\fP.\fIsize\fP.font
-.PD
-.PP
-where
-.I size
-is approximately the height in pixels of the lower case letters
-(without ascenders or descenders).
-.I Range
-gives some indication of which characters will be available: for example
-.BR ascii ,
-.BR latin1 ,
-.BR euro ,
-or
-.BR unicode .
-.B Euro
-includes most European languages, punctuation marks, the International Phonetic
-Alphabet, etc., but no Oriental languages.
-.B Unicode
-includes every character for which images exist on the system.
-.PP
-A font is selected by notifying the X server of the location
-of the subfonts and then specifying the desired font file.
-The directory containing the subfonts must be added to the
-server's font search path using the
-.B xset
-command. For example,
-.PP
-.EX
-xset +fp /usr/local/p9snf
-.EE
-.PP
-adds the directory
-.B /usr/local/p9snf
-to the font search path.
-The
-.B p9font
-resource contains the full path name
-of the desired font file; it is usually specified in the
-.B .Xdefaults
-or
-.B .xrdb
-startup file. For example,
-the entry:
-.PP
-.EX
-*p9font: /n/pyxis/usr/local/p9fonts/pelm.unicode.9.font
-.EE
-.PP
-selects the 9-point Pellucida Modern unicode font.
-.PP
-A
-.I Cursor
-is defined:
-.IP
-.EX
-.ta 6n +\w'Point 'u
-typedef struct
-Cursor {
- Point offset;
- uchar clr[2*16];
- uchar set[2*16];
-} Cursor;
-.EE
-.PP
-The arrays are arranged in rows, two bytes per row, left to
-right in big-endian order to give 16 rows
-of 16 bits each.
-A cursor is displayed on the screen by adding
-.B offset
-to the current mouse position, using
-.B clr
-as a mask to zero the pixels where
-.B clr
-is 1, and then setting pixels to ones where
-.B set
-is one.
-.PP
-The function
-.I xtbinit
-should be called before using any graphics operations.
-The
-.I errfun
-argument is a function that will be called with an error message
-argument when the graphics functions detect an error;
-such an error function should not return.
-A zero for the
-.I errfun
-argument means use
-.IR berror ,
-which prints the message and exits.
-The
-.I class
-argument is the name of the class of X application, or zero to
-use the capitalized version of the program name.
-The
-.I pargc
-and
-.I argv
-arguments should be a pointer to the main program's
-.I argc
-and
-.IR argv ;
-any standard toolkit options in the argument list will be used
-to initialize the window's options, and after
-.I xtbinit
-returns, those options will have been removed from the argument list.
-The
-.I fallbacks
-argument, when non-null, specifies a list of fallback resources
-for the application.
-.B Xtbinit
-sets up the global
-.I screen
-to be a bitmap describing the area of the screen that the program
-can use.
-.I Xtbinit
-also initializes the global default
-.IR font .
-By default,
-.I xtbinit
-does not install the standard Plan 9 colourmap, see
-.IR rgbpix (3).
-.PP
-.I Bclose
-releases the resources allocated by
-.I xtbinit
-and the other graphics functions.
-It usually isn't necessary, since the resources will be released
-on program exit. [
-.I Bclose
-is currently unimplemented.]
-.PP
-The
-.IB screen .r
-field is not guaranteed to be always accurate; the
-.I bscreenrect
-function returns the current size
-(see
-.IR event (3)
-to see how to get reshape notification).
-.PP
-The mouse cursor is always displayed.
-The initial cursor is an arrow.
-.I Cursorswitch
-causes the argument cursor to be displayed instead.
-A zero argument causes a switch back to the arrow cursor.
-.I Cursorset
-moves the mouse cursor to position
-.I p,
-provided (if in a window) that the requesting program is
-executing in the current window and the mouse is within
-the window boundaries; otherwise
-.I cursorset
-is a no-op.
-.PP
-The graphics functions described in
-.IR bitblt (3)
-and
-.IR balloc (3)
-are implemented by writing commands to the X server;
-the writes are buffered, so the functions may not take effect immediately.
-.I Bflush
-flushes the buffer, doing all pending graphics operations.
-.I Xtbinit
-arranges that
-.I bflush
-will be called on exit,
-and the following graphics functions all cause a flush:
-.IR balloc ,
-.IR bfree ,
-.IR bscreenrect ,
-.IR cursorset ,
-.IR cursorswitch ,
-.IR ecankbd ,
-.IR ecanmouse ,
-.IR ekbd ,
-.IR emouse ,
-.IR event ,
-.IR rdbitmap ,
-and
-.IR wrbitmap .
-.PP
-.I Getsubfont
-attempts to load the font given by
-.IR name ;
-it returns a pointer to a
-.B Subfont
-struct if it succeeds, zero otherwise,
-see
-.IR font (4).
-The subfont returned by
-.I getsubfont
-may be passed to
-.I mkfont
-to generate a
-.B Font
-suitable for use in
-.IR string .
-.PP
-.I Scrollfwdbut
-returns 3 or 1 depending on which buttons is to be used
-as the forward scrolling button on the mouse.
-The default is to return 3.
-.SH "X DEFAULTS"
-LibXg understands all of the core X Toolkit resource names and
-classes as well as:
-.TP 8
-.B "p9font (\fPclass\fB P9font)"
-Specifies the path name of a font file.
-If the file does not exist or is not a properly formatted
-font file, the default X11 font directory is searched for an
-X11 font of the same name.
-.TP 8
-.B "composeMod (\fPclass\fB ComposeMod)"
-Specifies the modifier key to be used in composing characters.
-The integers 1 to 5 correspond to using modifier keys 1 to 5.
-When this resource is non-zero it is only necessary to press the
-compose modifier once before beginning a compose sequence, i.e.,
-it need not be held down for any of the characters in the sequence.
-A zero for
-.B composeMod
-means use modifier key 1 and this key must be held down in conjuction
-with the first key of the sequence.
-.TP 8
-.B "scrollForwardR (\fPclass\fB ScrollForwardR)"
-The value
-.I true
-for this resource
-reverses the value returned by
-.IR scrollfwdbut ,
-i.e., it returns 3 instead of 1.
-This reverses the scroll direction selected by clicks of the left or
-right mouse buttons in the scrollbar.
-.SH "SEE ALSO"
-.IR add (3),
-.IR balloc (3),
-.IR cachechars (3),
-.IR bitblt (3),
-.IR event (3),
-.IR frame (3),
-.IR rgbpix (3),
-.IR bitmap (4),
-.IR font (4).
-.SH DIAGNOSTICS
-An error function may call
-.IR errstr (2)
-for further diagnostics.
//GO.SYSIN DD ./doc/graphics.3
echo ./doc/keyboard.4
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH KEYBOARD 4
-.SH NAME
-keyboard \- how to type characters
-.SH DESCRIPTION
-Keyboards are idiosyncratic.
-It should be obvious how to type ordinary
-.SM ASCII
-characters,
-backspace, tab, escape, and newline.
-In general, the key labeled
-.B Return
-or
-.B Enter
-generates a newline
-.RB ( 0x0A );
-if there is a key labeled
-.B Line
-.BR Feed ,
-it generates a carriage return
-.RB ( 0x0D );
-CRLFs are not used.
-All control characters are typed in the usual way;
-in particular, control-J is a line feed and control-M a carriage return.
-.PP
-The delete character
-.RB ( 0x7F )
-is usually generated by a key labeled
-.BI Del ,
-.BI Delete ,
-or
-.BI Int .
-.PP
-The view character
-.RB ( 0x80 ),
-.IR sam (1),
-and
-.IR 9term (1),
-causes windows to scroll forward;
-the back-view character
-.RB ( 0x81 ),
-causes windows to scroll backward.
-The view character is generated by the
-\(<- and \(da keys; the back-view character
-is generated by the \(-> and \(ua keys.
-.PP
-Internally, characters are represented as runes (see
-.IR utf (4)).
-Any 16-bit rune can be typed as a multi-character sequence.
-The compose key must be pressed while the first character
-of the sequence is typed; on most terminals, the compose key
-is labeled
-.BI Alt .
-While pressing the compose key, type a capital
-.L X
-and exactly four hexadecimal characters (digits and
-.L a
-to
-.LR f )
-to enter the rune with the value represented by
-the typed number.
-There are two-character shorthands for some characters. The
-compose key must be pressed while typing the first character
-of the pair. The following sequences
-generate the desired rune:
-.IP
-.EX
-.ta 10n +12n +10n +12n +10n +12n +10n +12n +10n
-\(I! !! \(ct c$ \(po l$ \(gc g$
-\($J y$ \(| || \(sc SS \(.. ""
-\(co cO \(Fo sa \(d< << \(no no
-[0xad] -- \(rg rO \(ma __ \(de de
-\(+- +- \(s2 s2 \(s3 s3 \(aa ''
-[0xb5] mi \(pp pg \(cp .. \(cd ,,
-\(s1 s1 \(Mo s0 \(d> >> \(14 14
-\(12 12 \(34 34 \(I? ?? \(`A `A
-\('A 'A \(^A ^A \(~A ~A \("A "A
-\(oA oA \(AE AE \(,C ,C \(`E `E
-\('E 'E \(^E ^E \("E "E \(`I `I
-\('I 'I \(^I ^I \("I "I \(D- D-
-\(~N ~N \(`O `O \('O 'O \(^O ^O
-\(~O ~O \("O "O \(mu mu \(O/ /O
-\(`U `U \('U 'U \(^U ^U \("U "U
-\('Y 'Y \(|P |P \(ss ss \(`a `a
-\('a 'a \(^a ^a \(~a ~a \("a "a
-\(oa oa \(ae ae \(,c ,c \(`e `e
-\('e 'e \(^e ^e \("e "e \('i `i
-\('i 'i \(^i ^i \("i "i \(d- d-
-\(~n ~n \(`o `o \('o 'o \(^o ^o
-\(~o ~o \("o "o \(di -: \(o/ /o
-\(`u `u \('u 'u \(^u ^u \("u "u
-\('y 'y \(|p |p \("y "y \(*a *a
-\(*b *b \(*g *g \(*d *d \(*e *e
-\(*z *z \(*y *y \(*h *h \(*i *i
-\(*k *k \(*l *l \(*m *m \(*n *n
-\(*c *c \(*o *o \(*p *p \(*r *r
-\(ts ts \(*s *s \(*t *t \(*u *u
-\(*f *f \(*x *x \(*q *q \(*w *w
-\(*A *A \(*B *B \(*G *G \(*D *D
-\(*E *E \(*Z *Z \(*Y *Y \(*H *H
-\(*I *I \(*K *K \(*L *L \(*M *M
-\(*N *N \(*C *C \(*O *O \(*P *P
-\(*R *R \(*S *S \(*T *T \(*U *U
-\(*F *F \(*X *X \(*Q *Q \(*W *W
-\(<- <- \(ua ua \(-> -> \(da da
-\(<> ab \(fa fa \(te te \(pd pd
-\(es es [0x2206] De \(gr gr \(!m !m
-[0x220d] st \(** ** \(bu bu \(sr sr
-\(pt pt \(if if \(ag an \(an l&
-\(lo l| \(ca ca \(cu cu \(is is
-\(tf tf [0x2243] ~= \(~= cg [0x2248] ~~
-\(!= != \(== == \(<= <= \(>= >=
-\(sb sb \(sp sp \(!s !b \(ib ib
-\(ip ip \(a+ O+ [0x2296] O- \(ax Ox
-[0x22a2] tu [0x22a8] Tu [0x22c4] lz \(el el
-.EE
-.PP
-Note the difference between \(ss (ss) and [0xb5] (micron) and
-the Greek \(*b and \(*m.
-As well, white and black chess pieces may be escaped using the sequence
-color
-.RB ( w
-or
-.BR b )
-followed by piece
-.RB ( k
-for king,
-.B q
-for queen,
-.B r
-for rook,
-.B n
-for knight,
-.B b
-for bishop, or
-.B p
-for pawn).
-.SH "SEE ALSO"
-.IR ascii (5),
-.IR sam (1),
-.IR 9term (1),
-.IR graphics (3),
-.IR utf (4)
//GO.SYSIN DD ./doc/keyboard.4
echo ./doc/regexp.6
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH REGEXP 6
-.SH NAME
-regexp \- regular expression notation
-.SH DESCRIPTION
-A
-.I "regular expression"
-specifies
-a set of strings of characters.
-A member of this set of strings is said to be
-.I matched
-by the regular expression. In many applications
-a delimiter character, commonly
-.LR / ,
-bounds a regular expression.
-In the following specification for regular expressions
-the word `character' means any character (rune) but newline.
-.PP
-The syntax for a regular expression
-.B e0
-is
-.IP
-.EX
-e3: literal | charclass | '.' | '^' | '$' | '(' e0 ')'
-
-e2: e3
- | e2 REP
-REP: '*' | '+' | '?'
-
-e1: e2
- | e1 e2
-
-e0: e1
- | e0 '|' e1
-.EE
-.PP
-A
-.B literal
-is any non-metacharacter or a metacharacter
-(one of
-.BR .*+?[]()|\e^$ )
-or the delimiter
-preceded by
-.LR \e .
-.PP
-A
-.B charclass
-is a nonempty string
-.I s
-bracketed
-.BI [ \|s\| ]
-(or
-.BI [^ s\| ]\fR);
-it matches any character in (or not in)
-.I s.
-A negated character class never
-matches newline.
-A substring
-.IB a - b ,
-with
-.I a
-and
-.I b
-in ascending
-order, stands for the inclusive
-range of
-characters between
-.I a
-and
-.IR b .
-In
-.I s,
-the metacharacters
-.LR - ,
-.LR ] ,
-an initial
-.LR ^ ,
-and the regular expression delimiter
-must be preceded by a
-.LR \e ;
-other metacharacters
-have no special meaning and
-may appear unescaped.
-.PP
-A
-.L .
-matches any character.
-.PP
-A
-.L ^
-matches the beginning of a line;
-.L $
-matches the end of the line.
-.PP
-The
-.B REP
-operators match zero or more
-.RB ( * ),
-one or more
-.RB ( + ),
-zero or one
-.RB ( ? ),
-instances respectively of the preceding regular expression
-.BR e2 .
-.PP
-A concatenated regular expression,
-.BR "e1\|e2" ,
-matches a match to
-.B e1
-followed by a match to
-.BR e2 .
-.PP
-An alternative regular expression,
-.BR "e0\||\|e1" ,
-matches either a match to
-.B e0
-or a match to
-.BR e1 .
-.PP
-A match to any part of a regular expression
-extends as far as possible without preventing
-a match to the remainder of the regular expression.
-.SH "SEE ALSO"
-.IR awk (1),
-.IR ed (1),
-.IR sam (1),
-.IR sed (1),
-.IR regexp (2)
//GO.SYSIN DD ./doc/regexp.6
echo ./doc/rgbpix.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH RGBPIX 3G
-.SH NAME
-RGB, rgbpix, rdcolmap, wrcolmap
-.SH SYNOPSIS
-.nf
-.PP
-.B
-#include <libc.h>
-.B
-#include <libg.h>
-.PP
-.ta \w'\fLunsigned long 'u
-.B
-unsigned long rgbpix(Bitmap *b, RGB rgb)
-.PP
-.B
-void rdcolmap(Bitmap *b, RGB *map)
-.PP
-.B
-void wrcolmap(Bitmap *b, RGB *map)
-.fi
-.SH DESCRIPTION
-Colors are described by the red, green, and blue
-light intensities, in an
-.B RGB
-datum:
-.IP
-.EX
-.ta 6n
-typedef
-struct RGB {
- unsigned long red;
- unsigned long green;
- unsigned long blue;
-} RGB;
-.EE
-.PP
-Zero intensity means there is no component of the given color;
-hence, black is represented by zero in all three positions and
-white has the maximum unsigned long value in all three positions.
-.PP
-Some of the graphics functions, such as
-.I point
-(see
-.IR bitblt (3)),
-take a
-.I pixel value
-argument, which is a single unsigned long.
-For a given bitmap,
-.I rgbpix
-returns the pixel value with a color closest to
-the color represented by the
-.I rgb
-argument.
-.PP
-There is a
-.I colormap
-associated with each Bitmap. A colormap is an array of
-.BR RGB s,
-of length
-.if t 2\u\s82\u\s6\fIldepth\fP\d\d\s10,
-.if n 2^(2^\fIldepth\fP),
-giving the colors for pixels 0, 1, 2, etc.
-.PP
-.I Rdcolormap
-reads the colormap for the given bitmap into the provided
-.IR map ,
-which must have enough space to hold it.
-.I Wrcolormap
-associates the given colormap with the given bitmap, if possible.
-(The hardware might not allow this.)
-.SH CAVEAT
-The X implementation of libg uses whatever colourmap is
-the default when it starts up.
-A call to
-.I rgbpix
-will result in a call to
-.I XAllocColor
-and the allocation of a new colour in the application's colourmap
-if there is room.
-If no new colours can be allocated
-.I rgbpix
-will return the closest pixel value approximating the requested colour.
-If an application calls
-.I wrcolmap
-the default colourmap is replaced with the new colourmap and from
-then on
-.I rgbpix
-will deal with the new colourmap.
-.SH BUGS
-These functions only work for the screen bitmap.
-This interface will have to be refined for screens with
-ldepth > 3.
-.SH "SEE ALSO"
-.IR graphics (3),
-.IR bitblt (3)
-
//GO.SYSIN DD ./doc/rgbpix.3
echo ./doc/rune.3
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH RUNE 3
-.SH NAME
-runetochar, chartorune, runelen, fullrune, utflen, utfrune, utfrrune, utfutf \- rune/UTF conversion
-.SH SYNOPSIS
-.nf
-.B
-#include <libc.h>
-.B
-int runetochar(char *s, Rune *r)
-.PP
-.B
-int chartorune(Rune *r, char *s)
-.PP
-.B
-int runelen(long r)
-.PP
-.B
-int fullrune(char *s, int n)
-.PP
-.B
-int utflen(char *s)
-.PP
-.B
-char* utfrune(char *s, long c)
-.PP
-.B
-char* utfrrune(char *s, long c)
-.PP
-.B
-char* utfutf(char *s1, char *s2)
-.fi
-.SH DESCRIPTION
-These routines convert to and from a
-.SM UTF
-byte stream and runes.
-.PP
-.I Runetochar
-copies one rune at
-.I r
-to at most
-.B UTFmax
-characters starting at
-.I s
-and returns the number of characters copied.
-.BR UTFmax ,
-defined as
-.B 3
-in
-.BR <libc.h> ,
-is the maximum number of bytes required to represent a rune.
-.PP
-.I Chartorune
-copies at most
-.B UTFmax
-characters starting at
-.I s
-to one rune at
-.I r
-and returns the number of characters copied.
-If the characters are not exactly in
-.SM UTF
-format,
-.I chartorune
-will convert to 0x80 and return 1.
-.PP
-.I Runelen
-returns the number of characters
-required to convert
-.I r
-into
-.SM UTF.
-.PP
-.I Fullrune
-returns 1 if the string
-.I s
-of length
-.I n
-is long enough to be decoded by
-.I chartorune
-and 0 otherwise.
-This does not guarantee that the string
-contains a legal
-.SM UTF
-encoding.
-This routine is used by programs that
-obtain input a character at
-a time and need to know when a full rune
-has arrived.
-.PP
-The following routines are analogous to the
-corresponding string routines with
-.B utf
-substituted for
-.B str
-and
-.B rune
-substituted for
-.BR chr .
-.PP
-.I Utflen
-returns the number of runes that
-are represented by the
-.SM UTF
-string
-.IR s .
-.PP
-.I Utfrune
-.RI ( utfrrune )
-returns a pointer to the first (last)
-occurrence of rune
-.I c
-in the
-.SM UTF
-string
-.IR s ,
-or 0 if
-.I c
-does not occur in the string.
-The NUL character terminating a string is considered to
-be part of the string
-.IR s .
-.PP
-.I Utfutf
-returns a pointer to the first occurrence of
-the
-.SM UTF
-string
-.I s2
-as a
-.SM UTF
-substring of
-.IR s1 ,
-or 0 if there is none.
-If
-.I s2
-is the null string,
-.I utfutf
-returns
-.IR s1 .
-.SH SEE ALSO
-.IR utf (4)
//GO.SYSIN DD ./doc/rune.3
echo ./doc/utf.4
-.de F
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de L
-.B
-.if !"\\$1"" \&\\$1 \\$2 \\$3 \\$4 \\$5 \\$6
-..
-.de FR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de LR
-.BR "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
-..
-.de CW
-.ft B
-..
-.\" This is gross but it avoids relying on internal implementation details
-.\" of the -man macros.
-.de TF
-.IP "" \w'\fB\\$1\ \ \fP'u
-.PD0
-..
-.de EX
-.CW
-.nf
-..
-.de EE
-.fi
-..
-.\" delete above this point if your system has F, L, FR, LR, CW and TF macros
-.TH UTF 4
-.SH NAME
-UTF, Unicode, ASCII, rune \- character set and format
-.SH DESCRIPTION
-The Plan 9 character set and representation are
-based on Unicode and on a proposed X-Open multibyte
-.SM FSS-UCS-TF
-(File System Safe Universal Character
-Set Transformation Format) encoding.
-Unicode represents its characters in 16
-bits;
-.SM FSS-UCS-TF,
-or just
-.SM UTF,
-represent such
-values in an 8-bit byte stream.
-.PP
-In Plan 9, a
-.I rune
-is a 16-bit quantity representing a Unicode character.
-Internally, programs may store characters as runes.
-However, any external manifestation of textual information,
-in files or at the interface between programs, uses a
-machine-independent, byte-stream encoding called
-.SM UTF.
-.PP
-.SM UTF
-is designed so the 7-bit
-.SM ASCII
-set (values hexadecimal 00 to 7F),
-appear only as themselves
-in the encoding.
-Runes with values above 7F appear as sequences of two or more
-bytes with values only from 80 to FF.
-.PP
-The
-.SM UTF
-encoding of Unicode is backward compatible with
-.SM ASCII\c
-:
-programs presented only with
-.SM ASCII
-work on Plan 9
-even if not written to deal with
-.SM UTF,
-as do
-programs that deal with uninterpreted byte streams.
-However, programs that perform semantic processing on
-.SM ASCII
-graphic
-characters must convert from
-.SM UTF
-to runes
-in order to work properly with non-\c
-.SM ASCII
-input.
-See
-.IR rune (2).
-.PP
-Letting numbers be binary,
-a rune x is converted to a multibyte
-.SM UTF
-sequence
-as follows:
-.PP
-01. x in [00000000.0bbbbbbb] \(-> 0bbbbbbb
-.br
-10. x in [00000bbb.bbbbbbbb] \(-> 110bbbbb, 10bbbbbb
-.br
-11. x in [bbbbbbbb.bbbbbbbb] \(-> 1110bbbb, 10bbbbbb, 10bbbbbb
-.br
-.PP
-Conversion 01 provides a one-byte sequence that spans the
-.SM ASCII
-character set in a compatible way.
-Conversions 10 and 11 represent higher-valued characters
-as sequences of two or three bytes with the high bit set.
-Plan 9 does not support the 4, 5, and 6 byte sequences proposed by X-Open.
-When there are multiple ways to encode a value, for example rune 0,
-the shortest encoding is used.
-.PP
-In the inverse mapping,
-any sequence except those described above
-is incorrect and is converted to rune 0080.
-.SH "SEE ALSO"
-.IR ascii (1),
-.IR rune (3),
-.IR keyboard (4),
-.IR "The Unicode Standard" .
//GO.SYSIN DD ./doc/utf.4
echo ./Makefile
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# master makefile for sam. configure sub-makefiles first.
-#
-
-all: lXg lframe samdir samtermdir
-
-lXg:
- cd libXg; $(MAKE)
-lframe:
- cd libframe; $(MAKE)
-
-samdir:
- cd sam; $(MAKE)
-
-samtermdir:
- cd samterm; $(MAKE)
-
-install:
- cd libXg; $(MAKE) install
- cd libframe; $(MAKE) install
- cd sam; $(MAKE) install
- cd samterm; $(MAKE) install
-
-clean:
- cd libXg; $(MAKE) clean
- cd libframe; $(MAKE) clean
- cd sam; $(MAKE) clean
- cd samterm; $(MAKE) clean
-
-nuke:
- cd libXg; $(MAKE) nuke
- cd libframe; $(MAKE) nuke
- cd sam; $(MAKE) nuke
- cd samterm; $(MAKE) nuke
//GO.SYSIN DD ./Makefile
echo ./sam/Makefile
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Makefile for sam
-#
-# define operating system. ONE of:
-# -DIRIX -DSUNOS -DUMIPS -DSYSVR3 -DAIX -DOSF1
-# -DHPUX -DAPOLLO -DCONVEX -DDYNIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX5 -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# Set the name of the environment variable containing the user's home directory
-HOMEDIR=HOME
-
-# RSAMNAME and TERMNAME contain the names of the files containing the
-# sam and samterm executables, respectively. SAMDIR is the directory
-# where sam is to be installed. SAMSAVEDIR is the name of the directory
-# where the samsave file restoration script is stored.
-RSAMNAME=sam
-TERMNAME=/v/bin/samterm
-SAMDIR=/usr/bin
-SAMSAVEDIR=/v/bin
-
-# Set TMP to a good place for tmp files (with lots of room)
-TMP=/tmp
-
-# Set SHELLNAME and SHELLPATH to the name of a shell and the pathname
-# of its executable
-SHELLNAME=sh
-SHELLPATH=/bin/sh
-
-# Set RXNAME and RXPATHNAME to the name of the remote execution command
-# and the pathname of its executable
-RXNAME=rsh
-RXPATHNAME=/usr/bsd/rsh
-
-SAMSAVE=/bin/sh\\n$(SAMSAVEDIR)/samsave
-
-CFLAGS=$(OS) -D_LIBXG_EXTENSION $(INCS)
-
-SYSFLAGS= -DHOMEDIR=\"$(HOMEDIR)\" -DRSAMNAME=\"$(RSAMNAME)\" \
- -DTERMNAME=\"$(TERMNAME)\" -DTMP=\"$(TMP)\" \
- -DSHELLNAME=\"$(SHELLNAME)\" -DSHELLPATH=\"$(SHELLPATH)\" \
- -DRXNAME=\"$(RXNAME)\" -DRXPATHNAME=\"$(RXPATHNAME)\" \
- -DSAMSAVE=\"$(SAMSAVE)\"
-
-LIB=../libframe/libframe.a ../libXg/libXg.a
-CC=cc
-
-OBJ=sam.o address.o buffer.o cmd.o disc.o error.o file.o io.o \
- list.o mesg.o moveto.o multi.o rasp.o regexp.o shell.o \
- string.o sys.o unix.o xec.o
-
-all: sam
-
-sam: $(OBJ) $(LIB)
- $(CC) -o sam $(OBJ) $(LIB)
-
-clean:
- rm -f *.o core
-
-nuke: clean
- rm -f sam
-
-install: sam
- cp sam $(SAMDIR)/$(RSAMNAME)
- cp samsave $(SAMSAVEDIR)/samsave
- chmod +x $(SAMSAVEDIR)/samsave
-
-$(OBJ): sam.h ../include/u.h ../include/libc.h errors.h mesg.h
-
-cmd.o: parse.h
-xec.o: parse.h
-
-unix.o: sam.h ../include/u.h ../include/libc.h errors.h mesg.h
- $(CC) -c $(CFLAGS) $(SYSFLAGS) unix.c
//GO.SYSIN DD ./sam/Makefile
echo ./libframe/Makefile
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Makefile for libframe
-#
-# define operating system. ONE of:
-# -DIRIX -DSUNOS -DUMIPS -DSYSVR3 -DAIX -DOSF1
-# -DHPUX -DAPOLLO -DCONVEX -DDYNIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX5 -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# add name of library orderer - use ":" if none exists
-RANLIB=:
-
-# add name of library
-AR=ar
-
-CFLAGS=-c $(OS) $(INCS) -D_LIBXG_EXTENSION
-
-LIB=libframe.a
-CC=cc
-
-OBJ=frbox.o frdelete.o frdraw.o frinit.o frinsert.o frptofchar.o\
- frselect.o frstr.o frutil.o misc.o
-
-all: $(LIB)
-
-$(LIB): $(OBJ)
- $(AR) rv $(LIB) $(OBJ)
- $(RANLIB) $(LIB)
-
-clean:
- rm -f *.o
-
-nuke: clean
- rm -f $(LIB)
-
-install: $(LIB)
-
-$(OBJ): ../include/u.h ../include/libc.h ../include/frame.h
//GO.SYSIN DD ./libframe/Makefile
echo ./samterm/Makefile
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Makefile for samterm
-#
-# define operating system. ONE of:
-# -DIRIX -DSUNOS -DUMIPS -DSYSVR3 -DAIX -DOSF1
-# -DHPUX -DAPOLLO -DCONVEX -DDYNIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX5 -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# SAMTERM contains the name of the file containing the samterm
-# executable.
-SAMTERM=/v/bin/samterm
-
-# set this if your X libraries are in different locations
-# or if you need extra libraries to load with X11 applications
-XLIBS=-lXt -lX11
-
-CFLAGS=$(OS) $(INCS) -D_LIBXG_EXTENSION
-
-LIBS=../libframe/libframe.a ../libXg/libXg.a
-CC=cc
-
-OBJ=main.o flayer.o icons.o io.o menu.o mesg.o rasp.o scroll.o unix.o
-
-all: samterm
-
-samterm: $(OBJ) $(LIBS)
- $(CC) -o samterm $(OBJ) $(LIBS) $(XLIBS)
-
-clean:
- rm -f *.o core
-
-nuke: clean
- rm -f samterm
-
-install: samterm
- cp samterm $(SAMTERM)
-
-$(OBJ): samterm.h flayer.h ../include/frame.h ../include/libg.h ../include/u.h ../include/libc.h ../sam/mesg.h
//GO.SYSIN DD ./samterm/Makefile
echo ./libXg/Makefile
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Makefile for libXg
-#
-# define operating system. ONE of:
-# -DIRIX -DSUNOS -DUMIPS -DSYSVR3 -DAIX -DOSF1
-# -DHPUX -DAPOLLO -DCONVEX -DDYNIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX5 -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-INCS=-I../include
-
-# set this if your X libraries are in different locations
-# or if you need extra libraries to load with X11 applications
-XLIBS=-lXt
-
-# add name of library orderer - use ":" if none
-RANLIB=:
-
-# add name of librarian
-AR=ar
-
-# the name of the library
-LIB=libXg.a
-
-CFLAGS=$(OS) -D_LIBXG_EXTENSION $(INCS)
-CC=cc
-
-OBJS= arc.o arith.o balloc.o bitblt.o bitbltclip.o border.o bscreenrect.o\
- circle.o clipline.o clipr.o copymasked.o cursorset.o cursorswitch.o\
- disc.o ellipse.o font.o gcs.o getrect.o gwin.o ldconvert.o latin1.o\
- mkfont.o menuhit.o point.o polysegment.o rdbitmap.o rdbitmapfile.o\
- rdfontfile.o rectclip.o rune.o segment.o string.o strwidth.o texture.o\
- wrbitmap.o wrbitmapfile.o xtbinit.o
-
-all install: $(LIB)
-compile: $(LIB)
-test: $(LIB) test.o
- $(CC) -o $@ $? $(LIB) $(XLIBS) -lm
- echo try running test
-clean:
- rm -f *.o test
-
-nuke: clean
- rm -f $(LIB)
-
-$(LIB): $(OBJS)
- $(AR) rv $(LIB) $(OBJS)
- $(RANLIB) $(LIB)
-
-$(LIB)(%.o): %.o
-
-$(OBJS): ../include/libg.h libgint.h ../include/libc.h
//GO.SYSIN DD ./libXg/Makefile
echo ./libregexp/Makefile
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Makefile for libregexp
-#
-# define operating system. ONE of:
-# -DIRIX -DSUNOS -DUMIPS -DSYSVR3 -DAIX -DOSF1
-# -DHPUX -DAPOLLO -DCONVEX -DDYNIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX5 -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# add name of library orderer - use ":" if none exists
-RANLIB=:
-
-# add name of library
-AR=ar
-
-CFLAGS=-c $(OS) $(INCS)
-
-LIB=libregexp.a
-CC=cc
-
-OBJ=regaux.o regcomp.o regerror.o regexec.o regsub.o rregexec.o\
- rregsub.o
-
-all: $(LIB)
-
-$(LIB): $(OBJ)
- $(AR) rv $(LIB) $(OBJ)
- $(RANLIB) $(LIB)
-
-clean:
- rm -f *.o
-
-nuke: clean
- rm -f $(LIB)
-
-install: $(LIB)
-
-test: test.o $(LIB)
- $(CC) test.o $(LIB) ../libframe/libframe.a ../libXg/libXg.a
-
-test2: test2.o $(LIB)
- $(CC) test2.o $(LIB) ../libframe/libframe.a ../libXg/libXg.a
-
-$(OBJ): ../include/u.h ../include/libc.h ../include/regexp.h regcomp.h
//GO.SYSIN DD ./libregexp/Makefile
echo ./sam/Make.irix
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Silicon Graphics Makefile for sam
-#
-# Define operating system type: -DIRIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# Set the name of the environment variable containing the user's home directory
-HOMEDIR=HOME
-
-# RSAMNAME and TERMNAME contain the names of the files containing the
-# sam and samterm executables, respectively. SAMDIR is the directory
-# where sam is to be installed. SAMSAVEDIR is the name of the directory
-# where the samsave file restoration script is stored.
-RSAMNAME=sam
-TERMNAME=/usr/local/bin/samterm
-SAMDIR=/usr/local/bin
-SAMSAVEDIR=/usr/local/bin
-
-# Set TMP to a good place for tmp files (with lots of room)
-TMP=/usr/tmp
-
-# Set SHELLNAME and SHELLPATH to the name of a shell and the pathname
-# of its executable
-SHELLNAME=sh
-SHELLPATH=/bin/sh
-
-# Set RXNAME and RXPATHNAME to the name of the remote execution command
-# and the pathname of its executable
-RXNAME=rsh
-RXPATHNAME=/usr/bsd/rsh
-
-SAMSAVE=/bin/sh\\n$(SAMSAVEDIR)/samsave
-
-CFLAGS=$(OS) -D_LIBXG_EXTENSION $(INCS)
-
-SYSFLAGS= -DHOMEDIR=\"$(HOMEDIR)\" -DRSAMNAME=\"$(RSAMNAME)\" \
- -DTERMNAME=\"$(TERMNAME)\" -DTMP=\"$(TMP)\" \
- -DSHELLNAME=\"$(SHELLNAME)\" -DSHELLPATH=\"$(SHELLPATH)\" \
- -DRXNAME=\"$(RXNAME)\" -DRXPATHNAME=\"$(RXPATHNAME)\" \
- -DSAMSAVE=\"$(SAMSAVE)\"
-
-LIB=../libframe/libframe.a ../libXg/libXg.a
-CC=cc
-
-OBJ=sam.o address.o buffer.o cmd.o disc.o error.o file.o io.o \
- list.o mesg.o moveto.o multi.o rasp.o regexp.o shell.o \
- string.o sys.o unix.o xec.o
-
-all: sam
-
-sam: $(OBJ) $(LIB)
- $(CC) -o sam $(OBJ) $(LIB)
-
-clean:
- rm -f *.o core
-
-nuke: clean
- rm -f sam
-
-install: sam
- cp sam $(SAMDIR)/$(RSAMNAME)
- cp samsave $(SAMSAVEDIR)/samsave
- chmod +x $(SAMSAVEDIR)/samsave
-
-$(OBJ): sam.h ../include/u.h ../include/libc.h errors.h mesg.h
-
-cmd.o: parse.h
-xec.o: parse.h
-
-unix.o: sam.h ../include/u.h ../include/libc.h errors.h mesg.h
- $(CC) -c $(CFLAGS) $(SYSFLAGS) unix.c
//GO.SYSIN DD ./sam/Make.irix
echo ./samterm/Make.irix
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Silicon Graphics Makefile for samterm
-#
-# Define operating system type: -DIRIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# SAMTERM contains the name of the file containing the samterm
-# executable.
-SAMTERM=/usr/local/bin/samterm
-
-# set this if your X libraries are in different locations
-# or if you need extra libraries to load with X11 applications
-XLIBS=/usr/local/X11R5/lib/libXt.a /usr/local/X11R5/lib/libX11.a
-
-CFLAGS=$(OS) $(INCS) -D_LIBXG_EXTENSION
-
-LIBS=../libframe/libframe.a ../libXg/libXg.a
-CC=cc
-
-OBJ=main.o flayer.o icons.o io.o menu.o mesg.o rasp.o scroll.o unix.o
-
-all: samterm
-
-samterm: $(OBJ) $(LIBS)
- $(CC) -o samterm $(OBJ) $(LIBS) $(XLIBS)
-
-clean:
- rm -f *.o core
-
-nuke: clean
- rm -f samterm
-
-install: samterm
- cp samterm $(SAMTERM)
-
-$(OBJ): samterm.h flayer.h ../include/frame.h ../include/libg.h ../include/u.h ../include/libc.h ../sam/mesg.h
//GO.SYSIN DD ./samterm/Make.irix
echo ./libframe/Make.irix
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Silicon Graphics Makefile for libframe
-#
-# Define operating system type: -DIRIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# add name of library orderer - use ":" if none exists
-RANLIB=:
-
-# add name of library
-AR=ar
-
-CFLAGS=-c $(OS) $(INCS) -D_LIBXG_EXTENSION
-
-LIB=libframe.a
-CC=cc
-
-OBJ=frbox.o frdelete.o frdraw.o frinit.o frinsert.o frptofchar.o\
- frselect.o frstr.o frutil.o misc.o
-
-all: $(LIB)
-
-$(LIB): $(OBJ)
- $(AR) rv $(LIB) $(OBJ)
- $(RANLIB) $(LIB)
-
-clean:
- rm -f *.o
-
-nuke: clean
- rm -f $(LIB)
-
-install: $(LIB)
-
-$(OBJ): ../include/u.h ../include/libc.h ../include/frame.h
//GO.SYSIN DD ./libframe/Make.irix
echo ./libXg/Make.irix
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Silicon Graphics Makefile for libXg
-#
-# Define operating system type: -DIRIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-INCS=-I../include
-
-# set this if your X libraries are in different locations
-# or if you need extra libraries to load with X11 applications
-XLIBS=/usr/local/X11R5/lib/libXt.a /usr/local/X11R5/lib/libX11.a
-
-# add name of library orderer - use ":" if none
-RANLIB=:
-
-# add name of librarian
-AR=ar
-
-# the name of the library
-LIB=libXg.a
-
-CFLAGS=$(OS) -D_LIBXG_EXTENSION $(INCS)
-CC=cc
-
-OBJS= arc.o arith.o balloc.o bitblt.o bitbltclip.o border.o bscreenrect.o\
- circle.o clipline.o clipr.o copymasked.o cursorset.o cursorswitch.o\
- disc.o ellipse.o font.o gcs.o getrect.o gwin.o ldconvert.o latin1.o\
- mkfont.o menuhit.o point.o polysegment.o rdbitmap.o rdbitmapfile.o\
- rdfontfile.o rectclip.o rune.o segment.o string.o strwidth.o texture.o\
- wrbitmap.o wrbitmapfile.o xtbinit.o
-
-all install: $(LIB)
-compile: $(LIB)
-test: test.o
- $(CC) -o $@ $? $(LIB) $(XLIBS) -lm
- echo try running test
-clean:
- rm -f *.o test
-
-nuke: clean
- rm -f $(LIB)
-
-$(LIB): $(OBJS)
- $(AR) rv $(LIB) $(OBJS)
- $(RANLIB) $(LIB)
-
-$(LIB)(%.o): %.o
-
-$(OBJS): ../include/libg.h libgint.h ../include/libc.h
//GO.SYSIN DD ./libXg/Make.irix
echo ./libregexp/Make.irix
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Silicon Graphics Makefile for libregexp
-#
-# Define operating system type: -DIRIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# add name of library orderer - use ":" if none exists
-RANLIB=:
-
-# add name of library
-AR=ar
-
-CFLAGS=-c $(OS) $(INCS)
-
-LIB=libregexp.a
-CC=cc
-
-OBJ=regaux.o regcomp.o regerror.o regexec.o regsub.o rregexec.o rregsub.o
-
-all: $(LIB)
-
-$(LIB): $(OBJ)
- $(AR) rv $(LIB) $(OBJ)
- $(RANLIB) $(LIB)
-
-clean:
- rm -f *.o a.out
-
-nuke: clean
- rm -f $(LIB)
-
-install: $(LIB)
-
-test: test.o $(LIB)
- $(CC) test.o $(LIB) ../libframe/libframe.a ../libXg/libXg.a
-
-test2: test2.o $(LIB)
- $(CC) test2.o $(LIB) ../libframe/libframe.a ../libXg/libXg.a
-
-$(OBJ): ../include/u.h ../include/libc.h ../include/regexp.h regcomp.h
//GO.SYSIN DD ./libregexp/Make.irix
echo ./sam/Make.irix5
-# Copyright (c) 1998 Lucent Technologies - All rights reserved.
-#
-# Prototype Makefile for sam
-#
-# define operating system. ONE of:
-# -DIRIX -DSUNOS -DUMIPS -DSYSVR3 -DAIX -DOSF1
-# -DHPUX -DAPOLLO -DCONVEX -DDYNIX
-#
-# Additionally, -D_POSIX_SOURCE (or its equivalent) may be specified
-# if your compiler supports posix-compatible compilation
-OS=-DIRIX5 -ansiposix
-
-# add -Iincludedir for any include directories that need to be searched
-# for posix header files (for UMIPS, add -I/usr/include/posix)
-INCS=-I../include
-
-# Set the name of the environment variable containing the user's home directory
-HOMEDIR=HOME
-
-# RSAMNAME and TERMNAME contain the names of the files containing the
-# sam and samterm executables, respectively. SAMDIR is the directory
-# where sam is to be installed. SAMSAVEDIR is the name of the directory
-# where the samsave file restoration script is stored.
-RSAMNAME=sam
-TERMNAME=/v/bin/samterm
-SAMDIR=/usr/bin
-SAMSAVEDIR=/v/bin
-
-# Set TMP to a good place for tmp files (with lots of room)
-TMP=/tmp
-
-# Set SHELLNAME and SHELLPATH to the name of a shell and the pathname
-# of its executable
-SHELLNAME=sh
-SHELLPATH=/bin/sh
-
-# Set RXNAME and RXPATHNAME to the name of the remote execution command
-# and the pathname of its executable
-RXNAME=rsh
-RXPATHNAME=/usr/bsd/rsh
-
-SAMSAVE=/bin/sh\\n$(SAMSAVEDIR)/samsave
-
-CFLAGS=$(OS) -D_LIBXG_EXTENSION $(INCS)
-
-SYSFLAGS= -DHOMEDIR=\"$(HOMEDIR)\" -DRSAMNAME=\"$(RSAMNAME)
