ARPUS/ce, Version 2.6.2 (07/28/05)    (SCCS 1.1)
_______________________________________________________________________________
 [range] cntlc [-h <hexchar>] [-a] [-r] [-l] [-f <pathname> | <name>]
 "text copy"
 
 DESCRIPTION:
     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 

     The cntlc command takes the parameters from 'xc' command (copy) and the
     -a parameter from the 'dq' command (interupt) translated to -h to avoid
     conflict  with xc.  Many editors use the <ctrl>-c sequence to do a copy
     to  the  clipboard.   However, terminal emulators use  <ctrl>-c  as  an
     interupt.   This  command resolves this issue by  behaving  differently
     based on the environment.

     The limitation of cntlc lies in the default action of the 'xc' command.
     In  'xc'  if  no  region is marked (highlighted), the  line  under  the
     cursor,  from the current position to the end of line is copied.  In  a
     ceterm  window, cntlc will send an interupt under this condition.  In a
     ce window it will perform the 'xc' function.

     
 PARAMETERS
     -h <hexchar>
             This option sends the character hexchar to the shell. <hexchar>
             can  be any character valid in an er (enter raw) command.  This
             includes  two  digit  hex  codes, such as  0C  or  A3,  control
             constructs  such  as ^c or ^d, and C type  escaped  characters,
             such as \t and \r.  For example, dq -a ^c forces dq to send the
             hex 03 character as a quit character to the shell. This feature
             is  useful on some platforms when using telnet.  By default  dq
             queries  the  shells  line  discipline  to  get  the  interrupt
             character  and  sends  this character.  Because  multiple  line
             disciplines  are  involved  in telnet, the wrong  character  is
             sometimes  returned.  Since interrupt is almost always ^c  (see
             stty(1V))  this  can be compensated for with the -a  parameter.
             This parameter is ignored if a process id (<pid>) is specified.

     -l      Use a "local only" paste buffer. This works like a normal paste
             buffer  except that the X server does not get involved and  the
             contents  of  the  paste buffer are not saved in  a  file  upon
             termination. This improves performance and disables the copying
             of  data  between  different  windows.  It is  useful  for  cut
             commands which are throwing data away.

     -r      Treat  the  affected region as a rectangular region.   See  the
             'regions' help file mentioned below for an exact description of
             the behavior of rectangular regions.

     -a      Append mode.  Append the region being copied to the paste buffer.

     -f <path>
             Copy  the  affected  region into a file on the  machine  Ce  is
             executing  on.  Text copied to a file will probably not be able
             to  be  pasted  into a Ce window executing on  another  machine
             unless  that  machine has access to the file which  was  pasted
             into.

     <name>
             Copy to the named X paste buffer.
     
 
 RELATED HELP FILES:
     xc            (Copy )            
     dq            (Kill)             
     
     keyboard      (common keys)      
     regionsCon    (marking regions)  
     pastebufCon   (Paste buffers)    
     support       (customer support) 
     

_______________________________________________________________________________
  Copyright (c) 2005, Robert Styma Consulting.  All rights reserved.