/usr/share/doc/subcommander/html/ch02s02.html is in subcommander-doc 2.0.0~b5p2-6.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Projects & Bookmarks</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="index.html" title="The Subcommander Guide"><link rel="up" href="ch02.html" title="Chapter 2. subcommander"><link rel="prev" href="ch02s01.html" title="The Main Window"><link rel="next" href="ch02s03.html" title="The Commands"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Projects & Bookmarks</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s01.html">Prev</a> </td><th width="60%" align="center">Chapter 2. subcommander</th><td width="20%" align="right"> <a accesskey="n" href="ch02s03.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="idm368"></a>Projects & Bookmarks</h2></div></div></div><a class="indexterm" name="idm370"></a><p>The way to group repositories and working copies in subcommander is
a <span class="emphasis"><em>Project</em></span>.</p><p>A Project in subcommander can contain three special URLs to the
repository and any number of repository and working copy bookmarks. The
special URLs are the <span class="emphasis"><em>trunk</em></span> folder of the repository,
the <span class="emphasis"><em>branches</em></span> folder of the repository and the
<span class="emphasis"><em>tags</em></span> folder of the repository. Since subversions
branches and tags are only branches and tags by convention you have to
tell subcommander where they are placed in the repository. That way you
don't have to enter them every time you want to do something with a branch
or tag. Any other bookmark into a repository has no special
meaning.</p><p>The Projects are displayed in the Project Folders View (see <a class="xref" href="ch02s01.html" title="The Main Window">the section called “The Main Window”</a>).</p><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm380"></a>Adding a New Project</h3></div></div></div><a class="indexterm" name="idm382"></a><p>You can create a new project either by using the <span class="bold"><strong>new project..</strong></span> item from the <span class="bold"><strong>Project</strong></span> menu or by drag and drop. The menu item
will add a new project item to the Project Folder View and switch it to
edit mode so you can directly enter a name for the new project.</p><p>The other way to set up a new project is to use drag and drop. You
can simply drag an URL from another application (like a web browser) and
drop it into the Project Folder View (not on a project). Dropping the
URL will automatically create a new project and will ask which slot the
URL should fill. I.e. if the URL is the trunk, branches or tags
URL.</p><p>In the same way you can drop multiple local directories from a
file browser to the Project Folder View and tell subcommander to use the
directories as working copies. Each working copy gets the last section
of its path as the name in the project.</p><p>Adding, editing and deleting bookmarks from the new project can be
done by choosing the corresponding item from the context menus of a
project or a bookmark.</p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm391"></a>Modifying a Project</h3></div></div></div><a class="indexterm" name="idm393"></a><p>You can modify an existing project using the menu items in the
<span class="bold"><strong>Project</strong></span> menu or from the <span class="bold"><strong>Settings Dialog</strong></span>.</p><p>Open the dialog from the <span class="bold"><strong>Tools</strong></span>
menu and select the project from the <span class="emphasis"><em>Projects</em></span>
category to edit it. You can directly open the project page in the
settings dialog if you select the project and choose <span class="bold"><strong>project settings..</strong></span> from the Project menu.</p><div class="figure"><a name="idm403"></a><p class="title"><b>Figure 2.5. subcommander Project Settings</b></p><div class="figure-contents"><div class="mediaobject" align="center"><img src="images/Subcommander-ProjectSettings.png" align="middle" alt="subcommander Project Settings"></div></div></div><br class="figure-break"><p>To add folders, repository URLs or working copy paths, change to
the <span class="bold"><strong>project folders</strong></span> tab. Subcommander
can help you to fill the URLs for trunk, branches and tags. In case your
repository uses the standard repository layout (you don't have to) you
can enter the root URL of your repository as the URL for the
<span class="emphasis"><em>trunk type</em></span>. Select the trunk folder, normally the
first entry in the list view control, and enter the root URL in the edit
control below the list view. Then press <span class="bold"><strong>use
Standard Layout</strong></span> to automatically fill the URLs with the root
URL and an appended <code class="literal">trunk</code>,
<code class="literal">branches</code> and <code class="literal">tags</code> string.</p><p>You can also modify an URL by browsing the repository with
<span class="bold"><strong>browse Repository</strong></span>.</p><p>To add a working copy <span class="bold"><strong>Clear</strong></span> the
edit controls and change the <span class="bold"><strong>Project Folder
Type</strong></span> to working copy. Enter a name and a path and finally
press <span class="bold"><strong>Add</strong></span> to add the new working copy.
Selecting an existing working copy form the list view and pressing
<span class="bold"><strong>Add</strong></span> will duplicate it.</p><p>Another way of modifying a working copy path is by browsing the
filesystem with <span class="bold"><strong>browse
Filesystem</strong></span>.</p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm424"></a>Removing a Project</h3></div></div></div><a class="indexterm" name="idm426"></a><p>To remove a project select it in the Project Folder View and run
<span class="bold"><strong>remove</strong></span> from the Project menu.
Subcommander will request a confirmation that you really want to delete
the project so you don't remove it by accident.</p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm431"></a>Changing the Order of Projects</h3></div></div></div><a class="indexterm" name="idm433"></a><p>You can simply drag a project root item and drop it on another
project root item to move the source project to the location of the
target project in the Project Folder View.</p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm437"></a>Adding Bookmarks</h3></div></div></div><a class="indexterm" name="idm439"></a><p>To add a new working copy or to change one of the URLs in a
project you can use drag and drop in the same way you can create a new
project. The only difference is that you drop the URL or paths directly
on a project item. Subcommander will ask you where to place the dropped
URL or paths. An URL will overwrite an existing URL in the same slot and
working copies will be added to the project.</p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm443"></a>Modifying Bookmarks</h3></div></div></div><a class="indexterm" name="idm445"></a><p>Bookmark settings can be modified in the Bookmark Properties
Dialog. You cann edit its name, its path or URL and in the case of a
working copy you can activate the auto update option. Open the dialog by
selecting <span class="bold"><strong>edit..</strong></span> from the bookmark
menu.</p></div><div class="simplesect"><div class="titlepage"><div><div><h3 class="title"><a name="idm450"></a>Changing the Order of Bookmarks</h3></div></div></div><a class="indexterm" name="idm452"></a><p>To change the order of the bookmarks in a project simply drag a
bookmark and drop it onto its new position.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s01.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">The Main Window </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> The Commands</td></tr></table></div></body></html>
|