--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Mon Jul 20 05:10:37 2015 +0000
@@ -0,0 +1,24 @@
+I, Mychaela Falconia, am mostly a software girl, but every now and then I make
+a foray into hardware design out of necessity: if I want to play with a toy
+that doesn't exist, I have to design and build it myself if I wish to bring it
+into existence.  When I did my first hw design (the OSDCU board for SDSL) and a
+few very simple boards subsequent to that one, my hw design (EDA) environment
+ran on a big UNIX machine named ifctfvax.  My tool suite (ueda) and the
+associated part library (ifctf-part-lib) were maintained in a CVS repository on
+ifctfvax.
+
+The present Hg repository is an adaptation of my hw design environment from
+UNIX to Linux; it has been created for the following two reasons:
+
+1. Due to a downturn in my personal life circumstances, I had to shut ifctfvax
+   down, and it may be a while before I can power it back up.
+
+2. My current board design projects are part of the FreeCalypso libre phone
+   project (www.freecalypso.org), and I don't expect to have much overlap
+   between the libre phone community and the big old UNIX community - hence I
+   thought it would be a good idea to make my FC hardware designs accessible to
+   those who don't care much for big old UNIX.
+
+To use these EDA tools, go into the ueda subdirectory and run 'make' followed
+by 'make install'.  The ifctf-part-lib tree needs to be installed in (copied
+verbatim to) /usr/local/eda.