=======================================================================
xyscan 4
=======================================================================
A data thief for scientist.

Copyright 2002-2016 Thomas S. Ullrich (thomas.ullrich@bnl.gov)
This version: 4.3.0 (December 2017)

xyscan is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; See license.txt and gpl.txt.

This directory contains all sources and files needed to built
xyscan. Supported platforms are LINUX, Windows, and Mac OS X.


Obtaining xyscan.
Binary distributions are available from the xyscan web site:
http://rhig.physics.yale.edu/~ullrich/software/xyscan/index.html
If not available for your system you need to build it from 
the source distribution available on the same side.
For Windows or Mac I strongly recommend to grab the installer
and use the binary distribution. Replying an app on either platform
is not for the fainthearted. On Linux one has to build
xyscan from the source which is straightforward.

Building xyscan from scratch
============================
This is straightforward. All what is needed is a C++ compiler
with C++11 support, Qt5, and the poppler library used for handling
PDFs (poppler-qt5 is needed).

You can either use the command line tool qmake or the Qt Constructor.
Both are shipped with Qt. On the Mac you can use Xcode to build xyscan
on Windows Visual Studio.

Linux
=====

1. Download the tar ball of the latest source
   (here xyscan-4.30-src.tar.gz)

2. Unpack
   tar -xzvf xyscan-4.30-src.tar.gz

   This will create a directory xyscan with all the needed files

3. cd xyscan

4. Adjusting the xyscan.pro file to your installation.

   Edit xyscan.pro. There are very few places where you might
   need to adjust things:

   a) Check where your “poppler” library and include files are installed.
      If they are not in /usr/local or /opt/local or /usr you will need 
      to change the referring lines.
   b) By default xyscan will be installed in /usr/local/bin
      and the needed resource files (documentation) in 
      /usr/local/share/xyscan. If you want it in a different place
      use qmake PREFIX=<your directory> 
      
      Note that you might have to edit xyscanWindow.cpp and modify 
      createHelpBrowser() to accommodate any unusual location(s).

5. qmake [PREFIX=<install-dir>] xyscan.pro

6. make

7. make install
   or 
   sudo make install
   depending on your privileges 


