ClipRdWr 1.3

Short:        read+write text from/to any clipb. unit
Author:       Jody Tierney
Uploader:     amigasourcecodepreservation gmail com
Type:         util/cli
Version:      1.3
Replaces:     util/cli/ClipRdWr12a.lha;util/cli/ClipRW.lha
Architecture: m68k-amigaos

Two CLI programs to display & write text from/to any clipboard unit.
Uploaded to aminet for historical preservation.

Notes:
======

ClipRead
-======-
  A CLI program to display the text in any clipboard unit.

  Usage:  ClipRead [[U=UNIT] <n>] [LF=LFATEND]

          - UNIT <n> - Where <n> is the clipboard unit (0-255) to read.
                       Defaults to PRIMARY_CLIP (currently 0).  It isn't
                       necessary to specify the keyword "UNIT".

          - LFATEND  - Supply a linefeed ($0A) if the string doesn't end with
                       one.  By default, the string is printed exactly as it
                       exists in the clipboard (i.e. it may or may not end
                       with a linefeed).

ClipWrite
-=======-
  A CLI program to write text to any clipboard unit.

  Usage:  ClipWrite [U=UNIT <n>] [NP=NOPARSE] [TEXT] <text>

    - UNIT <n> - Where <n> is the clipboard unit (0-255) to write to.
                 Defaults to PRIMARY_CLIP (currently 0).

    - NOPARSE  - Ignore any format commands (see below) in the text.

    - <text>   - The text to store in the clipboard.  The text may contain
                special format commands, which begin with a backslash (""),
                listed below.

      - Text format commands:
        t     A tab (ASCII 9).
        n     A linefeed (LF) (ASCII 10).
        r     A carriage return (CR) (ACSII 13).
        e     An ESC (ASCII 27).
        q     A quote mark:  " (ASCII 34).
        \     A backslash:   (ASCII 92).
        #<n>  Where <n> is the number (0-255) of an ASCII character to
               insert.
                 Examples:  #169  The copyright character:  ©.

                            #$A9  Still the copyright character, only this
                                   time we specified it using a hex number.

                            #%10101001  Yep, copyright again in binary.
        .     Does nothing; it's useful after a "#", however:  "#169.1997"
               will equal "©1997".  Without the ".", ClipWrite would try (and
               fail) to evaluate 1691997.


Requirements:
-===========-
  Workbench 2.04 or higher

Thanks To:
-========-
  - God - For life, the universe, & everything.

  - Wouter van Oortmerssen - For Amiga E, the best language I've ever used.

  - My cat - Okay, I'll admit it, he's the real brains of the operation here.

  - Jilles Tjoelker <M.Tjoelker@nl.cis.philips.com> - For spotting and correcting
   the bugs in v1.2a.

  - Ramones - For some really great music to program by.


To Do:
-====-
  - Find any bugs and replace them with newer, more interesting bugs.
  - Maybe more format commands for ClipWrite, if the need arises.


Bugs:
-===-
  - According to the AutoDocs, there were a few bugs in the iffparse.library,
   prior to v39, with the OpenClipboard() function.


http://myplace.frontier.com/~jodytierney/prgsutil.html

Cheers!
https://twitter.com/AmigaSourcePres

  _____ ___   _   __  __     _   __  __ ___ ___   _   
 |_   _| __| /_ |  /  |   /_ |  /  |_ _/ __| /_  
   | | | _| / _ | |/| |  / _ | |/| || | (_ |/ _  
  _|_| |___/_/ __|_ |_|_/_/___|__|_|______/_/__
 / __|/ _ | | | | _ / __| __|  / __/ _ |   | __|  
 __  (_) | |_| |   / (__| _|  | (_| (_) | |) | _|   
 |___/___/____/|_|_\___|___|________/|___/|___|_ 
 | _  _  __/ __| __| _   / /__   _|_ _/ _ | | |
 |  _/   / _|__  _||   / V / _ | |  | | (_) | .` |
 |_| |_|____|___/___|_|_ _/_/ __| |______/|_|_|