From owner-freebsd-ports@FreeBSD.ORG Fri Nov 16 16:23:24 2012 Return-Path: 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 1107FB77 for ; Fri, 16 Nov 2012 16:23:24 +0000 (UTC) (envelope-from m.e.sanliturk@gmail.com) Received: from mail-vb0-f54.google.com (mail-vb0-f54.google.com [209.85.212.54]) by mx1.freebsd.org (Postfix) with ESMTP id A49F58FC14 for ; Fri, 16 Nov 2012 16:23:23 +0000 (UTC) Received: by mail-vb0-f54.google.com with SMTP id l1so3859960vba.13 for ; Fri, 16 Nov 2012 08:23:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=zGRhWIp9xVVSNteuXosQ4HY+4I6onh1+rns66LBQpSI=; b=O+KT/SeyHFgWNetu0n/jHdPm1irVo+gj54iYUcEz4wvQZpV6nr5CDZJGPFxOQmpaPU 5cKpa9sn8UTNqkADmqa0B51tiPsEr4+IH19hCu6PndQHyBSVAPu/dYpEgSMdPTMAoeMG O97sXsOeAEWwzY8CV5dca/lyGgCr1qVwHCXMOjQwzuyZVpcD8wVdAasF0yWC/mqKn5pM 2bOUZJl2Qwft3Y7KLhvEz3fKvs8MuEZ4OdTUgtGyazTX5LliyjzOPnr4a4N3KLBF/klK dJ2gIHmRLNPSdHR8m5LmIGnfBoYo0brxFAimy3y8zWcVmZTmApyE6LzbI0FC7LX8jZ6v NT7w== MIME-Version: 1.0 Received: by 10.220.115.138 with SMTP id i10mr7362963vcq.37.1353083002550; Fri, 16 Nov 2012 08:23:22 -0800 (PST) Received: by 10.58.218.35 with HTTP; Fri, 16 Nov 2012 08:23:22 -0800 (PST) In-Reply-To: References: <50A64F69.30607@gmail.com> Date: Fri, 16 Nov 2012 08:23:22 -0800 Message-ID: Subject: Re: Users Handbook From: Mehmet Erol Sanliturk To: Warren Block Content-Type: text/plain; charset=UTF-8 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 Cc: FreeBSD Ports , Joseph a Nagy Jr X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Nov 2012 16:23:24 -0000 On Fri, Nov 16, 2012 at 7:15 AM, Warren Block wrote: > 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]: >> http://www.freebsd.org/doc/en_**US.ISO8859-1/books/handbook/** >> ports-using.html >> > > You mean this part? > > Check out a copy of the ports tree. Use a specific Subversion mirror > close to your geographic location instead of svn.FreeBSD.org 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://svn.FreeBSD.org/ports/**head/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 > 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? > The other mirrors may be listed as -------------------- or any of the following : # svn checkout svn://*svn.FreeBSD.org*/ports/head /usr/ports . . . # svn checkout svn://*svn.FreeBSD.org*/ports/head /usr/ports -------------------- by listing actual mirror names . The users may select the suitable one for their territory . Thank you very much . Mehmet Erol Sanliturk