Edgewall Software

Changes between Version 16 and Version 17 of TracGit


Ignore:
Timestamp:
Mar 9, 2015, 8:57:02 PM (9 years ago)
Author:
Ryan J Ollos
Comment:

Grammar fixes and make some sentences more concise.

Legend:

Unmodified
Added
Removed
Modified
  • TracGit

    v16 v17  
    22= Git support in Trac
    33
    4 Starting with version [milestone:1.0], Trac features built-in support
    5 for [http://git-scm.com/ Git] so that it can be used as one of the
    6 VersionControlSystem for Trac.
     4Since version [milestone:1.0], Trac features built-in support
     5for [http://git-scm.com/ Git] as a VersionControlSystem for Trac.
    76
    87Please note that we're still considering the level of performance to
     
    1211== Features
    1312
    14 * Browsing source code in a Git repository via the TracBrowser
     13* Browsing source code via the TracBrowser
    1514* Viewing the change history of a file or directory using TracRevisionLog
    16 * Performing diffs between any two files or two directories
    17 * Displaying submitted changes in the TracTimeline
     15* Performing diffs between any two files or directories
     16* Displaying changes in the TracTimeline
    1817* (Optionally) caching TracChangeset information in Trac's database
    1918* Caching Git commit relation graph in memory
    20 * Using the TracSearch page to search change descriptions
     19* Search change descriptions via TracSearch
    2120* Annotation support, also known as "blame" operation
    2221* Interpretation of 40-character wide hex-strings as sha1 commit checksums
     
    2827[http://git-scm.com/download Git:Download].
    2928
    30 We try to maintain backward compatibility with versions of Git as old as 1.5.6,
    31 up to the latest. Better use a recent version however.
     29We try to maintain backward compatibility with versions of Git from 1.5.6 to the latest.
     30It's better use a recent version, however.
    3231
    3332=== Configuration
     
    3938
    4039Note that the repository should be made accessible as a local repository.
    41 Thanks to the distributed nature of Git, that's always possible (if the
    42 repository is not already local, simply `git clone` it).
     40Thanks to the distributed nature of Git, that's always possible. If the
     41repository is not already local, simply `git clone` it.
    4342
    4443== Trac
     
    6665 - for the ''repository type'', specify `git` instead of the default `svn`.
    6766 - for the ''repository directory'', specify the location of the Git repository
    68    (including the ending `.git` directory).
     67   (for Trac < 1.0.2 the path of a non-bare repository will end in a `.git` directory).
    6968
    7069Your [wiki:TracIni <trac_environment>/conf/trac.ini] configuration file
     
    8584
    8685
    87 Also in there, make sure you specify the location of the `git` executable, in case it's not the default `/usr/bin/git`. As an example, for Windows:
     86Specify the location of the `git` executable, in case it's not the default `/usr/bin/git`. As an example, for Windows:
    8887{{{#!ini
    8988[git]
     
    9594
    9695If all you need is to work with a single git environment, it is enough
    97 to modify the `[trac]` section in your [TracIni trac.ini] so that it
    98 contains the appropriate values for the `repository_type` and
    99 `repository_dir` options, like in the above example.
     96to modify the `[repositories]` section in your [TracIni trac.ini] so that it
     97contains the appropriate values for the `.type` and
     98`.dir` options, like in the above example.
    10099
    101100However, if you need more than one git repository, or if you want to
     
    104103contained in that repository, you can add non-default repositories.
    105104
    106 There is basically two ways to do it, either via the
     105There are basically two ways to do that, either via the
    107106[TracIni#repositories-section "[repositories]"] section of the TracIni
    108107file, or via the web administration interface using the