[Libreoffice] [PATCH] Translations of comments in writer/sw/inc

From ac1f5f1b8160c32dffb7d05b93d8b4b4f72ffe47 Mon Sep 17 00:00:00 2001
From: Christoph Herzog <rhogez@googlemail.com>
Date: Mon, 24 Jan 2011 18:48:46 +0100
Subject: [PATCH] Translations of comments in writer/sw/inc

From ac1f5f1b8160c32dffb7d05b93d8b4b4f72ffe47 Mon Sep 17 00:00:00 2001
From: Christoph Herzog <rhogez@googlemail.com>
Date: Mon, 24 Jan 2011 18:48:46 +0100
Subject: [PATCH] Translations of comments in writer/sw/inc

---
 sw/inc/errhdl.hxx  |   15 ++++-----
 sw/inc/error.h     |    8 ++---
 sw/inc/expfld.hxx  |   86 +++++++++++++++++----------------------------------
 sw/inc/index.hxx   |   16 ++++------
 sw/inc/inetfld.hxx |   20 +++++-------
 5 files changed, 53 insertions(+), 92 deletions(-)

diff --git a/sw/inc/errhdl.hxx b/sw/inc/errhdl.hxx
index 1b89d0a..53c893a 100644
--- a/sw/inc/errhdl.hxx
+++ b/sw/inc/errhdl.hxx
@@ -34,19 +34,19 @@
 #include <sal/types.h>
 #include "swdllapi.h"
 
-extern BOOL bAssert;                           // TRUE, wenn eine ASSERT Box hochkam
+extern BOOL bAssert;                           // TRUE, if an ASSERT Box popped up.
 
 
 // -----------------------------------------------------------------------
-// Ausgabe einer Fehlermeldung inkl. Dateiname und Zeilennummer
-// wo der Fehler auftrat.
-// Die Funktion darf nicht direkt benutzt werden!
+// Return an error message including file name and line number indicating
+// where the error occured.
+// The function may not be used directly!
 // -----------------------------------------------------------------------
 SW_DLLPUBLIC void AssertFail( USHORT, const sal_Char* );
 
 // -----------------------------------------------------------------------
-// Prueft ob die angegebene Bedingung wahr ist, wenn nicht wird eine
-// Fehlermeldung die ueber die ID Identifiziert wird, ausgegeben.
+// Check if the given condition is true. If not, an error message,
+// identified via the ID, will be returned.
 // -----------------------------------------------------------------------
 #define ASSERT_ID( cond, id ) \
     if( !(cond) ) { \
@@ -56,8 +56,7 @@ SW_DLLPUBLIC void AssertFail( USHORT, const sal_Char* );
 
 
 // -----------------------------------------------------------------------
-// Beim Bilden der Produktversion werden alle Debug-Utilities automatisch
-// ignoriert
+// When building for production all debugging utilities are ignored automatically.
 // -----------------------------------------------------------------------
 #else
 #define ASSERT_ID( cond, id )          ;
diff --git a/sw/inc/error.h b/sw/inc/error.h
index 7ca8f71..c9617d0 100644
--- a/sw/inc/error.h
+++ b/sw/inc/error.h
@@ -31,18 +31,16 @@
 
 #define ERR_SWGBASE 25000
 
-/*** Error Codes **********************************************************/
+// Error Codes.
 #define ERR_VAR_IDX                                    (ERR_SWGBASE+ 0)
 #define ERR_OUTOFSCOPE                 (ERR_SWGBASE+ 1)
 
-/* Error Codes fuer Numerierungsregeln */
 #define ERR_NUMLEVEL                           (ERR_SWGBASE+ 2)
 
-/* Error Codes fuer TxtNode */
+// Error Codes for TxtNode.
 #define ERR_NOHINTS                                    (ERR_SWGBASE+ 3)
 
-// von _START bis _END sind in der COREDL.DLL entsprechende Strings
-// abgelegt, die erfragt werden koennen.
+// Strings to be queried are in COREDL.DLL from _START to _END.
 #define ERR_SWGMSG_START                       (ERR_VAR_IDX)
 #define ERR_SWGMSG_END                         (ERR_NOHINTS)
 
diff --git a/sw/inc/expfld.hxx b/sw/inc/expfld.hxx
index 80d33e9..fafd8b8 100644
--- a/sw/inc/expfld.hxx
+++ b/sw/inc/expfld.hxx
@@ -43,11 +43,10 @@ class SwFmtFld;
 class _SetGetExpFlds;
 class SwEditShell;
 
-// Vorwaertsdeklaration: besorge den "Body-TextNode", fuer Exp.Fld in Fly's
-//                                             Header/Footers/Footnodes
+// Forward declaration: get "BodyTxtNode" for exp.fld in Fly's headers/footers/footnotes.
 const SwTxtNode* GetBodyTxtNode( const SwDoc& pDoc, SwPosition& rPos,
                                  const SwFrm& rFrm );
-// Wandlung Address -> Adressen
+
 void ReplacePoint(String& sTmpName, BOOL bWithCommandType = FALSE);
 
 struct _SeqFldLstElem
@@ -70,27 +69,18 @@ public:
     BOOL SeekEntry( const _SeqFldLstElem& , USHORT* pPos = 0 );
 };
 
-/*--------------------------------------------------------------------
-    Beschreibung: Ausdruck
- --------------------------------------------------------------------*/
-
 class SwGetExpFieldType : public SwValueFieldType
 {
 public:
         SwGetExpFieldType(SwDoc* pDoc);
         virtual SwFieldType*    Copy() const;
 
-        // ueberlagert, weil das Get-Field nicht veraendert werden kann
-        // und dann auch nicht aktualisiert werden muss. Aktualisierung
-        // erfolgt beim Aendern von Set-Werten !
+        // Overlay, because get-field cannot be changed and therefore
+        // does not need to be updated. Update at changing of set-values!
 
         virtual void Modify( SfxPoolItem *pOld, SfxPoolItem *pNew );
 };
 
-/*--------------------------------------------------------------------
-    Beschreibung: GetExperession
- --------------------------------------------------------------------*/
-
 class SW_DLLPUBLIC SwGetExpField : public SwFormulaField
 {
     String                     sExpand;
@@ -112,17 +102,19 @@ public:
     inline const String&               GetExpStr() const;
     inline void                                ChgExpStr(const String& rExpand);
 
-    // wird von der Formatierung abgefragt
+    // Called by formating.
     inline BOOL                                IsInBodyTxt() const;
-    // wird von UpdateExpFlds gesetzt (dort ist die Node-Position bekannt)
+
+    // Set by UpdateExpFlds where node position is known.
     inline void                                ChgBodyTxtFlag( BOOL bIsInBody );
-    // fuer Felder in Header/Footer/Footnotes/Flys:
-    // (wird nur von der Formatierung aufgerufen!!)
+
+    // For fields in header/footer/footnotes/flys:
+    // Only called by formating!!
     void                                               ChangeExpansion( const SwFrm&, const 
SwTxtFld& );
 
     virtual    String                          GetCntnt(BOOL bName = FALSE) const;
 
-    // Die Formel aendern
+    // Change formula.
     virtual String                             GetPar2() const;
     virtual void                               SetPar2(const String& rStr);
 
@@ -142,19 +134,14 @@ inline void SwGetExpField::ChgExpStr(const String& rExpand)
 inline const String& SwGetExpField::GetExpStr() const
     { return sExpand;  }
 
-// wird von der Formatierung abgefragt
+// Called by formating.
 inline BOOL SwGetExpField::IsInBodyTxt() const
     { return bIsInBodyTxt; }
 
-// wird von UpdateExpFlds gesetzt (dort ist die Node-Position bekannt)
+// Set by UpdateExpFlds where node position is known.
 inline void SwGetExpField::ChgBodyTxtFlag( BOOL bIsInBody )
     { bIsInBodyTxt = bIsInBody; }
 
-
-/*--------------------------------------------------------------------
-    Beschreibung: Ausdruck setzen
- --------------------------------------------------------------------*/
-
 class SwSetExpField;
 
 class SW_DLLPUBLIC SwSetExpFieldType : public SwValueFieldType
@@ -181,8 +168,7 @@ public:
     BOOL                                       IsDeleted() const               { return bDeleted; }
     void                                       SetDeleted( BOOL b )    { bDeleted = b; }
 
-    // ueberlagert, weil das Set-Field selbst dafuer sorgt, das
-    // es aktualisiert wird.
+    // Overlay, because set-field takes care for its being updated by itself.
     virtual void                       Modify( SfxPoolItem *pOld, SfxPoolItem *pNew );
     inline const String&       GetSetRefName() const;
 
@@ -191,14 +177,15 @@ public:
     USHORT GetSeqFldList( SwSeqFldList& rList );
     String MakeSeqName( USHORT nSeqNo );
 
-    // Seqencefelder ggfs. Kapitelweise numerieren
+    // Number sequence fields chapterwise if required.
     const String& GetDelimiter() const                 { return sDelim; }
     void SetDelimiter( const String& s )       { sDelim = s; }
     BYTE GetOutlineLvl() const                                 { return nLevel; }
     void SetOutlineLvl( BYTE n )                       { nLevel = n; }
     void SetChapter( SwSetExpField& rFld, const SwNode& rNd );
-    // Member nur fuers SwDoc::UpdateExpFld - wird nur waehrend der Laufzeit
-    // von SequencefeldTypen benoetigt!!!
+
+    // Member only for SwDoc::UpdateExpFld.
+    // It is needed only at runtime of sequence field types!
     const SwNode* GetOutlineChgNd() const      { return pOutlChgNd; }
     void SetOutlineChgNd( const SwNode* p )    { pOutlChgNd = p; }
 
@@ -219,10 +206,6 @@ inline const String& SwSetExpFieldType::GetSetRefName() const
     { return sName; }
 
 
-/*--------------------------------------------------------------------
-    Beschreibung: Ausdruck
- --------------------------------------------------------------------*/
-
 class SW_DLLPUBLIC SwSetExpField : public SwFormulaField
 {
     String                     sExpand;
@@ -256,14 +239,14 @@ public:
 
     inline BOOL                                IsSequenceFld() const;
 
-    // fuer SequenceFelder - logische Nummer
+    // Logical number, sequence fields.
     inline void                                        SetSeqNumber( USHORT n )        { nSeqNo = 
n; }
     inline USHORT                              GetSeqNumber() const            { return nSeqNo; }
 
-    // Der Name nur erfragen
+    // Query name only.
     virtual const String&              GetPar1()       const;
 
-    // Die Formel
+    // Query formula.
     virtual String                             GetPar2()       const;
     virtual void                               SetPar2(const String& rStr);
     virtual bool        QueryValue( com::sun::star::uno::Any& rVal, USHORT nWhich ) const;
@@ -291,9 +274,6 @@ inline BOOL SwSetExpField::GetInputFlag() const
 inline BOOL SwSetExpField::IsSequenceFld() const
     { return 0 != (nsSwGetSetExpType::GSE_SEQ & ((SwSetExpFieldType*)GetTyp())->GetType()); }
 
-/*--------------------------------------------------------------------
-    Beschreibung: Eingabe im Text/Variable setzen
- --------------------------------------------------------------------*/
 
 class SwInputFieldType : public SwFieldType
 {
@@ -306,9 +286,6 @@ public:
     SwDoc* GetDoc() const { return pDoc; }
 };
 
-/*--------------------------------------------------------------------
-    Beschreibung: Eingabefeld
- --------------------------------------------------------------------*/
 
 class SW_DLLPUBLIC SwInputField : public SwField
 {
@@ -318,7 +295,7 @@ class SW_DLLPUBLIC SwInputField : public SwField
     String  aToolTip;
     USHORT  nSubType;
 public:
-    // Direkte Eingabe ueber Dialog alten Wert loeschen
+    // Direct input via dialog; delete old value.
     SwInputField(SwInputFieldType*, const String& rContent ,
                  const String& rPrompt, USHORT nSubType = 0,
                  ULONG nFmt = 0);
@@ -366,12 +343,11 @@ public:
     void               PushCrsr();
     void               PopCrsr();
 
-    // vergleiche TmpLst mit akt Feldern. Alle neue kommen in die SortLst
-    // damit sie geupdatet werden koennen. Returnt die Anzahl.
-    // (Fuer Textbausteine: nur seine Input-Felder aktualisieren)
+    // Put all that are new into SortLst for updating. Returns count.
+    // (For Glossary: only update its input-fields).
+    // Compare TmpLst with current fields.
     USHORT             BuildSortLst();
 
-    // Alle unselektierten Felder aus Liste entfernen
     void               RemoveUnselectedFlds();
 
 private:
@@ -380,11 +356,7 @@ private:
     SvPtrarr           aTmpLst;
 };
 
-/*--------------------------------------------------------------------
-    Beschreibung: Tabellen-Formelfeld
-                  (Implementierung steht in tblcalc.cxx)
- --------------------------------------------------------------------*/
-
+// Implementation in tblcalc.cxx.
 class SwTblFieldType : public SwValueFieldType
 {
 public:
@@ -398,7 +370,7 @@ class SwTblField : public SwValueField, public SwTableFormula
     String             sExpand;
     USHORT             nSubType;
 
-    // suche den TextNode, in dem das Feld steht
+    // Search TextNode containing the field.
     virtual const SwNode* GetNodeOfFormula() const;
 
 public:
@@ -414,11 +386,11 @@ public:
     const String&              GetExpStr() const                               { return sExpand; }
     void                               ChgExpStr(const String& rStr)   { sExpand = rStr; }
 
-    // berechne sich selbst
     void                               CalcField( SwTblCalcPara& rCalcPara );
 
     virtual    String          GetCntnt(BOOL bName = FALSE) const;
-    // Die Formel
+
+    // The formula.
     virtual String             GetPar2()       const;
     virtual void               SetPar2(const String& rStr);
     virtual bool        QueryValue( com::sun::star::uno::Any& rVal, USHORT nWhich ) const;
diff --git a/sw/inc/index.hxx b/sw/inc/index.hxx
index 7921863..6a87fe8 100644
--- a/sw/inc/index.hxx
+++ b/sw/inc/index.hxx
@@ -36,7 +36,7 @@
 
 #define INVALID_INDEX STRING_NOTFOUND
 
-// Maximale Anzahl von Indizies im IndexArray (zum Abtesten auf Ueberlaeufe)
+// Maximal count of indices in IndexArray (for testing on overflows).
 class SwIndex;
 class SwIndexReg;
 struct SwPosition;
@@ -61,7 +61,7 @@ class SW_DLLPUBLIC SwIndex
     SwIndex *pNext, *pPrev;
 
     SwIndex& ChgValue( const SwIndex& rIdx, xub_StrLen nNewValue );
-    void Remove();                                     // Ausketten
+    void Remove();
 
 public:
     explicit SwIndex(SwIndexReg *const pReg, xub_StrLen const nIdx = 0);
@@ -99,15 +99,12 @@ public:
     INLINE SwIndex& operator=( xub_StrLen );
     SwIndex& operator=( const SwIndex & );
 
-    // gebe den Wert vom Index als xub_StrLen zurueck
     xub_StrLen GetIndex() const        { return nIndex; }
 
-    // ermoeglicht Zuweisungen ohne Erzeugen eines temporaeren
-    // Objektes
+    // Assignments without creating a temporary object.
     SwIndex &Assign(SwIndexReg *,xub_StrLen);
 
-        // Herausgabe des Pointers auf das IndexArray,
-        // (fuers RTTI am SwIndexReg)
+    // Returns pointer to IndexArray (for RTTI at SwIndexReg).
     const SwIndexReg* GetIdxReg() const { return pArray; }
 };
 
@@ -120,9 +117,8 @@ class SwIndexReg
 
     const SwIndex *pFirst, *pLast, *pMiddle;
 
-    // ein globales Array, in das Indizies verschoben werden, die mal
-    // temporaer "ausgelagert" werden muessen; oder die zum Zeitpunkt des
-    // anlegens kein gueltiges Array kennen (SwPaM/SwPosition!)
+    // A global array for holding indices that need to be "swapped" temporarily
+    // or do not know a valid array (SwPaM/SwPosition!).
     friend void _InitCore();
     friend void _FinitCore();
     static SwIndexReg* pEmptyIndexArray;
diff --git a/sw/inc/inetfld.hxx b/sw/inc/inetfld.hxx
index ef1ebbf..830fc52 100644
--- a/sw/inc/inetfld.hxx
+++ b/sw/inc/inetfld.hxx
@@ -37,9 +37,7 @@ class SwINetField;
 class SwCharFmt;
 class SwDoc;
 
-/*--------------------------------------------------------------------
-    Beschreibung: InterNet-FieldType -> Lade Document mit der URL
- --------------------------------------------------------------------*/
+// InterNet-FieldType -> Load document with URL
 
 class SwINetFieldType : public SwFieldType
 {
@@ -57,21 +55,20 @@ public:
     SwDoc* GetDoc() const      { return pDoc; }
 };
 
-/*--------------------------------------------------------------------
-    Beschreibung: InterNet-Field -> Lade Document mit der URL
- --------------------------------------------------------------------*/
+
+// InterNet-Field -> Load document with URL
 
 class SwINetField : public SwField
 {
     friend class SwINetFieldType;
 
-    String     sTargetFrameName;       // in diesen Frame soll die URL
+    String     sTargetFrameName;       // Frame to put the URL.
     String  sURL;
     String  sText;
     SvxMacroTableDtor* pMacroTbl;
 
 public:
-    // Direkte Eingabe alten Wert loeschen
+    // Direct input, delete old value.
     SwINetField( SwINetFieldType* pTyp, USHORT nFmt,
                   const String& rURL, const String& rText );
     virtual    ~SwINetField();
@@ -84,11 +81,11 @@ public:
     virtual const String& GetPar1() const;
     virtual void       SetPar1(const String& rStr);
 
-    // HinweisText
+    // Information text.
     virtual String     GetPar2() const;
     virtual void       SetPar2(const String& rStr);
 
-    // das ist das akt. Zeichenformat
+    // Current character format.
           SwCharFmt* GetCharFmt();
     const SwCharFmt* GetCharFmt() const
             { return ((SwINetField*)this)->GetCharFmt(); }
@@ -96,11 +93,10 @@ public:
     const String& GetTargetFrameName() const           { return sTargetFrameName; }
     void SetTargetFrameName( const String& rNm )       { sTargetFrameName = rNm; }
 
-    // setze eine neue oder loesche die akt. MakroTabelle
+    // Set new or delete old MacroTable.
     void SetMacroTbl( const SvxMacroTableDtor* pTbl = 0 );
     const SvxMacroTableDtor* GetMacroTbl() const       { return pMacroTbl; }
 
-    // setze / erfrage ein Makro
     void SetMacro( USHORT nEvent, const SvxMacro& rMacro );
     const SvxMacro* GetMacro( USHORT nEvent ) const;
 };
-- 
1.7.1