[Libreoffice-commits] .: sw/inc sw/source

[Miklos Vajna]

 sw/inc/doc.hxx                 |    1 +
 sw/inc/index.hxx               |    1 +
 sw/inc/ndindex.hxx             |    1 +
 sw/inc/ndtxt.hxx               |    2 +-
 sw/inc/pam.hxx                 |    2 ++
 sw/source/core/inc/hffrm.hxx   |    2 ++
 sw/source/core/inc/pagefrm.hxx |    1 +
 sw/source/core/inc/rootfrm.hxx |    1 +
 8 files changed, 10 insertions(+), 1 deletion(-)

New commits:
commit 335b38d831558ce786f726b4b6a014d2a312cf29
Author: Miklos Vajna <vmiklos at suse.cz>
Date:   Wed Feb 15 11:36:56 2012 +0100

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

diff --git a/sw/inc/doc.hxx b/sw/inc/doc.hxx
index 8fb1c1b..580108e 100644
--- a/sw/inc/doc.hxx
+++ b/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,
diff --git a/sw/inc/index.hxx b/sw/inc/index.hxx
index 329fcb4..8d183db 100644
--- a/sw/inc/index.hxx
+++ b/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:
diff --git a/sw/inc/ndindex.hxx b/sw/inc/ndindex.hxx
index 566d180..4283408 100644
--- a/sw/inc/ndindex.hxx
+++ b/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& );
diff --git a/sw/inc/ndtxt.hxx b/sw/inc/ndtxt.hxx
index b412aa4..21e9fb4 100644
--- a/sw/inc/ndtxt.hxx
+++ b/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
 {
 
diff --git a/sw/inc/pam.hxx b/sw/inc/pam.hxx
index 53d1486..1ca3905 100644
--- a/sw/inc/pam.hxx
+++ b/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;
diff --git a/sw/source/core/inc/hffrm.hxx b/sw/source/core/inc/hffrm.hxx
index dcf9a2b..993da32 100644
--- a/sw/source/core/inc/hffrm.hxx
+++ b/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:
diff --git a/sw/source/core/inc/pagefrm.hxx b/sw/source/core/inc/pagefrm.hxx
index 779c4cd..0091e24 100644
--- a/sw/source/core/inc/pagefrm.hxx
+++ b/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;
diff --git a/sw/source/core/inc/rootfrm.hxx b/sw/source/core/inc/rootfrm.hxx
index 788fc55..b8f0f8f 100644
--- a/sw/source/core/inc/rootfrm.hxx
+++ b/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.