Quoting Brian (2019-12-03 14:39:28)
> On Tue 03 Dec 2019 at 08:07:16 -0500, rhkra...@gmail.com wrote:
> 
> > On Tuesday, December 03, 2019 07:16:22 AM Andrei POPESCU wrote:
> > > With 'find' instead of 'locate'.
> > > 
> > >     find dir_with_repos -type d -name .git
> > > 
> > > or
> > > 
> > >     find dir_with_repos -type d -name "*.git"
> > > 
> > > if you also have git bare clones ('-name' expects a shell pattern).
> > 
> > It took me a minute (well, a trial) to realize that dir_with_repos 
> > is a metaname (right word?).  I prefer a syntax like:
> > 
> > find <dir_with_repos> -type d -name .git
> 
> I prefer that syntax too but many users (particularly new ones) end up 
> typing the angle brackets, which, of course, leads to a failed 
> command. A second mail is then needed to clear up the confusion. I've 
> taken to doing what Andrei does or giving an instruction as to what to 
> type.

I agree that angle brackets has a real risk of wreaking havoc for less 
experienced users following instructions "to the letter".  I did so 
myself back in 1998 when moving from MacOS 8 to Linux :-)

What I have so far settled on is to distinguish "variables" in capital 
letters, and explicitly hint that it should be changed, like this:

With 'find' instead of 'locate' (adapt dir):

  find DIR_WITH_REPOS -type d -name .git


 - Jonas

-- 
 * Jonas Smedegaard - idealist & Internet-arkitekt
 * Tlf.: +45 40843136  Website: http://dr.jones.dk/

 [x] quote me freely  [ ] ask before reusing  [ ] keep private

Attachment: signature.asc
Description: signature

Reply via email to