TrivialRebase: tidy up docstrings to follow PEP-0257

Tidy up the docstrings to follow PEP-0257 [1], the Python
Docstring Convention.

The following warnings, reported by the pep257 checker [2], are
removed.

- All modules should have docstrings.
- Multiline docstring should end with 1 blank line.
- First line should be in imperative mood ('Do', not 'Does').
- First line should end with a period.

[1] http://www.python.org/dev/peps/pep-0257/
[2] https://github.com/GreenSteam/pep257

Change-Id: Icdda650d77c3b52c6b4dba62467b45ade8229b48
Fix setting account's full name via ssh

While the fetched Account object had its full name updated, the
object was not flagged as updated, so the change was not pushed back
to the database. We now flag the account as updated and hence the new
full name gets written to the database.

Change-Id: I79ca6df458170af97ab7afde3125a8d7cec5ca17
Merge "Fix setting account's full name via ssh" into stable-2.6
Mark project and user options as required for LsUserRefs

The documentation of, and the 'ssh ... --help' page for LsUserRefs
showed the project and user options as optional although they were
required. We now mark them as required in their annotations. Thereby,
the 'ssh ... --help' page lists them as required, and it is
automatically assured that they are not null. We also marked them as
required in the documentation.

Change-Id: I73aace6eeebb897174628c444350a275b323b673
Fix ls-user-refs command name in documentation

Change-Id: Ib54419d10b654e0e766072a810a72b81deedec28
Merge "Mark project and user options as required for LsUserRefs" into stable-2.6
Merge "Fix ls-user-refs command name in documentation" into stable-2.6
Merge branch 'stable-2.6'

* stable-2.6:
  Fix ls-user-refs command name in documentation
  Mark project and user options as required for LsUserRefs
  Fix setting account's full name via ssh
  TrivialRebase: tidy up docstrings to follow PEP-0257

Change-Id: Ibd4563a8418e823d700082bc4fbcf465085d4719
Clarify setup of change cache in documentation

https://groups.google.com/d/topic/repo-discuss/BTImKTcbXKw/discussion

Change-Id: Ifae451b75b3bc655cfd59e6e0e2d16a702bf659e
Merge "Clarify setup of change cache in documentation"
Clarify setup of change cache in documentation

https://groups.google.com/d/topic/repo-discuss/BTImKTcbXKw/discussion

Change-Id: Ifae451b75b3bc655cfd59e6e0e2d16a702bf659e
Fix RebaseIfNecessary submit strategy

If a change on submit needs to be rebased a current user is not
available since the merge is executed in the background.

At the moment ChangeControl.Factory is used to get the label types
when rebasing a change, which fails if called from the merge thread
because it requires the current user to be injected. As result the
submit fails and the user gets the error message 'change is new'.

Fix the problem by retrieving the label types from the project and
avoid the usage of ChangeControl.

Change-Id: I2e55caf73904ad078ee9be8fb3ba8d6b02c532b3
Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
Remove CollectionsUtil.java

Since 05f2bc1, CollectionsUtil.java is not used anymore
by Gerrit.

Change-Id: I5e250bd9e1a3157c4d3f7eda8711517a3e0a59fa
Remove SingleListChangeInfo.java

Since 1283dd7d, SingleListChangeInfo.java is not used
by Gerrit.

Change-Id: I5e3b158a08df5265cd9da87ac642c94a4f8ac0fc
Merge "Remove CollectionsUtil.java"
Add clarifications in the documentation of the `query` command

- Add a statement that the result is always for the latest patch set,
  even if the query matched on an earlier patch set

- Add a link to the change attribute documentation from the JSON
  format option description.

- Add clarification in the change attribute documentation that the
  commit message is of the latest patch set.

- Correct a minor typo

Change-Id: Ie6a825d1d183994926662c0ad8c42ec15f687e51
Remove SingleListChangeInfo.java

Since 1283dd7d, SingleListChangeInfo.java is not used
by Gerrit.

Change-Id: I5e3b158a08df5265cd9da87ac642c94a4f8ac0fc
Merge "Add clarifications in the documentation of the `query` command" into stable-2.6
Merge "Fix RebaseIfNecessary submit strategy" into stable-2.6
Merge "Merge branch 'stable-2.6'"