Date: Fri, 16 Nov 2012 08:23:22 -0800 From: Mehmet Erol Sanliturk <m.e.sanliturk@gmail.com> To: Warren Block <wblock@wonkity.com> Cc: FreeBSD Ports <ports@freebsd.org>, Joseph a Nagy Jr <jnagyjr1978@gmail.com> Subject: Re: Users Handbook Message-ID: <CAOgwaMuEB1nMGc3VxB=3yAuK=wqiNQgjTOjwduegBXqb9Vw-=w@mail.gmail.com> In-Reply-To: <alpine.BSF.2.00.1211160807280.74281@wonkity.com> References: <50A64F69.30607@gmail.com> <alpine.BSF.2.00.1211160807280.74281@wonkity.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, Nov 16, 2012 at 7:15 AM, Warren Block <wblock@wonkity.com> 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<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<http://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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAOgwaMuEB1nMGc3VxB=3yAuK=wqiNQgjTOjwduegBXqb9Vw-=w>