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. _______________________________________________________________________________ Copyright (c) 2005, Robert Styma Consulting. All rights reserved.