From: Jonathan Nieder <jrnieder@gmail.com>
To: Rodrigo Silva <rodrigosilva@rodrigosilva.com>
Cc: Junio C Hamano <gitster@pobox.com>,
"Rodrigo Silva (MestreLion)" <linux@rodrigosilva.com>,
git@vger.kernel.org, Ben Walton <bwalton@artsci.utoronto.ca>
Subject: Re: [PATCH 1/2] var doc: default editor and pager are configurable at build time
Date: Sat, 31 Mar 2012 05:51:06 -0500 [thread overview]
Message-ID: <20120331105106.GA12552@burratino> (raw)
In-Reply-To: <4f76de0e.2ac7b60a.54ce.ffffd85eSMTPIN_ADDED@mx.google.com>
Hi Rodrigo,
Rodrigo Silva wrote:
>> Unfortunately those compile-time settings do not affect the
>> documentation, so the uninitiated user who tries to understand git by
>> reading the git-var(1) manpage can easily be confused when git falls
>> back to 'nano' and 'more' instead of 'vi' and 'less'. Even if the
>> distributor patches the distributed docs to reflect the new default,
>> the user may read the official documentation from the git-htmldocs
>> repository online and be confused in the same way.
>
> I'm sorry, but I disagree with this approach. There is no "usually":
> upstream sources are *always* 'vi', and Debian packages are *always*
> 'editor'.
I disagree. If I build the pristine source from Junio with
"./configure --with-shell=my-favorite-shell", I still have built the
pristine source from Junio.
[...]
> Upstream git /could/ say "... and finally, a hardcoded editor chosen
> at compile time, by default 'vi'"
It is not hardcoded.
[...]
> IMHO, only saying that "it can be customized", "it is usually 'vi'",
> without saying it /was/ customized and it /isn't/ vi, but editor, is
> not a good approach.
Ah, perhaps that is the source of misunderstanding. This is a
two-patch series. The two patches are meant to go together. Does
that help?
Sorry for the lack of clarity,
Jonathan
next prev parent reply other threads:[~2012-03-31 10:51 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20120330002543.2138.91961.reportbug@localhost6.localdomain6>
2012-03-30 0:55 ` [PATCH] Documentation: replace 'vi' for 'editor' to reflect build-time option Jonathan Nieder
2012-03-30 2:16 ` Junio C Hamano
2012-03-30 10:33 ` Bug#666250: " Rodrigo Silva
[not found] ` <20120330103326.272B040A067@cobalt.pobox.com>
2012-03-30 16:46 ` Junio C Hamano
2012-03-31 8:40 ` [PATCH 0/2] " Jonathan Nieder
2012-03-31 8:42 ` [PATCH 1/2] var doc: default editor and pager are configurable at build time Jonathan Nieder
[not found] ` <4f76de0e.2ac7b60a.54ce.ffffd85eSMTPIN_ADDED@mx.google.com>
2012-03-31 10:51 ` Jonathan Nieder [this message]
2012-03-31 8:44 ` [PATCH 2/2] var doc: advertise current DEFAULT_PAGER and DEFAULT_EDITOR settings Jonathan Nieder
2012-03-31 17:55 ` Junio C Hamano
2012-04-18 20:02 ` Jonathan Nieder
2012-03-31 20:29 ` [PATCH] Documentation: replace 'vi' for 'editor' to reflect build-time option Phil Hord
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20120331105106.GA12552@burratino \
--to=jrnieder@gmail.com \
--cc=bwalton@artsci.utoronto.ca \
--cc=git@vger.kernel.org \
--cc=gitster@pobox.com \
--cc=linux@rodrigosilva.com \
--cc=rodrigosilva@rodrigosilva.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).