Changes between Version 158 and Version 159 of TracIni

Timestamp:

Nov 21, 2009, 6:48:30 PM (14 years ago)

Author:

Christian Boos

Comment:

improve the #svn:externals-section, as suggested

TracIni

@@ -104 +104 @@
 
 The TracBrowser for Subversion can interpret the `svn:externals` property of folders out of the box.
-However, if those externals are ''not'' using the `http:` protocol, or if a link to a different repository browser (such another Trac or [http://www.viewvc.org/ ViewVC]) is desired, then Trac needs to be able to map an external prefix to this other URL.
+However, if those externals are ''not'' using the `http:` or `https:` protocol, or if a link to a different repository browser such as another Trac or [http://www.viewvc.org/ ViewVC] is desired, then Trac needs to be able to map an external prefix to this other URL.
 
 This mapping is done in the `[svn:externals]` section of the TracIni
@@ -114 +114 @@
 2 = svn://server/repos2 http://trac/proj2/browser/$path?rev=$rev
 3 = http://theirserver.org/svn/eng-soft       http://ourserver/viewvc/svn/$path/?pathrev=25914
-4 = svn://anotherserver.com/tools_repository  http://ourserver/trac/support/browser/$path?rev=$rev
+4 = svn://anotherserver.com/tools_repository  http://ourserver/tracs/tools/browser/$path?rev=$rev
 }}}
-With the above, the `svn://anotherserver.com/tools_repository/tags/1.1/tools` external will be mapped to `http://ourserver/trac/support/browser/tags/1.1/tools?rev=` (and `rev` will be set to the appropriate revision number if the external additionally specifies a revision, see the [http://svnbook.red-bean.com/en/1.4/svn.advanced.externals.html SVN Book on externals] for more details).
+With the above, the `svn://anotherserver.com/tools_repository/tags/1.1/tools` external will be mapped to `http://ourserver/tracs/tools/browser/tags/1.1/tools?rev=` (and `rev` will be set to the appropriate revision number if the external additionally specifies a revision, see the [http://svnbook.red-bean.com/en/1.4/svn.advanced.externals.html SVN Book on externals] for more details).
 
 Note that the number used as a key in the above section is purely used as a place holder, as the URLs themselves can't be used as a key due to various limitations in the configuration file parser.
+
+Finally, the relative URLs introduced in [http://subversion.tigris.org/svn_1.5_releasenotes.html#externals Subversion 1.5] are not yet supported.
 
 == Discussion ==
@@ -124 +126 @@
  ''Please discuss documentation changes here. Even better, send us documentation patches against the code, either on Trac-dev or on new tickets.''
 
- * More detail on getting [svn:externals] to work would be appreciated. A link to a working example would probably help a lot too.
-  * In reference to ''However, if those externals are not using the http: protocol ...''.  Does `http:` imply `https:` as well?
-  * What about relative URLs introduced in [http://subversion.tigris.org/svn_1.5_releasenotes.html#externals Subversion 1.5]? trac 0.11.5 does not seem to understand `^/tags/1.0`, for example, and the documentation doesn't say anything about this.
-  * The URLs in the example (4) are confusing to me.  Shouldn't `browser` reside immediately below `trac` in a typical installation?  I think the example would be clearer (more familiar to most people) if you changed the first URL to `svn://anotherserver.com/projecta` and the second URL to `http://ourserver.com/trac/browser/external/$path?rev=$rev`.  Unless there is something about the seemingly overly specific URLs in the current example that I'm not getting?
  * There is, apparently, an [svn] `repository_url` option that is not documented here.
  * Some more info on how to customize ticket_subject_template would be helpful.  Perhaps show what the setting would be for the default subject.