Changeset 189 in tracdarcs for README.rst


Ignore:
Timestamp:
06/11/10 16:55:39 (3 years ago)
Author:
lele@…
Hash name:
20100611145539-97f81-3fbf064055a682248b642255691cdfca2fec1617
Message:

Cosmetic and little fixes to the documentation

File:
1 edited

Legend:

Unmodified
Added
Removed
  • README.rst

    r188 r189  
    99__ http://trac.edgewall.org/wiki/MultipleRepositorySupport 
    1010__ http://trac.edgewall.org/milestone/0.12 
    11 __ http://trac.edgewall.org/browser/sandbox/multirepos 
    1211 
    1312It used to work on 0.11, and even with 0.10, at least up to version 
     
    7170----------------------- 
    7271 
    73 The recommended way to trigger the sync between the repository and the 
    74 Trac instance is by using a darcs `post hook`__ on its ``apply``: in 
    75 this way the database will be updated as soon as darcs finish applying 
    76 any new changeset. 
     72The `recommended way`__ to trigger the sync between the repository and 
     73the Trac instance is by using a darcs `post hook`__ on its ``apply``: 
     74in this way the database will be updated as soon as darcs finish 
     75applying any new changeset. 
    7776 
    7877This can be accomplished by putting something like the following 
    7978setting into the repository ``_darcs/prefs/defaults`` file:: 
    8079 
    81   apply posthook trac-admin TRAC_ENV changeset add $(pwd) $(python -m tracdarcs.changesparser) 
     80  apply posthook trac-admin TRAC_ENV changeset added $(pwd) $(python -m tracdarcs.changesparser) 
    8281  apply run-posthook 
    8382 
     
    8584the related trac instance. 
    8685 
    87 Btw, ``python -m tracdarcs.changesparser`` is just a quick way of 
    88 extracting the list of changeset hashes from the the ``darcs changes 
    89 --xml`` format: it accepts the input either as the 
    90 ``$DARCS_PATCHES_XML`` or from standard input:: 
    91  
    92   $ darcs changes --xml | python -m tracdarcs.changesparser | head -3 
    93   20100611081300-97f81-bc5c1f7acf0c168bbfa9fb911e3cc2a4e71d5eef 
    94   20100610150339-97f81-cd1b73f2ba1b1d98c28542ecbd1d5e2bd9052056 
    95   20100512164420-97f81-de3fbc73d7c401fb92503ef1b25e19e0f48d2ad1 
    96  
    97  
     86.. note:: ``python -m tracdarcs.changesparser`` is just a quick way of 
     87   extracting the list of changeset hashes from the the ``darcs 
     88   changes --xml`` format: it accepts the input either as the 
     89   ``$DARCS_PATCHES_XML`` or from standard input:: 
     90 
     91    $ darcs changes --xml | python -m tracdarcs.changesparser | head -3 
     92    20100611081300-97f81-bc5c1f7acf0c168bbfa9fb911e3cc2a4e71d5eef 
     93    20100610150339-97f81-cd1b73f2ba1b1d98c28542ecbd1d5e2bd9052056 
     94    20100512164420-97f81-de3fbc73d7c401fb92503ef1b25e19e0f48d2ad1 
     95 
     96At that point, you could deactivate the per request sync that Trac 
     97still does by default, by setting ``repository_sync_per_request`` to 
     98an empty value in the ``[trac]`` section of the configuration. 
     99 
     100__ http://trac.edgewall.org/wiki/0.12/TracRepositoryAdmin#ExplicitSync 
    98101__ http://darcs.net/manual/node7.html#SECTION00712000000000000000 
    99102 
Note: See TracChangeset for help on using the changeset viewer.