[Libreoffice] [PATCH] 1st try of translating German comments into English

Tried hard and hope it's acceptable. Please check.
Criticism welcome.

From ab9c6699645c17d1743e94a8af77685415db688b Mon Sep 17 00:00:00 2001
From: Christoph Herzog <rhogez@googlemail.com>
Date: Fri, 7 Jan 2011 00:22:24 +0100
Subject: [PATCH] First try of translating German comments into English.

---
 sw/inc/IDocumentContentOperations.hxx |   73 
+++++++++++++-------------------
 1 files changed, 30 insertions(+), 43 deletions(-)

diff --git a/sw/inc/IDocumentContentOperations.hxx 
b/sw/inc/IDocumentContentOperations.hxx
index 040b09c..4a5c0ee 100644
--- a/sw/inc/IDocumentContentOperations.hxx
+++ b/sw/inc/IDocumentContentOperations.hxx
@@ -74,20 +74,20 @@
     };

  public:
-    /** Kopieren eines Bereiches im oder in ein anderes Dokument !
-        Die Position kann auch im Bereich liegen !!
-    */
+    /** Copying of a range within or to another document.
+        The position can also be within the range!
+     */
     virtual bool CopyRange(SwPaM&, SwPosition&, const bool bCopyAll ) 
const = 0;

-    /** Loesche die Section, in der der Node steht.
+    /** Delete section containing the node.
     */
     virtual void DeleteSection(SwNode* pNode) = 0;

-    /** loeschen eines BereichesSwFlyFrmFmt
+    /** Delete a range SwFlyFrmFmt.
     */
     virtual bool DeleteRange(SwPaM&) = 0;

-    /** loeschen gesamter Absaetze
+    /** Delete full paragraphs.
     */
     virtual bool DelFullPara(SwPaM&) = 0;

@@ -100,19 +100,15 @@
     virtual bool DeleteAndJoin( SwPaM&,
                                 const bool bForceJoinNext = false ) = 0;

-    /** verschieben eines Bereiches
-    */
     virtual bool MoveRange(SwPaM&, SwPosition&, SwMoveFlags) = 0;

-    /** verschieben ganzer Nodes
-    */
     virtual bool MoveNodeRange(SwNodeRange&, SwNodeIndex&, 
SwMoveFlags) = 0;

-    /** verschieben eines Bereiches
+    /** Move a range.
     */
     virtual bool MoveAndJoin(SwPaM&, SwPosition&, SwMoveFlags) = 0;

-    /** Ueberschreiben eines Strings in einem bestehenden Textnode.
+    /** Overwrite string in an existing text node.
     */
     virtual bool Overwrite(const SwPaM &rRg, const String& rStr) = 0;

@@ -125,26 +121,24 @@
     */
     virtual void TransliterateText(const SwPaM& rPaM, 
utl::TransliterationWrapper&) = 0;

-    /** Einfuegen einer Grafik, Formel. Die XXXX werden kopiert.
+    /** Insert graphic or formula. The XXXX are copied.
     */
     virtual SwFlyFrmFmt* Insert(const SwPaM &rRg, const String& 
rGrfName, const String& rFltName, const Graphic* pGraphic,
                         const SfxItemSet* pFlyAttrSet, const 
SfxItemSet* pGrfAttrSet, SwFrmFmt*) = 0;

-    /**
-    */
     virtual SwFlyFrmFmt* Insert(const SwPaM& rRg, const 
GraphicObject& rGrfObj,	const SfxItemSet* pFlyAttrSet,
                         const SfxItemSet* pGrfAttrSet, SwFrmFmt*) = 0;

-    /** austauschen einer Grafik (mit Undo)
+    /** Transpose graphic (with undo)
     */
     virtual void ReRead(SwPaM&, const String& rGrfName, const String& 
rFltName, const Graphic* pGraphic, const GraphicObject* pGrfObj) = 0;

-    /** Einfuegen eines DrawObjectes. Das Object muss bereits im DrawModel
-        angemeldet sein.
+    /** Insert a DrawObject. The object must be already registered
+        in DrawModel.
     */
     virtual SwDrawFrmFmt* Insert(const SwPaM &rRg, SdrObject& 
rDrawObj, const SfxItemSet* pFlyAttrSet, SwFrmFmt*) = 0;

-    /** Einfuegen von OLE-Objecten.
+    /** Insert OLE-objects.
     */
     virtual SwFlyFrmFmt* Insert(const SwPaM &rRg, const 
svt::EmbeddedObjectRef& xObj, const SfxItemSet* pFlyAttrSet,
                         const SfxItemSet* pGrfAttrSet, SwFrmFmt*) = 0;
@@ -152,43 +146,36 @@
     virtual SwFlyFrmFmt* InsertOLE(const SwPaM &rRg, const String& 
rObjName, sal_Int64 nAspect, const SfxItemSet* pFlyAttrSet,
                            const SfxItemSet* pGrfAttrSet, SwFrmFmt*) = 0;

-    /** Aufspalten eines Nodes an rPos (nur fuer den TxtNode implementiert)
+    /** Split a node at rPos (implemented only for TxtNode).
     */
     virtual bool SplitNode(const SwPosition &rPos, bool 
bChkTableStart) = 0;

-    /**
-    */
     virtual bool AppendTxtNode(SwPosition& rPos) = 0;

-    /** Ersetz einen selektierten Bereich in einem TextNode mit dem
-        String. Ist fuers Suchen&Ersetzen gedacht.
-        bRegExpRplc - ersetze Tabs (\\t) und setze den gefundenen String
-                 ein ( nicht \& )
-                    z.B.: Fnd: "zzz", Repl: "xx\t\\t..&..\&"
-                        --> "xx\t<Tab>..zzz..&"
+    /** Replace selected range in a TxtNode with string.
+        Intended for search & replace.
+        bRegExpRplc - replace tabs (\\t) and insert the found string
+        ( not \& ). E.g.: Find: "zzz", Replace: "xx\t\\t..&..\&"
+        --> "xx\t<Tab>..zzz..&"
     */
     virtual bool ReplaceRange(SwPaM& rPam, const String& rNewStr,
                               const bool bRegExReplace) = 0;

-    /** Einfuegen eines Attributs. Erstreckt sich rRg ueber
-        mehrere Nodes, wird das Attribut aufgespaltet, sofern
-        dieses Sinn macht. Nodes, in denen dieses Attribut keinen
-        Sinn macht, werden ignoriert.  In vollstaendig in der
-        Selektion eingeschlossenen Nodes wird das Attribut zu
-        harter Formatierung, in den anderen (Text-)Nodes wird das
-        Attribut in das Attributearray eingefuegt. Bei einem
-        Zeichenattribut wird ein "leerer" Hint eingefuegt,
-        wenn keine Selektion
-        vorliegt; andernfalls wird das Attribut als harte
-        Formatierung dem durch rRg.Start() bezeichneten Node
-        hinzugefuegt.  Wenn das Attribut nicht eingefuegt werden
-        konnte, liefert die Methode sal_False.
+    /** Insert an attribute. If rRg spans several nodes the
+        attribute is split, provided it makes sense.
+        Nodes, where this attribute does not make sense are ignored.
+        In nodes completely enclosed in the selection the attribute
+        becomes hard-formated, in all other (text-) nodes the attribute
+        is inserted into the attribute array.
+        For a character attribute, in cases where no selection exists
+        an "empty" hint is inserted. If there is a selection the attribute
+        is hard-formated and added to the node at rRg.Start().
+        If the attribute could not be inserted, the method returns
+        sal_False.
     */
     virtual bool InsertPoolItem(const SwPaM &rRg, const SfxPoolItem&,
                                 const sal_uInt16 nFlags) = 0;

-    /**
-    */
     virtual bool InsertItemSet (const SwPaM &rRg, const SfxItemSet&,
                                 const sal_uInt16 nFlags) = 0;

--
1.7.1