]> asedeno.scripts.mit.edu Git - git.git/commitdiff
Merge branch 'jn/doc-backslash'
authorJunio C Hamano <gitster@pobox.com>
Fri, 3 Sep 2010 16:43:42 +0000 (09:43 -0700)
committerJunio C Hamano <gitster@pobox.com>
Fri, 3 Sep 2010 16:43:42 +0000 (09:43 -0700)
* jn/doc-backslash:
  Documentation: remove stray backslash in show-branch discussion
  Documentation: remove stray backslashes from "Fighting regressions" article
  Documentation: do not convert ... operator to ellipses
  Documentation: avoid stray backslash in user manual
  Documentation: avoid stray backslashes in core tutorial
  Documentation: remove stray backslashes in rev-parse manual
  Documentation: remove backslash before ~ in fast-import manual
  Documentation: remove stray backslash from "git bundle" manual
  Documentation/technical: avoid stray backslash in parse-options API docs
  Documentation: remove backslashes in manpage synopses
  Documentation: clarify quoting in gitignore docs
  Documentation: clarify quoting in "git rm" example
  Documentation: add missing quotes to "git grep" examples
  Documentation: clarify quoting in "git add" example
  Documentation: unbreak regex in show-ref manual
  Documentation: quoting trouble in "git rm" discussion
  Documentation: tweak description of log.date

1  2 
Documentation/config.txt
Documentation/git-fast-export.txt
Documentation/git-rebase.txt

diff --combined Documentation/config.txt
index 61831f60ce61f8a601fed3ba0b40559929d0ee61,250095db5635dd2f3fd2501d6c919a8e83b7dba6..0510ac795c1d558b7f3a551ac5cc10ba1f1c8dff
@@@ -1248,15 -1248,6 +1248,15 @@@ http.noEPSV:
        support EPSV mode. Can be overridden by the 'GIT_CURL_FTP_NO_EPSV'
        environment variable. Default is false (curl will use EPSV).
  
 +http.useragent::
 +      The HTTP USER_AGENT string presented to an HTTP server.  The default
 +      value represents the version of the client git such as git/1.7.1.
 +      This option allows you to override this value to a more common value
 +      such as Mozilla/4.0.  This may be necessary, for instance, if
 +      connecting through a firewall that restricts HTTP connections to a set
 +      of common USER_AGENT strings (but not including those like git/1.7.1).
 +      Can be overridden by the 'GIT_HTTP_USER_AGENT' environment variable.
 +
  i18n.commitEncoding::
        Character encoding the commit messages are stored in; git itself
        does not care per se, but this information is necessary e.g. when
@@@ -1305,10 -1296,11 +1305,11 @@@ interactive.singlekey:
        ignored if portable keystroke input is not available.
  
  log.date::
-       Set default date-time mode for the log command. Setting log.date
-       value is similar to using 'git log'\'s --date option. The value is one of the
-       following alternatives: {relative,local,default,iso,rfc,short}.
-       See linkgit:git-log[1].
+       Set the default date-time mode for the 'log' command.
+       Setting a value for log.date is similar to using 'git log''s
+       `\--date` option.  Possible values are `relative`, `local`,
+       `default`, `iso`, `rfc`, and `short`; see linkgit:git-log[1]
+       for details.
  
  log.decorate::
        Print out the ref names of any commits that are shown by the log
@@@ -1549,9 -1541,6 +1550,9 @@@ rebase.stat:
        Whether to show a diffstat of what changed upstream since the last
        rebase. False by default.
  
 +rebase.autosquash::
 +      If set to true enable '--autosquash' option by default.
 +
  receive.autogc::
        By default, git-receive-pack will run "git-gc --auto" after
        receiving data from git-push and updating refs.  You can stop
@@@ -1646,9 -1635,7 +1647,9 @@@ remote.<name>.tagopt:
        Setting this value to \--no-tags disables automatic tag following when
        fetching from remote <name>. Setting it to \--tags will fetch every
        tag from remote <name>, even if they are not reachable from remote
 -      branch heads.
 +      branch heads. Passing these flags directly to linkgit:git-fetch[1] can
 +      override this setting. See options \--tags and \--no-tags of
 +      linkgit:git-fetch[1].
  
  remote.<name>.vcs::
        Setting this to a value <vcs> will cause git to interact with
@@@ -1778,7 -1765,7 +1779,7 @@@ submodule.<name>.ignore:
        Using "none" (the default when this option is not set) also shows
        submodules that have untracked files in their work tree as changed.
        This setting overrides any setting made in .gitmodules for this submodule,
 -      both settings can be overriden on the command line by using the
 +      both settings can be overridden on the command line by using the
        "--ignore-submodules" option.
  
  tar.umask::
index 8a6a3cb255258dddc38f69b20525f8d123683681,cbc31c1fa5c601ccec9f6f76e4099bed24a2e533..fcad1132767021a03a88cf084d5eaf4ae8780792
@@@ -90,16 -90,10 +90,16 @@@ marks the same across runs
        resulting stream can only be used by a repository which
        already contains the necessary objects.
  
 +--full-tree::
 +      This option will cause fast-export to issue a "deleteall"
 +      directive for each commit followed by a full list of all files
 +      in the commit (as opposed to just listing the files which are
 +      different from the commit's first parent).
 +
  [git-rev-list-args...]::
         A list of arguments, acceptable to 'git rev-parse' and
         'git rev-list', that specifies the specific objects and references
-        to export.  For example, `master\~10..master` causes the
+        to export.  For example, `master{tilde}10..master` causes the
         current master reference to be exported along with all objects
         added since its 10th ancestor commit.
  
index 45c52d2e57d2f4c2783c32b4cb3ff8f4dcd6414e,b8aa0b999ddf878823622d3884d9def81996c7ff..30e5c0eb14470a5f72174b1071eac79c55fb0c41
@@@ -199,9 -199,6 +199,9 @@@ rebase.stat:
        Whether to show a diffstat of what changed upstream since the last
        rebase. False by default.
  
 +rebase.autosquash::
 +      If set to true enable '--autosquash' option by default.
 +
  OPTIONS
  -------
  <newbase>::
        <upstream>.  May be any valid commit, and not just an
        existing branch name.
  +
- As a special case, you may use "A...B" as a shortcut for the
+ As a special case, you may use "A\...B" as a shortcut for the
  merge base of A and B if there is exactly one merge base. You can
  leave out at most one of A and B, in which case it defaults to HEAD.
  
@@@ -336,7 -333,6 +336,7 @@@ idea unless you know what you are doin
        instead.
  
  --autosquash::
 +--no-autosquash::
        When the commit log message begins with "squash! ..." (or
        "fixup! ..."), and there is a commit whose title begins with
        the same ..., automatically modify the todo list of rebase -i
        commit from `pick` to `squash` (or `fixup`).
  +
  This option is only valid when the '--interactive' option is used.
 ++
 +If the '--autosquash' option is enabled by default using the
 +configuration variable `rebase.autosquash`, this option can be
 +used to override and disable this setting.
  
  --no-ff::
        With --interactive, cherry-pick all rebased commits instead of
@@@ -474,30 -466,6 +474,30 @@@ sure that the current HEAD is "B", and 
  $ git rebase -i -p --onto Q O
  -----------------------------
  
 +Reordering and editing commits usually creates untested intermediate
 +steps.  You may want to check that your history editing did not break
 +anything by running a test, or at least recompiling at intermediate
 +points in history by using the "exec" command (shortcut "x").  You may
 +do so by creating a todo list like this one:
 +
 +-------------------------------------------
 +pick deadbee Implement feature XXX
 +fixup f1a5c00 Fix to feature XXX
 +exec make
 +pick c0ffeee The oneline of the next commit
 +edit deadbab The oneline of the commit after
 +exec cd subdir; make test
 +...
 +-------------------------------------------
 +
 +The interactive rebase will stop when a command fails (i.e. exits with
 +non-0 status) to give you an opportunity to fix the problem. You can
 +continue with `git rebase --continue`.
 +
 +The "exec" command launches the command in a shell (the one specified
 +in `$SHELL`, or the default shell if `$SHELL` is not set), so you can
 +use shell features (like "cd", ">", ";" ...). The command is run from
 +the root of the working tree.
  
  SPLITTING COMMITS
  -----------------