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.