ARPUS/ce, Version 2.6.2 (12/14/05)    (SCCS 1.28)
This help contains changes between releases of Ce.  It starts with the
current  release  vs the previous release.  Differences between  older
releases follow.

What's new in release 2.6.2
This is a summary of changes from Ce release 2.6.1 to 2.6.2


    A  bug  introduced in release 2.6.1 caused certain command  syntax
    error  messages  to  be  trucated  to  4  bytes.   This  has  been

    When  you press the "Exit" button on CDE in Solaris 9, it sends  a
    SIGHUP  interupt instead of a "WM_SAVE_YOURSELF" message.  Ce  now
    traps  this  signal and creates a crash file (.CRA) if  there  are
    unsaved changes.

    Under the Gnome environment (Linux and Solaris), Ce is now able to
    correctly save its state when you log off.  Before, you  would get
    a  message  about having to restart the service manually.  Now  Ce
    complies  with  the  XSMP protocol so it handles  this  correctly.
    Support for the KDE environment under Linux is improved.


  -bell {on | off | visual | VISUAL}
  Ce.bell : {on | off | visual | VISUAL}
        This  option  defaults  to  on.  Setting the  value  to  "off"
        suppresses  the  generation  of  an audible  beep  on  certain
        events.   Setting  the value to "visual" causes the window  to
        flash  reverse video instead of making a noise.  A lower  case
        "visual"  flashes  the  DM  Output  window.   An  uppper  case
        "VISUAL"  flashes  the main window.  Note that only the  first
        character of "on", "off", "visual", and "Visual" is examined.

What's new in release 2.6.1
This is a summary of changes from Ce release 2.6 to 2.6.1


    Security fixes.
    A  buffer overflow was found in ce/ceterm which could be exploited
    to  get  root  access on a machine if the ceterm was  setuided  to
    root.   ceterm  does  not need to be setuid'ed  on  any  supported
    platform.   It  is recommended that the setuid be dropped  on  any
    existing  copies  of  Arpus/Ce.  One side affect of  dropping  the
    setuid is that ceterm will not be able to update the utmp file and
    thus will not appear in listings produced by the who command.  The
    who  command is a poor excuse to run setuid'ed.  Earlier  versions
    of  UNIX OS's required the setuid to open a pseudo-terminal.   The
    buffer overflows have been corrected.


         Special command to place under the <ctrl>-c key (press
         and hold the Ctrl key and then press c).
         Many editors use the <ctrl>-c sequence to do a copy to the 
         clipboard.  However, terminal emulators use <ctrl>-c as
         an interupt.  The cntlc command morphs into an interupt if
         the window is a ceterm and there is no text highlighted.  Otherwise
         it morphs into a copy command.  This is the default in new
         installs.  For existing $HOME/.Cekeys files, it is recommended
         that you replace the definition for ^c with:

         kd ^c               cntlc -h ^c  PRIMARY  ke

What's new in release 2.6
This is a summary of changes from Ce release 2.5.5 to 2.6


    Scrolling on highlighted drag.
    By default, the left mouse button highlights the text it is dragged
    over on press and does a copy on release.   The added behavior is
    that if you drag the mouse out of the window, the window will begin
    scrolling in that direction.

    Updates to use the new pseudo terminal calls in Linux Fedora Core 2
    (Available since Redhat 8) are added.  The old way stopped working
    on Fedora Core 2.


         Reload file from disk.
         This  command deletes the current memory copy of the file  and
         replaces it with a fresh copy loaded from disk.  If the memory
         copy  of  the file has been changed, a confirmation prompt  is
         requested.   A  prompt  for  this command to  be  executed  is
         generated  when ce detects that the disk copy of the file  has
         been changed external to ce.


    -l   option to xp
         The   -l  option has been added to the xp command.  It  causes
         the  cursor to be placed at the end of the pasted area  rather
         than  the  beginning.   It  is ignored if  the  -r  option  is
         kd F4               ax -l ke       # paste and put cursor at end

What's new in release 2.5.5
This is a summary of changes from Ce release 2.5.4 to 2.5.5


    Ceterm support for Linux is improved.  Linux colorization controls
    output by ls and other commands are handled.  (Be careful of
    colorizing to the background color).

    Modifications to support oddities of the Hummingbird Exceed window
    manager have been added.

    The X Resource Ce.vcolors has been added to allow the selection of
    the colors used in Linux colorization.  The default is the colors
    used in a gnome terminal.

What's new in release 2.5.4
This is a summary of changes from Ce release 2.5.3 to 2.5.4


         Save Location.
         This command temporarily saves the cursor position for
         later restore using rl.  For example:
         echo "\002\002sl;tmw;pb;tb;tl;ca blue;rl"
         If executed from a UNIX prompt, it will turn the last
         line of text in the ceterm (the display of the echo command)

         Return to Location
         This command returns to the last place saved with sl.


    Ceterm support for Linux is improved.  Multiple prompts when
    resizing the window and window getting small while resizing 
    have been elimintated.

    The ceterm transcript file has been increased from 16 million
    lines to 96 million lines and the maximum number of lines in a
    file loadable by ce has been from 12 million to 72 million lines.

What's new in release 2.5.3
This is a summary of changes from Ce release 2.5.2 to 2.5.3


    Ceterm support for Linux is improved.  Password prompt (dot mode)
    should behave more rationally.

    Minor fix to using the PN command under ceterm to retrieve the
    title name.

What's new in release 2.5.2
This is a summary of changes from Ce release 2.5.1 to 2.5.2


  -bkuptype {dm | vi | none}[n]
  Ce.bkuptype : {dm | vi | none}[<n>]
        The  optional  number  [<n>] has been added to  the  bkuptype
        argument and X Resource.  This number specifies how many .bak
        files  are  to be kept.  The  default, if omitted is 1.   For
        example:  Ce.bkuptype  :dm2 will cause Ce to maintain a  .bak
        and a .bak2 file with the .bak2 being older than .bak.


        If  the  environment  variable CE_KDP is set to  a  non-blank
        value and -kdp was not specfied on the command line, then set
        the  -kdb  parameter  will  be  set from  the  value  of  the
        environment  variable.  This allows the tools which invoke Ce
        indirectly  to  have these tools use a different set  of  key
        definitions  than normal Ce windows.  DEFAULT: Null, use  the
        key definitions defined in $HOME/.Cekeys


    Several updates to the status boxes have been made as a result of
    user requests.  
    +-+   The leftmost status box, which previoutly could only hold a W,
    |r|   will display a lower case 'r' when command recording
    +-+   mode is on.  Command recording is enabled with the "rec" command.

    +-+   The insert mode box, which also shows the 'R' for read only 
    |O|   will display a capital O when ce is in overstrike mode.

    +-+   The scroll mode box, which displays the letter 'S' when ceterm
    |J|   is  in  smooth scrolling mode and 'V' when in vt100  emulation
    +-+   mode, will display a 'J' when in Jump scrolling mode. Jump
          scrolling  is the alternative to smooth scrolling and is  more


    Bug Fix: When displaying a ce or ceterm to a PC using Hummingbird's
    Exceed  X  Server,  executing the geo command  either  directly  or
    indirectly  caused Exceed to crash.  Ce has been modified to  avoid
    this situation.


What's new in release 2.5.1
This is a summary of changes from Ce release 2.5 to 2.5.1


  -linemax <num>
  ceterm.linemax : <num>
        Normally a ceterm will store up to 16 million lines of output
        in the transcript pad.  It is more likely you will run out of
        swap  space  first.   This argument allows you to  limit  the
        number  of lines a ceterm will keep.  When the limit <num> is
        reached,  the  oldest lines are deleted from the top  of  the
        transcript pad.
        DEFAULT:    no limit

  Ce.autocut:  { y | n }
        This  option, when set to 'yes', causes the 'ed'  (delete),
        'ee'  (backspace),  'es' (type a character), 'er'  (type  a
        special  hex  character),  and  'xp'  (paste)  commands  to
        automatically cut a highlighted area when they are in a key
        definition by themselves. That is, not part of a list of Ce
        commands  executed  under one keystroke.  This  provides  a
        behavior  similar  to  that seen in Netscape and  other  PC
        based editors.
        DEFAULT:  n


         This command toggles or sets a caps mode. In caps mode lower
         case charaters are folded to upper case. This is useful for
         working with mainframe files.


    -w option in the 'al', 'ar', 'ee' commands
         The  -w option to each of these commands causes the cursor to
         wrap  to  the previous or next line when the end of  line  is
         encountered.   Normally 'al' and 'ee' stop when they hit  the
         leftmost column on a line.  The -w option causes them to wrap
         to the rightmost column of the previous line.  In the case of
         'ee',  the newline between the lines is removed, causing  the
         lines  to  be joined.  To make use of this option,  you  must
         modify your .Cekeys file as follows and run "ce -reload":
         kd Left             al -w ke       # cursor left 1 column
         kd Right            ar -w ke       # cursor right 1 column
         kd BackSpace        ee -w ke       # delete the character preceding the cursor

    -w option in the 'sic' command
         The  'sic' command is used when Ce is in "mouse off" mode.  In
         this   case, the text and mouse cursors are not tied  together
         and   encountered.  The -w option causes the text cursor to go
         to  just  past the end of the line when  the mouse  cursor  is
         past  the end of the line.  To  make use  of this option,  you
         must  modify your .Cekeys as  follows and run "ce -reload":
         kd m1   sic -w;dr;echo;mouse -on ke
         kd m1s  sic -w ;dr;echo -r;mouse -on ke
         kd m1u  sic -w;xc ;mouse -off ke;  
         kd m1us  sic -w;xc -r ;mouse -off ke;  
         # UNIX mode regular expressions
         kd *m2  sic -w;/[^-a-zA-Z._@\$0-9\\\\\\\\/\\\\\\~]/dr;?[^-a-zA-Z._@\$0-9\\\\\\\\/\\\\\\~]?;/./xc X ke 
         # Aegis mode regular expressions
         kd *m2  sic -w;/[~a-zA-Z._@@-$0-9@@/@@\~]/dr;\[~a-zA-Z._@@-$0-9@@/@@\~]\/?/xc X ke 

    -f option in the 'wc' command
         The  existing -f option has been modified to close all  cc'ed
         window in the file or transcript pad.


    Bug  Fix:  On Linux, a race condition existed in the ceterm terminal
    emulator in which blocks of data would be lost when alot of output
    was written to the screen all at once.

    Bug  Fix:  In a ceterm window, when the horizontal scroll  bar  was
    automatically  turned  on,  it  covered up the  last  line  of  the
    transcript pad. This has been fixed.

    Bug  Fix:  There  was  a problem calculating the  location  of  the
    horizontal  scroll  bar slider on very wide files.  This  has  been

    Bug  Fix:  Several minor problems involving colored text have  been

    Bug  Fix: The dotmode option on HP/UX terminals is no longer needed
    because  of  changes to the pseudo-terminal interface.  Dotmode  is
    still supported.

    Bug  Fix: If a file system with hard quotas is active and the  file
    system  is  over  quota,  saving the file would  fail  and  not  be
    detected. The fix flags the error and also creates a crash file.


What's new in release 2.5
This is a summary of changes from Ce release 2.4.2 to 2.5


   Ce  now  supports  both vertical and horizontal  scroll  bars.   By
   default,  they  appear as needed.  X resources and commands can  be
   used  to control their appearance (both how they look and when they
   appear).   Due to Ce's ability to scroll sideways, an extra resource
   (Ce.scrollBarWidth)  controls  the horizontal scroll bar  behavior.
   This resource can also be used to disable the horizontal scroll bar
   and keep the vertical scroll bar.

   Ce  now supports a user customizable menu bar and user customizable
   pull down menus. Menus items are controlled by commands held in the
   .Cekeys  file  which look a lot like key definitions.   Several  new
   commands assist in using an manipulating pulldowns.

   A  new Ce command 'ca' allows the colorization of a range of  text.
   The  colorization  is  local to the Ce session and  is  not  saved.
   Several  programs  to generate colorization on HTML and C  programs
   are  provided in source along with the menu item definitions  which
   would make use of them. This first color release uses static color.
   That is, the colorization is not yet language sensitive.

   Ce  now allows the generation of labels which are stored local to a
   Ce  session.  If line numbers are turned on, the labels can be seen
   in the line no field. A program to generate labels from C source and
   put them in a pulldown is supplied in the contributed source directory.

   The Ce helps and users guide are provided in HTML format along with
   a  frequently   asked   questions   list  and   other   HTML   only
   documentation.   The HTML package is self contained.  You need only
   provide  a link so your intranet web server can get to the main web

   Several useful programs are provided in source form. These programs
   are  designed  to  interact with Ce and can serve  as a  model  for
   other programs.  The initial set includes a basic HTML parser which
   generates  Ce  'ca' commands to colorize HTML documents; a  program
   which  does  the  same  thing for 'C' programs; and  a  program  to
   generate labels for all the functions in a 'C' source file.


    -kdp <name>
    Ce.keydefProp : <name>
         Ce stored the key definitions it reads from the $HOME/.Cekeys
         file in an X property hung off the root window. This property
         allows  a  different name to be used.This option can be  used
         with  the -name option or aliasing the ce command to maintain
         multiple  sets  of independent key definitions for  different
         windows.   This falls under the heading of extremely advanced
         features.   It  has  been used in  writing  simulators  which
         control  bunches of ce and ceterm windows simulating multiple
         DEFAULT:    CeKeys

    -sb {y | n | auto}
    Ce.scrollBar : {y | n | auto}
         Scroll  bars  are always on (y), off (n), or they  appear  as
         needed.  As needed is defined as a vertical scroll bar exists
         when  the number of lines being displayed exceeds the  number
         of  lines  in the window.  A horizontal scroll bar is  needed
         when a line is longer than a window.  A special note about Ce
         horizontal  scroll bars: The slider width is an indication of
         the width of the window with respect to the width of th line.
         To facilitate horizontal scrolling, Ce operates as though the
         line  width  is at least 300 characters when the  scroll  bar
         slider  is   drawn.    This   can  be   modified   with   the
         Ce.scrollBarWidth option. Note also that the scrollBar option
         is  often set differently for ce and ceterm.  It is common to
         turn it off in ceterm windows.
         Ce.scrollBar : auto
         ceterm.scrollBar : no
         DEFAULT:    auto

    -sbwidth <num>
    Ce.scrollBarWidth : <num>
        The    argument    sbwidth   or  the   X   Windows    resource
        "scrollBarWidth"  can  be set to define the minimum line  size
        used  to calculate the dimensions of the slider portion of the
        scroll  bar.  For example: If the window is 80 characters wide
        and  one  of the lines displayed is 160 characters  wide,  the
        horizontal scroll bar slider will be one half the width of the
        gutter it rides in. This allows you to slide to the end of the
        line  with the slider.  The use of horizontal scrolling in  Ce
        makes  this somewhat restrictive.  It would be nice to use the
        horizontal  scroll  bar  to move farther than the end  of  the
        line. To facilitate this, the scrollBarWidth resource is used.
        If  the  horizontal  scroll bar is displayed,  it  behaves  as
        though  the longest line displayed is at least  scrollBarWidth
        characters long. If a real line is longer, the longer value is
        used. Setting scrollBarWidth to 1 will make the slider size to
        the  longest line in the window.  Setting scrollBarWidth to  0
        disables the horizontal scroll bar.  This way you can use just
        the vertical scroll bar without ever seeing the horizontal.
        DEFAULT:    300

        The causes Ce to calculate it's run time options and dump them
        to stdout.  It is useful in diagnosing problems and is used in
        the procedure which updates Ce from a previous release.

    -pdm {y | n}
    Ce.pdm : {y | n}
         The  pdfm  or  the X windows resource ".pdm" can  be  set  to
         define whether the pull down menu bar is initially visible or
         invisible.  It is common to have the pulldown menu bar on for
         ce and cv and off for ceterm:
         ce.pdm : y
         cv.pdm : y
         ceterm.pdm : n

    -xrm "resource:value"
        The  xrm option allows the specification of X resources.  This
        is  a  standard  parameter  for X  applications.   It  is  not
        especially  useful  with  Ce,  as all  the  resources  can  be
        specified  from  the command line.  The parameter holds one  X
        resource  line.  The -xrm parameter may be specified  multiple
        times. For example: -xrm "ce.foreground:red"

    -CEHELPDIR <path>
    Ce.CEHELPDIR : <path>
        The  CEHELPDIR  resource  is set in the  installation  of  the
        app-defaults  file  for Ce to the directory containing the  Ce
        help  pages.   If  you  do not set  the  environment  variable
        CEHELPDIR  in  your  .profile,  Ce will use  this  value  when
        looking  for the help pages.  This technique makes the Ce help
        file directory easier to move around.

    -dotmode {0 | 1[string] | 2}
    ceterm.dotmode : {0 | 1[string] | 2}
        The  ceterm  password  dot  mode option  is  needed  on  HP/UX
        machines of release 10.20 and beyond where the users primarily
        use the csh shell. When ceterm detects that the user is typing
        a  password,  the program goes into dot mode.  The  characters
        typed  are displayed as dot's and undo processing is  disabled
        so  you cannot undo to get the password back.  At HP/UX 10.20,
        it  was  not  possible to find a combination of  tty  settings
        which  would  correctly  indicate that a  password  was  being
        entered  for  the  csh (ksh works fine).  To rectify  this,  a
        simpler  method  of   detecting  password   prompting,  namely
        watching  for  "pas" in the prompt string (case  insensitive),
        was  added.   In this mode, you can optionally set the  prompt
        fragment to look for.
        0  -  Nodot mode, never display dots, passwords are visible
        1  -  Scan prompt for string,  Note, if you use hostname in your
              UNIX prompt and your node name is Pascal, you are sunk.
        2  -  Normal mode, watch the tty bits to determine password entry.
        DEFAULT:    2 (Can be set during installation)

    New  Ce commands were added to support colorization of text,  pull
    down  menus,  scroll  bars, statement  labels,  and  miscellaneous
    features people asked for.

             This  command  is used to color an area or  remove  color
             from an area.

             Called the "corner" command, this command behaves similar
             to  the positioning command [row,col].  Instead of moving
             the cursor to this position, the corner command positions
             the  file so {row,col} is in the upper left corner of the
             This  command allows dynamic inspection and  modification
             of  the  find border resource introduced in release  2.4.
             The  find border modifies the positioning commands  (such
             as  find),  to position the window so there are at  least
             'n'  lines  between  the located position and  the  found
             line.   In  this  case, 'n' is the number from  the  fbdr
             command.  This allows you to see text in context.  See the
             fbdr help for more information.
             The  scroll  bar  command allows the scroll  bars  to  be
             switched on and off.

             The  menu  item  command is put in the  .Cekeys  file  to
             create  the items found in the menu bar and in pull  down
             menu's  It's  syntax  is  very much the  same  as  a  key
             definition.  As with key definitions, menu items are known
             across all Ce windows.
             The  local menu item command creates a menu item for just
             the current window.

             The  pulldown  command activates a pull down menu.   This
             command  can  be placed in a key definition  or  executed
             from  a  menu  item.  It is the command  used  to  create
             cascading pull down menus. Try the Ce command:
             "pd Menubar".

             The pull down menu command allows you to toggle the menu
             bar on and off.

             The to menu bar command can be put under a key definition
             to  move  the  cursor to the menu bar and lock  the  main
             window till the mouse is clicked.

             The  next  color command moves the cursor forward to  the
             next colored area.

             The  previous color command moves the cursor backward  to
             the next colored area.

             The  evaluate  command performs symbolic  substitution  of
             environment  variables on its argument and then  executes
             the  argument  as  Ce commands.  This is useful  in  some
             complex command files and key definitions.

             The  label  command  sets a label at the  current  cursor
             position in the main window.

             The  go  label command positions the cursor at the  named

             The delete label command deletes all labels in a range of

             The  paste  buffer append command concatenates two  paste
             buffers. This is useful in some key definitions.

             Alternate find syntax.  Allows delimiter other than '/'.
             This is handy for search strings with slashes in them.

    The  Ce_init  program  is now sensitive to whether Aegis  or  UNIX
    regular  expressions are in use.  The shell now asks several setup
    questions  to do some initial customization.  The key definitions,
    which  were  previously held in the DATA directory have  been  put
    into the ce_init shell. The data directory no longer exists.

    This program sends a terminal control sequence which is ignored by
    xterm's, hpterms, cmdtools, and so on but is recognized by ceterm.
    The  program  can  thus detect whether it is being called  from  a
    ceterm  or  some  other   terminal.   This   is  often  useful  in
    .profile(.login) shells or .kshrc(.cshrc) shells.

    The install process now addresses the HTML and contributed program
    directories.   It also allows some site wide customization as part
    of the install process. The data directory which contained initial
    key definitions has been eliminated in release 2.5.  This data is now
    encoded in the ce_init shell.  Also, the help files do not need to
    be  tailored  to  the site.  The only file which  is  tailored  is

    Release  2.4.2  and earlier versions will complain about the  menu
    item  definitions which are stored with the key definitions.  Once
    you  run  release 2.5, bringing up an earlier version of  Ce  will
    cause a bunch of error message to be written out.  You can get rid
    of  this by doing a ce -reload with the earlier version.  The code
    which generates these messages has been modified so it will not be
    a problem with later releases.


What's new in release 2.4.2
This is a summary of changes from Ce release 2.4.1 to 2.4.2

Release 2.4.2 contains 2 bug fixes and 2 enhancements.

1.  References to the system routine gethostbyname were removed to
    get around a problem which occurred on Apollo systems running
    the xdm window manager.

2.  A bug was fixed which allowed the key definitions
    kd m1 sic;dr;echo;mouse -on ke
    kd m1U xc;mouse -off ke
    To work as desired when running Ce in "mouse -off" mode.

3.  ENHANCEMENT:  If a Ce session which was piped into is put into
    read/write mode, a temporary name in /tmp is created.  Previous
    behavior was to beep and issue an error message.

4.  ENHANCEMENT:  A new X resource (titlebarfont) and line option (-tbf)
    allows the user to specify the font to use in the reverse video
    titlebar at the top of the window.

What's new in release 2.4.1
This is a summary of changes from Ce release 2.4 to 2.4.1

Release 2.4.1 contains 6 bug fixes.  One of which was severe.
No new features are included.

1.  A memory fault occurred in ceterm only on HP/UX systems when the
    prompt was wider than the window and the return key was pressed
    in the main pad.

2.  The +lineno option on the command line was off by 1.  That is,
    executing "ce +3 .profile" left the cursor on line 4.
    This is corrected.  The +line option will be documented in
    the next release.

3.  A problem with 'ww -a' has been corrected.  It would occasionally
    compress blanks.

4.  A bug in the bl command was fixed.

5.  A problem involving the use of aliases within key definitions
    has been resolved.

6.  A problem involving the title command with no options
    was resolved.

What's new in release 2.4
This is a summary of changes from Ce release 2.3.2 to 2.4

Release 2.4 contains a number of bug fixes several new resources and command
line options and several new commands.


    -dpb <name>
    Ce.dfltPasteBuf : <name>
         Use  the  specified  name as the default paste  buffer.   As
         delivered, this is the paste buffer name CLIPBOARD.  This is
         the default paste buffer name for most Sun applications. The
         other  common name is PRIMARY with is the name used by xterm
         and other applications. This resource is commonly set by the
         system  administrator to the value PRIMARY in the app-defaults
         directory file "Ce". It is expected that sites not using Sun
         workstations  will  change  the default to  PRIMARY  in  the
         app-defaults library to make it easier for Ce to communicate
         with xterms and other applications on these machines.

    -findbrdr <num>
    Ce.findbrdr : <num>
          Use the specified number as a border for find commands. That
          is, if <num> was specified as 2, make sure there are 2 lines
          between  the  top  or  bottom of the window  and  the  found
          string.   This is ignored if the find is in the first  <num>
          lines of the file. It may be modified if the number of lines
          in the window is less than double num.  This option is often
          set  to 1 or 2 in the .Xdefaults file.  For example: If  the
          resource  Ce.findbrdr:1  is active, a the find command  will
          position  the  window so there is at least one line of  text
          above or below the found line.
          DEFAULT:  0

    -ib <path>
    Ce.iconBitmap : <path>
          This option lets you change the icon used for ce/ceterm.  Ce
          will use the requested file as the bitmap for the icon.  The
          file  should  be  in  the format created  by  the  X  bitmap
          utility.   This  utility  is found in  different  places  on
          different types of machines.
          DEFAULT: The standard ce/ceterm icons  

          This  option puts a ce window into a special read from stdin
          mode. It is useful when piping into ce from a device such as
          a  hardware monitor which generates data sporadically over a
          long  period of time.  When Ce is running in its normal mode
          and  it is reading from stdin, if you press ^b (go to bottom
          of  file), the screen will lock until all the data has  been
          read  in  so that the bottom of the file has been  read  in.
          This is fine when using Ce as a pager for manual pages. When
          displaying  output  from  some  device  which  is  producing
          messages,  a behavior like the transcript pad of a ceterm is
          desired,  only  with no UNIX command window.  The  -transpad
          option  provides this behavior.  One use for this option has
          been  to  provide  a monitor window in a debugger.   The  ce
          program  was  executed  via a 'C' popen(3) call  and  output
          written to this pipe as needed.
          DEFAULT:  Off

    -offdspl { y | n }
    Ce.offdspl : { y | n }
          This  option  overrides a normal "safety" feature of Ce  for
          use with virtual window managers such as olvwm.  Normally Ce
          will  not allow the specification of a window geometry which
          has no portion of the window visible. This is because such a
          window  is  very difficult to interact with.  When  using  a
          virtual  window manager it may be desirable to bring up  Ce
          windows  in  parts  of the virtual workspace which  are  not
          currently  visible.   This is especially true  during  login
          startup processing. When set to 'y', the offdspl argument or
          X  resource allows the specification of geometries which are
          off screen. Whether this option is required depends upon how
          the virtual desktop is managed.  Managers such as HP/VUE and
          CDE  unmap  the  windows  which are  not  in  the  currently
          displayed  desktop.   Window  managers like olvwm  move  the
          window  to geometry values which are off screen.  It is  for
          this  second type of window managers that the offdspl option
          is supplied.
          DEFAULT:  n

    -lockf { y | n }
    Ce.lockf : { y | n }
          As of release 2.4, Ce supports the use of System V, advisory
          file locking. The default is to use file locking. Specifying
          'n'  in the command line argument or the X resource disables
          the  file  locking feature.  Note that file locking is  only
          supported on file systems which support advisory locking via
          the lockf system call. This includes local files systems and
          most NFS file systems.
          Default: Y

    The  new  Ce commands are primarily for user who write  customized
    commands  and for programmers who write "Ce aware" programs.   The
    alias command is a partial exception to this rule as it is used to
    add  default alias names for common commands.  For example,  find,
    quit,  end,  save,  and  help aliases were added  to  the  .Cekeys
    created  by  ce_init.   To  incorporate these  changes  into  your
    existing .Cekeys file, execute the new ce_update command.

             The  alias  command  allows  the user to  define  new  Ce
             commands.  The syntax is very similar to kd command.  New
             commands  may contain symbolic substitution of positional
             parameter.  It is used in the shipped key definition file
             to  add  aliases  for help, quit, end, and  a  few  other

             'sp'  is  a  special  command for  use  with  "Ce  aware"
             programs.   A program is "Ce aware" if it is the  program
             executing  under a ceterm and it wishes to make use of Ce
             features from within the program.

             'prefix' is a special command which modifies the way data
             being  written  to  the  transcript pad in  a  ceterm  is
             processed.   It allows a set of one or more characters to
             be  looked  for at the start of each line written to  the
             transcript pad. If a match is found, the rest of the line
             is  assumed  to  be Ce commands and executed  instead  of
             being  put  in the transcript pads.  The  ceterm  program
             comes  initialized  with a default prefix.  This  allows
             some  shell  users  to synchronize  the  current  working
             directory in the "Command:" window and the shells current
             working  directory in a more elegant way than  previously

             The  xl  command is "copy literal".  The string "xl"  was
             chosen  because it is consistent with xc for copy, xd for
             cut, and xp for paste. The xl command copies the literal
             string passed as it's argument to the named paste buffer.
             The optional arguments to xc apply to xl.


    -e option to the bang (!) command
             The bang (!) command causes the passed command to be sent
             to  the shell and executed.  The current marked region is
             passed  as  stdin   to  the   program/shell   script  and
             optionally  cut from the file.  The standard output  from
             the invoked program is optionally pasted into the cut out
             spot.   The -e option specifies that standard output from
             the  program  is a string of Ce commands to be  executed.
             Note that used in conjunction with the alias command, you
             can  write  your  own editor commands in your  choice  of
             languages or shell scripts.

    Using grave (reverse) quotes (`) in prompt strings
             Normally the processing of a prompt removes leading white
             space  from the response entered in a prompt.   Sometimes
             this  is  not desirable.  Enclose the prompt  string  in
             grave quotes instead of single quotes to preserve leading
             blanks and tabs in the response to the prompt.

    -w option to wc
             Normally  when  ce returns, it saves the  current  window
             size and color scheme. When the next ce/ceterm starts up,
             if  no  geometry was specified via the command line or  X
             resource,  it picks up the last one used.  The -w  option
             defeats  this option.  Using the window manager pull down
             to close a ce/ceterm implies this option.


    A  new  shell  called "ce_update" and a supporting  program  named
    "ce_merge"  have been added.  The "ce_update" command compares the
    existing  key  definitions  to the defaults and  appends  any  new
    default  key definitions which were not previously defined to  the
    existing  .Cekeys file.  Users who customize their key definitions
    generally  do  not want to run ce_init to get new key  definitions
    because this would overwrite their customizations. The "ce_update"
    command  does  a merge without replace of the default  definitions
    and  puts the new definitions at the bottom of the file where they
    are easy to find.


    Enhancement:  The  abrt  command  (^x)  will  now  cancel  pending
    prompts.  Thus if you press the Help key (F9) and are prompted for
    a  name and you do not wish to look at any helps, pressing ^x will
    cancel the prompting command.

    Enhancement:  The  dq  command  (interrupt) in  ceterm  causes  the
    transcript  pad to scroll to the bottom of the data.  This  avoids
    the  problem of users in scroll mode (the default) to continue  to
    see  data scrolling on the screen after the quit has taken  place.
    In  truth,  the  data  had already been sent from  the  shell  but
    scrolling one line at a time made the output look like the command
    was still running. See the ws command or the scroll X resource for
    information about turning scrolling on and off.

    Bug  Fix:  The tmw (to main window) command caused the  transcript
    pad to scroll when it should not have.

    Bug  Fix:  Key  definitions   which  included  entering  text  and
    scrolling  would  cause erroneous data to be displayed.  A  screen
    refresh  would  fix  it.  An example is: kd ^1 tl;es'>  ';[+1]  ke

    Bug  fix: Several minor drawing, regular expression  (substitute),
    and cursor positioning bugs have been fixed in this release.

    Enhancement:  The environment variable CE_CMDF_PATH is searched when
    accessing  command  files  which do not have a complete  path.   For
    example:  If CE_CMDF_PATH=.:/usr/mygroup/cecmds:/usr/dept/cecmds and
    the Ce command "cmdf abc" is executed, Ce will check for the command
    file as ./abc, /usr/mygroup/cecmds/abc, and /usr/dept/cecmds/abc.

    Moved ^c (copy), ^e (cut), and ^p (paste) key definitions to (Alt-c),
    (Alt-e), and (Alt-p) respectively.

    Added Key definitions for:
    ^c - interrupt in ceterm
    ^d - end of file in ceterm

    Added  aliases for "quit", "end", "exit", "save", "help",  "print",
    "top", and "bottom"


    Key  definitions  using  the bang (!) command or the  command  line
    prompting,  when read from the X server by one version will not  be
    processed correctly by the other. If the .Cekeys file was loaded by
    release  2.3.2 prompts will loose the first character of the prompt
    and  bang  commands will loose the first character of the  command

    If you use the Ce.dfltPasteBuf resource or th -dpb option to change
    the name of the default paste buffer in release 2.4, copy and paste
    operations using the default paste buffer will not work between 2.4
    and 2.3.2 windows.

    What's new in release 2.3.2

    This is a summary of changes from Ce release 2.3 to 2.3.2
    It includes the changes between release 2.3 and 2.3.1.

    Releases  2.3.1 and 2.3.2 are maintenance releases.  The primary change is
    deals  with  problems encountered with the license manager  introduced  in
    release 2.3. There are several minor bug fixes and two new resources.

    Ce.envar: {y | n}
    Release  2.3  introduced  the  ability to click on a  file  with  contains
    environment variables and have those variables resolved before looking for
    the  file  name.   In  release 2.3.1, a resource was added  to  allow  the
    processing of these names to be turned off.

    Ce.LSHOST : <nodename>
    Release  2.3.2  introduced the ability to specify a default value for  the
    license server LSHOST environment variable as a resource.  This allows the
    system  administrator to specify it in the app-defaults/Ce file instead of
    having to put it in each users .profile.

    Stored cp commands:
    If  a  key  definition  contains  a 'cp'  command  (none  of  the  default
    definitions  do) and it is read from the .Cekeys file by release 2.3.1  of
    Ce  or earlier, release 2.3.2 will not be able to extract it when starting

    As  of release 2.3.2, a default key definition for *b was added.  This  is
    <Alt>-b  (<diamond>-b  on some Sun keyboards.  This executes  the  balance
    command. This command finds matching parens, brackets, braces, etc. and is
    useful when programming.  See the help for 'bl' for more information.

    As  of release 2.3.2, a default key definition for *t was added.  This  is
    <Alt>-t  (<diamond>-t on some Sun keyboards.  This executes the text  flow
    command. This command left and right justifies text. By default it formats
    to columns 1 through 72. Marking a rectangular region overrides the target
    boundaries.   See the help for 'tf' for more information.  This command is
    useful in editing ascii documents like this help file.

    Release  2.3.2 is available on the Linux(c) freeware version of UNIX which
    runs on PC type hardware. This version is available without maintenance at
    no charge.  It behaves the same as the other versions of Ce/ceterm and and
    will interface with them cleanly.

    Known Problem in 2.3.2:
    If  you  start a ceterm from the "Command:" window with the cp or  ceterm
    command  and then attempt to open a non-existing file with a cv, so  that
    an error is generated, the message is sent to the Message output window
    of the window which did the cp.  A workaround is to put
    export CE_DMWIN_MSG=     # put this line in your .kshrc
    setenv CE_DMWIN_MSG  ""  # put this line in your .cshrc
    The intent is to clear this environment variable.

    What's new in release 2.3

    This is a summary of changes from Ce release 2.1 to 2.3
    It includes the changes between release 2.1 and 2.2.

    bell [<num>]
       This  command makes the bell beep.  The optional parameter controls the

    mouse  [-on | -off]
       This  command  dynamically disconnects (-off) and reconnects (-on)  the
       mouse  cursor from the text cursor.  The Ce.mouse X resource and -mouse
       parameter still control the initial state when a Ce session is started.

    rec [-p] [<pathname>]
       This  command  activates command recording to a file or  paste  buffer.
       This  allows  a key sequence to be recorded and then played  back  with

    title <WM title>
       This  command  allows the user to dynamically change the Window Manager
       title and the icon title.


    pn -r
       The  -r parameter to the path name command allows the replacement of an
       existing file with the pn command.  Normally pn will generate and error
       if  the  new  name for the pn already exists.  The pn command  with  no
       parameters  now  displays the current file name in the  output  message

    tf -p
       The -p parameter to the text flow command squeezes out multiple blanks
       before  starting  the text flow operation.  This is useful  when  text
       flowing something which was already text flowed.

    xc -a
       Append mode for xc.  The -a syntax existed in release 2.1 but was not
       supported for X paste buffers.

    vt [{-on | -off | -auto}]
       The 'vt' command can put a ceterm into or out of vt100 emulation mode
       or enable the automatic switching of modes.  The new value is -auto.


    -iconic (Ce.iconic)
      This new option instructs Ce to start as an icon. The X resource exists,
      but is of questionable usefulness.

    -autovt (ceterm.autovt)  (appeared in 2.2 was changed to -vt in 2.3)
      This option causes ceterm to switch to VT100 emulation mode whenever the
      echo  bit  in  the  tty to the shell is turned off.   Thus,  whenever  a
      password  prompt  occurs  or a telnet session is  started,  ceterm  will
      switch modes and switch back when the situation passes.

    -ls     (ceterm.loginShell)
      This  option instructs ceterm to start the shell as a login shell.  This
      causes  the  .profile to be run.  This option is identical to  the  like
      named option for the xterm program.
      The -man option existed in Ce prior to release 2.2. Turning on -man in a
      ceterm  causes  ceterm to eat any vt100 control sequences output by  the
      shell when it is running in normal (non-vt100) mode.

      This  option  instructs  ce to start in browse mode and disable  the  ro
      command  so  that the user cannot enter edit mode.  This is useful  with
      programs that browse files on a users behalf and do not want the user to
      change them.

    -vt (ceterm.vt)
      This  option  controls  how ceterm treats conversion to  vt100  emulation
      mode. "ceterm.vt : auto"  causes ceterm to switch to vt100 emulation mode
      using  an algorithm similar to the HP/Apollo terminal windows.  The other
      values allow manual control of vt100 emulation mode.


      The  .Cekeys  file  now  allows the cmdf command  to  be  present.   This
      provides  an  include facility for the .Cekeys file.  The  only  commands
      allowed  in  the  .Cekeys file and the included files are  'kd',  'cmdf',
      'wdc',  and  'wdf'.   This  facility  allow group  and  system  wide  key
      definitions to be included from the .Cekeys file.

      The 'ce', 'cv', 'pn', and 'cmdf' commands allow environment variables  to
      be  used  in  path names.  The environment variables  correspond  to  the
      environment at the time Ce was invoked.  The 'env' command can be used to
      examine and set environment variables within the Ce session.

      The  default  key definitions as installed by "ce_init" have changed  for
      the  actions of the mouse.  The default M1 does a highlighted drag with a
      copy on the up stroke and M2 does a paste. The former M1 functionality has
      been  moved  to  M3.  Help has been moved to F9 (A blank key on  some  HP
      keyboards).  Shift and control of the mouse keys has been added.  See the
      .Cekeys file created by "ce_init" for more information.

      The  default  key definitions in the $CEMAINDIR/data directory  are  now
      delivered in both Aegis and Unix regular expression mode.  The Unix mode
      definitions  are  commented  out.   You may modify  the  data  files  to
      initially  define  the Unix mode definitions.  See the keyCon help  file
      for  more  information on doing this customization.  If this  change  is
      made,  you need to modify the Ce.expr line in the .Xdefaults file of the
      $CEMAINDIR/data directory to specify Unix mode expressions.

      The  'es' (enter string) command allows an additional syntax.   Normally
      the  syntax is es 'string' or es "string".  es #string# is now  allowed.
      This  nonstandard quote character allows users to get around certain csh


      The  key definitions for F2 through F4, ^c, ^e, and ^p have been  updated
      in  the  initial  .Cekeys file to remove the -l (local) option  from  the
      definition.  You should make this change in your person .Cekeys file. The
      -l option prevented copy and paste across windows from working.
      For example:
      OLD:   kd F2   xc -l    ke
             kd F2S  xc -l -r ke
      NEW    kd F2   xc       ke
             kd F2S  xc -r    ke

      In  the files used by ce_init to build the .Cekeys files, alternate  Unix
      mode  definitions have been provided.  These  definitions  are  initially
      commented  out.  They can be updated by the user in their private .Cekeys
      file  or by the system administrator in the master copies.  In the keydef
      file  (either  .Cekeys or the master copy), find the line "Ce.expr".   It
      will be in a comment line.  Below it will be two key definitions.  One is
      commented  out  with  the string "#Unix expr".   Delete this  string  and
      comment out the existing definition on the line above.


   Several  of  the changes in release 2.3 make Ce not integrate properly  with
   release 2.1.  These changes are described here.

  1.  Default Saved Paste Buffer name
      When a Ce session is ended, Ce takes the paste buffers it owns and copies
      them  to  files  in  the  paste buffer directory.   By  default  this  is
      ~/.CePaste.   This  permits other Ce sessions to paste from  this  buffer
      after  the  process  has terminated.  Special code originally  saved  the
      default  paste  buffer as name ".UNNAMED" in the paste buffer  directory.
      This  code  has  been removed and the name used now  is  CLIPBOARD.   The
      result  is that if a release 2.2 or 2.1 terminates, a release 2.3 Ce will
      not  be  able to see the saved paste buffer.  The same is true if  a  2.3

  2.  To avoid problems which occurred when many windows were brought up during
      login  processing  and  to  support   the  new  paradigm  for  CC  window
      processing,  changes were made in the way Ce windows make there  presence
      known  to each other.  The result is that Ce 2.2 and earlier windows will
      not  see Ce 2.3 windows when searching to see if a window is already open
      on  that file.  Also, the 'tn' and 'ti' commands will not work between ce
      and cc windows.

  3.  Processing for the 'wdf' and 'wdc' commands have changed for release 2.3.
      Thus  release  2.2 and 2.1 windows will be unable to use the wdc and  wdf
      lists created by 2.3 Ce.  The reverse is also true.


   The following are problems known to be in Release 2.3 at the time of release.

  1.  Paste to a slow device on HP/UX
      If  you  have a program which reads data slowly from stdin running in  a
      ceterm  window and you paste in a large amount of data (more than  about
      50  lines) into the Unix command window and press ^b, the data is thrown
      away  by the line discipline.  This is consistent with the documentation
      for  the  line discipline.  However, xterm has a way around this and  it
      will be pursued.  A program which copies stdin to a file with a sleep in
      the loop will demonstrate this problem.  This occurs only on HP/UX.
  2.  Using rsh to start a ceterm with display back.
      On Sun/OS 4.1.3 only.  The command
      rsh <node> $CEBINDIR/ceterm -display <current_node:0>
      Gets I/O errors from select.  This technique works on all other supported

  3.  Remembered search string in CC mode.
      Each CC window should have it's own remembered search string.  This does
      not always happen.

  4.  Prompt on Solaris 2.3 under csh
      On Solaris 2.3, when running csh the shell cd command adds extra data in
      front  of  the  prompt.   This information is  used  by  cmdtool.   This
      information appears as extraneous information in the prompt on a ceterm.

  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.