+++ /dev/null
-$Id: INSTALL 6145 2006-08-06 13:13:03Z xmldoc $\r
-\r
-INSTALL file for the DocBook XSL stylesheets distribution\r
-\r
-----------------------------------------------------------------------\r
-Case #1: Installation using a package management system\r
-----------------------------------------------------------------------\r
-If you have installed the DocBook XSL distribution using "apt-get",\r
-"yum", "urpmi", or some similar package-management front-end,\r
-then, as part of the package installation, the stylesheets have\r
-already been automatically installed in the appropriate location\r
-for your system, and your XML catalog environment has probably\r
-been updated to use that location.\r
-\r
-----------------------------------------------------------------------\r
-Case #2: Installing manually\r
-----------------------------------------------------------------------\r
-If you have downloaded a docbook-xsl zip, tar.gz, or tar.bz2\r
-file, use the following steps to install it.\r
-\r
- 1. Move the zip, tar.gz, or tar.bz2 file to the directory where\r
- you'd like to install it (not to a temporary directory).\r
-\r
- 2. unzip or untar/uncompress the file\r
-\r
- That will create a docbook-xsl-$VERSION directory (where\r
- $VERSION is the version number for the release).\r
-\r
-The remaining steps are all OPTIONAL. They are intended to\r
-automatically update your user environment with XML Catalog\r
-information about the DocBook XSL distribution. You are NOT\r
-REQUIRED to complete these remaining steps. However, if you do\r
-not, and you want to use XML catalogs with the DocBook XSL\r
-stylesheets, you will need to manually update your XML catalog\r
-environment\r
-\r
- 3. Change to the docbook-xsl-$VERSION directory and execute the\r
- install.sh script:\r
-\r
- ./install.sh\r
-\r
- That will launch an interactive installer, which will emit a\r
- series of prompts for you to respond to.\r
-\r
- To instead run it non-interactively without being prompted\r
- for confirmation of the changes it makes, invoke it with the\r
- "--batch" switch, like this:\r
-\r
- ./install.sh --batch\r
-\r
- After the process is complete, the installer will emit a\r
- message with a command you need to run in order to source\r
- your environment for use with the stylesheets.\r
-\r
- 4. To test that he installation has updated your environment\r
- correctly, execute the test.sh script:\r
-\r
- ./test.sh\r
-\r
- That will test your XML catalog environment, using both the\r
- xmlcatalog application and the Apache XML Commons Resolver.\r
-\r
- NOTE: The test.sh file is not created until the install.sh\r
- file is run for the first time.\r
-\r
- 5. (UNINSTALLING) If/when you want to uninstall the release,\r
- execute the uninstall.sh script.\r
-\r
- ./uninstall.sh\r
-\r
- To instead run it non-interactively without being prompted\r
- for confirmation of the changes it makes, invoke it with the\r
- "--batch" switch, like this:\r
-\r
- ./uninstall.sh --batch\r
-\r
- NOTE: The uninstall.sh file is not created until the install.sh\r
- file is run for the first time.\r
-\r
-\r
-----------------------------------------------------------------------\r
-Note to packagers\r
-----------------------------------------------------------------------\r
-The install.sh, .CatalogManager.properties.example, and .urilist\r
-files should not be packaged. They are useful only to users who\r
-are installing the stylesheets manually.\r
-\r
-The catalog.xml file should be packaged.\r