From: しらいしななこ <nanako3@bluebottle.com>
Date: Wed, 27 Feb 2008 13:22:43 GMT
Subject: Re: [PATCH] Documentation: help: describe 'man.viewer' config variable.
Message-ID: <200802271323.m1RDNGTQ025557@mi1.bluebottle.com>
In-Reply-To: <20080227065535.8ac7883a.chriscool@tuxfamily.org>

Quoting Christian Couder <chriscool@tuxfamily.org>:

> +man.viewer::
> +	Specify the program that will be used to display help in the
> +	'man' format. See linkgit:git-help[1].
> +
>  -i|--info::
> -	Use the 'info' program to display the manual page, instead of
> -	the 'man' program that is used by default.
> +	Display manual documentation about the command in Info
> +	format. The 'info' program will be used for that purpose.

I am not a native speaker of the English language, but "manual documentation about" feels duplicatedly redundant, at least to me.  I think it is more common to say "the manual page for", or "the man page for".

>  -m|--man::
> -	Use the 'man' program to display the manual page. This may be
> -	used to override a value set in the 'help.format'
> -	configuration variable.
> +	Display manual documentation about the command in Man format.

An earlier description for man.viewer says "in the 'man' format".

> +	This option may be used to override a value set in the
> +	'help.format' configuration variable.
> ++
> +By default the 'man' program will be used to display the man pages,

And this part says "the man pages".

>  -w|--web::
> -	Use a web browser to display the HTML manual page, instead of
> -	the 'man' program that is used by default.
> +	Display manual documentation about the command in HTLM format.
> +	A web browser will be used for that purpose.

Is this a mistyped "HTML format"?

-- 
Nanako Shiraishi
http://ivory.ap.teacup.com/nanako3/

----------------------------------------------------------------------
Get a free email address with REAL anti-spam protection.
http://www.bluebottle.com/tag/1