Re: vc-dired doesn't contact server (was Re: Adding 2006. + VC/PCL-CVS)

[Nick Roberts <nickrob@snap.net.nz>]

 > > Is there a variable that makes vc contact the server?
 > 
 > Yes, it's called vc-stay-local.  Set it to nil and VC contacts the
 > repository for operations such as vc-directory.  This tends to be rather
 > slow, so setting that variable to t is usually preferred.  If the state
 > of the file in the repository is different than what the local
 > heuristics suggest, you'll be notified of that at checkin time anyway.
 > 
 > See the doc string of vc-stay-local; you can set it up so that it stays
 > local only for certain repositories.  You can also set it
 > backend-specific by using vc-BACKEND-stay-local.

Thanks.  That's very clear, but as vc-stay-local isn't mentioned in the manual
and it affects behaviour of VC in a fundamental way, how about the patch below
(based on your wording)?

-- 
Nick                                           http://www.inet.net.nz/~nickrob


*** files.texi	14 Feb 2006 10:13:52 +1300	1.132
--- files.texi	17 Feb 2006 09:06:32 +1300	
*************** The files @samp{file1} and @samp{file2} 
*** 1963,1968 ****
--- 1963,1979 ----
  have also been checked in to the repository---you need to merge them
  with the work file before you can check it in.
  
+ @vindex vc-stay-local
+ The variable @code{vc-stay-local} is nil in the example above which
+ means VC contacts the repository.  This tends to be rather
+ slow, so setting that variable to t is the default.  If the state
+ of the file in the repository is different than what the local
+ heuristics suggest, you'll be notified of that at checkin time anyway.
+ 
+ You can also set it up so that it stays local only for certain
+ repositories and in a backend-specific way by using
+ @code{vc-@var{backend}-stay-local}.
+ 
  @vindex vc-directory-exclusion-list
    When VC Dired displays subdirectories (in the ``full'' display mode),
  it omits some that should never contain any files under version control.