doc/wcopy.1x

   1 .TH wcopy,wpaste 1 04/09/01
   2 .UC 4
   3 .SH NAME
   4 wcopy \- copy stdin to an X11 cut buffer
   5 wpaste \- paste X11 cut buffer to stdout
   6 .SH SYNOPSIS
   7 .B wcopy [ [0-9]... ] [wxcopy's normal args]
   8 .SH DESCRIPTION
   9 \fBwcopy\fP reads from standard input and copies it to the nominated
  10 X11 cut buffers.
  11 The default is the first cut buffer.
  12 .PP
  13 \fBwpaste\fP pastes the nominated X11 cut buffers(s)
  14 to standard output.
  15 The default is the first cut buffer.
  16 .PP
  17 Note that the cut buffers are numbered starting from 0.
  18 .PP
  19 Simple integer arguments pick a cut-buffer.
  20 .PP
  21 For \fBwcopy\fP,
  22 the argument number picks a cut-buffer to copy the standard input to.
  23 (Subsequent copies are taken from the first nominated buffer \-
  24 it does not try to re-read the input!))
  25 .SH EXAMPLES
  26 .TP 1.5i
  27 .B echo fred | wcopy 1 2
  28 This puts the word "fred" into the 2nd and 3rd cut-buffers.
  29 .TP 1.5i
  30 .B wpaste | tr "A-Z" "a-z" | wcopy 1
  31 This copies the clipboard then translates all upper case letters to lower in
  32 the 1st
  33 cut buffer and copies the result into the 2nd.
  34 .TP 1.5i
  35 .B wpaste 0 | fmt -w 66 | sed 's/^/> /' | wcopy 1
  36 This reformats the clipboard to paragraphs with lines no longer than 66
  37 characters, inserts typical email quoting characters, and copies the
  38 output to the 2nd cut-buffer.
  39 .TP 1.5i
  40 .B wpaste | sed 's/^> *//' | wcopy
  41 This removes email quotes from the start of lines in the clipboard
  42 and replaces the clipboard with the un-quoted material.
  43 .TP 1.5i
  44 .B wpaste > ~/.myclipboard
  45 Copies the clipboard into a location where it can be pixked up from other
  46 computers (e.g. even from a Windows machine) \- as per the file permissions
  47 you choose for the ".myclipboard" file.
  48 .SH ENVIRONMENT
  49 If WXCOPY_DEFS or WXPASTE_DEFS are defined in your environment,
  50 they will always be provided as the first argument(s) to the
  51 respective underlying command.
  52 .SH BUGS
  53 Don't use "-cutbuffer N" notation as per wxcopy/wxpaste:
  54 stick to just using the plain unadorned number(s) that wcopy/wpaste expect.
  55 .SH SEE ALSO
  56 wxcopy(1), wxpaste(1), xcb(1)
  57 .SH AUTHOR
  58 Luke Kendall