XSH - XML Editing Shell

A. Latest release (2.1.0)
1. Linux, UNIX, BSD, MacOS X, etc.
2. Windows
B. Developement versions (CVS)
C. Older versions

A. Latest release (2.1.0)

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

RPM packages for Fedora Linux:
- Fedora Core 6 - kindly provided by Ville Skyttä
- Fedora Core 4 - kindly provided by Ismael Olea
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.
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

Please, follow the instructions for Linux if you wish to install XSH2 under Cygwin environment with Cygwin build of Perl.

For a native Windows installation you will need ActivePerl 5.8 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 such 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.

The installation procedure differs for ActivePerl builds <= 817 and ActivePerl build >= 818.

ActivePerl builds 817 and older

On-line installation:

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

ppm rep add xsh http://xsh.sourceforge.net/ppms/
ppm rep add kobes http://theoryx5.uwinnipeg.ca/ppms/
ppm install XML-XSH2
ppm rep del xsh
ppm rep del kobes

Off-line installation:

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

Open the command prompt (Press Win+R and type cmd) and type the following commands:
```
ppm rep add temp c:\install
ppm install XML-XSH2.ppd
ppm rep del temp
```
(change c:\install accordingly)
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 --install.

ActivePerl builds 818 and newer

Note: ActivePerl builds 818 and 819 have issues with the new PPM4 package manager which are supposed to be addressed in build 820. If you encounter any problems, please, downgrade to build 817. If the ppm command complains about connecting to a database and your user-name or profile folder contains non-ASCII characters, try this work-around (change c:\perl\temp below to fit your needs)

mkdir c:\perl\temp
set ACTIVEPERL_PPM_HOME=c:\perl\temp

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. Latest CVS version

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

cvs -d:pserver:anonymous@xsh.cvs.sourceforge.net:/cvsroot/xsh login
cvs -d:pserver:anonymous@xsh.cvs.sourceforge.net:/cvsroot/xsh -z3 co -P xsh

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

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

C. Old versions

Older XSH releases can be downloaded from SourceForge Project Page.