diff --git a/src/core/hostinfo.h b/src/core/hostinfo.h
index 1ea52287..9b44683f 100644
--- a/src/core/hostinfo.h
+++ b/src/core/hostinfo.h
@@ -1,57 +1,58 @@
 /*
 Copyright 2008  Roland Harnau <tau@gmx.eu>
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
 License as published by the Free Software Foundation; either
 version 2.1 of the License, or (at your option) version 3, or any
 later version accepted by the membership of KDE e.V. (or its
 successor approved by the membership of KDE e.V.), which shall
 act as a proxy defined in Section 6 of version 3 of the license.
 
 This library is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 Lesser General Public License for more details.
 
 You should have received a copy of the GNU Lesser General Public
 License along with this library.  If not, see <http://www.gnu.org/licenses/>.
 */
 
 #ifndef HOSTINFO_H_
 #define HOSTINFO_H_
 
 #include <QtCore/QString>
 #include <QtCore/QObject>
 #include "kiocore_export.h"
 
 class QHostInfo;
 
 namespace KIO
 {
 /**
+ * @internal
  * WARNING: this could disappear at some point in time.
  * DO NOT USE outside KDE Frameworks
  */
 namespace HostInfo
 {
 /// @internal
 KIOCORE_EXPORT void lookupHost(const QString &hostName, QObject *receiver, const char *member);
 /// @internal
 KIOCORE_EXPORT QHostInfo lookupHost(const QString &hostName, unsigned long timeout);
 /// @internal
 KIOCORE_EXPORT QHostInfo lookupCachedHostInfoFor(const QString &hostName);
 /// @internal
 KIOCORE_EXPORT void cacheLookup(const QHostInfo &info);
 
 // used by khtml's DNS prefetching feature
 /// @internal
 KIOCORE_EXPORT void prefetchHost(const QString &hostName);
 /// @internal
 KIOCORE_EXPORT void setCacheSize(int s);
 /// @internal
 KIOCORE_EXPORT void setTTL(int ttl);
 }
 }
 
 #endif
diff --git a/src/core/jobtracker.h b/src/core/jobtracker.h
index 931330ca..8e465b08 100644
--- a/src/core/jobtracker.h
+++ b/src/core/jobtracker.h
@@ -1,41 +1,42 @@
 /* This file is part of the KDE libraries
    Copyright (C) 2012 David Faure <faure@kde.org>
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License version 2 as published by the Free Software Foundation.
 
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.
 
    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
 */
 
 #ifndef KIO_JOBTRACKER_H
 #define KIO_JOBTRACKER_H
 
 #include "kiocore_export.h"
 
 class KJobTrackerInterface;
 
 namespace KIO
 {
 /**
  * Returns the job tracker to be used by all KIO jobs (in which HideProgressInfo is not set)
  */
 KIOCORE_EXPORT KJobTrackerInterface *getJobTracker();
 
 /**
- * Internal. Allows the KIO widgets library to register its widget-based job tracker automatically.
+ * @internal
+ * Allows the KIO widgets library to register its widget-based job tracker automatically.
  * @since 5.0
  */
 KIOCORE_EXPORT void setJobTracker(KJobTrackerInterface *tracker);
 }
 
 #endif /* KIO_JOBTRACKER_H */