# HG changeset patch # User Thomas De Schampheleire # Date 1428260622 -7200 # Node ID 9cef5a168b8854a7762fef76be3ebee825cc6b20 # Parent 601282d36c06811382c6032b24a89f0018a051ff docs/usage: move Mercurial subrepository info to VCS support page This commit moves the information verbatim, text changes will be done in a subsequent commit. diff -r 601282d36c06 -r 9cef5a168b88 docs/index.rst --- a/docs/index.rst Sun Apr 05 20:46:21 2015 +0200 +++ b/docs/index.rst Sun Apr 05 21:03:42 2015 +0200 @@ -32,7 +32,6 @@ usage/locking usage/statistics usage/backup - usage/subrepos usage/debugging usage/troubleshooting diff -r 601282d36c06 -r 9cef5a168b88 docs/usage/subrepos.rst --- a/docs/usage/subrepos.rst Sun Apr 05 20:46:21 2015 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,36 +0,0 @@ -.. _subrepos: - -============================================= -Working with Kallithea and Mercurial subrepos -============================================= - -Example usage of Subrepos with Kallithea:: - - ## init a simple repo - hg init repo1 - cd repo1 - echo "file1" > file1 - hg add file1 - hg ci --message "initial file 1" - - #clone subrepo we want to add - hg clone http://kallithea.local/subrepo - - ## use path like url to existing repo in Kallithea - echo "subrepo = http://kallithea.local/subrepo" > .hgsub - - hg add .hgsub - hg ci --message "added remote subrepo" - - -In the file list of a clone of ``repo1`` you will see a connected -subrepo at the revision it was at during cloning. Clicking in -subrepos link should send you to the proper repository in Kallithea. - -Cloning ``repo1`` will also clone the attached subrepository. - -Next we can edit the subrepo data, and push back to Kallithea. This will update -both of the repositories. - -See http://mercurial.aragost.com/kick-start/en/subrepositories/ for more -information about subrepositories. diff -r 601282d36c06 -r 9cef5a168b88 docs/usage/vcs_support.rst --- a/docs/usage/vcs_support.rst Sun Apr 05 20:46:21 2015 +0200 +++ b/docs/usage/vcs_support.rst Sun Apr 05 21:03:42 2015 +0200 @@ -44,6 +44,41 @@ use_threadpool = +Mercurial support +----------------- + +Working with Mercurial subrepositories +`````````````````````````````````````` +Example usage of Subrepos with Kallithea:: + + ## init a simple repo + hg init repo1 + cd repo1 + echo "file1" > file1 + hg add file1 + hg ci --message "initial file 1" + + #clone subrepo we want to add + hg clone http://kallithea.local/subrepo + + ## use path like url to existing repo in Kallithea + echo "subrepo = http://kallithea.local/subrepo" > .hgsub + + hg add .hgsub + hg ci --message "added remote subrepo" + + +In the file list of a clone of ``repo1`` you will see a connected +subrepo at the revision it was at during cloning. Clicking in +subrepos link should send you to the proper repository in Kallithea. + +Cloning ``repo1`` will also clone the attached subrepository. + +Next we can edit the subrepo data, and push back to Kallithea. This will update +both of the repositories. + +See http://mercurial.aragost.com/kick-start/en/subrepositories/ for more +information about subrepositories. .. _waitress: http://pypi.python.org/pypi/waitress .. _gunicorn: http://pypi.python.org/pypi/gunicorn