Date: prev next · Thread: first prev next last
2011 Archives by date, by thread · List index 

From 9099a9635ae87dc314a8db993c31f03f2168b24b Mon Sep 17 00:00:00 2001
From: Christoph Herzog <rhogez@googlemail.com>
Date: Mon, 10 Jan 2011 16:24:17 +0100
Subject: [PATCH] Translations in sw/inc/doc.hxx


---
sw/inc/doc.hxx | 570 +++++++++++++++++++++++++++++--------------------------- 
 1 files changed, 291 insertions(+), 279 deletions(-)

diff --git a/sw/inc/doc.hxx b/sw/inc/doc.hxx
index 3636b88..12dd790 100644
--- a/sw/inc/doc.hxx
+++ b/sw/inc/doc.hxx
@@ -245,7 +245,7 @@ namespace sfx2 {
     class LinkManager;
 }
 -//PageDescriptor-Schnittstelle, Array hier wegen inlines.
+// PageDescriptor-interface, Array because of inlines.
 typedef SwPageDesc* SwPageDescPtr;
 SV_DECL_PTRARR_DEL( SwPageDescs, SwPageDescPtr, 4, 4 )
 @@ -288,16 +288,16 @@ class SW_DLLPUBLIC SwDoc :
     SwNodes    aUndoNodes;                     // content for undo
     SwAttrPool*        mpAttrPool;                             // attribute pool
     SwPageDescs        aPageDescs;                             // PageDescriptors
-    Link               aOle2Link;                              // OLE 2.0-Benachrichtigung
+    Link               aOle2Link;                              // OLE 2.0-notification
     /* @@@MAINTAINABILITY-HORROR@@@
        Timer should not be members of the model
     */
-    Timer       aIdleTimer;             // der eigene IdleTimer
+    Timer       aIdleTimer;             // Own IdleTimer
     Timer              aOLEModifiedTimer;              // Timer for update modified OLE-Objecs
     SwDBData   aDBData;                                // database descriptor
     ::com::sun::star::uno::Sequence <sal_Int8 > aRedlinePasswd;
String sTOIAutoMarkURL; // ::com::sun::star::util::URL of table of index AutoMark file - SvStringsDtor aPatternNms; // Array fuer die Namen der Dokument-Vorlagen 
+    SvStringsDtor aPatternNms;                 // Array for names of document-templates

com::sun::star::uno::Reference<com::sun::star::container::XNameContainer>
         xXForms;                        // container with XForms models
mutable com::sun::star::uno::Reference< com::sun::star::linguistic2::XProofreadingIterator > m_xGCIterator; 
@@ -306,11 +306,11 @@ class SW_DLLPUBLIC SwDoc :
const ::boost::scoped_ptr< ::sw::MetaFieldManager > m_pMetaFieldManager; // ------------------------------------------------------------------- 
-    // die Pointer
-                                //Defaultformate
+    // Pointer
+                                //Default formats.
     SwFrmFmt           *pDfltFrmFmt;
      SwFrmFmt          *pEmptyPageFmt;         // Format for the default empty page
-    SwFrmFmt           *pColumnContFmt;        // Format fuer Spaltencontainer
+    SwFrmFmt           *pColumnContFmt;        // Format for column container
     SwCharFmt          *pDfltCharFmt;
     SwTxtFmtColl       *pDfltTxtFmtColl;       // Defaultformatcollections
     SwGrfFmtColl       *pDfltGrfFmtColl;
@@ -319,51 +319,49 @@ class SW_DLLPUBLIC SwDoc :
     SwCharFmts         *pCharFmtTbl;
     SwSpzFrmFmts       *pSpzFrmFmtTbl;
     SwSectionFmts      *pSectionFmtTbl;
-    SwFrmFmts          *pTblFrmFmtTbl;         // spz. fuer Tabellen
+    SwFrmFmts          *pTblFrmFmtTbl;         // For tables
     SwTxtFmtColls      *pTxtFmtCollTbl;        // FormatCollections
     SwGrfFmtColls      *pGrfFmtCollTbl;
 -    SwTOXTypes                *pTOXTypes;                     // Verzeichnisse
+    SwTOXTypes         *pTOXTypes;                     // Tables/indices
     SwDefTOXBase_Impl * pDefTOXBases;  // defaults of SwTOXBase's
 -    SwRootFrm         *pLayout;                       // Rootframe des spezifischen Layouts.
+    SwRootFrm          *pLayout;                       // Rootframe of the specific layout.
     SdrModel           *pDrawModel;            // StarView Drawing
      SwUndos           *pUndos;                        // Undo/Redo History
 -    SwDocUpdtFld      *pUpdtFlds;                     // Struktur zum Field-Update
-    SwFldTypes         *pFldTypes;                     // Feldtypen
-    SwNewDBMgr                 *pNewDBMgr;                     // Pointer auf den neuen DBMgr fuer
-                                        // Evaluierung der DB-Fields
+    SwDocUpdtFld       *pUpdtFlds;                     // Struct for updating fields
+    SwFldTypes         *pFldTypes;
+    SwNewDBMgr                 *pNewDBMgr;                     // Pointer to the new DBMgr for
+                                        // evaluation of DB-fields.
      VirtualDevice   *pVirDev;           // can be used for formatting
     SfxPrinter      *pPrt;              // can be used for formatting
     SwPrintData     *pPrtData;          // Print configuration
 -    SwDoc                     *pGlossaryDoc;          // Pointer auf das Glossary-Dokument. Dieses
+    SwDoc                      *pGlossaryDoc;          // Pointer to glossary-document.
      SwNumRule         *pOutlineRule;
     SwFtnInfo          *pFtnInfo;
     SwEndNoteInfo      *pEndNoteInfo;
     SwLineNumberInfo*pLineNumberInfo;
     SwFtnIdxs          *pFtnIdxs;
-    SwDocStat          *pDocStat;                      // Statistic Informationen
-    SvxMacroTableDtor *pMacroTable;    // Tabelle der dokumentglobalen Macros
+    SwDocStat          *pDocStat;              // Statistics information.
+    SvxMacroTableDtor *pMacroTable;     // table of macros.
 -    SwDocShell                *pDocShell;                     // Ptr auf die SfxDocShell vom Doc
- SfxObjectShellRef* pDocShRef; // fuers Kopieren von OLE-Nodes (wenn keine - // DocShell gesetzt ist, muss dieser 
-                                        // Ref-Pointer gesetzt sein!!!!)
- sfx2::LinkManager *pLinkMgr; // Liste von Verknuepften (Grafiken/DDE/OLE) 
+    SwDocShell         *pDocShell;         // Ptr to SfxDocShell of Doc.
+ SfxObjectShellRef* pDocShRef; // For copying OLE-nodes. (If no DocShell + // is set, this Ref-Pointer must be set!!). - SwAutoCorrExceptWord *pACEWord; // fuer die automatische Uebernahme von - // autokorrigierten Woertern, die "zurueck" 
-                                        // verbessert werden
-    SwURLStateChanged *pURLStateChgd;  // SfxClient fuer Aenderungen in der
-                                        // INetHistory
- SvNumberFormatter *pNumberFormatter; // NumFormatter fuer die Tabellen/Felder + sfx2::LinkManager *pLinkMgr; // List of linked stuff (graphics/DDE/OLE). - mutable SwNumRuleTbl *pNumRuleTbl; // Liste aller benannten NumRules 
+    SwAutoCorrExceptWord *pACEWord;            // For the automated takeover of
+ // auto-corrected words that are "re-corrected". + SwURLStateChanged *pURLStateChgd; // SfxClient for changes in INetHistory 
+    SvNumberFormatter *pNumberFormatter;// NumFormatter for tables / fields
+
+    mutable SwNumRuleTbl    *pNumRuleTbl;   // List of all named NumRules.
      // Hash map to find numrules by name
     mutable std::hash_map<String, SwNumRule *, StringHash> maNumRuleMap;
@@ -374,13 +372,12 @@ class SW_DLLPUBLIC SwDoc :
     // relation between list style and its default list
     tHashMapForLists maListStyleLists;
 -    SwRedlineTbl      *pRedlineTbl;                   // Liste aller Redlines
-    String                     *pAutoFmtRedlnComment;  // Kommentar fuer Redlines, die
- // uebers Autoformat eingefuegt werden 
+    SwRedlineTbl       *pRedlineTbl;                   // List of all Redlines.
+ String *pAutoFmtRedlnComment; // Comment for Redlines inserted via AutoFormat. 
+
     SwUnoCrsrTbl       *pUnoCrsrTbl;
 -    SwPagePreViewPrtData *pPgPViewPrtData;            // Einzuege/Abstaende fuers
-                                        // Drucken der Seitenansicht
+ SwPagePreViewPrtData *pPgPViewPrtData; // Indenting / spacing for printing of page view. 
     SwPaM                      *pExtInputRing;
SwLayouter *pLayouter; // ::com::sun::star::frame::Controller for complex layout formatting 
@@ -416,28 +413,29 @@ private:
// ------------------------------------------------------------------- 
     // other
-    sal_uInt16         nUndoPos;                       // akt. Undo-InsertPosition (for Redo!)
-    sal_uInt16 nUndoSavePos;           // Position im Undo-Array, ab der das Doc
-                                    // nicht als modifiziert gilt
-    sal_uInt16         nUndoCnt;                       // Anzahl von Undo Aktionen
-    sal_uInt16         nUndoSttEnd;            // != 0 -> innerhalb einer Klammerung
-
- sal_uInt16 nAutoFmtRedlnCommentNo; // SeqNo fuers UI-seitige zusammenfassen - // von AutoFmt-Redlines. Wird vom SwAutoFmt 
-                                    // verwaltet!
-    sal_uInt16 nLinkUpdMode;           // UpdateMode fuer Links
- SwFldUpdateFlags eFldUpdMode; // Mode fuer Felder/Charts automatisch aktualisieren 
-    RedlineMode_t eRedlineMode;                // aktueller Redline Modus
+    sal_uInt16         nUndoPos;                       // act. Undo-InsertPosition (for Redo!).
+    sal_uInt16 nUndoSavePos;           // Position in Undo-Array, at which document.
+                                    // is regarded as not modified.
+
+    sal_uInt16         nUndoCnt;                       // Count of Undo Actions.
+    sal_uInt16         nUndoSttEnd;            // != 0 -> within parentheses.
+
+ sal_uInt16 nAutoFmtRedlnCommentNo; // SeqNo for conjoining of AutoFmt-Redlines. 
+                                        // by the UI. Managed by SwAutoFmt!
+
+    sal_uInt16 nLinkUpdMode;               // UpdateMode for links.
+ SwFldUpdateFlags eFldUpdMode; // Automatically Update Mode for fields/charts. 
+    RedlineMode_t eRedlineMode;                    // Current Redline Mode.
SwCharCompressType eChrCmprType; // for ASIAN: compress punctuation/kana 
      sal_Int32   mReferenceCount;
     sal_Int32   mIdleBlockCount;
-    sal_Int8   nLockExpFld;            // Wenn != 0 hat UpdateExpFlds() keine Wirkung
+    sal_Int8   nLockExpFld;            // If != 0 UpdateExpFlds() has no effect!
      /* Draw Model Layer IDs
-     * LayerIds, Heaven == ueber dem Dokument
-     * Hell   == unter dem Dokument
-     * Controls == ganz oben
+     * LayerIds, Heaven == above document
+     *           Hell   == below document
+     *         Controls == at the very top
      */
     SdrLayerID  nHeaven;
     SdrLayerID  nHell;
@@ -446,47 +444,47 @@ private:
     SdrLayerID  nInvisibleHell;
     SdrLayerID  nInvisibleControls;
- bool mbGlossDoc : 1; //TRUE: ist ein Textbaustein Dokument 
-    bool mbModified              : 1;    //TRUE: Dokument ist veraendert
-    bool mbDtor                  : 1;    //TRUE: ist im SwDoc DTOR
-                                         //      leider auch temporaer von
- // SwSwgReader::InLayout(), wenn fehlerhafte - // Frames geloescht werden muessen 
-    bool mbUndo                  : 1;    // TRUE: Undo eingeschaltet
-    bool mbGroupUndo             : 1;    // TRUE: Undos werden gruppiert
- bool mbPageNums : 1; // TRUE: es gibt virtuelle Seitennummern 
-    bool mbLoaded                : 1;    // TRUE: ein geladenes Doc
-    bool mbUpdateExpFld          : 1;    // TRUE: Expression-Felder updaten
-    bool mbNewDoc                : 1;    // TRUE: neues Doc
-    bool mbNewFldLst             : 1;    // TRUE: Felder-Liste neu aufbauen
- bool mbCopyIsMove : 1; // TRUE: Copy ist ein verstecktes Move - bool mbNoDrawUndoObj : 1; // TRUE: keine DrawUndoObjecte speichern - bool mbVisibleLinks : 1; // TRUE: Links werden sichtbar eingefuegt - bool mbBrowseMode : 1; // TRUE: Dokument im BrowseModus anzeigen - bool mbInReading : 1; // TRUE: Dokument wird gerade gelesen - bool mbInXMLImport : 1; // TRUE: During xml import, attribute portion building is not necessary - bool mbUpdateTOX : 1; // TRUE: nach Dokument laden die TOX Updaten - bool mbInLoadAsynchron : 1; // TRUE: Dokument wird gerade asynchron geladen 
-    bool mbHTMLMode              : 1;    // TRUE: Dokument ist im HTMLMode
- bool mbInCallModified : 1; // TRUE: im Set/Reset-Modified Link 
-    bool mbIsGlobalDoc           : 1;    // TRUE: es ist ein GlobalDokument
- bool mbGlblDocSaveLinks : 1; // TRUE: im GlobalDoc. gelinkte Sect. mit speichern - bool mbIsLabelDoc : 1; // TRUE: es ist ein Etiketten-Dokument - bool mbIsAutoFmtRedline : 1; // TRUE: die Redlines werden vom Autoformat aufgezeichnet - bool mbOLEPrtNotifyPending : 1; // TRUE: Printer ist geaendert und beim - // Erzeugen der ::com::sun::star::sdbcx::View ist eine Benachrichtigung - // der OLE-Objekte PrtOLENotify() notwendig. - bool mbAllOLENotify : 1; // True: Benachrichtigung aller Objekte ist notwendig - bool mbIsRedlineMove : 1; // True: die Redlines werden in/aus der Section verschoben 
+    bool mbGlossDoc              : 1;    //TRUE: glossary document.
+    bool mbModified              : 1;    //TRUE: document has changed.
+    bool mbDtor                  : 1;    //TRUE: is in SwDoc DTOR.
+ // and unfortunately temorarily also in + // SwSwgReader::InLayout() when flawed 
+                                         //      frames need deletion.
+    bool mbUndo                  : 1;    // TRUE: Undo switched on.
+    bool mbGroupUndo             : 1;    // TRUE: Undos are grouped.
+ bool mbPageNums : 1; // TRUE: There are virtual page numbers. 
+    bool mbLoaded                : 1;    // TRUE: Doc loaded.
+    bool mbUpdateExpFld          : 1;    // TRUE: Update expression fields.
+    bool mbNewDoc                : 1;    // TRUE: new Doc.
+    bool mbNewFldLst             : 1;    // TRUE: Rebuild field-list.
+    bool mbCopyIsMove            : 1;    // TRUE: Copy is a hidden Move.
+ bool mbNoDrawUndoObj : 1; // TRUE: Do not save DrawUndoObjects. + bool mbVisibleLinks : 1; // TRUE: Links are inserted visibly. + bool mbBrowseMode : 1; // TRUE: Show document in browser mode. + bool mbInReading : 1; // TRUE: Document is in the process of being read. + bool mbInXMLImport : 1; // TRUE: During xml import, attribute portion building is not necessary. + bool mbUpdateTOX : 1; // TRUE: After loading document, update TOX. + bool mbInLoadAsynchron : 1; // TRUE: Document is in the process of being loaded asynchronously. 
+    bool mbHTMLMode              : 1;    // TRUE: Document is in HTMLMode.
+ bool mbInCallModified : 1; // TRUE: in Set/Reset-Modified link. 
+    bool mbIsGlobalDoc           : 1;    // TRUE: It's a global document.
+ bool mbGlblDocSaveLinks : 1; // TRUE: Save sections linked in global document. 
+    bool mbIsLabelDoc            : 1;    // TRUE: It's a label document.
+ bool mbIsAutoFmtRedline : 1; // TRUE: Redlines are recorded by Autoformat. + bool mbOLEPrtNotifyPending : 1; // TRUE: Printer has changed. At creation of + // ::com::sun::star::sdbcx::View + // notification of OLE-Objects PrtOLENotify() is required. + bool mbAllOLENotify : 1; // True: Notification of all objects is required. + bool mbIsRedlineMove : 1; // True: Redlines are moved into to / out of the section. bool mbInsOnlyTxtGlssry : 1; // True: insert 'only text' glossary into doc bool mbContains_MSVBasic : 1; // True: MS-VBasic exist is in our storage 
-    bool mbPurgeOLE              : 1;    // TRUE: Purge OLE-Objects
- bool mbKernAsianPunctuation : 1; // TRUE: kerning also for ASIAN punctuation - bool mbReadlineChecked : 1; // TRUE: if the query was already shown 
+    bool mbPurgeOLE              : 1;    // TRUE: Purge OLE-Objects.
+ bool mbKernAsianPunctuation : 1; // TRUE: kerning also for ASIAN punctuation. + bool mbReadlineChecked : 1; // TRUE: if the query was already shown. 
     bool mbLinksUpdated          : 1;    // #i38810#
// flag indicating, that the links have been updated. - bool mbClipBoard : 1; // true: this document represents the clipboard - bool mbColumnSelection : 1; // true: this content has bee created by a column selection + bool mbClipBoard : 1; // TRUE: this document represents the clipboard + bool mbColumnSelection : 1; // TRUE: this content has bee created by a column selection 
                                          //       (clipboard docs only)
  #if OSL_DEBUG_LEVEL > 1
@@ -573,7 +571,10 @@ private:
     bool mbUseFormerObjectPos               : 1;    // #i11860#
     bool mbUseFormerTextWrapping            : 1;
     bool mbConsiderWrapOnObjPos             : 1;    // #i28701#
- // TRUE: object positioning algorithm has consider the wrapping style of // the floating screen objects as given by its attribute 'WrapInfluenceOnObjPos' + // TRUE: object positioning algorithm has + // to consider the wrapping style of + // floating screen objects as given by its + // attribute 'WrapInfluenceOnObjPos'. 
      // non-ui-compatibility flags:
     bool mbOldNumbering                             : 1;
@@ -599,23 +600,24 @@ private:
     // COMPATIBILITY FLAGS END
     //
- sal_Bool mbStartIdleTimer ; // idle timer mode start/stop + sal_Bool mbStartIdleTimer; // idle timer mode start/stop - static SwAutoCompleteWord *pACmpltWords; // Liste aller Worte fuers AutoComplete - static sal_uInt16 nUndoActions; // anzahl von Undo ::com::sun::star::chaos::Action + static SwAutoCompleteWord *pACmpltWords; // List of all words for AutoComplete + static sal_uInt16 nUndoActions; // Count of Undo ::com::sun::star::chaos::Action 
 -    //---------------- private Methods ------------------------------
+    //---------------- private methods ------------------------------
     void checkRedlining(RedlineMode_t& _rReadlineMode);
- sal_Bool DelUndoObj( sal_uInt16 nEnde ); // loescht alle UndoObjecte vom Anfang 
-                                        // bis zum angegebenen Ende
+ sal_Bool DelUndoObj( sal_uInt16 nEnde ); // Deletes all UndoObjects from the beginning + // up to the indicated point. 
+
     DECL_LINK( AddDrawUndo, SdrUndoAction * );
                                         // DrawModel
-    void DrawNotifyUndoHdl();  // wegen CLOOKs
+    void DrawNotifyUndoHdl();          // Because of CLOOKs
 -        // nur fuer den internen Gebrauch deshalb privat.
-        // Kopieren eines Bereiches im oder in ein anderes Dokument !
-        // Die Position darf nicht im Bereich liegen !!
+    // Only for internal use and therefore private.
+    // Copy a range within the same or to another document.
+    // Position may not lie within range!
bool CopyImpl( SwPaM&, SwPosition&, const bool MakeNewFrms /*= true */, 
             const bool bCopyAll, SwPaM *const pCpyRng /*= 0*/ ) const;
 @@ -647,18 +649,18 @@ private:
      VirtualDevice& CreateVirtualDevice_() const;
     SfxPrinter& CreatePrinter_() const;
-    void               PrtDataChanged();       //Printer oder JobSetup geandert, es muss
- //fuer entsprechende Invalidierungen und 
-                                    //Benachrichtigungen gesorgt werden.
+    void               PrtDataChanged();       // Printer or JobSetup altered.
+ // Care has to be taken of the necessary 
+                                    // invalidations and notifications.
- // gcc: aFtnInfo::CopyCtor ist private, also muessen wir uns auch schuetzen + // gcc: aFtnInfo::CopyCtor is private, therefore we too have to protect ourselves. 
     SwDoc( const SwDoc &);
 -    // fuer Felder:
-    void _InitFieldTypes();    // wird vom CTOR gerufen!!
+    // For fields:
+    void _InitFieldTypes();    // Called by CTOR!!
     void _MakeFldList( int eMode );
 -    // Datenbankfelder:
+    // Database fields:
     void UpdateDBNumFlds( SwDBNameInfField& rDBFld, SwCalc& rCalc );
     void AddUsedDBToList( SvStringsDtor& rDBNameList,
                           const SvStringsDtor& rUsedDBNames );
@@ -678,21 +680,21 @@ private:
      sal_Bool _UnProtectTblCells( SwTable& rTbl );
 -    // erzeuge Anhand der vorgebenen Collection Teildokumente
-    // falls keine angegeben ist, nehme die Kapitelvorlage der 1. Ebene
+    // Create sub-documents according to the given collection.
+    // If no collection is given, take chapter style of the 1st level.
     sal_Bool SplitDoc( sal_uInt16 eDocType, const String& rPath,
                         const SwTxtFmtColl* pSplitColl );
sal_Bool SplitDoc( sal_uInt16 eDocType, const String& rPath, int nOutlineLevel = 0 ); - // Charts der angegebenen Tabelle updaten 
+    // Update charts of given table.
     void _UpdateCharts( const SwTable& rTbl, ViewShell& rVSh ) const;
      BOOL _SelectNextRubyChars( SwPaM& rPam, SwRubyListEntry& rRubyEntry,
                                 USHORT nMode );
 -    // unser eigener 'IdlTimer' ruft folgende Methode
+    // Our own 'IdleTimer' calls the following method
     DECL_LINK( DoIdleJobs, Timer * );
-    // der CharTimer ruft diese Methode
+    // CharTimer calls this method.
     DECL_LINK( DoUpdateAllCharts, Timer * );
     DECL_LINK( DoUpdateModifiedOLE, Timer * );
 @@ -822,7 +824,7 @@ public:
     virtual void setUndoNoModifiedPosition( SwUndoNoModifiedPosition );
     virtual SwUndoNoModifiedPosition getUndoNoModifiedPosition() const;
- /** abfragen/setzen der Anzahl von wiederherstellbaren Undo-Actions */ 
+    /** Query / set count of Undo-Actions. */
     static sal_uInt16 GetUndoActionCount();
     static void SetUndoActionCount(sal_uInt16 nNew);
 @@ -1054,22 +1056,22 @@ public:
     void SetXMLExport( bool bFlag )     { mbXMLExport = bFlag; }
 #endif
 -    // liefert zu allen fliegenden Rahmen die Position im Dokument.
-    // Wird ein Pam-Pointer uebergeben, muessen die absatzgebundenen
- // FlyFrames von der ::com::sun::star::awt::Selection vollstaendig umschlossen sein 
+    // Returns positions of all FlyFrames in the document.
+    // If a Pam-Pointer is passed the FlyFrames attached to paragraphes
+ // have to be surrounded completely by ::com::sun::star::awt::Selection. 
     // ( Start < Pos < End ) !!!
-    // (wird fuer die Writer benoetigt)
+    // (Required for Writers.)
     void GetAllFlyFmts( SwPosFlyFrms& rPosFlyFmts, const SwPaM* = 0,
                         sal_Bool bDrawAlso = sal_False ) const;
 -    // wegen swrtf.cxx und define private public, jetzt hier
+    // Because swrtf.cxx and define private public here now.
SwFlyFrmFmt *MakeFlyFrmFmt (const String &rFmtName, SwFrmFmt *pDerivedFrom); SwDrawFrmFmt *MakeDrawFrmFmt(const String &rFmtName, SwFrmFmt *pDerivedFrom); 
 -    // fuer Flys muss jetzt diese Schnittstelle benutzt
-    // werden. pAnchorPos muss gesetzt sein, wenn keine
- // Seitenbindung vorliegt UND der ::com::sun::star::chaos::Anchor nicht schon 
-    // im FlySet/FrmFmt mit gueltiger CntntPos gesetzt ist
+    // From now on this interface has to be used for Flys.
+    // pAnchorPos must be set, if they are not attached to pages AND
+    // ::com::sun::star::chaos::Anchor is not already set at valid CntntPos
+    // in FlySet/FrmFmt.
     /* new parameter bCalledFromShell
         TRUE: An existing adjust item at pAnchorPos is propagated to
@@ -1134,13 +1136,10 @@ public:
     // count words in pam
     void CountWords( const SwPaM& rPaM, SwDocStat& rStat ) const;
 -    /** ???
-    */
-    // Textbaustein Dokument?
+    // Glossary Document
     void SetGlossDoc( bool bGlssDc = true ) { mbGlossDoc = bGlssDc; }
     bool IsInsOnlyTextGlossary() const      { return mbInsOnlyTxtGlssry; }
 -    // Abstakt fuellen
void Summary( SwDoc* pExtDoc, sal_uInt8 nLevel, sal_uInt8 nPara, sal_Bool bImpress ); 
      void ChangeAuthorityData(const SwAuthEntry* pNewData);
@@ -1151,16 +1150,16 @@ public:
                             const Point* pPt = 0 ) const;
     sal_Bool IsInVerticalText( const SwPosition& rPos,
                                const Point* pPt = 0 ) const;
-    /** Database ???
-    */
 -    /*        Datenbank &&  DB-Manager */
+    /** Database  and DB-Manager
+    */
     void SetNewDBMgr( SwNewDBMgr* pNewMgr )            { pNewDBMgr = pNewMgr; }
     SwNewDBMgr* GetNewDBMgr() const                    { return pNewDBMgr; }
     void ChangeDBFields( const SvStringsDtor& rOldNames,
                         const String& rNewName );
     void SetInitDBFields(sal_Bool b);
-    // Von Feldern verwendete Datenbanken herausfinden
+
+    // Find out which databases are used by fields.
     void GetAllUsedDB( SvStringsDtor& rDBNameList,
                        const SvStringsDtor* pAllDBNames = 0 );
 @@ -1181,13 +1180,12 @@ public:
     void GetGrfNms( const SwFlyFrmFmt& rFmt, String* pGrfName,
                     String* pFltName ) const;
- // setze bei allen Flys ohne Namen einen gueltigen (Wird von den Readern 
-    // nach dem Einlesen gerufen )
+ // Set a valid name for all Flys that have none (Called by Readers after reading). 
     void SetAllUniqueFlyNames();
 -        //Zuruecksetzen der Attribute; es werden alle TxtHints und bei
- //vollstaendiger Selektion harte Formatierung (AUTO-Formate) entfernt - // introduce new optional parameter <bSendDataChangedEvents> in order to + // Reset attributes. All TxtHints and (if completely selected) all hard- 
+    // formated stuff (auto-formats) are removed.
+ // Introduce new optional parameter <bSendDataChangedEvents> in order to // control, if the side effect "send data changed events" is triggered or not. 
     void ResetAttrs( const SwPaM &rRg,
                      sal_Bool bTxtAttr = sal_True,
@@ -1195,8 +1193,8 @@ public:
                      const bool bSendDataChangedEvents = true );
     void RstTxtAttrs(const SwPaM &rRg, BOOL bInclRefToxMark = FALSE );
 -        // Setze das Attribut im angegebenen Format. Ist Undo aktiv, wird
-        // das alte in die Undo-History aufgenommen
+    // Set attribute in given format.
+    // If Undo is activated, the old one is listed in Undo-History.
     void SetAttr( const SfxPoolItem&, SwFmt& );
     void SetAttr( const SfxItemSet&, SwFmt& );
 @@ -1204,22 +1202,23 @@ public:
     void ResetAttrAtFormat( const USHORT nWhichId,
                             SwFmt& rChangedFormat );
- // Setze das Attribut als neues default Attribut in diesem Dokument. 
-        // Ist Undo aktiv, wird das alte in die Undo-History aufgenommen
+    // Set attribute as new default attribute in current document.
+    // If Undo is activated, the old one is listed in Undo-History.
     void SetDefault( const SfxPoolItem& );
     void SetDefault( const SfxItemSet& );
 -    // Erfrage das Default Attribut in diesem Dokument.
+    // Query default attribute in this document.
     const SfxPoolItem& GetDefault( sal_uInt16 nFmtHint ) const;
-    // TextAttribute nicht mehr aufspannen lassen
+
+    // Do not expand text attributes.
sal_Bool DontExpandFmt( const SwPosition& rPos, sal_Bool bFlag = sal_True ); 
 -    /* Formate */
+    /* Formats */
     const SwFrmFmts* GetFrmFmts() const        { return pFrmFmtTbl; }
           SwFrmFmts* GetFrmFmts()                      { return pFrmFmtTbl; }
     const SwCharFmts* GetCharFmts() const      { return pCharFmtTbl;}
 -    /* LayoutFormate (Rahmen, DrawObjecte), mal const mal nicht */
+ /* LayoutFormats (frames, DrawObjects), sometimes const sometimes not */ 
     const SwSpzFrmFmts* GetSpzFrmFmts() const  { return pSpzFrmFmtTbl; }
           SwSpzFrmFmts* GetSpzFrmFmts()                { return pSpzFrmFmtTbl; }
 @@ -1252,7 +1251,7 @@ public:
     SwCharFmt* FindCharFmtByName( const String& rName ) const
{ return (SwCharFmt*)FindFmtByName( (SvPtrarr&)*pCharFmtTbl, rName ); } 
 -    /* Formatcollections (Vorlagen) */
+    /* Formatcollections (styles) */
     // TXT
const SwTxtFmtColl* GetDfltTxtFmtColl() const { return pDfltTxtFmtColl; } 
     const SwTxtFmtColls *GetTxtFmtColls() const { return pTxtFmtCollTbl; }
@@ -1280,7 +1279,7 @@ public:
      void ChkCondColls();
 -        // GRF
+    // GRF
const SwGrfFmtColl* GetDfltGrfFmtColl() const { return pDfltGrfFmtColl; } const SwGrfFmtColls *GetGrfFmtColls() const { return pGrfFmtCollTbl; } 
     SwGrfFmtColl *MakeGrfFmtColl(const String &rFmtName,
@@ -1288,7 +1287,7 @@ public:
     SwGrfFmtColl* FindGrfFmtCollByName( const String& rName ) const
{ return (SwGrfFmtColl*)FindFmtByName( (SvPtrarr&)*pGrfFmtCollTbl, rName ); } 
 -        // Tabellen-Formate
+    // Table formating
     const SwFrmFmts* GetTblFrmFmts() const     { return pTblFrmFmtTbl; }
           SwFrmFmts* GetTblFrmFmts()           { return pTblFrmFmtTbl; }
     sal_uInt16 GetTblFrmFmtCount( sal_Bool bUsed ) const;
@@ -1297,33 +1296,34 @@ public:
     void           DelTblFrmFmt( SwTableFmt* pFmt );
SwTableFmt* FindTblFmtByName( const String& rName, sal_Bool bAll = sal_False ) const; 
 -    //Rahmenzugriff
-    //iterieren ueber Flys - fuer Basic-Collections
+    //Access to frames.
+    //Iterate over Flys - forr Basic-Collections.
     sal_uInt16 GetFlyCount( FlyCntType eType = FLYCNTTYPE_ALL) const;
SwFrmFmt* GetFlyNum(sal_uInt16 nIdx, FlyCntType eType = FLYCNTTYPE_ALL); 
 -    // kopiere die Formate in die eigenen Arrays und returne diese
+    // Copy formats in own arrays and return them.
     SwFrmFmt  *CopyFrmFmt ( const SwFrmFmt& );
     SwCharFmt *CopyCharFmt( const SwCharFmt& );
     SwTxtFmtColl* CopyTxtColl( const SwTxtFmtColl& rColl );
     SwGrfFmtColl* CopyGrfColl( const SwGrfFmtColl& rColl );
 -        // ersetze alle Formate mit denen aus rSource
+    // Replace all formats with those from rSource.
     void ReplaceStyles( SwDoc& rSource );
- // erfrage ob die Absatz-/Zeichen-/Rahmen-/Seiten - Vorlage benutzt wird 
+    // Query if style (paragraph- / character- / frame- / page-) is used.
     sal_Bool IsUsed( const SwModify& ) const;
     sal_Bool IsUsed( const SwNumRule& ) const;
 -        // setze den Namen der neu geladenen Dokument-Vorlage
+    // Set name of newly loaded document template.
     sal_uInt16 SetDocPattern( const String& rPatternName );
-        // gebe den Dok-VorlagenNamen zurueck. !!! Kann auch 0 sein !!!
+
+    // Return name of document template. Can be 0!
String* GetDocPattern( sal_uInt16 nPos ) const { return aPatternNms[nPos]; } 
 -        // Loesche alle nicht referenzierten FeldTypen
-    void GCFieldTypes();                               // impl. in docfld.cxx
+    // Delete all unreferenced field types.
+    void GCFieldTypes();       // impl. in docfld.cxx
 -        // akt. Dokument mit Textbausteindokument verbinden/erfragen
+    // Query / connect current document with glossary document.
     void SetGlossaryDoc( SwDoc* pDoc ) { pGlossaryDoc = pDoc; }
      // travel over PaM Ring
@@ -1342,27 +1342,28 @@ public:
     sal_uInt16 GetPageCount() const;
const Size GetPageSize( sal_uInt16 nPageNum, bool bSkipEmptyPages ) const; 
 -        //PageDescriptor-Schnittstelle
+    // PageDescriptor interface.
     sal_uInt16 GetPageDescCnt() const { return aPageDescs.Count(); }
const SwPageDesc& GetPageDesc( const sal_uInt16 i ) const { return *aPageDescs[i]; } 
     SwPageDesc* FindPageDescByName( const String& rName,
                                     sal_uInt16* pPos = 0 ) const;
- // kopiere den gesamten PageDesc - ueber Dokumentgrenzen und "tief"! - // optional kann das kopieren der PoolFmtId, -HlpId verhindert werden 
+    // Copy the complete PageDesc - beyond document and "deep"!
+    // Optionally copying of PoolFmtId, -HlpId can be prevented.
     void CopyPageDesc( const SwPageDesc& rSrcDesc, SwPageDesc& rDstDesc,
                         sal_Bool bCopyPoolIds = sal_True );
 -        // kopiere die Kopzeile (mit dem Inhalt!) aus dem SrcFmt
-        // ins DestFmt ( auch ueber Doc grenzen hinaus!)
+    // Copy header (with contents) from SrcFmt to DestFmt
+    // (can also be copied into other document).
     void CopyHeader( const SwFrmFmt& rSrcFmt, SwFrmFmt& rDestFmt )
         { CopyPageDescHeaderFooterImpl( true, rSrcFmt, rDestFmt ); }
-        // kopiere die Fusszeile (mit dem Inhalt!) aus dem SrcFmt
-        // ins DestFmt ( auch ueber Doc grenzen hinaus!)
+
+    // Copy footer (with contents) from SrcFmt to DestFmt.
+    // (can also be copied into other document).
     void CopyFooter( const SwFrmFmt& rSrcFmt, SwFrmFmt& rDestFmt )
         { CopyPageDescHeaderFooterImpl( false, rSrcFmt, rDestFmt ); }
 -        //fuer Reader
+    //For Reader.
      SwPageDesc * GetPageDesc( const String & rName );
SwPageDesc& _GetPageDesc( sal_uInt16 i ) const { return *aPageDescs[i]; } 
@@ -1383,14 +1384,14 @@ public:
     // correct this.
     void CheckDefaultPageFmt();
 -        // Methoden fuer die Verzeichnisse:
-        // - Verzeichnismarke einfuegen loeschen travel
+    // Methods for tables/indices.
+
     sal_uInt16 GetCurTOXMark( const SwPosition& rPos, SwTOXMarks& ) const;
     void DeleteTOXMark( const SwTOXMark* pTOXMark );
     const SwTOXMark& GotoTOXMark( const SwTOXMark& rCurTOXMark,
                                 SwTOXSearch eDir, sal_Bool bInReadOnly );
 -        // - Verzeichnis einfuegen, und bei Bedarf erneuern
+    //Insert/Renew table/indes.
     const SwTOXBaseSection* InsertTableOf( const SwPosition& rPos,
                                             const SwTOXBase& rTOX,
                                             const SfxItemSet* pSet = 0,
@@ -1408,7 +1409,7 @@ public:
sal_Bool SetTOXBaseName(const SwTOXBase& rTOXBase, const String& rName); void SetTOXBaseProtection(const SwTOXBase& rTOXBase, sal_Bool bProtect); 
 -    // nach einlesen einer Datei alle Verzeichnisse updaten
+    // After reading file update all tables/indices.
     void SetUpdateTOX( bool bFlag = true )     { mbUpdateTOX = bFlag; }
     bool IsUpdateTOX() const                   { return mbUpdateTOX; }
 @@ -1429,7 +1430,7 @@ public:
     bool IsInXMLImport() const { return mbInXMLImport; }
     void SetInXMLImport( bool bNew ) { mbInXMLImport = bNew; }
 -    // - Verzeichnis-Typen verwalten
+    // Manage types of tables/indices.
     sal_uInt16 GetTOXTypeCount( TOXTypes eTyp ) const;
     const SwTOXType* GetTOXType( TOXTypes eTyp, sal_uInt16 nId ) const;
     sal_Bool DeleteTOXType( TOXTypes eTyp, sal_uInt16 nId );
@@ -1439,31 +1440,34 @@ public:
const SwTOXBase* GetDefaultTOXBase( TOXTypes eTyp, sal_Bool bCreate = sal_False ); 
     void                               SetDefaultTOXBase(const SwTOXBase& rBase);
 -    // - Schluessel fuer die Indexverwaltung
+    // Key for management of index.
     sal_uInt16 GetTOIKeys( SwTOIKeyType eTyp, SvStringsSort& rArr ) const;
 -    // Sortieren Tabellen Text
+    // Sort table text.
     sal_Bool SortTbl(const SwSelBoxes& rBoxes, const SwSortOptions&);
     sal_Bool SortText(const SwPaM&, const SwSortOptions&);
 -        // korrigiere die im Dokument angemeldeten SwPosition-Objecte,
- // wie z.B. die ::com::sun::star::text::Bookmarks oder die Verzeichnisse. 
-        // ist bMoveCrsr gesetzt, verschiebe auch die Crsr
+    // Correct the SwPosition-Objects that are registered with the document
+    // e. g. ::com::sun::star::text::Bookmarks or tables/indices.
+    // If bMoveCrsr is set move Crsr too.
 -        // Setzt alles in rOldNode auf rNewPos + Offset
+    // Set everything in rOldNode on rNewPos + Offset.
     void CorrAbs( const SwNodeIndex& rOldNode, const SwPosition& rNewPos,
const xub_StrLen nOffset = 0, sal_Bool bMoveCrsr = sal_False ); 
-        // Setzt alles im Bereich von [rStartNode, rEndNode] nach rNewPos
+
+    // Set everything in the range of [rStartNode, rEndNode] to rNewPos.
void CorrAbs( const SwNodeIndex& rStartNode, const SwNodeIndex& rEndNode, const SwPosition& rNewPos, sal_Bool bMoveCrsr = sal_False ); 
-        // Setzt alles im Bereich von rRange nach rNewPos
+
+    // Set everything in this range from rRange to rNewPos.
     void CorrAbs( const SwPaM& rRange, const SwPosition& rNewPos,
                     sal_Bool bMoveCrsr = sal_False );
-        // Setzt alles in rOldNode auf relative Pos
+
+    // Set everything in rOldNode to relative Pos.
     void CorrRel( const SwNodeIndex& rOldNode, const SwPosition& rNewPos,
const xub_StrLen nOffset = 0, sal_Bool bMoveCrsr = sal_False ); 
 -        // GliederungsRegeln erfragen / setzen
+    // Query / set rules for Outline.
     inline SwNumRule* GetOutlineNumRule() const
     {
         return pOutlineRule;
@@ -1471,16 +1475,15 @@ public:
     void SetOutlineNumRule( const SwNumRule& rRule );
     void PropagateOutlineRule();
 -    // Gliederung - hoch-/runterstufen
+    // Outline - promote / demote.
     sal_Bool OutlineUpDown( const SwPaM& rPam, short nOffset = 1 );
-    // Gliederung - hoch-/runtermoven
+
+    // Ountline - move up / move down.
     sal_Bool MoveOutlinePara( const SwPaM& rPam, short nOffset = 1);
-        // zu diesem Gliederungspunkt
+
     sal_Bool GotoOutline( SwPosition& rPos, const String& rName ) const;
- // die Aenderungen an den Gliederungsvorlagen in die OutlineRule uebernehmen 
 -        // setzt, wenn noch keine Numerierung, sonst wird geaendert
- // arbeitet mit alten und neuen Regeln, nur Differenzen aktualisieren 
+    // Accept changes of outline styles for OUtlineRule.
     // re-use unused 3rd parameter
     // Add optional parameter <bResetIndentAttrs> - default value FALSE.
// If <bResetIndentAttrs> equals true, the indent attributes "before text" 
@@ -1522,18 +1525,18 @@ public:
     sal_uInt16 FindNumRule( const String& rName ) const;
     SwNumRule* FindNumRulePtr( const String& rName ) const;
- // loeschen geht nur, wenn die ::com::sun::star::chaos::Rule niemand benutzt! 
+    // Deletion only possible if ::com::sun::star::chaos::Rule is not used!
sal_Bool RenameNumRule(const String & aOldName, const String & aNewName, 
                            BOOL bBroadcast = FALSE);
     sal_Bool DelNumRule( const String& rName, BOOL bBroadCast = FALSE );
String GetUniqueNumRuleName( const String* pChkStr = 0, sal_Bool bAutoNum = sal_True ) const; 
 -    void UpdateNumRule();     // alle invaliden Updaten
+    void UpdateNumRule();      // Update all invalids.
void ChgNumRuleFmts( const SwNumRule& rRule, const String * pOldName = 0 ); sal_Bool ReplaceNumRule( const SwPosition& rPos, const String& rOldRule, 
                         const String& rNewRule );
 -        // zum naechsten/vorhergehenden Punkt auf gleicher Ebene
+    // Goto next/previous on same level.
     sal_Bool GotoNextNum( SwPosition&, sal_Bool bOverUpper = sal_True,
                         sal_uInt8* pUpper = 0, sal_uInt8* pLower = 0 );
     sal_Bool GotoPrevNum( SwPosition&, sal_Bool bOverUpper = sal_True,
@@ -1570,29 +1573,28 @@ public:
                                     String& sListId,
const bool bInvestigateStartNode = false ); 
 -        // Absaetze ohne Numerierung, aber mit Einzuegen
+    // Paragraphs without numbering but with indents.
     sal_Bool NoNum( const SwPaM& );
-        // Loeschen, Splitten der Aufzaehlungsliste
+
+    // Delete, splitting of numbering list.
     void DelNumRules( const SwPaM& );
      // Invalidates all numrules
     void InvalidateNumRules();
 -        // Hoch-/Runterstufen
     sal_Bool NumUpDown( const SwPaM&, sal_Bool bDown = sal_True );
-        // Bewegt selektierte Absaetze (nicht nur Numerierungen)
-        // entsprechend des Offsets. (negativ: zum Doc-Anf.)
+
+    // Move selected paragraphes (not only numberings)
+    // according to offsets. (if negative: go to doc start).
sal_Bool MoveParagraph( const SwPaM&, long nOffset = 1, sal_Bool bIsOutlMv = sal_False ); 
-        // No-/Numerierung ueber Delete/Backspace ein/abschalten
+
sal_Bool NumOrNoNum( const SwNodeIndex& rIdx, sal_Bool bDel = sal_False); 
-        // Animation der Grafiken stoppen
+
     void StopNumRuleAnimations( OutputDevice* );
 -        // fuege eine neue Tabelle auf der Position rPos ein. (es
-        // wird vor dem Node eingefuegt !!)
-        //     fuer AutoFormat bei der Eingabe: dann muessen die Spalten
- // auf die vordefinierten Breite gesetzt werden. Im Array stehen die 
-        //     Positionen der Spalten!! (nicht deren Breite!)
+    // Insert new table at position rPos (will be inserted before Node!).
+    // For AutoFormat at input: columns have to be set at predefined width.
+    // The array holds the positions of the columns (not their widths).
     /* new parameter bCalledFromShell:
         TRUE: called from shell -> propagate existing adjust item at
@@ -1610,20 +1612,22 @@ public:
                                 BOOL bCalledFromShell = FALSE,
                                 BOOL bNewModel = TRUE );
- // steht der Index in einer Tabelle, dann returne den TableNode sonst 0 
+    // If index is in a table, return TableNode, else 0.
                  SwTableNode* IsIdxInTbl( const SwNodeIndex& rIdx );
     inline const SwTableNode* IsIdxInTbl( const SwNodeIndex& rIdx ) const;
 -        // erzeuge aus dem makierten Bereich eine ausgeglichene Tabelle
+    // Create a balanced table out of the selected range.
const SwTable* TextToTable( const SwInsertTableOptions& rInsTblOpts, // HEADLINE_NO_BORDER, 
                                 const SwPaM& rRange, sal_Unicode cCh,
                                 short eAdjust,
                                 const SwTableAutoFmt* = 0 );
+
     // text to table conversion - API support
const SwTable* TextToTable( const std::vector< std::vector<SwNodeRange> >& rTableNodes ); 
-        // erzeuge aus der Tabelle wieder normalen Text
+
     sal_Bool TableToText( const SwTableNode* pTblNd, sal_Unicode cCh );
-        // einfuegen von Spalten/Zeilen in der Tabelle
+
+    // Create columns / rows in table.
     sal_Bool InsertCol( const SwCursor& rCursor,
                     sal_uInt16 nCnt = 1, sal_Bool bBehind = sal_True );
     sal_Bool InsertCol( const SwSelBoxes& rBoxes,
@@ -1632,21 +1636,24 @@ public:
                     sal_uInt16 nCnt = 1, sal_Bool bBehind = sal_True );
     sal_Bool InsertRow( const SwSelBoxes& rBoxes,
                     sal_uInt16 nCnt = 1, sal_Bool bBehind = sal_True );
-        // loeschen von Spalten/Zeilen in der Tabelle
+
+    // Delete Colums/Rows in table.
sal_Bool DeleteRowCol( const SwSelBoxes& rBoxes, bool bColumn = false ); 
     sal_Bool DeleteRow( const SwCursor& rCursor );
     sal_Bool DeleteCol( const SwCursor& rCursor );
-        // teilen / zusammenfassen von Boxen in der Tabelle
+
+    // Split / concatenate boxes in table.
sal_Bool SplitTbl( const SwSelBoxes& rBoxes, sal_Bool bVert = sal_True, sal_uInt16 nCnt = 1, sal_Bool bSameHeight = sal_False ); 
-        // returnt den enum TableMergeErr
+
+    // Return enum TableMergeErr.
     sal_uInt16 MergeTbl( SwPaM& rPam );
     String GetUniqueTblName() const;
     sal_Bool IsInsTblFormatNum() const;
     sal_Bool IsInsTblChangeNumFormat() const;
     sal_Bool IsInsTblAlignNum() const;
 -        // aus der FEShell wg.. Undo und bModified
+    // From FEShell (for Undo and BModified).
     void GetTabCols( SwTabCols &rFill, const SwCursor* pCrsr,
                     const SwCellFrm* pBoxFrm = 0 ) const;
     void SetTabCols( const SwTabCols &rNew, sal_Bool bCurRowOnly,
@@ -1656,25 +1663,27 @@ public:
void SetTabRows( const SwTabCols &rNew, BOOL bCurColOnly, const SwCursor* pCrsr, 
                      const SwCellFrm* pBoxFrm = 0 );
 -    // Direktzugriff fuer Uno
+    // Direct access for UNO.
void SetTabCols(SwTable& rTab, const SwTabCols &rNew, const SwTabCols &rOld, const SwTableBox *pStart, sal_Bool bCurRowOnly); 
      void SetRowsToRepeat( SwTable &rTable, USHORT nSet );
 -        // AutoFormat fuer die Tabelle/TabellenSelection
+    // AutoFormat for table/table selection.
sal_Bool SetTableAutoFmt( const SwSelBoxes& rBoxes, const SwTableAutoFmt& rNew ); 
-        // Erfrage wie attributiert ist
+
+    // Query attributes.
sal_Bool GetTableAutoFmt( const SwSelBoxes& rBoxes, SwTableAutoFmt& rGet ); 
-        // setze das InsertDB als Tabelle Undo auf:
+
+    // Set up InsertDB as table Undo:
     void AppendUndoForInsertFromDB( const SwPaM& rPam, BOOL bIsTable );
-        // setze die Spalten/Zeilen/ZTellen Breite/Hoehe
+
     sal_Bool SetColRowWidthHeight( SwTableBox& rAktBox, sal_uInt16 eType,
                                 SwTwips nAbsDiff, SwTwips nRelDiff );
     SwTableBoxFmt* MakeTableBoxFmt();
     SwTableLineFmt* MakeTableLineFmt();
- // teste ob die Box ein numerischen Wert darstellt und aender dann ggfs. 
-    // das Format der Box
+
+    // Check if box has numerical valule. Change format of box if required.
     void ChkBoxNumFmt( SwTableBox& rAktBox, sal_Bool bCallUpdate );
void SetTblBoxFormulaAttrs( SwTableBox& rBox, const SfxItemSet& rSet ); 
     void ClearBoxNumAttrs( const SwNodeIndex& rNode );
@@ -1691,34 +1700,35 @@ public:
                               const String* pTblName = 0,
                               sal_Bool* pFullTblProtection = 0 );
 -    // Tabelle an der Position in der GrundLine aufsplitten, sprich eine
-    // neue Tabelle erzeugen.
+    // Split table at baseline position, i.e. create a new table.
     sal_Bool SplitTable( const SwPosition& rPos, sal_uInt16 eMode = 0,
                         sal_Bool bCalcNewSize = sal_False );
- // und die Umkehrung davon. rPos muss in der Tabelle stehen, die bestehen 
-    // bleibt. Das Flag besagt ob die aktuelle mit der davor oder dahinter
-    // stehenden vereint wird.
+
+ // And vice versa: rPos must be in the table that remains. The flag indicates + // whether the current table is merged with the one before or behind it. sal_Bool MergeTable( const SwPosition& rPos, sal_Bool bWithPrev = sal_True, 
                         sal_uInt16 nMode = 0 );
 -    // Charts der angegebenen Tabelle zum Update bewegen
+    // Make charts of given table update.
     void UpdateCharts( const String &rName ) const;
-    // update all charts, for that exists any table
+
+    // Update all charts, for that exists any table.
     void UpdateAllCharts()          { DoUpdateAllCharts( 0 ); }
-    // Tabelle wird umbenannt und aktualisiert die Charts
+
+    // Table is renamed and refreshes charts.
     void SetTableName( SwFrmFmt& rTblFmt, const String &rNewName );
 -    // returne zum Namen die im Doc gesetzte Referenz
+    // Return the reference in document that is set for name.
     const SwFmtRefMark* GetRefMark( const String& rName ) const;
-    // returne die RefMark per Index - fuer Uno
+
+    // Return RefMark via index - for UNO.
     const SwFmtRefMark* GetRefMark( sal_uInt16 nIndex ) const;
-    // returne die Namen aller im Doc gesetzten Referenzen.
-    //         Ist der ArrayPointer 0 dann returne nur, ob im Doc. eine RefMark
-    // gesetzt ist
+
+    // Return names of all references that are set in document.
+ // If array pointer is 0 return only whether a RefMark is set in document. 
     sal_uInt16 GetRefMarks( SvStringsDtor* = 0 ) const;
 -    //Einfuegen einer Beschriftung - falls ein FlyFormat erzeugt wird, so
-    // returne dieses.
+    // Insert label. If a FlyFormat is created, return it.
SwFlyFrmFmt* InsertLabel( const SwLabelType eType, const String &rTxt, const String& rSeparator, 
                     const String& rNumberingSeparator,
const sal_Bool bBefore, const sal_uInt16 nId, const ULONG nIdx, 
@@ -1728,14 +1738,14 @@ public:
const String &rTxt, const String& rSeparator, const String& rNumberSeparator, const sal_uInt16 nId, const String& rCharacterStyle, SdrObject& rObj ); 
 -    // erfrage den Attribut Pool
+    // Query attribute pool.
     const SwAttrPool& GetAttrPool() const  { return *mpAttrPool; }
           SwAttrPool& GetAttrPool()                { return *mpAttrPool; }
 -    // suche ueber das Layout eine EditShell und ggfs. eine ViewShell
+    // Search an EditShell or, if appropriate, a ViewShell via layout.
     SwEditShell* GetEditShell( ViewShell** ppSh = 0 ) const;
 -    // OLE 2.0-Benachrichtung
+    // OLE 2.0-notification.
     inline              void  SetOle2Link(const Link& rLink) {aOle2Link = rLink;}
     inline const Link& GetOle2Link() const {return aOle2Link;}
 @@ -1758,86 +1768,89 @@ public:
        The model should not have anything to do with a shell.
        Unnecessary compile/link time dependency.
     */
-    // Pointer auf die SfxDocShell vom Doc, kann 0 sein !!!
+
+    // Pointer to SfxDocShell from Doc. Can be 0!!
           SwDocShell* GetDocShell()            { return pDocShell; }
     const SwDocShell* GetDocShell() const      { return pDocShell; }
     void SetDocShell( SwDocShell* pDSh );
- // falls beim Kopieren von OLE-Nodes eine DocShell angelegt werden muss, 
-    // dann MUSS der Ref-Pointer besetzt sein!!!!
+    // If a DocShell has to be created during copying of OLE-Nodes
+    // the Ref-Pointer MUST be set!
SfxObjectShellRef* GetRefForDocShell() { return pDocShRef; } 
     void SetRefForDocShell( SfxObjectShellRef* p )    { pDocShRef = p; }
 -    // fuer die TextBausteine - diese habe nur ein SvPersist zur
-    // Verfuegung
+ // For Autotexts? (Textbausteine) They have only one SVPersist at their disposal. 
     SfxObjectShell* GetPersist() const;
 -    // Pointer auf den Storage des SfxDocShells, kann 0 sein !!!
+    // Pointer to storage of SfxDocShells. Can be 0!!!
::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage > GetDocStorage(); 
 -        // abfrage/setze Flag, ob das Dokument im asynchronen Laden ist
+ // Query / set flag indicating if document is loaded asynchronously at this moment. bool IsInLoadAsynchron() const { return mbInLoadAsynchron; } void SetInLoadAsynchron( bool bFlag ) { mbInLoadAsynchron = bFlag; } 
 -    // erzeuge um das zu Servende Object eine Selektion
     sal_Bool SelectServerObj( const String& rStr, SwPaM*& rpPam,
                             SwNodeRange*& rpRange ) const;
 -    // fuer Drag&Move: ( z.B. RefMarks "verschieben" erlauben )
+    // For Drag&Move: (e.g. allow "moving" of RefMarks)
     bool IsCopyIsMove() const              { return mbCopyIsMove; }
     void SetCopyIsMove( bool bFlag )        { mbCopyIsMove = bFlag; }
 -    // fuers Draw-Undo: Aktionen auf Flys wollen wir selbst behandeln
+    // For Draw-Undo: actions on Flys we want to handle ourselves.
     bool IsNoDrawUndoObj() const           { return mbNoDrawUndoObj; }
     void SetNoDrawUndoObj( bool bFlag )    { mbNoDrawUndoObj = bFlag; }
     SwDrawContact* GroupSelection( SdrView& );
     void UnGroupSelection( SdrView& );
     sal_Bool DeleteSelection( SwDrawView& );
 -    // Invalidiert OnlineSpell-WrongListen
+    // Invalidates OnlineSpell-WrongLists.
void SpellItAgainSam( sal_Bool bInvalid, sal_Bool bOnlyWrong, sal_Bool bSmartTags ); 
     void InvalidateAutoCompleteFlag();
      void SetCalcFieldValueHdl(Outliner* pOutliner);
- // erfrage ob die ::com::sun::star::util::URL besucht war. Uebers Doc, falls nur ein ::com::sun::star::text::Bookmark 
-    // angegeben ist. Dann muss der Doc. Name davor gesetzt werden!
+    // Query if ::com::sun::star::util::URL was visited.
+ // Query via Doc, if only a ::com::sun::star::text::Bookmark has been given. 
+    // In this case the document name has to be set in front.
     sal_Bool IsVisitedURL( const String& rURL ) const;
- // speicher die akt. Werte fuer die automatische Aufnahme von Ausnahmen 
-    // in die Autokorrektur
+ // Save current values for automatic registration of exceptions in Autocorrection. 
     void SetAutoCorrExceptWord( SwAutoCorrExceptWord* pNew );
     SwAutoCorrExceptWord* GetAutoCorrExceptWord()              { return pACEWord; }
      const SwFmtINetFmt* FindINetAttr( const String& rName ) const;
 -    // rufe ins dunkle Basic, mit evt. Return String
+    // Call into intransparent Basic; expect possible Return String.
sal_Bool ExecMacro( const SvxMacro& rMacro, String* pRet = 0, SbxArray* pArgs = 0 ); 
-    // rufe ins dunkle Basic/JavaScript
+
+    // Call into intransparent Basic / JavaScript.
sal_uInt16 CallEvent( sal_uInt16 nEvent, const SwCallMouseEvent& rCallEvent, 
                         sal_Bool bChkPtr = sal_False, SbxArray* pArgs = 0,
                         const Link* pCallBack = 0 );
 +    // Adjust left margin via object bar.
     // linken Rand ueber Objectleiste einstellen (aenhlich dem Stufen von
     // Numerierungen), optional kann man "um" den Offset stufen oder "auf"
-    // die Position gestuft werden (bModulus = sal_True)
+    // die Position gestuft werden (bModulus = sal_True).
     void MoveLeftMargin( const SwPaM& rPam, sal_Bool bRight = sal_True,
                         sal_Bool bModulus = sal_True );
 -    // Numberformatter erfragen
+    // Query NumberFormatter.
inline SvNumberFormatter* GetNumberFormatter( sal_Bool bCreate = sal_True ); inline const SvNumberFormatter* GetNumberFormatter( sal_Bool bCreate = sal_True ) const; - // loesche den nicht sichtbaren ::com::sun::star::ucb::Content aus dem Document, wie z.B.: 
-    // versteckte Bereiche, versteckte Absaetze
+ // Delete non-visible ::com::sun::star::ucb::Content from document, e.g. 
+    // hidden ranges, hidden paragraphes.
     sal_Bool RemoveInvisibleContent();
+
     //restore the invisible content if it's available on the undo stack
     sal_Bool RestoreInvisibleContent();
-    // replace fields by text - mailmerge support
+
+    // Replace fields by text - mailmerge support.
     BOOL ConvertFieldsToText();
 -    // erzeuge Anhand der vorgebenen Collection Teildokumente
-    // falls keine angegeben ist, nehme die Kapitelvorlage der 1. Ebene
+    // Create sub-documents according to given collection.
+    // If no collection is given, use chapter styles for 1st level.
     sal_Bool GenerateGlobalDoc( const String& rPath,
                                 const SwTxtFmtColl* pSplitColl = 0 );
sal_Bool GenerateGlobalDoc( const String& rPath, int nOutlineLevel = 0 ); 
@@ -1845,32 +1858,34 @@ public:
                                 const SwTxtFmtColl* pSplitColl = 0 );
sal_Bool GenerateHTMLDoc( const String& rPath, int nOutlineLevel = 0 ); 
 -    //  vergleiche zwei Dokument miteinander
+    //  Compare two documents.
     long CompareDoc( const SwDoc& rDoc );
-    // merge zweier Dokumente
+
+    // Merge two documents.
     long MergeDoc( const SwDoc& rDoc );
-    // setze Kommentar-Text fuers Redline, das dann per AppendRedline
-    // hereinkommt. Wird vom Autoformat benutzt. 0-Pointer setzt den Modus
-    // wieder zurueck. Die SequenceNummer ist fuers UI-seitige zusammen-
-    // fassen von Redlines.
+
+    // Set comment-text for Redline. It then comes in via AppendRedLine.
+    // Used by AutoFormat. 0-pointer resets mode.
+    // Sequence number is for conjoining of Redlines by the UI.
void SetAutoFmtRedlineComment( const String* pTxt, sal_uInt16 nSeqNo = 0 ); bool IsAutoFmtRedline() const { return mbIsAutoFmtRedline; } void SetAutoFmtRedline( bool bFlag ) { mbIsAutoFmtRedline = bFlag; } 
 -    // fuer AutoFormat: mit Undo/Redlining - Behandlung
+    // For AutoFormat: with Undo/Redlining.
void SetTxtFmtCollByAutoFmt( const SwPosition& rPos, sal_uInt16 nPoolId, 
                                 const SfxItemSet* pSet = 0 );
     void SetFmtItemByAutoFmt( const SwPaM& rPam, const SfxItemSet& );
 -    // !!!NUR fuer die SW-Textblocks!! beachtet kein LAYOUT!!!
-    void ClearDoc();           // loescht den gesamten Inhalt.
+    // Only for SW-textbloxks! Does not pay any attention to layout!
+    void ClearDoc();           // Deletes all content!
 -    // erfrage / setze die Daten fuer die PagePreView
+    // Query /set data for PagePreView.
const SwPagePreViewPrtData* GetPreViewPrtData() const { return pPgPViewPrtData; } 
-    // wenn der Pointer == 0 ist, dann wird im Doc der Pointer zerstoert,
-    // ansonsten wird das Object kopiert.
-    // Der Pointer geht NICHT in den Besitz des Doc's!!
+
+    // If pointer == 0 destroy pointer in document.
+    // Else copy object.
+    // Pointer is not transferred to ownership by document!
     void SetPreViewPrtData( const SwPagePreViewPrtData* pData );
// update all modified OLE-Objects. The modification is called over the 
@@ -1878,13 +1893,12 @@ public:
     void SetOLEObjModified()
     {  if( GetRootFrm() ) aOLEModifiedTimer.Start(); }
- // -------------------- Uno - Schnittstellen --------------------------- 
+    // -------------------- Uno - Interfaces ---------------------------
     const SwUnoCrsrTbl& GetUnoCrsrTbl() const              { return *pUnoCrsrTbl; }
SwUnoCrsr* CreateUnoCrsr( const SwPosition& rPos, sal_Bool bTblCrsr = sal_False ); - // -------------------- Uno - Schnittstellen --------------------------- - // -------------------- FeShell - Schnittstellen ----------------------- 
-    // !!!!! diese gehen immer davon aus, das ein Layout existiert  !!!!
+    // -------------------- FeShell - Interfaces -----------------------
+    // !!! These assume always an existing layout !!!
     sal_Bool ChgAnchor( const SdrMarkList& _rMrkList,
                         RndStdIds _eAnchorType,
                         const sal_Bool _bSameOnly,
@@ -1912,22 +1926,21 @@ public:
     int Chain( SwFrmFmt &rSource, const SwFrmFmt &rDest );
     void Unchain( SwFrmFmt &rFmt );
 -    // fuers Copy/Move aus der FrmShell
+    // For Copy/Move from FrmShell.
SdrObject* CloneSdrObj( const SdrObject&, sal_Bool bMoveWithinDoc = sal_False, 
                             sal_Bool bInsInPage = sal_True );
      //
- // -------------------- FeShell - Schnittstellen Ende ------------------ 
+    // -------------------- FeShell - Interface end ------------------
 -    // Schnittstelle fuer die TextInputDaten - ( fuer die Texteingabe
-    // von japanischen/chinesischen Zeichen)
+ // Interface for TextInputData - for text input of Chinese and Japanese. 
     SwExtTextInput* CreateExtTextInput( const SwPaM& rPam );
     void DeleteExtTextInput( SwExtTextInput* pDel );
     SwExtTextInput* GetExtTextInput( const SwNode& rNd,
xub_StrLen nCntntPos = STRING_NOTFOUND) const; 
     SwExtTextInput* GetExtTextInput() const;
 -    // Schnistelle fuer den Zugriff auf die AutoComplete-Liste
+    // Interface for access to AutoComplete-List.
static SwAutoCompleteWord& GetAutoCompleteWords() { return *pACmpltWords; } bool ContainsMSVBasic() const { return mbContains_MSVBasic; } 
@@ -2059,8 +2072,7 @@ public:
     SfxObjectShell* CreateCopy(bool bCallInitNew) const;
 };
 -// Diese Methode wird im Dtor vom SwDoc gerufen und loescht den Cache
-// der Konturobjekte
+// This method is called in Dtor of SwDoc and deletes cache of ContourObjects. 
 void ClrContourCache();
inline const SwTableNode* SwDoc::IsIdxInTbl( const SwNodeIndex& rIdx ) const 
--
1.7.1


From 9099a9635ae87dc314a8db993c31f03f2168b24b Mon Sep 17 00:00:00 2001
From: Christoph Herzog <rhogez@googlemail.com>
Date: Mon, 10 Jan 2011 16:24:17 +0100
Subject: [PATCH] Translations in sw/inc/doc.hxx

---
 sw/inc/doc.hxx |  570 +++++++++++++++++++++++++++++---------------------------
 1 files changed, 291 insertions(+), 279 deletions(-)

diff --git a/sw/inc/doc.hxx b/sw/inc/doc.hxx
index 3636b88..12dd790 100644
--- a/sw/inc/doc.hxx
+++ b/sw/inc/doc.hxx
@@ -245,7 +245,7 @@ namespace sfx2 {
     class LinkManager;
 }
 
-//PageDescriptor-Schnittstelle, Array hier wegen inlines.
+// PageDescriptor-interface, Array because of inlines.
 typedef SwPageDesc* SwPageDescPtr;
 SV_DECL_PTRARR_DEL( SwPageDescs, SwPageDescPtr, 4, 4 )
 
@@ -288,16 +288,16 @@ class SW_DLLPUBLIC SwDoc :
     SwNodes    aUndoNodes;                     // content for undo
     SwAttrPool*        mpAttrPool;                             // attribute pool
     SwPageDescs        aPageDescs;                             // PageDescriptors
-    Link               aOle2Link;                              // OLE 2.0-Benachrichtigung
+    Link               aOle2Link;                              // OLE 2.0-notification
     /* @@@MAINTAINABILITY-HORROR@@@
        Timer should not be members of the model
     */
-    Timer       aIdleTimer;             // der eigene IdleTimer
+    Timer       aIdleTimer;             // Own IdleTimer
     Timer              aOLEModifiedTimer;              // Timer for update modified OLE-Objecs
     SwDBData   aDBData;                                // database descriptor
     ::com::sun::star::uno::Sequence <sal_Int8 > aRedlinePasswd;
     String             sTOIAutoMarkURL;                // ::com::sun::star::util::URL of table of 
index AutoMark file
-    SvStringsDtor aPatternNms;                 // Array fuer die Namen der Dokument-Vorlagen
+    SvStringsDtor aPatternNms;                 // Array for names of document-templates
     com::sun::star::uno::Reference<com::sun::star::container::XNameContainer>
         xXForms;                        // container with XForms models
     mutable com::sun::star::uno::Reference< com::sun::star::linguistic2::XProofreadingIterator > 
m_xGCIterator;
@@ -306,11 +306,11 @@ class SW_DLLPUBLIC SwDoc :
     const ::boost::scoped_ptr< ::sw::MetaFieldManager > m_pMetaFieldManager;
 
     // -------------------------------------------------------------------
-    // die Pointer
-                                //Defaultformate
+    // Pointer
+                                //Default formats.
     SwFrmFmt           *pDfltFrmFmt;
      SwFrmFmt          *pEmptyPageFmt;         // Format for the default empty page
-    SwFrmFmt           *pColumnContFmt;        // Format fuer Spaltencontainer
+    SwFrmFmt           *pColumnContFmt;        // Format for column container
     SwCharFmt          *pDfltCharFmt;
     SwTxtFmtColl       *pDfltTxtFmtColl;       // Defaultformatcollections
     SwGrfFmtColl       *pDfltGrfFmtColl;
@@ -319,51 +319,49 @@ class SW_DLLPUBLIC SwDoc :
     SwCharFmts         *pCharFmtTbl;
     SwSpzFrmFmts       *pSpzFrmFmtTbl;
     SwSectionFmts      *pSectionFmtTbl;
-    SwFrmFmts          *pTblFrmFmtTbl;         // spz. fuer Tabellen
+    SwFrmFmts          *pTblFrmFmtTbl;         // For tables
     SwTxtFmtColls      *pTxtFmtCollTbl;        // FormatCollections
     SwGrfFmtColls      *pGrfFmtCollTbl;
 
-    SwTOXTypes         *pTOXTypes;                     // Verzeichnisse
+    SwTOXTypes         *pTOXTypes;                     // Tables/indices
     SwDefTOXBase_Impl * pDefTOXBases;  // defaults of SwTOXBase's
 
-    SwRootFrm          *pLayout;                       // Rootframe des spezifischen Layouts.
+    SwRootFrm          *pLayout;                       // Rootframe of the specific layout.
     SdrModel           *pDrawModel;            // StarView Drawing
 
     SwUndos            *pUndos;                        // Undo/Redo History
 
-    SwDocUpdtFld       *pUpdtFlds;                     // Struktur zum Field-Update
-    SwFldTypes         *pFldTypes;                     // Feldtypen
-    SwNewDBMgr                 *pNewDBMgr;                     // Pointer auf den neuen DBMgr fuer
-                                        // Evaluierung der DB-Fields
+    SwDocUpdtFld       *pUpdtFlds;                     // Struct for updating fields
+    SwFldTypes         *pFldTypes;
+    SwNewDBMgr                 *pNewDBMgr;                     // Pointer to the new DBMgr for
+                                        // evaluation of DB-fields.
 
     VirtualDevice   *pVirDev;           // can be used for formatting
     SfxPrinter      *pPrt;              // can be used for formatting
     SwPrintData     *pPrtData;          // Print configuration
 
-    SwDoc                      *pGlossaryDoc;          // Pointer auf das Glossary-Dokument. Dieses
+    SwDoc                      *pGlossaryDoc;          // Pointer to glossary-document.
 
     SwNumRule          *pOutlineRule;
     SwFtnInfo          *pFtnInfo;
     SwEndNoteInfo      *pEndNoteInfo;
     SwLineNumberInfo*pLineNumberInfo;
     SwFtnIdxs          *pFtnIdxs;
-    SwDocStat          *pDocStat;                      // Statistic Informationen
-    SvxMacroTableDtor *pMacroTable;    // Tabelle der dokumentglobalen Macros
+    SwDocStat          *pDocStat;              // Statistics information.
+    SvxMacroTableDtor *pMacroTable;     // table of macros.
 
-    SwDocShell         *pDocShell;                     // Ptr auf die SfxDocShell vom Doc
-    SfxObjectShellRef* pDocShRef;     // fuers Kopieren von OLE-Nodes (wenn keine
-                                        // DocShell gesetzt ist, muss dieser
-                                        // Ref-Pointer gesetzt sein!!!!)
-    sfx2::LinkManager  *pLinkMgr;                      // Liste von Verknuepften (Grafiken/DDE/OLE)
+    SwDocShell         *pDocShell;         // Ptr to SfxDocShell of Doc.
+    SfxObjectShellRef* pDocShRef;       // For copying OLE-nodes. (If no DocShell
+                                        // is set, this Ref-Pointer must be set!!).
 
-    SwAutoCorrExceptWord *pACEWord;            // fuer die automatische Uebernahme von
-                                        // autokorrigierten Woertern, die "zurueck"
-                                        // verbessert werden
-    SwURLStateChanged *pURLStateChgd;  // SfxClient fuer Aenderungen in der
-                                        // INetHistory
-    SvNumberFormatter *pNumberFormatter;       // NumFormatter fuer die Tabellen/Felder
+    sfx2::LinkManager  *pLinkMgr;      // List of linked stuff (graphics/DDE/OLE).
 
-    mutable SwNumRuleTbl    *pNumRuleTbl;           // Liste aller benannten NumRules
+    SwAutoCorrExceptWord *pACEWord;            // For the automated takeover of
+                                        // auto-corrected words that are "re-corrected".
+    SwURLStateChanged *pURLStateChgd;  // SfxClient for changes in INetHistory
+    SvNumberFormatter *pNumberFormatter;// NumFormatter for tables / fields
+
+    mutable SwNumRuleTbl    *pNumRuleTbl;   // List of all named NumRules.
 
     // Hash map to find numrules by name
     mutable std::hash_map<String, SwNumRule *, StringHash> maNumRuleMap;
@@ -374,13 +372,12 @@ class SW_DLLPUBLIC SwDoc :
     // relation between list style and its default list
     tHashMapForLists maListStyleLists;
 
-    SwRedlineTbl       *pRedlineTbl;                   // Liste aller Redlines
-    String                     *pAutoFmtRedlnComment;  // Kommentar fuer Redlines, die
-                                        // uebers Autoformat eingefuegt werden
+    SwRedlineTbl       *pRedlineTbl;                   // List of all Redlines.
+    String                     *pAutoFmtRedlnComment;  // Comment for Redlines inserted via 
AutoFormat.
+
     SwUnoCrsrTbl       *pUnoCrsrTbl;
 
-    SwPagePreViewPrtData *pPgPViewPrtData;             // Einzuege/Abstaende fuers
-                                        // Drucken der Seitenansicht
+    SwPagePreViewPrtData *pPgPViewPrtData;     // Indenting / spacing for printing of page view.
     SwPaM                      *pExtInputRing;
 
     SwLayouter         *pLayouter;             // ::com::sun::star::frame::Controller for complex 
layout formatting
@@ -416,28 +413,29 @@ private:
 
     // -------------------------------------------------------------------
     // other
-    sal_uInt16         nUndoPos;                       // akt. Undo-InsertPosition (for Redo!)
-    sal_uInt16 nUndoSavePos;           // Position im Undo-Array, ab der das Doc
-                                    // nicht als modifiziert gilt
-    sal_uInt16         nUndoCnt;                       // Anzahl von Undo Aktionen
-    sal_uInt16         nUndoSttEnd;            // != 0 -> innerhalb einer Klammerung
-
-    sal_uInt16 nAutoFmtRedlnCommentNo; // SeqNo fuers UI-seitige zusammenfassen
-                                    // von AutoFmt-Redlines. Wird vom SwAutoFmt
-                                    // verwaltet!
-    sal_uInt16 nLinkUpdMode;           // UpdateMode fuer Links
-    SwFldUpdateFlags    eFldUpdMode;        // Mode fuer Felder/Charts automatisch aktualisieren
-    RedlineMode_t eRedlineMode;                // aktueller Redline Modus
+    sal_uInt16         nUndoPos;                       // act. Undo-InsertPosition (for Redo!).
+    sal_uInt16 nUndoSavePos;           // Position in Undo-Array, at which document.
+                                    // is regarded as not modified.
+
+    sal_uInt16         nUndoCnt;                       // Count of Undo Actions.
+    sal_uInt16         nUndoSttEnd;            // != 0 -> within parentheses.
+
+    sal_uInt16 nAutoFmtRedlnCommentNo; // SeqNo for conjoining of AutoFmt-Redlines.
+                                        // by the UI. Managed by SwAutoFmt!
+
+    sal_uInt16 nLinkUpdMode;               // UpdateMode for links.
+    SwFldUpdateFlags    eFldUpdMode;    // Automatically Update Mode for fields/charts.
+    RedlineMode_t eRedlineMode;                    // Current Redline Mode.
     SwCharCompressType eChrCmprType;   // for ASIAN: compress punctuation/kana
 
     sal_Int32   mReferenceCount;
     sal_Int32   mIdleBlockCount;
-    sal_Int8   nLockExpFld;            // Wenn != 0 hat UpdateExpFlds() keine Wirkung
+    sal_Int8   nLockExpFld;            // If != 0 UpdateExpFlds() has no effect!
 
     /* Draw Model Layer IDs
-     * LayerIds, Heaven == ueber dem Dokument
-     * Hell   == unter dem Dokument
-     * Controls == ganz oben
+     * LayerIds, Heaven == above document
+     *           Hell   == below document
+     *         Controls == at the very top
      */
     SdrLayerID  nHeaven;
     SdrLayerID  nHell;
@@ -446,47 +444,47 @@ private:
     SdrLayerID  nInvisibleHell;
     SdrLayerID  nInvisibleControls;
 
-    bool mbGlossDoc              : 1;    //TRUE: ist ein Textbaustein Dokument
-    bool mbModified              : 1;    //TRUE: Dokument ist veraendert
-    bool mbDtor                  : 1;    //TRUE: ist im SwDoc DTOR
-                                         //      leider auch temporaer von
-                                         //      SwSwgReader::InLayout(), wenn fehlerhafte
-                                         //      Frames geloescht werden muessen
-    bool mbUndo                  : 1;    // TRUE: Undo eingeschaltet
-    bool mbGroupUndo             : 1;    // TRUE: Undos werden gruppiert
-    bool mbPageNums              : 1;    // TRUE: es gibt virtuelle Seitennummern
-    bool mbLoaded                : 1;    // TRUE: ein geladenes Doc
-    bool mbUpdateExpFld          : 1;    // TRUE: Expression-Felder updaten
-    bool mbNewDoc                : 1;    // TRUE: neues Doc
-    bool mbNewFldLst             : 1;    // TRUE: Felder-Liste neu aufbauen
-    bool mbCopyIsMove            : 1;    // TRUE: Copy ist ein verstecktes Move
-    bool mbNoDrawUndoObj         : 1;    // TRUE: keine DrawUndoObjecte speichern
-    bool mbVisibleLinks          : 1;    // TRUE: Links werden sichtbar eingefuegt
-    bool mbBrowseMode            : 1;    // TRUE: Dokument im BrowseModus anzeigen
-    bool mbInReading             : 1;    // TRUE: Dokument wird gerade gelesen
-    bool mbInXMLImport           : 1;    // TRUE: During xml import, attribute portion building is 
not necessary
-    bool mbUpdateTOX             : 1;    // TRUE: nach Dokument laden die TOX Updaten
-    bool mbInLoadAsynchron       : 1;    // TRUE: Dokument wird gerade asynchron geladen
-    bool mbHTMLMode              : 1;    // TRUE: Dokument ist im HTMLMode
-    bool mbInCallModified        : 1;    // TRUE: im Set/Reset-Modified Link
-    bool mbIsGlobalDoc           : 1;    // TRUE: es ist ein GlobalDokument
-    bool mbGlblDocSaveLinks      : 1;    // TRUE: im GlobalDoc. gelinkte Sect. mit speichern
-    bool mbIsLabelDoc            : 1;    // TRUE: es ist ein Etiketten-Dokument
-    bool mbIsAutoFmtRedline      : 1;    // TRUE: die Redlines werden vom Autoformat aufgezeichnet
-    bool mbOLEPrtNotifyPending   : 1;    // TRUE: Printer  ist geaendert und beim
-                                         //       Erzeugen der ::com::sun::star::sdbcx::View ist 
eine Benachrichtigung
-                                         //       der OLE-Objekte PrtOLENotify() notwendig.
-    bool mbAllOLENotify          : 1;    // True: Benachrichtigung aller Objekte ist notwendig
-    bool mbIsRedlineMove         : 1;    // True: die Redlines werden in/aus der Section verschoben
+    bool mbGlossDoc              : 1;    //TRUE: glossary document.
+    bool mbModified              : 1;    //TRUE: document has changed.
+    bool mbDtor                  : 1;    //TRUE: is in SwDoc DTOR.
+                                         //      and unfortunately temorarily also in
+                                         //      SwSwgReader::InLayout() when flawed
+                                         //      frames need deletion.
+    bool mbUndo                  : 1;    // TRUE: Undo switched on.
+    bool mbGroupUndo             : 1;    // TRUE: Undos are grouped.
+    bool mbPageNums              : 1;    // TRUE: There are virtual page numbers.
+    bool mbLoaded                : 1;    // TRUE: Doc loaded.
+    bool mbUpdateExpFld          : 1;    // TRUE: Update expression fields.
+    bool mbNewDoc                : 1;    // TRUE: new Doc.
+    bool mbNewFldLst             : 1;    // TRUE: Rebuild field-list.
+    bool mbCopyIsMove            : 1;    // TRUE: Copy is a hidden Move.
+    bool mbNoDrawUndoObj         : 1;    // TRUE: Do not save DrawUndoObjects.
+    bool mbVisibleLinks          : 1;    // TRUE: Links are inserted visibly.
+    bool mbBrowseMode            : 1;    // TRUE: Show document in browser mode.
+    bool mbInReading             : 1;    // TRUE: Document is in the process of being read.
+    bool mbInXMLImport           : 1;    // TRUE: During xml import, attribute portion building is 
not necessary.
+    bool mbUpdateTOX             : 1;    // TRUE: After loading document, update TOX.
+    bool mbInLoadAsynchron       : 1;    // TRUE: Document is in the process of being loaded 
asynchronously.
+    bool mbHTMLMode              : 1;    // TRUE: Document is in HTMLMode.
+    bool mbInCallModified        : 1;    // TRUE: in Set/Reset-Modified link.
+    bool mbIsGlobalDoc           : 1;    // TRUE: It's a global document.
+    bool mbGlblDocSaveLinks      : 1;    // TRUE: Save sections linked in global document.
+    bool mbIsLabelDoc            : 1;    // TRUE: It's a label document.
+    bool mbIsAutoFmtRedline      : 1;    // TRUE: Redlines are recorded by Autoformat.
+    bool mbOLEPrtNotifyPending   : 1;    // TRUE: Printer has changed. At creation of
+                                         //       ::com::sun::star::sdbcx::View
+                                         //       notification of OLE-Objects PrtOLENotify() is 
required.
+    bool mbAllOLENotify          : 1;    // True: Notification of all objects is required.
+    bool mbIsRedlineMove         : 1;    // True: Redlines are moved into to / out of the section.
     bool mbInsOnlyTxtGlssry      : 1;    // True: insert 'only text' glossary into doc
     bool mbContains_MSVBasic     : 1;    // True: MS-VBasic exist is in our storage
-    bool mbPurgeOLE              : 1;    // TRUE: Purge OLE-Objects
-    bool mbKernAsianPunctuation  : 1;    // TRUE: kerning also for ASIAN punctuation
-    bool mbReadlineChecked       : 1;    // TRUE: if the query was already shown
+    bool mbPurgeOLE              : 1;    // TRUE: Purge OLE-Objects.
+    bool mbKernAsianPunctuation  : 1;    // TRUE: kerning also for ASIAN punctuation.
+    bool mbReadlineChecked       : 1;    // TRUE: if the query was already shown.
     bool mbLinksUpdated          : 1;    // #i38810#
                                          // flag indicating, that the links have been updated.
-    bool mbClipBoard             : 1;    // true: this document represents the clipboard
-    bool mbColumnSelection       : 1;    // true: this content has bee created by a column 
selection
+    bool mbClipBoard             : 1;    // TRUE: this document represents the clipboard
+    bool mbColumnSelection       : 1;    // TRUE: this content has bee created by a column 
selection
                                          //       (clipboard docs only)
 
 #if OSL_DEBUG_LEVEL > 1
@@ -573,7 +571,10 @@ private:
     bool mbUseFormerObjectPos               : 1;    // #i11860#
     bool mbUseFormerTextWrapping            : 1;
     bool mbConsiderWrapOnObjPos             : 1;    // #i28701#
-                                                    // TRUE: object positioning algorithm has 
consider the wrapping style of                                                    //       the 
floating screen objects as given by its attribute 'WrapInfluenceOnObjPos'
+                                                    // TRUE: object positioning algorithm has
+                                                    // to consider the wrapping style of
+                                                    // floating screen objects as given by its
+                                                    // attribute 'WrapInfluenceOnObjPos'.
 
     // non-ui-compatibility flags:
     bool mbOldNumbering                             : 1;
@@ -599,23 +600,24 @@ private:
     // COMPATIBILITY FLAGS END
     //
 
-    sal_Bool    mbStartIdleTimer                 ;    // idle timer mode start/stop
+    sal_Bool    mbStartIdleTimer;               // idle timer mode start/stop
 
-    static SwAutoCompleteWord *pACmpltWords;   // Liste aller Worte fuers AutoComplete
-    static sal_uInt16 nUndoActions;    // anzahl von Undo ::com::sun::star::chaos::Action
+    static SwAutoCompleteWord *pACmpltWords;   // List of all words for AutoComplete
+    static sal_uInt16 nUndoActions;            // Count of Undo ::com::sun::star::chaos::Action
 
-    //---------------- private Methods ------------------------------
+    //---------------- private methods ------------------------------
     void checkRedlining(RedlineMode_t& _rReadlineMode);
 
-    sal_Bool DelUndoObj( sal_uInt16 nEnde  );   // loescht alle UndoObjecte vom Anfang
-                                        // bis zum angegebenen Ende
+    sal_Bool DelUndoObj( sal_uInt16 nEnde  );   // Deletes all UndoObjects from the beginning
+                                                // up to the indicated point.
+
     DECL_LINK( AddDrawUndo, SdrUndoAction * );
                                         // DrawModel
-    void DrawNotifyUndoHdl();  // wegen CLOOKs
+    void DrawNotifyUndoHdl();          // Because of CLOOKs
 
-        // nur fuer den internen Gebrauch deshalb privat.
-        // Kopieren eines Bereiches im oder in ein anderes Dokument !
-        // Die Position darf nicht im Bereich liegen !!
+    // Only for internal use and therefore private.
+    // Copy a range within the same or to another document.
+    // Position may not lie within range!
     bool CopyImpl( SwPaM&, SwPosition&, const bool MakeNewFrms /*= true */,
             const bool bCopyAll, SwPaM *const pCpyRng /*= 0*/ ) const;
 
@@ -647,18 +649,18 @@ private:
 
     VirtualDevice& CreateVirtualDevice_() const;
     SfxPrinter& CreatePrinter_() const;
-    void               PrtDataChanged();       //Printer oder JobSetup geandert, es muss
-                                    //fuer entsprechende Invalidierungen und
-                                    //Benachrichtigungen gesorgt werden.
+    void               PrtDataChanged();       // Printer or JobSetup altered.
+                                    // Care has to be taken of the necessary
+                                    // invalidations and notifications.
 
-    // gcc: aFtnInfo::CopyCtor ist private, also muessen wir uns auch schuetzen
+    // gcc: aFtnInfo::CopyCtor is private, therefore we too have to protect ourselves.
     SwDoc( const SwDoc &);
 
-    // fuer Felder:
-    void _InitFieldTypes();    // wird vom CTOR gerufen!!
+    // For fields:
+    void _InitFieldTypes();    // Called by CTOR!!
     void _MakeFldList( int eMode );
 
-    // Datenbankfelder:
+    // Database fields:
     void UpdateDBNumFlds( SwDBNameInfField& rDBFld, SwCalc& rCalc );
     void AddUsedDBToList( SvStringsDtor& rDBNameList,
                           const SvStringsDtor& rUsedDBNames );
@@ -678,21 +680,21 @@ private:
 
     sal_Bool _UnProtectTblCells( SwTable& rTbl );
 
-    // erzeuge Anhand der vorgebenen Collection Teildokumente
-    // falls keine angegeben ist, nehme die Kapitelvorlage der 1. Ebene
+    // Create sub-documents according to the given collection.
+    // If no collection is given, take chapter style of the 1st level.
     sal_Bool SplitDoc( sal_uInt16 eDocType, const String& rPath,
                         const SwTxtFmtColl* pSplitColl );
     sal_Bool SplitDoc( sal_uInt16 eDocType, const String& rPath, int nOutlineLevel = 0 ); 
 
-    // Charts der angegebenen Tabelle updaten
+    // Update charts of given table.
     void _UpdateCharts( const SwTable& rTbl, ViewShell& rVSh ) const;
 
     BOOL _SelectNextRubyChars( SwPaM& rPam, SwRubyListEntry& rRubyEntry,
                                 USHORT nMode );
 
-    // unser eigener 'IdlTimer' ruft folgende Methode
+    // Our own 'IdleTimer' calls the following method
     DECL_LINK( DoIdleJobs, Timer * );
-    // der CharTimer ruft diese Methode
+    // CharTimer calls this method.
     DECL_LINK( DoUpdateAllCharts, Timer * );
     DECL_LINK( DoUpdateModifiedOLE, Timer * );
 
@@ -822,7 +824,7 @@ public:
     virtual void setUndoNoModifiedPosition( SwUndoNoModifiedPosition );
     virtual SwUndoNoModifiedPosition getUndoNoModifiedPosition() const;
 
-    /** abfragen/setzen der Anzahl von wiederherstellbaren Undo-Actions */
+    /** Query / set count of Undo-Actions. */
     static sal_uInt16 GetUndoActionCount();
     static void SetUndoActionCount(sal_uInt16 nNew);
 
@@ -1054,22 +1056,22 @@ public:
     void SetXMLExport( bool bFlag )     { mbXMLExport = bFlag; }
 #endif
 
-    // liefert zu allen fliegenden Rahmen die Position im Dokument.
-    // Wird ein Pam-Pointer uebergeben, muessen die absatzgebundenen
-    // FlyFrames von der ::com::sun::star::awt::Selection vollstaendig umschlossen sein
+    // Returns positions of all FlyFrames in the document.
+    // If a Pam-Pointer is passed the FlyFrames attached to paragraphes
+    // have to be surrounded completely by ::com::sun::star::awt::Selection.
     // ( Start < Pos < End ) !!!
-    // (wird fuer die Writer benoetigt)
+    // (Required for Writers.)
     void GetAllFlyFmts( SwPosFlyFrms& rPosFlyFmts, const SwPaM* = 0,
                         sal_Bool bDrawAlso = sal_False ) const;
 
-    // wegen swrtf.cxx und define private public, jetzt hier
+    // Because swrtf.cxx and define private public here now.
     SwFlyFrmFmt  *MakeFlyFrmFmt (const String &rFmtName, SwFrmFmt *pDerivedFrom);
     SwDrawFrmFmt *MakeDrawFrmFmt(const String &rFmtName, SwFrmFmt *pDerivedFrom);
 
-    // fuer Flys muss jetzt diese Schnittstelle benutzt
-    // werden. pAnchorPos muss gesetzt sein, wenn keine
-    // Seitenbindung vorliegt UND der ::com::sun::star::chaos::Anchor nicht schon
-    // im FlySet/FrmFmt mit gueltiger CntntPos gesetzt ist
+    // From now on this interface has to be used for Flys.
+    // pAnchorPos must be set, if they are not attached to pages AND
+    // ::com::sun::star::chaos::Anchor is not already set at valid CntntPos
+    // in FlySet/FrmFmt.
     /* new parameter bCalledFromShell
 
        TRUE: An existing adjust item at pAnchorPos is propagated to
@@ -1134,13 +1136,10 @@ public:
     // count words in pam
     void CountWords( const SwPaM& rPaM, SwDocStat& rStat ) const;
 
-    /** ???
-    */
-    // Textbaustein Dokument?
+    // Glossary Document
     void SetGlossDoc( bool bGlssDc = true ) { mbGlossDoc = bGlssDc; }
     bool IsInsOnlyTextGlossary() const      { return mbInsOnlyTxtGlssry; }
 
-    // Abstakt fuellen
     void Summary( SwDoc* pExtDoc, sal_uInt8 nLevel, sal_uInt8 nPara, sal_Bool bImpress );
 
     void ChangeAuthorityData(const SwAuthEntry* pNewData);
@@ -1151,16 +1150,16 @@ public:
                             const Point* pPt = 0 ) const;
     sal_Bool IsInVerticalText( const SwPosition& rPos,
                                const Point* pPt = 0 ) const;
-    /** Database ???
-    */
 
-    /* Datenbank &&  DB-Manager */
+    /** Database  and DB-Manager
+    */
     void SetNewDBMgr( SwNewDBMgr* pNewMgr )            { pNewDBMgr = pNewMgr; }
     SwNewDBMgr* GetNewDBMgr() const                    { return pNewDBMgr; }
     void ChangeDBFields( const SvStringsDtor& rOldNames,
                         const String& rNewName );
     void SetInitDBFields(sal_Bool b);
-    // Von Feldern verwendete Datenbanken herausfinden
+
+    // Find out which databases are used by fields.
     void GetAllUsedDB( SvStringsDtor& rDBNameList,
                        const SvStringsDtor* pAllDBNames = 0 );
 
@@ -1181,13 +1180,12 @@ public:
     void GetGrfNms( const SwFlyFrmFmt& rFmt, String* pGrfName,
                     String* pFltName ) const;
 
-    // setze bei allen Flys ohne Namen einen gueltigen (Wird von den Readern
-    // nach dem Einlesen gerufen )
+    // Set a valid name for all Flys that have none (Called by Readers after reading).
     void SetAllUniqueFlyNames();
 
-        //Zuruecksetzen der Attribute; es werden alle TxtHints und bei
-        //vollstaendiger Selektion harte Formatierung (AUTO-Formate) entfernt
-    // introduce new optional parameter <bSendDataChangedEvents> in order to
+    // Reset attributes. All TxtHints and (if completely selected) all hard-
+    // formated stuff (auto-formats) are removed.
+    // Introduce new optional parameter <bSendDataChangedEvents> in order to
     // control, if the side effect "send data changed events" is triggered or not.
     void ResetAttrs( const SwPaM &rRg,
                      sal_Bool bTxtAttr = sal_True,
@@ -1195,8 +1193,8 @@ public:
                      const bool bSendDataChangedEvents = true );
     void RstTxtAttrs(const SwPaM &rRg, BOOL bInclRefToxMark = FALSE );
 
-        // Setze das Attribut im angegebenen Format. Ist Undo aktiv, wird
-        // das alte in die Undo-History aufgenommen
+    // Set attribute in given format.
+    // If Undo is activated, the old one is listed in Undo-History.
     void SetAttr( const SfxPoolItem&, SwFmt& );
     void SetAttr( const SfxItemSet&, SwFmt& );
 
@@ -1204,22 +1202,23 @@ public:
     void ResetAttrAtFormat( const USHORT nWhichId,
                             SwFmt& rChangedFormat );
 
-        // Setze das Attribut als neues default Attribut in diesem Dokument.
-        // Ist Undo aktiv, wird das alte in die Undo-History aufgenommen
+    // Set attribute as new default attribute in current document.
+    // If Undo is activated, the old one is listed in Undo-History.
     void SetDefault( const SfxPoolItem& );
     void SetDefault( const SfxItemSet& );
 
-    // Erfrage das Default Attribut in diesem Dokument.
+    // Query default attribute in this document.
     const SfxPoolItem& GetDefault( sal_uInt16 nFmtHint ) const;
-    // TextAttribute nicht mehr aufspannen lassen
+
+    // Do not expand text attributes.
     sal_Bool DontExpandFmt( const SwPosition& rPos, sal_Bool bFlag = sal_True );
 
-    /* Formate */
+    /* Formats */
     const SwFrmFmts* GetFrmFmts() const        { return pFrmFmtTbl; }
           SwFrmFmts* GetFrmFmts()                      { return pFrmFmtTbl; }
     const SwCharFmts* GetCharFmts() const      { return pCharFmtTbl;}
 
-    /* LayoutFormate (Rahmen, DrawObjecte), mal const mal nicht */
+    /* LayoutFormats (frames, DrawObjects), sometimes const sometimes not  */
     const SwSpzFrmFmts* GetSpzFrmFmts() const  { return pSpzFrmFmtTbl; }
           SwSpzFrmFmts* GetSpzFrmFmts()                { return pSpzFrmFmtTbl; }
 
@@ -1252,7 +1251,7 @@ public:
     SwCharFmt* FindCharFmtByName( const String& rName ) const
         {      return (SwCharFmt*)FindFmtByName( (SvPtrarr&)*pCharFmtTbl, rName ); }
 
-    /* Formatcollections (Vorlagen) */
+    /* Formatcollections (styles) */
     // TXT
     const SwTxtFmtColl* GetDfltTxtFmtColl() const { return pDfltTxtFmtColl; }
     const SwTxtFmtColls *GetTxtFmtColls() const { return pTxtFmtCollTbl; }
@@ -1280,7 +1279,7 @@ public:
 
     void ChkCondColls();
 
-        // GRF
+    // GRF
     const SwGrfFmtColl* GetDfltGrfFmtColl() const      { return pDfltGrfFmtColl; }
     const SwGrfFmtColls *GetGrfFmtColls() const                { return pGrfFmtCollTbl; }
     SwGrfFmtColl *MakeGrfFmtColl(const String &rFmtName,
@@ -1288,7 +1287,7 @@ public:
     SwGrfFmtColl* FindGrfFmtCollByName( const String& rName ) const
         {      return (SwGrfFmtColl*)FindFmtByName( (SvPtrarr&)*pGrfFmtCollTbl, rName ); }
 
-        // Tabellen-Formate
+    // Table formating
     const SwFrmFmts* GetTblFrmFmts() const     { return pTblFrmFmtTbl; }
           SwFrmFmts* GetTblFrmFmts()           { return pTblFrmFmtTbl; }
     sal_uInt16 GetTblFrmFmtCount( sal_Bool bUsed ) const;
@@ -1297,33 +1296,34 @@ public:
     void           DelTblFrmFmt( SwTableFmt* pFmt );
     SwTableFmt* FindTblFmtByName( const String& rName, sal_Bool bAll = sal_False ) const;
 
-    //Rahmenzugriff
-    //iterieren ueber Flys - fuer Basic-Collections
+    //Access to frames.
+    //Iterate over Flys - forr Basic-Collections.
     sal_uInt16 GetFlyCount( FlyCntType eType = FLYCNTTYPE_ALL) const;
     SwFrmFmt* GetFlyNum(sal_uInt16 nIdx, FlyCntType eType = FLYCNTTYPE_ALL);
 
-    // kopiere die Formate in die eigenen Arrays und returne diese
+    // Copy formats in own arrays and return them.
     SwFrmFmt  *CopyFrmFmt ( const SwFrmFmt& );
     SwCharFmt *CopyCharFmt( const SwCharFmt& );
     SwTxtFmtColl* CopyTxtColl( const SwTxtFmtColl& rColl );
     SwGrfFmtColl* CopyGrfColl( const SwGrfFmtColl& rColl );
 
-        // ersetze alle Formate mit denen aus rSource
+    // Replace all formats with those from rSource.
     void ReplaceStyles( SwDoc& rSource );
 
-    // erfrage ob die Absatz-/Zeichen-/Rahmen-/Seiten - Vorlage benutzt wird
+    // Query if style (paragraph- / character- / frame- / page-) is used.
     sal_Bool IsUsed( const SwModify& ) const;
     sal_Bool IsUsed( const SwNumRule& ) const;
 
-        // setze den Namen der neu geladenen Dokument-Vorlage
+    // Set name of newly loaded document template.
     sal_uInt16 SetDocPattern( const String& rPatternName );
-        // gebe den Dok-VorlagenNamen zurueck. !!! Kann auch 0 sein !!!
+
+    // Return name of document template. Can be 0!
     String* GetDocPattern( sal_uInt16 nPos ) const { return aPatternNms[nPos]; }
 
-        // Loesche alle nicht referenzierten FeldTypen
-    void GCFieldTypes();                               // impl. in docfld.cxx
+    // Delete all unreferenced field types.
+    void GCFieldTypes();       // impl. in docfld.cxx
 
-        // akt. Dokument mit Textbausteindokument verbinden/erfragen
+    // Query / connect current document with glossary document.
     void SetGlossaryDoc( SwDoc* pDoc ) { pGlossaryDoc = pDoc; }
 
     // travel over PaM Ring
@@ -1342,27 +1342,28 @@ public:
     sal_uInt16 GetPageCount() const;
     const Size GetPageSize( sal_uInt16 nPageNum, bool bSkipEmptyPages ) const;
 
-        //PageDescriptor-Schnittstelle
+    // PageDescriptor interface.
     sal_uInt16 GetPageDescCnt() const { return aPageDescs.Count(); }
     const SwPageDesc& GetPageDesc( const sal_uInt16 i ) const { return *aPageDescs[i]; }
     SwPageDesc* FindPageDescByName( const String& rName,
                                     sal_uInt16* pPos = 0 ) const;
 
-        // kopiere den gesamten PageDesc - ueber Dokumentgrenzen und "tief"!
-        // optional kann das kopieren der PoolFmtId, -HlpId verhindert werden
+    // Copy the complete PageDesc - beyond document and "deep"!
+    // Optionally copying of PoolFmtId, -HlpId can be prevented.
     void CopyPageDesc( const SwPageDesc& rSrcDesc, SwPageDesc& rDstDesc,
                         sal_Bool bCopyPoolIds = sal_True );
 
-        // kopiere die Kopzeile (mit dem Inhalt!) aus dem SrcFmt
-        // ins DestFmt ( auch ueber Doc grenzen hinaus!)
+    // Copy header (with contents) from SrcFmt to DestFmt
+    // (can also be copied into other document).
     void CopyHeader( const SwFrmFmt& rSrcFmt, SwFrmFmt& rDestFmt )
         { CopyPageDescHeaderFooterImpl( true, rSrcFmt, rDestFmt ); }
-        // kopiere die Fusszeile (mit dem Inhalt!) aus dem SrcFmt
-        // ins DestFmt ( auch ueber Doc grenzen hinaus!)
+
+    // Copy footer (with contents) from SrcFmt to DestFmt.
+    // (can also be copied into other document).
     void CopyFooter( const SwFrmFmt& rSrcFmt, SwFrmFmt& rDestFmt )
         { CopyPageDescHeaderFooterImpl( false, rSrcFmt, rDestFmt ); }
 
-        //fuer Reader
+    //For Reader.
 
     SwPageDesc * GetPageDesc( const String & rName );
     SwPageDesc& _GetPageDesc( sal_uInt16 i ) const { return *aPageDescs[i]; }
@@ -1383,14 +1384,14 @@ public:
     // correct this.
     void CheckDefaultPageFmt();
 
-        // Methoden fuer die Verzeichnisse:
-        // - Verzeichnismarke einfuegen loeschen travel
+    // Methods for tables/indices.
+
     sal_uInt16 GetCurTOXMark( const SwPosition& rPos, SwTOXMarks& ) const;
     void DeleteTOXMark( const SwTOXMark* pTOXMark );
     const SwTOXMark& GotoTOXMark( const SwTOXMark& rCurTOXMark,
                                 SwTOXSearch eDir, sal_Bool bInReadOnly );
 
-        // - Verzeichnis einfuegen, und bei Bedarf erneuern
+    //Insert/Renew table/indes.
     const SwTOXBaseSection* InsertTableOf( const SwPosition& rPos,
                                             const SwTOXBase& rTOX,
                                             const SfxItemSet* pSet = 0,
@@ -1408,7 +1409,7 @@ public:
     sal_Bool SetTOXBaseName(const SwTOXBase& rTOXBase, const String& rName);
     void SetTOXBaseProtection(const SwTOXBase& rTOXBase, sal_Bool bProtect);
 
-    // nach einlesen einer Datei alle Verzeichnisse updaten
+    // After reading file update all tables/indices.
     void SetUpdateTOX( bool bFlag = true )     { mbUpdateTOX = bFlag; }
     bool IsUpdateTOX() const                   { return mbUpdateTOX; }
 
@@ -1429,7 +1430,7 @@ public:
     bool IsInXMLImport() const { return mbInXMLImport; }
     void SetInXMLImport( bool bNew ) { mbInXMLImport = bNew; }
 
-    // - Verzeichnis-Typen verwalten
+    // Manage types of tables/indices.
     sal_uInt16 GetTOXTypeCount( TOXTypes eTyp ) const;
     const SwTOXType* GetTOXType( TOXTypes eTyp, sal_uInt16 nId ) const;
     sal_Bool DeleteTOXType( TOXTypes eTyp, sal_uInt16 nId );
@@ -1439,31 +1440,34 @@ public:
     const SwTOXBase*   GetDefaultTOXBase( TOXTypes eTyp, sal_Bool bCreate = sal_False );
     void                               SetDefaultTOXBase(const SwTOXBase& rBase);
 
-    // - Schluessel fuer die Indexverwaltung
+    // Key for management of index.
     sal_uInt16 GetTOIKeys( SwTOIKeyType eTyp, SvStringsSort& rArr ) const;
 
-    // Sortieren Tabellen Text
+    // Sort table text.
     sal_Bool SortTbl(const SwSelBoxes& rBoxes, const SwSortOptions&);
     sal_Bool SortText(const SwPaM&, const SwSortOptions&);
 
-        // korrigiere die im Dokument angemeldeten SwPosition-Objecte,
-        // wie z.B. die ::com::sun::star::text::Bookmarks oder die Verzeichnisse.
-        // ist bMoveCrsr gesetzt, verschiebe auch die Crsr
+    // Correct the SwPosition-Objects that are registered with the document
+    // e. g. ::com::sun::star::text::Bookmarks or tables/indices.
+    // If bMoveCrsr is set move Crsr too.
 
-        // Setzt alles in rOldNode auf rNewPos + Offset
+    // Set everything in rOldNode on rNewPos + Offset.
     void CorrAbs( const SwNodeIndex& rOldNode, const SwPosition& rNewPos,
                     const xub_StrLen nOffset = 0, sal_Bool bMoveCrsr = sal_False );
-        // Setzt alles im Bereich von [rStartNode, rEndNode] nach rNewPos
+
+    // Set everything in the range of [rStartNode, rEndNode] to rNewPos.
     void CorrAbs( const SwNodeIndex& rStartNode, const SwNodeIndex& rEndNode,
                     const SwPosition& rNewPos, sal_Bool bMoveCrsr = sal_False );
-        // Setzt alles im Bereich von rRange nach rNewPos
+
+    // Set everything in this range from rRange to rNewPos.
     void CorrAbs( const SwPaM& rRange, const SwPosition& rNewPos,
                     sal_Bool bMoveCrsr = sal_False );
-        // Setzt alles in rOldNode auf relative Pos
+
+    // Set everything in rOldNode to relative Pos.
     void CorrRel( const SwNodeIndex& rOldNode, const SwPosition& rNewPos,
                     const xub_StrLen nOffset = 0, sal_Bool bMoveCrsr = sal_False );
 
-        // GliederungsRegeln erfragen / setzen
+    // Query / set rules for Outline.
     inline SwNumRule* GetOutlineNumRule() const
     {
         return pOutlineRule;
@@ -1471,16 +1475,15 @@ public:
     void SetOutlineNumRule( const SwNumRule& rRule );
     void PropagateOutlineRule();
 
-    // Gliederung - hoch-/runterstufen
+    // Outline - promote / demote.
     sal_Bool OutlineUpDown( const SwPaM& rPam, short nOffset = 1 );
-    // Gliederung - hoch-/runtermoven
+
+    // Ountline - move up / move down.
     sal_Bool MoveOutlinePara( const SwPaM& rPam, short nOffset = 1);
-        // zu diesem Gliederungspunkt
+
     sal_Bool GotoOutline( SwPosition& rPos, const String& rName ) const;
-    // die Aenderungen an den Gliederungsvorlagen in die OutlineRule uebernehmen
 
-        // setzt, wenn noch keine Numerierung, sonst wird geaendert
-        // arbeitet mit alten und neuen Regeln, nur Differenzen aktualisieren
+    // Accept changes of outline styles for OUtlineRule.
     // re-use unused 3rd parameter
     // Add optional parameter <bResetIndentAttrs> - default value FALSE.
     // If <bResetIndentAttrs> equals true, the indent attributes "before text"
@@ -1522,18 +1525,18 @@ public:
     sal_uInt16 FindNumRule( const String& rName ) const;
     SwNumRule* FindNumRulePtr( const String& rName ) const;
 
-    // loeschen geht nur, wenn die ::com::sun::star::chaos::Rule niemand benutzt!
+    // Deletion only possible if ::com::sun::star::chaos::Rule is not used!
     sal_Bool RenameNumRule(const String & aOldName, const String & aNewName,
                            BOOL bBroadcast = FALSE);
     sal_Bool DelNumRule( const String& rName, BOOL bBroadCast = FALSE );
     String GetUniqueNumRuleName( const String* pChkStr = 0, sal_Bool bAutoNum = sal_True ) const;
 
-    void UpdateNumRule();      // alle invaliden Updaten
+    void UpdateNumRule();      // Update all invalids.
     void ChgNumRuleFmts( const SwNumRule& rRule, const String * pOldName = 0 );
     sal_Bool ReplaceNumRule( const SwPosition& rPos, const String& rOldRule,
                         const String& rNewRule );
 
-        // zum naechsten/vorhergehenden Punkt auf gleicher Ebene
+    // Goto next/previous on same level.
     sal_Bool GotoNextNum( SwPosition&, sal_Bool bOverUpper = sal_True,
                         sal_uInt8* pUpper = 0, sal_uInt8* pLower = 0 );
     sal_Bool GotoPrevNum( SwPosition&, sal_Bool bOverUpper = sal_True,
@@ -1570,29 +1573,28 @@ public:
                                     String& sListId,
                                     const bool bInvestigateStartNode = false );
 
-        // Absaetze ohne Numerierung, aber mit Einzuegen
+    // Paragraphs without numbering but with indents.
     sal_Bool NoNum( const SwPaM& );
-        // Loeschen, Splitten der Aufzaehlungsliste
+
+    // Delete, splitting of numbering list.
     void DelNumRules( const SwPaM& );
 
     // Invalidates all numrules
     void InvalidateNumRules();
 
-        // Hoch-/Runterstufen
     sal_Bool NumUpDown( const SwPaM&, sal_Bool bDown = sal_True );
-        // Bewegt selektierte Absaetze (nicht nur Numerierungen)
-        // entsprechend des Offsets. (negativ: zum Doc-Anf.)
+
+    // Move selected paragraphes (not only numberings)
+    // according to offsets. (if negative: go to doc start).
     sal_Bool MoveParagraph( const SwPaM&, long nOffset = 1, sal_Bool bIsOutlMv = sal_False );
-        // No-/Numerierung ueber Delete/Backspace ein/abschalten
+
     sal_Bool NumOrNoNum( const SwNodeIndex& rIdx, sal_Bool bDel = sal_False);
-        // Animation der Grafiken stoppen
+
     void StopNumRuleAnimations( OutputDevice* );
 
-        // fuege eine neue Tabelle auf der Position rPos ein. (es
-        // wird vor dem Node eingefuegt !!)
-        //     fuer AutoFormat bei der Eingabe: dann muessen die Spalten
-        //     auf die vordefinierten Breite gesetzt werden. Im Array stehen die
-        //     Positionen der Spalten!! (nicht deren Breite!)
+    // Insert new table at position rPos (will be inserted before Node!).
+    // For AutoFormat at input: columns have to be set at predefined width.
+    // The array holds the positions of the columns (not their widths).
     /* new parameter bCalledFromShell:
 
        TRUE: called from shell -> propagate existing adjust item at
@@ -1610,20 +1612,22 @@ public:
                                 BOOL bCalledFromShell = FALSE,
                                 BOOL bNewModel = TRUE );
 
-    // steht der Index in einer Tabelle, dann returne den TableNode sonst 0
+    // If index is in a table, return TableNode, else 0.
                  SwTableNode* IsIdxInTbl( const SwNodeIndex& rIdx );
     inline const SwTableNode* IsIdxInTbl( const SwNodeIndex& rIdx ) const;
 
-        // erzeuge aus dem makierten Bereich eine ausgeglichene Tabelle
+    // Create a balanced table out of the selected range.
     const SwTable* TextToTable( const SwInsertTableOptions& rInsTblOpts, // HEADLINE_NO_BORDER,
                                 const SwPaM& rRange, sal_Unicode cCh,
                                 short eAdjust,
                                 const SwTableAutoFmt* = 0 );
+
     // text to table conversion - API support
     const SwTable* TextToTable( const std::vector< std::vector<SwNodeRange> >& rTableNodes );
-        // erzeuge aus der Tabelle wieder normalen Text
+
     sal_Bool TableToText( const SwTableNode* pTblNd, sal_Unicode cCh );
-        // einfuegen von Spalten/Zeilen in der Tabelle
+
+    // Create columns / rows in table.
     sal_Bool InsertCol( const SwCursor& rCursor,
                     sal_uInt16 nCnt = 1, sal_Bool bBehind = sal_True );
     sal_Bool InsertCol( const SwSelBoxes& rBoxes,
@@ -1632,21 +1636,24 @@ public:
                     sal_uInt16 nCnt = 1, sal_Bool bBehind = sal_True );
     sal_Bool InsertRow( const SwSelBoxes& rBoxes,
                     sal_uInt16 nCnt = 1, sal_Bool bBehind = sal_True );
-        // loeschen von Spalten/Zeilen in der Tabelle
+
+    // Delete Colums/Rows in table.
     sal_Bool DeleteRowCol( const SwSelBoxes& rBoxes, bool bColumn = false );
     sal_Bool DeleteRow( const SwCursor& rCursor );
     sal_Bool DeleteCol( const SwCursor& rCursor );
-        // teilen / zusammenfassen von Boxen in der Tabelle
+
+    // Split / concatenate boxes in table.
     sal_Bool SplitTbl( const SwSelBoxes& rBoxes, sal_Bool bVert = sal_True,
                        sal_uInt16 nCnt = 1, sal_Bool bSameHeight = sal_False );
-        // returnt den enum TableMergeErr
+
+    // Return enum TableMergeErr.
     sal_uInt16 MergeTbl( SwPaM& rPam );
     String GetUniqueTblName() const;
     sal_Bool IsInsTblFormatNum() const;
     sal_Bool IsInsTblChangeNumFormat() const;
     sal_Bool IsInsTblAlignNum() const;
 
-        // aus der FEShell wg.. Undo und bModified
+    // From FEShell (for Undo and BModified).
     void GetTabCols( SwTabCols &rFill, const SwCursor* pCrsr,
                     const SwCellFrm* pBoxFrm = 0 ) const;
     void SetTabCols( const SwTabCols &rNew, sal_Bool bCurRowOnly,
@@ -1656,25 +1663,27 @@ public:
     void SetTabRows( const SwTabCols &rNew, BOOL bCurColOnly, const SwCursor* pCrsr,
                      const SwCellFrm* pBoxFrm = 0 );
 
-    // Direktzugriff fuer Uno
+    // Direct access for UNO.
     void SetTabCols(SwTable& rTab, const SwTabCols &rNew, const SwTabCols &rOld,
                                     const SwTableBox *pStart, sal_Bool bCurRowOnly);
 
     void SetRowsToRepeat( SwTable &rTable, USHORT nSet );
 
-        // AutoFormat fuer die Tabelle/TabellenSelection
+    // AutoFormat for table/table selection.
     sal_Bool SetTableAutoFmt( const SwSelBoxes& rBoxes, const SwTableAutoFmt& rNew );
-        // Erfrage wie attributiert ist
+
+    // Query attributes.
     sal_Bool GetTableAutoFmt( const SwSelBoxes& rBoxes, SwTableAutoFmt& rGet );
-        // setze das InsertDB als Tabelle Undo auf:
+
+    // Set up InsertDB as table Undo:
     void AppendUndoForInsertFromDB( const SwPaM& rPam, BOOL bIsTable );
-        // setze die Spalten/Zeilen/ZTellen Breite/Hoehe
+
     sal_Bool SetColRowWidthHeight( SwTableBox& rAktBox, sal_uInt16 eType,
                                 SwTwips nAbsDiff, SwTwips nRelDiff );
     SwTableBoxFmt* MakeTableBoxFmt();
     SwTableLineFmt* MakeTableLineFmt();
-    // teste ob die Box ein numerischen Wert darstellt und aender dann ggfs.
-    // das Format der Box
+
+    // Check if box has numerical valule. Change format of box if required.
     void ChkBoxNumFmt( SwTableBox& rAktBox, sal_Bool bCallUpdate );
     void SetTblBoxFormulaAttrs( SwTableBox& rBox, const SfxItemSet& rSet );
     void ClearBoxNumAttrs( const SwNodeIndex& rNode );
@@ -1691,34 +1700,35 @@ public:
                               const String* pTblName = 0,
                               sal_Bool* pFullTblProtection = 0 );
 
-    // Tabelle an der Position in der GrundLine aufsplitten, sprich eine
-    // neue Tabelle erzeugen.
+    // Split table at baseline position, i.e. create a new table.
     sal_Bool SplitTable( const SwPosition& rPos, sal_uInt16 eMode = 0,
                         sal_Bool bCalcNewSize = sal_False );
-    // und die Umkehrung davon. rPos muss in der Tabelle stehen, die bestehen
-    // bleibt. Das Flag besagt ob die aktuelle mit der davor oder dahinter
-    // stehenden vereint wird.
+
+    // And vice versa: rPos must be in the table that remains. The flag indicates
+    // whether the current table is merged with the one before or behind it.
     sal_Bool MergeTable( const SwPosition& rPos, sal_Bool bWithPrev = sal_True,
                         sal_uInt16 nMode = 0 );
 
-    // Charts der angegebenen Tabelle zum Update bewegen
+    // Make charts of given table update.
     void UpdateCharts( const String &rName ) const;
-    // update all charts, for that exists any table
+
+    // Update all charts, for that exists any table.
     void UpdateAllCharts()          { DoUpdateAllCharts( 0 ); }
-    // Tabelle wird umbenannt und aktualisiert die Charts
+
+    // Table is renamed and refreshes charts.
     void SetTableName( SwFrmFmt& rTblFmt, const String &rNewName );
 
-    // returne zum Namen die im Doc gesetzte Referenz
+    // Return the reference in document that is set for name.
     const SwFmtRefMark* GetRefMark( const String& rName ) const;
-    // returne die RefMark per Index - fuer Uno
+
+    // Return RefMark via index - for UNO.
     const SwFmtRefMark* GetRefMark( sal_uInt16 nIndex ) const;
-    // returne die Namen aller im Doc gesetzten Referenzen.
-    //         Ist der ArrayPointer 0 dann returne nur, ob im Doc. eine RefMark
-    // gesetzt ist
+
+    // Return names of all references that are set in document.
+    // If array pointer is 0 return only whether a RefMark is set in document.
     sal_uInt16 GetRefMarks( SvStringsDtor* = 0 ) const;
 
-    //Einfuegen einer Beschriftung - falls ein FlyFormat erzeugt wird, so
-    // returne dieses.
+    // Insert label. If a FlyFormat is created, return it.
     SwFlyFrmFmt* InsertLabel( const SwLabelType eType, const String &rTxt, const String& 
rSeparator,
                     const String& rNumberingSeparator,
                     const sal_Bool bBefore, const sal_uInt16 nId, const ULONG nIdx,
@@ -1728,14 +1738,14 @@ public:
         const String &rTxt, const String& rSeparator, const String& rNumberSeparator,
         const sal_uInt16 nId, const String& rCharacterStyle, SdrObject& rObj );
 
-    // erfrage den Attribut Pool
+    // Query attribute pool.
     const SwAttrPool& GetAttrPool() const      { return *mpAttrPool; }
           SwAttrPool& GetAttrPool()            { return *mpAttrPool; }
 
-    // suche ueber das Layout eine EditShell und ggfs. eine ViewShell
+    // Search an EditShell or, if appropriate, a ViewShell via layout.
     SwEditShell* GetEditShell( ViewShell** ppSh = 0 ) const;
 
-    // OLE 2.0-Benachrichtung
+    // OLE 2.0-notification.
     inline              void  SetOle2Link(const Link& rLink) {aOle2Link = rLink;}
     inline const Link& GetOle2Link() const {return aOle2Link;}
 
@@ -1758,86 +1768,89 @@ public:
        The model should not have anything to do with a shell.
        Unnecessary compile/link time dependency.
     */
-    // Pointer auf die SfxDocShell vom Doc, kann 0 sein !!!
+
+    // Pointer to SfxDocShell from Doc. Can be 0!!
           SwDocShell* GetDocShell()            { return pDocShell; }
     const SwDocShell* GetDocShell() const      { return pDocShell; }
     void SetDocShell( SwDocShell* pDSh );
 
-    // falls beim Kopieren von OLE-Nodes eine DocShell angelegt werden muss,
-    // dann MUSS der Ref-Pointer besetzt sein!!!!
+    // If a DocShell has to be created during copying of OLE-Nodes
+    // the Ref-Pointer MUST be set!
     SfxObjectShellRef* GetRefForDocShell()            { return pDocShRef; }
     void SetRefForDocShell( SfxObjectShellRef* p )    { pDocShRef = p; }
 
-    // fuer die TextBausteine - diese habe nur ein SvPersist zur
-    // Verfuegung
+    // For Autotexts? (Textbausteine) They have only one SVPersist at their disposal.
     SfxObjectShell* GetPersist() const;
 
-    // Pointer auf den Storage des SfxDocShells, kann 0 sein !!!
+    // Pointer to storage of SfxDocShells. Can be 0!!!
     ::com::sun::star::uno::Reference< ::com::sun::star::embed::XStorage > GetDocStorage();
 
-        // abfrage/setze Flag, ob das Dokument im asynchronen Laden ist
+    // Query / set flag indicating if document is loaded asynchronously at this moment.
     bool IsInLoadAsynchron() const             { return mbInLoadAsynchron; }
     void SetInLoadAsynchron( bool bFlag )       { mbInLoadAsynchron = bFlag; }
 
-    // erzeuge um das zu Servende Object eine Selektion
     sal_Bool SelectServerObj( const String& rStr, SwPaM*& rpPam,
                             SwNodeRange*& rpRange ) const;
 
-    // fuer Drag&Move: ( z.B. RefMarks "verschieben" erlauben )
+    // For Drag&Move: (e.g. allow "moving" of RefMarks)
     bool IsCopyIsMove() const              { return mbCopyIsMove; }
     void SetCopyIsMove( bool bFlag )        { mbCopyIsMove = bFlag; }
 
-    // fuers Draw-Undo: Aktionen auf Flys wollen wir selbst behandeln
+    // For Draw-Undo: actions on Flys we want to handle ourselves.
     bool IsNoDrawUndoObj() const           { return mbNoDrawUndoObj; }
     void SetNoDrawUndoObj( bool bFlag )    { mbNoDrawUndoObj = bFlag; }
     SwDrawContact* GroupSelection( SdrView& );
     void UnGroupSelection( SdrView& );
     sal_Bool DeleteSelection( SwDrawView& );
 
-    // Invalidiert OnlineSpell-WrongListen
+    // Invalidates OnlineSpell-WrongLists.
     void SpellItAgainSam( sal_Bool bInvalid, sal_Bool bOnlyWrong, sal_Bool bSmartTags );
     void InvalidateAutoCompleteFlag();
 
     void SetCalcFieldValueHdl(Outliner* pOutliner);
 
-    // erfrage ob die ::com::sun::star::util::URL besucht war. Uebers Doc, falls nur ein 
::com::sun::star::text::Bookmark
-    // angegeben ist. Dann muss der Doc. Name davor gesetzt werden!
+    // Query if ::com::sun::star::util::URL was visited.
+    // Query via Doc, if only a ::com::sun::star::text::Bookmark has been given.
+    // In this case the document name has to be set in front.
     sal_Bool IsVisitedURL( const String& rURL ) const;
 
-    // speicher die akt. Werte fuer die automatische Aufnahme von Ausnahmen
-    // in die Autokorrektur
+    // Save current values for automatic registration of exceptions in Autocorrection.
     void SetAutoCorrExceptWord( SwAutoCorrExceptWord* pNew );
     SwAutoCorrExceptWord* GetAutoCorrExceptWord()              { return pACEWord; }
 
     const SwFmtINetFmt* FindINetAttr( const String& rName ) const;
 
-    // rufe ins dunkle Basic, mit evt. Return String
+    // Call into intransparent Basic; expect possible Return String.
     sal_Bool ExecMacro( const SvxMacro& rMacro, String* pRet = 0, SbxArray* pArgs = 0 );
-    // rufe ins dunkle Basic/JavaScript
+
+    // Call into intransparent Basic / JavaScript.
     sal_uInt16 CallEvent( sal_uInt16 nEvent, const SwCallMouseEvent& rCallEvent,
                         sal_Bool bChkPtr = sal_False, SbxArray* pArgs = 0,
                         const Link* pCallBack = 0 );
 
+    // Adjust left margin via object bar.
     // linken Rand ueber Objectleiste einstellen (aenhlich dem Stufen von
     // Numerierungen), optional kann man "um" den Offset stufen oder "auf"
-    // die Position gestuft werden (bModulus = sal_True)
+    // die Position gestuft werden (bModulus = sal_True).
     void MoveLeftMargin( const SwPaM& rPam, sal_Bool bRight = sal_True,
                         sal_Bool bModulus = sal_True );
 
-    // Numberformatter erfragen
+    // Query NumberFormatter.
     inline              SvNumberFormatter* GetNumberFormatter( sal_Bool bCreate = sal_True );
     inline const SvNumberFormatter* GetNumberFormatter( sal_Bool bCreate = sal_True ) const;
 
-    // loesche den nicht sichtbaren ::com::sun::star::ucb::Content aus dem Document, wie z.B.:
-    // versteckte Bereiche, versteckte Absaetze
+    // Delete non-visible ::com::sun::star::ucb::Content from document, e.g.
+    // hidden ranges, hidden paragraphes.
     sal_Bool RemoveInvisibleContent();
+
     //restore the invisible content if it's available on the undo stack
     sal_Bool RestoreInvisibleContent();
-    // replace fields by text - mailmerge support
+
+    // Replace fields by text - mailmerge support.
     BOOL ConvertFieldsToText();
 
-    // erzeuge Anhand der vorgebenen Collection Teildokumente
-    // falls keine angegeben ist, nehme die Kapitelvorlage der 1. Ebene
+    // Create sub-documents according to given collection.
+    // If no collection is given, use chapter styles for 1st level.
     sal_Bool GenerateGlobalDoc( const String& rPath,
                                 const SwTxtFmtColl* pSplitColl = 0 );
     sal_Bool GenerateGlobalDoc( const String& rPath, int nOutlineLevel = 0 );  
@@ -1845,32 +1858,34 @@ public:
                                 const SwTxtFmtColl* pSplitColl = 0 );
     sal_Bool GenerateHTMLDoc( const String& rPath, int nOutlineLevel = 0 );    
 
-    //  vergleiche zwei Dokument miteinander
+    //  Compare two documents.
     long CompareDoc( const SwDoc& rDoc );
-    // merge zweier Dokumente
+
+    // Merge two documents.
     long MergeDoc( const SwDoc& rDoc );
-    // setze Kommentar-Text fuers Redline, das dann per AppendRedline
-    // hereinkommt. Wird vom Autoformat benutzt. 0-Pointer setzt den Modus
-    // wieder zurueck. Die SequenceNummer ist fuers UI-seitige zusammen-
-    // fassen von Redlines.
+
+    // Set comment-text for Redline. It then comes in via AppendRedLine.
+    // Used by AutoFormat. 0-pointer resets mode.
+    // Sequence number is for conjoining of Redlines by the UI.
     void SetAutoFmtRedlineComment( const String* pTxt, sal_uInt16 nSeqNo = 0 );
 
     bool IsAutoFmtRedline() const           { return mbIsAutoFmtRedline; }
     void SetAutoFmtRedline( bool bFlag )    { mbIsAutoFmtRedline = bFlag; }
 
-    // fuer AutoFormat: mit Undo/Redlining - Behandlung
+    // For AutoFormat: with Undo/Redlining.
     void SetTxtFmtCollByAutoFmt( const SwPosition& rPos, sal_uInt16 nPoolId,
                                 const SfxItemSet* pSet = 0 );
     void SetFmtItemByAutoFmt( const SwPaM& rPam, const SfxItemSet& );
 
-    // !!!NUR fuer die SW-Textblocks!! beachtet kein LAYOUT!!!
-    void ClearDoc();           // loescht den gesamten Inhalt.
+    // Only for SW-textbloxks! Does not pay any attention to layout!
+    void ClearDoc();           // Deletes all content!
 
-    // erfrage / setze die Daten fuer die PagePreView
+    // Query /set data for PagePreView.
     const SwPagePreViewPrtData* GetPreViewPrtData() const { return pPgPViewPrtData; }
-    // wenn der Pointer == 0 ist, dann wird im Doc der Pointer zerstoert,
-    // ansonsten wird das Object kopiert.
-    // Der Pointer geht NICHT in den Besitz des Doc's!!
+
+    // If pointer == 0 destroy pointer in document.
+    // Else copy object.
+    // Pointer is not transferred to ownership by document!
     void SetPreViewPrtData( const SwPagePreViewPrtData* pData );
 
     // update all modified OLE-Objects. The modification is called over the
@@ -1878,13 +1893,12 @@ public:
     void SetOLEObjModified()
     {  if( GetRootFrm() ) aOLEModifiedTimer.Start(); }
 
-    // -------------------- Uno - Schnittstellen ---------------------------
+    // -------------------- Uno - Interfaces ---------------------------
     const SwUnoCrsrTbl& GetUnoCrsrTbl() const          { return *pUnoCrsrTbl; }
     SwUnoCrsr* CreateUnoCrsr( const SwPosition& rPos, sal_Bool bTblCrsr = sal_False );
-    // -------------------- Uno - Schnittstellen ---------------------------
 
-    // -------------------- FeShell - Schnittstellen -----------------------
-    // !!!!! diese gehen immer davon aus, das ein Layout existiert  !!!!
+    // -------------------- FeShell - Interfaces -----------------------
+    // !!! These assume always an existing layout !!!
     sal_Bool ChgAnchor( const SdrMarkList& _rMrkList,
                         RndStdIds _eAnchorType,
                         const sal_Bool _bSameOnly,
@@ -1912,22 +1926,21 @@ public:
     int Chain( SwFrmFmt &rSource, const SwFrmFmt &rDest );
     void Unchain( SwFrmFmt &rFmt );
 
-    // fuers Copy/Move aus der FrmShell
+    // For Copy/Move from FrmShell.
     SdrObject* CloneSdrObj( const SdrObject&, sal_Bool bMoveWithinDoc = sal_False,
                             sal_Bool bInsInPage = sal_True );
 
     //
-    // -------------------- FeShell - Schnittstellen Ende ------------------
+    // -------------------- FeShell - Interface end ------------------
 
-    // Schnittstelle fuer die TextInputDaten - ( fuer die Texteingabe
-    // von japanischen/chinesischen Zeichen)
+    // Interface for TextInputData - for text input of Chinese and Japanese.
     SwExtTextInput* CreateExtTextInput( const SwPaM& rPam );
     void DeleteExtTextInput( SwExtTextInput* pDel );
     SwExtTextInput* GetExtTextInput( const SwNode& rNd,
                                 xub_StrLen nCntntPos = STRING_NOTFOUND) const;
     SwExtTextInput* GetExtTextInput() const;
 
-    // Schnistelle fuer den Zugriff auf die AutoComplete-Liste
+    // Interface for access to AutoComplete-List.
     static SwAutoCompleteWord& GetAutoCompleteWords() { return *pACmpltWords; }
 
     bool ContainsMSVBasic() const          { return mbContains_MSVBasic; }
@@ -2059,8 +2072,7 @@ public:
     SfxObjectShell* CreateCopy(bool bCallInitNew) const;
 };
 
-// Diese Methode wird im Dtor vom SwDoc gerufen und loescht den Cache
-// der Konturobjekte
+// This method is called in Dtor of SwDoc and deletes cache of ContourObjects.
 void ClrContourCache();
 
 inline const SwTableNode* SwDoc::IsIdxInTbl( const SwNodeIndex& rIdx ) const
-- 
1.7.1

Context

Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.