Re: [PATCH v2 1/2] doc/pack-refs: convert synopsis and options to new style

[Junio C Hamano <gitster@pobox.com>]

Todd Zullinger <tmz@pobox.com> writes:

> Replace [verse] with [synopsis] in the SYNOPSIS block and remove
> single-quote formatting from the command name.
>
> Backtick-quote all option terms in the OPTIONS section and convert
> the standalone placeholder _<branch>_ in prose.
>
> Update the included pack-refs-options.adoc to backtick-quote all
> configuration key terms.

Micronit.  I think you backtick-quoted `--all`, `--no-prune`, and
friends, that are not configuration keyu terms but command line
options.

> diff --git a/Documentation/pack-refs-options.adoc b/Documentation/pack-refs-options.adoc
> index 0b11282941..2263648b39 100644
> --- a/Documentation/pack-refs-options.adoc
> +++ b/Documentation/pack-refs-options.adoc
> @@ -1,4 +1,4 @@
> ---all::
> +`--all`::
>  
>  The command by default packs all tags and refs that are already
>  packed, and leaves other refs
> @@ -8,12 +8,12 @@ This option causes all refs to be packed as well, with the exception
>  of hidden refs, broken refs, and symbolic refs. Useful for a repository
>  with many branches of historical interests.
>  
> ---no-prune::
> +`--no-prune`::
>  
>  The command usually removes loose refs under `$GIT_DIR/refs`
>  hierarchy after packing them.  This option tells it not to.
>  
> ---auto::
> +`--auto`::
>  
>  Pack refs as needed depending on the current state of the ref database. The
>  behavior depends on the ref format used by the repository and may change in the
> @@ -29,7 +29,7 @@ future.
>  	  maintains the property that N is at least twice as big as N+1. Only
>  	  tables that violate this property are compacted.
>  
> ---include <pattern>::
> +`--include <pattern>`::
>  
>  Pack refs based on a `glob(7)` pattern. Repetitions of this option
>  accumulate inclusion patterns. If a ref is both included in `--include` and
> @@ -38,7 +38,7 @@ tags from being included by default. Symbolic refs and broken refs will never
>  be packed. When used with `--all`, it will be a noop. Use `--no-include` to clear
>  and reset the list of patterns.
>  
> ---exclude <pattern>::
> +`--exclude <pattern>`::
>  
>  Do not pack refs matching the given `glob(7)` pattern. Repetitions of this option
>  accumulate exclusion patterns. Use `--no-exclude` to clear and reset the list of