esvn.xml

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

                <para>When &esvn; is first started the toolbars are not displayed. To display a
                    toolbar select &view-toolbars; and choose one of the available sub menu
                    options. Options displaying a checked symbol are enabled, those without are not.
                    In this way toolbars can be toggled ON and OFF depending on preference.</para>
                <para>When a toolbar is enabled it is by default displayed in the docked position
                    below the main menu. Toolbars can be docked on any side of the main interface
                    (top, left, bottom, right). To dock a toolbar select the toolbar handle and drag
                    it to one of the sides. While moving the toolbar the contents are transparent
                    and the outline of the area is represented by a thick lined rectangle. When the
                    toolbar is brought close to any side this line is thin, indicating that the
                    toolbar can be docked in this position. Release the toolbar when the outline
                    changes and the toolbar will span into the docked position. Within the docked
                    position the toolbar position can be adjusted according to preference.</para>
                <para>Toolbars can also be free-floating within any area of the desktop real-estate,
                    even beyond the &esvn; window space. When a toolbar is free-floating it can
                    be returned to the top docking position by <action>double-clicking</action> its
                    title bar.</para>
                <para>The layout and position of toolbars is set to be persistent so that the
                    &esvn; workspace is restored to the preferences of the previous session. As
                    example of the interface with docked and free-floating menus can be seen in
                        <xref linkend="esvn-fig-mainint"/>.</para>
            </sect2>
            <sect2 id="esvn-tree-view">
                <title id="esvn-title-tree-view">Tree View</title>
                <para>The tree view displays the tree folder structure of the workspace directory.
                    Folder levels can be expanded and collapsed. The status of a folder is displayed
                    by changes in the folder icon as follows.</para>
                <table>
                    <title>Tree View Status Icons</title>
                    <tgroup cols="2">
                        <thead>
                            <row>
                                <entry>Icon</entry>
                                <entry>Meaning</entry>
                            </row>
                        </thead>
                        <tbody>
                            <row>
                                <entry>
                                    <inlinemediaobject>
                                        <imageobject>
                                            <imagedata fileref="images/folder_green.png"
                                                format="PNG" scale="100"/>
                                        </imageobject>
                                    </inlinemediaobject>
                                    <inlinemediaobject>
                                        <imageobject>
                                            <imagedata fileref="images/folder_green_open.png"
                                                format="PNG" scale="100"/>
                                        </imageobject>
                                    </inlinemediaobject>
                                </entry>
                                <entry>Folder open/closed. Exists in local and repository.</entry>
                            </row>
                            <row>
                                <entry>
                                    <inlinemediaobject>
                                        <imageobject>
                                            <imagedata fileref="images/folder_grey_3.png" format="PNG"/>
                                        </imageobject>
                                    </inlinemediaobject>
                                    <inlinemediaobject>
                                        <imageobject>
                                            <imagedata fileref="images/folder_grey_open_3.png" format="PNG"/>
                                        </imageobject>
                                    </inlinemediaobject>
                                </entry>
                                <entry>Folder open/closed. Exists local only.</entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>
                <para>In addition to enabling exploration of the folder structure and displaying
                    status, the tree view provides access to a number of
                    <application>subversion</application> operations by way of a context menu (<action>right-click</action>).</para>
            </sect2>
            <sect2 id="esvn-file-view">
                <title id="esvn-title-file-view">File View</title>
                <para>The file view lists files and folders and displays information about the
                    listed items. The list of items displayed is determined by selecting a folder in
                    the &quot;<xref endterm="esvn-title-tree-view"
                    linkend="esvn-tree-view"/>&quot;. Items can be listed in two modes:</para>
                <variablelist>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Hide Paths</emphasis>
                        </term>
                        <listitem>
                            <para>This is the default view and displays items using the traditional
                                <acronym>GUI</acronym> file/folder display method. This method shows
                                only the root view of the selected folder, to view contents of
                                folders the folder must be selected in the Tree View. Files in the
                                root of the selected folder are shown by filename only and files
                                contained by folders in the selected folder are not displayed.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Show Paths</emphasis>
                        </term>
                        <listitem>
                            <para>This method of display is akin to a shell list view. Instead of
                                showing only the root contents of the selected folder all items are
                                recursively displayed. This enables the user to see all items and
                                paths under the selected folder. The result can be a very long list
                                of items, to show only files with a status of
                                &quot;changed&quot; the Show Paths view can be filtered
                                using the &view-flat-view-changed; option.</para>
                        </listitem>
                    </varlistentry>
                </variablelist>
                <note>
                    <para>The Show Paths mode is persistent on a per folder basis for the duration
                        of a session. Changing focus in the Tree View to a folder that does not have
                        Show Paths enabled will display the folder in Hide Paths mode in the File
                        View. When focus is changed back to a folder that has Show Paths mode
                        enabled the File View will continue to display items recursively. To revert
                        back to Hide Paths mode, selected the &view-flat-view; option again.</para>
                </note>
                <para>For each item the following information is displayed in columns for both
                    modes. Items can be ordered by column in ascending or descending order by
                    <action>clicking</action> the column title.</para>
                <variablelist>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Filename (Hide Paths mode)</emphasis>
                        </term>
                        <term>
                            <emphasis role="bold">Path and Filename (Show Paths mode)</emphasis>
                        </term>
                        <listitem>
                            <para>The name of the file or the path and name of the file, depending
                                on which mode is currently selected.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Status</emphasis>
                        </term>
                        <listitem>
                            <para>The status of the file, states include:</para>
                            <itemizedlist>
                                <listitem>
                                    <para>up-to-date</para>
                                </listitem>
                                <listitem>
                                    <para>modified</para>
                                </listitem>
                                <listitem>
                                    <para>out of date</para>
                                </listitem>
                                <listitem>
                                    <para>- unknown -</para>
                                </listitem>
                                <listitem>
                                    <para>- missing -</para>
                                </listitem>
                            </itemizedlist>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Revision</emphasis>
                        </term>
                        <listitem>
                            <para>The latest revision in the repository.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Last revision</emphasis>
                        </term>
                        <listitem>
                            <para>The last revision containing an a change.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Last updated</emphasis>
                        </term>
                        <listitem>
                            <para>The date and time of last up date.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Modified (local)</emphasis>
                        </term>
                        <listitem>
                            <para>The date and time of last modification made locally.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Author</emphasis>
                        </term>
                        <listitem>
                            <para>User name of <application>subversion</application> account that
                                performed a modification and did commit.</para>
                        </listitem>
                    </varlistentry>
                    <varlistentry>
                        <term>
                            <emphasis role="bold">Tag/Branch</emphasis>
                        </term>
                        <listitem>
                            <para>The trunk, tag or branch of the repository filesystem under which
                                the file resides. When the file resides in a <filename
                                class="directory">branch</filename> or a <filename
                                class="directory">tag</filename> folder the <inlinemediaobject>
                                    <imageobject>
                                        <imagedata fileref="images/b-16x16.png" format="PNG" scale="100"/>
                                    </imageobject>
                                </inlinemediaobject> or <inlinemediaobject>
                                    <imageobject>
                                        <imagedata fileref="images/t-16x16.png" format="PNG" scale="100"/>
                                    </imageobject>
                                </inlinemediaobject> icons are used respectively and the value is
                                change from trunk to branch or tag accordingly.</para>
                        </listitem>
                    </varlistentry>