Users Handbook

Warren Block wblock at
Fri Nov 16 15:15:05 UTC 2012

On Fri, 16 Nov 2012, Joseph a Nagy Jr wrote:

> I'm tired of getting the third degree on irc because of this even though
> it's not something I have control over.
> When I point someone to the User's handbook for using svn[0] instead of
> portsnap, I always seem to receive flack that the handbook points users
> to checkout on the central svn repo. I can see the wisdom in using a
> mirror, but I cannot fix the handbook and am frankly tired of being
> yelled at. Please fix this.
> [0]:

You mean this part?

   Check out a copy of the ports tree. Use a specific Subversion mirror
   close to your geographic location instead of in the
   command below for better performance. Committers should read the
   Subversion Primer first to be sure the correct protocol is chosen.

   # svn checkout svn:// /usr/ports

The only way to force the user to pick a mirror is to change the example 
so it won't work until they do.  Like this:

   Pick an svn mirror and replace the {svnmirror} string below with the

   # svn checkout {svnmirror} /usr/ports

That type of non-working example is confusing.  If we show one of the 
actual mirrors, 99% of users will cut and paste that example and not 
change it.  (Actually, that's an exaggeration.  It's closer to 100%.)

I'd really like to do that better.  Any ideas?

More information about the freebsd-ports mailing list