ARPUS/Ce cmd help rlse.html

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

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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

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.

NEW ARGUMENTS AND X RESOURCES:

-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

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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.

NEW CE COMMANDS:

cntlc
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

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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.

NEW CE COMMANDS:

reload
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.

NEW OPTIONS TO EXISTING CE COMMANDS:

-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
specified.
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

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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

NEW CE COMMANDS:

sl
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)
blue.

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

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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

NEW ARGUMENTS AND X RESOURCES:

-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.

NEW ENVIRONMENT VARIABLE:

CE_KDP=<name>
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

NEW DISPLAY FEATURES:

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
efficient.

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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

NEW ARGUMENTS AND X RESOURCES:

-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

NEW CE COMMANDS:

caps
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.

NEW OPTIONS TO EXISTING CE COMMANDS:

-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.

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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
fixed.

Bug Fix: Several minor problems involving colored text have been
fixed.

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

NEW MAJOR FEATURES:

SCROLL BARS
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.

MENU BAR AND PULLDOWNS
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.

COLORIZATION
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.

LABELS
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.

HTML DOCUMENTATION
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
page.

CONTRIBUTED PROGRAMS
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.

NEW ARGUMENTS AND X RESOURCES:

-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
processors.
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

-oplist
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.
VALUES:
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:
New Ce commands were added to support colorization of text, pull
down menus, scroll bars, statement labels, and miscellaneous
features people asked for.

ca
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
window.

fbdr
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.
sb
The scroll bar command allows the scroll bars to be
switched on and off.

mi
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.
lmi
The local menu item command creates a menu item for just
the current window.

pd
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".

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

tmb
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.

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

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

eval
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.

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

glb
The go label command positions the cursor at the named
label.

dlb
The delete label command deletes all labels in a range of
text.

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

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

CE_INIT CHANGES:
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.

CE_ISCETERM:
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.

CE_INSTALL CHANGES:
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
ce_init.

INCOMPATIBILITIES BETWEEN 2.5 AND 2.4.2
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.

NEW ARGUMENTS AND X RESOURCES:

-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.
DEFAULT: CLIPBOARD

-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

-transpad
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

NEW CE COMMANDS:
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.

alias
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
functions.

sp
'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
'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
possible.

xl
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.

NEW OPTIONS TO EXISTING CE COMMANDS:

-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.

NEW EXECUTABLES:

ce_update
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.

NOTEWORTHY BUG FIXES AND ENHANCEMENTS:

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.

CE_INIT FIXES:
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"

INCOMPATIBILITIES BETWEEN 2.4 AND 2.3.2

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
line.

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
up.

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.

NEW CE COMMANDS:

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

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.
$CEHELPDIR/mouse.hlp

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
cmdf.

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

NEW PARAMETERS TO EXISTING COMMANDS:

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
window.

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.

NEW RUN TIME OPTIONS AND X RESOURCES:

-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.

ceterm.man
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.

-readlock
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.

OTHER ENHANCEMENTS:

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.

NOTE TO SYSTEM ADMINISTRATORS (INSTALLERS):
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
problems.

CE_INIT FIXES:

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.

INCOMPATIBILITIES RUNNING VERSION 2.3 WITH VERSION 2.1

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
terminates.

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.

KNOWN BUGS IN 2.3:

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
platforms.

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.