Re: [PATCH] documentation: git-config minor cleanups

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Cliff Frey wrote:

> Change push.default's description to add hyphens between values and
> descriptions to make the manpage easier to read.  The html version is
> readable either way.
> 
> Change status.showUntrackedFiles to make item descriptions be
> sentences and to use the same asciidoc format as push.default.

Yep, it is hard to read

| Â    nothing do not push anything.
|
| Â    matching push all matching branches. All
|     branches having the same name in both ends are
[etc]

without the font change to indicate where each term begins and ends.

So for what it's worth:
Acked-by: Jonathan Nieder <jrnieder@xxxxxxxxx>

Thanks.

> --- a/Documentation/config.txt
> +++ b/Documentation/config.txt
> @@ -1765,9 +1765,9 @@ status.showUntrackedFiles::
>  	the untracked files. Possible values are:
>  +
>  --
> -	- 'no'     - Show no untracked files
> -	- 'normal' - Shows untracked files and directories
> -	- 'all'    - Shows also individual files in untracked directories.
> +* `no` - Show no untracked files.
> +* `normal` - Shows untracked files and directories.
> +* `all` - Shows also individual files in untracked directories.

If you are making these into sentences, they should be

 - Show no untracked...
 - Show untracked...
 - Also show...

, no?  [i.e., s/Shows/Show/c]
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]