diff --git a/src/cyrsasl.erl b/src/cyrsasl.erl
index f0737d352..5eea407e9 100644
--- a/src/cyrsasl.erl
+++ b/src/cyrsasl.erl
@@ -151,7 +151,7 @@ listmech(Host) ->
 			 ['$1']}]),
     filter_anonymous(Host, Mechs).
 
-%% @spec (Service, ServerFQDN, UserRealm, SecFlags, GetPassword, CheckPassword, CheckPasswordDigest) -> saslstate()
+%% @spec (Service, ServerFQDN, UserRealm, SecFlags, GetPassword, CheckPassword, CheckPasswordDigest, Socket) -> saslstate()
 %%     Service = string()
 %%     ServerFQDN = string()
 %%     UserRealm = string()
diff --git a/src/ejabberd_auth_storage.erl b/src/ejabberd_auth_storage.erl
index a7514f8d2..8ef8d577d 100644
--- a/src/ejabberd_auth_storage.erl
+++ b/src/ejabberd_auth_storage.erl
@@ -457,8 +457,6 @@ remove_user(User, Server, Password) ->
 	    bad_request
     end.
 
-%% @spec () -> term()
-
 update_table(Host, mnesia) ->
     gen_storage_migration:migrate_mnesia(
       Host, passwd,
diff --git a/src/gen_storage.erl b/src/gen_storage.erl
index 414d40c58..b315a0dcd 100644
--- a/src/gen_storage.erl
+++ b/src/gen_storage.erl
@@ -93,7 +93,6 @@ table_info(Host, Tab, InfoKey) ->
 	    end
     end.
 
-
 %% @spec create_table(backend(), Host::binary(), Name::atom(), options()) -> {atomic, ok} | {aborted, Reason}
 %% @type options() = [option()]
 %% @type option() = {odbc_host, string()}
@@ -104,7 +103,9 @@ table_info(Host, Tab, InfoKey) ->
 %% @type attributedef() = [{Column::atom(), columndef()}]
 %% @type columndef() = text
 %%                   | int
-%%                   | tuple() with an arbitrary number of columndef()
+%%                   | tuple()
+
+%% With an arbitrary number of columndef()
 %% option() is any mnesia option
 %% columndef() defaults to text for all unspecified attributes
 
diff --git a/src/gen_storage_migration.erl b/src/gen_storage_migration.erl
index 7d40658b3..4531e3e40 100644
--- a/src/gen_storage_migration.erl
+++ b/src/gen_storage_migration.erl
@@ -4,7 +4,8 @@
 
 -include("ejabberd.hrl").
 
-%% @type Migrations = [{OldTable, OldAttributes, MigrateFun}]
+%% @spec (Host, Table, Migrations) -> any()
+%% Migrations = [{OldTable, OldAttributes, MigrateFun}]
 migrate_mnesia(Host, Table, Migrations) ->
     SameTableName = [Migration
 		     || {OldTable, _, _} = Migration <- Migrations,