Re: [PATCH] Documentation: New GUI configuration and command-line options.

> ---
>  Documentation/config.txt        |   24 ++++++++++++++++++++++++
>  Documentation/git-gui.txt       |   19 +++++++++++++++++++
>  Documentation/gitattributes.txt |   17 +++++++++++++++++
>  Documentation/gitk.txt          |    5 +++++
>  4 files changed, 65 insertions(+), 0 deletions(-)
> 
> diff --git a/Documentation/config.txt b/Documentation/config.txt
> index 965ed74..2223dc4 100644
> --- a/Documentation/config.txt
> +++ b/Documentation/config.txt
> @@ -796,6 +796,14 @@ gui.diffcontext::
>  	Specifies how many context lines should be used in calls to diff
>  	made by the linkgit:git-gui[1]. The default is "5".
>  
> +gui.encoding::
> +	Specifies the default encoding to use for displaying of
> +	file contents in linkgit:git-gui[1] and linkgit:gitk[1].
> +	It can be overridden by setting the 'encoding' attribute
> +	for relevant files (see linkgit:gitattributes[5]).
> +	If this option is not set, the tools default to the
> +	locale encoding.
> +
>  gui.matchtrackingbranch::
>  	Determines if new branches created with linkgit:git-gui[1] should
>  	default to tracking remote branches with matching names or
> @@ -818,6 +826,22 @@ gui.spellingdictionary::
>  	the linkgit:git-gui[1]. When set to "none" spell checking is turned
>  	off.
>  
> +gui.fastcopyblame::
> +	If true, 'git gui blame' uses '-C' instead of '-C -C' for original
> +	location detection. It makes blame significantly faster on huge
> +	repositories at the expense of less thorough copy detection.
> +
> +gui.copyblamethreshold::
> +	Specifies the theshold to use in 'git gui blame' original location
> +	detection, measured in alphanumeric characters. See the
> +	linkgit:git-blame[1] manual for more information on copy detection.
> +
> +gui.blamehistoryctx::
> +	Specifies the radius of history context in days to show in
> +	linkgit:gitk[1] for the selected commit, when the `Show History
> +	Context` menu item is invoked from 'git gui blame'. If this
> +	variable is set to zero, the whole history is shown.
> +
>  help.browser::
>  	Specify the browser that will be used to display help in the
>  	'web' format. See linkgit:git-help[1].
> diff --git a/Documentation/git-gui.txt b/Documentation/git-gui.txt
> index 0e650f4..d0bc98b 100644
> --- a/Documentation/git-gui.txt
> +++ b/Documentation/git-gui.txt
> @@ -65,9 +65,28 @@ git gui blame v0.99.8 Makefile::
>  	example the file is read from the object database and not
>  	the working directory.
>  
> +git gui blame --line=100 Makefile::
> +
> +	Loads annotations as described above and automatically
> +	scrolls the view to center on line '100'.
> +
>  git gui citool::
>  
>  	Make one commit and return to the shell when it is complete.
> +	This command returns a non-zero exit code if the window was
> +	closed in any way other than by making a commit.
> +
> +git gui citool --amend::
> +
> +	Automatically enter the 'Amend Last Commit' mode of
> +	the interface.
> +
> +git gui citool --nocommit::
> +
> +	Behave as normal citool, but instead of making a commit
> +	simply terminate with a zero exit code. It still checks
> +	that the index does not contain any unmerged entries, so
> +	you can use it as a GUI version of linkgit:git-mergetool[1]
>  
>  git citool::
>  
> diff --git a/Documentation/gitattributes.txt b/Documentation/gitattributes.txt
> index eb64841..e02899f 100644
> --- a/Documentation/gitattributes.txt
> +++ b/Documentation/gitattributes.txt
> @@ -495,6 +495,23 @@ in the file.  E.g. the string `$Format:%H$` will be replaced by the
>  commit hash.
>  
>  
> +Viewing files in GUI tools
> +~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +`encoding`
> +^^^^^^^^^^
> +
> +The value of this attribute specifies the character encoding that should
> +be used by GUI tools (e.g. linkgit:gitk[1] and linkgit:git-gui[1]) to
> +display the contents of the relevant file. Note that due to performance
> +considerations linkgit:gitk[1] does not use this attribute unless you
> +manually enable per-file encodings in its options.
> +
> +If this attribute is not set or has an invalid value, the value of the
> +`gui.encoding` configuration variable is used instead
> +(See linkgit:git-config[1]).
> +
> +
>  USING ATTRIBUTE MACROS
>  ----------------------
>  
> diff --git a/Documentation/gitk.txt b/Documentation/gitk.txt
> index ae29a00..317f631 100644
> --- a/Documentation/gitk.txt
> +++ b/Documentation/gitk.txt
> @@ -56,6 +56,11 @@ frequently used options.
>  	Use this instead of explicitly specifying <revs> if the set of
>  	commits to show may vary between refreshes.
>  
> +--select-commit=<ref>::
> +
> +	Automatically select the specified commit after loading the graph.
> +	Default behavior is equivalent to specifying '--select-commit=HEAD'.
> +
>  <revs>::
>  
>  	Limit the revisions to show. This can be either a single revision
> -- 
> 1.6.0.3.15.gb8d36