• simple macros that may be used with uni-XEDIT Basic
• macros that include programming logic and therefore require uni-XEDIT Extended
• applications built around uni-XEDIT that require licenses for both uni-XEDIT Extended and uni-REXX

The following sections provide brief descriptions of the samples in each category. Comments in the sample files provide additional details. The sample files also include, at the top, comments describing the licenses required for their execution. The sample library is located in the directory "samples.xe" in the directory in which uni-XEDIT is installed (default: /usr/local/xedit).

You may download the files directly from these pages using "Save As". Or you may download a compressed tar file that contains all the samples .

uni-XEDIT Basic Macros

Basic macros generally tailor the editing environment in one of the following ways:

• initial screen display
• keyboard mappings
• PF key definitions
• synonym definitions

Such macros contain only commands documented in the uni-XEDIT Reference Manual. They are typically executed as profiles to customize the editor for a particular user or session. In the case of PF key or synonym definitions, some care is required. If the PF key or synonym is assigned to a standard editor command or Basic macro, only a Basic license is required. If the PF key or synonym is assigned to a macro that includes programming logic, an Extended license will be required to run that macro. The shellinit.xedit macro in this library is an example of a Basic macro that sets synonyms for macros requiring an Extended license.

prof1.xedit

sample profile to reconfigure initial screen display

prof2.xedit

sample profile to assign simple synonyms and PF key definitions

xterm_sun.xedit

sample profile with keybindings for Sun's xterm configuration and the console Type 5 keyboard

xterm_rs6k.xedit

sample profile with keybindings for IBM's xterm configuration and the console keyboard

xterm_hp.xedit

sample profile with keybindings for HP's xterm configuration and the console keyboard

xterm_sgi.xedit

sample profile with keybindings for SGI's xterm configuration and the console keyboard

xterm_sco.xedit

sample profile with keybindings for SCO Version 3 Open Desk Top xterm and the console keyboard

uni-XEDIT Extended Macros

These macros generally fall into two categories:

• those that automate editor tasks through programming logic
  
• those that extend the capabilities of the editor by adding new commands or features

In both cases, the extensions are implemented using a combination of uni-XEDIT commands and Rexx programming logic. Using these macros therefore requires a license for uni-XEDIT Extended for each concurrent user of the macro.

bclr.xedit

clears a rectangular block of text; this differs from the CUT/PCUT commands in that no "closing up" of the data occurs; an empty block remains where the text was "cleared"

bcopy.xedit

copies a rectangular block of text; performs the same function as COPY/PCOPY when SELMODE is set to BLOCK

bdel.xedit

deletes a rectangular block of text; performs the same function as CUT/PCUT when SELMODE is set to BLOCK

bmove.xedit

moves a rectangular block of text to a new location, leaving the original space blank; this differs from PMOVE in that no "closing up" of the data occurs

bover.xedit

overlays a rectangular block of text onto a new position, replacing any data that may already be in the new location

dbs.xedit

performs a destructive backspace in a data line when assigned to a PF key or other key sequence

ending.xedit

moves the cursor to the end of the data line when assigned to a PF key or other key sequence.

every.xedit

an extension of the ALL command; allows you to display a specified number of lines before or after those that contain the specified string target

flow.xedit

reformats paragraphs of text after text modifications have created poor alignment

invert.xedit

swaps the display between currently displayed lines and currently excluded lines

less.xedit

excludes additional lines from a display in which some lines are already excluded

mk.xedit

runs a background 'make' on the file currently being edited and displays the results in a different X window; calls "xemake"

more.xedit

displays additional lines in a display where some lines are already excluded

msplit.xedit

splits a line either before or after the specified string

nextword.xedit

moves the cursor to the next word in the line when assigned to a PF key or other key sequence

nl.xedit

moves the cursor to the beginning of the data on the next line of the file when assigned to a PF key or other key sequence; differs from the keyname "newline" which moves to the beginning of the prefix area

nocomm.xedit

excludes Fortran comment lines from the display in Fortran source files (name.f or name.for)

rlpx.xedit

prints all or part of the file currently being edited

shl.xedit

simulates CMS subset mode; exits to the UNIX shell where you may enter multiple commands before returning to the editor

spell.xedit

adds spell-checking capabilities to the editor, thereby extending its word processing capabilities

shell*.xedit

a set of macros to replace the uni-XEDIT I/O commands (file, save, get, put, macro, etc.); these macros support expansion of shell variables and shorthand on the uni-XEDIT command line

shellinit.xedit	shellfile.xedit	shellffile.xedit
shellsave.xedit	shellssave.xedit	shellmacro.xedit
shellget.xedit	shellput.xedit	shellputd.xedit
shellxe.xedit	expand	expmsg
justone

toggle.xedit

toggles the display between showing currently selected lines and showing all lines in the file

weed.xedit

with a string target operand, deletes all lines in the file that satisfy the target; with no operand, deletes from the file all lines that are currently excluded

Applications Built Around uni-XEDIT

Samples in this category are composed of a combination of uni-REXX programs and uni-XEDIT macros. Thus they require a uni-REXX license for the host computer on which they are to be run in addition to licenses for uni-XEDIT Extended. Applications in this category illustrate the most extensive form of editor customization.

adbook

electronic address book application that illustrates full-screen applications based on uni-XEDIT's SET RESERVED and READ features

address.xedit, reshow.xedit

macros used with the adbook application

x

start-up program for uni-XEDIT that, upon termination of the edit session, marks the file executable if the first line contains an implicit execution string (such as #!/usr/local/bin/rxx, #!/bin/sh, etc.)