INSTRUCTIONS FOR PINLABELER-0.3 on Cygwin. (2010-06-25)

First make sure you will be installing/running it from an account that has NO spaces in the name of the account owner. Something like "Paulo Ney" will NOT work, so if necessary change the account name to contain NO spaces, or add such an account an proceed from there. Cygwin does have a page on deal with spaces on Windows path names:

http://cygwin.com/cygwin-ug-net/using.html#using-pathnames

but it is just not worth the trouble ...

Install Cygwin from:

http://www.cygwin.com/

During the installation choose an editor (gvim, emacs-X11, xemacs, ...) from the "Editor" area. Install X11 as well, I have done everything because it is easier, make sure you choose at least the minimal that will work a functional X environment.

Type "Xaw" in the search window and install all components found, including Xaw3D and libXaw. Again it is easier to do them all. If you lookig to save space - be careful.

Also install "wget" from the Web-set. Just enter it in the search window.

After the installation of Cygwin, execute it from the Windows menu choice, or the icon on the desktop - which will open a BASH shell.

In the BASH shell, execute the command:

startx

which will provide you with a full working X environment. In one of the shells that open do:

cd
mkdir opt
cd opt
wget http://hans.math.upenn.edu/~pstorm/src/pinlabeler-0.3_cygwin.tar.gz
gunzip pinlabeler-0.3_cygwin.tar.gz
tar xf pinlabeler-0.3_cygwin.tar
cd /usr/bin
ln -s /home/PauloNey/opt/pinlabeler-0.3/pin .

You are now ready to start pinning some files. Go to a directory where you have some EPS files and execute:

Assume the figure you'd like to pinlabel is figure.eps. Assume the file foo.tex will contain the pinlabels.

Open foo.tex with an X window text editor. gvim works. vim inside xterm does not seem to work. (If you know why, please explain this to me.) Anything inside gnome-terminal works for me. Experimentation may be required.

Ensure the text editor is ready for input. E.g. in gvim enter INSERT mode at the desired location.

Start pin with the command "pin figure.eps".

When asked, click on the window of your text editor.

A gv window will open. Left mouse clicks will send a line of pinlabel output to the current cursor position of the text editor.

Quit labeling by closing the gv window. You can then work with foo.tex as you wish.

-Paulo Ney de Souza