Translation of German commentsTranslation of German comments.

sw/inc/pagedesc.hxx

@@ -32,7 +32,7 @@
 #include <tools/color.hxx>
 #include <tools/string.hxx>
 #include "swdllapi.h"
-#include <swtypes.hxx>  //fuer SwTwips
+#include <swtypes.hxx>  // For SwTwips.
 #include <frmfmt.hxx>
 #include <editeng/numitem.hxx>
 
@@ -40,7 +40,7 @@ class SfxPoolItem;
 class SwTxtFmtColl;
 class SwNode;
 
-//Separator line adjustment
+// Separator line adjustment.
 enum SwFtnAdj
 {
     FTNADJ_LEFT,
@@ -48,16 +48,16 @@ enum SwFtnAdj
     FTNADJ_RIGHT
 };
 
-//footnote information
+// Footnote information.
 class SW_DLLPUBLIC SwPageFtnInfo
 {
-    SwTwips     nMaxHeight;     //maximum height of the footnote area.
-    ULONG       nLineWidth;     //width of separator line
-    Color       aLineColor;     //color of the separator line
-    Fraction    aWidth;         //percentage width of the separator line.
-    SwFtnAdj    eAdj;           //line adjustment.
-    SwTwips     nTopDist;       //distance between body and separator.
-    SwTwips     nBottomDist;    //distance between separator and first footnote
+    SwTwips     nMaxHeight;     // Maximum height of the footnote area.
+    ULONG       nLineWidth;     // Width of separator line.
+    Color       aLineColor;     // Color of the separator line.
+    Fraction    aWidth;         // Percentage width of the separator line.
+    SwFtnAdj    eAdj;           // Line adjustment.
+    SwTwips     nTopDist;       // Distance between body and separator.
+    SwTwips     nBottomDist;    // Distance between separator and first footnote.
 
 public:
     SwTwips     GetHeight() const       { return nMaxHeight; }
@@ -84,51 +84,51 @@ public:
 };
 
 /*
- * Verwendung des UseOnPage (eUse) und der FrmFmt'e
+ *  Use of UseOnPage (eUse) and of FrmFmts
  *
- *  RIGHT   - aMaster nur fuer rechte Seiten, linke  Seiten immer leer.
- *  LEFT    - aLeft fuer linke  Seiten, rechte Seiten immer leer.
- *            aLeft ist eine Kopie des Master.
- *  ALL     - aMaster fuer rechte Seiten, aLeft fuer Linke Seiten.
- *            aLeft ist eine Kopie des Master.
- *  MIRROR  - aMaster fuer rechte Seiten, aLeft fuer linke Seiten.
- *            aLeft ist eine Kopie des Master, Raender sind gespiegelt.
+ *  RIGHT   - aMaster only for right hand (odd) pages, left hand (even) pages
+ *            always empty.
+ *  LEFT    - aLeft for left-hand pages, right-hand pages always empty.
+ *            aLeft is a copy of master.
+ *  ALL     - aMaster for right hand pages, aLeft for left hand pages.
+ *          - aLeft is a copy of master.
+ * MIRROR   - aMaster for right hand pages, aLeft for left hand pagers.
+ *            aLeft is a copy of master, margins are mirrored.
  *
- * UI dreht auschliesslich am Master! aLeft wird beim Chg am Dokument
- * enstprechend dem eUse eingestellt.
+ * UI works exclusively on master! aLeft is adjusted on Chg at document
+ * according to eUse.
  *
- * Damit es die Filter etwas einfacher haben werden weitere Werte im
- * eUse untergebracht:
+ * In order to simplify the work of the filters some more values are placed
+ * into eUse:
  *
- * HEADERSHARE - Headerinhalt auf beiden Seiten gleich
- * FOOTERSHARE - Footerinhalt auf beiden Seiten gleich
+ * HEADERSHARE - Content of header is equal on left and right hand pages.
+ * FOOTERSHARE - Content of footer is equal on left and right hand pages.
  *
- * Die Werte werden bei den entsprechenden Get-/Set-Methden ausmaskiert.
- * Zugriff auf das volle eUse inclusive der Header-Footer information
- * per ReadUseOn(), WriteUseOn() (fuer Filter und CopyCTor)!
- *
- * Die FrmFormate fuer Header/Footer werden anhand der Attribute fuer
- * Header/Footer vom UI am Master eingestellt (Hoehe, Raender, Hintergrund...);
- * Header/Footer fuer die Linke Seite werden entsprechen kopiert bzw.
- * gespielt (Chg am Dokument).
- * Das jew. Attribut fuer den Inhalt wird automatisch beim Chg am
- * Dokument versorgt (entsprechen den SHARE-informationen werden Inhalte
- * erzeugt bzw. entfernt).
+ * The values are masked out in the respective getter and setter methods.
+ * Access to complete eUse including the information on header and footer
+ * via ReadUseOn(), WriteUseOn() (fuer Filter und CopyCTor)!
  *
+ * The Frmformats for header/footer are adjusted by the UI according to
+ * the attributes for header and footer at master (height, margin, back-
+ * ground ...)
+ * Header/footer for left hand pages are copied or mirrored (Chg at
+ * document).
+ * The respective attribute for content is cared for automatically on Chg at
+ * document (contents are created or removed according to SHARE-information).
  */
 
 typedef USHORT UseOnPage;
 namespace nsUseOnPage
 {
-    const UseOnPage PD_NONE           = 0x0000; //for internal use only.
+    const UseOnPage PD_NONE           = 0x0000; // For internal use only.
     const UseOnPage PD_LEFT           = 0x0001;
     const UseOnPage PD_RIGHT          = 0x0002;
     const UseOnPage PD_ALL            = 0x0003;
     const UseOnPage PD_MIRROR         = 0x0007;
     const UseOnPage PD_HEADERSHARE    = 0x0040;
     const UseOnPage PD_FOOTERSHARE    = 0x0080;
-    const UseOnPage PD_NOHEADERSHARE  = 0x00BF; //for internal use only
-    const UseOnPage PD_NOFOOTERSHARE  = 0x007F; //for internal use only
+    const UseOnPage PD_NOHEADERSHARE  = 0x00BF; // For internal use only.
+    const UseOnPage PD_NOFOOTERSHARE  = 0x007F; // For internal use only.
 }
 
 class SW_DLLPUBLIC SwPageDesc : public SwModify
@@ -140,18 +140,18 @@ class SW_DLLPUBLIC SwPageDesc : public SwModify
     SvxNumberType   aNumType;
     SwFrmFmt    aMaster;
     SwFrmFmt    aLeft;
-    SwDepend    aDepend;    // wg. Registerhaltigkeit
+    SwDepend    aDepend;    // Because of grid alignment (Registerhaltigkeit).
     SwPageDesc *pFollow;
-    USHORT      nRegHeight; // Zeilenabstand und Fontascent der Vorlage
-    USHORT      nRegAscent; // fuer die Registerhaltigkeit
+    USHORT      nRegHeight; // Sentence spacing and fontascent of style.
+    USHORT      nRegAscent; // For grid alignment (Registerhaltigkeit).
     UseOnPage   eUse;
     BOOL        bLandscape;
 
-    //Fussnoteninformationen
+    // Footnote information.
     SwPageFtnInfo aFtnInfo;
 
-    //Wird zum Spiegeln vom Chg (Doc) gerufen.
-    //Kein Abgleich an anderer Stelle.
+    // Called for mirroring of Chg (doc).
+    // No adjustment at any other place.
     SW_DLLPRIVATE void Mirror();
 
     SW_DLLPRIVATE void ResetAllAttr( sal_Bool bLeft );
@@ -193,8 +193,8 @@ public:
     inline void ResetAllMasterAttr();
     inline void ResetAllLeftAttr();
 
-    //Mit den folgenden Methoden besorgt sich das Layout ein Format
-    //um eine Seite erzeugen zu koennen
+    // Layout uses the following methods to obtain a format in order
+    // to be able to create a page.
     inline SwFrmFmt *GetRightFmt();
     inline const SwFrmFmt *GetRightFmt() const;
     inline SwFrmFmt *GetLeftFmt();
@@ -214,7 +214,7 @@ public:
     virtual void Modify( SfxPoolItem *pOldValue, SfxPoolItem *pNewValue );
     void RegisterChange();
 
-    // erfragen und setzen der PoolFormat-Id
+    // Query and set PoolFormat-Id.
     USHORT GetPoolFmtId() const         { return aMaster.GetPoolFmtId(); }
     void SetPoolFmtId( USHORT nId )     { aMaster.SetPoolFmtId( nId ); }
     USHORT GetPoolHelpId() const        { return aMaster.GetPoolHelpId(); }
@@ -222,7 +222,7 @@ public:
     BYTE GetPoolHlpFileId() const       { return aMaster.GetPoolHlpFileId(); }
     void SetPoolHlpFileId( BYTE nId )   { aMaster.SetPoolHlpFileId( nId ); }
 
-        // erfrage vom Client Informationen
+    // Query information from Client.
     virtual BOOL GetInfo( SfxPoolItem& ) const;
 
     const SwFrmFmt* GetPageFmtOfNode( const SwNode& rNd,

sw/inc/pam.hxx

@@ -28,13 +28,13 @@
 #ifndef _PAM_HXX
 #define _PAM_HXX
 
-#include <stddef.h>         // fuer MemPool
+#include <stddef.h>         // For MemPool.
 #include <tools/gen.hxx>
 #include <tools/mempool.hxx>
-#include <cshtyp.hxx>       // fuer die Funktions-Definitionen
-#include <ring.hxx>         // Superklasse
-#include <index.hxx>        // fuer SwIndex
-#include <ndindex.hxx>      // fuer SwNodeIndex
+#include <cshtyp.hxx>       // For function definitions.
+#include <ring.hxx>         // Super class.
+#include <index.hxx>        // For SwIndex.
+#include <ndindex.hxx>      // For SwNodeIndex.
 #include "swdllapi.h"
 
 class SwFmt;
@@ -82,17 +82,17 @@ struct SW_DLLPUBLIC SwPosition
 };
 
 
-// das Ergebnis eines Positions Vergleiches
+// Result of comparing positions.
 enum SwComparePosition {
-    POS_BEFORE,             // Pos1 liegt vor Pos2
-    POS_BEHIND,             // Pos1 liegt hinter Pos2
-    POS_INSIDE,             // Pos1 liegt vollstaendig in Pos2
-    POS_OUTSIDE,            // Pos2 liegt vollstaendig in Pos1
-    POS_EQUAL,              // Pos1 ist genauso gross wie Pos2
-    POS_OVERLAP_BEFORE,     // Pos1 ueberlappt Pos2 am Anfang
-    POS_OVERLAP_BEHIND,     // Pos1 ueberlappt Pos2 am Ende
-    POS_COLLIDE_START,      // Pos1 Start stoesst an Pos2 Ende
-    POS_COLLIDE_END         // Pos1 End stoesst an Pos2 Start
+    POS_BEFORE,             // Pos1 before Pos2.
+    POS_BEHIND,             // Pos1 behind Pos2.
+    POS_INSIDE,             // Pos1 completely contained in Pos2.
+    POS_OUTSIDE,            // Pos2 completely contained in Pos1.
+    POS_EQUAL,              // Pos1 is as large as Pos2.
+    POS_OVERLAP_BEFORE,     // Pos1 overlaps Pos2 at the beginning.
+    POS_OVERLAP_BEHIND,     // Pos1 overlaps Pos2 at the end.
+    POS_COLLIDE_START,      // Pos1 start touches at Pos2 end.
+    POS_COLLIDE_END         // Pos1 end touches at Pos2 start.
 };
 SwComparePosition ComparePosition(
             const SwPosition& rStt1, const SwPosition& rEnd1,
@@ -150,11 +150,11 @@ public:
     // @@@ semantic: no copy assignment for super class Ring.
     SwPaM& operator=( const SwPaM & );
 
-    // Bewegen des Cursors
+    // Movement of cursor.
     BOOL Move( SwMoveFn fnMove = fnMoveForward,
                     SwGoInDoc fnGo = fnGoCntnt );
 
-    // Suchen
+    // Search.
     BYTE Find(  const com::sun::star::util::SearchOptions& rSearchOpt,
                 BOOL bSearchInNotes,
                 utl::TextSearch& rSTxt,
@@ -252,11 +252,11 @@ public:
     const SwPosition& GetBound( bool bOne = true ) const
                             { return bOne ? m_Bound1 : m_Bound2; }
 
-    // erfrage die Seitennummer auf der der Cursor steht
+    // Get number of page which contains cursor.
     USHORT GetPageNum( BOOL bAtPoint = TRUE, const Point* pLayPos = 0 );
 
-    // steht in etwas geschuetztem oder in die Selektion umspannt
-    // etwas geschuetztes.
+    // Is in something protected (readonly) or selection contains
+    // something protected.
     BOOL HasReadonlySel( bool bFormView ) const;
 
     BOOL ContainsPosition(const SwPosition & rPos)

sw/inc/paratr.hxx

@@ -39,28 +39,23 @@
 class SwCharFmt;
 class IntlWrapper;
 
-/*************************************************************************
-|*    class     SwFmtDrop
-*************************************************************************/
-
 #define DROP_WHOLEWORD ((USHORT)0x0001)
 
-//Wenn ein SwFmtDrop Client ist, so ist dies das CharFmt welches den Font fuer
-//die DropCaps beschreibt. Ist es kein Client, so wird von der Formatierung
-//das CharFmt des Absatzes benutzt.
-//Wird das CharFmt verandert, so wird diese Aenderung ueber das Modify des
-//SwFmtDrop an die Absatze propagiert.
+// If SwFmtDrop is a Client, it is the CharFmt that describes the font for the
+// DropCaps. If it is not a Client, formating uses the CharFmt of the paragraph.
+// If the CharFmt is modified, this change is propagated to the paragraphs
+// via the Modify of SwFmtDrop.
 class SW_DLLPUBLIC SwFmtDrop: public SfxPoolItem, public SwClient
 {
-    SwModify* pDefinedIn;   // Modify-Object, in dem der DropCaps steht
-                            // kann nur TxtFmtCollection/TxtNode sein
-    USHORT nDistance;   // Abstand zum Textbeginn
-    USHORT nReadFmt;    // fuer den Sw3-Reader: CharFormat-Id (Pool laden!)
-    BYTE   nLines;       // Anzahl der Zeilen
-    BYTE   nChars;       // Anzahl der Zeichen
-    BOOL   bWholeWord;   // Erstes Wort als Initialen
+    SwModify* pDefinedIn;   // Modify-Object, that contains DropCaps.
+                            // Can only be TxtFmtCollection/TxtNode.
+    USHORT nDistance;       // Distance to beginning of text.
+    USHORT nReadFmt;        // For Sw3-Reader: CharFormat-Id (load Pool!).
+    BYTE   nLines;          // Line count.
+    BYTE   nChars;          // Character count.
+    BOOL   bWholeWord;      // First word with initials.
 public:
-    TYPEINFO(); //Bereits in der Basisklasse SwClient
+    TYPEINFO(); // Already in base class SwClient.
 
     SwFmtDrop();
     virtual ~SwFmtDrop();
@@ -99,10 +94,10 @@ public:
     inline SwCharFmt *GetCharFmt()       { return (SwCharFmt*)pRegisteredIn; }
     void SetCharFmt( SwCharFmt *pNew );
     virtual void Modify( SfxPoolItem*, SfxPoolItem* );
-        // erfrage vom Client Informationen
+    // Get information from Client.
     virtual BOOL GetInfo( SfxPoolItem& ) const;
 
-    // erfrage und setze den Modify-Pointer
+    // Get and set Modify pointer.
     inline const SwModify* GetDefinedIn() const { return pDefinedIn; }
     inline void ChgDefinedIn( const SwModify* pNew )
     { pDefinedIn = (SwModify*)pNew; }
@@ -201,7 +196,7 @@ inline SwParaConnectBorderItem& SwParaConnectBorderItem::operator=(
 
 
 /******************************************************************************
- *  Implementierung der Paragraph-Attribut Methoden vom SwAttrSet
+ *  Implementation of paragraph-attributes methods of SwAttrSet
  ******************************************************************************/
 
 inline const SvxLineSpacingItem &SwAttrSet::GetLineSpacing(BOOL bInP) const
@@ -238,7 +233,7 @@ inline const SwParaConnectBorderItem &SwAttrSet::GetParaConnectBorder(BOOL bInP)
     {   return (const SwParaConnectBorderItem&)Get( RES_PARATR_CONNECT_BORDER, bInP ); }
 
 /******************************************************************************
- *  Implementierung der Paragraph-Attribut Methoden vom SwFmt
+ *  Implementation of paragraph-attributes methods of SwFmt
  ******************************************************************************/
 
 inline const SvxLineSpacingItem &SwFmt::GetLineSpacing(BOOL bInP) const