[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Quick-Start Guide (suggestion for)

From: Mark Bohlman <mbohlman_at_tcicredit.com>
Date: 2004-08-17 15:43:34 CEST

Monks, Peter wrote:

> G'day Suresh,
> Great idea! Are you volunteering? I'd be happy to review your first
> draft once it's done.
> Cheers,
> Peter
> ----------------------------------------------------------------------
> Peter Monks http://www.sydneyclimbing.com/
> pmonks_at_sydneyclimbing.com http://www.geocities.com/yosemite/4455/
> ----------------------------------------------------------------------
>>-----Original Message-----
>>From: Suresh Govindachar [mailto:sgovindachar@yahoo.com]
>>Sent: Monday, 16 August 2004 2:51pm
>>To: users@subversion.tigris.org
>>Subject: Quick-Start Guide (suggestion for)
>>I spent time trying out svn-win32-1.0.6.zip on a Windows
>>machine. Addressing the following items could help other
>>new users:
>> A) Mention the need to configure.
>> - Mention the absence of a .rc file.
>> - Mention the hidden side-effects of commands.
>> For example, mention that things will be created
>> in places such as
>> c:/WINDOWS/Application\ Data/Subversion/
>> WITHOUT any prompt to see if the user desires a
>> DIFFERENT location. (I still have no idea when that
>> directory and the stuff in it got created and do not
>> like this hidden, non-configurable side-effect.)
>> - Point out that things (section headers and values)
>> in .INI files need to start in the first column.
>> (This came as a total surprise to me.)
>> B) Mention the need to configure after the create command.
>> - Mention that one needs to modify the file
>> <repos>/conf/sunserve.conf This is so even though
>> the README.txt in <repos> says:
>> "... use the 'svnadmin' tool to examine it. Do not
>> add, delete, or modify files here unless you know
>> how to avoid corrupting the repository."
>> Now, I could be wrong about having to hand-modify the
>> file <repos>/conf/sunserve.conf; if so, mention the
>> correct way to do it.
>> - The file <repos>/conf/sunserve.conf has the lines:
>> ### This option controls the location of the password
>>database. This
>> ### path may be relative to the conf directory. There
>>is no default.
>> - What is the relationship between what is being
>> discussed here and what goes in
>> c:/WINDOWS/Application\ Data/Subversion/auth?
>> - Are there options in regard to the format in which
>> the path can be specified? If so, what are they?
>> C) In regard to the "user" commands such as import.
>> - Mention that the import command will prompt for the
>> user name (and depending on the configuration, the
>> password too).
>> - How come there is no way to specify the username
>> and password as command line arguments to the
>> command (like, -u <user> -p <password>)?
>> D) Mention the system requirement -- especially the
>> following from the FAQ:
>> "To reiterate, a Subversion server can be run on all
>> platforms except Win95/Win98/WinMe. The Subversion
>> client can be used on any platform where APR runs."
>> http://subversion.tigris.org/project_faq.html#portability
>> in a PROMINANT place.
>>It took me several hours to figure out the preceding.
>>To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
>>For additional commands, e-mail: users-help@subversion.tigris.org


Not to diminish perhaps valid points, but was there a reason you did not
use the setup executable to install?

 From your points above I've never encountered A), never had to
configure B) (for testing only), with C) svn help shows the --username
arg and --password arg options, and finally on D) I don't think anyone,
given an alternative (I realize cost comes into play on this, so...),
would attempt to use 95, 98 or ME as a source code server.

So having said that, and please don't take this as inflammatory, that is
not my point, I think that if you are serious about using and
administering Subversion, that a thorough reading of the book is a
requirement. Buy a copy - the authors deserve the $$ [unsolicited plug
for the folks who've helped me along the way ;-)].

And as Peter suggests, write up your notes, with detailed reproduction
recipes and submit them for review.

-- Mark

To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Tue Aug 17 15:44:09 2004

This is an archived mail posted to the Subversion Users mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.