Changes between Version 17 and Version 18 of 1.3/TracRepositoryAdmin

Timestamp:

Jul 16, 2019, 10:26:12 PM (5 years ago)

Author:

Ryan J Ollos

Comment:

Format and add section for Default Repository.

1.3/TracRepositoryAdmin

@@ -25 +25 @@
 == Specifying repositories #Repositories
 
-Trac supports multiple repositories per environment, and the repositories may be for different version control systems. Each repository must be defined in a repository configuration provider, the three supported by default are the [#ReposDatabase database store], the [#ReposTracIni trac.ini configuration file] and the [#ReposGitWeb GitWeb configuration file]. You can define your repositories through a mix of providers, but typically each repository should only be defined in a single provider. At the very least, the names used for each repository must be unique across all providers, otherwise duplicates will be discarded.
+Trac supports multiple repositories per environment, and the repositories may be for different version control systems. Each repository must be defined in a repository configuration provider. Repository providers included with Trac are the [#ReposDatabase database store], the [#ReposTracIni trac.ini configuration file] and the [#ReposGitWeb GitWeb configuration file]. Additional providers are available as plugins.
+
+You can define your repositories through a mix of providers, but each repository should only be defined in a single provider. The repository names must be unique across all providers and duplicate names are discarded.
 
 It is possible to define aliases of repositories that act as "pointers" to real repositories. This can be useful when renaming a repository, to avoid breaking links to the old name.
+
+=== Default Repository
+
+Trac's repositories are listed in the Repository Index when navigating to //Browse Source//. The default repository is displayed first, followed by the Repository Index. TracLinks without a repository name in the path specification (e.g. `[1]` rather than `[1/repos1]`) refer to the default repository. !TracLinks for repositories other than the default must include the repository name in the path specification.
+
+From the Repository Admin page, the default repository is specified by leaving the //Name// attribute empty. From the command line, the default repository is specified using the string `(default)` or `""`. In TracIni, the default repository is specified by leaving the `{name}` empty for each `{name}.{attribute}` option (e.g. `.dir = /path/to/dir`).
+
+=== Repository Attributes
 
 There are a number of attributes that can be specified for each repository, and additional attributes may be available through plugins. A repository `name` and one of the `alias` or `dir` attributes are mandatory. All others are optional.
@@ -117 +127 @@
 Repositories that support caching are cached by default. The Subversion and Git backends support caching. The [trac:TracMercurial Mercurial plugin] does not yet support caching ([trac:#8417]). To disable caching, set the `cached` attribute to `false`.
 
-After adding a repository, the cache for that repository must be re-synchronized once with the `trac-admin $ENV repository resync` command.
+After adding a cached repository, the cache must be populated with the `trac-admin $ENV repository resync` command.
 
  `repository resync <repos>`::