This is an beta release and should be considered experimental.

### Install Notes ###

WINDOWS -
* exe: Double click and follow prompts to install srcml.
* zip: Extract and run srcml from a command prompt at a given directory.
       Add srcml.exe to windows environment PATH for usage outside of extracted directory.

MACOS -
* dmg: For Yosemite and Mavericks ONLY, open dmg and run the pkg file to begin installation.
* tar.gz: Extract srcml and run commands to:
          * Copy contents of srcml bin directory to /usr/local/bin (create directory if necessary)
              sudo cp srcml/bin/* /usr/local/bin
          * Copy contents of srcml lib directory to /usr/local/lib (create directory if necessary)
              sudo cp srcml/lib/* /usr/local/lib
          * Copy contents of srcml include directory to /usr/local/include (create directory if necessary)
              sudo cp srcml/include/* /usr/local/include

LINUX - 
* rpm, deb: Run with distribution specific package manager (apt, yum, etc.) to install.
* tar.gz: Extract srcml and run commands to:
          * Copy contents of srcml bin directory to /usr/bin (create directory if necessary)
              sudo cp srcml/bin/* /usr/bin
          * Copy contents of srcml lib directory to /usr/lib (create directory if necessary)
              sudo cp srcml/lib/* /usr/lib
          * Copy contents of srcml/include directory to /usr/include (create directory if necessary)
              sudo cp srcml/include/* /usr/include
          * NOTE: Files may also be copied to /usr/local/bin, /usr/local/lib, and /usr/local/include
                  however, it may be necessary to set LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
		  in .profile, .bash_rc, or other terminal configuration file.

### Build Notes ###
* The XML namespace for srcML has changed.  This may break existing tools.
* The client srcml is dynamically linked to libsrcml.  Make sure to place the library in a location where it can be found automatically
  or use one of the installers.
* Mint 17 and 17.1 may need a version of libcurl installed (package libcurl3).


### Client Issues
* Losing network connection mid connection with a remote file can cause the client to lock up.
* --info and -i will only show xmlns and xmlns:cpp namespaces
* --prefix and -p can return prefix values associated with a uri even if it's not in use in the srcml document
* when using --no-xml-declaration in combination with --xml on a srcml document still shows xml declaration
* when using --no-namespace-decl in combination with --xml on a srcml document still shows namespace declaration
* --longinfo and -L will only show xmlns and xmlns:cpp namespaces
* --longinfo and -L will only show xmlns:cpp namespace even if it is not present in srcml archive header
* using --xml with a srcml xml file as input and -o or --output with a *.xml extension will throw an error.
* --apply-root doesn't copy down xmlns namespace
* parsing illformed xml will not necessarily fail without first outputting some data