Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
the(1)				  THE Manual				the(1)

       the - The Hessling Editor

       the [ options ] [ filename [ directory ]]

       THE is a	text editor that uses both command line	commands and key bind-
       ings to operate.	It is intended to be  similar  to  the	VM/CMS	System
       Product Editor, XEDIT and to KEDIT from Mansfield Software.

       THE  was	 originally written to be used by people already familiar with
       the above editors. For this reason, the documentation provides  limited
       information  on using THE, and concentrates more	on reference material,
       such as command syntax and configuration.

       -n     Run THE without any profile. Normally THE	tries to find  a  pro-
	      file  file  and  execute this on startup.	This switch suppresses
	      that search and execute and runs THE in its default  mode.  This
	      switch  is  useful  for  determining if a	bug in THE occurs only
	      with certain user-specific customisations.

       -m     On ports of THE that support colour, this	switch forces THE into
	      monochrome mode. More a testing feature than a user feature.

       -r     This  switch  enables  THE  to be	run in readonly	mode.  In this
	      mode commands that alter the contents of a file are invalid.

       -s     On Unix platforms, this switch enables the  writing  of  a  core
	      file  if	THE  crashes.  Normally, THE traps any internal	errors
	      and exits	gracefully.  This switch is a testing  feature	rather
	      than a user feature.

       -b     When  you	 want to use THE as a non-interactive tool for manipu-
	      lating the contents of one or more files,	this switch will  dis-
	      able  any	display	of file	contents and disable keyboard interac-
	      tion. Normally used in conjunction with a	specific profile;  see
	      -p option.

       -q     Run  quietly  in batch mode. This	will suppress the introductory
	      informative message displayed when errors	are  encountered  run-
	      ning in batch.

	      Allows  'soft  label  keys'.  This allows	the display of one (or
	      two) lines at the	bottom of the screen with  'buttons'  intended
	      to  be  used to represent	function keys. These 'soft label keys'
	      can be manipulated with the <SET SLK> command.   The  'fmt'  op-
	      tional  extra argument is	a single digit representing the	format
	      of the display of	the 'buttons'.

	       1 - displays 8 'buttons'	in a 4-4 layout
	       2 - displays 8 'buttons'	in a 3-2-3 layout
	       3 - displays 12 'buttons' in a 4-4-4 layout
	       4 - displays 12 'buttons' in a 4-4-4 layout with	an index line
	       5 - displays 10 'buttons' in a 5-5 layout

	      Not all platforms	support	all 5 format options.  On those	 ports
	      of THE that are mouse-aware, the mouse can be pressed on a 'but-
	      ton', and	the command assigned the  the  corresponding  function
	      key is executed.

       -l     This  switch  specifies the line number to make current when THE

       -c     This switch specifies the	column number to make current when THE

       -p     Specifies	the THE	profile	to run instead of the default profile.

       -a     Specifies	the arguments that are passed to the profile specified
	      with the -p switch.

       -w     Specifies	the maximum line width for a line in the current  edit
	      session. Can be overridden with the <SET WIDTH> command.

       -u     THE can run as a binary editor. Specifying this switch tells THE
	      to read in the file and display it in 'lines' that  are  ignored
	      and are treated as other characters in the file.

       -X     With the X11 port	of THE,	standard X11 switches can be specified
	      with this	switch to dynamically configure	the way	 THE  displays
	      or behaves.  You can also	specify	XCurses-specific switches here
	      as well.	For more information on	the  XCurses  switches	avail-
	      able, consult the	PDCurses documentation.

       -1     Tells  THE  to run in 'Single Instance Mode'. The	first time THE
	      is run with the -1 switch, it starts as normal. Subsequent  exe-
	      cutions  of THE with the -1 command-line switch will not start a
	      new instance of THE, rather it will edit the  file(s)  specified
	      on  the  command-line  in	the currently running instance of THE.
	      This feature is currently	only available with the	 X11  port  of
	      the using	XCurses	2.5 and	greater.  If the first instance	of THE
	      with the -1 switch crashes for any reason,  subsequent  attempts
	      to run THE with the -1 switch will hang.	To fix this remove the
	      file (really a FIFO); $HOME/.thefifo and then run	THE  with  the
	      -1 switch	again.

       Mark Hessling, <>

       Copyright (C) 1991-2013 Mark Hessling.  The Hessling Editor is distrib-
       uted under the GNU General Public License, See the  file	 `COPYING-LIB'
       in the source code distribution.


       Report bugs to

THE Manual			   June	2013				the(1)


Want to link to this manual page? Use this URL:

home | help