"Junio C Hamano" <gitster@xxxxxxxxx> writes:
> Jonathan Nieder <jrnieder@xxxxxxxxx> writes:
>
>>> what's with that "git config bla ~/"? is this some config keyword
>>> or something?
>> ...
>>
>> I agree with you that it is less clear than it could be. Ideas for
>> clarifying it?
>
> Yeah, if it were
>
> git config section.var ~/some/thing
>
> that would be far clearer than "bla" that what we see is a mere
> placeholder.
Agreed.
> Another obvious option is to remove the parenthetical comment.
>
> Or "(but you can give values without quoting and let your shell
> expand it)", without a confusing sample command that proved not to
> help very much.
I prefer your "section.var" proposal above. I think people who really understand shell quoting do not need the explanations, and others probably need the example.
While we're there, the formatting is also wrong ('' quoting, while we normally use `` quoting for shell commands).
Sounds like a nice microproject for my students :-). A patch should follow soon.
--
Matthieu Moy
https://matthieu-moy.fr/
