XSH - XML Editing Shell

A. Stable release (2.1.1)
1. Linux, UNIX, BSD, MacOS X, etc.
2. Windows
B. Developement versions (SVN)
C. Older versions

A. Stable release (2.1.1)

1. Linux, UNIX, BSD, MacOS X, etc.

On-line installation from CPAN:
```
cpan XML::XSH2
```
If you are running the cpan installer for the first time, you will be prompted several questions. Note that with the default configuration of the CPAN installer you may need root's privileges to proceed.
RPM packages (may be outdated):
- Fedora Core - kindly provided by Ismael Olea
- Other - search the rpm.pbone.net RPM search service.
Off-line installation:

Download the bundle containing the current version of XSH and all required modules and libraries: Bundle-Unix-XSH2-2.1.0.tar.gz

To install to standard paths, issue the following commands:
```
$ tar xzf Bundle-Unix-XSH2-2.1.0.tar.gz
$ cd Bundle-Unix-XSH2
$ sudo ./install
```
To install to a custom directory prefix (such as your /home directory), use something like
```
$ tar xzf Bundle-Unix-XSH2-2.1.0.tar.gz
$ cd Bundle-Unix-XSH2
$ ./install --prefix=/home/somebody/apps
```
(change /home/somebody/apps appropriately).

Finally, setup your PATH, PERLLIB and LD_LIBRARY_PATH in your login script accordingly. The install script suggests right settings for Bash and C-shell based on the prefix you have chosen.

See ./install --help for more options of this off-line installer.

2. Windows

If you wish to install XSH2 in the Cygwin environment or for Strawberry Perl, please, follow the above instructions for Linux. You may as well need to build libxml2. Users of these products are kindly asked to send the author suggestions for making this information more complete.

For a native Windows installation you will need ActivePerl (at least build 820) from ActiveState.

Note: The following features are do not work as expected on Windows/ActivePerl:

output redirection (broken - disabled),
TAB-completion (works only on some setups),
history (arrow keys do not work, but Ctrl+p and Ctrl+n as well as other readline shortcuts with Ctrl seem to work).

Feel free to send patches if you know how to implement these features on Win32.

ActivePerl (builds 820 and newer)

On-line installation:

open the command prompt (Press Win+R and type cmd) and run the following commands:

ppm install Parse-RecDescent
ppm install IO-stringy
ppm install XML-NodeFilter
ppm install XML-NamespaceSupport
ppm install XML-Filter-BufferText
ppm repo add http://theoryx5.uwinnipeg.ca/ppms/ kobes
ppm repo add http://xsh.sourceforge.net/ppms/ xsh
ppm install XML-XSH2

Off-line installation:

download Bundle-Win32-XSH2-2.1.0.zip, unzip it into some directory (say c:\install)

Open the command prompt (Press Win+R and type cmd) and type the following commands:

c:\> ppm repo add c:\install temp
c:\> ppm repo
+--------------------------------------------+
| id | pkgs | name                           |
+----+------+--------------------------------|
|  1 | 6451 | ActiveState Package Repository |
|  2 |   15 | temp                           |
+--------------------------------------------+
 (2 enabled repositories)

c:\> ppm repo off 1
c:\> ppm install XML-XSH2
c:\> ppm repo del 2
c:\> ppm repo on 1

where c:\install is the directory containing the unzipped bundle and 1 and 2 correspond to the ActiveState and temp repositories listed in the repository table displayed by the call to ppm repo.

Upgrade from an older version:

If you are upgrading from an older version, follow either of the installations described above replacing the command ppm install with ppm upgrade.

B. Developement versions (SVN)

This project's SourceForge SVN repository can be checked out through anonymous (pserver) SVN with the following instruction set. When prompted for a password for anonymous, simply press the Enter key.

svn co https://xsh.svn.sourceforge.net/svnroot/xsh/trunk/xsh xsh

You need to install all dependencies first (e.g. using CPAN). To build the latest version of XSH2 from SVN , run:

$ cd xsh
$ perl Makefile.PL
$ make svn
$ perl Makefile.PL PREFIX=/usr/local
$ make
$ make install

C. Old versions