 
 SLP, the source language input program, is a utility used for source
 file maintenance.
 
 SLP requires two types of input: 1)an input file and 2) command input. The
 input file is the source file you want to update, and the command input
 consists of SLP edit commands and, optionally, new lines of text.
 
 SLP output consists of an output file and a listing file. The output file
 is the updated input file. The listing file is a copy of the output file
 with line numbers added.
 
 The general form of the input to SLP is:
 
    A SLP command line containing the file specification
    A SLP command line followed by optional input lines
                  .
                  .
                  .
 
   / (the slash terminates the SLP edit session)
 
 For example:
 
	MYFILE.MAC;1/AU/-BF,MYFILE/-SP=MYFILE.MAC;1
	-3
	INSERT THIS LINE AFTER LINE 3
	-4,4
	DELETE LINE 4 AND REPLACE IT WITH THIS LINE
	-5,5
	/
 
 For more information on SLP command (file spec) lines, type HELP SLP
 COMMANDINPUT.  For more information on SLP edit command lines, type HELP
 SLP EDITCOMMAND.  For more information on SLP edit command line operators,
 type HELP SLP OPERATORS.  For more information on SLP line locators, type
 HELP SLP LOCATORS.
 
2 COMMANDINPUT
 
 The general form of a SLP command (file spec) line is:
 
	outfile[/switches][,listfile[/switches]]=infile[/switches]
 
 where:
 
 outfile	is the file specification for the output file.
		The output file is the updated input file.
 
 listfile	is the file specification for the listing file.  The listing
		file shows the updates made to the source file. 
 
 infile		is the file specification for the input file.  The input
		file is the file to be updated by SLP.
 
 switches	is one or more or the following optional switches:
 
		/AU[:pos:len]	Specifies that audit trails should be
				generated and start in column "pos" and have
				a length of "len". The defaults are 80 and 8
				respectively.  /AU is the default.
 
		/-AU		Specifies that audit trails should not be
				generated.
 
		/BF		Right-justifies the audit trail by inserting
				spaces at the end of the text information.
				/BF is the default.
 
		/-BF		Right justifies the audit trail by inserting
				tab characters at the end of text information.
 
		/CM[:pos]	Deletes audit trails  and any trailing spaces
				or tabs, and truncates the text at a specified
				horizontal position.  The value given for the
				beginning position of the audit trail is the
				default value for this switch.  The value is
				rounded to the next highest tab stop.
 
		/CS[:n]		Calculates the checksum value for the edit
				commands.  If you do not specify n, SLP
				reports the value in a message on your
				terminal.  If you do specify n and the
				checksum value that SLP calculates is not
				the same as the the one you specified, SLP
				displays a diagnostic error message.
 
		/DB		Generates the listing file in double-
				spaced format. /-DB is the default.
 
		/-DB		Does not generate the listing file in
				double-spaced format.
 
		/NS		Does not sequence the lines in the output 
				file. The /NS switch is the default condition
				and overrides the /SQ and /RS switches.
 
		/RS		Resequences the lines in the output file so
				that the line numbers are incremented for
				each line written to the output file.
 
		/SQ		Sequences the lines in the output file so that
				the numbers reflect the line numbers of the
				original input file.  New lines added to the
				file have the same number as the previous line
 
		/SP		Spools the listing file to the printer.
				/SP is the default.
 
		/-SP		Does not spool the listing file to the printer
 
		/TR		Reports truncation of lines by the audit
				trail.  If line truncation occurs, you will
				get a diagnostic error message.  There is no
				default for this switch.  In the listing file,
				a question mark (?) replaces the line number
				of the line(s) that was truncated.
 
2 OPERATORS
 
 In edit mode, SLP interprets the following characters specially as SLP
 operators when they are entered as the first charater of an input line.
 
 Operator	Function
 
   "-"		SLP interprets the dash as the first character of a
		SLP edit command.
 
   "\"		SLP interprets the backslash as a command to suppress
		audit trail processing.
 
   "%"		SLP interprets the precent sign as a command to
		reenable audit trail processing.
 
   "@"		SLP interprets the at sign as a command to invoke
		an indirect file for SLP processing.
 
   "/"		SLP interprets the slash as a command to terminate
		the SLP edit session and return to SLP command mode.
 
   "<"		SLP interprets the less-than character as an escape
		character.  Escape characters are characters that
		enable you to enter characters in the input file that
		SLP otherwise would interpret as operators.  For
		example, "</" hides the slash character from SLP.
 
2 EDITCOMMAND
 
 The general form of a SLP edit command is:
 
	-[locator1][,locator2][,/audittrail/][;comment]
	   .
	   .
	   .
 
 where:
 
 -		specifies that this is a SLP edit command line
 
 locator1	is a line locator that causes SLP to move the current line
		pointer to a specified line.  If only locator1 is specified,
		the current line pointer is moved to that line and SLP reads
		the next line in the edit command file.  This field can be
		specified using any of the locator forms described below.
 
 locator2	is a line locator that defines a range of lines (that is, the
		range beginning with locator1 and ending with locator2,
		inclusive) to be deleted or replaced.  This field can be
		specified using any of the locator forms described below.
 
 audittrail	is a character string used to keep track of the update status
		of each change in the file.  The string must be enclosed
		within slashes (/).  It consists of a comment delimiter as the
		first character and then a text string.  The semicolon (;) is
		the initial delimiter for audit-trails automatically generated
		by SLP (;**NEW** and ;**-n).  The comment delimiter specified
		in audittrail (usually a semicolon) is the new delimiter for
		all subsequent audit trails until redefined by a later one.
 
 ;comment	terminates the SLP edit command line and provides
		commentary text to the SLP edit command line
 
 Note that all fields in the command line are positional and commas
 must be specified.
 
 For more information on SLP line locators, type HELP SLP LOCATOR.
 
2 LOCATORS
 
 The locator fields can take one of the following forms:
 
	/string/[+n]
	/string...string/[+n]
	-number[+n]
	.[+n]
 
 where:
 
 number		specifies a decimal line number to which the current
		line pointer is to be moved. The largest line number
		that can be specified is 9999.
 
 string		is a string of ASCII characters.  SLP locates the line in
		which string exists and moves the current line pointer to that
		line.  If the locator is specified as /string...string/, SLP
		locates the line in which the two character strings delimit
		a larger character string abbreviated by an ellipsis (...).
 
 n		specifies a decimal value used as an offset from the line
		indicated by the first part of the locator.  It must be
		specified with a string locator or a period (.).
 
 .		SLP interprets the period (.) as the current line
 
 All forms of the line locator can be specified interchangeably in the
 command line.
 
 SLP allows you to move the line pointer sequentially.  Once past a given line
 in the file, you cannot return the line pointer to that line.  To return the
 line pointer to that line, you must close the file and begin another SLP edit

