readme: write intro and start writing examples

improve README skeleton

readme: skeleton for the new README

split READMEs

grsummary: test comments now mention expectation

grsummary: augment the test with a guest 'gr-hggit'

The grsummary command's code path is slightly different for hggit
guests, so it needs to be tested on an hggit guest as well as on a
plain hg guest.

grsummary: rename the test guestrepo to 'gr-plain'

This make the next commit, which adds an hggit guest repo called
'gr-hggit', easier to read.

grsummary: handle hggit guest repos

grsummary looked for draft commits to see if a repo had outgoing
changes, but hggit guests [1] consist entirely of drafts, and so always
looked unpushed. Now grsummary checks if the guest is an hggit repo; if
it is, unpushed commits are found with the revset `not(fromgit())`,
instead.

Fix tests for hg 3.3.2 and Py 3.4.3

~/source/python/guestrepo/tests: ( 2582f46a05a6 default @ ! ):
 $ hg --version
Mercurial Distributed SCM (version 3.3.2)
(see http://mercurial.selenic.com for more information)

Copyright (C) 2005-2014 Matt Mackall and others
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
~/source/python/guestrepo/tests: ( 2582f46a05a6 default @ ! ):
 $ python --version
Python 3.4.3

Merged in sietsebb/guestrepo-pnathan/bug-module-import-fails (pull request #2)

Fix test error 'abort: No module named pathutil!'

Fix test error 'abort: No module named pathutil!'

Given Mercurial 2.8.2 on Linux Mint 16,
When I run the tests in the test directory with ./run.sh,
Then all tests fail with the following error:

    +  abort: No module named pathutil!
    +  [255]

This commit fxes that error.

Adding TODO note

Fix spelling

Habitability tweaks.

Merge in David's work for updating non-guest subareas.

grupdate: add a '--clean' option

This option set every subrepo that is not a guest repo to revision null. If
the 'purge' extension is available, also purge the guest repositories.

Convert scmutil to pathutil, fixes issue #47

It appears that mercurial performed a rename from scmutil to pathutil in the
2.8.x line. This broke guestrepo.

This patch patches guestrepo to work again. Hurray.

Logical merge (with some minor changes) between default and aleufroy/configfile branch

new config/mapping: update documentation

new config/mapping: add usefull comment

ref: https://bitbucket.org/selinc/guestrepo/pull-request/11/new-config-snapshot-files-format/diff#comment-763693

ref: https://bitbucket.org/selinc/guestrepo/pull-request/11/new-config-snapshot-files-format/diff#comment-763680