* [PATCH v3] wording fixes in the user manual and glossary
@ 2014-05-28 2:23 Jeremiah Mahler
0 siblings, 0 replies; only message in thread
From: Jeremiah Mahler @ 2014-05-28 2:23 UTC (permalink / raw
To: Chris Packham; +Cc: Junio C Hamano, Ben Aveling, git, Jeremiah Mahler
Re-worded the section on "Updating a repository with git fetch" in the
user manual.
Various other minor fixes in the manual and glossary.
Signed-off-by: Jeremiah Mahler <jmmahler@gmail.com>
---
Notes:
This revision includes suggestions from Chris Packham, Ben Aveling
and Junio C Hamano [1].
[1]: http://marc.info/?l=git&m=140122033314094&w=2
- The changes to the "git fetch" section have been reduced.
- Kept the first sentence which Junio liked.
- Kept the second sentence as Chris had it originally except for
swapping 'command `git fetch` with '`git fetch` command' and
using 'original repository' instead of 'her repository'.
'original repository' agrees with the sentence before it.
- Other minor edits are the same as the previous version.
Documentation/glossary-content.txt | 2 +-
Documentation/user-manual.txt | 15 +++++++--------
2 files changed, 8 insertions(+), 9 deletions(-)
diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt
index be0858c..4e0b971 100644
--- a/Documentation/glossary-content.txt
+++ b/Documentation/glossary-content.txt
@@ -1,7 +1,7 @@
[[def_alternate_object_database]]alternate object database::
Via the alternates mechanism, a <<def_repository,repository>>
can inherit part of its <<def_object_database,object database>>
- from another object database, which is called "alternate".
+ from another object database, which is called an "alternate".
[[def_bare_repository]]bare repository::
A bare repository is normally an appropriately
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt
index d33f884..7330d88 100644
--- a/Documentation/user-manual.txt
+++ b/Documentation/user-manual.txt
@@ -416,12 +416,11 @@ REVISIONS" section of linkgit:gitrevisions[7].
Updating a repository with git fetch
------------------------------------
-Eventually the developer cloned from will do additional work in her
-repository, creating new commits and advancing the branches to point
-at the new commits.
+After you clone a repository and commit a few changes of your own, you
+may wish to check the original repository for updates.
-The command `git fetch`, with no arguments, will update all of the
-remote-tracking branches to the latest version found in her
+The `git-fetch` command, with no arguments, will update all of the
+remote-tracking branches to the latest version found in the original
repository. It will not touch any of your own branches--not even the
"master" branch that was created for you on clone.
@@ -1811,8 +1810,8 @@ manner.
You can then import these into your mail client and send them by
hand. However, if you have a lot to send at once, you may prefer to
use the linkgit:git-send-email[1] script to automate the process.
-Consult the mailing list for your project first to determine how they
-prefer such patches be handled.
+Consult the mailing list for your project first to determine
+their requirements for submitting patches.
[[importing-patches]]
Importing patches to a project
@@ -2255,7 +2254,7 @@ $ git checkout test && git merge speed-up-spinlocks
It is unlikely that you would have any conflicts here ... but you might if you
spent a while on this step and had also pulled new versions from upstream.
-Some time later when enough time has passed and testing done, you can pull the
+Sometime later when enough time has passed and testing done, you can pull the
same branch into the `release` tree ready to go upstream. This is where you
see the value of keeping each patch (or patch series) in its own branch. It
means that the patches can be moved into the `release` tree in any order.
--
2.0.0.rc4.480.g058e066
^ permalink raw reply related [flat|nested] only message in thread
only message in thread, other threads:[~2014-05-28 2:24 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-05-28 2:23 [PATCH v3] wording fixes in the user manual and glossary Jeremiah Mahler
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).