# HG changeset patch
# User David Barts <n5jrn@me.com>
# Date 1618335213 25200
# Node ID a9d5c94a177c09a01497679340edfb3dfed2d5b2
# Parent  c8ec2d7af3fbb432a237f9e5aabf1b8794915b05
Add README file.

diff -r c8ec2d7af3fb -r a9d5c94a177c README.txt
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.txt	Tue Apr 13 10:33:33 2021 -0700
@@ -0,0 +1,30 @@
+This is a simple, portable clipboard manager written in Kotlin. It
+should run on all three of {Linux, Macintosh, Windows}.
+
+Although in most respects pretty basic, it does support one feature that
+I wish most clipboard managers had (but to my knowledge which none but
+this one have): the ability to coerce a text from one font family to
+another. By this I mean, suppose you have a text passage in 10 point
+Times Roman. The text uses bold and italics for emphasis. You wish to
+paste into a document as 12 point Helvetica.
+
+For the vast majority of document-editing programs, you have two
+choices, both of them bad:
+1. Paste the text preserving existing formatting, i.e. as 10 point Times
+   Roman, then plod through it converting the plain text parts to 12
+   point Helvetica plain, the italics to 12 point Helvetica oblique, and
+   the bold to 12 point Helvetica bold.
+2. As above, but paste as plain text, losing all formatting, then put
+   the relevant formatting back.
+
+Just *try* getting everything correct on the first try, I dare you. Yet
+all the emphasis is there in the original text; it shouldn’t be *that*
+hard to use it to generate a comparable text in a new font family. Yet
+no such option exists!
+
+ClipMan has such an option. Copy the source text into the clipboard,
+choose “Coerce…” and select 12-point Helvetica as the proportional font
+to coerce to. Bam! Done!
+
+A somewhat obscure operation, perhaps, and even I don’t use it every
+day. But when I need it, it is *very* convenient to have it.