DocBook formmating.
authorRobert Soulliere <rsoulliere@libdog.mohawkcollege.ca>
Wed, 3 Nov 2010 19:42:11 +0000 (15:42 -0400)
committerRobert Soulliere <rsoulliere@libdog.mohawkcollege.ca>
Wed, 3 Nov 2010 19:42:11 +0000 (15:42 -0400)
Add some glassary definitions.

1.6/admin/staffclientinstallation.xml
1.6/appendices/glossary.xml

index 5df07af..05c46be 100644 (file)
                                        <para>The Staff Client data from the directory <filename class="directory">./staff_client/build</filename> must be placed somewhere on the machine \r
                                        (e.g. <filename class="directory">~/Desktop/Evergreen_Staff_Client</filename>). Remember to call XULRunner with the full path to the binary, followed by the \r
                                        install command and the path to the client data:</para>\r
-                                       <screen>\r
-                                       <userinput>/Library/Frameworks/XUL.framework/xulrunner-bin --install-app ~/Desktop/Evergreen_Staff_Client</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>/Library/Frameworks/XUL.framework/xulrunner-bin --install-app ~/Desktop/Evergreen_Staff_Client</userinput>\r
+</screen>\r
                                        <para>This command should exit quietly. The folder <filename class="directory">/Applications/OpenILS</filename> will be created, containing a launcher \r
                                        named <application>open_ils_staff_client</application>.</para>\r
                                </simplesect>\r
                                        <simplesect>\r
                                                <title>Flush Receiptdb file:</title>\r
                                                <para>First, get the package identifier, then purge/forget the build that was initially installed:</para>\r
-                                               <screen>\r
-                                               <userinput>sudo pkgutil --pkgs > /tmp/pkgs.txt</userinput>\r
-                                               <userinput>sudo pkgutil --forget org.mozilla.xulrunner</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>sudo pkgutil --pkgs > /tmp/pkgs.txt</userinput>\r
+<userinput>sudo pkgutil --forget org.mozilla.xulrunner</userinput>\r
+</screen>\r
                                                <note>It may not be necessary to edit the file <filename>/Library/Receipts/InstallHistory.plist</filename> after deleting the folder \r
                                                <filename class="directory">XUL.framework</filename>. \r
                                                See <ulink url="http://lists.apple.com/archives/Installer-dev/2009/Jul/msg00008.html">\r
                                            * MacOS\r
                                        </screen>\r
                                        <para>Create an APP folder structure with the following commands:</para>\r
-                                       <screen>\r
-                                       <userinput>mkdir -p Evergreen.app/Contents/Frameworks</userinput>\r
-                                       <userinput>mkdir -p Evergreen.app/Contents/Resources</userinput>\r
-                                       <userinput>mkdir -p Evergreen.app/Contents/MacOS</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>mkdir -p Evergreen.app/Contents/Frameworks</userinput>\r
+<userinput>mkdir -p Evergreen.app/Contents/Resources</userinput>\r
+<userinput>mkdir -p Evergreen.app/Contents/MacOS</userinput>\r
+</screen>\r
                                        <para/>\r
                                        <orderedlist>\r
                                                <listitem>\r
                                                        <para>Create a new file in the folder <filename class="directory">Evergreen.app/Contents/Info.plist</filename> containing the following data \r
                                                        (adjust for your version of Evergreen):</para>\r
-                                                       <programlisting language="xml"><![CDATA[\r
-                                                       <?xml version="1.0" encoding="UTF-8"?>\r
-                                                       <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\r
-                                                       <plist version="1.0">\r
-                                                       <dict>\r
-                                                              <key>CFBundleExecutable</key>\r
-                                                              <string>xulrunner</string>\r
-                                                              <key>CFBundleGetInfoString</key>\r
-                                                              <string>OpenILS open_ils_staff_client rel_1_6_0_7</string>\r
-                                                              <key>CFBundleInfoDictionaryVersion</key>\r
-                                                              <string>6.0</string>\r
-                                                              <key>CFBundleName</key>\r
-                                                              <string>Evergreen Staff Client</string>\r
-                                                              <key>CFBundlePackageType</key>\r
-                                                              <string>APPL</string>\r
-                                                              <key>CFBundleShortVersionString</key>\r
-                                                              <string>rel_1_6_0_7</string>\r
-                                                              <key>CFBundleVersion</key>\r
-                                                              <string>rel_1_6_0_7.rel_1_6_0_7</string>\r
-                                                              <key>NSAppleScriptEnabled</key>\r
-                                                              <true/>\r
-                                                              <key>CFBundleTypeIconFile</key>\r
-                                                              <string>Evergreen.icns</string>\r
-                                                       </dict>\r
-                                                       </plist>\r
-                                                       ]]></programlisting>\r
-                                                       \r
+<programlisting language="xml"><![CDATA[\r
+<?xml version="1.0" encoding="UTF-8"?>\r
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\r
+<plist version="1.0">\r
+<dict>\r
+       <key>CFBundleExecutable</key>\r
+       <string>xulrunner</string>\r
+       <key>CFBundleGetInfoString</key>\r
+       <string>OpenILS open_ils_staff_client rel_1_6_0_7</string>\r
+       <key>CFBundleInfoDictionaryVersion</key>\r
+       <string>6.0</string>\r
+       <key>CFBundleName</key>\r
+       <string>Evergreen Staff Client</string>\r
+       <key>CFBundlePackageType</key>\r
+       <string>APPL</string>\r
+       <key>CFBundleShortVersionString</key>\r
+       <string>rel_1_6_0_7</string>\r
+       <key>CFBundleVersion</key>\r
+       <string>rel_1_6_0_7.rel_1_6_0_7</string>\r
+       <key>NSAppleScriptEnabled</key>\r
+       <true/>\r
+       <key>CFBundleTypeIconFile</key>\r
+       <string>Evergreen.icns</string>\r
+</dict>\r
+</plist>\r
+]]></programlisting>                                           \r
                                                </listitem>\r
                                                <listitem>Download and install an appropriate Mac OS package of XULRunner from the Mozilla website (see above for recommendations).</listitem>\r
                                                <listitem>\r
                                                        <para>Make a copy of the folder <filename class="directory">/Library/Frameworks/XUL.Framework</filename> inside your APP file. It should \r
                                                        look something like this:</para>\r
-                                                       <screen>\r
-                                                               * Evergreen.app/\r
-                                                               __* Contents/\r
-                                                               ____* Frameworks/\r
-                                                               ______* XUL.Framework/\r
-                                                               ______* Versions/\r
-                                                               ________* Current -> 1.9.1.3 (symlink)\r
-                                                               ________* 1.9.1.3/\r
-                                                               ______* XUL -> Versions/Current/XUL\r
-                                                               ______* libxpcom.dylib -> Versions/Current/libxpcom.dylib\r
-                                                               ______* xulrunner-bin -> Versions/Current/xulrunner-bin\r
-                                                       </screen>\r
+<screen>\r
+* Evergreen.app/\r
+__* Contents/\r
+____* Frameworks/\r
+______* XUL.Framework/\r
+______* Versions/\r
+________* Current -> 1.9.1.3 (symlink)\r
+________* 1.9.1.3/\r
+______* XUL -> Versions/Current/XUL\r
+______* libxpcom.dylib -> Versions/Current/libxpcom.dylib\r
+______* xulrunner-bin -> Versions/Current/xulrunner-bin\r
+</screen>\r
                                                </listitem>\r
                                                <listitem>Copy <filename>XUL.Framework/Versions/Current/xulrunner</filename> into the folder <filename class="directory">Evergreen.app/MacOS</filename> \r
                                                (do not symlink; copy the file).</listitem>\r
                                                <listitem>\r
                                                        <para>Make <filename>Evergreen.app/Resources</filename> the root of your Evergreen application files like this:</para>\r
-                                                       <screen>\r
-                                                       * Evergreen.app/\r
-                                                       __* Contents/\r
-                                                       ____* Resources/\r
-                                                       ______* BUILD_ID\r
-                                                       ______* application.ini\r
-                                                       ______* chrome/\r
-                                                       ______* components/\r
-                                                       ______* etc.\r
-                                                       </screen>\r
+<screen>\r
+* Evergreen.app/\r
+__* Contents/\r
+____* Resources/\r
+______* BUILD_ID\r
+______* application.ini\r
+______* chrome/\r
+______* components/\r
+______* etc.\r
+</screen>\r
                                                </listitem>\r
                                                <listitem>Put a Mac format icon file named <filename>Evergreen.icns</filename> in <filename class="resources">Resources</filename>.</listitem>\r
                                        </orderedlist>\r
                                        in the following example.</para>\r
                                        <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then recursively copy the \r
                                        entire directory tree to the remote workstation:</para>\r
-                                       <screen>\r
-                                       <userinput>su - opensrf</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                       <userinput>scp -r build user@client.linux.machine:~/eg-client-x.x.x.x/</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>scp -r build user@client.linux.machine:~/eg-client-x.x.x.x/</userinput>\r
+</screen>\r
                                        <para>To test the newly copied Staff Client, as the <systemitem class="username">opensrf</systemitem> user log into the remote workstation and execute it as \r
                                        shown:</para>\r
-                                       <screen>\r
-                                       <userinput>su - opensrf</userinput>\r
-                                       <userinput>xulrunner ~/eg-client-x.x.x.x/build/application.ini</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>xulrunner ~/eg-client-x.x.x.x/build/application.ini</userinput>\r
+</screen>\r
                                </simplesect>\r
                                <simplesect>\r
                                        <title>Building the Staff Client on the Server</title>\r
                                        <para>A Linux Staff Client is automatically built on the server as part of the normal <emphasis>make install</emphasis> process for Evergreen server-side \r
                                        software, using a procedure similar to this:</para>\r
-                                       <screen>\r
-                                       <userinput>cd ~/ILS/Open-ILS/xul/staff_client</userinput>\r
-                                       <userinput>make STAFF_CLIENT_BUILD_ID='12345'</userinput>\r
-                                       <userinput>mkdir /openils/var/web/xul/</userinput>\r
-                                       <userinput>mkdir /openils/var/web/xul/12345/</userinput>\r
-                                       <userinput>cd build/</userinput>\r
-                                       <userinput>cp -R server/ /openils/var/web/xul/12345/</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>cd ~/ILS/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make STAFF_CLIENT_BUILD_ID='12345'</userinput>\r
+<userinput>mkdir /openils/var/web/xul/</userinput>\r
+<userinput>mkdir /openils/var/web/xul/12345/</userinput>\r
+<userinput>cd build/</userinput>\r
+<userinput>cp -R server/ /openils/var/web/xul/12345/</userinput>\r
+</screen>\r
                                        <para>The Staff Client can be run from the build directory using this command:</para>\r
-                                       <screen>\r
-                                       <userinput>su - opensrf</userinput>\r
-                                       <userinput>xulrunner application.ini</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>xulrunner application.ini</userinput>\r
+</screen>\r
                                        <para>In order to install a compatible Staff Client on another Linux system, just copy the applicable files from the server to that system, or even manually \r
                                        build it on that system. Ensure that the BUILD_ID you choose on the server matches the BUILD_ID for each Staff Client you use on other systems.</para>\r
                                        <para>If you will be using a pre-packaged Windows version on some systems, you may want to choose the BUILD_ID on both server and other versions to match that \r
                                        <para>If you are allowed to make changes on the Evergreen server, another option is to create a symbolic link. In order for a copy of the Staff Client and server \r
                                        to work together, the BUILD_ID must match the name of the directory containing the server components of the Staff Client, or the name of a symbolic link to \r
                                        that directory.</para>\r
-                                       <screen>\r
-                                       <userinput>su - root</userinput>\r
-                                       <userinput>cd /openils/var/web/xul</userinput>\r
-                                       <userinput>ln -s SERVER_BUILD_ID/ CLIENT_BUILD_ID</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - root</userinput>\r
+<userinput>cd /openils/var/web/xul</userinput>\r
+<userinput>ln -s SERVER_BUILD_ID/ CLIENT_BUILD_ID</userinput>\r
+</screen>\r
                                </simplesect>\r
                                <simplesect>\r
                                        <title>Building the Staff Client on the client Machine</title>\r
                                                        <application>subversion</application> and <application>xulrunner</application>. You can also use <command>synaptic</command>, the graphical \r
                                                        user interface for <command>apt-get</command>. For <application>subversion</application>, select the latest version; for \r
                                                        <application>xulrunner</application>, select version <emphasis>1.8.1.4-2ubuntu5</emphasis>.</para>\r
-                                                       <screen>\r
-                                                       <userinput>sudo apt-get install subversion</userinput>\r
-                                                       <userinput>sudo apt-get install xulrunner</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>sudo apt-get install subversion</userinput>\r
+<userinput>sudo apt-get install xulrunner</userinput>\r
+</screen>\r
                                                </step>\r
                                                <step>\r
                                                        <para>Download the Source Code</para>\r
                                                                        <para>As the <systemitem class="username">opensrf</systemitem> user, open a terminal (command-line prompt) and navigate \r
                                                                        to the directory in which you wish to download the Staff Client. Use the following commands to download the proper version of\r
                                                                        the source code by tag name:</para>\r
-                                                                       <screen>\r
-                                                                       <userinput>su - opensrf</userinput>\r
-                                                                       <userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
-                                                                       <userinput>svn co rel_1_2_1_4/</userinput>\r
-                                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
+<userinput>svn co rel_1_2_1_4/</userinput>\r
+</screen>\r
                                                                        <para>Remember to change "rel_1_6_1_2" to the appropriate tag for your installation.</para>\r
                                                                </listitem>\r
                                                        </itemizedlist>\r
                                                                        determine whether or not a connecting client is supported. For instance, for the PINES installation (version 1.2.1.4) the \r
                                                                        supported BUILD_ID is "rel_1_2_1_4". Modify the following commands accordingly.</para>\r
                                                                        <para>As the <systemitem class="username">opensrf</systemitem> user, run the following commands to build the Staff Client:</para>\r
-                                                                       <screen>\r
-                                                                       <userinput>su - opensrf</userinput>\r
-                                                                       <userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
-                                                                       <userinput>cd Open-ILS/xul/staff_client</userinput>\r
-                                                                       <userinput>make STAFF_CLIENT_BUILD_ID='rel_1_6_1_2'</userinput>\r
-                                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
+<userinput>cd Open-ILS/xul/staff_client</userinput>\r
+<userinput>make STAFF_CLIENT_BUILD_ID='rel_1_6_1_2'</userinput>\r
+</screen>\r
                                                                </listitem>\r
                                                        </itemizedlist>\r
                                                </step>\r
                                                        <para>Run the Staff Client (from the command line)</para>\r
                                                        <para>As the <systemitem class="username">opensrf</systemitem> user, navigate to the <filename class="directory">build/</filename> subdirectory \r
                                                        (not <filename class="directory">staff_client/</filename>) and run the following command:</para>\r
-                                                       <screen>\r
-                                                       <userinput>su - opensrf</userinput>\r
-                                                       <userinput>xulrunner application.ini</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>xulrunner application.ini</userinput>\r
+</screen>\r
                                                </step>\r
                                                <step>\r
                                                        <para>Cleaning Up / Creating Shortcuts</para>\r
                                                        to remove them to save space, or to create a clean directory containing the built Staff Client that can be copied to other machines. As \r
                                                        the <systemitem class="username">opensrf</systemitem> user, issue the following commands to create a clean "staging" directory in which to place \r
                                                        the finished Staff Client, and to copy into it the "staff_client" directory:</para>\r
-                                                       <screen>\r
-                                                       <userinput>su - opensrf</userinput>\r
-                                                       <userinput>mkdir ~/&lt;Destination Directory&gt;</userinput>\r
-                                                       <userinput>cd ~/&lt;Download Directory>/Open-ILS/xul/</userinput>\r
-                                                       <userinput>cp -r staff_client ~/&lt;Destination Directory&gt;</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>mkdir ~/&lt;Destination Directory&gt;</userinput>\r
+<userinput>cd ~/&lt;Download Directory>/Open-ILS/xul/</userinput>\r
+<userinput>cp -r staff_client ~/&lt;Destination Directory&gt;</userinput>\r
+</screen>\r
                                                        <para>Finally, test the Staff Client to verify that all the necessary files were moved to the destination directory:</para>\r
-                                                       <screen>\r
-                                                       <userinput>cd ~/&lt;Destination Directory>/staff_client/build</userinput>\r
-                                                       <userinput>xulrunner application.ini</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>cd ~/&lt;Destination Directory>/staff_client/build</userinput>\r
+<userinput>xulrunner application.ini</userinput>\r
+</screen>\r
                                                        <para>If there were no problems, then finish the cleanup by removing the original download directory and all subdirectories:</para>\r
-                                                       <screen>\r
-                                                       <userinput>rm -r -f ~/&lt;Download Directory&gt;</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>rm -r -f ~/&lt;Download Directory&gt;</userinput>\r
+</screen>\r
                                                        <para>You may wish to create <menuchoice><guimenu>Desktop</guimenu><guimenuitem>Start Menu</guimenuitem><guimenuitem>K-Menu</guimenuitem>\r
                                                        </menuchoice> shortcuts for the Staff Client using the command <command>xulrunner ~/&lt;Destination Directory>/staff_client/build/application.ini\r
                                                        </command> as the target.</para>\r
                                        <orderedlist>\r
                                                <listitem>\r
                                                        <para>Install wine</para>\r
-                                                       <screen>\r
-                                                       <userinput>sudo apt-get install wine</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>sudo apt-get install wine</userinput>\r
+</screen>\r
                                                </listitem>\r
                                                <listitem>\r
                                                        <para>Download Windows installer for the Staff Client</para>\r
                                                        <para>As the <systemitem class="username">opensrf</systemitem> user, run the following commands to download the Windows installer for the \r
                                                        proper Staff Client from the <ulink url="http://open-ils.org">open-ils.org</ulink> website and place it in a temporary directory:</para>\r
-                                                       <screen>\r
-                                                       <userinput>su - opensrf</userinput>\r
-                                                       <userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
-                                                       <userinput>wget http://open-ils.org/downloads/evergreen-setup-rel_version-number.exe</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
+<userinput>wget http://open-ils.org/downloads/evergreen-setup-rel_version-number.exe</userinput>\r
+</screen>\r
                                                </listitem>\r
                                                <listitem>\r
                                                        <para>Run the downloaded Windows installer</para>\r
                                                        <para>As the <systemitem class="username">opensrf</systemitem> user, navigate to the directory where you downloaded the Windows executable \r
                                                        file, then execute it:</para>\r
-                                                       <screen>\r
-                                                       <userinput>su - opensrf</userinput>\r
-                                                       <userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
-                                                       <userinput>wine evergreen-setup-rel_version-number.exe</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /YOUR/DOWNLOAD/DIRECTORY</userinput>\r
+<userinput>wine evergreen-setup-rel_version-number.exe</userinput>\r
+</screen>\r
                                                        <para>If this step fails, you may need to configure Wine first to properly emulate Windows XP. To do so, type "winecfg" from the command line; \r
                                                        in the "Applications" tab of the window that pops up, select "Default Settings" and choose "Windows XP" from the drop-down menu, then \r
                                                        click <guibutton>Apply</guibutton>.</para>\r
                                        <para>During the normal <emphasis>make install</emphasis> Evergreen server-side software build process, the variable defaults to an automatically generated \r
                                        date/time string, but you can also override the value of BUILD_ID.</para>\r
                                        <para>The following commands could be used during the normal build process:</para>\r
-                                       <screen>\r
-                                       <userinput>su - root</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
-                                       <userinput>make STAFF_CLIENT_BUILD_ID=[version ID] install</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - root</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
+<userinput>make STAFF_CLIENT_BUILD_ID=[version ID] install</userinput>\r
+</screen>\r
                                        <para>The following commands will manually build the Staff Client using a different BUILD_ID.</para>\r
                                        <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then set the variable and build \r
                                        the Staff Client:</para>                        \r
-                                       <screen>\r
-                                       <userinput>su - opensrf</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                       <userinput>make STAFF_CLIENT_BUILD_ID=my_test_id  build</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make STAFF_CLIENT_BUILD_ID=my_test_id  build</userinput>\r
+</screen>\r
                        </simplesect>\r
                        <simplesect>\r
                                        <title>Option STAFF_CLIENT_VERSION</title>\r
                                        in the Evergreen source root. The variable defaults to <emphasis>0trunk.revision</emphasis>, where the value of "revision" is automatically generated. You \r
                                        can override the value of VERSION similarly to the BUILD_ID.</para>\r
                                        <para>The following commands could be used during the normal build process:</para>\r
-                                       <screen>\r
-                                       <userinput>su - root</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
-                                       <userinput>make STAFF_CLIENT_VERSION=0mytest.200 install</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - root</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
+<userinput>make STAFF_CLIENT_VERSION=0mytest.200 install</userinput>\r
+</screen>\r
                                        <para>The following commands will manually build the Staff Client using a different VERSION.</para>\r
                                        <para>If you plan to make extensions update automatically, the VERSION needs to conform to the format recommended in \r
                                        <ulink url="https://developer.mozilla.org/en/Toolkit_version_format">Toolkit Version Format</ulink> and newer versions need to be "higher" than older \r
                                        versions.</para>\r
                                        <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then set the variable and build \r
                                        the Staff Client:</para>\r
-                                       <screen>\r
-                                       <userinput>su - opensrf</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                       <userinput>make STAFF_CLIENT_VERSION=0mytest.200  build</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make STAFF_CLIENT_VERSION=0mytest.200  build</userinput>\r
+</screen>\r
                                </simplesect>\r
                                <simplesect>\r
                                        <title>Option STAFF_CLIENT_STAMP_ID variable</title>\r
                                        <para>During the normal <emphasis>make install</emphasis> Evergreen server-side software build process, this variable is generated from STAFF_CLIENT_VERSION. \r
                                                You can override the value of STAMP_ID similarly to the BUILD_ID.</para>\r
                                        <para>The following commands could be used during the normal build process:</para>\r
-                                       <screen>\r
-                                       <userinput>su - root</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
-                                       <userinput>make STAFF_CLIENT_STAMP_ID=my_test_stamp install</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - root</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
+<userinput>make STAFF_CLIENT_STAMP_ID=my_test_stamp install</userinput>\r
+</screen>\r
                                        <para>The following commands will manually build the Staff Client using a different STAMP_ID.</para>\r
                                        <para>It is possible to have multiple versions of the Staff Client by specifying a different STAMP_ID for each, possibly for different uses or \r
                                        client-side customizations.</para>\r
                                        <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then set the variable and build \r
                                        the Staff Client:</para>\r
-                                       <screen>\r
-                                       <userinput>su - opensrf</userinput>\r
-                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                       <userinput>make STAFF_CLIENT_STAMP_ID=my_test_stamp  build</userinput>\r
-                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make STAFF_CLIENT_STAMP_ID=my_test_stamp  build</userinput>\r
+</screen>\r
                                </simplesect>\r
                        </simplesect>\r
                        <simplesect>\r
                                                <para>You can create a so-called "developer build" of the Staff Client by substituting "devbuild" for "build" when running <command>make</command>. \r
                                                The build will contain an extra configuration file that enables some developer options.</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, run <command>make</command> from the Staff Client source directory:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make devbuild</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make devbuild</userinput>\r
+</screen>\r
                                        </listitem>\r
                                        <listitem>\r
                                                <para>Compressed Javascript</para>\r
                                                by substituting <option>compress-javascript</option> for "build" when running <command>make</command>. For more information see \r
                                                <ulink url="http://code.google.com/closure/compiler/">Google Closure Compiler</ulink>.</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, run the following commands from the Staff Client source directory:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make compress-javascript</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make compress-javascript</userinput>\r
+</screen>\r
                                                <para>You can also combine Javascript review and compression, and also perform a "developer build".</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, run the following commands from the Staff Client source directory:</para>\r
                                                <note><para>In the following <command>make</command> below, the order of options is important!</para></note>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make  devbuild  compress-javascript</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make  devbuild  compress-javascript</userinput>\r
+</screen>\r
                                        </listitem>\r
                                        <listitem>\r
                                                <para>Automatic Update Host</para>\r
                                                <para>The host used to check for automatic Staff Client updates can be overridden by specifying the <option>AUTOUPDATE_HOST</option> option. The \r
                                                following commands could have been used during the normal build process:</para>\r
-                                               <screen>\r
-                                               <userinput>su - root</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
-                                               <userinput>make AUTOUPDATE_HOST=localhost install</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - root</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
+<userinput>make AUTOUPDATE_HOST=localhost install</userinput>\r
+</screen>\r
                                                <para>You can manually set <option>AUTOUPDATE_HOST</option> to set up automatic update checking. The following commands will manually build the Staff \r
                                                Client using a different <option>AUTOUPDATE_HOST</option>.</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then set the variable and \r
                                                build the Staff Client:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make AUTOUPDATE_HOST=localhost build</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make AUTOUPDATE_HOST=localhost build</userinput>\r
+</screen>\r
                                                <para>For more information on Automatic Updates, see <xref linkend="staffclientinstallation-autoupdate"/>.</para>\r
                                        </listitem>\r
                                </itemizedlist>\r
                                option of installing the Staff Client on the same machine it was built on, or on a different machine.</para>\r
                                <para>Assuming you have already built the Staff Client, and that your installation is in the directory <filename class="directory">/openils/var/web/xul</filename>, as \r
                                the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then execute the following commands:</para>\r
-                               <screen>\r
-                               <userinput>su - opensrf</userinput>\r
-                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                               <userinput>mkdir -p "/openils/var/web/xul/$(cat build/BUILD_ID)"</userinput>\r
-                               <userinput>cp -R build/server "/openils/var/web/xul/$(cat build/BUILD_ID)"</userinput>\r
-                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>mkdir -p "/openils/var/web/xul/$(cat build/BUILD_ID)"</userinput>\r
+<userinput>cp -R build/server "/openils/var/web/xul/$(cat build/BUILD_ID)"</userinput>\r
+</screen>\r
                        </simplesect>\r
                        <simplesect>\r
                                <title>Packaging the Staff Client</title>\r
                                                suitable for use with the <application>xulrunner</application> parameter <option>--install-app</option>>.</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then execute the \r
                                                following commands:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make generic-client</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make generic-client</userinput>\r
+</screen>\r
                                        </listitem>\r
                                        <listitem>\r
                                                <para>Packaging a Windows Client</para>\r
                                                </table>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then execute the \r
                                                following commands:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make win-client</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make win-client</userinput>\r
+</screen>\r
                                        </listitem>\r
                                        <listitem>\r
                                                <para>Packaging a Linux Client</para>\r
                                                creates the output file "evergreen_staff_client.tar.bz2".</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then execute the \r
                                                following commands:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make linux-client</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make linux-client</userinput>\r
+</screen>\r
                                        </listitem>\r
                                        <listitem>\r
                                                <para>Packaging a Firefox Extension</para>\r
                                                as a Firefox extension and creates the output file <filename>evergreen.xpi</filename>.</para>\r
                                                <para>As the <systemitem class="username">opensrf</systemitem> user, change directory to the Staff Client source directory, then execute the \r
                                                following commands:</para>\r
-                                               <screen>\r
-                                               <userinput>su - opensrf</userinput>\r
-                                               <userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
-                                               <userinput>make extension</userinput>\r
-                                               </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]/Open-ILS/xul/staff_client</userinput>\r
+<userinput>make extension</userinput>\r
+</screen>\r
                                        </listitem>\r
                                </itemizedlist>\r
                        </simplesect>\r
                                                        <para>At configuration time for the normal build of Evergreen server-side software</para>\r
                                                        <para>This must be done when the Evergreen server-side software is first configured (see <xref linkend="serversideinstallation-configure"/>). As \r
                                                        the <systemitem class="username">opensrf</systemitem> user, use the utility "configure" as shown:</para>\r
-                                                       <screen>\r
-                                                       <userinput>su - opensrf</userinput>\r
-                                                       <userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
-                                                       <userinput>./configure --prefix=/openils --sysconfdir=/openils/conf --with-updateshost=hostname</userinput>\r
-                                                       <userinput>make</userinput>\r
-                                                       </screen>\r
+<screen>\r
+<userinput>su - opensrf</userinput>\r
+<userinput>cd /home/opensrf/[Evergreen Install Directory]</userinput>\r
+<userinput>./configure --prefix=/openils --sysconfdir=/openils/conf --with-updateshost=hostname</userinput>\r
+<userinput>make</userinput>\r
+</screen>\r
                                                </listitem>\r
                                                <listitem>\r
                                                        <para>During a manual Staff Client build process</para>\r
index 22077d6..d832a1a 100644 (file)
-<?xml version="1.0" encoding="UTF-8"?>
-<glossary xml:id="Glossary" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">
-       <title>Glossary</title>
-       <abstract>
-               <para>In this section we expand acronyms, define terms, and generally try to explain concepts used by Evergreen software.</para>
-       </abstract>
-       <glossdiv>
-               <title>A</title>
-               <glossentry id="Apache">
-                       <glossterm>Apache</glossterm>
-                       <glossdef>
-                               <para>Open-source web server software used to serve both static content and dynamic web pages in a secure and reliable way. More information is available at <ulink url="http://apache.org">apache.org</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>B</title>
-               <glossentry id="Book Bags">
-                       <glossterm>Book Bags</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>C</title>
-               <glossentry id="closure">
-                       <glossterm>Closure Compiler</glossterm>
-                       <glossdef>
-                               <para>A suite of open-source tools used to build web applications with <application>Javascript</application>; originally developed by Google. More information is available at <ulink url="http://code.google.com/closure/compiler/">http://code.google.com/closure/compiler/</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="CPAN">
-                       <glossterm>CPAN</glossterm>
-                       <glossdef>
-                               <para>An open-source archive of software modules written in <application>Perl</application>. More information is available at <ulink url="http://www.cpan.org">www.cpan.org</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>D</title>
-               <glossentry id="Debian">
-                       <glossterm>Debian</glossterm>
-                       <glossdef>
-                               <para>One of the most popular open-source operating system using the <systemitem class="osname">Linux</systemitem> kernel that provides over 25000 useful precompiled software packages. Also known as <systemitem class="osname">Debian GNU/Linux</systemitem>. More information is available at <ulink url="http://www.debian.org">www.debian.org</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry>
-                       <glossterm>Domain name</glossterm>
-                       <glossdef>
-                               <para>A unique set of case-insensitive, alphanumeric strings separated by periods that are used to name organizations, web sites and addresses on the Internet (e.g.: <uri>www.esilibrary.com</uri>). Domain names can be reserved via third-party registration services, and can be associated with a unique IP address or suite of IP addresses.</para>
-                               <glossseealso otherterm="ipaddress"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>E</title>
-               <glossentry id="ejabberd">
-                       <glossterm>ejabberd</glossterm>
-                       <glossdef>
-                               <para>An open-source Jabber/XMPP instant messaging server that runs under popular operating systems (e.g., <systemitem class="osname">Mac OSX</systemitem>, <systemitem class="osname">GNU/Linux</systemitem>, and <systemitem class="osname">Microsoft Windows</systemitem>). One popular use is to provide <application>XMPP</application> messaging services for a <application>Jabber</application> domain across an extendable cluster of cheap, easily-replaced machine nodes. More information is available at <ulink url="http://www.ejabberd.im/">http://www.ejabberd.im</ulink>.</para>
-                               <glossseealso otherterm="Jabber"/>
-                               <glossseealso otherterm="XMPP"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>F</title>
-               <glossentry></glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>G</title>
-               <glossentry></glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>H</title>
-               <glossentry></glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>I</title>
-               <glossentry id="ipaddress">
-                       <glossterm>IP Address</glossterm>
-                       <glossdef>
-                               <para>(Internet Protocol address) A numerical label consisting of four numbers separated by periods (e.g., "192.168.1.15") assigned to individual members of networked computing systems. It uniquely identifies each system on the network and allows controlled communication between such systems. The numerical label scheme must adhere to a strictly defined naming convention that is currently defined and overseen by the Internet Corporation for Assigned Names and Numbers ("ICANN").</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="Item Buckets">
-                       <glossterm>Item Buckets</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>J</title>
-               <glossentry id="Jabber">
-                       <glossterm>Jabber</glossterm>
-                       <glossdef>
-                               <para>Now known as XMPP (eXtensible Messaging and Presence Protocol), it was originally named "Jabber".</para>
-                               <glossseealso otherterm="XMPP"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>K</title>
-               <glossentry></glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>L</title>
-               <glossentry></glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>M</title>
-               <glossentry id="MARC">
-                       <glossterm>MARC</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="MARCXML">
-                       <glossterm>MARCXML</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="McCoy">
-                       <glossterm>McCoy</glossterm>
-                       <glossdef>
-                               <para>An open-source application that allows add-on authors to provide secure updates to their users. More information is available at <ulink url="https://developer.mozilla.org/en/McCoy">developer.mozilla.org/en/McCoy</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="memcached">
-                       <glossterm>memcached</glossterm>
-                       <glossdef>
-                               <para>A general-purpose distributed memory caching system, usually with a client~server architecture spread over multiple computing systems. It reduces the number of times a data source (e.g., a database) must be directly accessed by temporarily caching data in memory, therefore dramatically speeding up database-driven web applications.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>N</title>
-               <glossentry id="netaddr">
-                       <glossterm>Network address</glossterm>
-                       <glossdef>
-                               <para>Also known as an IP address (Internet Protocol address).</para>
-                               <glossseealso otherterm="ipaddress"/>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="nsis">
-                       <glossterm>nsis</glossterm>
-                       <glossdef>
-                               <para>An open-source software tool used to create Windows installers. More information is available at <ulink url="http://nsis.sourceforge.net">http://nsis.sourceforge.net</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>O</title>
-               <glossentry id="OPAC">
-                       <glossterm>OPAC</glossterm>
-                       <glossdef>
-                               <para>The "Online Public Access Catalog"; an online database of a library's holdings; used to find resources in their collections; possibly searchable by keyword, title, author, subject or call number.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="OpenSRF">
-                       <glossterm>OpenSRF</glossterm>
-                       <glossdef>
-                               <para>The "Open Scalable Request Framework" (pronounced 'open surf') is a stateful, decentralized service architecture that allows developers to create applications for Evergreen with a minimum of knowledge of its structure.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>P</title>
-               <glossentry id="PostgreSQL">
-                       <glossterm>PostgreSQL</glossterm>
-                       <glossdef>
-                               <para>A popular open-source object-relational database management system that underpins Evergreen software.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="putty">
-                       <glossterm>Putty</glossterm>
-                       <glossdef>
-                               <para>A popular open-source telnet/ssh client for the Windows and Unix platforms. More information is available at <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/putty/">http://www.chiark.greenend.org.uk/~sgtatham/putty/</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>Q</title>
-               <glossentry></glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>R</title>
-               <glossentry id="Resource Hacker">
-                       <glossterm>Resource Hacker</glossterm>
-                       <glossdef>
-                               <para>An open-source utility used to view, modify, rename, add, delete and extract resources in 32bit Windows executables</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>S</title>
-               <glossentry id="SIP2">
-                       <glossterm>SIP2</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="srfsh">
-                       <glossterm>srfsh</glossterm>
-                       <glossdef>
-                               <para>A command language interpreter (shell) that executes commands read from the standard input. It is used to test the Open Service Request Framework (OpenSRF).</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="SRU">
-                       <glossterm>SRU</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="ssh">
-                       <glossterm>SSH</glossterm>
-                       <glossdef>
-                               <para>An encrypted network protocol using public-key cryptography that allows secure communications between systems on an insecure network. Typically used to access shell accounts but also supports tunneling, forwarding TCP ports and X11 connections, and transferring files.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="sshproxy">
-                       <glossterm>SSH proxy</glossterm>
-                       <glossdef>
-                               <para> As used in Evergreen, a method of allowing one or more Staff Clients to communicate with one or more Evergreen servers over an insecure network by sending data through a secure SSH tunnel. It also buffers and caches all data travelling to and from Staff Clients to speed up access to resources on Evergreen servers.</para>
-                               <glossseealso otherterm="ssh"/>
-                               <glossseealso otherterm="tunneling"/>
-                               <glossseealso otherterm="sshtunnel"/>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="sshtunnel">
-                       <glossterm>SSH tunnel</glossterm>
-                       <glossdef>
-                               <para>An encrypted data channel existing over an SSH network connection. Used to securely transfer unencrypted data streams over insecure networks.</para>
-                               <glossseealso otherterm="ssh"/>
-                               <glossseealso otherterm="tunneling"/>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="SSL Certificate">
-                       <glossterm>SSL Certificate</glossterm>
-                       <glossdef>
-                               <para>A special electronic document used to guarantee authenticity of a digital message. Also known as a "public key", or "identity" or "digital" certificate. It combines an identity (of a person or an organization) and a unique public key to form a so-called digital signature, and is used to verify that the public key does, in fact, belong with that particular identity.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>T</title>
-               <glossentry id="tunneling">
-                       <glossterm>tunneling</glossterm>
-                       <glossdef>
-                               <para>A method of encapsulating data provided in one network protocol (the "delivery" protocol), within data in a different network protocol (the "tunneling" protocol). Used to provide a secure path and secure communications through an insecure or incompatible network. Can be used to bypass firewalls by communicating via a protocol the firewall normally blocks, but "wrapped" inside a protocol that the firewall does not block.</para>
-                               <glossseealso otherterm="sshtunnel"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>U</title>
-               <glossentry id="Ubuntu">
-                       <glossterm>Ubuntu</glossterm>
-                       <glossdef>
-                               <para>A popular open-source operating system using the <systemitem class="osname">Linux</systemitem> kernel that was originally based on the <systemitem class="osname">Debian GNU/Linux</systemitem> operating system. More information is available at <ulink url="http://www.ubuntu.com">www.ubuntu.com</ulink>.</para>
-                               <glossseealso otherterm="Debian"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>V</title>
-               <glossentry id="virtualization">
-                       <glossterm>Virtualization</glossterm>
-                       <glossdef>
-                               <para>A method of executing software in a special environment that is partitioned or separated from the real underlying hardware and software resources. In typical usage, it allows a "host" operating system to encapsulate or emulate another operating system environment in such a way that the emulated environment is completely unaware of the hosting environment. For instance, it allows a <systemitem class="osname">Linux</systemitem> application to execute within a <systemitem class="osname">Windows</systemitem> environment.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="virtualbox">
-                       <glossterm>VirtualBox</glossterm>
-                       <glossdef>
-                               <para>A popular commercial package of virtualization software that emulates the x86 microprocessor architecture. It can be installed on  <systemitem class="osname">Linux</systemitem>, <systemitem class="osname">Mac OS X</systemitem>, <systemitem class="osname">Windows</systemitem> or <systemitem class="osname">Solaris</systemitem> "host" operating systems and allows other "guest" (typically including <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Windows</systemitem>) operating systems to be loaded and executed.</para>
-                               <glossseealso otherterm="virtualization"/>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="virtualpc">
-                       <glossterm>Virtual PC</glossterm>
-                       <glossdef>
-                               <para>A popular commercial package of virtualization software that emulates the x86 microprocessor architecture. It is installed on a Windows "host" operating system and allows other "guest" (typically including <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Windows</systemitem>) operating systems to be loaded and executed.</para>
-                               <glossseealso otherterm="virtualization"/>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="Volume Buckets">
-                       <glossterm>Volume Buckets</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="vmware">
-                       <glossterm>VMware</glossterm>
-                       <glossdef>
-                               <para>A popular commercial package of virtualization software that emulates the x86 microprocessor architecture. It can be installed on <systemitem class="osname">Linux</systemitem>, <systemitem class="osname">Mac OS X</systemitem>, <systemitem class="osname">Windows</systemitem> or <systemitem class="osname">Solaris</systemitem> "host" operating systems and allows other "guest" (typically including <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Windows</systemitem>) operating systems to be loaded and executed.</para>
-                               <glossseealso otherterm="virtualization"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>W</title>
-               <glossentry id="wine">
-                       <glossterm>Wine</glossterm>
-                       <glossdef>
-                               <para>A popular open-source application that allows <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Unix</systemitem> systems to run <systemitem class="osname">Windows</systemitem> executables. More information is available at <ulink url="http://www.winehq.org/">http://www.winehq.org/</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>X</title>
-               <glossentry id="xml">
-                       <glossterm>XML</glossterm>
-                       <glossdef>
-                               <para>The eXtensible Markup Language, a subset of SGML; a set of rules for encoding information in a way that is both human- and machine-readable. It is primarily used to define documents but can also be used to define arbitrary data structures. It was originally defined by the World Wide Web Consortium (W3C).</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="XMPP">
-                       <glossterm>XMPP</glossterm>
-                       <glossdef>
-                               <para>An open-standard communications protocol, based on XML, used in message-oriented middleware. It supports the concept of a consistent "domain" of message types that flow between software applications, possibly on different operating systems and architectures. More information is available at <ulink url="http://xmpp.org">xmpp.org</ulink>.</para>
-                               <glossseealso otherterm="Jabber"/>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="xpath">
-                       <glossterm>xpath</glossterm>
-                       <glossdef>
-                               <para>The XML Path Language, a query language based on a tree representation of an XML document. It is used to programmatically select nodes from an XML document and to do minor computation involving strings, numbers and Boolean values. It allows you to identify parts of the XML document tree, to navigate around the tree, and to uniquely select nodes. The currently version is "XPath 2.0". It was originally defined by the World Wide Web Consortium (W3C).</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="xul">
-                       <glossterm>XUL</glossterm>
-                       <glossdef>
-                               <para>The XML User Interface Language, a specialized interface language that allows building cross-platform applications that drive <application>Mozilla</application>-based browsers such as <application>Firefox</application>. More information is available at <ulink url="https://developer.mozilla.org/en/XUL">https://developer.mozilla.org/en/XUL</ulink>.</para>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="xulrunner">
-                       <glossterm>xulrunner</glossterm>
-                       <glossdef>
-                               <para>A specialized run-time application environment that provides support for installing, upgrading and uninstalling <application>XUL</application> applications. It operates with <application>Mozilla</application>-based applications such as the <application>Firefox</application> browser. More information is available at <ulink url="https://developer.mozilla.org/en/XULRunner">https://developer.mozilla.org/en/XULRunner</ulink>.</para>
-                               <glossseealso otherterm="xul"/>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>Y</title>
-               <glossentry id="YAZ">
-                       <glossterm>YAZ</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-               <glossentry id="yaz-client">
-                       <glossterm>yaz-client</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-       <glossdiv>
-               <title>Z</title>
-               <glossentry id="Z39.50">
-                       <glossterm>Z39.50</glossterm>
-                       <glossdef>
-                               <caution>PLEASE ADD CONTENT</caution>
-                       </glossdef>
-               </glossentry>
-       </glossdiv>
-</glossary>
+<?xml version="1.0" encoding="UTF-8"?>\r
+<glossary xml:id="Glossary" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">\r
+       <title>Glossary</title>\r
+       <abstract>\r
+               <para>In this section we expand acronyms, define terms, and generally try to explain concepts used by Evergreen software.</para>\r
+       </abstract>\r
+       <glossdiv>\r
+               <title>A</title>\r
+               <glossentry id="Apache">\r
+                       <glossterm>Apache</glossterm>\r
+                       <glossdef>\r
+                               <para>Open-source web server software used to serve both static content and dynamic web pages in a secure and reliable way. More information is available at <ulink url="http://apache.org">apache.org</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>B</title>\r
+               <glossentry id="Book Bags">\r
+                       <glossterm>Bookbags</glossterm>\r
+                       <glossdef>\r
+                               <para>Bookbags are lists of items that can be used for any number of purposes. For example, to keep track of what books you have read, books you would like to read, \r
+                               to maintain a class reading list, to maintain a reading list for a book club, to keep a list of books you would like for your birthday. There are an unlimited number \r
+                               of uses.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>C</title>\r
+               <glossentry id="closure">\r
+                       <glossterm>Closure Compiler</glossterm>\r
+                       <glossdef>\r
+                               <para>A suite of open-source tools used to build web applications with <application>Javascript</application>; originally developed by Google. More information is available at <ulink url="http://code.google.com/closure/compiler/">http://code.google.com/closure/compiler/</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="CPAN">\r
+                       <glossterm>CPAN</glossterm>\r
+                       <glossdef>\r
+                               <para>An open-source archive of software modules written in <application>Perl</application>. More information is available at <ulink url="http://www.cpan.org">www.cpan.org</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>D</title>\r
+               <glossentry id="Debian">\r
+                       <glossterm>Debian</glossterm>\r
+                       <glossdef>\r
+                               <para>One of the most popular open-source operating system using the <systemitem class="osname">Linux</systemitem> kernel that provides over 25000 useful precompiled software packages. Also known as <systemitem class="osname">Debian GNU/Linux</systemitem>. More information is available at <ulink url="http://www.debian.org">www.debian.org</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry>\r
+                       <glossterm>Domain name</glossterm>\r
+                       <glossdef>\r
+                               <para>A unique set of case-insensitive, alphanumeric strings separated by periods that are used to name organizations, web sites and addresses on the Internet (e.g.: <uri>www.esilibrary.com</uri>). Domain names can be reserved via third-party registration services, and can be associated with a unique IP address or suite of IP addresses.</para>\r
+                               <glossseealso otherterm="ipaddress"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>E</title>\r
+               <glossentry id="ejabberd">\r
+                       <glossterm>ejabberd</glossterm>\r
+                       <glossdef>\r
+                               <para>An open-source Jabber/XMPP instant messaging server that runs under popular operating systems (e.g., <systemitem class="osname">Mac OSX</systemitem>, <systemitem class="osname">GNU/Linux</systemitem>, and <systemitem class="osname">Microsoft Windows</systemitem>). One popular use is to provide <application>XMPP</application> messaging services for a <application>Jabber</application> domain across an extendable cluster of cheap, easily-replaced machine nodes. More information is available at <ulink url="http://www.ejabberd.im/">http://www.ejabberd.im</ulink>.</para>\r
+                               <glossseealso otherterm="Jabber"/>\r
+                               <glossseealso otherterm="XMPP"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>F</title>\r
+               <glossentry></glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>G</title>\r
+               <glossentry></glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>H</title>\r
+               <glossentry></glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>I</title>\r
+               <glossentry id="ipaddress">\r
+                       <glossterm>IP Address</glossterm>\r
+                       <glossdef>\r
+                               <para>(Internet Protocol address) A numerical label consisting of four numbers separated by periods (e.g., "192.168.1.15") assigned to individual members of networked computing systems. It uniquely identifies each system on the network and allows controlled communication between such systems. The numerical label scheme must adhere to a strictly defined naming convention that is currently defined and overseen by the Internet Corporation for Assigned Names and Numbers ("ICANN").</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="Item Buckets">\r
+                       <glossterm>Item/copy Buckets</glossterm>\r
+                       <glossdef>\r
+                               <para>Virtual <quote>containers</quote> to use in batch processing of item or copy records. They can be used to perform various cataloging/holdings maintenance tasks \r
+                               in batch.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>J</title>\r
+               <glossentry id="Jabber">\r
+                       <glossterm>Jabber</glossterm>\r
+                       <glossdef>\r
+                               <para>Now known as XMPP (eXtensible Messaging and Presence Protocol), it was originally named "Jabber".</para>\r
+                               <glossseealso otherterm="XMPP"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>K</title>\r
+               <glossentry></glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>L</title>\r
+               <glossentry></glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>M</title>\r
+               <glossentry id="MARC">\r
+                       <glossterm>MARC</glossterm>\r
+                       <glossdef>\r
+                               <para>The MARC formats are standards for the representation and communication of bibliographic and related information in machine-readable form.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="MARCXML">\r
+                       <glossterm>MARCXML</glossterm>\r
+                       <glossdef>\r
+                               <para>Framework for working with MARC data in a XML environment.<para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="McCoy">\r
+                       <glossterm>McCoy</glossterm>\r
+                       <glossdef>\r
+                               <para>An open-source application that allows add-on authors to provide secure updates to their users. More information is available at <ulink url="https://developer.mozilla.org/en/McCoy">developer.mozilla.org/en/McCoy</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="memcached">\r
+                       <glossterm>memcached</glossterm>\r
+                       <glossdef>\r
+                               <para>A general-purpose distributed memory caching system, usually with a client~server architecture spread over multiple computing systems. It reduces the number of \r
+                               times a data source (e.g., a database) must be directly accessed by temporarily caching data in memory, therefore dramatically speeding up database-driven \r
+                               web applications.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>N</title>\r
+               <glossentry id="netaddr">\r
+                       <glossterm>Network address</glossterm>\r
+                       <glossdef>\r
+                               <para>Also known as an IP address (Internet Protocol address).</para>\r
+                               <glossseealso otherterm="ipaddress"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="nsis">\r
+                       <glossterm>nsis</glossterm>\r
+                       <glossdef>\r
+                               <para>An open-source software tool used to create Windows installers. More information is available at <ulink url="http://nsis.sourceforge.net">http://nsis.sourceforge.net</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>O</title>\r
+               <glossentry id="OPAC">\r
+                       <glossterm>OPAC</glossterm>\r
+                       <glossdef>\r
+                               <para>The "Online Public Access Catalog"; an online database of a library's holdings; used to find resources in their collections; possibly searchable by keyword, \r
+                               title, author, subject or call number.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="OpenSRF">\r
+                       <glossterm>OpenSRF</glossterm>\r
+                       <glossdef>\r
+                               <para>The "Open Scalable Request Framework" (pronounced 'open surf') is a stateful, decentralized service architecture that allows developers to create applications \r
+                               for Evergreen with a minimum of knowledge of its structure.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>P</title>\r
+               <glossentry id="PostgreSQL">\r
+                       <glossterm>PostgreSQL</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular open-source object-relational database management system that underpins Evergreen software.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="putty">\r
+                       <glossterm>Putty</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular open-source telnet/ssh client for the Windows and Unix platforms. More information is available at \r
+                               <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/putty/">http://www.chiark.greenend.org.uk/~sgtatham/putty/</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>Q</title>\r
+               <glossentry></glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>R</title>\r
+               <glossentry id="Resource Hacker">\r
+                       <glossterm>Resource Hacker</glossterm>\r
+                       <glossdef>\r
+                               <para>An open-source utility used to view, modify, rename, add, delete and extract resources in 32bit Windows executables</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>S</title>\r
+               <glossentry id="SIP2">\r
+                       <glossterm></glossterm>\r
+                       <glossdef>\r
+                               <para>SIP, standing for Standard Interchange Protocol, was developed by the 3M Corporation to be a common protocol for data transfer between ILS' and third party \r
+                               devices.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="srfsh">\r
+                       <glossterm>srfsh</glossterm>\r
+                       <glossdef>\r
+                               <para>A command language interpreter (shell) that executes commands read from the standard input. It is used to test the Open Service Request Framework (OpenSRF).</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="SRU">\r
+                       <glossterm>SRU</glossterm>\r
+                       <glossdef>\r
+                               <para>SRU is a standard XML-focused search protocol for Internet search queries, utilizing CQL (Contextual Query Language), a standard syntax for representing \r
+                               queries.</para> \r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="ssh">\r
+                       <glossterm>SSH</glossterm>\r
+                       <glossdef>\r
+                               <para>An encrypted network protocol using public-key cryptography that allows secure communications between systems on an insecure network. Typically used to access \r
+                               shell accounts but also supports tunneling, forwarding TCP ports and X11 connections, and transferring files.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="sshproxy">\r
+                       <glossterm>SSH proxy</glossterm>\r
+                       <glossdef>\r
+                               <para> As used in Evergreen, a method of allowing one or more Staff Clients to communicate with one or more Evergreen servers over an insecure network by sending data through a secure SSH tunnel. It also buffers and caches all data travelling to and from Staff Clients to speed up access to resources on Evergreen servers.</para>\r
+                               <glossseealso otherterm="ssh"/>\r
+                               <glossseealso otherterm="tunneling"/>\r
+                               <glossseealso otherterm="sshtunnel"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="sshtunnel">\r
+                       <glossterm>SSH tunnel</glossterm>\r
+                       <glossdef>\r
+                               <para>An encrypted data channel existing over an SSH network connection. Used to securely transfer unencrypted data streams over insecure networks.</para>\r
+                               <glossseealso otherterm="ssh"/>\r
+                               <glossseealso otherterm="tunneling"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="SSL Certificate">\r
+                       <glossterm>SSL Certificate</glossterm>\r
+                       <glossdef>\r
+                               <para>A special electronic document used to guarantee authenticity of a digital message. Also known as a "public key", or "identity" or "digital" certificate. It \r
+                               combines an identity (of a person or an organization) and a unique public key to form a so-called digital signature, and is used to verify that the public key does, \r
+                               in fact, belong with that particular identity.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>T</title>\r
+               <glossentry id="tunneling">\r
+                       <glossterm>tunneling</glossterm>\r
+                       <glossdef>\r
+                               <para>A method of encapsulating data provided in one network protocol (the "delivery" protocol), within data in a different network protocol (the "tunneling" \r
+                               protocol). Used to provide a secure path and secure communications through an insecure or incompatible network. Can be used to bypass firewalls by communicating via \r
+                               a protocol the firewall normally blocks, but "wrapped" inside a protocol that the firewall does not block.</para>\r
+                               <glossseealso otherterm="sshtunnel"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>U</title>\r
+               <glossentry id="Ubuntu">\r
+                       <glossterm>Ubuntu</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular open-source operating system using the <systemitem class="osname">Linux</systemitem> kernel that was originally based on the \r
+                               <systemitem class="osname">Debian GNU/Linux</systemitem> operating system. More information is available at <ulink url="http://www.ubuntu.com">www.ubuntu.com</ulink>.</para>\r
+                               <glossseealso otherterm="Debian"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>V</title>\r
+               <glossentry id="virtualization">\r
+                       <glossterm>Virtualization</glossterm>\r
+                       <glossdef>\r
+                               <para>A method of executing software in a special environment that is partitioned or separated from the real underlying hardware and software resources. In typical \r
+                               usage, it allows a <emphasis>host</emphasis> operating system to encapsulate or emulate another operating system environment in such a way that the emulated environment \r
+                               is completely unaware of the hosting environment. For instance, it allows a <systemitem class="osname">Linux</systemitem> application to execute within a \r
+                               <systemitem class="osname">Windows</systemitem> environment.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="virtualbox">\r
+                       <glossterm>VirtualBox</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular commercial package of virtualization software that emulates the x86 microprocessor architecture. It can be installed on  \r
+                               <systemitem class="osname">Linux</systemitem>, <systemitem class="osname">Mac OS X</systemitem>, <systemitem class="osname">Windows</systemitem> or \r
+                               <systemitem class="osname">Solaris</systemitem> "host" operating systems and allows other "guest" (typically including <systemitem class="osname">Linux</systemitem> \r
+                               and <systemitem class="osname">Windows</systemitem>) operating systems to be loaded and executed.</para>\r
+                               <glossseealso otherterm="virtualization"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="virtualpc">\r
+                       <glossterm>Virtual PC</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular commercial package of virtualization software that emulates the x86 microprocessor architecture. It is installed on a Windows "host" operating system \r
+                               and allows other "guest" (typically including <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Windows</systemitem>) operating systems to \r
+                               be loaded and executed.</para>\r
+                               <glossseealso otherterm="virtualization"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="Volume Buckets">\r
+                       <glossterm>Volume Buckets</glossterm>\r
+                       <glossdef>\r
+                               <para>Virtual <quote>containers</quote> to use in batch processing of multiple volumes. They can be used to perform various cataloging/holdings maintenance tasks \r
+                               in batch.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="vmware">\r
+                       <glossterm>VMware</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular commercial package of virtualization software that emulates the x86 microprocessor architecture. It can be installed on <systemitem class="osname">Linux</systemitem>, <systemitem class="osname">Mac OS X</systemitem>, <systemitem class="osname">Windows</systemitem> or <systemitem class="osname">Solaris</systemitem> "host" operating systems and allows other "guest" (typically including <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Windows</systemitem>) operating systems to be loaded and executed.</para>\r
+                               <glossseealso otherterm="virtualization"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>W</title>\r
+               <glossentry id="wine">\r
+                       <glossterm>Wine</glossterm>\r
+                       <glossdef>\r
+                               <para>A popular open-source application that allows <systemitem class="osname">Linux</systemitem> and <systemitem class="osname">Unix</systemitem> systems to \r
+                               run <systemitem class="osname">Windows</systemitem> executables. More information is available at <ulink url="http://www.winehq.org/">http://www.winehq.org/</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>X</title>\r
+               <glossentry id="xml">\r
+                       <glossterm>XML</glossterm>\r
+                       <glossdef>\r
+                               <para>The eXtensible Markup Language, a subset of SGML; a set of rules for encoding information in a way that is both human- and machine-readable. It is primarily \r
+                               used to define documents but can also be used to define arbitrary data structures. It was originally defined by the World Wide Web Consortium (W3C).</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="XMPP">\r
+                       <glossterm>XMPP</glossterm>\r
+                       <glossdef>\r
+                               <para>An open-standard communications protocol, based on XML, used in message-oriented middleware. It supports the concept of a consistent <emphasis>domain</emphasis> \r
+                               of message types that flow between software applications, possibly on different operating systems and architectures. More information is available at \r
+                               <ulink url="http://xmpp.org">xmpp.org</ulink>.</para>\r
+                               <glossseealso otherterm="Jabber"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="xpath">\r
+                       <glossterm>xpath</glossterm>\r
+                       <glossdef>\r
+                               <para>The XML Path Language, a query language based on a tree representation of an XML document. It is used to programmatically select nodes from an XML document and to \r
+                               do minor computation involving strings, numbers and Boolean values. It allows you to identify parts of the XML document tree, to navigate around the tree, and to \r
+                               uniquely select nodes. The currently version is "XPath 2.0". It was originally defined by the World Wide Web Consortium (W3C).</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="xul">\r
+                       <glossterm>XUL</glossterm>\r
+                       <glossdef>\r
+                               <para>The XML User Interface Language, a specialized interface language that allows building cross-platform applications that drive <application>Mozilla</application>\r
+                               -based browsers such as <application>Firefox</application>. More information is available at \r
+                               <ulink url="https://developer.mozilla.org/en/XUL">https://developer.mozilla.org/en/XUL</ulink>.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="xulrunner">\r
+                       <glossterm>xulrunner</glossterm>\r
+                       <glossdef>\r
+                               <para>A specialized run-time application environment that provides support for installing, upgrading and uninstalling <application>XUL</application> applications. \r
+                               It operates with <application>Mozilla</application>-based applications such as the <application>Firefox</application> browser. More information is available at \r
+                               <ulink url="https://developer.mozilla.org/en/XULRunner">https://developer.mozilla.org/en/XULRunner</ulink>.</para>\r
+                               <glossseealso otherterm="xul"/>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>Y</title>\r
+               <glossentry id="YAZ">\r
+                       <glossterm>YAZ</glossterm>\r
+                       <glossdef>\r
+                               <para>A programmers’ toolkit supporting the development of Z39.50/SRW/SRU clients and servers.</para> \r
+                       </glossdef>\r
+               </glossentry>\r
+               <glossentry id="yaz-client">\r
+                       <glossterm>yaz-client</glossterm>\r
+                       <glossdef>\r
+                               <para>Z39.50/SRU client for connecting to YAZ servers.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+       <glossdiv>\r
+               <title>Z</title>\r
+               <glossentry id="Z39.50">\r
+                       <glossterm>Z39.50</glossterm>\r
+                       <glossdef>\r
+                               <para>A client–server protocol for searching and retrieving information from remote computer databases.</para>\r
+                       </glossdef>\r
+               </glossentry>\r
+       </glossdiv>\r
+</glossary>\r