esvn.xml

linux 下的 图形化的 SVN 相当于 VSS

<?xml version = '1.0' encoding = 'UTF-8'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
	<!ENTITY % global_entities SYSTEM "../common/global.ent">
	%global_entities;
]>
<book>
    <bookinfo>
    <title>The &esvn; User Manual</title>
    <authorgroup>
      <author>
        <personname>
          <firstname>Sean</firstname>
          <surname>Wheller</surname>
        </personname>
      </author>
    </authorgroup>
    <legalnotice>
      <para>Permission is granted to copy, distribute and/or modify this document under the terms of
        the GNU Free Documentation License, Version 1.1 or any later version published by the Free
        Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no
        Back-Cover Texts. A copy of the license can be found at the &quot;<ulink url="http://www.gnu.org/licenses/fdl.html">GNU Web Site.&quot;</ulink>
      </para>
    </legalnotice>
    <revhistory>
      <revision>
        <revnumber>0.1</revnumber>
        <date>11/08/2004</date>
        <revdescription>
          <para>Initial document creation in accordance with version 0.5.8</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.2</revnumber>
        <date>28/08/2004</date>
        <revdescription>
          <para>Version 0.5.9. [+] upgrading procedure, build procedures, toolbars. [*] update Main,
            View and Quick Diff captures.</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.2.1</revnumber>
        <date>29/08/2004</date>
        <revdescription>
          <para>Version 0.5.9. [*] fixes to grammar.</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.2.2</revnumber>
        <date>30/08/2004</date>
        <revdescription>
          <para>Version 0.6.0. [+] help options Web Site, Check for updates [+] Versions update [*]
            add filters to log [+] Browser to options [-] option help index.</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.2.3</revnumber>
        <date>06/09/2004</date>
        <revdescription>
          <para>Version 0.6.1. [+] B option diff setup dlg [+] Auto refresh Options - other dlg [+]
            Add Diff-3 (conflict) section [*] description of quick diff logic.</para>
        </revdescription>
      </revision>
      <revision>
        <revnumber>0.2.4</revnumber>
        <date>14/09/2004</date>
        <revdescription>
          <para>Version 0.6.3 [+] Show changed items option to Query menu [+] Show changed
            items section [*] Update main and query captures [+] Open option to Options, General
            form [+] Add File Mapping to Options</para>
        </revdescription>
      </revision>
        <revision>
        <revnumber>0.2.5</revnumber>
        <date>10/11/2004</date>
        <revdescription>
          <para>Version 0.6.4 [+] Added log levels (Regular and Verbose)</para>
        </revdescription>
        </revision>
        <revision>
        <revnumber>0.2.6</revnumber>
        <date>11/12/2004</date>
        <revdescription>
          <para>Version 0.6.5 [+] Build instructions [+] Flat View [+] list of modified files/dirs to the Commit dialog</para>
        </revdescription>
        </revision>
        <revision>
        <revnumber>0.2.7</revnumber>
        <date>11/12/2004</date>
        <revdescription>
          <para>Version &version; [*] Removed &quot;Hide unknown files&quot; from the &quot;Options&quot; dialog (still avaliable from Menu/View only)</para>
        </revdescription>
      </revision>
    </revhistory>
  </bookinfo>
    <preface id="esvn-preface">
        <title>Preface</title>
        <sect1 id="esvn-contributing">
            <title>Contributing</title>
            <para>&esvn; is developed as a Free/Open Source project at <ulink
                url="http://esvn.umputun.com/">umputun</ulink>. The source code and this
                documentation is therefore publicly available under the conditions of the
                <acronym>GPL</acronym> and <acronym>GFDL</acronym>. As a community project, everyone
                can contribute to &esvn;, even if you know little about it. In fact, some tasks
                may be better accomplished by those who know little about it, for example:</para>
            <itemizedlist>
                <listitem>
                    <para>Improving this documentation</para>
                </listitem>
                <listitem>
                    <para>Embellishing the interface with cool graphics</para>
                </listitem>
                <listitem>
                    <para>Internationalization of the interface and documentation</para>
                </listitem>
                <listitem>
                    <para>Testing features to see that they work</para>
                </listitem>
                <listitem>
                    <para>Building <acronym>RPM</acronym>'s</para>
                </listitem>
            </itemizedlist>
            <para>This said, there is always a need for good coders, so go ahead &quot;<ulink
                    url="http://esvn.umputun.com/">Get the Source!</ulink>&quot; Once you have
                done that register to the <ulink url="http://esvn.umputun.com/forum/">&esvn;
                forum</ulink>. If you have something to contribute, state your interest and what you
                want to work on. Members of the team will let you know if there is already somebody
                working on the item you're interested in. If you have a contribution you will be
                invited to join the developer group and given access to the &esvn;
                <application>subversion</application> server.</para>
            <para>If you just want a copy of &esvn; for your own use, visit the <ulink
                    url="http://esvn.umputun.com/">&esvn; Web Site</ulink> download either an
                RPM or tarball then see <xref linkend="esvn-installation"/>.</para>
        </sect1>
        <sect1 id="esvn-installation">
            <title>Installation</title>
            <para>Prior to proceeding with this section please ensure that you have downloaded your
                chosen installation package and that your system meets the requirements.</para>
            <para>&esvn; is available in source and packaged versions from the &esvn; <ulink
                    url="http://esvn.umputun.com/">Web Site</ulink>. If you have downloaded the
                <acronym>RPM</acronym> see <xref linkend="esvn-inst-inst-rpm"/>, otherwise see <xref
                linkend="esvn-inst-inst-tarball"/> for installation instructions.</para>
            <sect2 id="esvn-inst-req">
                <title id="esvn-title-inst-req">Requirements</title>
                <para>&esvn; requires:</para> &varlist-requirements; </sect2>
            <sect2 id="esvn-inst-inst">
                <title>Installing</title>
                <para>Before proceeding with the following installation instructions, please ensure
                    that your system meets the requirements for &esvn; (see <xref
                        endterm="esvn-title-inst-req" linkend="esvn-inst-req"/>).</para>
                <sect3 id="esvn-inst-inst-tarball">
                    <title>Tarball</title>
                    <para>If you downloaded the tarball, follow this procedure to install.</para>
                    <procedure>
                        <title>Installing &esvn; from tarball</title>
                        <step>
                            <para>
                                <action>Open</action> a <application>Shell</application> session.</para>
                        </step>
                        <step>
                            <para>Change to the directory where the &esvn; installation archive
                                is located (<command>cd path/to/installation/archive</command>).</para>
                        </step>
                        <step>
                            <para>Unpack the archive using the command <command>tar -zxf &esvn;.tar.gz</command>.</para>
                        </step>
                        <step>
                            <para>Change to the resulting <filename
                                class="directory">&esvn;</filename> directory <command>cd &esvn;</command>.</para>
                        </step>
                        <step>
                            <para>Enter the following command <command>make</command>.</para>
                        </step>
                        <step>
                            <para>Login as root.</para>
                        </step>
                        <step>
                            <para>
                                <action>Type</action>
                                <command>make install</command>.</para>
                        </step>
                        <step>
                            <para>
                                <action>Logoff</action> root <command>exit</command>.</para>
                        </step>
                        <step>
                            <para>
                                <action>Type</action>
                                <command>&esvn;</command> to start &esvn;.</para>
                        </step>
                    </procedure>
                    <caution>
                        <para>Do not delete the folder or files from the tarball source just in case
                            you wish to uninstall &esvn;.</para>
                    </caution>
                </sect3>
                <sect3 id="esvn-inst-inst-rpm">
                    <title>RPM</title>
                    <para>If you downloaded the <acronym>RPM</acronym> version of the distribution
                        then &esvn; can be installed using <application>RPM</application>.</para>
                    <procedure>
                        <title>Installing &esvn; from rpm</title>
                        <step>
                            <para>
                                <action>Open</action> a <application>Shell</application> session.</para>
                        </step>
                        <step>
                            <para>
                                <action>login</action> as root <command>su</command>, then enter the
                                root password.</para>
                        </step>
                        <step>
                            <para>Change to the directory where the &esvn; installation archive
                                is located (<command>cd path/to/installation/archive</command>).</para>
                        </step>
                        <step>
                            <para>
                                <action>Type</action>
                                <command>rpm -ivh [package]</command>. This will install &esvn;
                                in full verbose mode so you can see what's happening and where files
                                are put.</para>
                        </step>
                        <step>
                            <para>