Translation of German comments.

6 files changed, 123 insertions, 131 deletions

diff --git a/sw/inc/io.hxx b/sw/inc/io.hxx
index 2a2cc76eed61..7d1665c4f72b 100644
--- a/sw/inc/io.hxx
+++ b/sw/inc/io.hxx
@@ -25,9 +25,10 @@
  * for a copy of the LGPLv3 License.
  *
  ************************************************************************/
-// eigene Klasse fuer IO, die die systemunabhaengige Darstellung
-// uebernimmt (bytes dreht, Character konvertiert)
-// das Schreiben erfolgt aus Effizienzgruenden binaer
+
+// Special class for IO. Used for system-independent representation
+// (change of byte-order, conversion of characters)
+// Writes in binary format for efficiency.
 #ifndef _IO_HXX
 #define _IO_HXX
 
@@ -51,7 +52,7 @@ class SwIOin {
 private:
         SvFileStream aStr; //$ ifstream
 public:
-    // Stream wird im entsprechenden Mode erzeugt.
+    // Stream is created in respective mode.
     SwIOin(const String &rFilename, StreamMode nMode =
                                     STREAM_READ | STREAM_NOCREATE );
 
@@ -65,8 +66,8 @@ public:
     SwIOin& operator>>(unsigned long& val);
     String ReadString();
     KeyCode ReadKeyCode();
-    // kann erweitert werden fuer weitere Arrays von
-    // Basistypen; nLen ist die Anzahl der Elemente
+    // Can be extended for more arrays of base types.
+    // nLen is count of elements.
     SwIOin& Read(char *buf, unsigned nLen);
 
     int operator!() { return aStr.GetError() != SVSTREAM_OK; }
@@ -80,7 +81,7 @@ private:
     void _write(const char *buf, unsigned size);
     SvFileStream aStr; //$ ofstream
 public:
-    // Stream wird im entsprechenden Mode erzeugt.
+    // Stream is created in respective mode.
     SwIOout( const String &rFilename, StreamMode nMode =
                                       STREAM_WRITE | STREAM_NOCREATE );
     SwIOout& operator<<(char val);
@@ -93,8 +94,8 @@ public:
     SwIOout& operator<<(unsigned long val);
     SwIOout& operator<<(const String &);
     SwIOout& operator<<(const KeyCode &);
-    // kann erweitert werden fuer weitere Arrays von
-    // Basistypen; nLen ist die Anzahl der Elemente
+    // Can be extended for more arrays of base types.
+    // nLen is count of elements.
     SwIOout& Write(const char *buf, unsigned nLen);
 
     int operator!() { return aStr.GetError() != SVSTREAM_OK; }
@@ -109,7 +110,7 @@ private:
     SvFileStream aStr; //$ fstream
 
 public:
-    // Stream wird im entsprechenden Mode erzeugt.
+    // Stream is created in respective mode.
     SwIOinout(const String &rFilename, StreamMode nMode =
                                        STREAM_READWRITE  | STREAM_NOCREATE );
 
@@ -123,8 +124,8 @@ public:
     SwIOinout& operator>>(unsigned long& val);
     String ReadString();
     KeyCode ReadKeyCode();
-    // kann erweitert werden fuer weitere Arrays von
-    // Basistypen; nLen ist die Anzahl der Elemente
+    // Can be extended for more arrays of base types.
+    // nLen is count of elements.
     SwIOinout& Read(char *buf, unsigned nLen);
     SwIOinout& Read(unsigned short *buf, unsigned nLen );
 
@@ -138,8 +139,8 @@ public:
     SwIOinout& operator<<(unsigned long val);
     SwIOinout& operator<<(const String &);
     SwIOinout& operator<<(const KeyCode &);
-    // kann erweitert werden fuer weitere Arrays von
-    // Basistypen; nLen ist die Anzahl der Elemente
+    // Can be extended for more arrays of base types.
+    // nLen is count of elements.
     SwIOinout& Write(const char *buf, unsigned nLen);
 
     int operator!() { return aStr.GetError() != SVSTREAM_OK; }
diff --git a/sw/inc/mdiexp.hxx b/sw/inc/mdiexp.hxx
index 42464463fed3..3a4132f77ad7 100644
--- a/sw/inc/mdiexp.hxx
+++ b/sw/inc/mdiexp.hxx
@@ -45,7 +45,7 @@ extern void ScrollMDI(ViewShell* pVwSh, const SwRect &, USHORT nRangeX, USHORT n
 extern BOOL IsScrollMDI(ViewShell* pVwSh, const SwRect &);
 extern void SizeNotify(ViewShell* pVwSh, const Size &);
 
-//Update der Statusleiste, waehrend einer Action.
+// Update of status bar during an action.
 extern void PageNumNotify( ViewShell* pVwSh,
                             USHORT nPhyNum,
                             USHORT nVirtNum,
@@ -67,10 +67,10 @@ LAYOUT_NS Dialog* GetSearchDialog();
 void RepaintPagePreview( ViewShell* pVwSh, const SwRect& rRect );
 
 // ndgrf.cxx
-// alle QuickDraw-Bitmaps des speziellen Docs loeschen
+// Delete all QuickDraw-bitmaps of the specific Document.
 void DelAllGrfCacheEntries( SwDoc* pDoc );
 
-// ChgMode fuer Tabellen aus der Konfiguration lesen
+// Read ChgMode for tables from configuration.
 TblChgMode GetTblChgDefaultMode();
 
 BOOL JumpToSwMark( ViewShell* pVwSh, const UniString& rMark );
diff --git a/sw/inc/modcfg.hxx b/sw/inc/modcfg.hxx
index ac142f37c7d5..5081d3ad76e2 100644
--- a/sw/inc/modcfg.hxx
+++ b/sw/inc/modcfg.hxx
@@ -86,7 +86,7 @@ class SwInsertConfig : public utl::ConfigItem
 
     SvGlobalName        aGlobalNames[5];
 
-    sal_Bool            bInsWithCaption;       //Insert/Caption/Automatic   // Objekte beschriftet einfuegen
+    sal_Bool            bInsWithCaption;       //Insert/Caption/Automatic
     sal_Bool            bCaptionOrderNumberingFirst; //#i61007# caption order starting with numbering
 
     SwInsertTableOptions    aInsTblOpts;
@@ -113,9 +113,9 @@ class SwTableConfig : public utl::ConfigItem
     USHORT      nTblVInsert;        //int Table/Insert/Column
     TblChgMode  eTblChgMode;        //int Table/Change/Effect
 
-    sal_Bool    bInsTblFormatNum;       // Table/Input/NumberRecognition        // Automatische Zahlenerkennung
-    sal_Bool    bInsTblChangeNumFormat; // Table/Input/NumberFormatRecognition  // Automatische Zahlenformaterkennung
-    sal_Bool    bInsTblAlignNum;        // Table/Input/Alignment                // Zahlen ausrichten
+    sal_Bool    bInsTblFormatNum;       // Table/Input/NumberRecognition        // Automatic recognition of numbers.
+    sal_Bool    bInsTblChangeNumFormat; // Table/Input/NumberFormatRecognition  // Automatic recognition of number formats.
+    sal_Bool    bInsTblAlignNum;        // Table/Input/Alignment                // Align numbers.
 
     const com::sun::star::uno::Sequence<rtl::OUString>& GetPropertyNames();
     public:
diff --git a/sw/inc/ndarr.hxx b/sw/inc/ndarr.hxx
index a2018ae53151..a2f24ff53506 100644
--- a/sw/inc/ndarr.hxx
+++ b/sw/inc/ndarr.hxx
@@ -87,39 +87,39 @@ class SW_DLLPUBLIC SwNodes: private BigPtrArray
     friend class SwNode;
     friend class SwNodeIndex;
 
-    SwNodeIndex* pRoot;                 // Liste aller Indizies auf Nodes
+    SwNodeIndex* pRoot;                 // List of all indices on nodes.
 
     void InsertNode( const SwNodePtr pNode,
                      const SwNodeIndex& rPos );
     void InsertNode( const SwNodePtr pNode,
                      ULONG nPos );
 
-    SwDoc* pMyDoc;                      // in diesem Doc ist das Nodes-Array
+    SwDoc* pMyDoc;                      // This Doc contains the nodes-array.
 
-    SwNode *pEndOfPostIts, *pEndOfInserts,  // das sind die festen Bereiche
+    SwNode *pEndOfPostIts, *pEndOfInserts,  // These are the fixed ranges.
            *pEndOfAutotext, *pEndOfRedlines,
            *pEndOfContent;
 
-    mutable SwOutlineNodes* pOutlineNds;        // Array aller GliederiungsNodes
+    mutable SwOutlineNodes* pOutlineNds;        // Array of all outline nodes.
 
-    BOOL bInNodesDel : 1;               // falls rekursiv aufgerufen wird
-                                        // Num/Outline nicht aktualisierem
-    BOOL bInDelUpdOutl : 1;             // Flags fuers aktualisieren von Outl.
-    BOOL bInDelUpdNum : 1;              // Flags fuers aktualisieren von Outl.
+    BOOL bInNodesDel : 1;               // In Case of recursive calling.
+                                        // Do not update Num/Outline.
+    BOOL bInDelUpdOutl : 1;             // Flag for updating of Outline.
+    BOOL bInDelUpdNum : 1;              // Flag for updating of Outline.
 
-    // fuer dier Verwaltung der Indizies
+    // For administering indices.
     void RegisterIndex( SwNodeIndex& rIdx );
     void DeRegisterIndex( SwNodeIndex& rIdx );
     void RemoveNode( ULONG nDelPos, ULONG nLen, BOOL bDel );
 
-    // Aktionen auf die Nodes
+    // Actions on the nodes.
     void SectionUpDown( const SwNodeIndex & aStart, const SwNodeIndex & aEnd );
     void DelNodes( const SwNodeIndex& rStart, ULONG nCnt = 1 );
 
     void ChgNode( SwNodeIndex& rDelPos, ULONG nSize,
                   SwNodeIndex& rInsPos, BOOL bNewFrms );
 
-    void UpdtOutlineIdx( const SwNode& );   // Update ab Node alle OutlineNodes
+    void UpdtOutlineIdx( const SwNode& );   // Update all OutlineNodes starting from Node.
 
     void _CopyNodes( const SwNodeRange&, const SwNodeIndex&,
                     BOOL bNewFrms = TRUE, BOOL bTblInsDummyNode = FALSE ) const;
@@ -137,8 +137,8 @@ public:
     SwNodePtr operator[]( ULONG n ) const
         { return (SwNodePtr)BigPtrArray::operator[] ( n ); }
 
-    // impl. steht im ndindex.hxx - sollte moeglichst bald auf die
-    // neue Schnittstelle angepasst werden
+    // Implementaition in ndindex.hxx - it should be adapted to the
+    // new interface as soon as possible.
     inline SwNodePtr operator[]( const SwNodeIndex& rIdx ) const;
 
     ULONG Count() const { return BigPtrArray::Count(); }
@@ -154,22 +154,22 @@ public:
     void ForEach( const SwNodeIndex& rStart, const SwNodeIndex& rEnd,
                     FnForEach_SwNodes fnForEach, void* pArgs = 0 );
 
-    // eine noch leere Section
+    // A still empty section.
     SwNode& GetEndOfPostIts() const     { return *pEndOfPostIts; }
-    // Section fuer alle Fussnoten
+    // Section fpr all footnotes.
     SwNode& GetEndOfInserts() const     { return *pEndOfInserts; }
-    // Section fuer alle Flys/Header/Footers
+    // Section for all Flys/Header/Footers.
     SwNode& GetEndOfAutotext() const    { return *pEndOfAutotext; }
-    // Section fuer alle Redlines
+    // Section for all Redlines.
     SwNode& GetEndOfRedlines() const    { return *pEndOfRedlines; }
-    // das ist der letzte EndNode einer SonderSection. Hier nach kommt nur
-    // noch die normale ContentSection (also der BodyText)
+    // This is the last EndNode of a special section. After it
+    // there is only the regular ContentSection (i.e. the BodyText).
     SwNode& GetEndOfExtras() const      { return *pEndOfRedlines; }
-    // die normale ContentSection (also der BodyText)
+    // Regular ContentSection (i.e. the BodyText).
     SwNode& GetEndOfContent() const     { return *pEndOfContent; }
 
-    // ist das NodesArray das normale vom Doc? (nicht das UndoNds, .. )
-    // Implementierung steht im doc.hxx (weil man dazu Doc kennen muss) !
+    // Is the NodesArray the regular one of Doc? (and not the UndoNds, ...)
+    // Implementation in doc.hxx (because one needs to know Doc for it) !
     BOOL IsDocNodes() const;
 
     USHORT GetSectionLevel(const SwNodeIndex &rIndex) const;
@@ -194,25 +194,25 @@ public:
     SwCntntNode* GoNext(SwNodeIndex *) const;
     SwCntntNode* GoPrevious(SwNodeIndex *) const;
 
-    //Gehe zum naechsten/vorherigen Cntnt/Tabellennode, fuer den
-    //es LayoutFrames gibt, dabei Kopf-/Fusszeilen/Rahmen etc. nicht verlassen
+    // Go to next/previous Cntnt/Table-node for which LayoutFrames exist.
+    // While doing this do not leave Header/Footer/Frame etc.
     SwNode* GoNextWithFrm(SwNodeIndex *) const;
     SwNode* GoPreviousWithFrm(SwNodeIndex *) const;
 
-    // zum naechsten Content-Node, der nicht geschuetzt oder versteckt ist
-    // (beides auf FALSE ==> GoNext/GoPrevious!!!)
+    // Go to next content-node that is not protected or hidden
+    // (Both set FALSE ==> GoNext/GoPrevious!!!).
     SwCntntNode* GoNextSection( SwNodeIndex *, int bSkipHidden  = TRUE,
                                            int bSkipProtect = TRUE ) const;
     SwCntntNode* GoPrevSection( SwNodeIndex *, int bSkipHidden  = TRUE,
                                            int bSkipProtect = TRUE ) const;
 
-    // erzeuge ein leere Section von Start und EndNode. Darf nur gerufen
-    // werden, wenn eine neue Section mit Inhalt erzeugt werden soll.
-    // Zum Beispiel bei den Filtern/Undo/...
+    // Create an empty section of Start- and EndNote. It may be called
+    // only if a new section with content is to be created,
+    // e.g. at filters/Undo/...
     SwStartNode* MakeEmptySection( const SwNodeIndex& rIdx,
                                     SwStartNodeType = SwNormalStartNode );
 
-    // die Impl. von "Make...Node" stehen in den angegebenen .ccx-Files
+    // Implementations of "Make...Node" are in the given .cxx-files.
     SwTxtNode *MakeTxtNode( const SwNodeIndex & rWhere,
                             SwTxtFmtColl *pColl,
                             SwAttrSet* pAutoAttr = 0 ); // in ndtxt.cxx
@@ -244,30 +244,29 @@ public:
                             SwGrfFmtColl *pColl,
                             SwAttrSet* pAutoAttr ); // in ndole.cxx
 
-        // Array aller GliederiungsNodes;
+    // Array of all OutlineNodes.
     const SwOutlineNodes& GetOutLineNds() const;
 
-    //void UpdateOutlineNode( const SwNode&, BYTE nOldLevel, BYTE nNewLevel );//#outline level,removed by zhaojianwei
-        // alle Nodes Updaten - Rule/Format-Aenderung
+    // void UpdateOutlineNode( const SwNode&, BYTE nOldLevel, BYTE nNewLevel );//#outline level,removed by zhaojianwei
+
+    // Update all Nodes - Rule/Format-Change.
     void UpdateOutlineNode(SwNode & rNd);
 
-        // fuege die Nodes fuer die Tabelle ein
-        // wenn Lines angegeben, erzeuge die Matrix aus Lines & Boxen
-        // ansonsten nur die Anzahl von Boxen.
-    /*
-       New parameter pAttrSet: If pAttrSet is non-null and contains an
-       adjust item it is propagated to the table cells. If there is an
-       adjust in pCntntTxtColl or pHeadlineTxtColl this adjust item
-       overrides the item in pAttrSet.
+    // Insert nodes for tables. If Lines is given, create the matrix
+    // from lines and boxes, else only the count of boxes.
+
+    // New parameter pAttrSet: If pAttrSet is non-null and contains an
+    // adjust item it is propagated to the table cells. If there is an
+    // adjust in pCntntTxtColl or pHeadlineTxtColl this adjust item
+    // overrides the item in pAttrSet.
 
-     */
     SwTableNode* InsertTable( const SwNodeIndex& rNdIdx,
                         USHORT nBoxes, SwTxtFmtColl* pCntntTxtColl,
                         USHORT nLines = 0, USHORT nRepeat = 0,
                         SwTxtFmtColl* pHeadlineTxtColl = 0,
                         const SwAttrSet * pAttrSet = 0);
 
-        // erzeuge aus dem makierten Bereich eine ausgeglichene Tabelle
+    // Create balanced table from selected range.
     SwTableNode* TextToTable( const SwNodeRange& rRange, sal_Unicode cCh,
                                 SwTableFmt* pTblFmt,
                                 SwTableLineFmt* pLineFmt,
@@ -285,33 +284,34 @@ public:
                                 SwTxtFmtColl* pTxtColl
                                 /*, SwUndo... pUndo*/ );
 
-        // erzeuge aus der Tabelle wieder normalen Text
+
+    // Create regular text from what was table.
     BOOL TableToText( const SwNodeRange& rRange, sal_Unicode cCh,
                         SwUndoTblToTxt* = 0 );
-        // steht im untbl.cxx und darf nur vom Undoobject gerufen werden
+    // Is in untbl.cxx and may called only by Undo-object.
     SwTableNode* UndoTableToText( ULONG nStt, ULONG nEnd,
                         const SwTblToTxtSaves& rSavedData );
 
-        // fuege in der Line, vor der InsPos eine neue Box ein. Das Format
-        // wird von der nachfolgenden (vorhergenden;wenn an Ende) genommen
-        // in der Line muss schon eine Box vorhanden sein !
+    // Insert a new box in the line before InsPos. Its format
+    // is taken from the following one (or from the previous one if we are
+    // at the end). In the line there must be a box already.
     BOOL InsBoxen( SwTableNode*, SwTableLine*, SwTableBoxFmt*,
-                        // Formate fuer den TextNode der Box
+                        // Formats for TextNode of box.
                         SwTxtFmtColl*, const SfxItemSet* pAutoAttr,
                         USHORT nInsPos, USHORT nCnt = 1 );
-        // Splittet eine Tabelle in der Grund-Zeile, in der der Index steht.
-        // Alle GrundZeilen dahinter wandern in eine neue Tabelle/-Node.
-        // Ist das Flag bCalcNewSize auf TRUE, wird fuer beide neuen Tabellen
-        // die neue SSize aus dem Max der Boxen errechnet; vorrausgesetzt,
-        // die SSize ist "absolut" gesetzt (LONG_MAX)
-        // (Wird zur Zeit nur fuer den RTF-Parser benoetigt)
+    // Splits a table at the base-line which contains the index.
+    // All base lines behind it are moved to a new table/ -node.
+    // Is the flag bCalcNewSize set to TRUE, the new SSize for both
+    // tables is calculated from the Maximum of the boxes, provided
+    // SSize is set "absolute" (LONG_MAX).
+    // (Momentarily this is needed only for the RTF-parser.)
     SwTableNode* SplitTable( const SwNodeIndex& rPos, BOOL bAfter = TRUE,
                                 BOOL bCalcNewSize = FALSE );
-        // fuegt 2 Tabellen, die hintereinander stehen, wieder zusammen
+    // Two Tables that are following one another are merged.
     BOOL MergeTable( const SwNodeIndex& rPos, BOOL bWithPrev = TRUE,
                     USHORT nMode = 0, SwHistory* pHistory = 0 );
 
-        // fuege eine neue SwSection ein
+    // Insert a new SwSection.
     SwSectionNode* InsertTextSection(SwNodeIndex const& rNdIdx,
                                 SwSectionFmt& rSectionFmt,
                                 SwSectionData const&,
@@ -320,23 +320,21 @@ public:
                                 bool const bInsAtStart = true,
                                 bool const bCreateFrms = true);
 
-        // in welchem Doc steht das Nodes-Array ?
+    // Which Doc contains the nodes-array?
             SwDoc* GetDoc()         { return pMyDoc; }
     const   SwDoc* GetDoc() const   { return pMyDoc; }
 
-        // suche den vorhergehenden [/nachfolgenden ] ContentNode oder
-        // TabellenNode mit Frames. Wird kein Ende angeben, dann wird mit
-        // dem FrameIndex begonnen; ansonsten, wird mit dem vor rFrmIdx und
-        // dem hintern pEnd die Suche gestartet. Sollte kein gueltiger Node
-        // gefunden werden, wird 0 returnt. rFrmIdx zeigt auf dem Node mit
-        // Frames
+    // Search previous / next content node or table node with frames.
+    // If no end is given begin with the FrameIndex, else start search
+    // with that before rFrmIdx and pEnd at the back.
+    // If no valid node is found, return 0. rFrmIdx points to the node with frames.
     SwNode* FindPrvNxtFrmNode( SwNodeIndex& rFrmIdx,
                                 const SwNode* pEnd = 0 ) const;
 
     SwNode * DocumentSectionStartNode(SwNode * pNode) const;
     SwNode * DocumentSectionEndNode(SwNode * pNode) const;
 private:
-    // privater Constructor, weil nie kopiert werden darf !!
+    // Private constructor because copying is never allowed!!
     SwNodes( const SwNodes & rNodes );
 };
 
diff --git a/sw/inc/ndgrf.hxx b/sw/inc/ndgrf.hxx
index ba462e514670..a50a8b8434ba 100644
--- a/sw/inc/ndgrf.hxx
+++ b/sw/inc/ndgrf.hxx
@@ -39,20 +39,18 @@ class SwGrfFmtColl;
 class SwDoc;
 class GraphicAttr;
 class SvStorage;
-// --------------------
+
 // SwGrfNode
-// --------------------
 class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode
 {
     friend class SwNodes;
 
     GraphicObject aGrfObj;
-    ::sfx2::SvBaseLinkRef refLink;       // falls Grafik nur als Link, dann Pointer gesetzt
+    ::sfx2::SvBaseLinkRef refLink;       // If graphics only as link then pointer is set.
     Size nGrfSize;
     String aNewStrmName;        // SW3/XML: new stream name (either SW3 stream
                                 // name or package url)
-    String aLowResGrf;          // HTML: LowRes Grafik (Ersatzdarstellung bis
-                                //      die normale (HighRes) geladen ist.
+    String aLowResGrf;          // HTML: LowRes graphics (substitute until regular HighRes graphics is loaded).
     BOOL bTransparentFlagValid  :1;
     BOOL bInSwapIn              :1;
 
@@ -60,9 +58,8 @@ class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode
     BOOL bChgTwipSize           :1;
     BOOL bChgTwipSizeFromPixel  :1;
     BOOL bLoadLowResGrf         :1;
-    BOOL bFrameInPaint          :1; //Um Start-/EndActions im Paint (ueber
-                                    //SwapIn zu verhindern.
-    BOOL bScaleImageMap         :1; //Image-Map in SetTwipSize skalieren
+    BOOL bFrameInPaint          :1; // To avoid Start-/EndActions in Paint via SwapIn.
+    BOOL bScaleImageMap         :1; // Scale image map in SetTwipSize.
 
     boost::shared_ptr< SwAsyncRetrieveInputStreamThreadConsumer > mpThreadConsumer;
     bool mbLinkedInputStreamReady;
@@ -74,7 +71,7 @@ class SW_DLLPUBLIC SwGrfNode: public SwNoTxtNode
                const Graphic* pGraphic,
                SwGrfFmtColl* pGrfColl,
                SwAttrSet* pAutoAttr = 0 );
-    // Ctor fuer Einlesen (SW/G) ohne Grafik
+    // Ctor for reading (SW/G) without graphics.
     SwGrfNode( const SwNodeIndex& rWhere,
                const String& rGrfName, const String& rFltName,
                SwGrfFmtColl* pGrfColl,
@@ -169,29 +166,30 @@ public:
     virtual SwCntntNode* MakeCopy( SwDoc*, const SwNodeIndex& ) const;
 #ifndef _FESHVIEW_ONLY_INLINE_NEEDED
 
-    // erneutes Einlesen, falls Graphic nicht Ok ist. Die
-    // aktuelle wird durch die neue ersetzt.
+    // Re-read in case graphic was not OK. The current one
+    // gets replaced by the new one.
     BOOL ReRead( const String& rGrfName, const String& rFltName,
                  const Graphic* pGraphic = 0,
                  const GraphicObject* pGrfObj = 0,
                  BOOL bModify = TRUE );
-    // Laden der Grafik unmittelbar vor der Anzeige
+    // Loading of graphic immediately before displaying.
     short SwapIn( BOOL bWaitForData = FALSE );
-        // Entfernen der Grafik, um Speicher freizugeben
+    // Remove graphic in order to free memory.
     short SwapOut();
-        // Zugriff auf den Storage-Streamnamen
+    // Access to storage stream-name.
     void SetStreamName( const String& r ) { aGrfObj.SetUserData( r ); }
     void SetNewStreamName( const String& r ) { aNewStrmName = r; }
-    // is this node selected by any shell?
+    // Is this node selected by any shell?
     BOOL IsSelected() const;
 #endif
 
-        // Der Grafik sagen, dass sich der Node im Undobereich befindet
+    // Communicate to graphic that node is in Undo-range.
     virtual BOOL SavePersistentData();
     virtual BOOL RestorePersistentData();
 
 #ifndef _FESHVIEW_ONLY_INLINE_NEEDED
-        // Abfrage der Link-Daten
+
+    // Query link-data.
     BOOL IsGrfLink() const                  { return refLink.Is(); }
     inline BOOL IsLinkedFile() const;
     inline BOOL IsLinkedDDE() const;
@@ -199,11 +197,11 @@ public:
     BOOL GetFileFilterNms( String* pFileNm, String* pFilterNm ) const;
     void ReleaseLink();
 
-    // Skalieren einer Image-Map: Die Image-Map wird um den Faktor
-    // zwischen Grafik-Groesse und Rahmen-Groesse vergroessert/verkleinert
+    // Scale an image-map: the image-map becomes zoomed in / out by
+    // factor between graphic-size and border-size.
     void ScaleImageMap();
 
-    // returns the with our graphic attributes filled Graphic-Attr-Structure
+    // Returns the with our graphic attributes filled Graphic-Attr-Structure.
     GraphicAttr& GetGraphicAttr( GraphicAttr&, const SwFrm* pFrm ) const;
 
 #endif
@@ -217,8 +215,8 @@ public:
     bool IsAsyncRetrieveInputStreamPossible() const;
 };
 
-// ----------------------------------------------------------------------
-// Inline methods from Node.hxx - erst hier ist der TxtNode bekannt !!
+
+// Inline methods from Node.hxx - it is only now that we know TxtNode!!
 inline       SwGrfNode   *SwNode::GetGrfNode()
 {
      return ND_GRFNODE == nNodeType ? (SwGrfNode*)this : 0;
diff --git a/sw/inc/ndhints.hxx b/sw/inc/ndhints.hxx
index 29e8c13bd214..bd47ced1eba8 100644
--- a/sw/inc/ndhints.hxx
+++ b/sw/inc/ndhints.hxx
@@ -35,7 +35,7 @@
 #include "swtypes.hxx"
 
 class SwTxtNode;
-class SwRegHistory;                 // steht im RolBck.hxx
+class SwRegHistory;                 // Is in RolBck.hxx.
 class SwTxtAttr;
 class SwTxtAttrNesting;
 
@@ -55,26 +55,21 @@ SW_DLLPRIVATE SwTxtAttr*
 MakeRedlineTxtAttr( SwDoc & rDoc, SfxPoolItem& rAttr );
 
 
-/*
- * Ableitung der Klasse SwpHints ueber den Umweg ueber SwpHts, da
- * lediglich die Klasse SwTxtNode Attribute einfuegen und
- * loeschen koennen soll. Anderen Klassen wie den Frames steht
- * lediglich ein lesender Zugriff ueber den Index-Operator zur
- * Verfuegung.
- * Groesse beim Anlegen gleich 1, weil nur dann ein Array erzeug wird, wenn
- * auch ein Hint eingefuegt wird.
- */
+// Class SwpHints is derived indirectly via SwpHts, because only the
+// class SwTxtNode should be allowed to insert and remove attributes.
+// Other classes like the Frames are given only reading access via
+// the index-operator.
+// Size when created is 1 because an array is created only if
+// also a hint is inserted.
+
+ // Class SwpHtStart/End
 
-/*************************************************************************
- *                      class SwpHtStart/End
- *************************************************************************/
 
 SV_DECL_PTRARR_SORT(SwpHtStart,SwTxtAttr*,1,1)
 SV_DECL_PTRARR_SORT(SwpHtEnd,SwTxtAttr*,1,1)
 
-/*************************************************************************
- *                      class SwpHintsArr
- *************************************************************************/
+// Class SwpHintsArr
+
 
 /// the Hints array
 class SwpHintsArray
@@ -118,9 +113,9 @@ public:
 #endif
 };
 
-/*************************************************************************
- *                      class SwpHints
- *************************************************************************/
+
+// Class SwpHints
+
 
 // public interface
 class SwpHints : public SwpHintsArray
@@ -194,12 +189,12 @@ public:
     DECL_FIXEDMEMPOOL_NEWDEL(SwpHints)
 };
 
-// Ausgabeoperator fuer die Texthints
+// Output operator for text hints.
 SvStream &operator<<(SvStream &aS, const SwpHints &rHints); //$ ostream
 
-/*************************************************************************
- *                         Inline Implementations
- *************************************************************************/
+
+// Inline Implementations
+
 
 inline USHORT SwpHintsArray::GetStartOf( const SwTxtAttr *pHt ) const
 {