Changes between Version 3 and Version 4 of TracLinks

Timestamp:

Apr 28, 2017, 12:06:12 AM (5 years ago)

Author:

trac

Comment:

--

TracLinks

@@ -26 +26 @@
  Ticket comments :: `comment:1:ticket:2`
  Reports :: `{1}` or `report:1`
+ Milestones :: `milestone:1.0`
+ Attachment :: `attachment:example.tgz` (for current page attachment), `attachment:attachment.1073.diff:ticket:944` (absolute path)
  Changesets :: `r1`, `[1]`, `changeset:1` or (restricted) `[1/trunk]`, `changeset:1/trunk`
  Revision log :: `r1:3`, `[1:3]` or `log:@1:3`, `log:trunk@1:3`, `[2:5/trunk]`
- Diffs :: `diff:@1:3`, `diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default` 
+ Diffs :: `diff:@1:3`, `diff:plugins/0.12/mercurial-plugin@9128:9953`,
+          `diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default` 
           or `diff:trunk/trac@3538//sandbox/vc-refactoring@3539`
- Milestones :: `milestone:1.0`
- Attachment :: `attachment:example.tgz` (for current page attachment), `attachment:attachment.1073.diff:ticket:944` (absolute path)
- Files :: `source:trunk/COPYING`
- A specific file revision :: `source:/trunk/COPYING@200`
- A particular line of a specific file revision :: `source:/trunk/COPYING@200#L25`
+ Files :: `source:trunk/COPYING`, `source:/trunk/COPYING@200` (at version 200), `source:/trunk/COPYING@200#L25` (at version 200, line 25)
 }}}
 {{{#!td
@@ -42 +41 @@
  Ticket comments :: comment:1:ticket:2 
  Reports :: {1} or report:1
+ Milestones :: milestone:1.0
+ Attachment :: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 (absolute path)
  Changesets :: r1, [1], changeset:1 or (restricted) [1/trunk], changeset:1/trunk
  Revision log :: r1:3, [1:3] or log:@1:3, log:trunk@1:3, [2:5/trunk]
- Diffs :: diff:@1:3, diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default 
+ Diffs :: diff:@1:3, diff:plugins/0.12/mercurial-plugin@9128:9953,
+          diff:tags/trac-0.9.2/wiki-default//tags/trac-0.9.3/wiki-default 
           or diff:trunk/trac@3538//sandbox/vc-refactoring@3539
- Milestones :: milestone:1.0
- Attachment :: attachment:example.tgz (for current page attachment), attachment:attachment.1073.diff:ticket:944 (absolute path)
- Files :: source:trunk/COPYING
- A specific file revision :: source:/trunk/COPYING@200
- A particular line of a specific file revision :: source:/trunk/COPYING@200#L25
+ Files :: source:trunk/COPYING, source:/trunk/COPYING@200 (at version 200), source:/trunk/COPYING@200#L25 (at version 200, line 25)
 }}}
 
@@ -258 +256 @@
  - `ticket:123#comment:description`
 
+=== htdocs: links ===
+
+Use `htdocs:path/to/file` to reference files in the `htdocs` directory of the Trac environment, the [TracEnvironment#DirectoryStructure web resource directory].
+
 === query: links ===
 
@@ -291 +293 @@
 === wiki: links ===
 
-See WikiPageNames and [#QuotingspaceinTracLinks quoting space in TracLinks] above.
+See WikiPageNames and [#QuotingspaceinTracLinks quoting space in TracLinks] above. It is possible to create a link to a specific page revision using the syntax WikiStart@1.
 
 === Version Control related links ===
+
+It should be noted that multiple repository support works by creating a kind of virtual namespace for versioned files in which the toplevel folders correspond to the repository names. Therefore, in presence of multiple repositories, a ''/path'' specification in the syntax of links detailed below should start with the name of the repository. If omitted, the default repository is used. In case a toplevel folder of the default repository has the same name as a repository, the latter "wins". One can always access such folder by fully qualifying it (the default repository can be an alias of a named repository, or conversely, it is always possible to create an alias for the default repository, ask your Trac administrator).
+
+For example, `source:/trunk/COPYING` targets the path `/trunk/COPYING` in the default repository, whereas `source:/projectA/trunk/COPYING` targets the path `/trunk/COPYING` in the repository named `projectA`. This can be the same file if `'projectA'` is an alias to the default repository or if `''` (the default repository) is an alias to `'projectA'`.
+
 ==== source: links ====
  ''aliases:'' `browser:`, `repos:`