[Libreoffice-commits] core.git: sw/source

Philipp Weissenbacher p.weissenbacher at gmail.com
Thu Oct 2 04:39:44 PDT 2014


 sw/source/core/inc/layact.hxx   |  100 +++++++++++++++++++---------------------
 sw/source/core/inc/layfrm.hxx   |   63 ++++++++++++++++---------
 sw/source/core/inc/mvsave.hxx   |   23 ++++-----
 sw/source/core/inc/node2lay.hxx |   47 +++++++++---------
 sw/source/core/inc/pagefrm.hxx  |   74 ++++++++++++++---------------
 5 files changed, 161 insertions(+), 146 deletions(-)

New commits:
commit 7c3f7016f1bcbc6b7c46de3420c4410700dae5cd
Author: Philipp Weissenbacher <p.weissenbacher at gmail.com>
Date:   Thu Oct 2 13:05:37 2014 +0200

    fdo#39468 Start translating German comments in sw/source/core/inc
    
    Change-Id: I77e61fb268188d7c26132b10d1308daf1bebc741
    Reviewed-on: https://gerrit.libreoffice.org/11761
    Reviewed-by: Noel Grandin <noelgrandin at gmail.com>
    Tested-by: Noel Grandin <noelgrandin at gmail.com>

diff --git a/sw/source/core/inc/layact.hxx b/sw/source/core/inc/layact.hxx
index 0c83a38..3d8d42c 100644
--- a/sw/source/core/inc/layact.hxx
+++ b/sw/source/core/inc/layact.hxx
@@ -31,63 +31,59 @@ class SwViewImp;
 class SwCntntNode;
 class SwWait;
 
-// The usage of LayAction is always the same:
-
-// 1. Generation of the LayAction object.
-// 2. Specifying the wanted bahaviour via the Set-methods
-// 3. Calling Action()
-// 4. Soon after that the destruction of the object
-
-// Das Objekt meldet sich im CTor beim SwViewImp an und erst im DTor
-// wieder ab! Es handelt sich mithin um ein typisches Stackobjekt.
-
+/**
+ * The usage of LayAction is always the same:
+ *
+ * 1. Generation of the LayAction object.
+ * 2. Specifying the wanted behaviour via the Set-methods
+ * 3. Calling Action()
+ * 4. Soon after that the destruction of the object
+ *
+ * The object registers at the SwViewImp in the ctor and deregisters not until
+ * the dtor!
+ * It's a typical stack object.
+ */
 class SwLayAction
 {
     SwRootFrm  *pRoot;
-    SwViewImp  *pImp;   // here the action logs in and off
+    SwViewImp  *pImp; // here the action logs in and off
 
-    // for the sake of optimization, so that the tables stick a bit better to the Crsr
-    // when hitting return/backspace in front of one
-    // Wenn der erste TabFrm, der sich Paintet (pro Seite) traegt sich im
-    // Pointer ein. Die CntntFrms unterhalb der Seite brauchen sich
-    // dann nicht mehr bei der Shell zum Painten anmelden.
+    // For the sake of optimization, so that the tables stick a bit better to
+    // the Crsr when hitting return/backspace in front of one.
+    // The first TabFrm that paints itself (per page) adds itself to the pointer.
+    // The CntntFrms beneath the page do not need to deregister at the Shell for
+    // painting.
     const SwTabFrm *pOptTab;
 
     SwWait *pWait;
 
-    //Wenn ein Absatz - oder was auch immer - bei der Formatierung mehr
-    //als eine Seite rueckwaerts floss traegt er seine neue Seitennummer
-    //hier ein. Die Steuerung der InternalAction kann dann geeignet reagieren.
+    // If a paragraph (or anything else) moved more than one page when
+    // formatting, it adds its new page number here.
+    // The InternalAction can then take the appropriate steps.
     sal_uInt16 nPreInvaPage;
 
-    sal_uLong nStartTicks;  //Startzeitpunkt der Aktion, vergeht zu viel Zeit kann
-                        //der WaitCrsr per CheckWaitCrsr() eingeschaltet werden.
-
-    sal_uInt16 nInputType;  //Bei welchem Input soll die Verarbeitung abgebrochen
-                        //werden?
-    sal_uInt16 nEndPage;    //StatBar control
-    sal_uInt16 nCheckPageNum; //CheckPageDesc() was delayed if != USHRT_MAX
-                          // check from this page on
-
-    bool bPaint;        // painting or only formatting?
-    bool bComplete;     //Alles bis zum sichtbaren Bereich Formatieren oder
-                        // or only the visible area?
-    bool bCalcLayout;   //Vollstaendige Reformatierung?
-    bool bAgain;        //Zur automatisch wiederholten Action wenn Seiten
-                        //geloscht werden.
-    bool bNextCycle;    //Wiederaufsetzen bei der ersten Ungueltigen Seite.
-    bool bInput;        //Zum Abbrechen der Verarbeitung wenn ein Input anliegt.
-    bool bIdle;         //True wenn die Layaction vom Idler ausgeloest wurde.
-    bool bReschedule;   //Soll das Reschedule - abhaengig vom Progress -
-                        //gerufen werden?
-    bool bCheckPages;   //CheckPageDescs() ausfuehren oder verzoegern.
-    bool bUpdateExpFlds;//Wird gesetzt wenn nach dem Formatierien noch eine
-                        //Runde fuer den ExpFld laufen muss.
-    bool bBrowseActionStop; //Action fruehzeitig beenden (per bInput) und den
-                            //Rest dem Idler ueberlassen.
-    bool bWaitAllowed;      //Wartecursor erlaubt?
-    bool bPaintExtraData;   //Anzeige von Zeilennumerierung o. ae. eingeschaltet?
-    bool bActionInProgress; // wird in Action() anfangs gesetzt und zum Schluss geloescht
+    sal_uLong nStartTicks;      // The Action's starting time; if too much time passes the
+                                // WaitCrsr can be enabled via CheckWaitCrsr()
+
+    sal_uInt16 nInputType;      // Which input should terminate processing
+    sal_uInt16 nEndPage;        // StatBar control
+    sal_uInt16 nCheckPageNum;   // CheckPageDesc() was delayed if != USHRT_MAX
+                                // check from this page onwards
+
+    bool bPaint;         // painting or only formatting?
+    bool bComplete;      // Format everything or just the visible Area?
+    bool bCalcLayout;    // Complete reformatting?
+    bool bAgain;         // For the automatically repeated Action if Pages are deleted
+    bool bNextCycle;     // Reset on the first invalid Page
+    bool bInput;         // For terminating processing on input
+    bool bIdle;          // True if the LayAction was triggered by the Idler
+    bool bReschedule;    // Call Reschedule depending on Progress?
+    bool bCheckPages;    // Run CheckPageDescs() or delay it
+    bool bUpdateExpFlds; // Is set if, after Formatting, we need to do another round for ExpFld
+    bool bBrowseActionStop; // Terminate Action early (as per bInput) and leave the rest to the Idler
+    bool bWaitAllowed;      // Waitcursor allowed?
+    bool bPaintExtraData;   // Painting line numbers (or similar) enabled?
+    bool bActionInProgress; // Is set in Action() at the beginning and deleted at the end
 
     // OD 14.04.2003 #106346# - new flag for content formatting on interrupt.
     bool    mbFormatCntntOnInterrupt;
@@ -181,11 +177,11 @@ class SwLayIdle
 {
 
     SwRootFrm *pRoot;
-    SwViewImp  *pImp;           // Hier Meldet sich der Idler an und ab.
-    SwCntntNode *pCntntNode;    // Hier wird die aktuelle Cursorposition
-    sal_Int32  nTxtPos;        // zwischengespeichert.
-    bool        bPageValid;     // Konnte die Seite alles validiert werden?
-    bool        bAllValid;      // Konnte alles validiert werden?
+    SwViewImp  *pImp;           // The Idler registers and deregisters here
+    SwCntntNode *pCntntNode;    // The current cursor position is saved here
+    sal_Int32  nTxtPos;
+    bool        bPageValid;     // Were we able to evaluate everything on the whole page?
+    bool        bAllValid;      // Were we able to evaluate everything?
 
 #ifdef DBG_UTIL
     bool m_bIndicator;
diff --git a/sw/source/core/inc/layfrm.hxx b/sw/source/core/inc/layfrm.hxx
index 28e2bd2..d074034 100644
--- a/sw/source/core/inc/layfrm.hxx
+++ b/sw/source/core/inc/layfrm.hxx
@@ -33,11 +33,11 @@ class SwCellFrm;
 
 class SwLayoutFrm: public SwFrm
 {
-    //Der verkappte SwFrm
+    // The SwFrm in disguise
     friend class SwFlowFrm;
     friend class SwFrm;
 
-        //Hebt die Lower waehrend eines Spaltenumbaus auf.
+    // Releases the Lower while restructuring columns
     friend SwFrm* SaveCntnt( SwLayoutFrm *, SwFrm * );
     friend void   RestoreCntnt( SwFrm *, SwLayoutFrm *, SwFrm *pSibling, bool bGrow );
 
@@ -69,7 +69,7 @@ public:
     void RefreshLaySubsidiary( const SwPageFrm*, const SwRect& ) const;
     void RefreshExtraData( const SwRect & ) const;
 
-        //Proportionale Groessenanpassung der untergeordneten.
+    /// Change size of lowers proportionally
     void ChgLowersProp( const Size& rOldSize );
 
     void AdjustColumns( const SwFmtCol *pCol, bool bAdjustAttributes );
@@ -77,7 +77,7 @@ public:
     void ChgColumns( const SwFmtCol &rOld, const SwFmtCol &rNew,
         const bool bChgFtn = false );
 
-        //Painted die Column-Trennlinien fuer die innenliegenden Columns.
+    /// Paints the column separation line for the inner columns
     void PaintColLines( const SwRect &, const SwFmtCol &,
                         const SwPageFrm * ) const;
 
@@ -89,8 +89,10 @@ public:
     virtual void Cut() SAL_OVERRIDE;
     virtual void Paste( SwFrm* pParent, SwFrm* pSibling = 0 ) SAL_OVERRIDE;
 
-        //sucht den dichtesten Cntnt zum SPoint, wird bei Seiten, Flys und Cells
-        //benutzt wenn GetCrsrOfst versagt hat.
+    /**
+     * Finds the closest Cntnt for the SPoint
+     * Is used for Pages, Flys and Cells if GetCrsrOfst failed
+     */
     const SwCntntFrm* GetCntntPos( Point &rPoint, const bool bDontLeave,
                                    const bool bBodyOnly = false,
                                    const bool bCalc = false,
@@ -108,11 +110,14 @@ public:
     inline SwCntntFrm *ContainsCntnt();
     const SwCellFrm *FirstCell() const;
     inline SwCellFrm *FirstCell();
-    // Method <ContainsAny()> doesn't investigate content of footnotes by default.
-    // But under certain circumstances this investigation is intended.
-    // Thus, introduce new optional parameter <_bInvestigateFtnForSections>.
-    // It's default is <false>, still indicating that content of footnotes isn't
-    // investigated for sections.
+
+    /**
+     * Method <ContainsAny()> doesn't investigate content of footnotes by default.
+     * But under certain circumstances this investigation is intended.
+     * Thus, introduce new optional parameter <_bInvestigateFtnForSections>.
+     * It's default is <false>, still indicating that content of footnotes isn't
+     * investigated for sections.
+     */
     const SwFrm *ContainsAny( const bool _bInvestigateFtnForSections = false ) const;
     inline SwFrm *ContainsAny( const bool _bInvestigateFtnForSections = false );
     bool IsAnLower( const SwFrm * ) const;
@@ -121,28 +126,35 @@ public:
     virtual       SwFrmFmt *GetFmt();
     void        SetFrmFmt( SwFrmFmt* );
 
-    //Verschieben der Ftns aller Lower - ab dem StartCntnt.
-    //sal_True wenn mindestens eine Ftn verschoben wurde.
-    //Ruft das Update der Seitennummer wenn bFtnNums gesetzt ist.
+    /**
+     * Moving the Ftns of all Lowers - starting from StartCntnt
+     *
+     * @returns true if at least one Ftn was moved
+     * Calls the page number update if bFtnNums is set
+     */
     bool MoveLowerFtns( SwCntntFrm *pStart, SwFtnBossFrm *pOldBoss,
                         SwFtnBossFrm *pNewBoss, const bool bFtnNums );
 
     // --> #i28701# - change purpose of method and its name
     // --> #i44016# - add parameter <_bUnlockPosOfObjs> to
-    // force an unlockposition call for the lower objects.
+    /// force an unlockposition call for the lower objects.
     void NotifyLowerObjs( const bool _bUnlockPosOfObjs = false );
 
-    //Invalidiert diejenigen innenliegenden Frames, deren Breite und/oder
-    //Hoehe Prozentual berechnet werden. Auch Rahmen, die an this oder an
-    //innenliegenden verankert sind werden ggf. invalidiert.
+    /**
+     * Invalidates the inner Frames, whose width and/or height are
+     * calculated using percentages.
+     * Frames that are anchored to this or inner Frames, are also invalidated.
+     */
     void InvaPercentLowers( SwTwips nDiff = 0 );
 
-    //Gerufen von Format fuer Rahmen und Bereichen mit Spalten.
+    /// Called by Format for Frames and Areas with columns
     void FormatWidthCols( const SwBorderAttrs &, const SwTwips nBorder,
                           const SwTwips nMinHeight );
 
-    // InnerHeight returns the height of the content and may be bigger or
-    // less than the PrtArea-Height of the layoutframe himself
+    /**
+     * InnerHeight returns the height of the content and may be bigger or
+     * less than the PrtArea-Height of the layoutframe himself
+     */
     SwTwips InnerHeight() const;
 
     /** method to check relative position of layout frame to
@@ -177,7 +189,10 @@ public:
     }
 };
 
-//Um doppelte Implementierung zu sparen wird hier ein bischen gecasted
+/**
+ * In order to save us from duplicating implementations, we cast here
+ * a little.
+ */
 inline SwCntntFrm* SwLayoutFrm::ContainsCntnt()
 {
     return (SwCntntFrm*)(((const SwLayoutFrm*)this)->ContainsCntnt());
@@ -193,7 +208,9 @@ inline SwFrm* SwLayoutFrm::ContainsAny( const bool _bInvestigateFtnForSections )
     return (SwFrm*)(((const SwLayoutFrm*)this)->ContainsAny( _bInvestigateFtnForSections ));
 }
 
-// Diese SwFrm-inlines sind hier, damit frame.hxx nicht layfrm.hxx includen muss
+/**
+ * These SwFrm inlines are here, so that frame.hxx does not need to include layfrm.hxx
+ */
 inline bool SwFrm::IsColBodyFrm() const
 {
     return mnType == FRMC_BODY && GetUpper()->IsColumnFrm();
diff --git a/sw/source/core/inc/mvsave.hxx b/sw/source/core/inc/mvsave.hxx
index f40fc34..c3de3be 100644
--- a/sw/source/core/inc/mvsave.hxx
+++ b/sw/source/core/inc/mvsave.hxx
@@ -95,8 +95,8 @@ void _DelBookmarks(const SwNodeIndex& rStt,
  *  location. */
 struct _SaveFly
 {
-    sal_uLong nNdDiff;              /// relative node difference
-    SwFrmFmt* pFrmFmt;          /// the fly's frame format
+    sal_uLong nNdDiff;      /// relative node difference
+    SwFrmFmt* pFrmFmt;      /// the fly's frame format
     bool bInsertPosition;   /// if true, anchor _at_ insert position
 
     _SaveFly( sal_uLong nNodeDiff, SwFrmFmt* pFmt, bool bInsert )
@@ -132,22 +132,23 @@ public:
     sal_Int32 GetCntnt() const { return nCntnt; }
 };
 
-// Funktions-Deklaration damit auch alles unter der CrsrShell mal die
-// Crsr verschieben kann
-// die Funktionen rufen nicht die SwDoc::Corr - Methoden!
-
-    // Setzt alle PaMs im Bereich vom Range nach NewPos
+/**
+ * Function declarations so that everything below the CrsrShell can
+ * move the Crsr once in a while.
+ * These functions do not call the SwDoc::Corr methods!
+ */
 void PaMCorrAbs( const SwPaM& rRange,
                  const SwPosition& rNewPos );
 
-    // Setzt alle PaMs in OldNode auf relative Pos
+/// Sets all PaMs in OldNode to relative Pos
 void PaMCorrRel( const SwNodeIndex &rOldNode,
                  const SwPosition &rNewPos,
                  const sal_Int32 nOffset = 0 );
 
-// Hilfsklasse zum kopieren von absatzgebundenen Flys. Durch die Sortierung
-// nach der Ordnungsnummer wird versucht die layout seitige Anordnung
-// bei zu behalten
+/**
+ * Helper to copy paragraph-bound Flys.
+ * By sorting by order number, we try to retain the layout.
+ */
 class _ZSortFly
 {
     const SwFrmFmt* pFmt;
diff --git a/sw/source/core/inc/node2lay.hxx b/sw/source/core/inc/node2lay.hxx
index d6a6737..8ae69de 100644
--- a/sw/source/core/inc/node2lay.hxx
+++ b/sw/source/core/inc/node2lay.hxx
@@ -21,26 +21,26 @@
 
 #include <tools/solar.h>
 
-/*
- * Die Klasse SwNode2Layout stellt die Verbindung von Nodes zum Layout her.
- * Sie liefert einen intelligenten Iterator ueber die zum Node oder Nodebereich
- * gehoerenden Frames. Je nach Zweck der Iteration, z.B. um vor oder hinter
- * den Frames andere Frames einzufuegen, werden Master/Follows erkannt und nur
- * die relevanten zurueckgegeben. Auch wiederholte Tabellenueberschriften werden
- * beachtet.
- * Es ist auch moeglich, ueber SectionNodes zu iterieren, die durch Schachtelung
- * manchmal gar keinem SectionFrm direkt zugeordnet sind, manchmal aber sogar
- * mehreren.
- * SwNode2Layout ist ein Schnittstelle zwischen der aufrufenden Methode und
- * einem SwClientIter, sie waehlt je nach Aufgabenstellung das richtige
- * SwModify aus, erzeugt einen SwClientIter und filtert dessen Iterationen
- * je nach Aufgabenstellung.
- * Die Aufgabenstellung wird durch die Wahl des Ctors bestimmt.
- * 1. Das Einsammeln der UpperFrms, damit spaeter RestoreUpperFrms wird,
- *    wird von MakeFrms gerufen, wenn es keinen PrevNext gibt, vor/hinter den
- *    die Frames gehaengt werden koennen.
- * 2. Die Lieferung der Frames hinter/vor die die neuen Frames eines Nodes
- *    gehaengt werden muessen, ebenfalls von MakeFrms gerufen.
+/**
+ * This class connects the Nodes with the Layouts.
+ * It provides an intelligent iterator over Frames belonging to the Node or
+ * Node Area. Depending on the purpose of iterating (e.g. to insert other
+ * Frames before or after the Frames) Master/Follows are recognized and only
+ * the relevant ones are returned. Repeated table headers are also taken
+ * into account.
+ * It's possible to iterate over SectionNodes that are either not directly
+ * assigned to a SectionFrm or to multiple ones due to nesting.
+ *
+ * This class is an interface between the method and a SwClientIter: it
+ * chooses the right SwModify depending on the task, creates a SwClientIter
+ * and filters its iterations depeding on the task.
+ * The task is determined by the choice of ctor.
+ *
+ * 1. Collecting the UpperFrms (so that later on it becomes RestoreUpperFrms)
+ *    is called by MakeFrms, if there's no PrevNext (before/after we can insert
+ *    the Frames).
+ * 2. Inserting the Frames before/after which the new Frames of a Node need to
+ *    be inserted, is also called by MakeFrms.
  */
 
 class SwNode2LayImpl;
@@ -55,10 +55,11 @@ class SwNode2Layout
 {
     SwNode2LayImpl *pImpl;
 public:
-    // Dieser Ctor ist zum Einsammeln der UpperFrms gedacht.
+    /// Use this ctor for collecting the UpperFrms
     SwNode2Layout( const SwNode& rNd );
-    // Dieser Ctor ist fuer das Einfuegen vor oder hinter rNd gedacht,
-    // nIdx ist der Index des einzufuegenden Nodes
+
+    /// Use this ctor for inserting before/after rNd
+    /// @param nIdx is the index of the to-be-inserted Node
     SwNode2Layout( const SwNode& rNd, sal_uLong nIdx );
     ~SwNode2Layout();
     SwFrm* NextFrm();
diff --git a/sw/source/core/inc/pagefrm.hxx b/sw/source/core/inc/pagefrm.hxx
index b0c4a3d..129ee68 100644
--- a/sw/source/core/inc/pagefrm.hxx
+++ b/sw/source/core/inc/pagefrm.hxx
@@ -50,30 +50,30 @@ class SwPageFrm: public SwFtnBossFrm
 
     SwSortedObjs *pSortedObjs;
 
-    SwPageDesc *pDesc;      //PageDesc der die Seite beschreibt.
-
-    sal_uInt16  nPhyPageNum;        //Physikalische Seitennummer.
-
-    bool bInvalidCntnt      :1;
-    bool bInvalidLayout     :1;
-    bool bInvalidFlyCntnt   :1;
-    bool bInvalidFlyLayout  :1;
-    bool bInvalidFlyInCnt   :1;
-    bool bFtnPage           :1; //Diese Seite ist fuer Dokumentende-Fussnoten.
-    bool bEmptyPage         :1; //Dies ist eine explizite Leerseite
-    bool bEndNotePage       :1; //'Fussnotenseite' fuer Endnoten
-    bool bInvalidSpelling   :1; //Das Online-Spelling ist gefordert
-    bool bInvalidSmartTags :1;  //checking for smarttags is needed
-    bool bInvalidAutoCmplWrds :1; //Auto-Complete Wordliste aktualisieren
-    bool bInvalidWordCount  :1;
-    bool bHasGrid           :1; // Grid for Asian layout
+    SwPageDesc *pDesc; //PageDesc that describes the Page
+
+    sal_uInt16  nPhyPageNum; // Physical page number
+
+    bool bInvalidCntnt        :1;
+    bool bInvalidLayout       :1;
+    bool bInvalidFlyCntnt     :1;
+    bool bInvalidFlyLayout    :1;
+    bool bInvalidFlyInCnt     :1;
+    bool bFtnPage             :1; // This Page is for document end footnotes
+    bool bEmptyPage           :1; // This Page is an explicitly empty page
+    bool bEndNotePage         :1; // 'Footnote page' for end notes
+    bool bInvalidSpelling     :1; // We need online spelling
+    bool bInvalidSmartTags    :1; // We need checking for smarttags
+    bool bInvalidAutoCmplWrds :1; // Update auto complete word list
+    bool bInvalidWordCount    :1;
+    bool bHasGrid             :1; // Grid for Asian layout
 
     static const sal_Int8 mnShadowPxWidth;
 
     void _UpdateAttr( const SfxPoolItem*, const SfxPoolItem*, sal_uInt8 &,
                       SwAttrSetChg *pa = 0, SwAttrSetChg *pb = 0 );
 
-    // Anpassen der max. Fussnotenhoehen in den einzelnen Spalten
+    /// Adapt the max. footnote height in each single column
     void SetColMaxFtnHeight();
 
     /** determine rectangle for horizontal page shadow
@@ -111,9 +111,9 @@ public:
     SwPageFrm( SwFrmFmt*, SwFrm*, SwPageDesc* );
     virtual ~SwPageFrm();
 
-    //public, damit die SwViewShell beim Umschalten vom BrowseMode darauf
-    //zugreifen kann.
-    void PrepareHeader();   //Kopf-/Fusszeilen anlegen/entfernen.
+    /// Make this public, so that the SwViewShell can access it when switching from browse mode
+    /// Add/remove header/footer
+    void PrepareHeader();
     void PrepareFooter();
 
     const SwSortedObjs  *GetSortedObjs() const  { return pSortedObjs; }
@@ -124,7 +124,7 @@ public:
 
     void AppendFlyToPage( SwFlyFrm *pNew );
     void RemoveFlyFromPage( SwFlyFrm *pToRemove );
-    void MoveFly( SwFlyFrm *pToMove, SwPageFrm *pDest );//optimiertes Remove/Append
+    void MoveFly( SwFlyFrm *pToMove, SwPageFrm *pDest ); // Optimized Remove/Append
 
     void  SetPageDesc( SwPageDesc *, SwFrmFmt * );
           SwPageDesc *GetPageDesc() { return pDesc; }
@@ -138,18 +138,18 @@ public:
 
     SwRect GetBoundRect() const;
 
-    //Spezialisiertes GetCntntPos() fuer Felder in Rahmen.
+    // Specialized GetCntntPos() for Field in Frames
     void GetCntntPosition( const Point &rPt, SwPosition &rPos ) const;
 
-    bool IsEmptyPage() const { return bEmptyPage; } //explizite Leerseite.
+    bool IsEmptyPage() const { return bEmptyPage; } // Explicitly empty page
 
     void    UpdateFtnNum();
 
-    //Immer nach dem Paste rufen. Erzeugt die Seitengeb. Rahmen und Formatiert
-    //generischen Inhalt.
+    /// Always call after Paste
+    /// Creates the page-bound frames and formats the generic content
     void PreparePage( bool bFtn );
 
-    //Schickt an alle ContentFrames ein Prepare wg. geaenderter Registervorlage
+    // Sends a Prepare() to all ContentFrames caused by a changed register template
     void PrepareRegisterChg();
 
     // Appends a fly frame - the given one or a new one - at the page frame.
@@ -162,7 +162,7 @@ public:
 
     virtual bool GetCrsrOfst( SwPosition *, Point&,
                               SwCrsrMoveState* = 0, bool bTestBackground = false ) const SAL_OVERRIDE;
-        // erfrage vom Client Informationen
+    /// Get info from Client
     virtual bool GetInfo( SfxPoolItem& ) const SAL_OVERRIDE;
 
     virtual void Cut() SAL_OVERRIDE;
@@ -176,25 +176,25 @@ public:
     virtual void PaintSubsidiaryLines( const SwPageFrm*, const SwRect& ) const SAL_OVERRIDE;
     virtual void PaintBreak() const SAL_OVERRIDE;
 
-    //Zeilennummern usw malen
+    /// Paint line number etc.
     void RefreshExtraData( const SwRect & ) const;
 
-    //Hilfslinien malen.
+    /// Paint helper lines
     void RefreshSubsidiary( const SwRect& ) const;
 
-    //Fussnotenschnittstelle
-    bool IsFtnPage() const                                  { return bFtnPage; }
-    bool IsEndNotePage() const                              { return bEndNotePage; }
-    void SetFtnPage( bool b )                               { bFtnPage = b; }
-    void SetEndNotePage( bool b )                           { bEndNotePage = b; }
+    /// Foot note interface
+    bool IsFtnPage() const                          { return bFtnPage; }
+    bool IsEndNotePage() const                      { return bEndNotePage; }
+    void SetFtnPage( bool b )                       { bFtnPage = b; }
+    void SetEndNotePage( bool b )                   { bEndNotePage = b; }
 
     inline  sal_uInt16 GetPhyPageNum() const        { return nPhyPageNum;}
     inline  void SetPhyPageNum( sal_uInt16 nNum )   { nPhyPageNum = nNum;}
     inline  void DecrPhyPageNum()               { --nPhyPageNum;     }
     inline  void IncrPhyPageNum()               { ++nPhyPageNum;     }
 
-    //Validieren, invalidieren und abfragen des Status der Seite.
-    //Layout/Cntnt und jeweils Fly/nicht Fly werden getrennt betrachtet.
+    /// Validate, invalidate and query the Page status
+    /// Layout/Cntnt and Fly/non-Fly respectively are inspected separately
     inline void InvalidateFlyLayout() const;
     inline void InvalidateFlyCntnt() const;
     inline void InvalidateFlyInCnt() const;


More information about the Libreoffice-commits mailing list