From cdcf77c06bb8eb6c90f2edadaf5708c5ee181e8e Mon Sep 17 00:00:00 2001
From: Kissaki <kissaki@gmx.de>
Date: Mon, 14 Jul 2014 18:09:31 +0200
Subject: [PATCH] Adjust method comment to match usage

* The ice authenticator API was changed to allow returning -3 on auths,
the method comment of Server::authenticate now reflects this change as well.
** See 88d41e10, 6e8c8939
* The surrounding code already checks for the return value -3
(caller of method Server::msgAuthenticate)
---
 src/murmur/ServerDB.cpp | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/murmur/ServerDB.cpp b/src/murmur/ServerDB.cpp
index a0db88d18..819dc459d 100644
--- a/src/murmur/ServerDB.cpp
+++ b/src/murmur/ServerDB.cpp
@@ -840,9 +840,8 @@ QMap<int, QString> Server::getRegistration(int id) {
 	return info;
 }
 
-// -1 Wrong PW
-// -2 Anonymous
-
+/// @return UserID of authenticated user, -1 for authentication failures, -2 for unknown user (fallthrough),
+///         -3 for authentication failures where the data could (temporarily) not be verified.
 int Server::authenticate(QString &name, const QString &pw, int sessionId, const QStringList &emails, const QString &certhash, bool bStrongCert, const QList<QSslCertificate> &certs) {
 	int res = -2;