esvn.xml

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

            back without overriding each other work. All users can identify the most up-to-date
            version of a file and access older versions If required.</para>
        <para>A <application>subversion</application> server is therefore suited to managing files
            that are frequently changed and developed over time by a group of users. The server acts
            as the main focal point of the user effort and is therefore a collaborative environment.
            Everything that is done to the files must be saved back to the
            <application>subversion</application> server in order to be made available to all the
            other members of the group.</para>
    </chapter>
    <chapter id="esvn-gettingstarted">
        <title>Getting Started</title>
        <para>This chapter provides an overview of the &esvn; interface, how it works, where to
            find things and what they mean. For users that have knowledge of
            <application>subversion</application> and other revision control front end applications
            the interface is intuitive and easy to understand. This chapter should be enough for
            such users to have an understanding of &esvn; and begin working immediately.</para>
        <para>Users that are new to <application>subversion</application> or revision control front
            end applications will also find the &esvn; interface to be intuitive and easy to
            use, but will need to have an understanding of how <application>subversion</application>
            works and how to use it in order to understand the purpose and usage of the various
            &esvn; features and functions. To assist in such cases, this chapter provides links
            to relevant sections within the main part of the book (see <xref linkend="esvn-using"/>).</para>
        <sect1 id="esvn-starting">
            <title>Starting &esvn;</title>
            <para>&esvn; is normally installed in <filename
                class="directory">/usr/bin/</filename> which should be in the system path. To start
                &esvn; open a shell session and type <command>&esvn;</command>. This should
                start &esvn;.</para>
            <para>Alternatively, &esvn; is added to the
                <application>GNOME</application>/<application>KDE</application> desktop menu. Select &desktop-menu;.</para>
            <!-- Not sure that this desktop integration point is correct for GNOME -->
            <para>On first start &esvn; will display the <interfacename>Welcome to
                &esvn;</interfacename> dialog (see <xref linkend="fig-startup"/>). This dialog
                enables three actions:</para>
            <variablelist>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Open an existing working directory</emphasis>
                    </term>
                    <listitem>
                        <para>If you already have a folder system under &svn; control,
                            &esvn; can open the working copy directly. Select this option to
                            display the <interfacename>Open</interfacename> dialog used to change
                            path to a working copy. See <xref linkend="esvn-open-workspace"/>).</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Checkout a working copy</emphasis>
                    </term>
                    <listitem>
                        <para>If you have no &svn; working copies in your file system or wish to
                            checkout a working copy for the first time select this option to display
                            the <interfacename>checkout</interfacename> dialog. For more information
                            on performing a checkout see <xref linkend="esvn-checkout"/>.</para>
                    </listitem>
                </varlistentry>
                <varlistentry>
                    <term>
                        <emphasis role="bold">Import project to server</emphasis>
                    </term>
                    <listitem>
                        <para>If you have a project in your local file system that is not under
                            &svn; control and wish to place it into a &svn; server for
                            others to access and revision control, then select this option to
                            display the <interfacename>Import</interfacename> dialog. For more
                            information on importing projects to &svn; servers see <xref linkend="esvn-import"/>.</para>
                    </listitem>
                </varlistentry>
            </variablelist>
            <?pagebreak ?>
            <figure id="fig-startup">
                <title>The First Time Startup Dialog</title>
                <screenshot>
                    <mediaobject>
                        <imageobject>
                            <imagedata fileref="images/startup.png" format="PNG" width="8cm"/>
                        </imageobject>
                    </mediaobject>
                </screenshot>
            </figure>
            <tip>
                <para>
                    <action>Delete</action> the <filename class="directory">~/.qt3/esvn</filename>
                    directory to erase all configuration and preference settings. The
                        <interfacename>Welcome to &esvn;</interfacename> dialog will again
                    displayed be on first startup.</para>
            </tip>
        </sect1>
        <sect1 id="esvn-mainint">
            <title>Main Interface</title>
            <para>The main interface is comprised of the following areas (see <xref linkend="esvn-fig-mainint"/>):</para>
            <itemizedlist>
                <listitem>
                    <para>
                        <xref endterm="esvn-title-main-menus" linkend="esvn-main-menus"/>
                    </para>
                </listitem>
                <listitem>
                    <para>
                        <xref endterm="esvn-title-toolbar" linkend="esvn-toolbar"/> - By default set
                        to OFF. When set to ON, displayed under the menus. </para>
                </listitem>
                <listitem>
                    <para>
                        <xref endterm="esvn-title-tree-view" linkend="esvn-tree-view"/> - left side
                        pane </para>
                </listitem>
                <listitem>
                    <para>
                        <xref endterm="esvn-title-file-view" linkend="esvn-file-view"/> - right side
                        top pane </para>
                </listitem>
                <listitem>
                    <para>
                        <xref endterm="esvn-title-log-view" linkend="esvn-log-view"/> - right side
                        bottom pane </para>
                </listitem>
                <listitem>
                    <para>
                        <xref linkend="esvn-command-prompt" endterm="esvn-title-command-prompt"/>
                    </para>
                </listitem>
            </itemizedlist>
            <para>The real-estate of the main interface can be managed by resizing the amount of
                space a pane takes in the application window. <action>Move</action> the mouse
                pointer over either the vertical or horizontal pane separators. The pointer will
                change, then <action>click</action> and <action>hold</action> the mouse button while
                <action>dragging</action> the pointer to a new position in order to resize a pane.</para>
            <?pagebreak ?>
            <figure id="esvn-fig-mainint">
                <title>Main Interface</title>
                <screenshot>
                    <mediaobject>
                        <imageobject>
                            <imagedata fileref="images/main.jpg" format="JPEG" width="12cm"/>
                        </imageobject>
                    </mediaobject>
                </screenshot>
            </figure>
            <sect2 id="esvn-main-menus">
                <title id="esvn-title-main-menus">Main Menus</title>
                <para>SVN commands and &esvn; functions are menu driven. Following is a
                    description of the main menus, their options and shortcut keys where applicable.</para>
                <tip>
                    <para>When navigating the menu options look at the <interfacename>Status
                        bar</interfacename>, located at the bottom of the <interfacename>main
                        window</interfacename>, for tips about the function of the selected option.</para>
                </tip>
                <formalpara id="esvn-fpara-file-menu">
                    <title>File Menu</title>
                    <para>
                        <itemizedlist>
                            <listitem>
                                <para>&file-open;: Displays a common dialog for browsing to and
                                    opening local folders containing resources which may or may not
                                    be under <application>subversion</application> control (see
                                        <xref linkend="esvn-open-workspace"/>).</para>
                            </listitem>
                            <listitem>
                                <para>&file-workspace;: Displays the Workspace Manager dialog
                                    used to manage workspaces (see <xref linkend="esvn-workspace"/>).</para>
                            </listitem>
                            <listitem>
                                <para>&file-checkout;: Displays the checkout dialog used to
                                    specify parameters for the checkout process (see <xref linkend="esvn-checkout"/>).</para>
                            </listitem>
                            <listitem>
                                <para>&file-browse;: Displays the repository browser which can
                                    be used to explore a remote or local subversion repository
                                    without performing a checkout (see <xref linkend="esvn-browse"/>).</para>
                            </listitem>
                            <listitem>
                                <para>&file-import;: Displays the import dialog used to specify
                                    a path that will be committed to a given <acronym>URL</acronym>
                                    (see <xref linkend="esvn-import"/>).</para>
                            </listitem>
                            <listitem>
                                <para> &file-export;: Displays the export dialog used to specify
                                    a <acronym>URL</acronym> from which a clean directory tree will
                                    be made in a given local path (see <xref linkend="esvn-export"/>).</para>
                            </listitem>
                            <listitem>
                                <para>&file-options;: Displays the options dialog used to set
                                    preferences for &esvn; (see <xref linkend="esvn-options"/>).</para>
                            </listitem>
                            <listitem>
                                <para>&file-recent;: A list of the most recently opened work
                                    spaces. Select an option to open the workspace.</para>
                            </listitem>
                            <listitem>
                                <para>&file-exit;: Closes &esvn;.</para>
                            </listitem>
                        </itemizedlist>
                    </para>
                </formalpara>
                <formalpara id="esvn-fpara-view-menu">
                    <title>View Menu</title>
                    <para>
                        <itemizedlist>
                            <listitem>
                                <para>&view-refreshlocal;: Refreshes the <xref
                                        endterm="esvn-title-file-view" linkend="esvn-file-view"/> of
                                    the folder selected in the <xref endterm="esvn-title-tree-view"
                                    linkend="esvn-tree-view"/>. </para>
                            </listitem>
                            <listitem>
                                <para>&view-refreshworkspace;: Refreshes both the <xref
                                        endterm="esvn-title-file-view" linkend="esvn-file-view"/>
                                    and <xref endterm="esvn-title-tree-view" linkend="esvn-tree-view"/>.</para>
                            </listitem>
                            <listitem>
                                <para>&view-refreshonline;: Refreshes both the <xref
                                        endterm="esvn-title-file-view" linkend="esvn-file-view"/>
                                    and <xref endterm="esvn-title-tree-view"
                                    linkend="esvn-tree-view"/> and compares the revision number of
                                    all local files with those in the repository.</para>
                            </listitem>
                            <listitem>
                                <para>&view-flat-view;: Toggles display mode of the <xref
                                        linkend="esvn-file-view" endterm="esvn-title-file-view"/>
                                    between Hide Paths and Show Paths.</para>
                            </listitem>