sw: add doxygen comments for some document model / layout classes

sw/inc/doc.hxx

@@ -249,6 +249,7 @@ void SetAllScriptItem( SfxItemSet& rSet, const SfxPoolItem& rItem );
 // global function to start grammar checking in the document
 void StartGrammarChecking( SwDoc &rDoc );
 
+/// Represents the model of a Writer document.
 class SW_DLLPUBLIC SwDoc :
     public IInterface,
     public IDocumentSettingAccess,

sw/inc/index.hxx

@@ -48,6 +48,7 @@ struct SwPosition;
 #define INLINE inline
 #endif
 
+/// Marks a character position inside a document model node.
 class SW_DLLPUBLIC SwIndex
 {
 private:

sw/inc/ndindex.hxx

@@ -38,6 +38,7 @@
 class SwNode;
 class SwNodes;
 
+/// Marks a node in the document model.
 class SW_DLLPUBLIC SwNodeIndex
 {
     friend void SwNodes::RegisterIndex( SwNodeIndex& );

sw/inc/ndtxt.hxx

@@ -79,7 +79,7 @@ namespace com { namespace sun { namespace star {
 
 typedef std::set< xub_StrLen > SwSoftPageBreakList;
 
-// SwTxtNode
+/// SwTxtNode is a paragraph in the document model.
 class SW_DLLPUBLIC SwTxtNode: public SwCntntNode, public ::sfx2::Metadatable
 {
 

sw/inc/pam.hxx

@@ -53,6 +53,7 @@ namespace utl {
     class TextSearch;
 }
 
+/// Marks a position in the document model.
 struct SW_DLLPUBLIC SwPosition
 {
     SwNodeIndex nNode;
@@ -157,6 +158,7 @@ extern SwGoInDoc fnGoCntntCellsSkipHidden;
 
 void _InitPam();
 
+/// PaM is Point and Mark: a selection of the document model.
 class SW_DLLPUBLIC SwPaM : public Ring
 {
     SwPosition   m_Bound1;

sw/source/core/inc/hffrm.hxx

@@ -49,6 +49,7 @@ public:
     virtual void PaintSubsidiaryLines( const SwPageFrm*, const SwRect& ) const;
 };
 
+/// Header in the document layout, inside a page.
 class SwHeaderFrm: public SwHeadFootFrm
 {
 public:
@@ -57,6 +58,7 @@ public:
     DECL_FIXEDMEMPOOL_NEWDEL(SwHeaderFrm)
 };
 
+/// Footer in the document layout, inside a page.
 class SwFooterFrm: public SwHeadFootFrm
 {
 public:

sw/source/core/inc/pagefrm.hxx

@@ -58,6 +58,7 @@ enum SwPageChg
     CHG_CHGPAGE
 };
 
+/// A page of the document layout.
 class SwPageFrm: public SwFtnBossFrm
 {
     friend class SwFrm;

sw/source/core/inc/rootfrm.hxx

@@ -62,6 +62,7 @@ struct SwCrsrMoveState;
 
 #include <vector>
 
+/// The root element of a Writer document layout.
 class SwRootFrm: public SwLayoutFrm
 {
     //Muss das Superfluous temporaer abschalten.