Incorporate information about multiple accounts in the 'normal' docs

docs/bitbucket.rst

@@ -46,10 +46,17 @@ Add SSH public keys (default: :file:`~/.ssh/*.pub`) to your account.
 Display all public keys of a user, in a format that can be added to
 :file:`~/.authorized_keys`.
 
-.. describe:: git bb add-account [--host=<host>] <alias>
+Using multiple accounts
+-----------------------
+:command:`git bb` supports using more than one account. To use a non-default,
+you have to tell :command:`git bb` which account to use using
+:option:`--account`::
 
-:command:`git bb` supports multiple accounts. To add a new account, use the
-:command:`add-account` command.
+    $ git bb --account test-account clone seveas/whelk
+
+.. describe:: git bb add-account <alias>
+
+To add a new account, use the :command:`add-account` command.
 
 .. describe:: git bb config [--unset] <key> [<value>]
 

docs/github.rst

@@ -85,20 +85,6 @@ e.g. :option:`--type=push`. You can also get more (or less) than the default 30
 items in the log by specifying a count. Finally, :option:`--verbose` will give
 slightly more verbose output for some log items.
 
-.. describe:: git hub add-account [--host=<host>] <alias>
-
-:command:`git hub` supports multiple accounts. To add a new account, use the
-:command:`add-account` command. If the account lives on a GitHub Enterprise
-instance, you can specify its hostname. To change the hostname of any account,
-including the default one, you can use the :command:`config` command as
-follows: :command:`git hub config host https://github.example.com`.
-
-.. describe:: git hub config [--unset] <key> [<value>]
-
-Set, get or unset a configuration variable in :file:`~/.gitspindle`. Similar to
-:command:`git config`, but only single-level keys are allowed, and the section
-is hardcoded to be the current account.
-
 .. describe:: git hub create-token [--store]
 
 Create a personal access token that can be used for git operations (clone,
@@ -112,6 +98,37 @@ helpers.
 
 .. _`profile page`: https://github.com/settings/applications
 
+Using multiple accounts
+-----------------------
+:command:`git hub` supports using more than one account, and using local
+installs of GitHub enterprise. To use a non-default account outside a
+repository, for example when cloning, you have to tell :command:`git hub` which
+account to use using :option:`--account`::
+
+    $ git hub --account test-account clone seveas/whelk
+
+If the account is on a GitHub enterprise installation, you don't need to use
+--account all the time. git-spindle will recognize the account from the url in
+your repository configuration::
+
+    $ git hub --account work clone dev/website
+    $ cd website
+    $ git hub issues
+
+.. describe:: git hub add-account [--host=<host>] <alias>
+
+To add a new account, use the :command:`add-account` command. If the account
+lives on a GitHub Enterprise instance, you can specify its hostname.
+
+.. describe:: git hub config [--unset] <key> [<value>]
+
+Set, get or unset a configuration variable in :file:`~/.gitspindle`. Similar to
+:command:`git config`, but only single-level keys are allowed, and the section
+is hardcoded to be the current account.
+
+To change the hostname of any account, including the default one, you can use
+the :command:`config` command as follows: :command:`git hub config host
+https://github.example.com`.
 
 Interacting with repositories
 -----------------------------

docs/gitlab.rst

@@ -59,20 +59,39 @@ other users.
 Displays a log of actions done to a repository, such as pushes and issue
 comments.
 
+Using multiple accounts
+-----------------------
+:command:`git lab` supports using more than one account, and using local
+installs of GitLab CE and EE. To use a non-default account outside a
+repository, for example when cloning, you have to tell :command:`git lab` which
+account to use using :option:`--account`::
+
+    $ git lab --account test-account clone seveas/whelk
+
+If the account is on a Gitlab enterprise installation, you don't need to use
+--account all the time. git-spindle will recognize the account from the url in
+your repository configuration::
+
+    $ git lab --account work clone dev/website
+    $ cd website
+    $ git lab issues
+
 .. describe:: git lab add-account [--host=<host>] <alias>
 
-:command:`git lab` supports multiple accounts. To add a new account, use the
-:command:`add-account` command. If the account lives on a Gitlab CE or EE
-instance, you can specify its hostname. To change the hostname of any account,
-including the default one, you can use the :command:`config` command as
-follows: :command:`git lab config host https://gitlab.example.com`.
+To add a new account, use the :command:`add-account` command. If the account
+lives on a GitLab EE or CE instance other than gitlab.com, you can specify its
+hostname.
 
 .. describe:: git lab config [--unset] <key> [<value>]
 
 Set, get or unset a configuration variable in :file:`~/.gitspindle`. Similar to
 :command:`git config`, but only single-level keys are allowed, and the section
 is hardcoded to be the current account.
 
+To change the hostname of any account, including the default one, you can use
+the :command:`config` command as follows: :command:`git lab config host
+https://gitlab.example.com`.
+
 Interacting with repositories
 -----------------------------
 

docs/index.rst

@@ -32,4 +32,3 @@ Contents
    github
    gitlab
    bitbucket
-   accounts