ARPUS/ce, Version 2.6.2 (03/10/05) (SCCS 1.9) _______________________________________________________________________________ xp [-r [-a]] [-l] [-f <pathname> | <name>] "text paste" DESCRIPTION: 'xp' copies text to the current or marked cursor position from either an internal paste buffer accessible from X selections, an internal paste buffer that is local to the edit session, a named paste buffer in the paste buffer directory, or a text file. xp can be used in one of four ways: xp Paste text from the default paste buffer as defined by the Ce.dfltPasteBuf X resource. This paste buffer is available to other ce windows and to other X applications using the X selection mechanism. If the X selection is owned by a ce session when that edit session terminates, the paste buffer data is saved in the paste buffer directory as a file. This file contains the text. xp <name> paste text from the internal paste buffer with name <name>. This paste buffer is available to other ce windows and to other X applications using the X selection mechanism named <name>. If the X selection is owned by a ce session when that edit session terminates, the paste buffer data is saved in the paste buffer directory as a file. There are three special paste buffer names (BangIn, BangOut, and BangErr) used by the ! (bang) command that always use the paste buffer files. xp -f <pathname> paste text from an on-disk file. xp -l Paste text from the default paste buffer as defined by the Ce.dfltPasteBuf X resource. Position the cursor at the end of the pasted region instead of at the point of insertion. PARAMETERS -r Do a rectangular paste. A rectangular paste differs from a normal paste as follows: A normal paste inserts all the text from the paste buffer at the current cursor location. This includes newlines. A rectangular paste inserts the first line of the paste buffer (up to the newline) at the current cursor position. The position in the cursor is then moved down one line from the original cursor position and the next line of the paste buffer is inserted at that point. This is repeated for each line of the paste buffer. The file is extended at the bottom as necessary. An example of the usefulness of rectangular paste can be seen in the following example. Consider a file with 5 columns of numbers. Each column is 200 lines long. We desire to move the second column of numbers and make it the fourth column. To do this, we mark a rectangular region highlighting the second column of numbers and cut it. We then put the cursor on the first line over the spot we wish to insert the column we just cut. The we execute a rectangular paste and the column is where it belongs. -a Specified alone, -a does nothing in the xp command. Specified with -r, the -a option causes the paste to be done in overstrike mode instead of insert mode. It covers up characters. This is useful for pasting data into a predefined box. -f <path> Copy the text from a file on the machine Ce is executing on. -l The -l argument specifies that the cursor is to be placed at the end of the pasted text rather than at the beginning. This option is ignored if -r (rectangular paste) is specified. Note that this option makes use of labels <name> Get data from the named X paste buffer. RELATED HELP FILES: ! (bang ) xc (Copy ) xd (Cut ) xl (Copy Literal) xp (Paste) xa (Concat Pastebuff) regionsCon (marking regions) pastebufCon (Paste buffers) support (customer support) _______________________________________________________________________________ Copyright (c) 2005, Robert Styma Consulting. All rights reserved.