[PATCH 03 of 14] docs/usage: rework section 'Mailing'

[Thomas De Schampheleire]

# HG changeset patch
# User Thomas De Schampheleire <thomas.de.schampheleire at gmail.com>
# Date 1427918461 -7200
#      Wed Apr 01 22:01:01 2015 +0200
# Node ID 20588378897c574fcd4dc2fe051542d339cda325
# Parent  af0b55a8fc5c4872b4edfde1a16b58c83b95d21e
docs/usage: rework section 'Mailing'

diff --git a/docs/usage/general.rst b/docs/usage/general.rst
--- a/docs/usage/general.rst
+++ b/docs/usage/general.rst
@@ -76,16 +76,17 @@
 with the ``_<ID>`` syntax.
 
 
-Mailing
--------
+E-mail notifications
+--------------------
 
-When the administrator configures the mailing settings in .ini files
-Kallithea will send mails on user registration, or when Kallithea
+When the administrator correctly specified the e-mail settings in the Kallithea
+configuration file, Kallithea will send e-mails on user registration and when
 errors occur.
 
-Mails are also sent for code comments. If someone comments on a changeset
-mail is sent to all participants, the person who commited the changeset
-(if present in Kallithea), and to all people mentioned with the @mention system.
+Mails are also sent for comments on changesets. In this case, an e-mail is sent
+to the committer of the changeset (if known to Kallithea), to all reviewers of
+the pull request (if applicable) and to all people mentioned in the comment
+using @mention notation.
 
 
 Trending source files