Bin comments that claim to say why some header is included

They are practically always useless, often misleading or obsolete.

Change-Id: I2d32182a31349c9fb3b982498fd22d93e84c0c0c

25 files changed, 49 insertions, 49 deletions

diff --git a/sw/inc/IDocumentRedlineAccess.hxx b/sw/inc/IDocumentRedlineAccess.hxx
index 191d820dfab2..690b5b8c2e65 100644
--- a/sw/inc/IDocumentRedlineAccess.hxx
+++ b/sw/inc/IDocumentRedlineAccess.hxx
@@ -23,7 +23,7 @@
  #include <sal/types.h>
  #include <tools/solar.h>
 
- #include <limits.h> // USHRT_MAX
+ #include <limits.h>
 
  #include <com/sun/star/uno/Sequence.hxx>
 
diff --git a/sw/inc/crsrsh.hxx b/sw/inc/crsrsh.hxx
index 8994c37bdf06..3d3e8d912917 100644
--- a/sw/inc/crsrsh.hxx
+++ b/sw/inc/crsrsh.hxx
@@ -27,13 +27,13 @@
 
 #include <IShellCursorSupplier.hxx>
 #include "swdllapi.h"
-#include <swtypes.hxx>          // for SWPOSDOC
-#include <viewsh.hxx>           // for ViewShell
-#include <calbck.hxx>           // for SwClient
-#include <cshtyp.hxx>           // for CursorShell types
-#include <crstate.hxx>          // for CursorMove-States
-#include <toxe.hxx>             // SwTOXSearchDir
-#include <tblsel.hxx>           // SwTblSearchType
+#include <swtypes.hxx>
+#include <viewsh.hxx>
+#include <calbck.hxx>
+#include <cshtyp.hxx>
+#include <crstate.hxx>
+#include <toxe.hxx>
+#include <tblsel.hxx>
 #include <viscrs.hxx>
 #include <node.hxx>
 #include <tblsel.hxx>
diff --git a/sw/inc/dlelstnr.hxx b/sw/inc/dlelstnr.hxx
index 8ce12ebc54f0..acf9f2a2a6a4 100644
--- a/sw/inc/dlelstnr.hxx
+++ b/sw/inc/dlelstnr.hxx
@@ -25,7 +25,7 @@
 #include <com/sun/star/linguistic2/XLinguServiceEventListener.hpp>
 #include <com/sun/star/frame/XTerminateListener.hpp>
 #include <com/sun/star/frame/XDesktop2.hpp>
-#include <cppuhelper/implbase2.hxx> // helper for implementations
+#include <cppuhelper/implbase2.hxx>
 
 
 namespace com { namespace sun { namespace star {
diff --git a/sw/inc/doc.hxx b/sw/inc/doc.hxx
index 3dc2f6f9d176..5e1138e99ede 100644
--- a/sw/inc/doc.hxx
+++ b/sw/inc/doc.hxx
@@ -51,7 +51,7 @@ class SwList;
 #include "swdllapi.h"
 #include <swtypes.hxx>
 #include <swatrset.hxx>
-#include <toxe.hxx>             // enums
+#include <toxe.hxx>
 #include <flyenum.hxx>
 #include <flypos.hxx>
 #include <itabenum.hxx>
diff --git a/sw/inc/editsh.hxx b/sw/inc/editsh.hxx
index d3a1aa5a3516..43987f8fdf97 100644
--- a/sw/inc/editsh.hxx
+++ b/sw/inc/editsh.hxx
@@ -24,7 +24,7 @@
 #include <vcl/font.hxx>
 #include <editeng/swafopt.hxx>
 #include "swdllapi.h"
-#include <crsrsh.hxx>   // For base class.
+#include <crsrsh.hxx>
 #include <itabenum.hxx>
 #include <swdbdata.hxx>
 #include <com/sun/star/linguistic2/XSpellAlternatives.hpp>
diff --git a/sw/inc/fmtcol.hxx b/sw/inc/fmtcol.hxx
index 590f53449c54..85e54ec8565b 100644
--- a/sw/inc/fmtcol.hxx
+++ b/sw/inc/fmtcol.hxx
@@ -21,7 +21,7 @@
 
 #include "swdllapi.h"
 #include <frmatr.hxx>
-#include <swtypes.hxx> // For MAXLEVEL.
+#include <swtypes.hxx>
 #include <boost/ptr_container/ptr_vector.hpp>
 #include <rtl/ustring.hxx>
 
diff --git a/sw/inc/format.hxx b/sw/inc/format.hxx
index 5463e9f9162d..d6f801031767 100644
--- a/sw/inc/format.hxx
+++ b/sw/inc/format.hxx
@@ -21,8 +21,8 @@
 
 #include <tools/solar.h>
 #include "swdllapi.h"
-#include <swatrset.hxx>     ///< For SfxItemPool/-Set, Attr forward decl.
-#include <calbck.hxx>       ///< For SwModify.
+#include <swatrset.hxx>
+#include <calbck.hxx>
 #include <hintids.hxx>
 
 class IDocumentSettingAccess;
diff --git a/sw/inc/frmatr.hxx b/sw/inc/frmatr.hxx
index 402005d02b79..b5c59d7215d5 100644
--- a/sw/inc/frmatr.hxx
+++ b/sw/inc/frmatr.hxx
@@ -19,8 +19,8 @@
 #ifndef _FRMATR_HXX
 #define _FRMATR_HXX
 
-#include <hintids.hxx> // IDs of attributes before frmitems to make sure
-#include <format.hxx>  // they are available for implementation of the inlines.
+#include <hintids.hxx>
+#include <format.hxx>
 
 // Inlines
 
diff --git a/sw/inc/grfatr.hxx b/sw/inc/grfatr.hxx
index d4190465e10e..7b84836b67d5 100644
--- a/sw/inc/grfatr.hxx
+++ b/sw/inc/grfatr.hxx
@@ -19,14 +19,14 @@
 #ifndef _GRFATR_HXX
 #define _GRFATR_HXX
 
-#include <hintids.hxx>      // For the WhichIds @@@ must be included first @@@
+#include <hintids.hxx>
 #include <tools/gen.hxx>
 #include <svl/eitem.hxx>
 #include <svl/intitem.hxx>
 #include <svx/grfcrop.hxx>
 #include "swdllapi.h"
-#include <swatrset.hxx>     // For inlines.
-#include <format.hxx>       // For inlines.
+#include <swatrset.hxx>
+#include <format.hxx>
 
 /******************************************************************************
  *  class SwMirrorGrf
diff --git a/sw/inc/hintids.hxx b/sw/inc/hintids.hxx
index 97ee553f4035..8d5feceeef67 100644
--- a/sw/inc/hintids.hxx
+++ b/sw/inc/hintids.hxx
@@ -20,7 +20,7 @@
 #define _HINTIDS_HXX
 
 #include <tools/solar.h>
-#include <sal/types.h>          // for sal_Unicode
+#include <sal/types.h>
 #include "swdllapi.h"
 
 // For SwTxtHints without end index the following char is added:
diff --git a/sw/inc/htmltbl.hxx b/sw/inc/htmltbl.hxx
index fe855242f0cf..b9d9f22e31c2 100644
--- a/sw/inc/htmltbl.hxx
+++ b/sw/inc/htmltbl.hxx
@@ -25,7 +25,7 @@
 #include <editeng/svxenum.hxx>
 
 #include "swtypes.hxx"
-#include "node.hxx"     ///< For SwStartNode
+#include "node.hxx"
 
 
 class SwTableBox;
diff --git a/sw/inc/index.hxx b/sw/inc/index.hxx
index 6934c26142e0..e59d0d843b6d 100644
--- a/sw/inc/index.hxx
+++ b/sw/inc/index.hxx
@@ -24,7 +24,7 @@
 #include "rtl/instance.hxx"
 #include <tools/solar.h>
 #include <tools/string.hxx>
-#include <tools/rtti.hxx>               // for RTTI of SwIndexReg
+#include <tools/rtti.hxx>
 #include <swdllapi.h>
 
 // Maximum index in IndexArray (for testing on overflows).
diff --git a/sw/inc/pagedesc.hxx b/sw/inc/pagedesc.hxx
index e668dfd240ae..e1ab6f7290ef 100644
--- a/sw/inc/pagedesc.hxx
+++ b/sw/inc/pagedesc.hxx
@@ -22,7 +22,7 @@
 #include <tools/fract.hxx>
 #include <tools/color.hxx>
 #include "swdllapi.h"
-#include <swtypes.hxx>  ///< For SwTwips.
+#include <swtypes.hxx>
 #include <frmfmt.hxx>
 #include <editeng/numitem.hxx>
 #include <editeng/borderline.hxx>
diff --git a/sw/inc/pam.hxx b/sw/inc/pam.hxx
index 7003b6422bff..f48dff8e85be 100644
--- a/sw/inc/pam.hxx
+++ b/sw/inc/pam.hxx
@@ -19,13 +19,13 @@
 #ifndef _PAM_HXX
 #define _PAM_HXX
 
-#include <stddef.h>         ///< For MemPool.
+#include <stddef.h>
 #include <sal/types.h>
 #include <tools/mempool.hxx>
-#include <cshtyp.hxx>       ///< For function definitions.
-#include <ring.hxx>         ///< Super class.
-#include <index.hxx>        ///< For SwIndex.
-#include <ndindex.hxx>      ///< For SwNodeIndex.
+#include <cshtyp.hxx>
+#include <ring.hxx>
+#include <index.hxx>
+#include <ndindex.hxx>
 #include "swdllapi.h"
 
 class SwFmt;
diff --git a/sw/inc/shellio.hxx b/sw/inc/shellio.hxx
index 328593f19ae4..3e0d0f597a20 100644
--- a/sw/inc/shellio.hxx
+++ b/sw/inc/shellio.hxx
@@ -35,7 +35,7 @@
 #include <tools/ref.hxx>
 #include <swdllapi.h>
 #include <swtypes.hxx>
-#include <docfac.hxx>   // SwDocFac
+#include <docfac.hxx>
 #include <iodetect.hxx>
 #include <IMark.hxx>
 
diff --git a/sw/inc/splargs.hxx b/sw/inc/splargs.hxx
index 2c7d6af110b0..16e5c8cae73e 100644
--- a/sw/inc/splargs.hxx
+++ b/sw/inc/splargs.hxx
@@ -22,7 +22,7 @@
 #include <i18nlangtag/lang.h>
 #include <tools/solar.h>
 #include <tools/gen.hxx>
-#include <limits.h>       // USHRT_MAX
+#include <limits.h>
 
 class SwTxtNode;
 class SwIndex;
diff --git a/sw/inc/swtypes.hxx b/sw/inc/swtypes.hxx
index 1426b0260768..fe2636e26348 100644
--- a/sw/inc/swtypes.hxx
+++ b/sw/inc/swtypes.hxx
@@ -22,7 +22,7 @@
 #include <tools/solar.h>
 #include <SwGetPoolIdFromName.hxx>
 
-#include <limits.h>     //For LONG_MAX.
+#include <limits.h>
 #include <com/sun/star/uno/Reference.h>
 #include "swdllapi.h"
 #include <i18nlangtag/languagetag.hxx>
diff --git a/sw/inc/tblafmt.hxx b/sw/inc/tblafmt.hxx
index 6ef82568ba13..a5444a9f2dff 100644
--- a/sw/inc/tblafmt.hxx
+++ b/sw/inc/tblafmt.hxx
@@ -30,7 +30,7 @@
 
 #include <boost/scoped_ptr.hpp>
 
-#include "hintids.hxx"          // _Always_ before the solar-items!
+#include "hintids.hxx"
 #include <svx/algitem.hxx>
 #include <editeng/fontitem.hxx>
 #include <editeng/fhgtitem.hxx>
diff --git a/sw/inc/tox.hxx b/sw/inc/tox.hxx
index 047cc1553172..8e5a3b746a55 100644
--- a/sw/inc/tox.hxx
+++ b/sw/inc/tox.hxx
@@ -29,7 +29,7 @@
 #include <toxe.hxx>
 #include <calbck.hxx>
 
-#include <vector> // #i21237#
+#include <vector>
 
 namespace com { namespace sun { namespace star {
     namespace text { class XDocumentIndexMark; }
diff --git a/sw/inc/txtatr.hxx b/sw/inc/txtatr.hxx
index d28112979800..0536e65ccdb6 100644
--- a/sw/inc/txtatr.hxx
+++ b/sw/inc/txtatr.hxx
@@ -19,7 +19,7 @@
 #ifndef _TXTATR_HXX
 #define _TXTATR_HXX
 
-#include <txatbase.hxx>     // SwTxtAttr/SwTxtAttrEnd
+#include <txatbase.hxx>
 #include <calbck.hxx>
 
 
diff --git a/sw/inc/unochart.hxx b/sw/inc/unochart.hxx
index 16baeacc6def..f5753136ec8c 100644
--- a/sw/inc/unochart.hxx
+++ b/sw/inc/unochart.hxx
@@ -41,11 +41,11 @@
 #include <com/sun/star/util/XModifyListener.hpp>
 #include <com/sun/star/chart/ChartDataRowSource.hpp>
 
-#include <cppuhelper/interfacecontainer.h>  //OMultiTypeInterfaceContainerHelper
-#include <cppuhelper/implbase2.hxx> // helper for implementations
-#include <cppuhelper/implbase4.hxx> // helper for implementations
-#include <cppuhelper/implbase6.hxx> // helper for implementations
-#include <cppuhelper/implbase10.hxx> // helper for implementations
+#include <cppuhelper/interfacecontainer.h>
+#include <cppuhelper/implbase2.hxx>
+#include <cppuhelper/implbase4.hxx>
+#include <cppuhelper/implbase6.hxx>
+#include <cppuhelper/implbase10.hxx>
 #include <cppuhelper/weakref.hxx>
 
 #include <tools/link.hxx>
diff --git a/sw/inc/unocoll.hxx b/sw/inc/unocoll.hxx
index 271491ec1061..928466513fa6 100644
--- a/sw/inc/unocoll.hxx
+++ b/sw/inc/unocoll.hxx
@@ -25,10 +25,10 @@
 #include <com/sun/star/container/XEnumerationAccess.hpp>
 #include <com/sun/star/container/XNameAccess.hpp>
 #include <com/sun/star/container/XIndexAccess.hpp>
-#include <cppuhelper/implbase1.hxx> // helper for implementations
-#include <cppuhelper/implbase2.hxx> // helper for implementations
-#include <cppuhelper/implbase3.hxx> // helper for implementations
-#include <cppuhelper/implbase4.hxx> // helper for implementations
+#include <cppuhelper/implbase1.hxx>
+#include <cppuhelper/implbase2.hxx>
+#include <cppuhelper/implbase3.hxx>
+#include <cppuhelper/implbase4.hxx>
 #include <IMark.hxx>
 #include <unobaseclass.hxx>
 #include "swdllapi.h"
diff --git a/sw/inc/unodraw.hxx b/sw/inc/unodraw.hxx
index d285554f89d2..a505e16a0645 100644
--- a/sw/inc/unodraw.hxx
+++ b/sw/inc/unodraw.hxx
@@ -28,9 +28,9 @@
 #include <com/sun/star/lang/XUnoTunnel.hpp>
 #include <com/sun/star/beans/XPropertyState.hpp>
 #include <com/sun/star/drawing/XShapes.hpp>
-#include <cppuhelper/implbase3.hxx> // helper for implementations
-#include <cppuhelper/implbase4.hxx> // helper for implementations
-#include <cppuhelper/implbase6.hxx> // helper for implementations
+#include <cppuhelper/implbase3.hxx>
+#include <cppuhelper/implbase4.hxx>
+#include <cppuhelper/implbase6.hxx>
 #include <com/sun/star/container/XEnumerationAccess.hpp>
 #include <com/sun/star/drawing/HomogenMatrix3.hpp>
 #include <svl/itemprop.hxx>
diff --git a/sw/inc/unosrch.hxx b/sw/inc/unosrch.hxx
index 63d3f72e9f0e..45936615510f 100644
--- a/sw/inc/unosrch.hxx
+++ b/sw/inc/unosrch.hxx
@@ -22,7 +22,7 @@
 #include <com/sun/star/util/XPropertyReplace.hpp>
 #include <com/sun/star/lang/XServiceInfo.hpp>
 #include <com/sun/star/lang/XUnoTunnel.hpp>
-#include <cppuhelper/implbase3.hxx> // helper for implementations
+#include <cppuhelper/implbase3.hxx>
 #include <rtl/ustring.hxx>
 
 class SfxItemPropertySet;
diff --git a/sw/inc/unotxdoc.hxx b/sw/inc/unotxdoc.hxx
index 0c2378cc89dc..2f5a1e1cc8e4 100644
--- a/sw/inc/unotxdoc.hxx
+++ b/sw/inc/unotxdoc.hxx
@@ -65,8 +65,8 @@
 #include <svx/fmdmod.hxx>
 #include <editeng/UnoForbiddenCharsTable.hxx>
 #include <cppuhelper/weak.hxx>
-#include <cppuhelper/implbase2.hxx> // helper for implementations
-#include <cppuhelper/implbase4.hxx> // helper for implementations
+#include <cppuhelper/implbase2.hxx>
+#include <cppuhelper/implbase4.hxx>
 
 #include <unobaseclass.hxx>
 #include <viewopt.hxx>