Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMatthias Sohn2011-12-21 18:54:20 -0500
committerMatthias Sohn2011-12-22 16:57:32 -0500
commit1f6b4b6347291e720ffb3ac69c816cf578820e8d (patch)
tree17d039de0ce7fc1a5cd2b1fb5480935a2feb4db0
parent093cc67cb66ad102cf4c7fa046f5223962540aa3 (diff)
downloadegit-1f6b4b6347291e720ffb3ac69c816cf578820e8d.tar.gz
egit-1f6b4b6347291e720ffb3ac69c816cf578820e8d.tar.xz
egit-1f6b4b6347291e720ffb3ac69c816cf578820e8d.zip
Update documentation for 1.2
Since some contributor refactored the User Guide in the wiki which broke the documentation build and a large number of hyperlinks this time the documentation generation was done against a hand-crafted copy of the split new pages in order to defer fixing the regressions introduced by splitting the wiki page until 1.2 release is ready. Change-Id: I874c9b3ac4773788d6f24a46c0c52d32625cbd2e Signed-off-by: Matthias Sohn <matthias.sohn@sap.com>
-rw-r--r--org.eclipse.egit.doc/build-help.xml4
-rw-r--r--org.eclipse.egit.doc/help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html52
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/1.1.html151
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html92
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/New-Actions.html80
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Dnd_patch.pngbin9174 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/EGit_logical_Selection.pngbin13308 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-commit-content-assist.pngbin19817 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-github-clone-wizard.pngbin16739 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-request-editor.pngbin44335 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-results.pngbin25061 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-push-results.pngbin14032 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-reflow-view.pngbin32048 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-staging-view.pngbin12153 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Mylyn_commit_links.pngbin13091 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/1.2.html130
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Bugs-Closed.html61
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Commits.html (renamed from org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Performance-Improvements.html)36
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Updating-This-Document.html (renamed from org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/Updating-This-Document.html)16
-rw-r--r--org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/images/Gist-from-console.pngbin0 -> 119032 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/Concepts.html4
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/Reference.html283
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/Tasks.html745
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/User-Guide.html132
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/EGit-0.12-SetupRepo-RepoStructureTwoProjects.jpgbin14087 -> 15974 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-history-commitmenu.pngbin12720 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-branchmenu.pngbin14119 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-fetchmenu.pngbin10876 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-pushmenu.pngbin10677 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-tagmenu.pngbin10918 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-worktreemenu.pngbin7444 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-project-menu.pngbin15550 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-repoview-repomenu.pngbin7718 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-resource-menu.pngbin7795 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuFolder.pngbin13543 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuSingleFile.pngbin1561 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuTwoFiles.pngbin3630 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-viewmenu.pngbin5660 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-project-menu.pngbin160023 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-repomenu.pngbin32530 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-resource-menu.pngbin32793 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags-history.pngbin0 -> 21260 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags.pngbin0 -> 10706 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-commit-dialog-path-assist.pngbin0 -> 3517 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-history-view-menu.pngbin0 -> 21508 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-2files-menu.pngbin0 -> 13646 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-file-menu.pngbin0 -> 3711 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-menu.pngbin0 -> 15237 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-advanced.pngbin0 -> 29910 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-main.pngbin0 -> 13888 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-remote.pngbin0 -> 5871 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-switchto.pngbin0 -> 11632 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-reflog-view.pngbin0 -> 18794 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-branch-menu.pngbin0 -> 8843 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-fetchconfig-menu.pngbin0 -> 9493 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-pushconfig-menu.pngbin0 -> 8351 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-repository-menu.pngbin0 -> 27145 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-tag-menu.pngbin0 -> 7147 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-workingtree-menu.pngbin0 -> 6744 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-resource-menu.pngbin0 -> 11796 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-staging-view.pngbin0 -> 18541 bytes
-rw-r--r--org.eclipse.egit.doc/help/EGit/User_Guide/images/RepoMgrPropertiesView.pngbin15902 -> 0 bytes
-rw-r--r--org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/1.2.html (renamed from org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/1.1.html)13
-rw-r--r--org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Bugs-Closed.html61
-rw-r--r--org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Commits.html (renamed from org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Features.html)33
-rw-r--r--org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Features.html71
-rw-r--r--org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Updating-This-Document.html (renamed from org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Updating-This-Document.html)16
-rw-r--r--org.eclipse.egit.doc/help/JGit/User_Guide/Concepts.html13
-rw-r--r--org.eclipse.egit.doc/help/JGit/User_Guide/Reference.html2
-rw-r--r--org.eclipse.egit.doc/help/toc.xml76
70 files changed, 1104 insertions, 967 deletions
diff --git a/org.eclipse.egit.doc/build-help.xml b/org.eclipse.egit.doc/build-help.xml
index 8befc5515..0cd2565f0 100644
--- a/org.eclipse.egit.doc/build-help.xml
+++ b/org.eclipse.egit.doc/build-help.xml
@@ -38,8 +38,8 @@
generateUnifiedToc="true">
<path name="EGit/User_Guide" title="EGit User Guide" />
<path name="JGit/User_Guide" title="JGit User Guide" />
- <path name="EGit/New_and_Noteworthy/1.1" title="EGit 1.1 New and Noteworthy" />
- <path name="JGit/New_and_Noteworthy/1.1" title="JGit 1.1 New and Noteworthy" />
+ <path name="EGit/New_and_Noteworthy/1.2" title="EGit 1.2 New and Noteworthy" />
+ <path name="JGit/New_and_Noteworthy/1.2" title="JGit 1.2 New and Noteworthy" />
<path name="EGit/Git_For_Eclipse_Users" title="Git for Eclipse Users" />
<stylesheet url="book.css" />
<pageAppendum>
diff --git a/org.eclipse.egit.doc/help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html b/org.eclipse.egit.doc/help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html
index f5b7f14d4..b1304fe7f 100644
--- a/org.eclipse.egit.doc/help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html
+++ b/org.eclipse.egit.doc/help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html
@@ -25,12 +25,12 @@
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
</table><hr/>
- <p>This post is aimed at those who have been using Eclipse for a while, and probably have been either using the baked-in CVS or external SVN providers to store their source code. The content of the post is about Git; what it means to you, as an Eclipse user – and specifically, how it affects how you obtain or work with projects from Eclipse.org.</p>
- <p>This post is not about the relative merits of Git over CVS/SVN, or of Git versus other distributed version control systems (DVCS) like Mercurial (Hg). There's other sites which can give those flavours if needed.</p>
- <p>Once you understand the conceptual differences between CVS/SVN and Git, and then subsequently start to use Git, you may find it very difficult to go back. You should only really start to experiment if you think you're going to migrate in the near future, because using Git is like watching TV in colour; once you've discovered it, it's really difficult to go back to black &amp; white.</p>
+ <p>This post is aimed at those who have been using Eclipse for a while, and probably have been using either the baked-in CVS or external SVN providers to store their source code. The content of the post is about Git: what it means to you, as an Eclipse user, and specifically, how it affects how you obtain or work with projects from Eclipse.org.</p>
+ <p>This post is not about the relative merits of Git over CVS/SVN, or of Git versus other distributed version control systems (DVCS) like Mercurial (Hg). Other sites can give those flavours if needed.</p>
+ <p>Once you understand the conceptual differences between CVS/SVN and Git, and then subsequently start to use Git, you may find it very difficult to go back. You should really start to experiment only if you think you're going to migrate in the near future, because using Git is like watching TV in colour: once you've discovered it, it's really difficult to go back to black &amp; white.</p>
<dl>
<dd>&#9758;
- <b>Once you start to use a DVCS, it's very difficult to want to go back</b>
+ <b>Once you start to use a DVCS, it's very unlikely you'll want to go back</b>
</dd>
</dl>
<h2 id="Centralised_version_control_systems">Centralised version control systems</h2>
@@ -38,16 +38,16 @@
<i>centralised</i> version control systems (CVCS). That is, there is one Master repository where people share code; everyone checks out their code (or branch) from that repository, and checks changes back in. For code that needs to be sent person-to-person (for example, for review, or as a way of contributing fixes), it is possible to create a
<i>patch</i>, which is a diff of your code against the given Master repository version (often HEAD, but sometimes a branch like Eclipse_35).
</p>
- <p>There are two problems that surface with a centralised version control system, although these problems aren't immediately apparent or obvious: </p>
+ <p>Two problems surface with a centralised version control system, although they aren't immediately obvious: </p>
<ul>
- <li>You need to be 'on-line' to perform actions, like diff or patch.<sup>*</sup> </li>
+ <li>You need to be 'online' to perform actions, like diff or patch.<sup>*</sup> </li>
<li>Patches generated against a particular branch can become outdated fairly quickly as development of the snapshot-in-time branch moves on (e.g. when it is time to apply the patch, HEAD is different than it was when the patch was generated).</li>
</ul>
- <p>The first problem is rarely apparent for those working with Eclipse in a location at (or near to) the repository itself. Those in the same continent will rarely experience delays due to global networking variance; in addition, they tend to be employed in an organisation and sit at a desktop connected to wired networking for most of the day. Road warriors (those with laptops and who code from the local coffee shop) tend to operate in a more frequently disconnected mode, which limits repository functionality to when they are connected.
- <i>(*A note on SVN: since SVN keeps the last-known-checkout, it's possible to do a limited set of operations while disconnected from SVN, like diff from the last-known-checkout. However, in general, you are prevented from doing many of the operations that are possible while connected.)</i>
+ <p>The first problem is rarely apparent for those working with Eclipse in a location at (or near) the repository itself. Those in the same continent will rarely experience delays due to global network variation; in addition, they tend to be employed in an organisation and sit at a desktop connected to wired networking for most of the day. Road warriors (those with laptops and who code from the local coffee shop) tend to operate in a more frequently disconnected mode, which limits repository functionality to when they are connected.
+ <i>(*A note on SVN: since SVN keeps the last-known checkout, it's possible to do a limited set of operations while disconnected from SVN, like diff from the last-known checkout. However, in general, you are prevented from doing many of the operations that are possible while connected.)</i>
</p>
- <p>The second problem is simply an artifact of the way in which patches work. These are generally performed against HEAD (a snapshot in time) and then applied later (sometimes months or even
- <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=4922" target="egit_external">eight years later</a>). Although they record the version of the file they were patched against, the patch itself is sensitive to big changes in the file, sometimes leading to the patch being inapplicable. Even relatively simple operations, like a file-rename, can throw a well-formed CVCS patch out of the window.
+ <p>The second problem is simply an artefact of the way in which patches work. These are generally performed against HEAD (a snapshot in time) and then applied later (sometimes months or even
+ <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=4922" target="egit_external">eight years later</a>). Although they record the version of the file they were patched against, the patch itself is sensitive to big changes in the file, sometimes leading to the patch's being inapplicable. Even relatively simple operations, like a file rename, can throw a well-formed CVCS patch out of the window.
</p>
<h2 id="Distributed_Version_Control_Systems">Distributed Version Control Systems</h2>
<p>Distributed Version Control Systems (DVCS) are a family of version control systems unlike those with which many are familiar. Two of the most popular are
@@ -55,7 +55,7 @@
<a href="http://mercurial.selenic.com" target="egit_external">Hg</a>, although others (
<a href="http://darcs.net/" target="egit_external">Darcs</a>,
<a href="http://bazaar.canonical.com/en/" target="egit_external">Bazaar</a>,
- <a href="http://www.bitkeeper.com/" target="egit_external">Bitkeeper</a>, etc.) exist. In a DVCS each user has a complete copy of the repository, including its entire history. A user may potentially push changes to or pull changes from any other repository. Although policy may confer special status to one or more repositories, in principle every repository is a first-class citizen in the DVCS model. This stands in contrast to a centralised version control system, where every individual checks files into and out of an authoritative repository.
+ <a href="http://www.bitkeeper.com/" target="egit_external">Bitkeeper</a>, etc.) exist. In a DVCS each user has a complete copy of the repository, including its entire history. A user may potentially push changes to or pull changes from any other repository. Although policy may confer special status on one or more repositories, in principle every repository is a first-class citizen in the DVCS model. This stands in contrast to a centralised version control system, where every individual checks files into and out of an authoritative repository.
</p>
<dl>
<dd>&#9758;
@@ -76,29 +76,29 @@
<a href="http://sourceforge.net/projects/rcpapps/files/maclipse/" target="egit_external">Maclipse</a>. The key thing here is that whilst forks are possible,
<i>forking is not a bad thing in itself</i>. After all, look at Linux and Android; originally, they shared a history, but are now different. XFree86 and X.Org
<a href="http://www.x.org/wiki/XorgFoundation" target="egit_external">split</a> over licensing issues. MySQL was forked to create
- <a href="http://askmonty.org/wiki/index.php/MariaDB" target="egit_external">MariaDB</a>, and so on.The key thing about forks is that the best survive. X.Org is now the default X client, whereas XFree86 was the default beforehand. The jury is still out on MySQL versus MariaDB. And although Maclipse has been downloaded literally <span title="Actually, about one and a half thousand. That&#39;s more than I expected.">tens of times</span>, it hasn't caused a dent in Eclipse's growth.
+ <a href="http://askmonty.org/wiki/index.php/MariaDB" target="egit_external">MariaDB</a>, and so on. The key thing about forks is that the best survive. X.Org is now the default X client, whereas XFree86 was the default beforehand. The jury is still out on MySQL versus MariaDB. And although Maclipse has been downloaded literally <span title="Actually, about one and a half thousand. That&#39;s more than I expected.">tens of times</span>, it hasn't caused a dent in Eclipse's growth.
<dl>
<dd>&#9758;
<b>Forks happen</b>
</dd>
</dl>
</li>
- <li>Do not try to bend the <span title="spoon">master repository</span> – that's impossible. Instead, only try to realise the truth; there is no <span title="spoon">master repository</span>. In fact, there's a veritable matrix of master repositories possible. Each repository can be considered a node in a graph; nodes in the graph can be connected to each other in any way. However, rather than an n-n set of links, the graph usually self-organises into a tree-like structure, logically associating with one point that acts as a funnel for everything else. In a sense, that's a master repository – everyone has already made the choice; now you have to understand it. Should an oracle intervene, a neo-master can be chosen.
+ <li>Do not try to bend the <span title="spoon">master repository</span> – that's impossible. Instead, try only to realise the truth; there is no <span title="spoon">master repository</span>. In fact, there's a veritable matrix of master repositories possible. Each repository can be considered a node in a graph; nodes in the graph can be connected to each other in any way. However, rather than an n-n set of links, the graph usually self-organises into a tree-like structure, logically associating with one point that acts as a funnel for everything else. In a sense, that's a master repository – everyone has already made the choice; now you have to understand it. Should an oracle intervene, a neo-master can be chosen.
<dl>
<dd>&#9758;
<b>There is no master repository</b>
</dd>
</dl>
</li>
- <li>Having accepted that there is no master repository, it becomes clear that the repository must live in its entirety on each of the nodes in the DVCS. This usually leads to fears about the size of the repository, even taking into account the fact that storage is cheap.A key point here is that DVCS repositories are usually far
- <i>smaller</i> than their counterpart CVCS repositories, not least of which is because everyone has to have a full repository in order to do any work. It's a natural consequence that they're smaller. However, they're also smaller because each repository contains far less scope than a CVCS repository. For example, most organisations will have one mammoth CVCS repository with several thousand top-level 'modules' (or 'projects') underneath. Because of the administrative overhead with 'creating a new repository', it is often easier to reuse the same one for everything. (SVN put some limits on how wide it could grow, which CVS tended not to have; but even so, the main
- <a href="http://svn.apache.org/viewvc?view=revision&amp;revision=908283" target="egit_external">Apache SVN</a> is over 900k revisions.) By contrast, setting up a DVCS is usually nothing more than a directory with a few administrative files inside. It doesn't require administrator privileges or specific ports; in fact, since there's no central server to speak of, it doesn't even need to be shared by network protocols. As a result, a DVCS repository is much more granular – and easy to create – than a traditional CVCS repository. Firstly, it's always on your machine (there's no centralised server to configure) and secondly, all you need access to is a file system. So typically, a DVCS “repository” will often be at the level of an Eclipse project or project working set. For example, although the [
+ <li>Given that there is no master repository, it becomes clear that the repository must live in its entirety on each of the nodes in the DVCS. This usually leads to fears about the size of the repository, even taking into account that storage is cheap. A key point here is that DVCS repositories are usually far
+ <i>smaller</i> than their counterpart CVCS repositories, not least of the reasons for which being that everyone has to have a full repository in order to do any work. It's a natural consequence that they're smaller. However, they're smaller also because each repository contains far less scope than a CVCS repository. For example, most organisations will have one mammoth CVCS repository with several thousand top-level 'modules' (or 'projects') underneath. Because of the administrative overhead of 'creating a new repository', it is often easier to reuse the same one for everything. (SVN put some limits on how wide it could grow, which CVS tended not to have; but even so, the main
+ <a href="http://svn.apache.org/viewvc?view=revision&amp;revision=908283" target="egit_external">Apache SVN</a> is over 900k revisions.) By contrast, a DVCS is usually nothing more than a directory with a few administrative files inside. It doesn't require administrator privileges or specific ports; in fact, since there's no central server to speak of, it doesn't even need to be shared by network protocols. As a result, a DVCS repository is much more granular – and easy to create – than a conventional CVCS repository. Firstly, it's always on your machine (there's no centralised server to configure) and secondly, all you need access to is a file system. So typically, a DVCS “repository” will often be at the level of an Eclipse project or project working set. For example, although the [
<a href="http://dev.eclipse.org/viewcvs/index.cgi/?root=RT_Project" target="egit_external">http://dev.eclipse.org/viewcvs/index.cgi/?root=RT_Project</a> CVS <span title="RunTime">RT</span> repository] is shared by
<a href="http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.equinox/?root=RT_Project" target="egit_external">Equinox</a> and
<a href="http://dev.eclipse.org/viewcvs/index.cgi/org.eclipse.ecf/?root=RT_Project&amp;view=log" target="egit_external">ECF</a>, a DVCS-based solution would almost certainly see the Equinox and ECF projects in their own repositories; perhaps, even breaking down further into (say) ECF-Doc and ECF-Bundles. Think of a DVCS repository as one or a few Eclipse projects instead of hundreds of projects together.
<dl>
<dd>&#9758;
- <b>DVCS repositories are much smaller, typically because they only contain a small number of highly-related projects</b>
+ <b>DVCS repositories are much smaller, typically because they contain only a small number of highly-related projects</b>
</dd>
</dl>
</li>
@@ -119,7 +119,7 @@
</p>
<p>This doesn't work in a DVCS. Because there is no central repository, there is no central repository version number (either for the repository as a whole, or for individual files).</p>
<p>Instead, a DVCS operates at the level of a
- <i>changeset</i>. Logically, a repository is made up from an initial (empty) state, followed by many changesets. (A changeset is merely a change to a set of files; if you think 'patch' from CVS or SVN, then you're not far off.)
+ <i>changeset</i>. Logically, a repository is made up of an initial (empty) state, followed by many changesets. (A changeset is merely a change to a set of files; if you think 'patch' from CVS or SVN, you're not far off.)
</p>
<p>Identifying a changeset is much harder. We can't use a (global) revision number, because that concept isn't used. Instead, a changeset is represented as a hash of its contents. For example, given the changeset:</p>
<pre>--- a/README.txt
@@ -128,13 +128,13 @@
-SVN is great
+Git is great
</pre>
- <p>then we can create a 'hash' using (for example) <code>md5</code>, to generate the string <code>0878a8189e6a3ae1ded86d9e9c7cbe3f</code>. When referring to our change with others, we can use this hash to identify the change in question.</p>
+ <p>we can create a 'hash' using (for example) <code>md5</code>, to generate the string <code>0878a8189e6a3ae1ded86d9e9c7cbe3f</code>. When referring to our change with others, we can use this hash to identify the change in question.</p>
<dl>
<dd>&#9758;
<b>Changesets are identified by a hash of their contents</b>
</dd>
</dl>
- <p>Clearly, though, this doesn't work on its own. What happens if we do the same change later on? It would have the same change, and so we don't want the same hash value.</p>
+ <p>Clearly, though, this doesn't work on its own. What happens if we do the same change later on? It would have the same change, and we don't want the same hash value.</p>
<p>What happens is that a changeset contains two things; the change itself, and a back-pointer to the previous changeset. In other words, we end up with something like:</p>
<pre>previous: 48b2179994d494485b79504e8b5a6b23ce24a026
--- a/README.txt
@@ -174,7 +174,7 @@
</pre>
<p>Each time, the value of the changeset includes a pointer to what comes before, so the hash is continually changing.</p>
<p>
- <b>''Note</b>: Rather than using <code>md5</code>, as shown here, most DVCS (including Git) use an <code>sha1</code> hash instead. Also, the exact way that the prior elements in the tree are stored, and their relationships, isn't accurately portrayed above; however, it gives the idea of how they are organised sufficiently well.''
+ <b>''Note</b>: Rather than using <code>md5</code>, as shown here, most DVCS (including Git) use an <code>sha1</code> hash instead. Also, the exact way that the prior elements in the tree are stored, and their relationships, isn't accurately portrayed above; however, it gives sufficiently well the idea of how they are organised.''
</p>
<dl>
<dd>&#9758;
@@ -200,7 +200,7 @@
<b>The tip of the current branch is referred to as 'HEAD</b>'
</dd>
</dl>
- <p>As a direct corollary from this, creating branches in a DVCS is fast. All that happens is the repository on disk is updated to point to a different element in the (already physically present) tree, and you're good to go. Furthermore, it's trivial to ping-pong between different branches on the same repository, which can contain different states and evolve independently.</p>
+ <p>As a direct corollary to this, creating branches in a DVCS is fast. All that happens is that the repository on disk is updated to point to a different element in the (already physically present) tree, and you're done. Furthermore, it's trivial to ping-pong between different branches on the same repository that may contain different states and evolve independently.</p>
<dl>
<dd>&#9758;
<b>Creating, and switching between, branches is fast</b>
@@ -225,7 +225,7 @@
</dd>
</dl>
<p>Fortunately, DVCSs are all about merging. Given that each node in the changeset tree contains a pointer to its previous node (and transitively, to the beginning of time), it's much more powerful than the standard flat CVCS diff. In other words, not only do you know what changes need to be made, but also
- <i>what point in history they need to be made</i>. So, if you have a changeset which renames a file, and then merge in a changeset which points to the file as it was before it was renamed, then a CVCS will just fall over; but a DVCS will be able to apply the change
+ <i>what point in history they need to be made</i>. So, if you have a changeset that renames a file, and then merge in a changeset that points to the file as it was before it was renamed, a CVCS will just fall over; but a DVCS will be able to apply the change
<i>before</i> the rename occurred, and then play forward the changes.
</p>
<p>Merges are just the weaving together of two (or more) local branches into one. The
@@ -248,7 +248,7 @@
<p>The last case is only slightly more tricky; a common ancestor must be found; say, <code>746d6c</code>. Then I send changes between my tip and <code>746d6c</code>, and you send changes between your tip and <code>746d6c</code>. That way, we both end up with the same contents on our repositories.</p>
<p>Changes flow between repositories by
<i>push</i> and
- <i>pull</i> operations. In essence, it doesn't matter whether I push my changes to you, or you pull my changes from me; the net result is the same. However, in the case of Eclipse.org infrastructure, it's likely that a central Git repository will only be writable by Eclipse committers. Thus, if I contribute a fix, I can ask a committer to pull the fix from my repository, and then they (after reviewing, and optionally rebasing) can push the fix to the Eclipse.org repository.
+ <i>pull</i> operations. In essence, it doesn't matter whether I push my changes to you, or you pull my changes from me; the net result is the same. However, in the case of Eclipse.org infrastructure, it's likely that a central Git repository will be writable only by Eclipse committers. Thus, if I contribute a fix, I can ask a committer to pull the fix from my repository, and then they (after reviewing, and optionally rebasing) can push the fix to the Eclipse.org repository.
</p>
<p>The best part of a DVCS is that it takes care of all the paperwork for you. You don't need to use SVN-like <code>314:321</code> tags to remind you where you branched from; you don't even have to worry if you haven't updated recently. It all just works.</p>
<dl>
@@ -282,14 +282,14 @@ git push github
</dd>
</dl>
<h2 id="Initialising.2C_committing_and_branching">Initialising, committing and branching</h2>
- <p>To create a new Git repository, the <code>git init</code> command is used. This creates an empty repository in the current directory. They can, but often don't, end with <code>.git</code> – typically it's only repositories pushed to remote servers that use the <code>.git</code> extension. As noted above, a Git repository should ideally only hold one or a few highly related/coupled projects.</p>
+ <p>To create a new Git repository, the <code>git init</code> command is used. This creates an empty repository in the current directory. They can, but often don't, end with <code>.git</code> – typically it's only repositories pushed to remote servers that use the <code>.git</code> extension. As noted above, a Git repository should ideally hold only one or a few highly related/coupled projects.</p>
<dl>
<dd>&#9758;
<b>'git init' creates a fresh repository in the current directory</b>
</dd>
</dl>
<p>Git allows you to commit files, much like any other VCS. Each commit may be a single file, or many files; and a message goes along with it. Unlike other VCS, Git has a separate concept of an
- <i>index</i>, which is a set of files that would be committed. You can think of it as an active changeset; as you're working on multiple files, you only want some changes to be committed as a unit. These files get <code>git add</code>ed to the index first, then <code>git commit</code>ted subsequently. (If you don't like this behaviour, there's a <code>git commit -a</code> option, which performs like CVS or SVN would.)
+ <i>index</i>, which is a set of files that would be committed. You can think of it as an active changeset; as you're working on multiple files, you want only some changes to be committed as a unit. These files get <code>git add</code>ed to the index first, then <code>git commit</code>ted subsequently. (If you don't like this behaviour, there's a <code>git commit -a</code> option, which performs as CVS or SVN would.)
</p>
<dl>
<dd>&#9758;
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/1.1.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/1.1.html
deleted file mode 100644
index accd83689..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/1.1.html
+++ /dev/null
@@ -1,151 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>EGit 1.1 New and Noteworthy</title>
- <link type="text/css" rel="stylesheet" href="../../../book.css"/>
- </head>
- <body>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <th style="width: 100%" align="center" colspan="3">EGit 1.1 New and Noteworthy</th>
- </tr>
- <tr>
- <td style="width: 20%" align="left"></td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right">
- <a href="New-Actions.html" title="New Actions">
- <img alt="Next" border="0" src="../../../images/next.gif"/>
- </a>
- </td>
- </tr>
- <tr>
- <td style="width: 20%" align="left" valign="top"></td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">New Actions</td>
- </tr>
- </table><hr/>
- <h1 id="New_Features">New Features</h1>
- <h2 id="New_Reflog_View">New Reflog View</h2>
- <ul>
- <li>Shows the Git reflog for a selected repository</li>
- <li>Supports showing the reflog for a specific branch by selecting the hyperlink ref name in the top right of the view</li>
- <li>Supports searching and filtering</li>
- <li>Double-clicking a reflog entry opens the corresponding
- <i>To</i> commit
- </li>
- </ul>
- <p>
- <img border="0" src="images/Egit11-reflow-view.png"/>
- </p>
- <h2 id="Allow_dragging_of_commits_from_History_view">Allow dragging of commits from History view</h2>
- <p>You're now able to Drag and drop commits either onto a Mylyn Task or into a folder on your harddisk. In both cases, EGit will automatically create a patch for you to attach it on the bug or to create a patchfile on your harddisk.</p>
- <p>
- <img border="0" src="images/Dnd_patch.png"/>
- </p>
- <h2 id="New_preference_to_ignore_whitespace_changes_in_blame_annotations">New preference to ignore whitespace changes in blame annotations</h2>
- <h2 id="History_View_always_displays_HEAD_and_other_additional_refs">History View always displays HEAD and other additional refs</h2>
- <h2 id="More_information_displayed_in_merge.2C_fetch_and_push_results_dialogs">More information displayed in merge, fetch and push results dialogs</h2>
- <ul>
- <li>Commits and modified files displayed in fetch, push, and pull and push result dialogs</li>
- <li>Commit details such as author and date are now displayed for merge results</li>
- <li>Icons displayed for different ref update types (new tag, new branch, etc.)</li>
- <li>Push result messages now support hyperlinks</li>
- </ul>
- <p>
- <img border="0" src="images/Egit11-pull-results.png"/>
- </p>
- <p>
- <img border="0" src="images/Egit11-push-results.png"/>
- </p>
- <h2 id="Commit_Dialog_Improvements">Commit Dialog Improvements</h2>
- <ul>
- <li>Support for commit ID hyperlinks</li>
- <li>Content assist for file names shown in
- <i>Files</i> section
- </li>
- </ul>
- <p>
- <img border="0" src="images/Egit11-commit-content-assist.png"/>
- </p>
- <h2 id="Staging_View">Staging View</h2>
- <ul>
- <li>New column layout preference that supports showing the
- <i>Unstaged Changes</i> and
- <i>Staged Changes</i> sections side by side
- </li>
- <li>New preference for showing the file names first followed by the directory that the files are located in</li>
- </ul>
- <p>
- <img border="0" src="images/Egit11-staging-view.png"/>
- </p>
- <h2 id="New_Features_in_Synchronize_View">New Features in Synchronize View</h2>
- <ul>
- <li>Synchronize filtered on folder</li>
- <li>drag and drop staging / unstaging in Git Changeset Model (
- <a href="http://www.youtube.com/watch?v=MU9eaf_rSWw" target="egit_external">demonstration on youtube</a>)
- </li>
- <li>new "Fetch Changes" checkbox in synchronize wizard</li>
- <li>Performance improvements</li>
- <li>"Synchronize Wizard" allow select additional refs like FETCH_HEAD</li>
- <li>"Synchronize With..." menu item moved into "Advanced" section</li>
- </ul>
- <h2 id="Team_Project_Set_Support">Team Project Set Support</h2>
- <p>It's now possible to export and import Git projects with team project set files (.psf). This enables easier workspace setup, especially with many repositories and/or with different branches. How it works:</p>
- <ul>
- <li>Select the projects you want to export</li>
- <li>Right click on the selection and chose
- <i>Export</i>
- </li>
- <li>Select
- <i>Team Project Set</i>
- </li>
- <li>Fill in the details such as where the
- <i>.psf</i> file should be saved and finish the wizard
- </li>
- </ul>
- <p>This creates a file with all the information that is necessary for Eclipse to reconstruct the project setup. It contains the URLs of the Git repositories, the branch to checkout, and the paths to the projects. Creating a new workspace is as easy as:</p>
- <ul>
- <li>Go to
- <i>File</i> -&gt;
- <i>Import</i>
- </li>
- <li>Select
- <i>Team Project Set</i>
- </li>
- <li>Select the
- <i>.psf</i> file
- </li>
- </ul>
- <p>Eclipse will clone the repositories into the workspace location, check out the right branches and import the projects, ready for creating new commits and pushing.</p>
- <h2 id="Logical_Model_Support">Logical Model Support</h2>
- <p>In case you're working with files that are supported by a Logical Model Provider (eg. EMF Compare for .ecore, or other commercial modeling tools), EGit now detects these cases during staging, replacing and commiting changes and will help you to choose the right set of files to work on.</p>
- <p>
- <img border="0" src="images/EGit_logical_Selection.png"/>
- </p>
- <p>For some background information on Logical Models, see this blog post:
- <a href="http://tasktop.com/blog/eclipse/what-the-heck-are-logical-models" target="egit_external">What the heck are Logical Models</a>
- </p>
- <h2 id="Navigating_from_tasks_to_commits">Navigating from tasks to commits</h2>
- <p>With the Mylyn/EGit bridge installed, you're now able to see commit ids in tasks (eg. Bugzilla) hyperlinked. Once clicked, the corresponding commit will open up in the Commit Editor.</p>
- <p>
- <img border="0" src="images/Mylyn_commit_links.png"/>
- </p><hr/>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <td style="width: 20%" align="left"></td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right">
- <a href="New-Actions.html" title="New Actions">
- <img alt="Next" border="0" src="../../../images/next.gif"/>
- </a>
- </td>
- </tr>
- <tr>
- <td style="width: 20%" align="left" valign="top"></td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">New Actions</td>
- </tr>
- </table>
- </body>
-</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html
deleted file mode 100644
index 4d2f1c21a..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html
+++ /dev/null
@@ -1,92 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>EGit 1.1 New and Noteworthy - GitHub Mylyn Connector</title>
- <link type="text/css" rel="stylesheet" href="../../../book.css"/>
- </head>
- <body>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <th style="width: 100%" align="center" colspan="3">GitHub Mylyn Connector</th>
- </tr>
- <tr>
- <td style="width: 20%" align="left">
- <a href="New-Actions.html" title="New Actions">
- <img alt="Previous" border="0" src="../../../images/prev.gif"/>
- </a>
- </td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right">
- <a href="Updating-This-Document.html" title="Updating This Document">
- <img alt="Next" border="0" src="../../../images/next.gif"/>
- </a>
- </td>
- </tr>
- <tr>
- <td style="width: 20%" align="left" valign="top">New Actions</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">Updating This Document</td>
- </tr>
- </table><hr/>
- <h1 id="GitHub_Mylyn_Connector">GitHub Mylyn Connector</h1>
- <h2 id="Pull_Request_Support">Pull Request Support</h2>
- <ul>
- <li>Pull Requests can now be added as a Mylyn Task Repository type</li>
- <li>The Pull Request task editor displays the commits and supports opening commits in the EGit commit viewer</li>
- </ul>
- <p>
- <img border="0" src="images/Egit11-pull-request-editor.png"/>
- </p>
- <h2 id="Import_and_Clone">Import and Clone</h2>
- <ul>
- <li>Projects can now be cloned using the new
- <b>Import &gt; Git &gt; Repositories from GitHub</b> wizard
- </li>
- <li>Projects cloned will appear in the
- <i>Git Repositories</i> view once the clone has completed
- </li>
- </ul>
- <p>
- <img border="0" src="images/Egit11-github-clone-wizard.png"/>
- </p>
- <h2 id="GitHub_Java_API">GitHub Java API</h2>
- <ul>
- <li>The GitHub Java API now supports the entire
- <a href="http://developer.github.com" target="egit_external">GitHub v3 API</a>
- </li>
- <li>The README is available
- <a href="http://egit.eclipse.org/w/?p=egit-github.git;a=blob_plain;f=org.eclipse.egit.github.core/README.md;hb=refs/heads/stable-1.1" target="egit_external">here</a>
- <ul>
- <li>Rendered version available
- <a href="https://github.com/eclipse/egit-github/tree/stable-1.1/org.eclipse.egit.github.core#readme" target="egit_external">here</a>
- </li>
- </ul>
- </li>
- </ul><hr/>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <td style="width: 20%" align="left">
- <a href="New-Actions.html" title="New Actions">
- <img alt="Previous" border="0" src="../../../images/prev.gif"/>
- </a>
- </td>
- <td style="width: 60%" align="center">
- <a href="1.1.html" title="EGit 1.1 New and Noteworthy">
- <img alt="EGit 1.1 New and Noteworthy" border="0" src="../../../images/home.gif"/>
- </a>
- </td>
- <td style="width: 20%" align="right">
- <a href="Updating-This-Document.html" title="Updating This Document">
- <img alt="Next" border="0" src="../../../images/next.gif"/>
- </a>
- </td>
- </tr>
- <tr>
- <td style="width: 20%" align="left" valign="top">New Actions</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">Updating This Document</td>
- </tr>
- </table>
- </body>
-</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/New-Actions.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/New-Actions.html
deleted file mode 100644
index 5e8c20d91..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/New-Actions.html
+++ /dev/null
@@ -1,80 +0,0 @@
-<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>EGit 1.1 New and Noteworthy - New Actions</title>
- <link type="text/css" rel="stylesheet" href="../../../book.css"/>
- </head>
- <body>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <th style="width: 100%" align="center" colspan="3">New Actions</th>
- </tr>
- <tr>
- <td style="width: 20%" align="left">
- <a href="1.1.html" title="EGit 1.1 New and Noteworthy">
- <img alt="Previous" border="0" src="../../../images/prev.gif"/>
- </a>
- </td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right">
- <a href="GitHub-Mylyn-Connector.html" title="GitHub Mylyn Connector">
- <img alt="Next" border="0" src="../../../images/next.gif"/>
- </a>
- </td>
- </tr>
- <tr>
- <td style="width: 20%" align="left" valign="top">EGit 1.1 New and Noteworthy</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">GitHub Mylyn Connector</td>
- </tr>
- </table><hr/>
- <h1 id="New_Actions">New Actions</h1>
- <ul>
- <li>Staging View
- <ul>
- <li>unstaged pane: "Add to Git Index", "Replace with File in Git Index", "Open Working Tree Version"</li>
- <li>staged pane: "Open Working Tree Version", "Remove from Git Index"</li>
- </ul>
- </li>
- <li>Double-click opening of commits in push result table</li>
- <li>Synchronize View
- <ul>
- <li>"Mark as Merged"</li>
- <li>"Open Merge Tool"</li>
- </ul>
- </li>
- <li>"Open Properties &gt; Git" on Eclipse project now displays link to current HEAD</li>
- <li>Repositories View
- <ul>
- <li>"Show In &gt; Reflog" on repository nodes</li>
- <li>Enable "Synchronize with Each Other" when two ref or tag nodes are selected</li>
- </ul>
- </li>
- </ul><hr/>
- <table class="navigation" style="width: 100%;" border="0" summary="navigation">
- <tr>
- <td style="width: 20%" align="left">
- <a href="1.1.html" title="EGit 1.1 New and Noteworthy">
- <img alt="Previous" border="0" src="../../../images/prev.gif"/>
- </a>
- </td>
- <td style="width: 60%" align="center">
- <a href="1.1.html" title="EGit 1.1 New and Noteworthy">
- <img alt="EGit 1.1 New and Noteworthy" border="0" src="../../../images/home.gif"/>
- </a>
- </td>
- <td style="width: 20%" align="right">
- <a href="GitHub-Mylyn-Connector.html" title="GitHub Mylyn Connector">
- <img alt="Next" border="0" src="../../../images/next.gif"/>
- </a>
- </td>
- </tr>
- <tr>
- <td style="width: 20%" align="left" valign="top">EGit 1.1 New and Noteworthy</td>
- <td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">GitHub Mylyn Connector</td>
- </tr>
- </table>
- </body>
-</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Dnd_patch.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Dnd_patch.png
deleted file mode 100644
index 921ca683c..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Dnd_patch.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/EGit_logical_Selection.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/EGit_logical_Selection.png
deleted file mode 100644
index e02e36b98..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/EGit_logical_Selection.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-commit-content-assist.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-commit-content-assist.png
deleted file mode 100644
index 9f48fc8bb..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-commit-content-assist.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-github-clone-wizard.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-github-clone-wizard.png
deleted file mode 100644
index a117ec6d0..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-github-clone-wizard.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-request-editor.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-request-editor.png
deleted file mode 100644
index 24dc70d2e..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-request-editor.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-results.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-results.png
deleted file mode 100644
index 4d52bffe9..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-pull-results.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-push-results.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-push-results.png
deleted file mode 100644
index 212dd0568..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-push-results.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-reflow-view.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-reflow-view.png
deleted file mode 100644
index 690120f02..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-reflow-view.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-staging-view.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-staging-view.png
deleted file mode 100644
index ed1005426..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Egit11-staging-view.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Mylyn_commit_links.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Mylyn_commit_links.png
deleted file mode 100644
index bebd2d732..000000000
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/images/Mylyn_commit_links.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/1.2.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/1.2.html
new file mode 100644
index 000000000..c3c2907b1
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/1.2.html
@@ -0,0 +1,130 @@
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>EGit 1.2 New and Noteworthy</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">EGit 1.2 New and Noteworthy</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Bugs Closed</td>
+ </tr>
+ </table><hr/>
+ <h1 id="New_Features">New Features</h1>
+ <h2 id="Improved_decorator_performance">Improved decorator performance</h2>
+ <ul>
+ <li>An IndexDiff cache and a new resource decorator have been implemented to improve performance of resource decoration.</li>
+ </ul>
+ <h2 id="Support_for_project_rename_and_move_for_some_cases">Support for project rename and move for some cases</h2>
+ <p>EGit can now move and rename projects within a repository for a number
+ of cases. Moving a project to a subdirectory does not work and since
+ Eclipse actually destroys the project, we simply forbid it for now
+ (Platform bug 307140). The bug is only worked around in Eclipse 3.7,
+ i.e. forbidden in the UI.</p>
+ <h2 id="Option_to_auto-share_projects_on_import_when_located_in_a_working_tree">Option to auto-share projects on import when located in a working tree</h2>
+ <p>When the new preference
+ <b>Team &gt; Git Projects &gt; Auto share project located in a git repository</b> is enabled projects which are located in the working tree of a git repository are automatically shared with the Git team provider when the project is imported into the workspace.
+ </p>
+ <h2 id="Interactive_adding_in_Compare_Editors">Interactive adding in Compare Editors</h2>
+ <p>You can stage only part of file and save it in git index. Also reverting selected hunk of code (from git index to working tree and from HEAD to working tree) is supported. For more detailed description you can watch this
+ <a href="http://www.youtube.com/watch?v=d94RI9QA-RU" target="egit_external">example movie</a>
+ </p>
+ <h2 id="Repositories_View">Repositories View</h2>
+ <h3 id="Pull_with_multi-selection">Pull with multi-selection</h3>
+ <p>The
+ <b>Pull</b> command now also works if resources are selected from more than one repository.
+ </p>
+ <h3 id="Property_page_for_repository_configuration">Property page for repository configuration</h3>
+ <p>In the Git Repositories view, there is a new
+ <b>Properties</b> action in the context menu, which will open a configuration dialog allowing to edit the Repository Configuration. Here, key value pairs can be added, changed or deleted. The
+ <b>Open</b> button allows to open the Repository Configuration file in a text editor.
+ </p>
+ <h3 id="Delete_tag_command">Delete tag command</h3>
+ <p>On a tag, you may now click
+ <b>Delete Tag</b> to delete a tag.
+ </p>
+ <h3 id="Drag_file_from_working_tree_to_open_editor">Drag file from working tree to open editor</h3>
+ <p>Files can now be opened by dragging them from the Working Directory to the Editor Area.</p>
+ <h2 id="History_View">History View</h2>
+ <h3 id="Option_to_follow_renames">Option to follow renames</h3>
+ <p>The new Preference
+ <b>Preferences &gt; Team &gt; Git &gt; Views &gt; Follow Renames</b> allows to toggle whether renames of a selected resource should be followed in the History View, if the "Resource" filter is used. This preference can also be configured from the History View's menu
+ <b>Show &gt; Follow Renames</b>
+ </p>
+ <h3 id="Delete_Branch_Command">Delete Branch Command</h3>
+ <p>In the commit graph area, there is a new context menu action "Delete Branch" allowing to delete a branch. It will be enabled if a branch exists for the currently selected commit, which is not checked out. If there is a single branch on this commit, which is not checked out, this action will delete this branch immediately. If multiple such branches exist, a dialog will be shown asking which branches should be deleted. If commits become unreachable on "Delete Branch" a confirmation dialog will be shown to prevent accidental unreachability of commits.</p>
+ <h3 id="Show_annotations_from_file_table_in_history_view">Show annotations from file table in history view</h3>
+ <p>In the revision details area, there is a new context menu action
+ <b>Show Annotations</b>. On selected files it will open the file in a (read-only) editor and display an annotation ruler with commit and author information ("blame annotations") for each line in a file.
+ </p>
+ <h2 id="Reflog_View">Reflog View</h2>
+ <h3 id="Show_Timestamp_and_Commit_Short_Message">Show Timestamp and Commit Short Message</h3>
+ <p>A reflog entry now additionally shows the timestamp of the reflog entry and the short message of the associated commit.</p>
+ <h3 id="New_Commands">New Commands</h3>
+ <p>The new context menu action
+ <b>Checkout</b> will checkout the selected commit and the HEAD will become detached. The new action
+ <b>Open in Commit Viewer</b> will open the commit matching the reflog entry, the same action can be triggered by double-clicking the reflog entry.
+ </p>
+ <h2 id="Commit_Editor">Commit Editor</h2>
+ <h3 id="Checkout_Command">Checkout Command</h3>
+ <p>A new
+ <b>Checkout</b> button allows to check out the commit displayed in the commit viewer. The HEAD pointer will become detached.
+ </p>
+ <h3 id="Cherry-Pick_Command">Cherry-Pick Command</h3>
+ <p>A new
+ <b>Cherry-Pick</b> button allows to cherry-pick the displayed commit. This applies the change introduced by the displayed commit on top of the currently checked out commit or branch.
+ </p>
+ <h2 id="GitHub_Mylyn_Connector">GitHub Mylyn Connector</h2>
+ <ul>
+ <li>You can now create Gists from selections in the
+ <b>Console</b> view.
+ </li>
+ </ul>
+ <p>
+ <img border="0" src="images/Gist-from-console.png"/>
+ </p>
+ <ul>
+ <li>Support for
+ <a href="https://enterprise.github.com/" target="egit_external">GitHub Enterprise</a>
+ </li>
+ <li>GitHub Java API updates
+ <ul>
+ <li>OAuth API support</li>
+ <li>Service Hook support</li>
+ <li>Repository contributors, languages, branches, and teams</li>
+ </ul>
+ </li>
+ </ul><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top"></td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Bugs Closed</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Bugs-Closed.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Bugs-Closed.html
new file mode 100644
index 000000000..f0840a17c
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Bugs-Closed.html
@@ -0,0 +1,61 @@
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>EGit 1.2 New and Noteworthy - Bugs Closed</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">Bugs Closed</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="1.2.html" title="EGit 1.2 New and Noteworthy">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Commits.html" title="Commits">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">EGit 1.2 New and Noteworthy</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Commits</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Bugs_Closed">Bugs Closed</h1>
+ <p>
+ <a href="https://bugs.eclipse.org/bugs/buglist.cgi?chfieldto=2011-12-21;chfield=bug_status;query_format=advanced;order=Importance;chfieldfrom=2011-09-23;bug_status=RESOLVED;bug_status=CLOSED;resolution=FIXED;resolution=DUPLICATE;product=EGit;classification=Technology" target="egit_external">114 bugs and 12 enhancement requests</a> were closed.
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="1.2.html" title="EGit 1.2 New and Noteworthy">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="1.2.html" title="EGit 1.2 New and Noteworthy">
+ <img alt="EGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="Commits.html" title="Commits">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">EGit 1.2 New and Noteworthy</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Commits</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Performance-Improvements.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Commits.html
index 6f07ccf53..9b369fa22 100644
--- a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Performance-Improvements.html
+++ b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Commits.html
@@ -2,17 +2,17 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>JGit 1.1 New and Noteworthy - Performance Improvements</title>
+ <title>EGit 1.2 New and Noteworthy - Commits</title>
<link type="text/css" rel="stylesheet" href="../../../book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
- <th style="width: 100%" align="center" colspan="3">Performance Improvements</th>
+ <th style="width: 100%" align="center" colspan="3">Commits</th>
</tr>
<tr>
<td style="width: 20%" align="left">
- <a href="Features.html" title="Features">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
@@ -24,37 +24,25 @@
</td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">Features</td>
+ <td style="width: 20%" align="left" valign="top">Bugs Closed</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
</table><hr/>
- <h1 id="Performance_Improvements">Performance Improvements</h1>
- <ul>
- <li>diverse performance improvements were implemented
- <ul>
- <li>
- <a href="http://egit.eclipse.org/r/3978" target="egit_external">http://egit.eclipse.org/r/3978</a>
- </li>
- <li>
- <a href="http://egit.eclipse.org/r/3809" target="egit_external">http://egit.eclipse.org/r/3809</a>
- </li>
- <li>
- <a href="http://egit.eclipse.org/r/3778" target="egit_external">http://egit.eclipse.org/r/3778</a>
- </li>
- </ul>
- </li>
- </ul><hr/>
+ <h1 id="Commits">Commits</h1>
+ <p>
+ <a href="http://egit.eclipse.org/w/?p=egit.git;a=shortlog;h=stable-1.2;hp=v1.1.0.201109151100-r;opt=--no-merges" target="egit_external">EGit 1.2 - commits in gitweb</a>
+ </p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
- <a href="Features.html" title="Features">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
- <a href="1.1.html" title="JGit 1.1 New and Noteworthy">
- <img alt="JGit 1.1 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ <a href="1.2.html" title="EGit 1.2 New and Noteworthy">
+ <img alt="EGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right">
@@ -64,7 +52,7 @@
</td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">Features</td>
+ <td style="width: 20%" align="left" valign="top">Bugs Closed</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/Updating-This-Document.html b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Updating-This-Document.html
index 1474e4911..0e501f6c9 100644
--- a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.1/Updating-This-Document.html
+++ b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/Updating-This-Document.html
@@ -2,7 +2,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>EGit 1.1 New and Noteworthy - Updating This Document</title>
+ <title>EGit 1.2 New and Noteworthy - Updating This Document</title>
<link type="text/css" rel="stylesheet" href="../../../book.css"/>
</head>
<body>
@@ -12,7 +12,7 @@
</tr>
<tr>
<td style="width: 20%" align="left">
- <a href="GitHub-Mylyn-Connector.html" title="GitHub Mylyn Connector">
+ <a href="Commits.html" title="Commits">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
@@ -20,7 +20,7 @@
<td style="width: 20%" align="right"></td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">GitHub Mylyn Connector</td>
+ <td style="width: 20%" align="left" valign="top">Commits</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top"></td>
</tr>
@@ -29,24 +29,24 @@
<p> This document is maintained in a collaborative wiki. If you wish to
update or modify this document please visit
- <a href="http://wiki.eclipse.org/EGit/New_and_Noteworthy/1.1" target="egit_external">http://wiki.eclipse.org/EGit/New_and_Noteworthy/1.1</a>
+ <a href="http://wiki.eclipse.org/EGit/New_and_Noteworthy/1.2" target="egit_external">http://wiki.eclipse.org/EGit/New_and_Noteworthy/1.2</a>
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
- <a href="GitHub-Mylyn-Connector.html" title="GitHub Mylyn Connector">
+ <a href="Commits.html" title="Commits">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
- <a href="1.1.html" title="EGit 1.1 New and Noteworthy">
- <img alt="EGit 1.1 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ <a href="1.2.html" title="EGit 1.2 New and Noteworthy">
+ <img alt="EGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right"></td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">GitHub Mylyn Connector</td>
+ <td style="width: 20%" align="left" valign="top">Commits</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top"></td>
</tr>
diff --git a/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/images/Gist-from-console.png b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/images/Gist-from-console.png
new file mode 100644
index 000000000..90b92bf32
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/New_and_Noteworthy/1.2/images/Gist-from-console.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/Concepts.html b/org.eclipse.egit.doc/help/EGit/User_Guide/Concepts.html
index 975670846..21bb9b24a 100644
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/Concepts.html
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/Concepts.html
@@ -91,7 +91,7 @@
</li>
<li>Do modifications in the working directory</li>
<li>Tell git about these modifications (add modified files). This transfers the modified file contents into the object database and prepares the tree to be committed in the index.</li>
- <li>Commit the tree prepared in the index into the object database. </li>
+ <li>Commit the tree prepared in the index into the object database.</li>
<li>The result is a new commit object and the
<i>HEAD</i> of the current branch moves to the new commit.
</li>
@@ -100,7 +100,7 @@
<p>You start from a fresh checkout of a branch of a local repository. You want to do some changes and record snapshots of these changes in the repository whenever you reach a state of your changes you want to record.</p>
<p>Each file in the working directory can either be
<i>tracked</i> or
- <i>untracked</i>.
+ <i>untracked</i>.
</p>
<ul>
<li>Tracked files are those which were in the last snapshot or files which have been newly staged into the
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/Reference.html b/org.eclipse.egit.doc/help/EGit/User_Guide/Reference.html
index f4d1af184..aecee5549 100644
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/Reference.html
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/Reference.html
@@ -33,16 +33,42 @@
<h2 id="Menus">Menus</h2>
<h3 id="Project_Context_Menu">Project Context Menu</h3>
<p>On project nodes in navigation views (Navigator, Package Explorer etc.) the following
- Git actions are available for projects shared with the Git team provider:
-
- <br/>
- <img border="0" src="images/Egit-1.0-project-menu.png"/>
+ Git actions are available for projects shared with the Git team provider:</p>
+ <p>
+ <br/>
+ </p>
+ <p>
+ <i>main project menu</i>
+ </p>
+ <p>
+ <img border="0" src="images/Egit-1.2-project-menu-main.png"/>
+ </p>
+ <p>
+ <i>"Remote" sub-menu</i>
+ </p>
+ <p>
+ <img border="0" src="images/Egit-1.2-project-menu-remote.png"/>
+ </p>
+ <p>
+ <i>"Switch To" sub-menu</i>
+ </p>
+ <p>
+ <img border="0" src="images/Egit-1.2-project-menu-switchto.png"/>
+ </p>
+ <p>
+ <i>"Advanced" sub-menu</i>
+ </p>
+ <p>
+ <img border="0" src="images/Egit-1.2-project-menu-advanced.png"/>
+ </p>
+ <p>
+ <br/>
</p>
<h3 id="Resource_Context_Menu">Resource Context Menu</h3>
<p>On resource nodes (files and folders) in navigation views the following Git actions are available for projects shared with the Git team provider:
<br/>
- <img border="0" src="images/Egit-1.0-resource-menu.png"/>
+ <img border="0" src="images/Egit-1.2-resource-menu.png"/>
</p>
<h3 id="Repositories_View_Menus">Repositories View Menus</h3>
<p>In the Repositories View the menu depends on the node type which is selected
@@ -53,17 +79,17 @@
<p>Menu on repository nodes:
<br/>
- <img border="0" src="images/Egit-1.0-repomenu.png"/>
+ <img border="0" src="images/Egit-1.2-repoview-repository-menu.png"/>
</p>
<p>Menu on branch nodes:
<br/>
- <img border="0" src="images/Egit-0.10-repoview-branchmenu.png"/>
+ <img border="0" src="images/Egit-1.2-repoview-branch-menu.png"/>
</p>
<p>Menu on tag nodes:
<br/>
- <img border="0" src="images/Egit-0.10-repoview-tagmenu.png"/>
+ <img border="0" src="images/Egit-1.2-repoview-tag-menu.png"/>
</p>
<p>Menu on Reference nodes:
<br/>
@@ -73,23 +99,23 @@
<p>Menu on Fetch Configuration nodes:
<br/>
- <img border="0" src="images/Egit-0.10-repoview-fetchmenu.png"/>
+ <img border="0" src="images/Egit-1.2-repoview-fetchconfig-menu.png"/>
</p>
<p>Menu on Push Configuration nodes:
<br/>
- <img border="0" src="images/Egit-0.10-repoview-pushmenu.png"/>
+ <img border="0" src="images/Egit-1.2-repoview-pushconfig-menu.png"/>
</p>
<p>Menu on Working Tree nodes:
<br/>
- <img border="0" src="images/Egit-0.10-repoview-worktreemenu.png"/>
+ <img border="0" src="images/Egit-1.2-repoview-workingtree-menu.png"/>
</p>
<h3 id="History_View_Menus">History View Menus</h3>
<p>Menu on entries in the History View's commit list
<br/>
- <img border="0" src="images/Egit-0.10-history-commitmenu.png"/>
+ <img border="0" src="images/Egit-1.2-historyview-menu.png"/>
</p>
<h3 id="Git_Workbench_Toolbar_and_Git_Workbench_Menu">Git Workbench Toolbar and Git Workbench Menu</h3>
<p>In order to ease use of the most frequently used Git actions the
@@ -125,129 +151,129 @@
<li>
<a href="User-Guide.html#Track_Changes">Add</a>
<ul>
- <li>Add changes present in the working tree to the git index, also known as staging changes. </li>
- <li>Put newly created resources under git version control (Git does not automatically start tracking resources). </li>
+ <li>Add changes present in the working tree to the git index, also known as staging changes.</li>
+ <li>Put newly created resources under git version control (Git does not automatically start tracking resources).</li>
<li>
- <a href="Tasks.html#Adding_conflict_resolution_to_the_git_index">Resolve conflicts</a>.
+ <a href="Tasks.html#Adding_conflict_resolution_to_the_git_index">Resolve conflicts</a>.
</li>
</ul>
</li>
<li>
- <a href="Tasks.html#Applying_Patches">Apply Patch</a> - Apply a patch.
+ <a href="Tasks.html#Applying_Patches">Apply Patch</a> - Apply a patch.
</li>
<li>
<b>Assume unchanged</b> - Resources can be flagged "assume unchanged". This means that Git stops checking the working tree files for possible modifications, so you need to manually unset the bit to tell Git when you change the working tree file. This setting can be switched on with the menu action
<b>Team &gt; Assume unchanged</b> and switched back with the menu action
- <b>Team &gt; No Assume unchanged</b>.
+ <b>Team &gt; No Assume unchanged</b>.
</li>
<li>
<a href="Tasks.html#Branching">Branch</a>,
- <a href="Reference.html#Create_Branch...">Create Branch</a> - Checkout a branch or create a branch.
+ <a href="Reference.html#Create_Branch...">Create Branch</a> - Checkout a branch or create a branch.
</li>
<li>
- <b>Change Credentials</b> - Change logon credentials of a Fetch or Push Specification, credentials are stored per URL in the Eclipse Secure Store.
+ <b>Change Credentials</b> - Change logon credentials of a Fetch or Push Specification, credentials are stored per URL in the Eclipse Secure Store.
</li>
<li>
<b>Checkout</b> - Checkout a
<a href="Tasks.html#Check-out_of_Branches_and_Tags">Branch, Tag</a>,
- <a href="Reference.html#Checkout">Commit</a> or Reference.
+ <a href="Reference.html#Checkout">Commit</a> or Reference.
</li>
<li>
- <a href="Tasks.html#Cherry_Picking">Cherry-pick</a> - Cherry-pick a single commit onto the tip of the currently checked out branch.
+ <a href="Tasks.html#Cherry_Picking">Cherry-pick</a> - Cherry-pick a single commit onto the tip of the currently checked out branch.
</li>
<li>
- <b>Clear Credentials</b> - Clear logon credentials of a Fetch or Push Specification, credentials are stored per URL in the Eclipse Secure Store.
+ <b>Clear Credentials</b> - Clear logon credentials of a Fetch or Push Specification, credentials are stored per URL in the Eclipse Secure Store.
</li>
<li>
- <a href="Tasks.html#Committing_Changes">Commit</a> - Commit changes.
+ <a href="Tasks.html#Committing_Changes">Commit</a> - Commit changes.
</li>
<li>
- <b>Delete Fetch</b> - Delete a Fetch Specification.
+ <b>Delete Fetch</b> - Delete a Fetch Specification.
</li>
<li>
- <b>Delete Push</b> - Delete a Push Specification.
+ <b>Delete Push</b> - Delete a Push Specification.
</li>
<li>
- <a href="Tasks.html#Direct_Fetch_and_Push_Support">Configure Fetch</a> - Configure a Fetch Specification.
+ <a href="Tasks.html#Direct_Fetch_and_Push_Support">Configure Fetch</a> - Configure a Fetch Specification.
</li>
<li>
- <a href="Tasks.html#Direct_Fetch_and_Push_Support">Configure Push</a> - Configure a Push Specification.
+ <a href="Tasks.html#Direct_Fetch_and_Push_Support">Configure Push</a> - Configure a Push Specification.
</li>
<li>
- <a href="Tasks.html#Creation_and_Deletion_of_Branches">Delete Branch</a> - Delete a branch.
+ <a href="Tasks.html#Creation_and_Deletion_of_Branches">Delete Branch</a> - Delete a branch.
</li>
<li>
- <a href="Tasks.html#Deleting_a_Repository">Delete Repository</a> - Delete a repository.
+ <a href="Tasks.html#Deleting_a_Repository">Delete Repository</a> - Delete a repository.
</li>
<li>
- <b>Disconnect</b> - Disconnect the attached Git Team Provider from this project. The git repository still exists but is no longer integrated with Eclipse.
+ <b>Disconnect</b> - Disconnect the attached Git Team Provider from this project. The git repository still exists but is no longer integrated with Eclipse.
</li>
<li>
- <a href="Reference.html#Git_Ignore">Ignore</a> - Add files to .gitignore so that git ignores them.
+ <a href="Reference.html#Git_Ignore">Ignore</a> - Add files to .gitignore so that git ignores them.
</li>
<li>
- <a href="#Method_for_importing_Projects">Import Projects</a> - Import projects into the Eclipse workbench.
+ <a href="#Method_for_importing_Projects">Import Projects</a> - Import projects into the Eclipse workbench.
</li>
<li>
- <a href="Tasks.html#Merging">Merge</a> - Merge branches.
+ <a href="Tasks.html#Merging">Merge</a> - Merge branches.
</li>
<li>
- <a href="Tasks.html#Using_Merge_Tool">Merge Tool</a> - Resolve conflicts using the Merge Tool.
+ <a href="Tasks.html#Using_Merge_Tool">Merge Tool</a> - Resolve conflicts using the Merge Tool.
</li>
<li>
- <a href="Tasks.html#Repository_Configuration">Open Properties View</a> - View and edit the repository configuration.
+ <a href="Tasks.html#Repository_Configuration">Open Properties View</a> - View and edit the repository configuration.
</li>
<li>
- <a href="#Pulling_New_Changes_from_Upstream_Repositories">Pull</a> - Pull changes from remote branch tracked by currently checked out local branch.
+ <a href="#Pulling_New_Changes_from_Upstream_Repositories">Pull</a> - Pull changes from remote branch tracked by currently checked out local branch.
</li>
<li>
<i>'Remote &gt; '</i>
- <a href="Tasks.html#Fetching_from_other_Repositories">Fetch From</a> - Fetch changes from a remote repository
+ <a href="Tasks.html#Fetching_from_other_Repositories">Fetch From</a> - Fetch changes from a remote repository
</li>
<li>
<b>Remote &gt;</b>
- <a href="Tasks.html#Fetching_a_change_from_a_Gerrit_Code_Review_Server">Fetch from Gerrit</a> - Fetch changed from a Gerrit Code Review Server
+ <a href="Tasks.html#Fetching_a_change_from_a_Gerrit_Code_Review_Server">Fetch from Gerrit</a> - Fetch changed from a Gerrit Code Review Server
</li>
<li>
<b>Remote &gt;</b>
<a href="Tasks.html#Pushing_to_other_Repositories">Push</a> - Push changes to other repositories
- <br/>
+ <br/>
</li>
<li>
<b>Remote &gt;</b>
- <a href="Tasks.html#Configuring_upstream_fetch">Configure Fetch from Upstream</a> - Configure Upstream for automated fetch
+ <a href="Tasks.html#Configuring_upstream_fetch">Configure Fetch from Upstream</a> - Configure Upstream for automated fetch
</li>
<li>
<b>Remote &gt;</b>
<a href="Tasks.html#Configuring_upstream_push">Configure Push to Upstream</a> - Configure upstream for automated push
- <br/>
+ <br/>
</li>
<li>
- <a href="Tasks.html#Rebasing">Rebase</a> - Rebase a branch onto another one.
+ <a href="Tasks.html#Rebasing">Rebase</a> - Rebase a branch onto another one.
</li>
<li>
- <a href="Tasks.html#Removing_a_Repository_from_the_Repositories_View">Remove Repository</a> - Remove a repository from the Repositories View.
+ <a href="Tasks.html#Removing_a_Repository_from_the_Repositories_View">Remove Repository</a> - Remove a repository from the Repositories View.
</li>
<li>
- <a href="Tasks.html#Renaming_an_Existing_Branch">Rename Branch</a> - Rename a branch.
+ <a href="Tasks.html#Renaming_an_Existing_Branch">Rename Branch</a> - Rename a branch.
</li>
<li>
- <a href="Tasks.html#Resetting_your_current_HEAD">Reset</a> - Reset the current HEAD, Index or Working Tree.
+ <a href="Tasks.html#Resetting_your_current_HEAD">Reset</a> - Reset the current HEAD, Index or Working Tree.
</li>
<li>
- <a href="Reference.html#History_View">Show in History</a> - Show the selected resource in the History View.
+ <a href="Reference.html#History_View">Show in History</a> - Show the selected resource in the History View.
</li>
<li>
- <a href="Tasks.html#Managing_Repositories">Show in Repositories View</a> - Show the selected resource in the Repositories View.
+ <a href="Tasks.html#Managing_Repositories">Show in Repositories View</a> - Show the selected resource in the Repositories View.
</li>
<li>
<a href="Tasks.html#Checking_out_an_existing_Branch">Switch to...</a> - Switch to (also known as checkout) another branch or tag.
</li>
<li>
- <a href="Tasks.html#Comparing_with_Branches_.28Synchronize.29">Synchronize</a> - Synchronize local and remote branches with each other.
+ <a href="Tasks.html#Comparing_with_Branches_.28Synchronize.29">Synchronize</a> - Synchronize local and remote branches with each other.
</li>
<li>
- <a href="Tasks.html#Tagging">Tag</a> - Create, delete tags.
+ <a href="Tasks.html#Tagging">Tag</a> - Create, delete tags.
</li>
<li>
<b>Untrack</b> - Remove resources from git version control. If you want to delete the resource from the working tree click also
@@ -280,7 +306,7 @@
<li>Setting and resetting of the quickdiff baseline to a certain commit</li>
</ul>
<h4 id="Opening_the_History_View">Opening the History View</h4>
- <p>The History view can be opened by </p>
+ <p>The History view can be opened by</p>
<ul>
<li>Right-clicking
<b>Show In &gt; History View</b> on any resource under Git version control in the explorer (not available in all Perspectives)
@@ -297,9 +323,9 @@
<b>Link with Selection</b> button to keep the input of the view in sync with the selection in the explorer automatically.
</p>
<h4 id="Organization_of_the_History_View">Organization of the History View</h4>
- <p>The History view is organized in several panes: </p>
+ <p>The History view is organized in several panes:</p>
<p>
- <img border="0" src="images/Egit-0.9-history-view.png"/>
+ <img border="0" src="images/Egit-0.9-history-view.png"/>
</p>
<p>The upper pane is the Commit Graph displaying the commit log (or commit history) in reverse chronological order (newest commit on top). Below the commit graph, there are by default two panes: on the left side, the Revision Comment area, which shows the commit message and a textual Diff of the file or files in the commit, and on the right side, the Revision Detail area, which shows a table of the files that were changed by the commit.</p>
<p>The first column of this table describes the nature of the change for each file:</p>
@@ -400,7 +426,9 @@
<li>If the "Folder" toggle is down, the commit log is filtered to show all commits which affected any of the resources in the parent folder of the current input</li>
</ul>
<ul>
- <li>If the "Resource" button is down, the commit log is filtered to show only commits which affected the current input</li>
+ <li>If the "Resource" button is down, the commit log is filtered to show only commits which affected the current input; the view menu item
+ <b>Show &gt; Follow Renames</b> allows to toggle whether renames of the selected ressource should be followed by this filter
+ </li>
</ul>
<p>Note that not all combinations of filter setting and current input are meaningful; for example, if the current input is a project, the "Project" option is in fact the same as the "Resource" option.</p>
<h5 id="Compare_Mode">Compare Mode</h5>
@@ -420,22 +448,27 @@
<h5 id="Configuring_the_View">Configuring the View</h5>
<p>Most of the toolbar actions are available in the View Menu, too. In addition, the following four toggles are available:</p>
<p>
- <img border="0" src="images/Egit-0.9-history-view-viewmenu.png"/>
+ <img border="0" src="images/Egit-1.2-history-view-menu.png"/>
</p>
<p>"Show Revision Details" toggles the Revision Detail area and "Show Revision Comment" the Revision Comment area. The "Wrap Comments" and "Fill paragraphs" actions are only available if "Show Revision Comment" is active and govern the formatting within the Revision Comment area.</p>
<p>The first two actions are also available by right-clicking anywhere in the Commit Graph area, and the last two actions are also available by right-clicking anywhere in the Revision Comment area.</p>
+ <p>The preference
+ <b>Show &gt; Follow Renames</b> allows to toggle whether renames of a selected resource should be followed in the History View, if the "Resource" filter is used.
+ This preference can also be configured in the preference wizard
+ <b>Preferences &gt; Team &gt; Git &gt; Views &gt; Follow Renames</b>.
+ </p>
<h4 id="Context_Menu_actions">Context Menu actions</h4>
<p>The context menu in the Commit Graph area is slightly different, depending on whether the current is a File or a Folder/Project, respectively. The following menu entries are always available:</p>
<p>
- <img border="0" src="images/Egit-0.9-history-view-contextMenuFolder.png"/>
+ <img border="0" src="images/Egit-1.2-historyview-menu.png"/>
</p>
- <p>If the current input is a File, there are some other actions available; if exactly one commit is selected, there are two additional options:</p>
+ <p>If the current input is a File, there are some other actions available; if exactly one commit is selected, there are three additional options:</p>
<p>
- <img border="0" src="images/Egit-0.9-history-view-contextMenuSingleFile.png"/>
+ <img border="0" src="images/Egit-1.2-historyview-file-menu.png"/>
</p>
<p>and if exactly two commits are selected, the menu will appear like this:</p>
<p>
- <img border="0" src="images/Egit-0.9-history-view-contextMenuTwoFiles.png"/>
+ <img border="0" src="images/Egit-1.2-historyview-2files-menu.png"/>
</p>
<p>If more than two commits are selected, only the "Open" action and the "Quickdiff" menu will be available.</p>
<h5 id="Compare_with_working_tree">Compare with working tree</h5>
@@ -443,11 +476,15 @@
<h5 id="Compare_with_each_other">Compare with each other</h5>
<p>This action is only available if the current input is a file and exactly two commits are selected. It will open a compare editor comparing the file content of the selected commits with each other.</p>
<h5 id="Open">Open</h5>
- <p>This action is only available if the current input is a file. It will open an editor for each selected commit displaying the content of the file for the given commit. </p>
+ <p>This action is only available if the current input is a file. It will open an editor for each selected commit displaying the content of the file for the given commit.</p>
<h5 id="Checkout">Checkout</h5>
- <p>This checks out the currently selected commit. If a branch exists for this commit, the branch is checked out, if more than one branch exists for this commit, a dialog will be shown asking which branch should be checked out. If no branches exist for the commit, the commit will be checked out and HEAD will become detached.</p>
+ <p>This checks out the currently selected commit. If a branch exists for this commit, the branch is checked out, if more than one branch exists for this commit, a dialog will be shown asking which branch should be checked out. If no branches exist for the commit, the commit will be checked out and
+ <a href="#&quot;Detached&quot;_HEAD">HEAD will become detached</a>.
+ </p>
<h5 id="Create_Branch...">Create Branch...</h5>
<p>Creates a branch on the currently selected commit. A dialog will be shown asking for a branch name and whether the newly created branch should be checked out.</p>
+ <h5 id="Delete_Branch">Delete Branch</h5>
+ <p>This action will be enabled if a branch exists for the currently selected commit, which is not checked out. If there is a single branch on this commit, which is not checked out, this action will delete this branch immediately. If multiple such branches exist, a dialog will be shown asking which branches should be deleted. If commits become unreachable on "Delete Branch" a confirmation dialog will be shown to prevent accidental unreachability of commits.</p>
<h5 id="Create_Tag...">Create Tag...</h5>
<p>Creates a tag on the currently selected commit. A dialog will be shown asking for a tag name and a tag message.</p>
<h5 id="Create_Patch...">Create Patch...</h5>
@@ -476,18 +513,29 @@
<h5 id="Wrap_Comments">Wrap Comments</h5>
<p>Only available when right-clicking on the Revision Comment area. If active, the comments will be auto-wrapped to fill the display area, otherwise the wrapping of the commit message will be used.</p>
<h5 id="Fill_Paragraphs">Fill Paragraphs</h5>
- <p>Only available when right-clicking on the Revision Comment area. If active, the commit message will be displayed without unnecessary line breaks.</p>
- <p>
+ <p>Only available when right-clicking on the Revision Comment area. If active, the commit message will be displayed without unnecessary line breaks.
+
<br/>
</p>
+ <h4 id="Drag_and_Drop_Support">Drag and Drop Support</h4>
+ <p>You may drag and drop commits from the commit graph either onto a
+ <a href="http://wiki.eclipse.org/index.php/Mylyn/User_Guide" target="egit_external">Mylyn</a> Task or into a folder on your harddisk. In both cases, EGit will automatically create a patch you may attach to a bug or store on disk.
+ </p>
+ <h4 id="Working_with_the_Revision_Details_Area">Working with the Revision Details Area</h4>
+ <p>The Revision Details Area shows a table of the files that were changed by the selected commit. Selecting the context menu action
+ <b>Show Annotations</b> on selected files will open the file in a (read-only) editor and display an annotation ruler with commit and author information for each line in a file. See
+ <a href="Tasks.html#Finding_the_author_of_each_line_in_a_file">this section</a>.
+ </p>
<h3 id="Synchronize_View">Synchronize View</h3>
- <p>A Git synchronization launched using the Team &gt; Synchronize menu command will appear in the Synchronize view. This view allows you to inspect the differences between the resources in the local workspace and a local or remote tracking branch. Alternatively you may compare a local and a remote tracking branch. Comparison of two remote tracking branches as well as menu commands on the Synchronize View are not yet available in this EGit version and will be provided in a future release.</p>
+ <p>The menu command
+ <b>Team &gt; Synchronize Workspace</b> will launch the Synchronize View. This view allows you to inspect the differences between the resources in the local workspace and a local or remote tracking branch. Alternatively you may compare a local and a remote tracking branch. Comparison of two remote tracking branches as well as menu commands on the Synchronize View are not yet available in this EGit version and will be provided in a future release.
+ </p>
<p>Here is what the Git Synchronize View looks like:</p>
<p>
<img border="0" src="images/Egit-0.9-synchronize-overview.png"/>
</p>
<h4 id="Synchronization_State">Synchronization State</h4>
- <p>The Synchronize View shows the synchronization state of resources in your workspace or a local branch compared to those in another local or remote tracking branch representing the state of a branch from a remote repository. This state is shown by using icons and can also be configured to show the state as text appended to the resource name. </p>
+ <p>The Synchronize View shows the synchronization state of resources in your workspace or a local branch compared to those in another local or remote tracking branch representing the state of a branch from a remote repository. This state is shown by using icons and can also be configured to show the state as text appended to the resource name.</p>
<p>
<img border="0" src="images/Egit-0.9-synchronize-overview-labels.png"/>
</p>
@@ -499,7 +547,7 @@
</tr>
<tr>
<td>
- <img border="0" src="images/Egit-0.9-synchronize-incoming-add.png"/>
+ <img border="0" src="images/Egit-0.9-synchronize-incoming-add.png"/>
</td>
<td>An incoming addition means that a resource has been added to the target branch.</td>
</tr>
@@ -568,8 +616,8 @@
</dl>
</dt>
<dt>Java Model: displays a Java based model (similar to what appears in the Package Explorer).</dt>
- <dt>Change Sets: displays a Change Set based model. This model shows incoming changes grouped by commit which is handy for seeing who released what and why. For outgoing changes, you can create Change Sets by
- <a href="Tasks.html#Committing_Changes">creating commits</a>. The display format of the Change Set description can be configured in the preferences under
+ <dt>Git Commits: displays a Git Commit based model. This model shows incoming changes grouped by commit which is handy for seeing who released what and why. For outgoing changes, you can create commits by
+ <a href="Tasks.html#Committing_Changes">creating commits</a>. The display format of the Git commit description can be configured in the preferences under
<b>Team &gt; Git &gt; Label Decorations</b> in the tab
<b>Other</b>.
</dt>
@@ -592,11 +640,11 @@
<h3 id="Git_Tree_Compare_View">Git Tree Compare View</h3>
<p>This view will be opened by some of the
<b>Compare With</b> actions (see
- <a href="Tasks.html#Comparing_Content">Comparing Content</a>). When started from a resource (e.g. a project or folder), it will look similar to the resources in the workspace. However, the usual icons on the files will be replaced with icons showing the change state (added, deleted, changed, or unchanged).
+ <a href="Tasks.html#Comparing_Content">Comparing Content</a>). When started from a resource (e.g. a project or folder), it will look similar to the resources in the workspace. However, the usual icons on the files will be replaced with icons showing the change state (added, deleted, changed, or unchanged).
</p>
- <p>The changes can be browsed and a double-click on a file will open a compare editor for this file (this only makes sense on "changed" files, in case of added or deleted files, one side of the compare editor will be empty, whereas unchanged files will show the same content on both sides of the editor): </p>
+ <p>The changes can be browsed and a double-click on a file will open a compare editor for this file (this only makes sense on "changed" files, in case of added or deleted files, one side of the compare editor will be empty, whereas unchanged files will show the same content on both sides of the editor):</p>
<p>
- <img border="0" src="images/Egit-0.11-GitTreeCompareView.png"/>
+ <img border="0" src="images/Egit-0.11-GitTreeCompareView.png"/>
</p>
<p>It is possible to hide unchanged files by clicking the "Hide files with equal content" button in the toolbar.</p>
<p>The Git Tree Compare View can also be started without having workspace resources as starting point (for example by comparing two commits in the history view when the input of the history view is a Repository and not a workspace resource). In this case, the complete content of the Repository is shown and both projects and folders appear as simple "folder" icons:</p>
@@ -604,7 +652,40 @@
<img border="0" src="images/Egit-0.11-GitTreeCompareViewRepo.png"/>
</p>
<h3 id="Git_Staging_View">Git Staging View</h3>
- <p>This view provides a graphical equivalent for <code>git status</code> showing changes made in the working tree. Unstaged changes which have not yet been transferred to the git index are displayed in the "unstaged" pane, changes which have already been "added" (staged) to the index are shown in the "staged" pane. Double-click modified files to open a compare view, if fired from the "unstaged" pane the compare view will show the not-yet staged changes. When fired from the "staged" pane it will display the already staged changes. Use drag and drop to stage or unstage changed files. The integrated commit action will commit the staged changes only similar to what <code>git commit</code> does in native git.</p>
+ <p>
+ <img border="0" src="images/Egit-1.2-staging-view.png"/>
+ </p>
+ <p>This view provides an equivalent for <code>git status</code> showing changes made in the working tree. Unstaged changes which have not yet been transferred to the git index are displayed in the
+ <b>Unstaged Changes</b> pane, changes which have already been "added" (staged) to the Git index are shown in the
+ <b>Staged Changes</b> pane. By default these panes are displayed in a row layout, which can be changed to a column layout by the
+ <b>Column Layout</b> option. The Staged- and Unstaged Changes panes by default show the full path of the files. They can be configured by the
+ <b>Show File Names First</b> option to show the file names first, followed by the directory that the files are located in.
+ </p>
+ <p>Double-click modified files to open a compare view. If fired from the "unstaged" pane the compare view will show the not-yet staged changes. When fired from the "staged" pane it will display the already staged changes. To open a file in the editor, use the
+ <b>Open Working Tree Version</b> action on the file's context menu.
+ </p>
+ <p>To stage a file, drag it from the
+ <b>Unstaged Changes</b> pane to the
+ <b>Staged Pages</b> pane. Alternatively, use the
+ <b>Add to Git Index</b> action on the file's context menu in the
+ <b>Unstaged Changes</b> pane. The
+ <b>Replace with File in Git Index</b> action will replace the selected file in the working tree. If the file is unstaged, it will be reset. If it is staged, the working tree version will be replaced with the staged version from the Git index.
+ </p>
+ <p>To unstage a file, drag it from the
+ <b>Staged Changes</b> pane to the
+ <b>Unstaged Changes</b> pane. Alternatively, use the
+ <b>Remove from Git Index</b> action on the file's context menu.
+ </p>
+ <p>The commit action will commit the staged changes only -- similar to what <code>git commit</code> does in native git. An intergrated commit message editor allows to edit the commit message for the commit. In contrast to the commit dialog, the staging view can be kept open while doing changes. This allows for incrementally writing the commit message along with the changes. The commit message being edited is associated with the repository, the staging view is linked with. It is not stored persistently and will get lost if the staging view or Eclipse are closed.</p>
+ <h3 id="Git_Reflog_View">Git Reflog View</h3>
+ <p>
+ <img border="0" src="images/Egit-1.2-reflog-view.png"/>
+ </p>
+ <p>The Reflog View shows the Git reflog for a selected repository. It supports showing the reflog for a specific branch by selecting the hyperlink ref name in the top right of the view. Double-clicking or selecting the context menu action
+ <b>Open in Commit Viewer</b> on a reflog entry opens the corresponding commit in the commit viewer. The context menu action
+ <b>Checkout</b> will checkout the selected commit and the
+ <a href="Tasks.html#.22Detached.22_HEAD">HEAD will become detached</a>.
+ </p>
<h2 id="Git_URLs">Git URLs</h2>
<p>Git URLs in general consist of transport protocol scheme, address of the remote server and the repository path within the remote server and for some authenticating protocols also the user ID.</p>
<p>EGit supports the following protocols</p>
@@ -613,36 +694,36 @@
<b>file</b> - Direct file system access to the repository.
</li>
<li>
- <b>git</b> - The most efficient built-in git protocol (default port 9418). This protocol doesn't provide authentication. Typically used for anonymous read access to the repository.
+ <b>git</b> - The most efficient built-in git protocol (default port 9418). This protocol doesn't provide authentication. Typically used for anonymous read access to the repository.
</li>
<li>
<b>ssh</b> - Git over
- <a href="http://tools.ietf.org/html/rfc4251" target="egit_external">secure shell (SSH)</a> protocol. Typically used for authenticated write access to the repository.
+ <a href="http://tools.ietf.org/html/rfc4251" target="egit_external">secure shell (SSH)</a> protocol. Typically used for authenticated write access to the repository.
</li>
<li>
<b>http</b> -
- <a href="http://tools.ietf.org/html/rfc2616" target="egit_external">Hypertext Transfer Protocol</a> can be tunneled through firewalls.
+ <a href="http://tools.ietf.org/html/rfc2616" target="egit_external">Hypertext Transfer Protocol</a> can be tunneled through firewalls.
</li>
<li>
<b>https</b> -
- <a href="http://tools.ietf.org/html/rfc2818" target="egit_external">Hypertext Transfer Protocol Secure</a> can be tunneled through firewalls.
+ <a href="http://tools.ietf.org/html/rfc2818" target="egit_external">Hypertext Transfer Protocol Secure</a> can be tunneled through firewalls.
</li>
<li>
<b>ftp</b> -
- <a href="http://tools.ietf.org/html/rfc959" target="egit_external">File Transfer Protocol</a>
+ <a href="http://tools.ietf.org/html/rfc959" target="egit_external">File Transfer Protocol</a>
</li>
<li>
<b>sftp</b> -
- <a href="http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol" target="egit_external">SSH File Transfer Protocol</a>
+ <a href="http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol" target="egit_external">SSH File Transfer Protocol</a>
</li>
</ul>
- <p>Git URLs are used when </p>
+ <p>Git URLs are used when</p>
<ul>
<li>
- <a href="Tasks.html#Cloning_Remote_Repositories">cloning repositories</a>
+ <a href="Tasks.html#Cloning_Remote_Repositories">cloning repositories</a>
</li>
<li>
- <a href="Tasks.html#Fetching_from_other_Repositories">fetching</a> changes from another repository
+ <a href="Tasks.html#Fetching_from_other_Repositories">fetching</a> changes from another repository
</li>
<li>
<a href="Tasks.html#Pushing_to_other_Repositories">pushing</a> changes to another repository
@@ -654,28 +735,28 @@
<h2 id="Git_References">Git References</h2>
<p>Git References are also known shortly as
<b>Refs</b>.
- <br/>They comprise
+ <br/>They comprise
</p>
<ul>
- <li>branches </li>
- <li>remote-tracking branches </li>
+ <li>branches</li>
+ <li>remote-tracking branches</li>
<li>tags</li>
</ul>
- <p>They all are named with a path using '/' as path separator and are starting with "refs". </p>
+ <p>They all are named with a path using '/' as path separator and are starting with "refs".</p>
<ul>
- <li>Local branches start with "refs/heads/" </li>
- <li>Remote tracking branches start with "refs/remotes/". Remote tracking branches proxy branches located in a remote repository so that their state at the time of the last transport operation can be queried also when no connection to the repository is available (offline). </li>
+ <li>Local branches start with "refs/heads/"</li>
+ <li>Remote tracking branches start with "refs/remotes/". Remote tracking branches proxy branches located in a remote repository so that their state at the time of the last transport operation can be queried also when no connection to the repository is available (offline).</li>
<li>Tags start with "refs/tags/"</li>
</ul>
<p>Ref names can be abbreviated as long as the abbreviated form is unique.
- <br/>E.g.
+ <br/>E.g.
</p>
<ul>
- <li>"master" is short for "refs/heads/master" </li>
- <li>"origin/master" is short for "refs/remotes/origin/master" </li>
+ <li>"master" is short for "refs/heads/master"</li>
+ <li>"origin/master" is short for "refs/remotes/origin/master"</li>
<li>"v1.0.1" is short for "refs/tags/v1.0.1"</li>
</ul>
- <p>There is also a number of "reserved" names for Refs that are useful for certain scenarios: </p>
+ <p>There is also a number of "reserved" names for Refs that are useful for certain scenarios:</p>
<table style="width: 538px; height: 63px;" border="1" cellpadding="1" cellspacing="1">
<tr>
<td>
@@ -686,15 +767,15 @@
</td>
</tr>
<tr>
- <td>HEAD </td>
+ <td>HEAD</td>
<td>Points to the currently checkout out commit</td>
</tr>
<tr>
- <td>FETCH_HEAD </td>
+ <td>FETCH_HEAD</td>
<td>Points to the result of the last fetch operation</td>
</tr>
<tr>
- <td>ORIG_HEAD </td>
+ <td>ORIG_HEAD</td>
<td>Points to the commit that was checked out before a merge or rebse operation was started</td>
</tr>
</table>
@@ -706,15 +787,14 @@
<a href="Reference.html#Git_References">Ref</a> and local
<a href="Reference.html#Git_References">Ref</a>. Semantically they define how local branches or tags are mapped to branches or tags in a remote repository. In native git they are combined with a colon in the format &lt;src&gt;:&lt;dst&gt;, preceded by an optional plus sign, + to denote forced update. In EGit they can be displayed and also edited in tabular form in the
<a href="Tasks.html#Push_Ref_Specifications">Push Ref Specification</a> and the
- <a href="Tasks.html#Fetch_Ref_Specifications">Fetch Ref Specification</a> and other dialogs.
+ <a href="Tasks.html#Fetch_Ref_Specifications">Fetch Ref Specification</a> and other dialogs.
</p>
- <p>The "left-hand" side of a RefSpec is called source and the "right-hand" side is called destination. Depending on whether the RefSpec is used for fetch or for push, the semantics of source and destination differ: for a Push RefSpec, the source denotes a Ref in the source Repository and the destination denotes a Ref in the target Repository. </p>
+ <p>The "left-hand" side of a RefSpec is called source and the "right-hand" side is called destination. Depending on whether the RefSpec is used for fetch or for push, the semantics of source and destination differ: for a Push RefSpec, the source denotes a Ref in the source Repository and the destination denotes a Ref in the target Repository.</p>
<h3 id="Push_Refspecs">Push Refspecs</h3>
- <p>A typical example for a Push RefSpec could be </p>
+ <p>A typical example for a Push RefSpec could be</p>
<pre>HEAD:refs/heads/master
</pre>
- <p>
- This means that the currently checked out branch (as signified by the HEAD Reference, see
+ <p>This means that the currently checked out branch (as signified by the HEAD Reference, see
<a href="Reference.html#Git_References">Git References</a>) will be pushed into the master branch of the remote repository.
</p>
<h3 id="Fetch_Refspecs">Fetch Refspecs</h3>
@@ -724,7 +804,7 @@
<p>This means that all branches from the remote repository will be fetched into the corresponding remote tracking branches of the local repository.</p>
<h2 id="Remotes">Remotes</h2>
<p>Remotes are used to manage the repositories ("remotes") whose branches you track from your repository.</p>
- <p>In EGit Remotes are defined when </p>
+ <p>In EGit Remotes are defined when</p>
<ul>
<li>
<a href="Tasks.html#Cloning_Remote_Repositories">Cloning a repository</a> from another repository, by convention this repository the newly cloned one has been created from is named "origin". If you prefer a different name the clone wizard allows to specify that.
@@ -800,10 +880,7 @@
<li>The repository is cloned to local disc. If it already exists, it is assumed that it was previously cloned and just new commits will be fetched</li>
<li>The specified tag will be checked out in the local clone</li>
<li>The content of the path will be copied to the final build location</li>
- </ul>
- <p>
- <a href="http://wiki.eclipse.org/Category:Git" title="Category:Git" target="egit_external">Category:Git</a>
- </p><hr/>
+ </ul><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/Tasks.html b/org.eclipse.egit.doc/help/EGit/User_Guide/Tasks.html
index b14e6d861..ab4f50dfc 100644
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/Tasks.html
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/Tasks.html
@@ -53,7 +53,7 @@
<h4 id="The_longer_story">The longer story</h4>
<h5 id="Eclipse_Workspace_and_Repository_working_directory">Eclipse Workspace and Repository working directory</h5>
<p>Git Repositories can be created in different ways, for example by cloning from an existing Repository, by creating one from scratch, or by using the EGit Sharing wizard.</p>
- <p>In any case (unless you create a "bare" Repository, but that't not discussed here), the new Repository is essentially a folder on the local hard disk which contains the "working directory" and the metadata folder. The metadata folder is a dedicated child folder named ".git" and often referred to as ".git-folder". It contains the actual repository (i.e. the Commits, the References, the logs and such).</p>
+ <p>In any case (unless you create a "bare" Repository, but that's not discussed here), the new Repository is essentially a folder on the local hard disk which contains the "working directory" and the metadata folder. The metadata folder is a dedicated child folder named ".git" and often referred to as ".git-folder". It contains the actual repository (i.e. the Commits, the References, the logs and such).</p>
<p>The metadata folder is totally transparent to the Git client, while the working directory is used to expose the currently checked out Repository content as files for tools and editors.</p>
<p>Typically, if these files are to be used in Eclipse, they must be imported into the Eclipse workspace in one way or another. In order to do so, the easiest way would be to check in .project files from which the "Import Existing Projects" wizard can create the projects easily. Thus in most cases, the structure of a Repository containing Eclipse projects would look similar to something like this:</p>
<p>
@@ -65,7 +65,7 @@
<li>It is probably not a good idea to make a project the root folder of your Repository</li>
</ul>
<dl>
- <dd>The reason is that you will never be able to add another project to this Repository, as the .project file will occupy the root folder; you could still add projects as sub-folders, but this kind of project nesting is known to cause lots of problems all over the place. In order to add another project, you would have to move the project to a sub-folder in the Repository and add the second project as another sub-folder before you could commit this change. </dd>
+ <dd>The reason is that you will never be able to add another project to this Repository, as the .project file will occupy the root folder; you could still add projects as sub-folders, but this kind of project nesting is known to cause lots of problems all over the place. In order to add another project, you would have to move the project to a sub-folder in the Repository and add the second project as another sub-folder before you could commit this change.</dd>
</dl>
<ul>
<li>It is a good idea to keep your Repository outside of your Eclipse Workspace</li>
@@ -90,17 +90,17 @@
<a href="Creating_a_Repository" title="EGit/User_Guide#Creating_a_Repository">Creating a Repository</a>).
</p>
<h3 id="Creating_a_Git_Repository_for_multiple_Projects">Creating a Git Repository for multiple Projects</h3>
- <p>You may first create multiple projects under a common directory and then create a common repository for all projects in one go: </p>
+ <p>You may first create multiple projects under a common directory and then create a common repository for all projects in one go:</p>
<ul>
- <li>create the Eclipse projects e.g. a, b, c under a common directory e.g. <span style="font-family:monospace;">/repos/examples/</span> </li>
+ <li>create the Eclipse projects e.g. a, b, c under a common directory e.g. <span style="font-family:monospace;">/repos/examples/</span></li>
<li>select all projects a, b, c - from context menu click
<b>Team &gt; Share Project &gt; Git</b>
</li>
<li>press
<b>Next</b>
</li>
- <li>select all projects a, b, c </li>
- <li>the wizard automatically moves up the default repository location to the parent folder <span style="font-family:monospace;">/repos/examples/</span> since multiple projects have been selected </li>
+ <li>select all projects a, b, c</li>
+ <li>the wizard automatically moves up the default repository location to the parent folder <span style="font-family:monospace;">/repos/examples/</span> since multiple projects have been selected</li>
<li>click
<b>Create Repository</b> and
<b>Finish</b>
@@ -110,42 +110,42 @@
<br/>
</p>
<h2 id="Starting_from_existing_Git_Repositories">Starting from existing Git Repositories</h2>
- <p>In order to work with the content of a Git repository in the Eclipse workbench, the contained files and folders must be imported as projects. In principle, this import can be done using the generic "New Project" or "Import..." wizards, since the working directory of a Git Repository is just a normal directory in the local file system. However, the newly created projects would still have to be shared manually with Git. The "Import Projects from Git" wizards integrates project import and sharing and also offers some extra convenience. </p>
+ <p>In order to work with the content of a Git repository in the Eclipse workbench, the contained files and folders must be imported as projects. In principle, this import can be done using the generic "New Project" or "Import..." wizards, since the working directory of a Git Repository is just a normal directory in the local file system. However, the newly created projects would still have to be shared manually with Git. The "Import Projects from Git" wizards integrates project import and sharing and also offers some extra convenience.</p>
<h3 id="Starting_the_import_wizard">Starting the import wizard</h3>
<p>To start the wizard click
- <b>Import &gt; Git &gt; Projects from Git</b>
+ <b>Import &gt; Git &gt; Projects from Git</b>
</p>
- <p>If you started in a clean workspace, the first page will display an empty list: </p>
+ <p>If you started in a clean workspace, the first page will display an empty list:</p>
<p>
- <img border="0" src="images/Egit-0.9-import-projects-select-repository.png"/>
+ <img border="0" src="images/Egit-0.9-import-projects-select-repository.png"/>
</p>
- <p>Before you can continue, you need to add one or several Git repositories to the list. If you have already repositories in the list, this step is optional. </p>
+ <p>Before you can continue, you need to add one or several Git repositories to the list. If you have already repositories in the list, this step is optional.</p>
<h3 id="Cloning_or_adding_Repositories">Cloning or adding Repositories</h3>
- <p>There are two ways to add Git repositories to the list: </p>
+ <p>There are two ways to add Git repositories to the list:</p>
<ol>
- <li>Clone a remote repository </li>
+ <li>Clone a remote repository</li>
<li>Add an existing repository from your local file system</li>
</ol>
<h4 id="Cloning_a_Repository">Cloning a Repository</h4>
<p>The first option is used if you start with a remote repository. The clone operation will copy that repository to your local file system. To start the Clone Wizard click
<b>Clone...</b>. The Clone Wizard is described in more detail in
- <a href="Cloning_Remote_Repositories" title="EGit/User Guide#Cloning_Remote_Repositories">Cloning Remote Repositories</a>. Upon successful completion of the clone operation, the newly cloned repository appears in the list automatically.
+ <a href="Cloning_Remote_Repositories" title="EGit/User Guide#Cloning_Remote_Repositories">Cloning Remote Repositories</a>. Upon successful completion of the clone operation, the newly cloned repository appears in the list automatically.
</p>
<h4 id="Adding_a_Repository">Adding a Repository</h4>
<p>The second option is useful if you already have a repository in your local file system, for example because you have cloned it earlier, you created it from scratch or you copied it from somewhere else. Click
<b>Add...</b>; and select a directory in the local file system. Press
- <b>Search</b> to trigger a scan for Git repositories contained in this directory. If Git repositories are found, they will be listed and you can select repositories to add&nbsp;:
+ <b>Search</b> to trigger a scan for Git repositories contained in this directory. If Git repositories are found, they will be listed and you can select repositories to add&nbsp;:
</p>
<p>
- <img border="0" src="images/Egit-0.11-import-projects-add-dialog.png"/>
+ <img border="0" src="images/Egit-0.11-import-projects-add-dialog.png"/>
</p>
- <p>After successful completion, the repository list should contain some repositories: </p>
+ <p>After successful completion, the repository list should contain some repositories:</p>
<p>
- <img border="0" src="images/Egit-0.11-import-projects-filled-list.png"/>
+ <img border="0" src="images/Egit-0.11-import-projects-filled-list.png"/>
</p>
<h3 id="Selecting_a_Repository_from_the_List">Selecting a Repository from the List</h3>
<p>You can now select a repository and click
- <b>Next</b>. On the following wizard page, you will decide how to import projects.
+ <b>Next</b>. On the following wizard page, you will decide how to import projects.
</p>
<h3 id="Importing_projects">Importing projects</h3>
<p>This page offers a group with radio buttons that allow you to select a wizard and a directory tree that optionally allows you to select a folder in the working directory.</p>
@@ -154,33 +154,33 @@
</p>
<h3 id="Wizard_for_project_import">Wizard for project import</h3>
<h4 id="Import_Existing_Projects">Import Existing Projects</h4>
- <p>If this radio button is selected, the wizard will scan the local file system for <tt>.project</tt> files and display the projects found for being imported. This is the most comfortable solution and should be used if <tt>.project</tt> files are checked into the Repository. </p>
+ <p>If this radio button is selected, the wizard will scan the local file system for <tt>.project</tt> files and display the projects found for being imported. This is the most comfortable solution and should be used if <tt>.project</tt> files are checked into the Repository.</p>
<h5 id="Limiting_the_Scope_for_Project_Import">Limiting the Scope for Project Import</h5>
<p>In this case, the directory tree at the bottom is active. You can limit the search for <tt>.project</tt> files by selecting a folder in this tree, otherwise the complete working directory of the repository will be scanned. On the next page, a list of the found projects (if any) will be shown. This is very similar to the generic
- <b>Import Existing Projects</b> wizard, but has some additional filtering capabilities:
+ <b>Import Existing Projects</b> wizard, but has some additional filtering capabilities:
</p>
<p>
- <img border="0" src="images/Egit-0.9-import-projects-select-projects.png"/>
+ <img border="0" src="images/Egit-0.9-import-projects-select-projects.png"/>
</p>
<h4 id="Use_the_New_Projects_Wizard">Use the New Projects Wizard</h4>
- <p>When this option is chosen, the generic "New Project" wizard will open. After completion of the "New Project" wizard, the "Import Projects from Git" wizard will resume and assist with sharing the projects you just created. </p>
- <p>In this case, the directory tree at the bottom is inactive, as the selection is not relevant for the "New Project" wizard. </p>
+ <p>When this option is chosen, the generic "New Project" wizard will open. After completion of the "New Project" wizard, the "Import Projects from Git" wizard will resume and assist with sharing the projects you just created.</p>
+ <p>In this case, the directory tree at the bottom is inactive, as the selection is not relevant for the "New Project" wizard.</p>
<h4 id="Import_as_General_Project">Import as General Project</h4>
- <p>This option can be helpful when there are neither <tt>.project</tt> files available nor a suitable "New Project" wizard applies to the content of the Git Repository. If chosen, the wizard will generate a <tt>.project</tt> file and point the project to a folder of the Repository's working directory. The result is a "General Project". </p>
- <p>By default, the newly generated project will point to the working directory of the Repository. By selecting some folder from the directory tree at the bottom, you can have the project generated for that folder. </p>
+ <p>This option can be helpful when there are neither <tt>.project</tt> files available nor a suitable "New Project" wizard applies to the content of the Git Repository. If chosen, the wizard will generate a <tt>.project</tt> file and point the project to a folder of the Repository's working directory. The result is a "General Project".</p>
+ <p>By default, the newly generated project will point to the working directory of the Repository. By selecting some folder from the directory tree at the bottom, you can have the project generated for that folder.</p>
<p>Click
- <b>Next</b> to open a simple dialog for entering a name and a directory for the new project:
+ <b>Next</b> to open a simple dialog for entering a name and a directory for the new project:
</p>
<p>
- <img border="0" src="images/Egit-0.9-import-projects-general-project.png"/>
+ <img border="0" src="images/Egit-0.9-import-projects-general-project.png"/>
</p>
<p>By default the suggested project name matches the name of the directory.
<br/>
</p>
<h2 id="Working_with_remote_Repositories">Working with remote Repositories</h2>
<h3 id="Cloning_Remote_Repositories">Cloning Remote Repositories</h3>
- <p>Using the Git Clone Wizard you may clone remote repositories using different transport protocols. </p>
- <p>The wizard can be started from the "Import Projects from Git" wizard using
+ <p>Using the Git Clone Wizard you may clone remote repositories using different transport protocols.</p>
+ <p>The wizard can be started from the "Import Projects from Git" wizard using
<br/>
@@ -188,33 +188,33 @@
</p>
<p>or from the "Git Repositories View" (described in
<a href="Managing_Repositories" title="EGit/User_Guide#Managing_Repositories">Managing Repositories</a>) using the
- <b>Clone a Git Repository</b> toolbar button or view menu.
+ <b>Clone a Git Repository</b> toolbar button or view menu.
</p>
<h4 id="Repository_Selection">Repository Selection</h4>
- <p>On the first page of the wizard enter the location of the remote repository: </p>
+ <p>On the first page of the wizard enter the location of the remote repository:</p>
<p>
- <img border="0" src="images/Egit-0.9-clone-wizard-url-page.png"/>
+ <img border="0" src="images/Egit-0.9-clone-wizard-url-page.png"/>
</p>
<ul>
<li>
<b>URI</b> - The complete URI of the remote repository or the path on the file system. This field is automatically synchronized with the other fields.
<br/>Note that you can use the
- <b>Local file...</b> button to browse for a local directory and that the URI field offers content assist by offering previously used values
+ <b>Local file...</b> button to browse for a local directory and that the URI field offers content assist by offering previously used values
</li>
<li>
- <b>Host</b> - The name of the remote host or empty if cloning from the file system.
+ <b>Host</b> - The name of the remote host or empty if cloning from the file system.
</li>
<li>
- <b>Repository Path</b> - Path to the remote repository or on the file system.
+ <b>Repository Path</b> - Path to the remote repository or on the file system.
</li>
<li>
- <b>Protocol</b> - One of the protocols described below.
+ <b>Protocol</b> - One of the protocols described below.
</li>
<li>
- <b>Port</b> - Port number.
+ <b>Port</b> - Port number.
</li>
<li>
- <b>User</b> - The user name used for authentication.
+ <b>User</b> - The user name used for authentication.
</li>
<li>
<b>Password</b> The password used for authentication.
@@ -223,29 +223,29 @@
<b>Store in Secure Store</b> Whether the password is saved in the Eclipse secure store.
</li>
</ul>
- <p>The following protocols are supported: </p>
+ <p>The following protocols are supported:</p>
<ul>
<li>
<b>file</b> - File system access to the repository.
</li>
<li>
<b>ftp</b> -
- <a href="http://tools.ietf.org/html/rfc959" target="egit_external">File Transfer Protocol</a>
+ <a href="http://tools.ietf.org/html/rfc959" target="egit_external">File Transfer Protocol</a>
</li>
<li>
- <b>git</b> - The most efficient built-in git protocol (default port 9418). This protocol doesn't provide authentication. Typically used for anonymous read access to the repository.
+ <b>git</b> - The most efficient built-in git protocol (default port 9418). This protocol doesn't provide authentication. Typically used for anonymous read access to the repository.
</li>
<li>
<b>http</b> -
- <a href="http://tools.ietf.org/html/rfc2616" target="egit_external">Hypertext Transfer Protocol</a> can be tunneled through firewalls.
+ <a href="http://tools.ietf.org/html/rfc2616" target="egit_external">Hypertext Transfer Protocol</a> can be tunneled through firewalls.
</li>
<li>
<b>https</b> -
- <a href="http://tools.ietf.org/html/rfc2818" target="egit_external">Hypertext Transfer Protocol Secure</a> can be tunneled through firewalls.
+ <a href="http://tools.ietf.org/html/rfc2818" target="egit_external">Hypertext Transfer Protocol Secure</a> can be tunneled through firewalls.
</li>
<li>
<b>sftp</b> -
- <a href="http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol" target="egit_external">SSH File Transfer Protocol</a>
+ <a href="http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol" target="egit_external">SSH File Transfer Protocol</a>
</li>
<li>
<b>ssh</b> - Git over
@@ -262,23 +262,23 @@
<i>password</i> fields at the bottom of the wizard page, the credentials will be transmitted as HTTP headers.
</p>
<h4 id="Branch_Selection">Branch Selection</h4>
- <p>On the next page choose which branches shall be cloned from the remote repository: </p>
+ <p>On the next page choose which branches shall be cloned from the remote repository:</p>
<p>
<img border="0" src="images/Egit-0.11-clone-wizard-branch-page.png"/>
</p>
<p>If you are not sure which branches you need, simply hit "Select All".</p>
<p>You can filter the branches by their name by typing using the text control above the list. Note, however, that branches that have been checked will always be shown in the list, i.e. they will not be filtered.</p>
<h4 id="Local_Destination">Local Destination</h4>
- <p>On the next page define where you want to store the repository on the local file system and define some initial settings. </p>
+ <p>On the next page define where you want to store the repository on the local file system and define some initial settings.</p>
<p>
- <img border="0" src="images/Egit-0.9-clone-wizard-destination-page.png"/>
+ <img border="0" src="images/Egit-0.9-clone-wizard-destination-page.png"/>
</p>
<ul>
<li>
- <b>Directory</b> - The directory which will contain the Git repository. It will be created by the wizard if it does not yet exist.
+ <b>Directory</b> - The directory which will contain the Git repository. It will be created by the wizard if it does not yet exist.
</li>
<li>
- <b>Initial branch</b> - Choose here which local branch will be created and initially checked out.
+ <b>Initial branch</b> - Choose here which local branch will be created and initially checked out.
</li>
<li>
<b>Remote name</b> - Define a name for the remote repository. The default is "origin".
@@ -297,10 +297,10 @@
</p>
<h4 id="Gerrit_Configuration">Gerrit Configuration</h4>
<p>If you clone a repository from a
- <a href="http://code.google.com/p/gerrit/" target="egit_external">Gerrit Code Review</a> server you may use this page to
+ <a href="http://code.google.com/p/gerrit/" target="egit_external">Gerrit Code Review</a> server you may use this page to
</p>
<ul>
- <li>specify the push configuration used to push changes to code review </li>
+ <li>specify the push configuration used to push changes to code review</li>
<li>configure your repository to select the
<b>Compute Change-Id for Gerrit Code Review</b> option in the Commit dialog by default
</li>
@@ -314,7 +314,7 @@
<ul>
<li>The fields in the sections
<b>Push URI</b> and
- <b>Push Configuration</b> get enabled.
+ <b>Push Configuration</b> get enabled.
</li>
<li>When you click
<b>Finish</b> the wizard sets the repository configuration parameter
@@ -337,30 +337,30 @@
</p>
<h3 id="Pushing_to_other_Repositories">Pushing to other Repositories</h3>
<h4 id="Pushing_to_upstream">Pushing to upstream</h4>
- <p>If you are working with a local branch which has a so-called "upstream configuration", the most convenient way for pushing relies on this upstream configuration. </p>
+ <p>If you are working with a local branch which has a so-called "upstream configuration", the most convenient way for pushing relies on this upstream configuration.</p>
<p>Typically local branches are created based on a remote tracking branch. Since the remote tracking branch is associated with a remote and the remote contains the information required to access the corresponding remote repository, it is possible to automatically create this upstream configuration while creating the local branch (see
- <a href="Tasks.html#Branching">Branching</a> for more information).
+ <a href="Tasks.html#Branching">Branching</a> for more information).
</p>
<p>When pushing upstream from the local branch, push requires no further parameters and hence can be performed without showing another dialog based on the stored upstream configuration.</p>
<p>In order to push upstream, right-click on a project and select
<b>Team &gt; Push to upstream</b> or right-click on a Repository in the Repositories View and click
<b>Push to upstream</b>. There is also an action available in the
<a href="Reference.html#Git_Workbench_Toolbar_and_Git_Workbench_Menu">Git Command Group</a>.
- <br/>
+ <br/>
</p>
- <p>Push will then be executed immediately after selecting the action. Once finished, a confirmation dialog will be shown displaying information about the pushed data and/or error messages: </p>
+ <p>Push will then be executed immediately after selecting the action. Once finished, a confirmation dialog will be shown displaying information about the pushed data and/or error messages:</p>
<p>
- <img border="0" src="images/Egit-0.11-PushResultDialog.png"/>
+ <img border="0" src="images/Egit-0.11-PushResultDialog.png"/>
</p>
<h5 id="Configuring_upstream_push">Configuring upstream push</h5>
<p>The upstream push can be configured using the "Configure..." button on the confirmation dialog (see above) or by right-clicking a project and selecting
- <b>Team &gt; Remote &gt; Configure push to upstream...</b>.
+ <b>Team &gt; Remote &gt; Configure push to upstream...</b>.
</p>
- <p>A configuration dialog will be shown for configuration of push URIs and corresponding branch mappings (RefSpecs): </p>
+ <p>A configuration dialog will be shown for configuration of push URIs and corresponding branch mappings (RefSpecs):</p>
<p>
- <img border="0" src="images/Egit-0.11-ConfigurePushToUpstream.png"/>
+ <img border="0" src="images/Egit-0.11-ConfigurePushToUpstream.png"/>
</p>
- <p>The dialog is divided into three main sections. In the upper part, information about the current Repository and the currently checked out branch is shown. The outer Group shows the Push Configuration for the remote that is associated with the current branch (in our case, "origin" as shown in the Group text). </p>
+ <p>The dialog is divided into three main sections. In the upper part, information about the current Repository and the currently checked out branch is shown. The outer Group shows the Push Configuration for the remote that is associated with the current branch (in our case, "origin" as shown in the Group text).</p>
<p>In this specific example, there is a warning message that there are several branches that use the remote named "origin". This means that changes in the push configuration will affect all these branches, not just the branch shown in the Branch field.</p>
<p>The URI Group contains two controls, a URI field and a Push URIs list. If the list is empty, the URI in the URI field will be used for Push, if at least one entry is in the Push URIs list, the URIs in the list will be used instead. It should be noted that if the Push URIs list is empty and the URI is changed in this dialog, the new URI will also be used for Pull, so care should be taken when doing so.</p>
<p>The RefMapping Group allows specification of one or several RefSpecs (see
@@ -373,12 +373,12 @@
<p>The buttons in the lower button bar allow you to save your changes and do the push immediately, save the changes without fetching, dry-run (push without saving the configuration), revert your changes, and Cancel.</p>
<h4 id="Direct_Push">Direct Push</h4>
<p>Alternatively, you can use
- <a href="Tasks.html#Direct_Fetch_and_Push_Support">Direct Push Support</a> on a Push Specification of a Remote.
+ <a href="Tasks.html#Direct_Fetch_and_Push_Support">Direct Push Support</a> on a Push Specification of a Remote.
</p>
<h4 id="Push_Wizard">Push Wizard</h4>
<p>The most powerful (but also most complex) way is using the Push Wizard
<br/>
- <b>Team &gt; Remote &gt; Push...</b>
+ <b>Team &gt; Remote &gt; Push...</b>
</p>
<h5 id="Push_URI">Push URI</h5>
<ul>
@@ -395,45 +395,45 @@
</p>
<h5 id="Push_Ref_Specifications">Push Ref Specifications</h5>
<p>See also
- <a href="Reference.html#Refspecs">Refspecs</a> for more explanations.
+ <a href="Reference.html#Refspecs">Refspecs</a> for more explanations.
</p>
<p>Click
<b>Next</b>
- <br/> If this is the first time you connect to this repository via ssh you will have to accept the host key of the remote repository
+ <br/> If this is the first time you connect to this repository via ssh you will have to accept the host key of the remote repository
</p>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-accept-hostkey.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-accept-hostkey.png"/>
</p>
- <p>If your ssh key is protected by a passphrase (which is recommended) you have to enter it here </p>
+ <p>If your ssh key is protected by a passphrase (which is recommended) you have to enter it here</p>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-ssh-passphrase.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-ssh-passphrase.png"/>
</p>
<p>Click
- <b>Add all branches spec</b>
+ <b>Add all branches spec</b>
</p>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-refspec-allbranches.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-refspec-allbranches.png"/>
</p>
- <p>This is a convenient way to declare that you want to map your local branch names to the same branch names on the upstream repository you want to push changes to. </p>
+ <p>This is a convenient way to declare that you want to map your local branch names to the same branch names on the upstream repository you want to push changes to.</p>
<p>Click
- <b>Add all tags spec</b> to map local tags 1:1 to tags in the repository you want to push to.
+ <b>Add all tags spec</b> to map local tags 1:1 to tags in the repository you want to push to.
</p>
- <p>If you want to map local branches to those in the upstream repository in a different way you may define more detailed mapping specifications in the following way </p>
+ <p>If you want to map local branches to those in the upstream repository in a different way you may define more detailed mapping specifications in the following way</p>
<ul>
- <li>enter source and destination ref or select already existing branches from the drop-down lists </li>
+ <li>enter source and destination ref or select already existing branches from the drop-down lists</li>
<li>click
<b>Add spec</b>
</li>
</ul>
<p>This will transfer the newly defined mapping to the list
- <b>Specifications for push</b>
+ <b>Specifications for push</b>
</p>
<p>
- <b>Other common push specs:</b>
+ <b>Other common push specs:</b>
</p>
<ul>
<li>You may e.g. map <tt>refs/heads/*</tt> to <tt>refs/heads/joe/*</tt> if you want to name the branches you push to according to your nickname
- <i>joe</i>. This is useful if multiple users want to publish their local branches on personal branches in a jointly used public repository.
+ <i>joe</i>. This is useful if multiple users want to publish their local branches on personal branches in a jointly used public repository.
</li>
<li>Another usual mapping is to map the source ref <tt>HEAD</tt> to the destination <tt>refs/heads/master</tt>. This means you want to map your current <tt>HEAD</tt> (which might currently point e.g. to any local topic branch) to the upstream master branch.</li>
</ul>
@@ -441,31 +441,31 @@
<p>To delete a ref in the destination repository select the ref to be deleted from the drop-down list
<b>Remote ref to delete</b> and click
<b>Add spec</b>. This will create a corresponding entry in the
- <b>Specifications for push</b> list. Alternatively you may type in the specification for the refs to be deleted, this may also use wildcards. Pushing Delete Ref Specifications will delete the matching Refs in the destination repository.
+ <b>Specifications for push</b> list. Alternatively you may type in the specification for the refs to be deleted, this may also use wildcards. Pushing Delete Ref Specifications will delete the matching Refs in the destination repository.
</p>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-delete-refspec.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-delete-refspec.png"/>
</p>
<h5 id="Conflicting_Push_Ref_Specifications">Conflicting Push Ref Specifications</h5>
<p>If you add multiple conflicting Push Ref Specifications they will be marked in red, solve this by removing or editing the conflicting specs. It is also possible to edit the specs in-place in the list
- <b>Specifications for push</b>
+ <b>Specifications for push</b>
</p>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-refspec-conflict.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-refspec-conflict.png"/>
</p>
<h5 id="Push_Confirmation">Push Confirmation</h5>
<p>Click
- <b>Next</b>
+ <b>Next</b>
</p>
<p>This will open the Push Confirmation dialog showing a preview which changes will be pushed to the destination repository. If this does not match your expectation click
- <b>Back</b> and correct your push specs accordingly.
+ <b>Back</b> and correct your push specs accordingly.
</p>
<ul>
<li>For ref updates the range of commits to be pushed will be shown in the format <tt>
<b>&lt;SHA1-from&gt;..&lt;SHA1-to&gt;</b></tt> e.g. <tt>
<b>d97f5a2e..adfdbfd2</b></tt> means all commits between <tt>
<b>d97f5a2e</b></tt> and <tt>
- <b>adfdbfd2</b></tt> will be pushed.
+ <b>adfdbfd2</b></tt> will be pushed.
</li>
<li>For refs which do not yet exist in the destination repository <tt>
<b>
@@ -473,7 +473,7 @@
</b></tt> or <tt>
<b>
<a href="new">tag</a>
- </b></tt> is displayed.
+ </b></tt> is displayed.
</li>
<li>For refs which will be delete <tt>
<b>
@@ -482,11 +482,11 @@
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-confirm-push.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-confirm-push.png"/>
</p>
<ul>
<li>Select the
- <b>Push only if remote refs don't change in the mean time</b> check box if you want to be sure that what you see in this preview is also what you get when pushing these changes out.
+ <b>Push only if remote refs don't change in the mean time</b> check box if you want to be sure that what you see in this preview is also what you get when pushing these changes out.
</li>
<li>Select the
<b>Show final report dialog only when it differs from this confirmation report</b> check box if you only want to get a report after executing the push if the result differs from this preview.
@@ -494,13 +494,13 @@
</ul>
<h5 id="Push_Result_Report">Push Result Report</h5>
<p>Click
- <b>Finish</b>
+ <b>Finish</b>
</p>
- <p>Depending on the options you have chosen a push result report dialog is shown </p>
+ <p>Depending on the options you have chosen a push result report dialog is shown</p>
<p>
- <img border="0" src="images/Egit-0.9-push-wizard-push-result.png"/>
+ <img border="0" src="images/Egit-0.9-push-wizard-push-result.png"/>
</p>
- <p>In the box at the bottom the push confirmation message from the remote server is displayed. In case of any errors you will find the error message from the remote server here. To see the message for a given list entry simply select it in the list. </p>
+ <p>In the box at the bottom the push confirmation message from the remote server is displayed. In case of any errors you will find the error message from the remote server here. To see the message for a given list entry simply select it in the list.</p>
<p>Click
<b>Ok</b> to close the dialog.
<br/>
@@ -524,13 +524,13 @@
</p>
<h5 id="Configuring_upstream_fetch">Configuring upstream fetch</h5>
<p>The upstream fetch can be configured using the "Configure..." button on the confirmation dialog (see above) or by clicking
- <b>Team &gt; Remote &gt; Configure fetch from upstream...</b> on a project.
+ <b>Team &gt; Remote &gt; Configure fetch from upstream...</b> on a project.
</p>
<p>A configuration dialog will be shown for configuring the fetch URI and branch mappings (RefSpecs):</p>
<p>
<img border="0" src="images/Egit-0.11-ConfigureFetchFromUpstream.png"/>
</p>
- <p>The dialog is divided into three main sections. In the upper part, information about the current Repository and the currently checked out branch is shown. The outer Group shows the Fetch Configuration for the remote that is associated with the current branch (in our case, "origin" as shown in the Group text). </p>
+ <p>The dialog is divided into three main sections. In the upper part, information about the current Repository and the currently checked out branch is shown. The outer Group shows the Fetch Configuration for the remote that is associated with the current branch (in our case, "origin" as shown in the Group text).</p>
<p>The URI field can be used to add/change the fetch URI.</p>
<p>The RefMapping Group allows specification of one or several RefSpecs (see
<a href="Reference.html#Refspecs">Refspecs</a>) for Fetch.
@@ -575,31 +575,31 @@
<p>Click
<b>Next</b>
<br/> Click
- <b>Add all branches spec</b>
+ <b>Add all branches spec</b>
</p>
<p>
- <img border="0" src="images/Egit-0.9-fetch-wizard-refspec.png"/>
+ <img border="0" src="images/Egit-0.9-fetch-wizard-refspec.png"/>
</p>
- <p>This is a convenient way to declare that you want to map the branch names in the upstream repository you want to fetch changes from 1:1 to the same local branch names. </p>
+ <p>This is a convenient way to declare that you want to map the branch names in the upstream repository you want to fetch changes from 1:1 to the same local branch names.</p>
<ul>
<li>Click in the edit field
<b>Destination Ref</b> and replace the path segment
- <i>choose_remote_name</i> with a symbolic name for the upstream repository you are going to fetch from.
+ <i>choose_remote_name</i> with a symbolic name for the upstream repository you are going to fetch from.
</li>
<li>The default remote name for the repository your repository has been cloned from is <tt>
<b>origin</b></tt>. The master of this remote maps by default from <tt>
<b>refs/heads/master</b></tt> to <tt>
- <b>refs/remotes/origin/master</b></tt>.
+ <b>refs/remotes/origin/master</b></tt>.
</li>
<li>If you e.g. want to additionally track branches from Joe's repository in your local repository you would map the branch in his repository <tt>
<b>refs/heads/*</b></tt> to the following tracking branches <tt>
- <b>refs/remotes/joe/*</b></tt>.
+ <b>refs/remotes/joe/*</b></tt>.
</li>
<li>Deselect
- <b>Force Update</b> if you want to allow fast-forward updates only, select this option if you also want to allow non-fast-forward changes.
+ <b>Force Update</b> if you want to allow fast-forward updates only, select this option if you also want to allow non-fast-forward changes.
</li>
<li>Click
- <b>Force Update all Refs</b> to set the force update option on all specs
+ <b>Force Update all Refs</b> to set the force update option on all specs
</li>
<li>Click
<b>Remove all specs</b> to remove all specs from the list
@@ -611,9 +611,9 @@
<b>Add all tags spec</b> to map tags tags in the repository you want to fetch from 1:1 to local tags.
</li>
</ul>
- <p>If you want to map branches or tags in the upstream repository to local branches in a different way you may define more detailed mapping specifications in the following way </p>
+ <p>If you want to map branches or tags in the upstream repository to local branches in a different way you may define more detailed mapping specifications in the following way</p>
<ul>
- <li>enter source (ref in source repository) and destination ref (tracking branch or tag in local repository) or select already existing branches from the drop-down lists </li>
+ <li>enter source (ref in source repository) and destination ref (tracking branch or tag in local repository) or select already existing branches from the drop-down lists</li>
<li>click
<b>Add spec</b>
</li>
@@ -634,7 +634,7 @@
<b>&lt;SHA1-from&gt;..&lt;SHA1-to&gt;</b></tt> e.g. <tt>
<b>d97f5a2e..adfdbfd2</b></tt> means all commits between <tt>
<b>d97f5a2e</b></tt> and <tt>
- <b>adfdbfd2</b></tt> have been fetched.
+ <b>adfdbfd2</b></tt> have been fetched.
</li>
<li>For refs which didn't exist before in the local repository <tt>
<b>&#91;new branch&#93;</b></tt> or <tt>
@@ -649,19 +649,20 @@
</p>
<h3 id="Pulling_New_Changes_from_Upstream_Branch">Pulling New Changes from Upstream Branch</h3>
<ul>
- <li>Click
- <b>Team &gt; Pull</b> to pull new changes from the upstream branch your local branch is tracking. This also works if resources are selected from more than one repository.
+ <li>Right-click on a project in the Package Explorer and select
+ <b>Team &gt; Pull</b> or right-click on a repository in the Git Repositories view and select
+ <b>Pull</b> to pull new changes from the upstream branch your local branch is tracking. This also works if resources are selected from more than one repository.
</li>
<li>Whenever you create a local branch based on a remote tracking branch EGit can configure a tracking relationship so that subsequent pulls will fetch and then merge or rebase (depending on the configuration of this tracking relationship) the changes from the tracked upstream branch; see
<a href="Tasks.html#Branching">Branching</a> for details.
</li>
</ul>
- <p>Ad-hoc selection of the upstream branch to pull from is not yet supported by EGit. </p>
- <p>Available alternatives include: </p>
+ <p>Ad-hoc selection of the upstream branch to pull from is not yet supported by EGit.</p>
+ <p>Available alternatives include:</p>
<ul>
<li>run
<b>git pull</b> from outside eclipse (but
- <a href="http://marc.info/?l=git&amp;m=123924844219075" target="egit_external">beware on Windows</a>)
+ <a href="http://marc.info/?l=git&amp;m=123924844219075" target="egit_external">beware on Windows</a>)
</li>
<li>if you did no local change or want to discard your local changes, use
<b>Team &gt; Reset...</b>
@@ -673,20 +674,20 @@
</p>
<h3 id="Fetching_a_change_from_a_Gerrit_Code_Review_Server">Fetching a change from a Gerrit Code Review Server</h3>
<p>If you are working with Gerrit (
- <a href="http://code.google.com/p/gerrit/" target="egit_external">http://code.google.com/p/gerrit/</a>), EGit allows you to conveniently fetch a change into your local Repository for inspection and/or modification.
+ <a href="http://code.google.com/p/gerrit/" target="egit_external">http://code.google.com/p/gerrit/</a>), EGit allows you to conveniently fetch a change into your local Repository for inspection and/or modification.
</p>
<p>Right-click on a project and select
<b>Team &gt; Remote &gt; Fetch from Gerrit...</b> or right-click on a Repository node in the Repositories View and select
- <b>Fetch from Gerrit...</b>
+ <b>Fetch from Gerrit...</b>
</p>
- <p>A dialog will appear that lets you select or enter a URI and a change as well as some additional options: </p>
+ <p>A dialog will appear that lets you select or enter a URI and a change as well as some additional options:</p>
<p>
- <img border="0" src="images/Egit-0.11-fetchChangeFromGerritDialog.png"/>
+ <img border="0" src="images/Egit-0.11-fetchChangeFromGerritDialog.png"/>
</p>
<ul>
- <li>In the URI combo, select or enter the URI that points to your Gerrit instance; the combo will be pre-filled with all URIs defined in any remote of your current Repository; in addition you can type any URI into this field </li>
+ <li>In the URI combo, select or enter the URI that points to your Gerrit instance; the combo will be pre-filled with all URIs defined in any remote of your current Repository; in addition you can type any URI into this field</li>
<li>In the Change field, you must enter the full name of a change; you can either take this value from the Gerrit Web UI, use the content assist described below, or build the name using the following pattern:
- <br/>"refs/changes/" + (last two digits from change number) + / + (change number) + / + (revision number)
+ <br/>"refs/changes/" + (last two digits from change number) + / + (change number) + / + (revision number)
</li>
<li>In the "Actions to perform after fetch" you can decide what to do after the change has been fetched; you can either create and checkout a branch pointing to the change, create and checkout a tag pointing to the change, or simply checkout the change (thus making HEAD detached); the last option does nothing after fetch, but you will be able to find the commit pertaining to the change at FETCH_HEAD (go to the Repositories View and find FETCH_HEAD under the References node of your Repository, see
<a href="Tasks.html#Inspecting_References">Inspecting References </a>).
@@ -694,31 +695,31 @@
<br/>Since deletion of tags is currently not supported in EGit, we suggest to use local branches rather than tags for the time being. Since the Repositories view allows to group branches hierarchically using "/" as hierarchy separator, the suggested names can come in very handy when dealing with large numbers of changes.
</li>
</ul>
- <p>Instead of the tedious copy-paste or manual entering of the change ID, the dialog also offers a content assist for the change. Simply press "CTRL-SPACE" to activate this (consult the tooltip that appears when hovering over the little bulb decorator near the Change field). The Gerrit Server will be contacted and all available changes will be fetched and shown in a content assist dialog: </p>
+ <p>Instead of the tedious copy-paste or manual entering of the change ID, the dialog also offers a content assist for the change. Simply press "Ctrl+Space" to activate this (consult the tooltip that appears when hovering over the little bulb decorator near the Change field). The Gerrit Server will be contacted and all available changes will be fetched and shown in a content assist dialog:</p>
<p>
- <img border="0" src="images/Egit-0.11-ContentAssistGerritChange.png"/>
+ <img border="0" src="images/Egit-0.11-ContentAssistGerritChange.png"/>
</p>
<p>The list will be filtered with your input in the change field. After selecting the change in the content assist, the Change field will be filled with the correct information.</p>
<h2 id="Inspecting_the_state_of_the_Repository">Inspecting the state of the Repository</h2>
<h3 id="Label_Decorations">Label Decorations</h3>
- <p>Label decorations show Git specific information on resources under Git version control. They appear in all views showing model objects, like Package Explorer, Project Explorer, Navigator, Hierarchy View. </p>
+ <p>Label decorations show Git specific information on resources under Git version control. They appear in all views showing model objects, like Package Explorer, Project Explorer, Navigator, Hierarchy View.</p>
<p>The Git label decorations can be switched on globally in the Preference Menu (
<b>Window &gt; Preferences</b>) under
- <b>General &gt; Appearance &gt; Label Decorations</b>.
+ <b>General &gt; Appearance &gt; Label Decorations</b>.
</p>
<p>More detailed settings can be done in the Preferences under
- <b>Team &gt; Git &gt; Label Decorations</b>.
+ <b>Team &gt; Git &gt; Label Decorations</b>.
</p>
- <p>There are two different types of label decorations: text decorations and icon decorations. </p>
+ <p>There are two different types of label decorations: text decorations and icon decorations.</p>
<h4 id="Text_Decorations">Text Decorations</h4>
<p>Text decorations appear on the left or right side of the text label. They can be configured on the Preferences dialog under
<b>Team &gt; Git &gt; Label Decorations</b> on the tab
<b>Text Decorations</b>. For example, the default for a dirty resource is a <tt>
- <b>&gt;</b></tt> on the left side of its name.
+ <b>&gt;</b></tt> on the left side of its name.
</p>
- <p>These are the default settings: </p>
+ <p>These are the default settings:</p>
<p>
- <img border="0" src="images/01-TextDecorations.png"/>
+ <img border="0" src="images/01-TextDecorations.png"/>
</p>
<p>For files and folders there are the variables <tt>"name"</tt>, <tt>"dirty"</tt> and <tt>"staged"</tt>. <tt>"Dirty"</tt> and <tt>"staged"</tt> are flags; if they are true, the text after the colon is displayed.</p>
<p>For projects there are the additional variables <tt>"repository"</tt> and <tt>"branch"</tt>. The <tt>"repository"</tt> variable displays the name of the repository.</p>
@@ -734,43 +735,43 @@
<h4 id="Icon_Decorations">Icon Decorations</h4>
<p>Icon decorations appear on the lower right corner of the icon displayed in front of the label. They can be configured on the Preferences dialog under
<b>Team &gt; Git &gt; Label Decorations</b> on the tab
- <b>Icon Decorations</b>.
+ <b>Icon Decorations</b>.
</p>
- <p>These are the default decorations: </p>
+ <p>These are the default decorations:</p>
<p>
- <img border="0" src="images/02-IconDecorations.png"/>
+ <img border="0" src="images/02-IconDecorations.png"/>
</p>
<ul>
<li>
- <b>dirty (folder)</b> - At least one file below the folder is dirty; that means that it has changes in the working tree that are neither in the index nor in the repository.
+ <b>dirty (folder)</b> - At least one file below the folder is dirty; that means that it has changes in the working tree that are neither in the index nor in the repository.
</li>
<li>
- <b>tracked</b> - The resource is known to the Git repository and hence under version control.
+ <b>tracked</b> - The resource is known to the Git repository and hence under version control.
</li>
<li>
- <b>untracked</b> - The resource is not known to the Git repository and will not be version controlled until it is explicitly added.
+ <b>untracked</b> - The resource is not known to the Git repository and will not be version controlled until it is explicitly added.
</li>
<li>
<b>ignored</b> - The resource is ignored by the Git team provider. The preference settings under
- <b>Team &gt; Ignored Resources</b>, "derived" flag and settings from <tt>.gitignore</tt> files are taken into account.
+ <b>Team &gt; Ignored Resources</b>, "derived" flag and settings from <tt>.gitignore</tt> files are taken into account.
</li>
<li>
- <b>dirty</b> - The resource has changes in the working tree that are neither in the index nor in the repository.
+ <b>dirty</b> - The resource has changes in the working tree that are neither in the index nor in the repository.
</li>
<li>
- <b>staged</b> - The resource has changes which have been added to the index. Note that adding changes to the index is currently possible only in the commit dialog via the context menu of a resource.
+ <b>staged</b> - The resource has changes which have been added to the index. Note that adding changes to the index is currently possible only in the commit dialog via the context menu of a resource.
</li>
<li>
- <b>partially-staged</b> - The resource has changes which are added to the index and additional changes in the working tree that neither reached the index nor have been committed to the repository.
+ <b>partially-staged</b> - The resource has changes which are added to the index and additional changes in the working tree that neither reached the index nor have been committed to the repository.
</li>
<li>
- <b>added</b> - The resource has not yet reached any commit in the repository but has been freshly added to the Git repository in order to be tracked in future.
+ <b>added</b> - The resource has not yet reached any commit in the repository but has been freshly added to the Git repository in order to be tracked in future.
</li>
<li>
- <b>removed</b> - The resource is staged for removal from the Git repository.
+ <b>removed</b> - The resource is staged for removal from the Git repository.
</li>
<li>
- <b>conflict</b> - A merge conflict exists for the file.
+ <b>conflict</b> - A merge conflict exists for the file.
</li>
<li>
<b>assume-valid</b> - The resource has the "assume unchanged" flag. This means that Git stops checking the working tree files for possible modifications, so you need to manually unset the bit to tell Git when you change the working tree file. Also see
@@ -799,7 +800,7 @@
</p>
<h4 id="Compare_working_tree_with_last_commit">Compare working tree with last commit</h4>
<p>The difference between a resource in the current working directory and in the last commit in the current branch can be viewed from the context menu
- <b>Compare With &gt; HEAD revision</b>. This feature is also available in the Commit dialog. Double clicking on an entry in the Commit dialog opens a compare dialog.
+ <b>Compare With &gt; HEAD revision</b>. This feature is also available in the Commit dialog. Double clicking on an entry in the Commit dialog opens a compare dialog.
</p>
<h4 id="Comparing_Working_Tree_with_Index">Comparing Working Tree with Index</h4>
<p>The differences between the current working tree and the index (based on the currently selected resource) can be viewed from the context menu
@@ -807,52 +808,52 @@
</p>
<h4 id="Comparing_Working_Tree_with_a_branch.2C_a_tag_or_a_reference">Comparing Working Tree with a branch, a tag or a reference</h4>
<ul>
- <li>Select a resource </li>
+ <li>Select a resource</li>
<li>right-click
- <b>Compare With &gt; Branch, Tag, or Reference...</b>
+ <b>Compare With &gt; Branch, Tag, or Reference...</b>
</li>
<li>select a branch, tag or reference</li>
</ul>
<h4 id="Comparing_Working_Tree_with_Any_Commit">Comparing Working Tree with Any Commit</h4>
<h5 id="From_the_project_explorer:">From the project explorer:</h5>
<ul>
- <li>Select a resource </li>
+ <li>Select a resource</li>
<li>right-click
- <b>Compare With &gt; Commit...</b>
+ <b>Compare With &gt; Commit...</b>
</li>
<li>select a commit from the commit graph</li>
</ul>
<h5 id="From_the_history_view_.28files_only.29:">From the history view (files only):</h5>
<ul>
- <li>Select a file in the package explorer </li>
+ <li>Select a file in the package explorer</li>
<li>right-click
<b>Team &gt; Show in History</b> or
- <b>Compare With &gt; History...</b>
+ <b>Compare With &gt; History...</b>
</li>
- <li>in the commit graph select a commit </li>
+ <li>in the commit graph select a commit</li>
<li>from the context menu select
- <b>Compare with working tree</b>
+ <b>Compare with working tree</b>
</li>
<li>this will open a compare dialog showing the changes between the selected commit and the current working tree</li>
</ul>
<h4 id="Comparing_Two_Commits">Comparing Two Commits</h4>
<ul>
- <li>Select a resource in the Package Explorer </li>
+ <li>Select a resource in the Package Explorer</li>
<li>click
<b>Team &gt; Show in History</b> or
- <b>Compare With &gt; History...</b> (the latter for files only)
+ <b>Compare With &gt; History...</b> (the latter for files only)
</li>
- <li>in the commit graph select two commits </li>
+ <li>in the commit graph select two commits</li>
<li>right-click
- <b>Compare with each other</b>
+ <b>Compare with each other</b>
</li>
- <li>this will open a compare dialog showing the changes between the two selected commits </li>
+ <li>this will open a compare dialog showing the changes between the two selected commits</li>
<li>you can also open a Git Tree Compare view by right-clicking
<b>Compare with each other in Tree</b>
</li>
</ul>
<h4 id="Comparing_Index_with_HEAD_or_Any_Other_Commit">Comparing Index with HEAD or Any Other Commit</h4>
- <p>This feature is not implemented yet. </p>
+ <p>This feature is not implemented yet.</p>
<p>
<br/>
</p>
@@ -860,7 +861,7 @@
<p>The difference between the working tree (including not committed changes) and a branch or tag can be viewed by clicking the dynamic menu
<b>Team &gt; Synchronize</b> on a project and selecting the
<i>Ref</i> you want to synchronize your working tree against. If the Git repository contains multiple Eclipse projects it is sufficient to select one project, the
- <b>Synchronization View</b> will also include all other projects.
+ <b>Synchronization View</b> will also include all other projects.
</p>
<p>
<img border="0" src="images/Egit-1.0-synchronize-dynamic.png"/>
@@ -874,31 +875,31 @@
<p>When clicking "Include local uncommited changes in comparison" also local, not yet staged changes and the already staged changes will be shown in comparison.</p>
<p>It is also possible to compare multiple repositories at once. In this case in the Synchronize Wizard select for each repository the Ref you want to compare against.</p>
<h3 id="Quickdiff">Quickdiff</h3>
- <p>Instead of using a compare editor you can enable quick diff support and see the changes within the text editor.
+ <p>Instead of using a compare editor you can enable quick diff support and see the changes within the text editor.
<br/>This feature can be enabled via the
- <b>General &gt; Editors &gt; Text Editors &gt; Quick Diff</b> preference page:
+ <b>General &gt; Editors &gt; Text Editors &gt; Quick Diff</b> preference page:
</p>
<p>
- <img border="0" src="images/04-QuickDiffPreferences.png"/>
+ <img border="0" src="images/04-QuickDiffPreferences.png"/>
</p>
- <p>The difference annotation will then be displayed on the left hand side of the editor: </p>
+ <p>The difference annotation will then be displayed on the left hand side of the editor:</p>
<p>
- <img border="0" src="images/05-QuickDiffInEditor.png"/>
+ <img border="0" src="images/05-QuickDiffInEditor.png"/>
</p>
- <p>If you move your mouse over the annotation you see the content of the version you are comparing to: </p>
+ <p>If you move your mouse over the annotation you see the content of the version you are comparing to:</p>
<p>
- <img border="0" src="images/06-QuickDiffInEditorPopup.png"/>
+ <img border="0" src="images/06-QuickDiffInEditorPopup.png"/>
</p>
<p>Per default, the comparison is against the HEAD. You can determine the version you are comparing to, the so-called quickdiff baseline, from the context menu of a commit in the history view (
- <b>Show in &gt; History</b>). There are three menu entries:
+ <b>Show in &gt; History</b>). There are three menu entries:
</p>
<ul>
<li>
<b>Quick Diff -&gt; Reset baseline to first parent of HEAD</b> - Compare against the first commit before HEAD.
</li>
<li>
- <b>Quick Diff -&gt; Reset baseline to HEAD</b> - Compare against HEAD.
+ <b>Quick Diff -&gt; Reset baseline to HEAD</b> - Compare against HEAD.
</li>
<li>
<b>Quick Diff -&gt; Set as baseline</b> - Compare against the selected commit
@@ -908,12 +909,12 @@
<br/>
</p>
<h3 id="Inspecting_Commits">Inspecting Commits</h3>
- <p>To inspect a given commit </p>
+ <p>To inspect a given commit</p>
<ul>
<li>from the context menu in package explorer select
- <b>Team &gt; Show in History</b>
+ <b>Team &gt; Show in History</b>
</li>
- <li>select the commit you want to inspect </li>
+ <li>select the commit you want to inspect</li>
</ul>
<p>
<img border="0" src="images/EGit-0.7-ViewDiffInResourceHistory.png"/>
@@ -923,25 +924,25 @@
<h4 id="Showing_the_contents_of_a_Commit">Showing the contents of a Commit</h4>
<p>The behavior of a double click on a file in the lower right pane depends on the state of the compare mode toggle button. If it's on, a compare editor will be opened which compares the file content in the current commit with the content in the ancestor commit; if it's off, an editor will be opened showing the file content in the current commit.</p>
<h2 id="Committing_Changes">Committing Changes</h2>
- <p>Modifications to a project under git version control are persisted in the git history through commits. Starting from the state checked out from the git repository modify your project until you have reached a state you are satisfied with and then commit all these changes into the repository as one single commit. Each commit represents a well defined snapshot of all the files stored in the repository. </p>
+ <p>Modifications to a project under git version control are persisted in the git history through commits. Starting from the state checked out from the git repository modify your project until you have reached a state you are satisfied with and then commit all these changes into the repository as one single commit. Each commit represents a well defined snapshot of all the files stored in the repository.</p>
<h3 id="Modifying_the_content">Modifying the content</h3>
<p>To modify a project which is already shared with Git modify or delete files either within Eclipse or directly in the file system. There is no need to tell Git in advance about these operations. New files which should be version-controlled have to be explicitly put under Git version control :</p>
<ul>
<li>click
- <b>Team &gt; Add</b> in the file's context menu
+ <b>Team &gt; Add</b> in the file's context menu
</li>
</ul>
<p>Alternatively you may display untracked files in the Commit dialog and check the
- <b>Show untracked Files</b> checkbox to select them for inclusion into the commit.
+ <b>Show untracked Files</b> checkbox to select them for inclusion into the commit.
</p>
- <p>Label decorators e.g. in the Package Explorer View show </p>
+ <p>Label decorators e.g. in the Package Explorer View show</p>
<ul>
<li>untracked files which are not yet under git version control (marked with "?")</li>
- <li>files which have been added (marked with "+") </li>
+ <li>files which have been added (marked with "+")</li>
<li>modified files (marked with "&gt;" in front of the filename)</li>
</ul>
<p>For details see
- <a href="Tasks.html#Label_Decorations">Label Decorations</a>.
+ <a href="Tasks.html#Label_Decorations">Label Decorations</a>.
</p>
<p>Here is an example in the Package Explorer for</p>
<ul>
@@ -949,31 +950,36 @@
<li>a file modified in the working tree but not yet staged for the next commit</li>
<li>a modified file which modifications have been staged for the next commit</li>
<li>a file which has been newly staged for first-time inclusion with the next commit</li>
- <li>a file which is not under git version control </li>
+ <li>a file which is not under git version control</li>
</ul>
<p>
<img border="0" src="images/Egit-0.9-label-decorators.png"/>
</p>
<h3 id="Committing">Committing</h3>
<p>To commit a change click
- <b>Team &gt; Commit...</b> in the context menu of a resource in the project.
+ <b>Team &gt; Commit...</b> in the context menu of a resource in the project.
</p>
- <p>Git tracks all changes made to the entire repository capturing the modifications of all version-controlled files in that repository not regarding if these files reside in the same Eclipse project or not. </p>
+ <p>Git tracks all changes made to the entire repository capturing the modifications of all version-controlled files in that repository not regarding if these files reside in the same Eclipse project or not.</p>
<p>Once you have triggered the commit the
- <b>Commit Dialog</b> will pop-up
+ <b>Commit Dialog</b> will pop-up
</p>
<p>
- <img border="0" src="images/Egit-0.9-commit-dialog.png"/>
+ <img border="0" src="images/Egit-0.9-commit-dialog.png"/>
</p>
<h4 id="Commit_Message">Commit Message</h4>
- <p>In the Commit Dialog you specify the commit message describing the change. </p>
- <p>It is good practice to start the message with a short first line summarizing the change followed by a blank line and then the message body. In order to ensure that also git command line tools can format these messages nicely the lines shouldn't be formatted too wide (this is indicated by a grey vertical line). The commit message text is checked for errors by the Eclipse spell checker. The spell checker can be configured via the Eclipse
- <b>Preferences &gt; General &gt; Editors &gt; Text Editors &gt; Spelling</b>. Click
- <b>Ctrl - 1</b> to open quick fixes which may help to fix the spelling errors.
- </p>
+ <p>In the Commit Dialog you specify the commit message describing the change.</p>
+ <p>It is good practice to start the message with a short first line summarizing the change followed by a blank line and then the message body. In order to ensure that also git command line tools can format these messages nicely the lines shouldn't be formatted too wide (this is indicated by a grey vertical line).</p>
<p>
<img border="0" src="images/Egit-0.9-commit-dialog-spell-quickfix.png"/>
</p>
+ <p>The commit message text is checked for errors by the Eclipse spell checker. The spell checker can be configured via the Eclipse
+ <b>Preferences &gt; General &gt; Editors &gt; Text Editors &gt; Spelling</b>. Press
+ <b>Ctrl+1</b> to open quick fixes which may help to fix the spelling errors.
+ </p>
+ <p>
+ <img border="0" src="images/Egit-1.2-commit-dialog-path-assist.png"/>
+ </p>
+ <p>The commit message editor supports content assist for file names shown in Files section of the commit dialog, which can be activated pressing Ctrl-Space.</p>
<p>
<b>Footer Tags</b>
@@ -1003,38 +1009,38 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
<b>Team &gt; Git &gt; Commit Dialog</b> is set the corresponding checkbox in the Commit Dialog is always preselected.
</li>
</ul>
- <p>Additionally this dialog controls which of the changes will be included in the commit. If you clear the checkbox in front of a file, the changes to this file will not be included in the commit. The local file in your eclipse workspace will still contain the modifications giving you the chance to commit these changes with a subsequent commit. This feature is often used to separate modifications done to a set of files into different commits. </p>
+ <p>Additionally this dialog controls which of the changes will be included in the commit. If you clear the checkbox in front of a file, the changes to this file will not be included in the commit. The local file in your eclipse workspace will still contain the modifications giving you the chance to commit these changes with a subsequent commit. This feature is often used to separate modifications done to a set of files into different commits.</p>
<p>
- <b>One example:</b> Imagine since the last commit you have fixed a bug in A.java and you have added a new method to B.java. These two modifications are logically independent from each other hence you may want to commit them in two independant commits. In this case you initate the commit, deselect B.java from the set of committed files and specify a commit message describing only the bugfix in A.java. After a succesfull first commit you just call commit again and the upcoming dialog will present you the remaining changes in B.java. Now you specify a commit message describing the addition of the method and finish the second commit.
+ <b>One example:</b> Imagine since the last commit you have fixed a bug in A.java and you have added a new method to B.java. These two modifications are logically independent from each other hence you may want to commit them in two independant commits. In this case you initate the commit, deselect B.java from the set of committed files and specify a commit message describing only the bugfix in A.java. After a succesfull first commit you just call commit again and the upcoming dialog will present you the remaining changes in B.java. Now you specify a commit message describing the addition of the method and finish the second commit.
</p>
<p>New files you added to the project which have not been explicitly added to version control (see "Modifying the content") will be listed in the commit dialog if you select the checkbox "Show untracked Files". If you select the checkbox in front of these files in the list they will be added to the repository and committed once you press the commit button. Files which are excluded by the team ignore list or a <tt>.gitignore</tt> file or which are derived (e.g. the bin folder in java projects) will not be shown here. If you have no other changes in your repository than such untracked files the checkbox
<b>Show untracked Files</b> is selected by default.
</p>
<h4 id="Amending_Commits">Amending Commits</h4>
- <p>If you recognize that you missed something when committing a change you may fix this : open the commit dialog again and specify that the current commit shall "amend" the previous commit in the current branch. The new commit will then replace the previous one. This feature is often used to correct wrong commits before they are published to other repositories. </p>
+ <p>If you recognize that you missed something when committing a change you may fix this : open the commit dialog again and specify that the current commit shall "amend" the previous commit in the current branch. The new commit will then replace the previous one. This feature is often used to correct wrong commits before they are published to other repositories.</p>
<p>
<b>Note:</b> do not amend commits if they have already been published to a shared repository since this may disturb others if they already based their changes on the published change.
</p>
<p>
- <b>Amend example:</b>
+ <b>Amend example:</b>
- <br/>Imagine you have committed a change to a file containing a typo
+ <br/>Imagine you have committed a change to a file containing a typo
</p>
<p>
- <img border="0" src="images/EGit-Typo.png"/>
+ <img border="0" src="images/EGit-Typo.png"/>
</p>
- <p>After committing the change you detect a typo. In order to correct this typo and the corresponding commit you just fix the typo in the source file </p>
+ <p>After committing the change you detect a typo. In order to correct this typo and the corresponding commit you just fix the typo in the source file</p>
<p>
- <img border="0" src="images/EGit-Corrected.png"/>
+ <img border="0" src="images/EGit-Corrected.png"/>
</p>
<p>then open the Commit Dialog again and select the option
- <b>Amend previous commit</b>.
+ <b>Amend previous commit</b>.
</p>
<p>
- <img border="0" src="images/Egit-0.9-commit-dialog-amend.png"/>
+ <img border="0" src="images/Egit-0.9-commit-dialog-amend.png"/>
</p>
- <p>The commit message of your previous commit (the one you want to replace) is filled into the "Commit Message" field. This gives you the chance not only to correct errors in the content of the version-controlled files but to also correct errors (e.g. typos) in the commit message describing your change. </p>
- <p>As an alternative to amending you could just commit the corrected version as a subsequent commit. But the first commit containing the typo is of no use to anybody and in order not to clutter the history of your project with unneeded commits you may decide to amend the commit. </p>
+ <p>The commit message of your previous commit (the one you want to replace) is filled into the "Commit Message" field. This gives you the chance not only to correct errors in the content of the version-controlled files but to also correct errors (e.g. typos) in the commit message describing your change.</p>
+ <p>As an alternative to amending you could just commit the corrected version as a subsequent commit. But the first commit containing the typo is of no use to anybody and in order not to clutter the history of your project with unneeded commits you may decide to amend the commit.</p>
<p>Be aware that amending commits which are already published to other repositories may cause trouble. Once you have pushed a commit to a remote repository or your local repository was cloned by somebody else you should be very careful whith amending commits. In this case publishing a second commit which corrects the first one is probably a better solution. Otherwise inform all others that you amended a published commit so that they can react accordingly.</p>
<h2 id="Reverting_Changes">Reverting Changes</h2>
<h3 id="Reverting_changes_in_the_working_tree">Reverting changes in the working tree</h3>
@@ -1106,10 +1112,10 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
<h4 id="From_the_team_menu_on_a_project_node:">From the team menu on a project node:</h4>
<ul>
<li>Select
- <b>Team &gt; Switch To...</b> and select a branch name from the list
+ <b>Team &gt; Switch To...</b> and select a branch name from the list
</li>
</ul>
- <p>If there are too many branches the list does not show all of them. In this case </p>
+ <p>If there are too many branches the list does not show all of them. In this case</p>
<ul>
<li>Select
<b>Team &gt; Switch To... &gt; Other...</b>
@@ -1175,9 +1181,9 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
<h3 id="Renaming_an_Existing_Branch">Renaming an Existing Branch</h3>
<ul>
<li>Open the Git Repositories View</li>
- <li>Select the branch you want to rename </li>
+ <li>Select the branch you want to rename</li>
<li>Click
- <b>Rename Branch...</b>
+ <b>Rename Branch...</b>
</li>
<li>Enter the new branch name and click
<b>OK</b>
@@ -1186,30 +1192,30 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
<h3 id="Deleting_Branch">Deleting Branch</h3>
<ul>
<li>Open the Git Repositories View</li>
- <li>Select the branch you want to rename </li>
+ <li>Select the branch you want to rename</li>
<li>Click
- <b>Delete Branch</b>
+ <b>Delete Branch</b>
</li>
</ul>
<h3 id="Branch_Creation_Dialog">Branch Creation Dialog</h3>
- <p>There are several actions available to create a local branch. All these actions use the Branch Creation dialog: </p>
+ <p>There are several actions available to create a local branch. All these actions use the Branch Creation dialog:</p>
<p>
- <img border="0" src="images/Egit-0.11-BranchCreationDialog.png"/>
+ <img border="0" src="images/Egit-0.11-BranchCreationDialog.png"/>
</p>
- <p>The combo in the upper part allows to select the branch or commit the new branch shall be based on. Typically, this is a remote tracking branch, but it could be any branch or commit in the repository. </p>
- <p>The "Pull Strategy" group allows to override the default setup for the "upstream configuration" which is helpful when fetching and pushing, but particularly when pulling. Depending on the selected option the following configuration can be chosen: </p>
+ <p>The combo in the upper part allows to select the branch or commit the new branch shall be based on. Typically, this is a remote tracking branch, but it could be any branch or commit in the repository.</p>
+ <p>The "Pull Strategy" group allows to override the default setup for the "upstream configuration" which is helpful when fetching and pushing, but particularly when pulling. Depending on the selected option the following configuration can be chosen:</p>
<ul>
- <li>Rebase: When pulling, new changes will be fetched from upstream and the remote tracking branch will be updated. Then the current local branch will be rebased onto the updated remote tracking branch </li>
- <li>Merge: When pulling, the changes will be fetched from upstream and the remote tracking branch will be updated. Then the current local branch will be merged with the new changes. This is the default if the new branch is based on a remote tracking branch (but this default may be overriden by specific repository configuration) </li>
+ <li>Rebase: When pulling, new changes will be fetched from upstream and the remote tracking branch will be updated. Then the current local branch will be rebased onto the updated remote tracking branch</li>
+ <li>Merge: When pulling, the changes will be fetched from upstream and the remote tracking branch will be updated. Then the current local branch will be merged with the new changes. This is the default if the new branch is based on a remote tracking branch (but this default may be overriden by specific repository configuration)</li>
<li>None: When pulling, no specific upstream configuration will be done for the new branch; however, if a default remote exists (a remote with name "origin", pull will try to use the configuration of this remote; this is the default if the new branch is not based on a remote tracking branch</li>
</ul>
<p>You may view and edit the upstream configuration in the
- <a href="Tasks.html#Repository_Configuration">repository configuration</a>.
+ <a href="Tasks.html#Repository_Configuration">repository configuration</a>.
</p>
<p>EGit also supports the git configuration parameter <code>branch.autosetuprebase</code>, set it to <code>always</code> if you want to use the rebase pull strategy by default. If you set this in the repository configuration this is used for all local branches created based on a remote tracking branch in this repository, if you set it in your user configuration it will be used for all your repositories.</p>
<p>In the lower part, you can decide whether the new branch shall be checked out immediately.</p>
<h2 id="Merging">Merging</h2>
- <p>A merge incorporates changes from named commits (since the time their histories diverged from the current branch) into the current branch. </p>
+ <p>A merge incorporates changes from named commits (since the time their histories diverged from the current branch) into the current branch.</p>
<h3 id="Merging_a_branch_or_a_tag_into_the_current_branch">Merging a branch or a tag into the current branch</h3>
<p>You have two places where you can trigger the merge:</p>
<ul>
@@ -1225,10 +1231,10 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
<p>
<img border="0" src="images/MergeDialog.png"/>
</p>
- <p>On the dialog, select a branch or a tag you want to merge with your current branch. </p>
+ <p>On the dialog, select a branch or a tag you want to merge with your current branch.</p>
<h4 id="Starting_merge_from_the_Git_Repositories_View">Starting merge from the Git Repositories View</h4>
<p>You can trigger a merge from any branch and tag node and from the repository node if you have checked out a local branch. See
- <a href="Tasks.html#Merging_a_Branch_or_a_Tag">Merging a Branch or a Tag</a> for further details.
+ <a href="Tasks.html#Merging_a_Branch_or_a_Tag">Merging a Branch or a Tag</a> for further details.
</p>
<h4 id="Possible_merge_results">Possible merge results</h4>
<p>After pressing the Merge button, the following scenarios can occur:</p>
@@ -1306,7 +1312,7 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
</p>
<h4 id="Editing_conflicting_files">Editing conflicting files</h4>
<p>In the file content, the area where a pair of conflicting changes happened is marked with markers &lt;&lt;&lt;&lt;&lt;&lt;&lt;, =======, and &gt;&gt;&gt;&gt;&gt;&gt;&gt;. The part before the ======= is typically your side, and the part afterwards is typically their side (see
- <a href="http://www.kernel.org/pub/software/scm/git/docs/git-merge.html#_how_conflicts_are_presented" target="egit_external">http://www.kernel.org/pub/software/scm/git/docs/git-merge.html#_how_conflicts_are_presented</a> for more details).
+ <a href="http://www.kernel.org/pub/software/scm/git/docs/git-merge.html#_how_conflicts_are_presented" target="egit_external">http://www.kernel.org/pub/software/scm/git/docs/git-merge.html#_how_conflicts_are_presented</a> for more details).
</p>
<p>Open the file in an editor, edit the content and save the editor.</p>
<p>Note that this step is not mandatory. EGit does not check the content to decide if a conflict is resolved. The next step is the relevant one.</p>
@@ -1331,7 +1337,7 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
</ul>
<p>After pressing the "Commit" Button the merge is completed.</p>
<h3 id="Aborting_Merge">Aborting Merge</h3>
- <p>If a merge resulted in conflicts you can abort the merge with a hard reset to the current branch. This can be done in state "Conflicts" and in state "Merged", i.e. before and after you have resolved the conflicts. </p>
+ <p>If a merge resulted in conflicts you can abort the merge with a hard reset to the current branch. This can be done in state "Conflicts" and in state "Merged", i.e. before and after you have resolved the conflicts.</p>
<p>The hard reset can be done from the team menu, the Git Repositories View or the History View. See
<a href="Tasks.html#Revert_all_local_and_staged_changes">Revert all local and staged changes</a> for more details.
</p>
@@ -1341,73 +1347,67 @@ Signed-off-by: William Shakespeare &lt;will.from@the.past&gt;
<h2 id="Rebasing">Rebasing</h2>
<h3 id="Rebase_Introduction">Rebase Introduction</h3>
<p>Rebase applies a chain of commits onto a given commit. A typical scenario is the development of some feature on a "topic" branch which was created from a "master" branch at some point in time. When "master" is updated with changes e.g. from other developers while "topic" is still under development, it may become necessary to incorporate these changes into "topic".
- <br/>
+ <br/>
</p>
<p>Let's assume we start development on "topic" by creating the "topic" branch from master. At this point, both "master" and "topic" point to commit "E". When the first commit ("A") is added to "topic", the commit history of the repository looks like this:
- <br/>
+ <br/>
</p>
<pre> A topic
/
D---E master
</pre>
- <p>
- Now, let's assume that there were some more commits on "topic" and as well some more commits on "master" (for example, "master" may track some remote repository and there were some changes in that remote repository that have been pulled into "master"):
- <br/>
+ <p>Now, let's assume that there were some more commits on "topic" and as well some more commits on "master" (for example, "master" may track some remote repository and there were some changes in that remote repository that have been pulled into "master"):
+ <br/>
</p>
<pre> A---B---C topic
/
D---E---F---G master
</pre>
- <p>
- Now, in order to incorporate the changes in "master" into "topic", a Rebase of "topic" onto "master" would produce
- <br/>
+ <p>Now, in order to incorporate the changes in "master" into "topic", a Rebase of "topic" onto "master" would produce
+ <br/>
</p>
<pre> A'--B'--C' topic
/
D---E---F---G master
</pre>
- <p>
-
+ <p>
<br/> Technically, the sequence of commits that are contained in "topic" but not in "master" are applied (that is, cherry-picked) on top of "master" one by one.
- <br/>
+ <br/>
</p>
<p>Note that the commits A, B, C are neither lost nor changed, instead a new chain of commits A', B', C' with the same changes and commit messages as the original commits (but different commit IDs) will be created. The old commits A, B, C are still around in the object database but not visible anymore as they are no longer reachable from any branch. A', B', C' are different from the old ones as they now also contain changes F and G.</p>
<h3 id="Rebase.2C_A_Simple_Example">Rebase, A Simple Example</h3>
- <p>Let's have a look at some simple example: we have a text file "FamousWords.txt" which initially might have some content like </p>
+ <p>Let's have a look at some simple example: we have a text file "FamousWords.txt" which initially might have some content like</p>
<pre>Chapter 1
Once upon a time...
Chapter 2
To be or not to be
</pre>
- <p>
- Now, in "topic", two commits are created, the first one adding a French translation to Chapter 2, and another one adding a German translation: </p>
+ <p>Now, in "topic", two commits are created, the first one adding a French translation to Chapter 2, and another one adding a German translation:</p>
<p>After first change in "topic":
- <br/>
+ <br/>
</p>
<pre>Chapter 1
Once upon a time...
Chapter 2
To be or not to be
-Ètre ou non ètre pas
+Être ou ne pas être
</pre>
- <p>
- After second change in "topic":
- <br/>
+ <p>After second change in "topic":
+ <br/>
</p>
<pre>Chapter 1
Once upon a time...
Chapter 2
To be or not to be
-Ètre ou non ètre pas
+Être ou ne pas être
Sein oder nicht sein
</pre>
- <p>
- At the same time, the file was changed in "master" by adding two commits adding French and German translations to Chapter 1:
- <br/>
+ <p>At the same time, the file was changed in "master" by adding two commits adding French and German translations to Chapter 1:
+ <br/>
</p>
<pre>Chapter 1
Once upon a time...
@@ -1417,12 +1417,11 @@ Es war einmal
Chapter 2
To be or not to be
</pre>
- <p>
- The commit history looks like this: </p>
+ <p>The commit history looks like this:</p>
<p>
- <img border="0" src="images/EGit-0.10-MergeDemoHistory.png"/>
+ <img border="0" src="images/EGit-0.10-MergeDemoHistory.png"/>
</p>
- <p>Now, if "topic" is rebased onto "master", the two changes in topic are applied in the same sequence as they were applied during the evolution of "topic". </p>
+ <p>Now, if "topic" is rebased onto "master", the two changes in topic are applied in the same sequence as they were applied during the evolution of "topic".</p>
<p>The result is a merged version of "FamousWords.txt":
<br/>
</p>
@@ -1433,12 +1432,12 @@ Es war einmal
Chapter 2
To be or not to be
-Ètre ou non ètre pas
+Être ou ne pas être
Sein oder nicht sein
</pre>
<p>and a commit history with the commit history of "topic" on top of the current "master":
- <br/>
+ <br/>
</p>
<p>
<img border="0" src="images/EGit-0.10-MergeDemoHistoryAfterRebase.png"/>
@@ -1447,7 +1446,7 @@ Sein oder nicht sein
<p>Up to now, we have assumed that the changes in "topic" can be auto-merged into "master". In the real world, however, it may happend that you encounter conflicts during rebase. Now, if a commit that is to be cherry-picked contains changes that conflict with changes in "master", the rebase operation is interrupted after applying the conflicting change; the conflicts are visualized in the usual way (with conflict markers) and the user gets a chance to decide whether to</p>
<ul>
<li>resolve these conflicts manually,</li>
- <li>skip the current commit, or </li>
+ <li>skip the current commit, or</li>
<li>abort the rebase completely</li>
</ul>
<p>If
@@ -1498,7 +1497,7 @@ Sein oder nicht sein
<h3 id="Cherry-pick_Introduction">Cherry-pick Introduction</h3>
<p>A given commit
<i>C'' on branch ''stable-1.0</i> contains a set of changes you would like to integrate in your current development on branch
- <i>master</i>.
+ <i>master</i>.
</p>
<pre> A--B--C--D stable-1.0
/
@@ -1540,10 +1539,10 @@ Sein oder nicht sein
</p>
<ul>
<li>Resolve the conflicts by editing the corresponding sources as described in
- <a href="Tasks.html#Resolving_a_merge_conflict">Resolving a merge conflict</a>
+ <a href="Tasks.html#Resolving_a_merge_conflict">Resolving a merge conflict</a>
</li>
<li>
- <b>Team &gt; Add</b> the files you edited to mark the conflicts resolved
+ <b>Team &gt; Add</b> the files you edited to mark the conflicts resolved
</li>
<li>Commit the changes using
<b>Team &gt; Commit</b>
@@ -1556,7 +1555,7 @@ Sein oder nicht sein
<h3 id="Creating_a_Tag">Creating a Tag</h3>
<ul>
<li>Select
- <b>Team &gt; Tag...</b> from the project context menu.
+ <b>Team &gt; Advanced &gt; Tag...</b> from the project context menu.
</li>
</ul>
<p>
@@ -1604,9 +1603,23 @@ Sein oder nicht sein
</li>
</ul>
<h3 id="Deletion_of_tags">Deletion of tags</h3>
- <p>This is not yet supported.</p>
+ <p>In order to delete a tag, select the tag to be deleted and click
+ <b>Delete Tag</b>.
+ </p>
+ <p>
+ <b>Note:</b> it's a bad practice to delete tags which have already been published on a public server, some Git servers even disallow tag deletion to ensure traceability for releases which are usually tagged. Also see the
+ <a href="http://schacon.github.com/git/git-tag.html" target="egit_external">section "On re-tagging"</a> in the Git reference documentation of the tag command.
+ </p>
<h3 id="Light-weight_and_Signed_Tags">Light-weight and Signed Tags</h3>
- <p>Light-weight tags are shown in the Repositories View as well as in the Create Tag dialog, but can not be edited. In the History View, they are shown as yellow labels.</p>
+ <p>Light-weight tags are shown in the Repositories View as well as in the Create Tag dialog, but can not be edited.
+ Tags are shown with a blue icon in the Repositories View, lightweight tags are decorated with a dark blue "L".</p>
+ <p>
+ <img border="0" src="images/Egit-1.1-tags.png"/>
+ </p>
+ <p>In the History View, tags are shown as yellow labels.</p>
+ <p>
+ <img border="0" src="images/Egit-1.1-tags-history.png"/>
+ </p>
<p>Signed tags are not yet supported by EGit, use command line <tt>
<b>git tag</b></tt> or <tt>
<b>git tag -s</b></tt> instead.
@@ -1637,9 +1650,9 @@ Sein oder nicht sein
<img border="0" src="images/Egit-0.0-create-patch-dialog.png"/>
</p>
<p>The name of the patch file is created from the first line of the commit message.</p>
- <p>On the second page you can change the patch format. </p>
+ <p>On the second page you can change the patch format.</p>
<p>Currently there is one check box:
- <b>Export in git patch format</b>.
+ <b>Export in git patch format</b>.
</p>
<ul>
<li>If you do not check it (this is the default) the patch can be applied with the eclipse
@@ -1652,142 +1665,142 @@ Sein oder nicht sein
</ul>
<p>Binary diffs are currently not produced.</p>
<h3 id="Applying_Patches">Applying Patches</h3>
- <p>Currently it s not possible to apply all patches in git format. It is possible to apply patches using the standard Eclipse (unified diff) format using
+ <p>Currently EGit isn't able to apply patches in git format. It is possible to apply patches using the standard Eclipse (unified diff) format using
<b>Team &gt; Apply Patch...</b>. Git patches may contain non-standard extensions for rename and binary diffs. The current version of EGit does not generate these extensions.
</p>
<p>
<br/>
</p>
<h2 id="Managing_Repositories">Managing Repositories</h2>
- <p>The "Git Repositories View" is the primary UI element to facilitate working with multiple Repositories simultaneously (i.e. within one Eclipse Workspace). </p>
+ <p>The "Git Repositories View" is the primary UI element to facilitate working with multiple Repositories simultaneously (i.e. within one Eclipse Workspace).</p>
<p>This view can be opened using the menu path
<br/>
- <b>Windows &gt; Show View &gt; Other... &gt; Git &gt; Git Repositories</b>
+ <b>Windows &gt; Show View &gt; Other... &gt; Git &gt; Git Repositories</b>
</p>
<p>It is also part of the "Git Repository Exploring" perspective available using menu path
<br/>
- <b>Window &gt; Open Perspective &gt; Other... &gt; Git Repository Exploring</b>
+ <b>Window &gt; Open Perspective &gt; Other... &gt; Git Repository Exploring</b>
</p>
<p>If you already have projects in your workspace which are shared with a Git Repository, you can use
- <br/>'
- <i>Team &gt; Show in Repositories View</i>'
+ <br/>
+ <b>Team &gt; Show in Repositories View</b>
</p>
- <p>on any resource to open the view. </p>
+ <p>on any resource to open the view.</p>
<h3 id="Adding_Repositories_to_the_Git_Repositories_View">Adding Repositories to the Git Repositories View</h3>
- <p>Initially, the Git Repositories View is empty. In order to add Repositories to it, there are several options: </p>
+ <p>Initially, the Git Repositories View is empty. In order to add Repositories to it, there are several options:</p>
<ol>
- <li>Adding a Repository from the Local File System manually </li>
- <li>Cloning a Repository and having the cloned Repository added to the view automatically </li>
- <li>Creating a Repository on the Local File System </li>
+ <li>Adding a Repository from the Local File System manually</li>
+ <li>Cloning a Repository and having the cloned Repository added to the view automatically</li>
+ <li>Creating a Repository on the Local File System</li>
<li>Adding a Repository by pasting a Git Repository path to the view</li>
</ol>
<h4 id="Adding_a_Repository_manually">Adding a Repository manually</h4>
<p>You can add a Repository from your local file system to the Git Repositories View without cloning it. This can be helpful if you are setting up a new Eclipse workspace and want to re-use your Git Repositories. Use the
- <b>Add an existing Git Repository</b> button from the view's toolbar:
+ <b>Add an existing Git Repository</b> button from the view's toolbar:
</p>
<p>
- <img border="0" src="images/RepoMgrAddRepositoryIcon.png"/>
+ <img border="0" src="images/RepoMgrAddRepositoryIcon.png"/>
</p>
<p>A dialog will appear prompting you for a directory of your local file system. After selecting the correct directory, you can hit the
<b>Search</b> button to see a list of Git Repositories in this directory. You can then select some or all found Repositories and add them to the view using
- <b>OK</b>:
+ <b>OK</b>:
</p>
<p>
- <img border="0" src="images/Egit-0.11-import-projects-add-dialog.png"/>
+ <img border="0" src="images/Egit-0.11-import-projects-add-dialog.png"/>
</p>
<h4 id="Cloning_a_Repository_2">Cloning a Repository</h4>
<p>In order to clone a Repository, refer to
- <a href="Tasks.html#Cloning_a_Repository">Cloning remote Repositories</a>. After a successful clone operation, the newly cloned Repository should appear in the Git Repositories View automatically.
+ <a href="Tasks.html#Cloning_a_Repository">Cloning remote Repositories</a>. After a successful clone operation, the newly cloned Repository should appear in the Git Repositories View automatically.
</p>
<p>You can also use the
- <b>Clone a Git Repository</b> button from the view's toolbar to start the Clone wizard:
+ <b>Clone a Git Repository</b> button from the view's toolbar to start the Clone wizard:
</p>
<p>
- <img border="0" src="images/RepoMgrCloneRepositoryIcon.png"/>
+ <img border="0" src="images/RepoMgrCloneRepositoryIcon.png"/>
</p>
<p>Please refer to
- <a href="Tasks.html#Cloning_a_Repository">Cloning remote Repositories</a> about how to use the wizard.
+ <a href="Tasks.html#Cloning_a_Repository">Cloning remote Repositories</a> about how to use the wizard.
</p>
<h4 id="Creating_a_Repository">Creating a Repository</h4>
<p>You can create a new, empty repository on the local file system. This is useful if you later on want to create one or more new projects below this repository. Another usecase is to create a new bare repository where you can push to. Use the
- <b>Create a new Git Repository</b> button from the view's toolbar:
+ <b>Create a new Git Repository</b> button from the view's toolbar:
</p>
<p>
- <img border="0" src="images/RepoMgrCreateRepositoryIcon.png"/>
+ <img border="0" src="images/RepoMgrCreateRepositoryIcon.png"/>
</p>
- <p>A dialog will appear which lets you choose a directory: </p>
+ <p>A dialog will appear which lets you choose a directory:</p>
<p>
- <img border="0" src="images/RepoMgrCreateRepositoryDialog.png"/>
+ <img border="0" src="images/RepoMgrCreateRepositoryDialog.png"/>
</p>
<p>If you select the checkbox
- <b>Create as Bare Repository</b> the new repository will not have a working directory. You then can only add content by pushing changes from another repository.
+ <b>Create as Bare Repository</b> the new repository will not have a working directory. You then can only add content by pushing changes from another repository.
</p>
<h4 id="Adding_a_Repository_using_Copy_and_Paste">Adding a Repository using Copy and Paste</h4>
- <p>As a shortcut, it is also possible to paste the local file system path of a Git repository from the clipboard into this view. In order to do so, copy the path of a Git repository (the full path of its <code>.git</code> folder) to the clipboard, then open the context menu on the view panel: </p>
+ <p>As a shortcut, it is also possible to paste the local file system path of a Git repository from the clipboard into this view. In order to do so, copy the path of a Git repository (the full path of its <code>.git</code> folder) to the clipboard, then open the context menu on the view panel:</p>
<p>
- <img border="0" src="images/RepoMgrPasteRepositoryPath.png"/>
+ <img border="0" src="images/RepoMgrPasteRepositoryPath.png"/>
</p>
<p>or click
- <b>Edit &gt; Paste</b> from the main menu (or the corresponding keyboard shortcut). If the clipboard content is not suitable, an error popup will be displayed, otherwise the added Repository should appear automatically.
+ <b>Edit &gt; Paste</b> from the main menu (or the corresponding keyboard shortcut). If the clipboard content is not suitable, an error popup will be displayed, otherwise the added Repository should appear automatically.
</p>
- <p>After the view has been populated with some repositories, it should look like this: </p>
+ <p>After the view has been populated with some repositories, it should look like this:</p>
<p>
- <img border="0" src="images/RepoMgrViewWithRepos.png"/>
+ <img border="0" src="images/RepoMgrViewWithRepos.png"/>
</p>
<h3 id="Removing_Repositories">Removing Repositories</h3>
<h4 id="Removing_a_Repository_from_the_Repositories_View">Removing a Repository from the Repositories View</h4>
- <p>In order to remove a repository from the Repositories View select a repository and click "Remove Repository" </p>
+ <p>In order to remove a repository from the Repositories View select a repository and click "Remove Repository"</p>
<p>
- <img border="0" src="images/Egit-0.10-RemoveRepository.png"/>
+ <img border="0" src="images/Egit-0.10-RemoveRepository.png"/>
</p>
<h4 id="Deleting_a_Repository">Deleting a Repository</h4>
- <p>In order to delete a repository, select it in the Repositories View and click "Delete Repository". </p>
+ <p>In order to delete a repository, select it in the Repositories View and click "Delete Repository".</p>
<p>
- <img border="0" src="images/Egit-0.10-DeleteRepository.png"/>
+ <img border="0" src="images/Egit-0.10-DeleteRepository.png"/>
</p>
- <p>Then confirm that you want to delete the repository </p>
+ <p>Then confirm that you want to delete the repository</p>
<p>
- <img border="0" src="images/Egit-0.10-ConfirmRepositoryDeletion.png"/>
+ <img border="0" src="images/Egit-0.10-ConfirmRepositoryDeletion.png"/>
</p>
- <p>and decide if you want to delete projects contained in the repository from the Eclipse workspace. </p>
+ <p>and decide if you want to delete projects contained in the repository from the Eclipse workspace.</p>
<p>
- <img border="0" src="images/Egit-0.10-ConfirmProjectRemoval.png"/>
+ <img border="0" src="images/Egit-0.10-ConfirmProjectRemoval.png"/>
</p>
<p>
- <br/>
+ <br/>
</p>
<h3 id="Structure_of_the_Git_Repositories_View">Structure of the Git Repositories View</h3>
- <p>The following screenshot shows the topmost two levels of the Git Repositories View: </p>
+ <p>The following screenshot shows the topmost two levels of the Git Repositories View:</p>
<p>
- <img border="0" src="images/Egit-0.11-RepoViewTopLevel.png"/>
+ <img border="0" src="images/Egit-0.11-RepoViewTopLevel.png"/>
</p>
<p>The root node represents the Repository itself. The node text indicates the name of the Repository and its location in the local file system. The "Branches" and "Tags" nodes allow browsing and manipulation of tags and branches. The "References" node lists other references which are not branches or tags, most notably the "HEAD" and "FETCH_HEAD" symbolic references (see
<a href="Reference.html#Git_References">Git References</a>).
</p>
- <p>The "Working directory" node displays the location and structure of the working directory on the local file system (only in case of a development, or non-bare Repository, for bare Repositories, this node is always a leaf). </p>
+ <p>The "Working Directory" node displays the location and structure of the working directory on the local file system (only in case of a development, or non-bare Repository, for bare Repositories, this node is always a leaf).</p>
<p>Finally, the "Remotes" node allows browsing and manipulating the remote configurations used for Fetch and Push.</p>
<h3 id="Functions_of_the_Git_Repositories_View">Functions of the Git Repositories View</h3>
<h4 id="Project_Import">Project Import</h4>
- <p>In order to work with the contents of a Git Repository, its files and folders must be imported into the Eclipse workspace in the form of projects. While the Git Clone wizard allows to do such imports directly after cloning, the Git Repositories View allows to trigger project imports independently of the clone operation. </p>
- <p>The "Import Projects..." context menu is available on the "Repository" node as well as on any "Folder" node within the "Working Directory" node and the "Working Directory" node itself: </p>
+ <p>In order to work with the contents of a Git Repository, its files and folders must be imported into the Eclipse workspace in the form of projects. While the Git Clone wizard allows to do such imports directly after cloning, the Git Repositories View allows to trigger project imports independently of the clone operation.</p>
+ <p>The "Import Projects..." context menu is available on the "Repository" node as well as on any "Folder" node within the "Working Directory" node and the "Working Directory" node itself:</p>
<p>
- <img border="0" src="images/Egit-0.11-ImportProjectsFromRepoView.png"/>
+ <img border="0" src="images/Egit-0.11-ImportProjectsFromRepoView.png"/>
</p>
<p>The rationale for offering the
<b>Import Projects...</b> action on several nodes is that some of the wizards used for importing projects can take the file system directory into account, for example the
- <b>Import Existing Projects</b> wizard. If the import is started from the "Repository" or the "Working Directory" node, the working directory of the repository is set as context, otherwise the directory corresponding to the currently selected "Folder" node.
+ <b>Import Existing Projects</b> wizard. If the import is started from the "Repository" or the "Working Directory" node, the working directory of the repository is set as context, otherwise the directory corresponding to the currently selected "Folder" node.
</p>
<p>The details of project import are discussed in
- <a href="Tasks.html#Use_the_New_Projects_Wizard">Use the New Projects Wizard</a>.
+ <a href="Tasks.html#Use_the_New_Projects_Wizard">Use the New Projects Wizard</a>.
</p>
<h4 id="Branch_and_Tag_Support">Branch and Tag Support</h4>
- <p>The "Branches" node allows to create, browse, checkout and delete local and remote branches. The "Tags" node allows to browse and check out tags. Both the "Branches" node and the "Tags" node allow to merge the branch or tag into the currently checked out branch and also to synchronize with the currently checked out branch. </p>
- <p>For better readability, branches are organized in two sub-nodes for local and remote branches, respectively, and only the shortened names are displayed, e.g. instead of <tt>"refs/heads/master"</tt> you would find an entry <tt>"master"</tt> under the "Local Branches" node, instead of <tt>"refs/remotes/origin/master"</tt> the shortened name <tt>"origin/master"</tt> is displayed under the "Remote Branches" node. Similarly, tag names are shortened by omitting the <tt>"refs/tags/"</tt> prefix: </p>
+ <p>The "Branches" node allows to create, browse, checkout and delete local and remote branches. The "Tags" node allows to browse and check out tags. Both the "Branches" node and the "Tags" node allow to merge the branch or tag into the currently checked out branch and also to synchronize with the currently checked out branch.</p>
+ <p>For better readability, branches are organized in two sub-nodes for local and remote branches, respectively, and only the shortened names are displayed, e.g. instead of <tt>"refs/heads/master"</tt> you would find an entry <tt>"master"</tt> under the "Local Branches" node, instead of <tt>"refs/remotes/origin/master"</tt> the shortened name <tt>"origin/master"</tt> is displayed under the "Remote Branches" node. Similarly, tag names are shortened by omitting the <tt>"refs/tags/"</tt> prefix:</p>
<p>
- <img border="0" src="images/RepoMgrBranchesAndTags.png"/>
+ <img border="0" src="images/RepoMgrBranchesAndTags.png"/>
</p>
<h5 id="Check-out_of_Branches_and_Tags">Check-out of Branches and Tags</h5>
- <p>Branches and tags can be checked out by either double-clicking on the respective node or by selecting the corresponding context menu entry. </p>
+ <p>Branches and tags can be checked out by either double-clicking on the respective node or by selecting the corresponding context menu entry.</p>
<h5 id="Creation_and_Deletion_of_Branches">Creation and Deletion of Branches</h5>
<p>Local branches can be created using the
<a href="Tasks.html#Branch_Creation_Dialog">Branch Creation Dialog</a>. The wizard is opened by right-clicking on the "Branches", the "Local Branches" on any "Branch" and "Tag" node).
@@ -1799,7 +1812,7 @@ Sein oder nicht sein
</p>
<h5 id="Merging_a_Branch_or_a_Tag">Merging a Branch or a Tag</h5>
<p>You can trigger a merge from any branch and tag node and from the repository node if you have checked out a local branch. See
- <a href="Tasks.html#Merging">Merging</a> for further details of the merging features.
+ <a href="Tasks.html#Merging">Merging</a> for further details of the merging features.
</p>
<ul>
<li>When you select any branch node other than the currently checked out branch or any tag node, use
@@ -1814,144 +1827,159 @@ Sein oder nicht sein
</ul>
<h5 id="Synchronizing_with_a_Branch_or_a_Tag">Synchronizing with a Branch or a Tag</h5>
<p>You can perform a comparison of the changes in your HEAD with the changes done in any other branch or tag. Right click and select
- <b>Synchronize...</b> on any branch or tag. Then the eclipse synchronize view opens which contains a representation of the changes that are contained in your HEAD but not on the other branch or tag (outgoing change) or vice versa (incoming change). Please refer to the documentation of the synchronize feature for further details.
+ <b>Synchronize...</b> on any branch or tag. Then the eclipse synchronize view opens which contains a representation of the changes that are contained in your HEAD but not on the other branch or tag (outgoing change) or vice versa (incoming change). Please refer to the documentation of the synchronize feature for further details.
</p>
<h5 id="Determining_the_Checked-out_Branch">Determining the Checked-out Branch</h5>
- <p>There are two ways to determine which branch or tag is currently checked out: the checked out branch/tag node is decorated with a little check mark and the "HEAD" entry under the "Symbolic References" node shows the (full) name of the checked out branch: </p>
+ <p>There are two ways to determine which branch or tag is currently checked out: the checked out branch/tag node is decorated with a little check mark and the "HEAD" entry under the "Symbolic References" node shows the (full) name of the checked out branch:</p>
<p>
- <img border="0" src="images/RepoMgrCheckedOutBranch.png"/>
+ <img border="0" src="images/RepoMgrCheckedOutBranch.png"/>
</p>
<h5 id="Resetting_to_a_Branch_or_a_Tag">Resetting to a Branch or a Tag</h5>
<p>Right click and select
<b>Reset...</b> on any branch or tag. This opens a dialog which lets you decide on the reset type. See
- <a href="Tasks.html#Resetting_your_current_HEAD">Resetting you current HEAD</a> for further details.
+ <a href="Tasks.html#Resetting_your_current_HEAD">Resetting you current HEAD</a> for further details.
</p>
<h5 id=".22Detached.22_HEAD">"Detached" HEAD</h5>
<p>If HEAD is "detached", i.e. is not pointing to the tip of a local branch but to a commit or tag, then none or several "checked-out" markers may appear in the tree, since any number of remote branch or tags may point to the currently checked out commit. The state you are in while your HEAD is detached is not recorded by any branch (which is natural --- you are not on any branch).</p>
<h4 id="Inspecting_References">Inspecting References</h4>
- <p>The References node displays some References other than branches and tags (the list is dynamic and depends on the current state of the Repository): </p>
+ <p>The References node displays some References other than branches and tags (the list is dynamic and depends on the current state of the Repository):</p>
<p>
- <img border="0" src="images/Egit-0.11-RepoViewReferencesNode.png"/>
+ <img border="0" src="images/Egit-0.11-RepoViewReferencesNode.png"/>
</p>
- <p>If the Reference is symbolic, i.e. points to another Reference, the name of the target reference is shown, followed by the object ID of the reference's target. If the Reference is not symbolic, only the object ID is shown. </p>
- <p>In the example above, HEAD is a symbolic Reference pointing to branch "refs/heads/master" (i.e. branch "master" is checked out", while FETCH_HEAD points directly to commit 226a7f... . </p>
+ <p>If the Reference is symbolic, i.e. points to another Reference, the name of the target reference is shown, followed by the object ID of the reference's target. If the Reference is not symbolic, only the object ID is shown.</p>
+ <p>In the example above, HEAD is a symbolic Reference pointing to branch "refs/heads/master" (i.e. branch "master" is checked out", while FETCH_HEAD points directly to commit 226a7f... .</p>
<p>The following actions are available on right-clicking on a Reference:
<b>Checkout '''(unless the Reference is already checked out) and '''Create Branch</b>
<b>...</b> .
</p>
<h4 id="Browsing_the_Working_Directory">Browsing the Working Directory</h4>
- <p>The "Working Directory" node visualizes the local file system structure of the Git Repository. It is also possible to open a text editor on the files: </p>
+ <p>The "Working Directory" node visualizes the local file system structure of the Git Repository. It is also possible to open a text editor on the files:</p>
<p>
- <img border="0" src="images/RepoMgrOpenTextEditor.png"/>
+ <img border="0" src="images/RepoMgrOpenTextEditor.png"/>
</p>
+ <p>Alternatively, files can be opened by dragging them from the Working Directory to the Editor Area.</p>
<p>Also, on all file and folder nodes as well as on the "Repository" node, an option is offered to copy the (file-system specific) path to the clipboard. This is sometimes useful when the path is needed, for example to open a directory using a file browser or to copy and paste Repositories between view instances (see above about how to add Repositories to the view). The
<b>Copy to Clipboard</b> action is also available using
<b>Edit &gt; Copy</b> (or the corresponding keyboard shortcut).
</p>
<h4 id="Repository_Configuration">Repository Configuration</h4>
- <p>Integration with the generic "Properties" view in Eclipse allows to view and edit the Git Configuration (global and repository-specific configuration). If the "Properties" view is open, it is updated automatically when a "Repository" node is selected. For convenience, an
- <b>Open Properties view</b> action is provided in the context menu:
- </p>
- <p>
- <img border="0" src="images/RepoMgrPropertiesView.png"/>
- </p>
- <p>With a drop down box (left red box in the screen shot) you can switch between the display of the Repository Configuration, the Global Configuration and a view which aggregates both. If the view displays the Repository Configuration or the Global Configuration you can open an editor dialog with the
+ <p>Integration with the generic "Properties" view in Eclipse allows to view and edit the Git Configuration (global and repository-specific configuration). If the "Properties" view is open, it is updated automatically when a "Repository" node is selected. With a drop down box (left red box in the screen shot) you can switch between the display of the Repository Configuration, the Global Configuration and a view which aggregates both. If the view displays the Repository Configuration or the Global Configuration you can open an editor dialog with the
<b>Edit</b> button (right red box in the screen shot). The editor dialog has the same functionality as the preference page
- <b>Team &gt; Git &gt; Configuration</b>.
+ <b>Team &gt; Git &gt; Configuration</b>.
+ </p>
+ <p>In the Git Repositories view, there is a
+ <b>Properties</b> action in the context menu, which will open a configuration dialog allowing to edit the Repository Configuration. Here, key value pairs can be added, changed or deleted. The
+ <b>Open</b> button allows to open the Repository Configuration file in a text editor.
</p>
<h4 id="Remote_Repositories">Remote Repositories</h4>
<p>The "Remotes" node allows for browsing and editing Remote configurations. Each Remote configuration has a name and either a Push Specification, a Fetch Specification, or both. If a "Remote Configuration" node or any of its children is selected, the
- <b>Properties</b> view will show a summary of the Remote configuration. In this example: there is a Remote configuration named "origin" which only has a Fetch Specification, but no Push Specification:
+ <b>Properties</b> view will show a summary of the Remote configuration. In this example: there is a Remote configuration named "origin" which only has a Fetch Specification, but no Push Specification:
</p>
<p>
- <img border="0" src="images/RepoMgrRemoteConfig.png"/>
+ <img border="0" src="images/RepoMgrRemoteConfig.png"/>
</p>
- <p>Menu actions are provided to add, configure, and remove Remote configurations and Fetch and Push Specifications. </p>
+ <p>Menu actions are provided to add, configure, and remove Remote configurations and Fetch and Push Specifications.</p>
<h5 id="Direct_Fetch_and_Push_Support">Direct Fetch and Push Support</h5>
- <p>It is possible to execute fetch and push directly (i.e. without a wizard) on the respective "Fetch" and "Push" nodes: </p>
+ <p>It is possible to execute fetch and push directly (i.e. without a wizard) on the respective "Fetch" and "Push" nodes:</p>
<p>
- <img border="0" src="images/RepoMgrSimpleFetch.png"/>
+ <img border="0" src="images/RepoMgrSimpleFetch.png"/>
</p>
- <p>Note that the fetch or push operation will be executed immediately in an asynchronous job; on completion you will get a confirmation pop-up displaying the fetch result. </p>
- <p>The "Fetch" node contains a so called fetch specification and the "Push" node contains a so called push specification. </p>
+ <p>Note that the fetch or push operation will be executed immediately in an asynchronous job; on completion you will get a confirmation pop-up displaying the fetch result.</p>
+ <p>The "Fetch" node contains a so called fetch specification and the "Push" node contains a so called push specification.</p>
<p>A default fetch specification is created when the repository is cloned. You can edit the fetch specification with the menu entry
<b>Configure Fetch...</b>. This opens a wizard. On the first page you can edit the Fetch URI. Ob the second page you can determine the fetch ref specifications, see
- <a href="Tasks.html#Fetch_Ref_Specifications">Fetch Ref Specifications</a>.
+ <a href="Tasks.html#Fetch_Ref_Specifications">Fetch Ref Specifications</a>.
</p>
<p>You can create or edit a push specification with the menu entry
<b>Configure Push...</b>. This opens a wizard. On the first page you can edit the Push URIs. If a fetch is specified the fetch URI is automatically included into the push specification and no additional Push URI is needed. On the second page you can determine the push ref specifications, see
- <a href="Tasks.html#Push_Ref_Specifications">Push Ref Specifications</a>.
+ <a href="Tasks.html#Push_Ref_Specifications">Push Ref Specifications</a>.
</p>
<h5 id="Adding_a_Remote_Configuration">Adding a Remote Configuration</h5>
- <p>This is done using a context menu action on the "Remotes" node. A wizard is started asking for the name of the new configuration and whether to configure Fetch, Push, or both: </p>
+ <p>This is done using a context menu action on the "Remotes" node. A wizard is started asking for the name of the new configuration and whether to configure Fetch, Push, or both:</p>
<p>
- <img border="0" src="images/RepoMgrNewRemote.png"/>
+ <img border="0" src="images/RepoMgrNewRemote.png"/>
</p>
<p>If the
- <b>Configure Fetch</b> checkbox was selected, the next wizard page will ask for the URI of the Repository to fetch from:
+ <b>Configure Fetch</b> checkbox was selected, the next wizard page will ask for the URI of the Repository to fetch from:
</p>
<p>
- <img border="0" src="images/Egit-0.9-repo-view-createRemoteWizardFetch.png"/>
+ <img border="0" src="images/Egit-0.9-repo-view-createRemoteWizardFetch.png"/>
</p>
<p>Click
<b>Change...</b> to open a dialog that allows you to select a URI. The next step is to define the Remote Specification for the fetch URI. See
- <a href="Tasks.html#Fetch_Ref_Specifications">Fetch Ref Specifications</a> about the details.
+ <a href="Tasks.html#Fetch_Ref_Specifications">Fetch Ref Specifications</a> about the details.
</p>
<p>If the
<b>Configure Push</b> checkbox was selected, the next wizard page will ask for the URIs of the repositories to push to. This is actually a list, as you can push to multiple repositories at once. Click
<b>Add....</b> to add URIs to the list using the same dialog as above. You can remove URIs by marking them in the list and hitting
<b>Remove</b>. This step is completely optional if there is already a fetch URI defined. In this case, the fetch URI will also be used for push. If at least one push URI is defined in this steps, it will override the fetch URI. In this example, there is already a fetch URI, so the
- <b>Next</b> button is enabled, even though there is no Push URI in the list:
+ <b>Next</b> button is enabled, even though there is no Push URI in the list:
</p>
<p>
- <img border="0" src="images/Egit-0.9-repo-view-createRemoteWizardPush.png"/>
+ <img border="0" src="images/Egit-0.9-repo-view-createRemoteWizardPush.png"/>
</p>
<p>The next step is to define the Remote Specification for the push URIs. See
- <a href="Tasks.html#Push_Ref_Specifications">Push Ref Specifications</a> about the details.
+ <a href="Tasks.html#Push_Ref_Specifications">Push Ref Specifications</a> about the details.
</p>
- <p>Upon completion, the new Remote configuration will be visible: </p>
+ <p>Upon completion, the new Remote configuration will be visible:</p>
<p>
- <img border="0" src="images/RepoMgrRemoteCreated.png"/>
+ <img border="0" src="images/RepoMgrRemoteCreated.png"/>
</p>
<h5 id="Changing_Remote_Configurations">Changing Remote Configurations</h5>
- <p>It is also possible to add, remove, or change Fetch/Push Specifications for an existing Remote configuration using the context menu. </p>
+ <p>It is also possible to add, remove, or change Fetch/Push Specifications for an existing Remote configuration using the context menu.</p>
<h3 id="Refresh">Refresh</h3>
<p>The view is auto-refreshed periodically. The
- <b>Refresh</b> button in the toolbar allows to trigger an immediate refresh:
+ <b>Refresh</b> button in the toolbar allows to trigger an immediate refresh:
</p>
<p>
- <img border="0" src="images/RepoMgrRefresh.png"/>
+ <img border="0" src="images/RepoMgrRefresh.png"/>
</p>
<h3 id="Link_with_Selection">Link with Selection</h3>
<p>If the
- <b>Link with selection</b> toggle is enabled, the file or folder corresponding to the current workbench selection will be displayed automatically:
+ <b>Link with selection</b> toggle is enabled, the file or folder corresponding to the current workbench selection will be displayed automatically:
</p>
<p>
- <img border="0" src="images/RepoMgrLinkWithSelection.png"/>
+ <img border="0" src="images/RepoMgrLinkWithSelection.png"/>
</p>
<h3 id="Link_with_Editor">Link with Editor</h3>
<p>If the
- <b>Link with editor</b> toggle is enabled, the file or folder corresponding to the currently active editor will be displayed automatically:
+ <b>Link with editor</b> toggle is enabled, the file or folder corresponding to the currently active editor will be displayed automatically:
</p>
<p>
- <img border="0" src="images/RepoMgrLinkWithEditor.png"/>
+ <img border="0" src="images/RepoMgrLinkWithEditor.png"/>
</p>
<h3 id="Hierarchical_Branch_Layout">Hierarchical Branch Layout</h3>
<p>If the
- <b>Hierarchical Branch Layout</b> toggle is enabled, branches will be shown in a hierarchical layout using slash (/) as hierarchy separator:
+ <b>Hierarchical Branch Layout</b> toggle is enabled, branches will be shown in a hierarchical layout using slash (/) as hierarchy separator:
</p>
<p>
- <img border="0" src="images/RepoMgrHierarchicalBranchLayout.png"/>
+ <img border="0" src="images/RepoMgrHierarchicalBranchLayout.png"/>
</p>
- <p>This can be helpful for organizing large numbers of branches. </p>
+ <p>This can be helpful for organizing large numbers of branches.</p>
<h3 id="Bare_Repositories">Bare Repositories</h3>
- <p>"Bare" Git Repositories (as opposed to "development" or "standard" Repositories) have no working directory by definition, so all actions related to the working directory (check-out, project import, browsing the working directory) are not available for such Repositories. The "Bare-ness" of a Repository is visualized on the "Working Directory" node, which is always a leaf: </p>
+ <p>"Bare" Git Repositories (as opposed to "development" or "standard" Repositories) have no working directory by definition, so all actions related to the working directory (check-out, project import, browsing the working directory) are not available for such Repositories. The "Bare-ness" of a Repository is visualized on the "Working Directory" node, which is always a leaf:</p>
<p>
<img border="0" src="images/RepoMgrBareRepository.png"/>
</p>
<p>Bare repositories are only changed by pushing changes to them.</p>
<h3 id="Removing_Repositories_from_the_Git_Repositories_View">Removing Repositories from the Git Repositories View</h3>
- <p>This is offered as a menu action on the "Repository" node. Note that this does not delete the Repository, but just removes the node from the view. If there are projects in the workspace which are located in the working directory of the Repository, the user will be prompted to confirm deletion of these projects from the Eclipse workspace. </p>
+ <p>This is offered as a menu action on the "Repository" node. Note that this does not delete the Repository, but just removes the node from the view. If there are projects in the workspace which are located in the working directory of the Repository, the user will be prompted to confirm deletion of these projects from the Eclipse workspace.</p>
+ <h3 id="Showing_Repository_in_Related_Views">Showing Repository in Related Views</h3>
+ <h4 id="Show_in_History">Show in History</h4>
+ <p>The command
+ <b>Show in &gt; History</b> will open the
+ <a href="Reference.html#History_View">History View</a> showing all changes in the selected repository.
+ </p>
+ <h4 id="Show_in_Reflog">Show in Reflog</h4>
+ <p>The command
+ <b>Show in &gt; Reflog</b> will open the
+ <a href="Reference.html#Git_Reflog_View">Git Reflog view</a> showing the Git reflog of the selected repository.
+ </p>
+ <h4 id="Show_in_Properties">Show in Properties</h4>
+ <p>The command
+ <b>Show in &gt; Properties</b> will open the
+ <a href="Tasks.html#Repository_Configuration">Properties view</a> showing the properties of the selected repository.
+ </p>
<p>
<br/>
</p>
@@ -1981,7 +2009,7 @@ Sein oder nicht sein
<img border="0" src="images/Egit-0.11-activate-task.png"/>
</p>
<ul>
- <li>When launching the commit dialog EGit will pre-populate the commit message using the commit message template. </li>
+ <li>When launching the commit dialog EGit will pre-populate the commit message using the commit message template.</li>
</ul>
<p>
<img border="0" src="images/Egit-0.11-commit-using-template.png"/>
@@ -1990,7 +2018,7 @@ Sein oder nicht sein
<a href="http://wiki.eclipse.org/index.php/Mylyn/User_Guide" target="egit_external">Mylyn User Guide</a> for more information how to work with tasks.
</p>
<h2 id="Viewing_Commits">Viewing Commits</h2>
- <p>EGit 1.0 added a Git commit viewer that allows commits to be opened in the Eclipse editor area.</p>
+ <p>The Egit commit viewer allows commits to be opened in the Eclipse editor area.</p>
<p>The EGit commit viewer displays the following commit information:</p>
<ul>
<li>Commit tab
@@ -2050,6 +2078,12 @@ Sein oder nicht sein
</ul>
</li>
</ul>
+ <h3 id="Checking_out_a_commit">Checking out a commit</h3>
+ <p>This checks out the commit displayed in the commit viewer. The commit will be checked out and
+ <a href="#&quot;Detached&quot;_HEAD">HEAD will become detached</a>.
+ </p>
+ <h3 id="Cherry_picking_a_commit">Cherry picking a commit</h3>
+ <p>Applies the change introduced by the commit displayed in the commit viewer on top of the currently checked out commit or branch.</p>
<h3 id="Opening_the_commit_viewer">Opening the commit viewer</h3>
<p>The commit viewer can be opened from the following places:</p>
<ul>
@@ -2061,9 +2095,12 @@ Sein oder nicht sein
<li>
<a href="Tasks.html#Finding_the_author_of_each_line_in_a_file">Blame annotation popup</a>
</li>
+ <li>
+ <a href="#Reflog_View">Reflog View</a>
+ </li>
</ul>
<h2 id="Searching_for_commits">Searching for commits</h2>
- <p>EGit 1.0 support searching for commits.</p>
+ <p>EGit supports searching for commits.</p>
<h3 id="Git_Search_page">Git Search page</h3>
<p>Commits can be searched from the
<b>Git Search</b> tab in the standard Eclipse Search dialog.
@@ -2104,7 +2141,7 @@ Sein oder nicht sein
</p>
<p>Selecting the
<b>Team</b> &gt;
- <b>Show Blame Annotations</b> action on file selections will open the editor and display an annotation ruler with commit and author information for each line in a file. Hovering over the ruler will display a pop-up showing the commit id, author, committer, and the commit message.
+ <b>Show Annotations</b> action on file selections will open the editor and display an annotation ruler with commit and author information for each line in a file. Hovering over the ruler will display a pop-up showing the commit id, author, committer, and the commit message.
</p>
<p>The look and feel of the blame annotation editor ruler can be configured from the
<b>Revisions</b> sub-menu available from the ruler context-menu.
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/User-Guide.html b/org.eclipse.egit.doc/help/EGit/User_Guide/User-Guide.html
index d1153f3bc..4f97a52ab 100644
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/User-Guide.html
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/User-Guide.html
@@ -36,19 +36,19 @@
<h3 id="Configuration">Configuration</h3>
<h4 id="Identifying_yourself">Identifying yourself</h4>
<p>Whenever the history of the repository is changed (technically, whenever a commit is created), Git keeps track of the user who created that commit. The identification consists of a name (typically a person's name) and an e-mail address. This information is stored in file <code>~/.gitconfig</code> under dedicated keys.
- <br/>
+ <br/>
</p>
- <p>EGit will ask you for this information when you create your first commit. By default, this dialog is shown only once until you create a new workspace or tick the checkbox "Show initial configuration dialog" on the Git Preference page: </p>
+ <p>EGit will ask you for this information when you create your first commit. By default, this dialog is shown only once until you create a new workspace or tick the checkbox "Show initial configuration dialog" on the Git Preference page:</p>
<p>
- <img border="0" src="images/Egit-0.11-initialConfigurationDialog.png"/>
+ <img border="0" src="images/Egit-0.11-initialConfigurationDialog.png"/>
</p>
<p>You can also untick "Don't show this dialog again" if you want to see it again later.</p>
<p>Instead of using this dialog, you can always change this information using the Git configuration:
- <br/>
+ <br/>
</p>
<ul>
<li>Click
- <b>Preferences &gt; Team &gt; Git &gt; Configuration</b>
+ <b>Preferences &gt; Team &gt; Git &gt; Configuration</b>
</li>
<li>Click
<b>New Entry</b> and enter the key value pairs <code>user.email</code> and <code>user.name</code>
@@ -56,42 +56,42 @@
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-email.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-email.png"/>
</p>
<p>
<img border="0" src="images/Egit-0.9-getstarted-name.png"/>
</p>
<h4 id="Setting_up_the_Home_Directory_on_Windows">Setting up the Home Directory on Windows</h4>
- <p>Add the environment variable <code>HOME</code> to your environment variables. </p>
+ <p>Add the environment variable <code>HOME</code> to your environment variables.</p>
<ol>
- <li>In Windows 7, type "enviroment window" at the start menu </li>
+ <li>In Windows 7, type "enviroment window" at the start menu</li>
<li>Select "Edit environment variables for your account"</li>
- <li>Click the "New" button. </li>
- <li>Enter "HOME" in the name field </li>
- <li>Enter "%USERPROFILE%" or some other path in the value field. </li>
+ <li>Click the "New" button.</li>
+ <li>Enter "HOME" in the name field</li>
+ <li>Enter "%USERPROFILE%" or some other path in the value field.</li>
<li>Click OK, and OK again. You have just added the Home directory on Windows.
<br/>
</li>
</ol>
<p>EGit needs this path for looking up the user configuration (.gitconfig). <code>HOME</code> should point to your home directory e.g. <code>C:\Users\Tom</code>.
- <b>Ensure correct case!</b> E.g. <code>C:\users</code> instead of <code>C:\Users</code> may cause problems!
+ <b>Ensure correct case!</b> E.g. <code>C:\users</code> instead of <code>C:\Users</code> may cause problems!
</p>
- <p>If the <code>HOME</code> variable is not defined the home directory will be calculated by concatenating <code>HOMEDRIVE</code> and <code>HOMEPATH</code>. </p>
- <p>If both <code>HOME</code> and <code>HOMEDRIVE</code> are not defined <code>HOMESHARE</code> will be used. </p>
- <p>EGit shows a warning if <code>HOME</code> is not defined explicitly: </p>
+ <p>If the <code>HOME</code> variable is not defined the home directory will be calculated by concatenating <code>HOMEDRIVE</code> and <code>HOMEPATH</code>.</p>
+ <p>If both <code>HOME</code> and <code>HOMEDRIVE</code> are not defined <code>HOMESHARE</code> will be used.</p>
+ <p>EGit shows a warning if <code>HOME</code> is not defined explicitly:</p>
<p>
<img border="0" src="images/Egit_no_home.png"/>
</p>
<h3 id="Create_Repository">Create Repository</h3>
<ul>
- <li>Create a new Java project <code>HelloWorld</code> </li>
+ <li>Create a new Java project <code>HelloWorld</code></li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-project.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-project.png"/>
</p>
<ul>
<li>Select the project, click
- <b>File &gt; Team &gt; Share Project</b>
+ <b>File &gt; Team &gt; Share Project</b>
</li>
<li>Select repository type
<b>Git</b> and click
@@ -99,37 +99,37 @@
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-share.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-share.png"/>
</p>
<ul>
- <li>To configure the Git repository select the new project <code>HelloWorld</code> </li>
+ <li>To configure the Git repository select the new project <code>HelloWorld</code></li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-create-project.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-create-project.png"/>
</p>
<ul>
<li>Click
- <b>Create Repository</b> to initialize a new Git repository for the <code>HelloWorld</code> project. If your project already resides in the working tree of an exisiting Git repository the repository is chosen automatically.
+ <b>Create Repository</b> to initialize a new Git repository for the <code>HelloWorld</code> project. If your project already resides in the working tree of an exisiting Git repository the repository is chosen automatically.
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-project-created.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-project-created.png"/>
</p>
<ul>
<li>Click
- <b>Finish</b> to close the wizard.
+ <b>Finish</b> to close the wizard.
</li>
<li>The decorator text "&#91;master&#93;" behind the project shows that this project is tracked in a repository on the
- <i>master</i> branch and the question mark decorators show that the <code>.classpath</code> and <code>.project</code> and the <code>.settings</code> files are not yet under version control
+ <i>master</i> branch and the question mark decorators show that the <code>.classpath</code> and <code>.project</code> and the <code>.settings</code> files are not yet under version control
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-shared-project.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-shared-project.png"/>
</p>
<h3 id="Track_Changes">Track Changes</h3>
<ul>
<li>Click
- <b>Team &gt; Add</b> on the project node
+ <b>Team &gt; Add</b> on the project node
</li>
<li>The
<i>+</i> decorators show that now the project's files have been added to version control
@@ -140,33 +140,33 @@
<b>Team &gt; Ignore</b> or by creating a file <code>.gitignore</code> in the project folder with the following content
</li>
</ul>
- <pre>/bin
+ <pre>/bin
</pre>
<ul>
- <li>This excludes the <code>bin</code> folder from Git's list of tracked files. </li>
+ <li>This excludes the <code>bin</code> folder from Git's list of tracked files.</li>
<li>Add <code>.gitignore</code> to version control (
<b>Team &gt; Add</b>):
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.11-getstarted-ignore-added.png"/>
+ <img border="0" src="images/Egit-0.11-getstarted-ignore-added.png"/>
</p>
<ul>
<li>Click
- <b>Team &gt; Commit</b> in the project context menu
+ <b>Team &gt; Commit</b> in the project context menu
</li>
- <li>Enter a commit message explaining your change, the first line (followed by an empty line) will become the short log for this commit. By default the author and committer are taken from the <code>.gitconfig</code> file in your home directory. </li>
+ <li>Enter a commit message explaining your change, the first line (followed by an empty line) will become the short log for this commit. By default the author and committer are taken from the <code>.gitconfig</code> file in your home directory.</li>
<li>You may click
<b>Add Signed-off-by</b> to add a
- <i>Signed-off-by:</i> tag.
+ <i>Signed-off-by:</i> tag.
</li>
- <li>If you are committing the change of another author you may alter the author field to give the name and email address of the author. </li>
+ <li>If you are committing the change of another author you may alter the author field to give the name and email address of the author.</li>
<li>Click
<b>Commit</b> to commit your first change.
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-commit.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-commit.png"/>
</p>
<ul>
<li>Note that the decorators of the committed files changed.</li>
@@ -181,28 +181,28 @@
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.11-getstarted-history1.png"/>
+ <img border="0" src="images/Egit-0.11-getstarted-history1.png"/>
</p>
<ul>
- <li>Create a new Java class <code>Hello.java</code> and implement it </li>
- <li>Add it to version control and commit your change </li>
- <li>Improve your implementation and commit the improved class </li>
+ <li>Create a new Java class <code>Hello.java</code> and implement it</li>
+ <li>Add it to version control and commit your change</li>
+ <li>Improve your implementation and commit the improved class</li>
<li>The resource history should now show 2 commits for this class</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.9-getstarted-application.png"/>
+ <img border="0" src="images/Egit-0.9-getstarted-application.png"/>
</p>
<p>
- <img border="0" src="images/Egit-0.11-getstarted-history2.png"/>
+ <img border="0" src="images/Egit-0.11-getstarted-history2.png"/>
</p>
<ul>
<li>Click the
- <b>Compare Mode</b> toggle button in the History View
+ <b>Compare Mode</b> toggle button in the History View
</li>
<li>Double click <code>src/Hello.java</code> in the Resource list of the History View to open your last committed change in the Compare View</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.11-getstarted-compare.png"/>
+ <img border="0" src="images/Egit-0.11-getstarted-compare.png"/>
</p>
<p>
<br/>
@@ -222,7 +222,7 @@
<li>create a new repository at GitHub</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.10-github-create-repo.png"/>
+ <img border="0" src="images/Egit-0.10-github-create-repo.png"/>
</p>
<p>On the next screen you can see the URLs you may use to access your fresh new repository:</p>
<ul>
@@ -246,11 +246,11 @@
<h3 id="Eclipse_SSH_Configuration">Eclipse SSH Configuration</h3>
<ul>
<li>Open the Eclipse
- <b>Preferences</b> and ensure that your SSH2 home is configured correctly (usually this is <tt>~/.ssh</tt>) and contains your SSH2 keys
+ <b>Preferences</b> and ensure that your SSH2 home is configured correctly (usually this is <tt>~/.ssh</tt>) and contains your SSH2 keys
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.10-ssh-preferences.png"/>
+ <img border="0" src="images/Egit-0.10-ssh-preferences.png"/>
</p>
<ul>
<li>if you don't have SSH keys yet you may generate them on the second tab
@@ -264,17 +264,17 @@
<h3 id="Push_Upstream">Push Upstream</h3>
<ul>
<li>Click
- <b>Team &gt; Remote &gt; Push...</b> and copy and paste the SSH URL of your new github repository
+ <b>Team &gt; Remote &gt; Push...</b> and copy and paste the SSH URL of your new github repository
</li>
<li>If you are behind a firewall which doesn't allow SSH traffic use the github HTTPS URL instead and provide your github user and password instead of using the uploaded public SSH key. To store your credentials into the Eclipse secure store click
- <b>Store in Secure Store</b>.
+ <b>Store in Secure Store</b>.
</li>
<li>
<b>Note:</b> many HTTP proxies are configured to block HTTP URLs containing a user name, since disclosing a user name in an HTTP URL is considered a security risk. In that case remove the username from the HTTP URL and only provide it in the user field. It will be sent as an HTTP header.
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.10-github-pushurl.png"/>
+ <img border="0" src="images/Egit-0.10-github-pushurl.png"/>
</p>
<ul>
<li>Click
@@ -292,7 +292,7 @@
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.10-github-push-refspec.png"/>
+ <img border="0" src="images/Egit-0.10-github-push-refspec.png"/>
</p>
<ul>
<li>Click
@@ -300,7 +300,7 @@
</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.10-github-push-preview.png"/>
+ <img border="0" src="images/Egit-0.10-github-push-preview.png"/>
</p>
<ul>
<li>Click
@@ -311,7 +311,7 @@
<li>The next dialog reports the result of the push operation.</li>
</ul>
<p>
- <img border="0" src="images/Egit-0.10-github-pushresult.png"/>
+ <img border="0" src="images/Egit-0.10-github-pushresult.png"/>
</p>
<ul>
<li>Point your browser at your GitHub repository to see that your new repository content has arrived</li>
@@ -322,18 +322,18 @@
<p>
<br/>
</p>
- <h2 id="EGit_Tutorial">EGit Tutorial</h2>
+ <h2 id="EGit_Tutorial_.28EclipseCon_March_2011.29">EGit Tutorial (EclipseCon March 2011)</h2>
<p>You may want to learn how to work with EGit and Gerrit Code Review by going through the
- <a href="http://www.eclipsecon.org/2011/sessions/?page=sessions&amp;id=2035" target="egit_external">EGit tutorial we held at EclipseCon 2011</a>.
+ <a href="http://www.eclipsecon.org/2011/sessions/?page=sessions&amp;id=2035" target="egit_external">EGit tutorial we held at EclipseCon America 2011</a>.
</p>
<h3 id="Installation_and_Configuration">Installation and Configuration</h3>
- <p>The tutorial was developed using EGit 0.11 so you should use at least this version. Newer versions may provide an easier way to do certain steps, look at the
+ <p>This tutorial was developed using EGit 0.11 so you should use at least this version. Newer versions may provide an easier way to do certain steps, look at the
<a href="http://wiki.eclipse.org/EGit/FAQ#Where_can_I_find_older_releases_of_EGit.3F" target="egit_external">EGit "New and Noteworthy" documentation</a>.
</p>
<p>Best you go through the exercises using the Gerrit-in-a-zip you may download from TODO.
See exercise 9 to learn how to use that.</p>
<p>The egit-training repository is also available on
- <a href="http://egit.eclipse.org/" target="egit_external">http://egit.eclipse.org/</a>.
+ <a href="http://egit.eclipse.org/" target="egit_external">http://egit.eclipse.org/</a>.
You may clone it from there using
</p>
<pre>git://egit.eclipse.org/egit-training.git
@@ -341,7 +341,7 @@
<p>More details are given in</p>
<ul>
<li>Exercise 1:
- <a href="https://docs.google.com/document/d/1Uxq59vCcWqK-hPb5CHQcR97A%20mJehj6Rn0ScTnih2tyU/edit?hl=en_US" target="egit_external">Installation and configuration</a>
+ <a href="https://docs.google.com/document/d/1Uxq59vCcWqK-hPb5CHQcR97AmJehj6Rn0ScTnih2tyU/edit?hl=en_US" target="egit_external">Installation and configuration</a>
</li>
<li>Exercise 9:
<a href="https://docs.google.com/document/d/1JDdge66iEN5BvBMSETtO3u5eUHmsuXLCoEc25HQqOcE/edit?hl=en_US" target="egit_external">Starting demo Gerrit server</a>
@@ -373,6 +373,24 @@
</ul>
<p>
<br/>
+ </p>
+ <h2 id="EGit_Tutorial_.28EclipseCon_Europe_Nov_2011.29">EGit Tutorial (EclipseCon Europe Nov 2011)</h2>
+ <p>We held this tutorial
+ <a href="http://www.eclipsecon.org/europe2011/sessions/eclipse-hackers-guide-git-universe" target="egit_external">"Eclipse Hacker's Guide to the Git Universe"</a> at EclipseCon Europe on Nov 2, 2011.
+ </p>
+ <p>This tutorial was developed using EGit 1.2-SNAPSHOT so you should use at least this version.
+ Newer versions may provide an easier way to do certain steps, look at the
+ <a href="http://wiki.eclipse.org/EGit/FAQ#Where_can_I_find_older_releases_of_EGit.3F" target="egit_external">EGit "New and Noteworthy" documentation</a>.
+ </p>
+ <p>The egit-training repository is also available on
+ <a href="http://egit.eclipse.org/" target="egit_external">http://egit.eclipse.org/</a>.
+ You may clone it from there using
+ </p>
+ <pre>git://egit.eclipse.org/egit-training.git
+</pre>
+ <h3 id="Exercises_2">Exercises</h3>
+ <p>Find slides and exercises
+ <a href="https://docs.google.com/#folders/0B4F_gjXVrHZVYmYzN2EwMmQtMmQyNC00NmI4LWFmODQtYjk4ZGVlMTI0NGJl" target="egit_external">here</a>
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/EGit-0.12-SetupRepo-RepoStructureTwoProjects.jpg b/org.eclipse.egit.doc/help/EGit/User_Guide/images/EGit-0.12-SetupRepo-RepoStructureTwoProjects.jpg
index 9db2badbd..ee406e61f 100644
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/EGit-0.12-SetupRepo-RepoStructureTwoProjects.jpg
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/EGit-0.12-SetupRepo-RepoStructureTwoProjects.jpg
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-history-commitmenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-history-commitmenu.png
deleted file mode 100644
index 9bc97cc21..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-history-commitmenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-branchmenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-branchmenu.png
deleted file mode 100644
index 53a4c8b25..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-branchmenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-fetchmenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-fetchmenu.png
deleted file mode 100644
index d3bf685c8..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-fetchmenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-pushmenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-pushmenu.png
deleted file mode 100644
index 53c8b61bf..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-pushmenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-tagmenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-tagmenu.png
deleted file mode 100644
index df870094d..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-tagmenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-worktreemenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-worktreemenu.png
deleted file mode 100644
index 37f847224..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.10-repoview-worktreemenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-project-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-project-menu.png
deleted file mode 100644
index f5b6d82e7..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-project-menu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-repoview-repomenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-repoview-repomenu.png
deleted file mode 100644
index 812aea182..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-repoview-repomenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-resource-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-resource-menu.png
deleted file mode 100644
index ff464b4ef..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.12-resource-menu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuFolder.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuFolder.png
deleted file mode 100644
index 7886b5639..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuFolder.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuSingleFile.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuSingleFile.png
deleted file mode 100644
index c200f7df9..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuSingleFile.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuTwoFiles.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuTwoFiles.png
deleted file mode 100644
index d481c6f50..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-contextMenuTwoFiles.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-viewmenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-viewmenu.png
deleted file mode 100644
index d1f54a0c2..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-0.9-history-view-viewmenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-project-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-project-menu.png
deleted file mode 100644
index 05d64ee7c..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-project-menu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-repomenu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-repomenu.png
deleted file mode 100644
index c503ce19d..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-repomenu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-resource-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-resource-menu.png
deleted file mode 100644
index 1881a0480..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.0-resource-menu.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags-history.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags-history.png
new file mode 100644
index 000000000..9dcab93c5
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags-history.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags.png
new file mode 100644
index 000000000..e65a15a13
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.1-tags.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-commit-dialog-path-assist.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-commit-dialog-path-assist.png
new file mode 100644
index 000000000..65154e3ab
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-commit-dialog-path-assist.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-history-view-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-history-view-menu.png
new file mode 100644
index 000000000..5e682053b
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-history-view-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-2files-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-2files-menu.png
new file mode 100644
index 000000000..8670a8853
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-2files-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-file-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-file-menu.png
new file mode 100644
index 000000000..407975782
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-file-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-menu.png
new file mode 100644
index 000000000..38928458b
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-historyview-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-advanced.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-advanced.png
new file mode 100644
index 000000000..115969a1b
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-advanced.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-main.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-main.png
new file mode 100644
index 000000000..9c92e17eb
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-main.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-remote.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-remote.png
new file mode 100644
index 000000000..0df4f5b12
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-remote.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-switchto.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-switchto.png
new file mode 100644
index 000000000..b26d963cd
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-project-menu-switchto.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-reflog-view.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-reflog-view.png
new file mode 100644
index 000000000..51dd04943
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-reflog-view.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-branch-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-branch-menu.png
new file mode 100644
index 000000000..4170bba22
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-branch-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-fetchconfig-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-fetchconfig-menu.png
new file mode 100644
index 000000000..019b789f6
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-fetchconfig-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-pushconfig-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-pushconfig-menu.png
new file mode 100644
index 000000000..ded6e74e4
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-pushconfig-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-repository-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-repository-menu.png
new file mode 100644
index 000000000..ef144cdc0
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-repository-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-tag-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-tag-menu.png
new file mode 100644
index 000000000..055dfcbf2
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-tag-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-workingtree-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-workingtree-menu.png
new file mode 100644
index 000000000..c33922093
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-repoview-workingtree-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-resource-menu.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-resource-menu.png
new file mode 100644
index 000000000..6ff915b01
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-resource-menu.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-staging-view.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-staging-view.png
new file mode 100644
index 000000000..010b4b561
--- /dev/null
+++ b/org.eclipse.egit.doc/help/EGit/User_Guide/images/Egit-1.2-staging-view.png
Binary files differ
diff --git a/org.eclipse.egit.doc/help/EGit/User_Guide/images/RepoMgrPropertiesView.png b/org.eclipse.egit.doc/help/EGit/User_Guide/images/RepoMgrPropertiesView.png
deleted file mode 100644
index 234a0a6df..000000000
--- a/org.eclipse.egit.doc/help/EGit/User_Guide/images/RepoMgrPropertiesView.png
+++ /dev/null
Binary files differ
diff --git a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/1.1.html b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/1.2.html
index 2bf55b0d0..1dd6cc231 100644
--- a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/1.1.html
+++ b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/1.2.html
@@ -2,13 +2,13 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>JGit 1.1 New and Noteworthy</title>
+ <title>JGit 1.2 New and Noteworthy</title>
<link type="text/css" rel="stylesheet" href="../../../book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
- <th style="width: 100%" align="center" colspan="3">JGit 1.1 New and Noteworthy</th>
+ <th style="width: 100%" align="center" colspan="3">JGit 1.2 New and Noteworthy</th>
</tr>
<tr>
<td style="width: 20%" align="left"></td>
@@ -26,15 +26,8 @@
</tr>
</table><hr/>
<h1 id="Git_Porcelain_API_Updates">Git Porcelain API Updates</h1>
- <p>More Git porcelain commands and command options were added to the
- <b>org.eclipse.jgit.api</b> package
- </p>
<ul>
- <li><code>ReflogCommand</code></li>
- <li><code>DiffCommand</code></li>
- <li><code>ListTagCommand</code></li>
- <li><code>DeleteTagCommand</code></li>
- <li><code> ResetCommand</code> now supports recursive reset on given directory</li>
+ <li>A TransportConfig callback has been introduced for transport commands</li>
</ul><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
diff --git a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Bugs-Closed.html b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Bugs-Closed.html
new file mode 100644
index 000000000..a1cccc436
--- /dev/null
+++ b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Bugs-Closed.html
@@ -0,0 +1,61 @@
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>JGit 1.2 New and Noteworthy - Bugs Closed</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">Bugs Closed</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Features.html" title="Features">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Commits.html" title="Commits">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Features</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Commits</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Bugs_Closed">Bugs Closed</h1>
+ <p>
+ <a href="https://bugs.eclipse.org/bugs/buglist.cgi?chfieldto=2011-12-21;chfield=bug_status;query_format=advanced;order=Importance;chfieldfrom=2011-09-23;bug_status=RESOLVED;bug_status=CLOSED;resolution=FIXED;resolution=DUPLICATE;product=JGit;classification=Technology" target="egit_external">6 bugs and 6 enhancement requests</a> were closed.
+ </p><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="Features.html" title="Features">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="1.2.html" title="JGit 1.2 New and Noteworthy">
+ <img alt="JGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="Commits.html" title="Commits">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">Features</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Commits</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Features.html b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Commits.html
index dd8b5cc0c..7cb7e96c2 100644
--- a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Features.html
+++ b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Commits.html
@@ -2,60 +2,59 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>JGit 1.1 New and Noteworthy - Features</title>
+ <title>JGit 1.2 New and Noteworthy - Commits</title>
<link type="text/css" rel="stylesheet" href="../../../book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
- <th style="width: 100%" align="center" colspan="3">Features</th>
+ <th style="width: 100%" align="center" colspan="3">Commits</th>
</tr>
<tr>
<td style="width: 20%" align="left">
- <a href="1.1.html" title="JGit 1.1 New and Noteworthy">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right">
- <a href="Performance-Improvements.html" title="Performance Improvements">
+ <a href="Updating-This-Document.html" title="Updating This Document">
<img alt="Next" border="0" src="../../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">JGit 1.1 New and Noteworthy</td>
+ <td style="width: 20%" align="left" valign="top">Bugs Closed</td>
<td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">Performance Improvements</td>
+ <td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
</table><hr/>
- <h1 id="Features">Features</h1>
- <ul>
- <li>Shallow cloning support</li>
- <li>Blame command in JGit command line</li>
- </ul><hr/>
+ <h1 id="Commits">Commits</h1>
+ <p>
+ <a href="http://egit.eclipse.org/w/?p=jgit.git;a=shortlog;h=stable-1.2;hp=v1.1.0.201109151100-r;opt=--no-merges" target="egit_external">JGit 1.2 - commits in gitweb</a>
+ </p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
- <a href="1.1.html" title="JGit 1.1 New and Noteworthy">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
- <a href="1.1.html" title="JGit 1.1 New and Noteworthy">
- <img alt="JGit 1.1 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ <a href="1.2.html" title="JGit 1.2 New and Noteworthy">
+ <img alt="JGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right">
- <a href="Performance-Improvements.html" title="Performance Improvements">
+ <a href="Updating-This-Document.html" title="Updating This Document">
<img alt="Next" border="0" src="../../../images/next.gif"/>
</a>
</td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">JGit 1.1 New and Noteworthy</td>
+ <td style="width: 20%" align="left" valign="top">Bugs Closed</td>
<td style="width: 60%" align="center"></td>
- <td style="width: 20%" align="right" valign="top">Performance Improvements</td>
+ <td style="width: 20%" align="right" valign="top">Updating This Document</td>
</tr>
</table>
</body>
diff --git a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Features.html b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Features.html
new file mode 100644
index 000000000..7451596ae
--- /dev/null
+++ b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Features.html
@@ -0,0 +1,71 @@
+<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <title>JGit 1.2 New and Noteworthy - Features</title>
+ <link type="text/css" rel="stylesheet" href="../../../book.css"/>
+ </head>
+ <body>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <th style="width: 100%" align="center" colspan="3">Features</th>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="1.2.html" title="JGit 1.2 New and Noteworthy">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">JGit 1.2 New and Noteworthy</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Bugs Closed</td>
+ </tr>
+ </table><hr/>
+ <h1 id="Features">Features</h1>
+ <ul>
+ <li>A Distributed File System storage API has been added for JGit to enable storing Git data in a distributed file system.</li>
+ <li>A rename callback in FollowFilter has been added to enable following renames in RevWalks.</li>
+ <li>Git over HTTP can now be served without the old <code>/p</code> web context root through new HTTP servlet filters</li>
+ <li>A new configuration option <code>maxObjectSizeLimit</code> for receive-pack has been implemented to allow limiting the maximum file size which can be pushed. This is e.g. used by Gerrit to limit the maximum file size which can be pushed to the server in order to protect it against excessive resource consumption.</li>
+ <li>The new system property <code>jgit.cygpath</code> can be used to explicitly control cygwin path translation which is now off by default.</li>
+ </ul>
+ <p>
+ <b>JGit command line</b>
+ </p>
+ <ul>
+ <li>The log command now supports the usual date options also provided by native Git.</li>
+ </ul><hr/>
+ <table class="navigation" style="width: 100%;" border="0" summary="navigation">
+ <tr>
+ <td style="width: 20%" align="left">
+ <a href="1.2.html" title="JGit 1.2 New and Noteworthy">
+ <img alt="Previous" border="0" src="../../../images/prev.gif"/>
+ </a>
+ </td>
+ <td style="width: 60%" align="center">
+ <a href="1.2.html" title="JGit 1.2 New and Noteworthy">
+ <img alt="JGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ </a>
+ </td>
+ <td style="width: 20%" align="right">
+ <a href="Bugs-Closed.html" title="Bugs Closed">
+ <img alt="Next" border="0" src="../../../images/next.gif"/>
+ </a>
+ </td>
+ </tr>
+ <tr>
+ <td style="width: 20%" align="left" valign="top">JGit 1.2 New and Noteworthy</td>
+ <td style="width: 60%" align="center"></td>
+ <td style="width: 20%" align="right" valign="top">Bugs Closed</td>
+ </tr>
+ </table>
+ </body>
+</html> \ No newline at end of file
diff --git a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Updating-This-Document.html b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Updating-This-Document.html
index 422e676e8..13acd0fdf 100644
--- a/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.1/Updating-This-Document.html
+++ b/org.eclipse.egit.doc/help/JGit/New_and_Noteworthy/1.2/Updating-This-Document.html
@@ -2,7 +2,7 @@
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
- <title>JGit 1.1 New and Noteworthy - Updating This Document</title>
+ <title>JGit 1.2 New and Noteworthy - Updating This Document</title>
<link type="text/css" rel="stylesheet" href="../../../book.css"/>
</head>
<body>
@@ -12,7 +12,7 @@
</tr>
<tr>
<td style="width: 20%" align="left">
- <a href="Performance-Improvements.html" title="Performance Improvements">
+ <a href="Commits.html" title="Commits">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
@@ -20,7 +20,7 @@
<td style="width: 20%" align="right"></td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">Performance Improvements</td>
+ <td style="width: 20%" align="left" valign="top">Commits</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top"></td>
</tr>
@@ -29,24 +29,24 @@
<p> This document is maintained in a collaborative wiki. If you wish to
update or modify this document please visit
- <a href="http://wiki.eclipse.org/JGit/New_and_Noteworthy/1.1" target="egit_external">http://wiki.eclipse.org/JGit/New_and_Noteworthy/1.1</a>
+ <a href="http://wiki.eclipse.org/JGit/New_and_Noteworthy/1.2" target="egit_external">http://wiki.eclipse.org/JGit/New_and_Noteworthy/1.2</a>
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
- <a href="Performance-Improvements.html" title="Performance Improvements">
+ <a href="Commits.html" title="Commits">
<img alt="Previous" border="0" src="../../../images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
- <a href="1.1.html" title="JGit 1.1 New and Noteworthy">
- <img alt="JGit 1.1 New and Noteworthy" border="0" src="../../../images/home.gif"/>
+ <a href="1.2.html" title="JGit 1.2 New and Noteworthy">
+ <img alt="JGit 1.2 New and Noteworthy" border="0" src="../../../images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right"></td>
</tr>
<tr>
- <td style="width: 20%" align="left" valign="top">Performance Improvements</td>
+ <td style="width: 20%" align="left" valign="top">Commits</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top"></td>
</tr>
diff --git a/org.eclipse.egit.doc/help/JGit/User_Guide/Concepts.html b/org.eclipse.egit.doc/help/JGit/User_Guide/Concepts.html
index 7ee7e0a64..53d37f2ac 100644
--- a/org.eclipse.egit.doc/help/JGit/User_Guide/Concepts.html
+++ b/org.eclipse.egit.doc/help/JGit/User_Guide/Concepts.html
@@ -38,11 +38,12 @@
<p>To build a repository, you invoke flavors of
<b>RepositoryBuilder</b>.
</p>
- <pre>FileRepositoryBuilder builder = new RepositoryBuilder();
-Repository repository = builder.setGitDir("/my/git/directory")
-.readEnvironment() // scan environment GIT_* variables
-.findGitDir() // scan up the file system tree
-.build();
+ <pre class="source-java">FileRepositoryBuilder builder = new FileRepositoryBuilder();
+Repository repository = builder.setGitDir(new File("/my/git/directory"))
+ .readEnvironment() // scan environment GIT_* variables
+ .findGitDir() // scan up the file system tree
+ .build();
+
</pre>
<h3 id="Git_Objects">Git Objects</h3>
<p>All objects are represented by a SHA-1 id in the Git object model. In JGit, this is represented by the
@@ -111,7 +112,7 @@ RevTag tag = walk.parseTag(objectIdOfTag);
<p>A
<b>RevTree</b> represents a tree in the Git object model.
</p>
- <p>To parse a commit, simply use a
+ <p>To parse a tree, simply use a
<b>RevWalk</b> instance:
</p>
<pre>RevWalk walk = new RevWalk(repository);
diff --git a/org.eclipse.egit.doc/help/JGit/User_Guide/Reference.html b/org.eclipse.egit.doc/help/JGit/User_Guide/Reference.html
index c74eda9f0..2da2ccc6d 100644
--- a/org.eclipse.egit.doc/help/JGit/User_Guide/Reference.html
+++ b/org.eclipse.egit.doc/help/JGit/User_Guide/Reference.html
@@ -80,7 +80,7 @@ RevTag tag = git.tag().setName("tag").call();
</ul>
<p>Here's a quick example of how get some log messages.</p>
<pre>Git git = new Git(db);
-LogCommand log = git.log().call();
+Iterable&lt;RevCommit&gt; log = git.log().call();
</pre>
<h3 id="MergeCommand_.28git-merge.29">MergeCommand (git-merge)</h3>
<p>TODO</p>
diff --git a/org.eclipse.egit.doc/help/toc.xml b/org.eclipse.egit.doc/help/toc.xml
index b852b6ca4..832dda8a9 100644
--- a/org.eclipse.egit.doc/help/toc.xml
+++ b/org.eclipse.egit.doc/help/toc.xml
@@ -18,10 +18,13 @@
<topic href="help/EGit/User_Guide/User-Guide.html#Eclipse_SSH_Configuration" label="Eclipse SSH Configuration"></topic>
<topic href="help/EGit/User_Guide/User-Guide.html#Push_Upstream" label="Push Upstream"></topic>
</topic>
- <topic href="help/EGit/User_Guide/User-Guide.html#EGit_Tutorial" label="EGit Tutorial">
+ <topic href="help/EGit/User_Guide/User-Guide.html#EGit_Tutorial_.28EclipseCon_March_2011.29" label="EGit Tutorial (EclipseCon March 2011)">
<topic href="help/EGit/User_Guide/User-Guide.html#Installation_and_Configuration" label="Installation and Configuration"></topic>
<topic href="help/EGit/User_Guide/User-Guide.html#Exercises" label="Exercises"></topic>
</topic>
+ <topic href="help/EGit/User_Guide/User-Guide.html#EGit_Tutorial_.28EclipseCon_Europe_Nov_2011.29" label="EGit Tutorial (EclipseCon Europe Nov 2011)">
+ <topic href="help/EGit/User_Guide/User-Guide.html#Exercises_2" label="Exercises"></topic>
+ </topic>
</topic>
<topic href="help/EGit/User_Guide/Concepts.html" label="Concepts">
<topic href="help/EGit/User_Guide/Concepts.html#Repository" label="Repository"></topic>
@@ -235,6 +238,11 @@
<topic href="help/EGit/User_Guide/Tasks.html#Hierarchical_Branch_Layout" label="Hierarchical Branch Layout"></topic>
<topic href="help/EGit/User_Guide/Tasks.html#Bare_Repositories" label="Bare Repositories"></topic>
<topic href="help/EGit/User_Guide/Tasks.html#Removing_Repositories_from_the_Git_Repositories_View" label="Removing Repositories from the Git Repositories View"></topic>
+ <topic href="help/EGit/User_Guide/Tasks.html#Showing_Repository_in_Related_Views" label="Showing Repository in Related Views">
+ <topic href="help/EGit/User_Guide/Tasks.html#Show_in_History" label="Show in History"></topic>
+ <topic href="help/EGit/User_Guide/Tasks.html#Show_in_Reflog" label="Show in Reflog"></topic>
+ <topic href="help/EGit/User_Guide/Tasks.html#Show_in_Properties" label="Show in Properties"></topic>
+ </topic>
</topic>
<topic href="help/EGit/User_Guide/Tasks.html#Working_with_Tasks" label="Working with Tasks">
<topic href="help/EGit/User_Guide/Tasks.html#Installation" label="Installation"></topic>
@@ -243,6 +251,8 @@
<topic href="help/EGit/User_Guide/Tasks.html#Viewing_Commits" label="Viewing Commits">
<topic href="help/EGit/User_Guide/Tasks.html#Tagging_a_commit" label="Tagging a commit"></topic>
<topic href="help/EGit/User_Guide/Tasks.html#Creating_a_branch_from_a_commit" label="Creating a branch from a commit"></topic>
+ <topic href="help/EGit/User_Guide/Tasks.html#Checking_out_a_commit" label="Checking out a commit"></topic>
+ <topic href="help/EGit/User_Guide/Tasks.html#Cherry_picking_a_commit" label="Cherry picking a commit"></topic>
<topic href="help/EGit/User_Guide/Tasks.html#Opening_the_commit_viewer" label="Opening the commit viewer"></topic>
</topic>
<topic href="help/EGit/User_Guide/Tasks.html#Searching_for_commits" label="Searching for commits">
@@ -289,6 +299,7 @@
<topic href="help/EGit/User_Guide/Reference.html#Open" label="Open"></topic>
<topic href="help/EGit/User_Guide/Reference.html#Checkout" label="Checkout"></topic>
<topic href="help/EGit/User_Guide/Reference.html#Create_Branch..." label="Create Branch..."></topic>
+ <topic href="help/EGit/User_Guide/Reference.html#Delete_Branch" label="Delete Branch"></topic>
<topic href="help/EGit/User_Guide/Reference.html#Create_Tag..." label="Create Tag..."></topic>
<topic href="help/EGit/User_Guide/Reference.html#Create_Patch..." label="Create Patch..."></topic>
<topic href="help/EGit/User_Guide/Reference.html#Cherry_Pick" label="Cherry Pick"></topic>
@@ -305,6 +316,8 @@
<topic href="help/EGit/User_Guide/Reference.html#Wrap_Comments" label="Wrap Comments"></topic>
<topic href="help/EGit/User_Guide/Reference.html#Fill_Paragraphs" label="Fill Paragraphs"></topic>
</topic>
+ <topic href="help/EGit/User_Guide/Reference.html#Drag_and_Drop_Support" label="Drag and Drop Support"></topic>
+ <topic href="help/EGit/User_Guide/Reference.html#Working_with_the_Revision_Details_Area" label="Working with the Revision Details Area"></topic>
</topic>
<topic href="help/EGit/User_Guide/Reference.html#Synchronize_View" label="Synchronize View">
<topic href="help/EGit/User_Guide/Reference.html#Synchronization_State" label="Synchronization State"></topic>
@@ -314,6 +327,7 @@
</topic>
<topic href="help/EGit/User_Guide/Reference.html#Git_Tree_Compare_View" label="Git Tree Compare View"></topic>
<topic href="help/EGit/User_Guide/Reference.html#Git_Staging_View" label="Git Staging View"></topic>
+ <topic href="help/EGit/User_Guide/Reference.html#Git_Reflog_View" label="Git Reflog View"></topic>
</topic>
<topic href="help/EGit/User_Guide/Reference.html#Git_URLs" label="Git URLs"></topic>
<topic href="help/EGit/User_Guide/Reference.html#Git_References" label="Git References"></topic>
@@ -377,33 +391,43 @@
</topic>
<topic href="help/JGit/User_Guide/Updating-This-Document.html" label="Updating This Document"></topic>
</topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html" label="EGit 1.1 New and Noteworthy">
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html" label="New Features">
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#New_Reflog_View" label="New Reflog View"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#Allow_dragging_of_commits_from_History_view" label="Allow dragging of commits from History view"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#New_preference_to_ignore_whitespace_changes_in_blame_annotations" label="New preference to ignore whitespace changes in blame annotations"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#History_View_always_displays_HEAD_and_other_additional_refs" label="History View always displays HEAD and other additional refs"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#More_information_displayed_in_merge.2C_fetch_and_push_results_dialogs" label="More information displayed in merge, fetch and push results dialogs"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#Commit_Dialog_Improvements" label="Commit Dialog Improvements"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#Staging_View" label="Staging View"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#New_Features_in_Synchronize_View" label="New Features in Synchronize View"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#Team_Project_Set_Support" label="Team Project Set Support"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#Logical_Model_Support" label="Logical Model Support"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/1.1.html#Navigating_from_tasks_to_commits" label="Navigating from tasks to commits"></topic>
- </topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/New-Actions.html" label="New Actions"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html" label="GitHub Mylyn Connector">
- <topic href="help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html#Pull_Request_Support" label="Pull Request Support"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html#Import_and_Clone" label="Import and Clone"></topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/GitHub-Mylyn-Connector.html#GitHub_Java_API" label="GitHub Java API"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html" label="EGit 1.2 New and Noteworthy">
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html" label="New Features">
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Improved_decorator_performance" label="Improved decorator performance"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Support_for_project_rename_and_move_for_some_cases" label="Support for project rename and move for some cases"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Option_to_auto-share_projects_on_import_when_located_in_a_working_tree" label="Option to auto-share projects on import when located in a working tree"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Interactive_adding_in_Compare_Editors" label="Interactive adding in Compare Editors"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Repositories_View" label="Repositories View">
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Pull_with_multi-selection" label="Pull with multi-selection"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Property_page_for_repository_configuration" label="Property page for repository configuration"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Delete_tag_command" label="Delete tag command"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Drag_file_from_working_tree_to_open_editor" label="Drag file from working tree to open editor"></topic>
+ </topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#History_View" label="History View">
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Option_to_follow_renames" label="Option to follow renames"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Delete_Branch_Command" label="Delete Branch Command"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Show_annotations_from_file_table_in_history_view" label="Show annotations from file table in history view"></topic>
+ </topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Reflog_View" label="Reflog View">
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Show_Timestamp_and_Commit_Short_Message" label="Show Timestamp and Commit Short Message"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#New_Commands" label="New Commands"></topic>
+ </topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Commit_Editor" label="Commit Editor">
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Checkout_Command" label="Checkout Command"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#Cherry-Pick_Command" label="Cherry-Pick Command"></topic>
+ </topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/1.2.html#GitHub_Mylyn_Connector" label="GitHub Mylyn Connector"></topic>
</topic>
- <topic href="help/EGit/New_and_Noteworthy/1.1/Updating-This-Document.html" label="Updating This Document"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/Bugs-Closed.html" label="Bugs Closed"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/Commits.html" label="Commits"></topic>
+ <topic href="help/EGit/New_and_Noteworthy/1.2/Updating-This-Document.html" label="Updating This Document"></topic>
</topic>
- <topic href="help/JGit/New_and_Noteworthy/1.1/1.1.html" label="JGit 1.1 New and Noteworthy">
- <topic href="help/JGit/New_and_Noteworthy/1.1/1.1.html" label="Git Porcelain API Updates"></topic>
- <topic href="help/JGit/New_and_Noteworthy/1.1/Features.html" label="Features"></topic>
- <topic href="help/JGit/New_and_Noteworthy/1.1/Performance-Improvements.html" label="Performance Improvements"></topic>
- <topic href="help/JGit/New_and_Noteworthy/1.1/Updating-This-Document.html" label="Updating This Document"></topic>
+ <topic href="help/JGit/New_and_Noteworthy/1.2/1.2.html" label="JGit 1.2 New and Noteworthy">
+ <topic href="help/JGit/New_and_Noteworthy/1.2/1.2.html" label="Git Porcelain API Updates"></topic>
+ <topic href="help/JGit/New_and_Noteworthy/1.2/Features.html" label="Features"></topic>
+ <topic href="help/JGit/New_and_Noteworthy/1.2/Bugs-Closed.html" label="Bugs Closed"></topic>
+ <topic href="help/JGit/New_and_Noteworthy/1.2/Commits.html" label="Commits"></topic>
+ <topic href="help/JGit/New_and_Noteworthy/1.2/Updating-This-Document.html" label="Updating This Document"></topic>
</topic>
<topic href="help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html" label="Git for Eclipse Users">
<topic href="help/EGit/Git_For_Eclipse_Users/Git-For-Eclipse-Users.html" label="Centralised version control systems"></topic>

Back to the top