From owner-freebsd-ports@FreeBSD.ORG  Fri Nov 16 15:21:47 2012
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
 by hub.freebsd.org (Postfix) with ESMTP id 257EFEBD
 for <ports@freebsd.org>; Fri, 16 Nov 2012 15:21:47 +0000 (UTC)
 (envelope-from royce.williams@gmail.com)
Received: from mail-lb0-f182.google.com (mail-lb0-f182.google.com
 [209.85.217.182])
 by mx1.freebsd.org (Postfix) with ESMTP id 965918FC15
 for <ports@freebsd.org>; Fri, 16 Nov 2012 15:21:46 +0000 (UTC)
Received: by mail-lb0-f182.google.com with SMTP id go10so125914lbb.13
 for <ports@freebsd.org>; Fri, 16 Nov 2012 07:21:45 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:sender:in-reply-to:references:from:date
 :x-google-sender-auth:message-id:subject:to:cc:content-type;
 bh=3G3q+Ig8L3kGs5yJbrwTIZ0URvOr99aK2TPpqwXqr5I=;
 b=V6DSHIg/LY4KyLo0v6lFRVEuJMTqRDzuU0LkAUlkefYF1jwLRgbVet8ckitgePIATD
 zsngLKZGMkzWa4qkORv7e0hC2csLxKmtKDz5VT64TkX8xDf4GBQmS+rfoVHt0bs0uXzo
 8YQPYXAqq4aGoX8HuD+s9aqkHMhCRSErBsuR24M+WVE0HDhjGAD/5sNkCoF5Cag0O8OT
 J69dmmIiTU+kmXXa3g0x+tMmGVtlzy9+CRSA+XnH7+aUSGIGd+V8kxMrHEFHaYzy5VPe
 kBP6nwSmyrXp+i6J2MoIwVPRyQWUT7OynA5BhfyZkzvzV8IHzFwNOVDeoeFoO95IpbSA
 QkLw==
Received: by 10.112.37.7 with SMTP id u7mr2111466lbj.30.1353079305468; Fri, 16
 Nov 2012 07:21:45 -0800 (PST)
MIME-Version: 1.0
Sender: royce.williams@gmail.com
Received: by 10.112.134.199 with HTTP; Fri, 16 Nov 2012 07:21:25 -0800 (PST)
In-Reply-To: <alpine.BSF.2.00.1211160807280.74281@wonkity.com>
References: <50A64F69.30607@gmail.com>
 <alpine.BSF.2.00.1211160807280.74281@wonkity.com>
From: Royce Williams <royce@tycho.org>
Date: Fri, 16 Nov 2012 06:21:25 -0900
X-Google-Sender-Auth: MD1S4WUx2NHz5aw3ugDBYN96DNc
Message-ID: <CA+E3k91HvmhCTihUxN5Rm54mSUAhoVtms9Oiis3UX1zy4_urMQ@mail.gmail.com>
Subject: Re: Users Handbook
To: Warren Block <wblock@wonkity.com>
Content-Type: text/plain; charset=ISO-8859-1
Cc: FreeBSD Ports <ports@freebsd.org>, Joseph a Nagy Jr <jnagyjr1978@gmail.com>
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 16 Nov 2012 15:21:47 -0000

On Fri, Nov 16, 2012 at 6:15 AM, Warren Block <wblock@wonkity.com> wrote:

[snip]

> 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
>   URL.
>
>   # 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?

Speaking pie-in-the-sky, is there an equivalent of fastest-cvsup for
SVN?  If not, creating a 'fastest-svn' and using that as the example
treats the cut-and-paste symptom.  Having a way to prompt the user to
ask if they want to cache its results might be even better.

Royce