# The Hessling Editor

# Version 3.3RC4

## TABLE OF CONTENTS

INTRODUCTION
LICENSE
THE BASICS
COMMAND-LINE SWITCHES
PROFILE FILE
COMMANDS
  add add blank line
  alert display a user configurable dialog box with notification
  all select and display restricted set of lines
  backward scroll backward by number of screens or lines
  bottom move to the bottom of the file
  cancel quit from all unaltered files in the ring
  cappend append text after column pointer
  ccancel qquit from all files in the ring
  cdelete delete text starting at column pointer
  cfirst move column pointer to beginning of zone
  change change one string to another
  cinsert insert text starting at the column pointer
  clast move the column pointer to end of zone
  clipboard manipulate system clipboard
  clocate move the column pointer
  cmatch find matching bracket character
  cmsg display text on command line
  command execute a command without translation
  compress reduce spaces to tabs
  controlchar allow control characters to be entered
  copy copies text from one position to another
  coverlay overlay text starting at the column pointer
  creplace replace text starting at the column pointer
  cursor move cursor to specified position
  define assign one or many commands to a key or mouse event
  delete delete lines from a file
  dialog display a user configurable dialog box
  directory list the specified directory as an editable file
  dos execute an operating system command
  dosnowait execute an operating system command - no prompt
  dosquiet execute an operating system command quietly
  down move forward in the file a number of lines
  duplicate duplicate lines
  edit edit another file or switch to next file
  editv set and retrieve persistent macro variables
  emsg display message
  ENTER execute a command
  expand expand tab characters to spaces
  extract obtain various internal information about THE
  ffile force a FILE of the current file to disk
  file write the current file to disk and remove from ring
  fillbox fill the marked block with a character
  find locate forwards the line which begins with the supplied string
  findup locate backwards the line which begins with the supplied string
  forward scroll forward by number of screens or lines
  fup locate backwards the line which begins with the supplied string
  get insert into file the contents of specified file
  help edit help file for THE
  hit simulate hitting of the named key
  input insert the command line contents into the file
  join join a line with the line following
  kedit edit another file or switch to next file
  left scroll the screen to the left
  locate search for a target
  lowercase change uppercase characters to lowercase
  ls list the specified directory as an editable file
  macro execute a macro command file
  mark mark a portion of text
  modify display current SET command for alteration
  move move a portion of text
  msg display message on error line
  next move forward in the file a number of lines
  nextwindow switch focus of editing session to another file
  nfind locate forwards the line which does NOT begin with the supplied string
  nfindup locate backwards the line which does NOT begin with the supplied string
  nfup locate backwards the line which does NOT begin with the supplied string
  nomsg execute a command suppressing any messages
  nop no operation command
  os execute an operating system command
  osnowait execute an operating system command - no prompt
  osquiet execute an operating system command quietly
  osredir execute an operating system command and capture output
  overlaybox overlay marked block on current cursor position
  popup display popup menu
  preserve save various editor settings
  prevwindow switch focus of editing session to another file
  print send text to default printer or print spooler
  put write part of a file to another
  putd write part of a file to another and delete
  qquit exit from the current file without saving changes
  query display various option settings
  quit exit from the current file if no changes made
  readv read keystrokes and pass to macro
  record records all keystrokes into a macro file
  recover recover changed or deleted lines
  redit re-edit the current file
  redraw redraw the current screen
  refresh refresh the contents of the current screen
  repeat repeat the last command
  replace replace the current line with supplied text
  reset cancel the marked block or prefix commands or both
  restore restore various editor settings
  rexx execute Rexx instructions
  rgtleft scroll the screen to the left or right
  right scroll the screen to the right
  save save changes to current file
  schange selectively change strings
  search locate a string
  set execute various set commands
  shift move text left or right
  showkey display current key value and command assignation
  sort sort selected lines in a file
  sos execute various sos commands
  split split a line into two lines
  spltjoin split/join two lines
  ssave force SAVE to specified file
  status display current settings of various variables
  suspend suspend THE and return to operating system
  tabfile edit the file under the file tab or shift FILETABS view
  tag displays lines matching target in different colour
  text simulate keyboard entry of characters
  the edit another file or switch to next file
  toascii convert the target from EBCDIC to ASCII
  top move to the top of the file
  up move backward in the file a number of lines
  uppercase change lowercase characters to uppercase
  xedit edit another file or switch to next file
  ? retrieve - return the next/prior command on the command line
  = re-execute the last command issued on the command line
  ! execute an operating system command
  & execute and re-display command
SET COMMANDS
  set alt change alteration counts
  set arbchar set arbitrary character(s) for targets
  set autocolor specifies which parser to use for syntax highlighting
  set autocolour specifies which parser to use for syntax highlighting
  set autosave set autosave period
  set autoscroll set rate of automatic horizontal scrolling
  set backup indicate if a backup copy of the file is to be kept
  set beep turn on or off the audible alarm when displaying errors
  set boundmark set bounds marker display
  set case set case sensitivity parameters
  set clearerrorkey specify which key clears the message line
  set clearscreen indicate if the screen is to be cleared on exit
  set clock turn on or off display of time on status line
  set cmdarrows sets the behaviour of the up and down arrow keys
  set cmdline sets the position of the command line.
  set color set colors for display
  set colour set colours for display
  set coloring enable or disable syntax highlighting
  set colouring enable or disable syntax highlighting
  set compat set compatibility mode
  set ctlchar define control character attributes
  set curline set position of current line on screen
  set cursorstay set on or off the behaviour of the cursor on a scroll
  set defsort specify the order in which files appear in DIR.DIR
  set dirinclude set the file mask for directory command
  set display specify which level of lines to display
  set ecolor set colors for syntax highlighting
  set ecolour set colours for syntax highlighting
  set eolout set end of line terminating character(s)
  set equivchar set the equivalence character
  set erroroutput indicate whether THE error messages are echoed to screen
  set etmode indicate if extended display mode is possible
  set fext change the extension of the existing file
  set filename change the filename of the file being edited
  set filetabs determine if and where where file tabs are positioned
  set fmode change the drive letter of the existing file
  set fname change the filename of the file being edited
  set fpath change the path of the existing file
  set ftype change the extension of the existing file
  set fullfname specify if complete filename to be displayed
  set header turn on or off syntax highlighting headers
  set hex set how hexadecimal strings are treated in string operands
  set hexdisplay turn on or off display of character under cursor
  set hexshow turn on or off hex display of current line
  set highlight specify which lines (if any) are to be highlighted
  set idline specify if IDLINE is displayed
  set impcmscp set implied operating system command processing
  set impmacro set implied macro command processing
  set impos set implied operating system command processing
  set inputmode set input mode behaviour
  set insertmode put editor into or out of insert mode
  set interface set overall behaviour of THE
  set lastop set the contents of the lastop argument
  set lineflag set the line characteristics of lines
  set linend allow/disallow multiple commands on command line
  set macro indicate if macros executed before commands
  set macroext set default macro extension value
  set macropath set default path for macro commands
  set margins set left and right margins for wordwrap
  set mouse turn mouse support on or off
  set msgline set position and size of message line
  set msgmode set display of messages on or off
  set newlines set position of cursor after adding blank line
  set nondisp specify character to display for non-displaying characters
  set number turn prefix numbers on or off
  set pagewrap determine if page scrolling wraps at bottom/top of file
  set parser associates a language definition file with a parser
  set pending set status of pending prefix commands
  set point assign a name to the current line
  set position determine if LINE/COL is displayed on idline
  set prefix set prefix area attributes
  set printer define printer spooler name
  set pscreen set physical size of screen
  set readonly allow/disallow changes to a file if it is readonly
  set regexp specify the regular expression syntax to use
  set reprofile indicate if profile file to be executed for all files
  set reserved display a reserved line
  set rexxhalt halt Rexx macro after specified number of events
  set rexxoutput indicate where Rexx output is to go
  set scale set position and status of scale line on screen
  set scope sets which lines are to be excluded from commands
  set screen specify number of screens displayed
  set select sets the selection level for the specified lines
  set shadow determines if shadow lines are displayed or not
  set slk set Soft Label Key definitions
  set span specify if a string target can span multiple lines (unavailable)
  set spill specify if a string target can span multiple lines (unavailable)
  set statopt set display options on statusline
  set statusline set position of status line
  set stay set condition of cursor position after CHANGE/LOCATE commands
  set synonym define synonyms for commands (unavailable)
  set tabkey set characteristics of the SOS TABF command
  set tabline set position and status of tab line on screen
  set tabs set tab columns or tab length
  set tabsin set tab processing on file input
  set tabsout set tab processing on file output
  set targetsave set type(s) of targets to save for subsequent LOCATEs
  set thighlight specify if text highlighting is supported
  set timecheck specify if time stamp checking done
  set tofeof specify if TOF and BOF lines are displayed
  set trailing specify how to treat trailing blanks on lines
  set trunc specify the truncation column
  set typeahead set behaviour of screen redraw
  set undoing turn on or off undo facility for the current file
  set untaa specifies if "Unsigned Numerical Targets Are Absolute"
  set verify set column display limits
  set width set width of maximum line that THE can edit
  set word controls what THE considers a word to be
  set wordwrap set wordwrap feature on or off
  set wrap enable/disable string locates around the end of the file
  set xterminal set X terminal to execute under X
  set zone set column limits for editing
SOS COMMANDS
  sos addline add blank line after focus line
  sos blockend move cursor to end of marked block
  sos blockstart move cursor to start of marked block
  sos bottomedge move cursor to bottom edge of FILEAREA
  sos cuadelback delete the character to the left of the cursor
  sos cuadelchar delete character under cursor
  sos current move cursor to current line
  sos cursoradj move first non-blank character to cursor
  sos cursorshift move text to right of cursor to cursor
  sos delback delete the character to the left of the cursor
  sos delchar delete character under cursor
  sos delend delete to end of line
  sos delline delete focus line
  sos delword delete word at or right of cursor
  sos doprefix execute any pending prefix commands
  sos edit edit a file from directory list
  sos endchar move cursor to end of focus line
  sos execute move cursor to command line and execute command
  sos firstchar move cursor to first non-blank of field
  sos firstcol move cursor to first column of field
  sos instab shift text to next tab column
  sos lastcol move cursor to last column of field
  sos leftedge move cursor to left edge of window
  sos lineadd add blank line after focus line
  sos linedel delete focus line
  sos makecurr make focus line the current line
  sos marginl move cursor to the left margin column
  sos marginr move cursor to the right margin column
  sos parindent move cursor to the paragraph indent column
  sos pastecmdline copy contents of marked block to command line
  sos prefix move cursor to leftmost edge of prefix area
  sos qcmnd move cursor to command line and clear
  sos rightedge move cursor to right edge of window
  sos settab set a tab column at the cursor position
  sos startendchar move cursor to end/start of focus line
  sos tabb move cursor to previous tab stop
  sos tabf move cursor to next tab stop
  sos tabfieldb move cursor to previous enterable field
  sos tabfieldf move cursor to next enterable field
  sos tabwordb move cursor to beginning of previous word
  sos tabwordf move cursor to start of next word
  sos topedge move cursor to top edge of filearea
  sos undo undo changes to the current line
QUERY, EXTRACT and STATUS
IMPLIED EXTRACT
BOOLEAN FUNCTIONS
OTHER FUNCTIONS
GLOSSARY
APPENDIX 1 ENVIRONMENT VARIABLES
APPENDIX 2 KEYBOARD HANDLING IN THE
APPENDIX 3 POINTER DEVICE SUPPORT IN THE
APPENDIX 4 SYNTAX HIGHLIGHTING IN THE
APPENDIX 5 DEFAULT STATUS SETTINGS IN THE
APPENDIX 6 THE BY TASKS
APPENDIX 7 REGULAR EXPRESSIONS IN THE
History of THE
Quick Reference for THE