# HG changeset patch # User Jared Bunting # Date 1309560361 18000 # Node ID 93cffcb6fd543334e1779b3834ed24d63bf52c75 # Parent 2744f5b01d00e009b2909cea86f93031525a29e9 Adding documentation for indexer's self-resolving repos location. diff -r 2744f5b01d00 -r 93cffcb6fd54 docs/setup.rst --- a/docs/setup.rst Fri Jul 01 17:38:37 2011 -0500 +++ b/docs/setup.rst Fri Jul 01 17:46:01 2011 -0500 @@ -103,34 +103,35 @@ Starting from version 1.1 the whoosh index can be build by using the paster command ``make-index``. To use ``make-index`` you must specify the configuration -file that stores the location of the index, and the location of the repositories -(`--repo-location`).Starting from version 1.2 it is -also possible to specify a comma separated list of repositories (`--index-only`) -to build index only on chooses repositories skipping any other found in repos -location +file that stores the location of the index. You may specify the location of the +repositories (`--repo-location`). If not specified, this value is retrieved +from the RhodeCode database. This was required prior to 1.2. Starting from +version 1.2 it is also possible to specify a comma separated list of +repositories (`--index-only`) to build index only on chooses repositories +skipping any other found in repos location You may optionally pass the option `-f` to enable a full index rebuild. Without the `-f` option, indexing will run always in "incremental" mode. For an incremental index build use:: - paster make-index production.ini --repo-location= + paster make-index production.ini For a full index rebuild use:: - paster make-index production.ini -f --repo-location= + paster make-index production.ini -f building index just for chosen repositories is possible with such command:: - paster make-index production.ini --repo-location= --index-only=vcs,rhodecode + paster make-index production.ini --index-only=vcs,rhodecode In order to do periodical index builds and keep your index always up to date. It's recommended to do a crontab entry for incremental indexing. An example entry might look like this:: - /path/to/python/bin/paster /path/to/rhodecode/production.ini --repo-location= + /path/to/python/bin/paster make-index /path/to/rhodecode/production.ini When using incremental mode (the default) whoosh will check the last modification date of each file and add it to be reindexed if a newer file is @@ -556,4 +557,4 @@ .. _mercurial-server: http://www.lshift.net/mercurial-server.html .. _PublishingRepositories: http://mercurial.selenic.com/wiki/PublishingRepositories .. _Issues tracker: https://bitbucket.org/marcinkuzminski/rhodecode/issues -.. _google group rhodecode: http://groups.google.com/group/rhodecode \ No newline at end of file +.. _google group rhodecode: http://groups.google.com/group/rhodecode diff -r 2744f5b01d00 -r 93cffcb6fd54 rhodecode/lib/indexers/__init__.py --- a/rhodecode/lib/indexers/__init__.py Fri Jul 01 17:38:37 2011 -0500 +++ b/rhodecode/lib/indexers/__init__.py Fri Jul 01 17:46:01 2011 -0500 @@ -113,7 +113,7 @@ self.parser.add_option('--repo-location', action='store', dest='repo_location', - help="Specifies repositories location to index REQUIRED", + help="Specifies repositories location to index OPTIONAL", ) self.parser.add_option('--index-only', action='store',