diff --git a/core/action.h b/core/action.h
index 9828a28b9..4c462c90e 100644
--- a/core/action.h
+++ b/core/action.h
@@ -68,9 +68,11 @@ class OKULAR_EXPORT Action
         virtual QString actionTip() const;
 
     protected:
+        /// @cond PRIVATE
         Action( ActionPrivate &dd );
         Q_DECLARE_PRIVATE( Action )
         ActionPrivate *d_ptr;
+        /// @endcond
 
     private:
         Q_DISABLE_COPY( Action )
diff --git a/core/annotations.h b/core/annotations.h
index 2d54375e6..064acce78 100644
--- a/core/annotations.h
+++ b/core/annotations.h
@@ -82,10 +82,12 @@ class OKULAR_EXPORT AnnotationUtils
  */
 class OKULAR_EXPORT Annotation
 {
+    /// @cond PRIVATE
     friend class AnnotationObjectRect;
     friend class Document;
     friend class Page;
     friend class PagePrivate;
+    /// @endcond
 
     public:
         /**
@@ -574,10 +576,12 @@ class OKULAR_EXPORT Annotation
         virtual void store( QDomNode & node, QDomDocument & document ) const;
 
     protected:
+        /// @cond PRIVATE
         Annotation( AnnotationPrivate &dd );
         Annotation( AnnotationPrivate &dd, const QDomNode &description );
         Q_DECLARE_PRIVATE( Annotation )
         AnnotationPrivate *d_ptr;
+        /// @endcond
 
     private:
         Q_DISABLE_COPY( Annotation )
diff --git a/core/document.h b/core/document.h
index 1a69da82d..32d260ab9 100644
--- a/core/document.h
+++ b/core/document.h
@@ -606,7 +606,9 @@ class OKULAR_EXPORT Document : public QObject
         void searchFinished( int id, Okular::Document::SearchStatus endStatus );
 
     private:
+        /// @cond PRIVATE
         friend class DocumentPrivate;
+        /// @endcond
         DocumentPrivate *const d;
 
         Q_DISABLE_COPY( Document )
diff --git a/core/fontinfo.h b/core/fontinfo.h
index c279aa7ea..0bdd2a1b2 100644
--- a/core/fontinfo.h
+++ b/core/fontinfo.h
@@ -115,7 +115,9 @@ class OKULAR_EXPORT FontInfo
         bool operator!=( const FontInfo &fi ) const;
 
     private:
+        /// @cond PRIVATE
         friend class FontInfoPrivate;
+        /// @endcond
         QSharedDataPointer<FontInfoPrivate> d;
 };
 
diff --git a/core/form.h b/core/form.h
index 8eceb280a..f6ec3c52c 100644
--- a/core/form.h
+++ b/core/form.h
@@ -33,8 +33,10 @@ class FormFieldChoicePrivate;
  */
 class OKULAR_EXPORT FormField
 {
+    /// @cond PRIVATE
     friend class Page;
     friend class PagePrivate;
+    /// @endcond
 
     public:
         /**
@@ -88,9 +90,11 @@ class OKULAR_EXPORT FormField
         virtual bool isVisible() const;
 
     protected:
+        /// @cond PRIVATE
         FormField( FormFieldPrivate &dd );
         Q_DECLARE_PRIVATE( FormField )
         FormFieldPrivate *d_ptr;
+        /// @endcond
 
     private:
         Q_DISABLE_COPY( FormField )
diff --git a/core/generator.h b/core/generator.h
index 50c20cac4..abf840052 100644
--- a/core/generator.h
+++ b/core/generator.h
@@ -152,7 +152,9 @@ class OKULAR_EXPORT ExportFormat
         bool operator!=( const ExportFormat &other ) const;
 
     private:
+        /// @cond PRIVATE
         friend class ExportFormatPrivate;
+        /// @endcond
         QSharedDataPointer<ExportFormatPrivate> d;
 };
 
@@ -174,8 +176,10 @@ class OKULAR_EXPORT ExportFormat
  */
 class OKULAR_EXPORT Generator : public QObject
 {
+    /// @cond PRIVATE
     friend class PixmapGenerationThread;
     friend class TextPageGenerationThread;
+    /// @endcond
 
     Q_OBJECT
 
@@ -441,10 +445,14 @@ setAboutData( about );
         void setAboutData( KAboutData* data );
 
     private:
+        /// @cond PRIVATE
         friend class GeneratorPrivate;
+        /// @endcond PRIVATE
         GeneratorPrivate* const d;
 
+        /// @cond PRIVATE
         friend class Document;
+        /// @endcond PRIVATE
 
         Q_PRIVATE_SLOT( d, void pixmapGenerationFinished() )
         Q_PRIVATE_SLOT( d, void textpageGenerationFinished() )
@@ -521,6 +529,7 @@ class OKULAR_EXPORT PixmapRequest
         void swap();
 
     protected:
+        /// @cond PRIVATE
         /**
          * Internal usage.
          */
@@ -535,6 +544,7 @@ class OKULAR_EXPORT PixmapRequest
          * Internal usage.
          */
         void setPage( Page *page );
+        /// @endcond
 
     private:
         Q_DISABLE_COPY( PixmapRequest )
diff --git a/core/page.h b/core/page.h
index c8fc63a6c..8e96b052a 100644
--- a/core/page.h
+++ b/core/page.h
@@ -305,6 +305,7 @@ class OKULAR_EXPORT Page
 
     private:
         PagePrivate* const d;
+        /// @cond PRIVATE
         friend class PagePrivate;
         friend class Document;
         friend class DocumentPrivate;
@@ -314,6 +315,7 @@ class OKULAR_EXPORT Page
          * member variables directly.
          */
         friend class ::PagePainter;
+        /// @endcond
 
         const QPixmap * _o_nearestPixmap( int, int, int ) const;
 
diff --git a/core/pagesize.h b/core/pagesize.h
index 42ab7b2c5..e92483378 100644
--- a/core/pagesize.h
+++ b/core/pagesize.h
@@ -72,7 +72,9 @@ class OKULAR_EXPORT PageSize
         bool operator!=( const PageSize &pageSize ) const;
 
     private:
+        /// @cond PRIVATE
         friend class PageSizePrivate;
+        /// @endcond
         QSharedDataPointer<PageSizePrivate> d;
 };
 
diff --git a/core/textdocumentgenerator.h b/core/textdocumentgenerator.h
index 30c36beed..11d6e5f7b 100644
--- a/core/textdocumentgenerator.h
+++ b/core/textdocumentgenerator.h
@@ -105,7 +105,9 @@ class OKULAR_EXPORT TextDocumentConverter : public QObject
 
 class OKULAR_EXPORT TextDocumentGenerator : public Generator
 {
+    /// @cond PRIVATE
     friend class TextDocumentConverter;
+    /// @endcond
 
     Q_OBJECT