{"thread":{"id":"3845","subject":"SVN_URL undocumented","startedAt":"2006-04-10T21:22:42Z","lastAt":"2006-04-10T21:22:42Z","messageCount":1,"participants":["Pavel Roskin"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"18544","messageId":"1144704162.18727.30.camel@dv","threadId":"3845","inReplyTo":null,"subject":"SVN_URL undocumented","fromName":"Pavel Roskin","fromEmail":"proski@gnu.org","sentAt":"2006-04-10T21:22:42Z","receivedAt":"2006-04-10T21:22:42Z","isPatch":false,"sender":{"key":"proski@gnu.org","avatar":null},"body":"Hello, Eric!\n\nI'm trying to use git-svn, but the documentation seems to be quite\nunclear.  I'm using current git-svn from the git repository.\n\nI'm running \"git-svn init\" in a Subversion working directory:\n\n$ git-svn init\nSVN repository location required\n at /home/proski/bin/git-svn line 223\n        main::init() called at /home/proski/bin/git-svn line 104\n\nThe help shown by git-svn without arguments doesn't say anything about\narguments for \"init\", unlike other subcommands.  I'm assuming that\n\"git-svn init\" is not taking any arguments.\n\nThe manual page doesn't say anything about arguments, but it mentions\nthat \"the SVN_URL must be specified at this point\".  This statement is\nunclear to me.\n\nThere are several references to SVN_URL in the manual, but there is no\ndescription what it is.  Is it supposed to be an environment variable,\nor an undocumented argument, or is it taken from \"svn info\" output?\n\nThe environment variable has no effect:\n\n$ SVN_URL=http://svn.madwifi.org/trunk git-svn init\nSVN repository location required\n at /home/proski/bin/git-svn line 223\n        main::init() called at /home/proski/bin/git-svn line 104\n\nLooking at the sources, it looks like that SVN_URL is an undocumented\nargument for \"git-cvs init\".  \"git-svn fetch\" appears to be taking that\nvalue from the git repository, but it also takes care to protect the\noriginal value (I have no idea where it can come from).\n\nOne of the \"basic examples\" further in the manual confirms that SVN_URL\nis set on the command line:\n\ngit-svn init http://svn.foo.org/project/trunk\n\nI believe that the documentation should be updated to describe where\nSVN_URL comes from, and what arguments are accepted by \"git-svn init\".\nBasic examples shouldn't recommend using undocumented arguments.\n\nIt seems to me that the current documentation describes the internals of\ngit-svn instead of its user interface.  Rather than tell the user that\n\"FOO must be specified at that point\", the documentation should say what\n(an how) should (or can) be specified when the command is invoked on the\ncommand line.\n\nAlso, it would be great to refer to the \"additional fetch arguments\" in\nthe \"fetch\" description.  That section is easy to miss by somebody who\nis specifically looking for \"fetch arguments\".\n\n-- \nRegards,\nPavel Roskin\n"}]}