fdo#39468 Translate German comments

Also remove ASCII art and some typos.

Change-Id: I76d05209dd674598c787fe6fb486f0e9eadb2629
Reviewed-on: https://gerrit.libreoffice.org/8188
Reviewed-by: Caolán McNamara <caolanm@redhat.com>
Tested-by: Caolán McNamara <caolanm@redhat.com>

1 files changed, 251 insertions, 305 deletions

diff --git a/include/svx/svdobj.hxx b/include/svx/svdobj.hxx
index 611b365cf8f6..76f0e2155f05 100644
--- a/include/svx/svdobj.hxx
+++ b/include/svx/svdobj.hxx
@@ -98,60 +98,59 @@ namespace svx
 
 // Defines
 
-enum SdrObjKind {OBJ_NONE       = 0,  // Abstraktes Objekt (SdrObject)
-                 OBJ_GRUP       = 1,  // Objektgruppe
-                 OBJ_LINE       = 2,  // Strecke
-                 OBJ_RECT       = 3,  // Rechteck ww. mit runden Ecken
-                 OBJ_CIRC       = 4,  // Kreis, Ellipse
-                 OBJ_SECT       = 5,  // Kreissektor
-                 OBJ_CARC       = 6,  // Kreisbogen
-                 OBJ_CCUT       = 7,  // Kreisabschnitt
-                 OBJ_POLY       = 8,  // Polygon, PolyPolygon
+enum SdrObjKind {OBJ_NONE       = 0,  // abstract object (SdrObject)
+                 OBJ_GRUP       = 1,  // object group
+                 OBJ_LINE       = 2,  // line
+                 OBJ_RECT       = 3,  // rectangle (round corners optional)
+                 OBJ_CIRC       = 4,  // circle, ellipse
+                 OBJ_SECT       = 5,  // circle section
+                 OBJ_CARC       = 6,  // circle arc
+                 OBJ_CCUT       = 7,  // circle cut
+                 OBJ_POLY       = 8,  // polygon, PolyPolygon
                  OBJ_PLIN       = 9,  // PolyLine
-                 OBJ_PATHLINE   =10,  // Offene Bezierkurve
-                 OBJ_PATHFILL   =11,  // Geschlossene Bezierkurve
-                 OBJ_FREELINE   =12,  // Offene Freihandlinie
-                 OBJ_FREEFILL   =13,  // Geschlossene Freihandlinie
+                 OBJ_PATHLINE   =10,  // open Bezier-curve
+                 OBJ_PATHFILL   =11,  // closed Bezier-curve
+                 OBJ_FREELINE   =12,  // open free-hand line
+                 OBJ_FREEFILL   =13,  // closed free-hand line
                  OBJ_SPLNLINE   =14,  // Natuerlicher kubischer Spline          (ni)
                  OBJ_SPLNFILL   =15,  // Periodischer kubischer Spline          (ni)
-                 OBJ_TEXT       =16,  // Textobjekt
+                 OBJ_TEXT       =16,  // text object
                  OBJ_TEXTEXT    =17,  // Texterweiterungsrahmen                 (ni)
                  OBJ_wegFITTEXT,      // FitToSize-Text (alle Zeilen gleich)
                  OBJ_wegFITALLTEXT,   // FitToSize-Text (Zeilenweise)           (ni)
                  OBJ_TITLETEXT  =20,  // Titeltext. Spezial-Textobjekt fuer StarDraw
                  OBJ_OUTLINETEXT=21,  // OutlineText. Spezial-Textobjekt fuer StarDraw
                  OBJ_GRAF       =22,  // Fremdgrafik - (StarView Graphic)
-                 OBJ_OLE2       =23,  // OLE-Objekt
+                 OBJ_OLE2       =23,  // OLE object
                  OBJ_EDGE       =24,  // Verbindungsobjekt fuer Konnektoren
                  OBJ_CAPTION    =25,  // Legendenobjekt
                  OBJ_PATHPOLY   =26,  // Polygon/PolyPolygon dargestellt durch SdrPathObj
                  OBJ_PATHPLIN   =27,  // Polyline dargestellt durch SdrPathObj
-                 OBJ_PAGE       =28,  // Objekt, das eine SdrPage darstellt
-                 OBJ_MEASURE    =29,  // Bemassungsobjekt
-                 OBJ_DUMMY      =30,  // Dummyobjekt zum speichern von Luecken (zur anschliessenden Wiederherstellung der Surrogate)
-                 OBJ_FRAME      =31,  // staendig aktives OLE (PlugIn-Frame oder sowas)
-                 OBJ_UNO        =32,  // Universal Network Object im SvDraw-Obj eingepackt
-                 OBJ_CUSTOMSHAPE=33,  // CustomShape
-                 OBJ_MEDIA      =34,  // Media shape
-                 OBJ_TABLE      =35,  // Table
+                 OBJ_PAGE       =28,  // object that represents a SdrPage
+                 OBJ_MEASURE    =29,  // measurement object
+                 OBJ_DUMMY      =30,  // dummy object for saving holes (to recover surrogates later)
+                 OBJ_FRAME      =31,  // continiously activated aktives OLE (PlugIn-Frame or similar)
+                 OBJ_UNO        =32,  // Universal Network Object packed into SvDraw object
+                 OBJ_CUSTOMSHAPE=33,  // custom shape
+                 OBJ_MEDIA      =34,  // media shape
+                 OBJ_TABLE      =35,  // table
                  OBJ_MAXI};
 
-enum SdrUserCallType {SDRUSERCALL_MOVEONLY,         // Nur verschoben, Groesse unveraendert
-                      SDRUSERCALL_RESIZE,           // Groesse und evtl. auch Pos veraendert
-                      SDRUSERCALL_CHGATTR,          // Attribute veraendert. Moeglicherweise neue Groesse wg. Linienbreite
-                      SDRUSERCALL_DELETE,           // Obj gibt es gleich nicht mehr. Schon keine Attr mehr.
-                      SDRUSERCALL_COPY,             // Zuweisungsoperator gerufen. Kann alles geaendert sein
-                      SDRUSERCALL_INSERTED,         // In eine Objektliste (z.B. Page) eingefuegt
-                      SDRUSERCALL_REMOVED,          // Aus der Objektliste entfernt
-                      SDRUSERCALL_CHILD_MOVEONLY,   // Ein Child einer Gruppe hat sich veraendert
-                      SDRUSERCALL_CHILD_RESIZE,     // Ein Child einer Gruppe hat sich veraendert
-                      SDRUSERCALL_CHILD_CHGATTR,    // Ein Child einer Gruppe hat sich veraendert
-                      SDRUSERCALL_CHILD_DELETE,     // Ein Child einer Gruppe hat sich veraendert
-                      SDRUSERCALL_CHILD_COPY,       // Ein Child einer Gruppe hat sich veraendert
-                      SDRUSERCALL_CHILD_INSERTED,   // Ein Child einer Gruppe hat sich veraendert
-                      SDRUSERCALL_CHILD_REMOVED};   // Ein Child einer Gruppe hat sich veraendert
-
-//   Hilfsklasse SdrObjUserCall
+enum SdrUserCallType {SDRUSERCALL_MOVEONLY,         // only moved, size unchanged
+                      SDRUSERCALL_RESIZE,           // size and maybe position changed
+                      SDRUSERCALL_CHGATTR,          // attribute changed. Eventually new size, because of line width
+                      SDRUSERCALL_DELETE,           // object is going to be deleted soon, no attributes anymore
+                      SDRUSERCALL_COPY,             // assign operator called, everything can be changed
+                      SDRUSERCALL_INSERTED,         // inserted into an object list (e.g. Page)
+                      SDRUSERCALL_REMOVED,          // removed from an object list
+                      SDRUSERCALL_CHILD_MOVEONLY,   // a child within a group has changed
+                      SDRUSERCALL_CHILD_RESIZE,     // a child within a group has changed
+                      SDRUSERCALL_CHILD_CHGATTR,    // a child within a group has changed
+                      SDRUSERCALL_CHILD_DELETE,     // a child within a group has changed
+                      SDRUSERCALL_CHILD_COPY,       // a child within a group has changed
+                      SDRUSERCALL_CHILD_INSERTED,   // a child within a group has changed
+                      SDRUSERCALL_CHILD_REMOVED};   // a child within a group has changed
+
 class SVX_DLLPUBLIC SdrObjUserCall
 {
 public:
@@ -160,7 +159,6 @@ public:
     virtual void Changed(const SdrObject& rObj, SdrUserCallType eType, const Rectangle& rOldBoundRect);
 };
 
-//   Hilfsklasse SdrObjMacroHitRec
 class SVX_DLLPUBLIC SdrObjMacroHitRec
 {
 public:
@@ -175,13 +173,9 @@ public:
     SdrObjMacroHitRec();
 };
 
-//   Hilfsklasse SdrObjUserData
-//
-// Anwenderdaten an einem Zeichenobjekt, z.B. applikationsspezifische Daten.
-// Jedes Zeichenobjekt kann beliebig viele dieser Records haben (SV-Liste).
-// Wer hier Daten halten will, muss sich ableiten und auch an der Factory
-// einen entsprechenden Link setzen.
-//
+// User data of a drawing object, e.g. application specific data.
+// Every drawing object can have arbitrarily many such records (SV list).
+// Whoever wants to save data here, must inherit from this and set a corresponding link in the factory.
 class SVX_DLLPUBLIC SdrObjUserData
 {
 protected:
@@ -213,7 +207,6 @@ public:
     virtual OUString GetMacroPopupComment(const SdrObjMacroHitRec& rRec, const SdrObject* pObj) const;
 };
 
-//   Hilfsklasse SdrObjUserDataList
 class SdrObjUserDataList
 {
     typedef boost::ptr_vector<SdrObjUserData> ListType;
@@ -230,9 +223,7 @@ public:
     void DeleteUserData(size_t nNum);
 };
 
-//   Hilfsklasse SdrObjGeoData
-//
-// Alle geometrischen Daten eines beliebigen Objektes zur ??bergabe an's Undo/Redo
+// all geometrical data of an arbitrary object for use in undo/redo
 class SVX_DLLPUBLIC SdrObjGeoData
 {
 public:
@@ -251,16 +242,14 @@ public:
     virtual ~SdrObjGeoData();
 };
 
-//   Hilfsklasse SdrObjPlusData
-//
-// Bitsack fuer DrawObjekte
+// Bitsack for DrawObjects
 class SdrObjPlusData
 {
     friend class                SdrObject;
 
-    SfxBroadcaster*             pBroadcast;    // Broadcaster, falls dieses Obj referenziert wird (bVirtObj=true). Auch fuer Konnektoren etc.
-    SdrObjUserDataList*         pUserDataList; // applikationsspeziefische Daten
-    SdrGluePointList*           pGluePoints;   // Klebepunkte zum Ankleben von Objektverbindern
+    SfxBroadcaster*             pBroadcast;    // broadcaster, if this object is referenced (bVirtObj=true). Also for connectors etc.
+    SdrObjUserDataList*         pUserDataList; // application specific data
+    SdrGluePointList*           pGluePoints;   // glue points for glueing object connectors
 
     // #i68101#
     // object name, title and description
@@ -277,39 +266,35 @@ public:
     void SetGluePoints(const SdrGluePointList& rPts);
 };
 
-//   Hilfsklasse SdrObjTransformInfoRec
-//
-// gibt Auskunft ueber verschiedene Eigenschaften eines ZObjects
+// provides information about various ZObject properties
 class SVX_DLLPUBLIC SdrObjTransformInfoRec
 {
 public:
-    bool bSelectAllowed : 1;     // false=Obj kann nicht selektiert werden
-    bool bMoveAllowed : 1;       // false=Obj kann nicht verschoben werden
-    bool bResizeFreeAllowed : 1; // false=Obj kann nicht frei resized werden
-    bool bResizePropAllowed : 1; // false=Obj kann nichtmal proportional resized werden
-    bool bRotateFreeAllowed : 1; // false=Obj kann nicht frei gedreht werden
-    bool bRotate90Allowed : 1;   // false=Obj kann nichtmal im 90deg Raster gedreht werden
-    bool bMirrorFreeAllowed : 1; // false=Obj kann nicht frei gespiegelt werden
-    bool bMirror45Allowed : 1;   // false=Obj kann nichtmal ueber Achse im 45deg Raster gespiegelt werden
-    bool bMirror90Allowed : 1;   // false=Obj kann ebenfalls nicht ueber Achse im 90deg Raster gespiegelt werden
-    bool bTransparenceAllowed : 1; // false=Obj does not have an interactive transparence control
-    bool bGradientAllowed : 1; // false=Obj dooes not have an interactive gradient control
-    bool bShearAllowed : 1;      // false=Obj kann nicht verzerrt werden
+    bool bSelectAllowed : 1;           // if false, object cannot be selected
+    bool bMoveAllowed : 1;             // if false, object cannot be moved
+    bool bResizeFreeAllowed : 1;       // if false, object cannot be resized freely
+    bool bResizePropAllowed : 1;       // if false, object cannot even be resized proportionally
+    bool bRotateFreeAllowed : 1;       // if false, object cannot be rotated freely
+    bool bRotate90Allowed : 1;         // if false, object cannot even be rotated in 90 degree steps
+    bool bMirrorFreeAllowed : 1;       // if false, object cannot be mirrored freely
+    bool bMirror45Allowed : 1;         // if false, object cannot even be mirrored over axes in a 45 degree raster
+    bool bMirror90Allowed : 1;         // if false, object cannot even be mirrored over axes in a 90 degree raster
+    bool bTransparenceAllowed : 1;     // if false, object does not have an interactive transparence control
+    bool bGradientAllowed : 1;         // if false, object dooes not have an interactive gradient control
+    bool bShearAllowed : 1;            // if false, object cannot be sheared
     bool bEdgeRadiusAllowed : 1;
-    bool bNoOrthoDesired : 1;    // true bei Rect; ... false bei BMP,MTF;
-    bool bNoContortion : 1;      // false=Kein verzerren (bei Crook) moeglich (nur true bei PathObj und Gruppierten PathObjs)
-    bool bCanConvToPath : 1;     // false=Keine Konvertierung in PathObj moeglich
-    bool bCanConvToPoly : 1;     // false=Keine Konvertierung in PolyObj moeglich
-    bool bCanConvToContour : 1;     // false=no conversion down to whole contour possible
-    bool bCanConvToPathLineToArea : 1; // false=Keine Konvertierung in PathObj moeglich mit Wandlung von LineToArea
-    bool bCanConvToPolyLineToArea : 1; // false=Keine Konvertierung in PolyObj moeglich mit Wandlung von LineToArea
+    bool bNoOrthoDesired : 1;          // is true for Rect; is false for BMP, MTF
+    bool bNoContortion : 1;            // if false, Kein verzerren (bei Crook) moeglich (nur true bei PathObj und Gruppierten PathObjs)
+    bool bCanConvToPath : 1;           // if false, no conversion into PathObj possible
+    bool bCanConvToPoly : 1;           // if false, no conversion into PolyObj possible
+    bool bCanConvToContour : 1;        // if false, no conversion down to whole contour possible
+    bool bCanConvToPathLineToArea : 1; // if false, no conversion into PathObj with transformation from LineToArea possible
+    bool bCanConvToPolyLineToArea : 1; // if false, no conversion into PolyObj with transformation from LineToArea possible
 
     SdrObjTransformInfoRec();
 };
 
-////////////////////////////////////////////////////////////////////////////////////////////////////
-// Abstraktes DrawObject
-////////////////////////////////////////////////////////////////////////////////////////////////////
+// Abstract DrawObject
 
 class SvxShape;
 class SVX_DLLPUBLIC SdrObject: public SfxListener, public tools::WeakBase< SdrObject >
@@ -330,7 +315,6 @@ protected:
 public:
     virtual sdr::properties::BaseProperties& GetProperties() const;
 
-    ///////////////////////////////////////////////////////////////////////////////
     // #110094# DrawContact section
 private:
     sdr::contact::ViewContact*                                      mpViewContact;
@@ -348,54 +332,52 @@ private:
     friend class                SdrRectObj;
 
 protected:
-    Rectangle                   aOutRect;     // umschliessendes Rechteck fuer Paint (inkl. LineWdt, ...)
-    Point                       aAnchor;      // Ankerposition (Writer)
+    Rectangle                   aOutRect;     // surrounding rectangle for Paint (incl. LineWdt, ...)
+    Point                       aAnchor;      // anchor position (Writer)
     Point                       aGridOffset;  // hack (Calc)
-    SdrObjList*                 pObjList;     // Liste, in dem das Obj eingefuegt ist.
+    SdrObjList*                 pObjList;     // list that includes this object
     SdrPage*                    pPage;
     SdrModel*                   pModel;
     SdrObjUserCall*             pUserCall;
-    SdrObjPlusData*             pPlusData;    // Broadcaster, UserData, Konnektoren, ... (Das ist der Bitsack)
+    SdrObjPlusData*             pPlusData;    // Broadcaster, UserData, connektors, ... (this is the Bitsack)
 
-    sal_uInt32                  nOrdNum;      // Rangnummer des Obj in der Liste
+    sal_uInt32                  nOrdNum;      // order number of the object in the list
 
-    SfxGrabBagItem*             pGrabBagItem; // Holds the GrabBagItem property
+    SfxGrabBagItem*             pGrabBagItem; // holds the GrabBagItem property
 
 
-    /** Position in the navigation order.  SAL_MAX_UINT32 when not used.
-    */
+    // Position in the navigation order.  SAL_MAX_UINT32 when not used.
     sal_uInt32                  mnNavigationPosition;
     SdrLayerID                  mnLayerID;
 
-    // Objekt zeigt nur auf ein Anderes
+    // object is only pointing to another one
     bool                        bVirtObj : 1;
     bool                        bSnapRectDirty : 1;
     bool                        bNetLock : 1;   // ni
-    bool                        bInserted : 1;  // nur wenn true gibt's RepaintBroadcast & SetModify
-    bool                        bGrouped : 1;   // Member eines GroupObjektes?
-
-    // Die folgende Flags werden gestreamt
-    bool                        bMovProt : 1; // If true, the position is protected
-    bool                        bSizProt : 1; // If true, the size is protected
-    bool                        bNoPrint : 1; // If true, the object is not printed.
-    bool                        mbVisible : 1; // If false, the object is not visible on screen (but maybe on printer, depending on bNoprint
-    // Wenn bEmptyPresObj true ist, handelt es sich um ein
-    // Praesentationsobjekt, dem noch kein Inhalt zugewiesen
-    // wurde. Default ist das Flag auf FALSE. Die Verwaltung
-    // uebernimmt die Applikation. Im Zuweisungsoperator sowie
-    // beim Clone wird das Flag nicht mitkopiert!
-    // Das Flag ist persistent.
-    bool                        bEmptyPresObj : 1;     // Leeres Praesentationsobjekt (Draw)
-
-    // true=Objekt ist als Objekt der MasterPage nicht sichtbar
+    bool                        bInserted : 1;  // only if set to true, there are RepaintBroadcast & SetModify
+    bool                        bGrouped : 1;   // member of a group object?
+
+    // the following flags will be streamed
+    bool                        bMovProt : 1;   // if true, the position is protected
+    bool                        bSizProt : 1;   // if true, the size is protected
+    bool                        bNoPrint : 1;   // if true, the object is not printed.
+    bool                        mbVisible : 1;  // if false, the object is not visible on screen (but maybe on printer, depending on bNoprint
+    // If bEmptyPresObj is true, it is a presentation object that has no content yet.
+    // The flag's default value is false.
+    // The management is done by the application.
+    // Neither assign operator nor cloning copies the flag!
+    // The flag is persistent.
+    bool                        bEmptyPresObj : 1;     // empty presentation object (Draw)
+
+    // if true, object is invisible as object of the MasterPage
     bool                        bNotVisibleAsMaster : 1;
 
-    // true=Es handelt sich hierbei um ein geschlossenes Objekt, also nicht Linie oder Kreisbogen ...
+    // if true, the object is closed, i.e. no line, arc...
     bool                        bClosedObj : 1;
 
     bool                        bIsEdge : 1;
     bool                        bIs3DObj : 1;
-    bool                        bMarkProt : 1;  // Markieren verboten. Persistent
+    bool                        bMarkProt : 1;  // marking forbidden, persistent
     bool                        bIsUnoObj : 1;
     bool                        bNotMasterCachable : 1;
 
@@ -409,7 +391,7 @@ protected:
     // in this case the following member is initialized as nonempty rectangle
     Rectangle                   maBLIPSizeRectangle;
 
-    // global static ItemPool for not-yet-insetred items
+    // global static ItemPool for not-yet-inserted items
 private:
     static SdrItemPool*         mpGlobalItemPool;
     boost::optional<double>                                         mnRelativeWidth;
@@ -434,7 +416,7 @@ protected:
     SdrObjUserData* ImpGetMacroUserData() const;
     Rectangle ImpDragCalcRect(const SdrDragStat& rDrag) const;
 
-    // Fuer GetDragComment
+    // for GetDragComment
     void ImpTakeDescriptionStr(sal_uInt16 nStrCacheID, OUString& rStr, sal_uInt16 nVal=0) const;
 
     void ImpForcePlusData();
@@ -442,14 +424,14 @@ protected:
     OUString GetWinkStr(long nWink, bool bNoDegChar = false) const;
     OUString GetMetrStr(long nVal, MapUnit eWantMap=MAP_MM, bool bNoUnitChars = false) const;
 
-    // bNotMyself=true bedeutet: Nur die ObjList auf Dirty setzen, nicht mich.
-    // Wird z.B. benoetigt fuer NbcMove, denn da movt man SnapRect und aOutRect
-    // i.d.R. gleich mit um die Neuberechnung zu sparen.
+    // bNotMyself=true means: set only ObjList to dirty, don't mark this object as dirty.
+    // This is needed for instance for NbcMove, because usually one moves SnapRect and aOutRect
+    // at the same time to avoid recomputation.
 public:
     virtual void SetRectsDirty(sal_Bool bNotMyself = false);
 protected:
 
-    // ueberladen, wenn man sich von SdrObjPlusData abgeleitet hat:
+    // override if the class inherits from SdrObjPlusData:
     virtual SdrObjPlusData* NewPlusData() const;
 
 protected:
@@ -468,14 +450,12 @@ public:
     TYPEINFO();
     SdrObject();
 
-    /** frees the SdrObject pointed to by the argument
-
-        In case the object has an SvxShape, which has the ownership of the object, it
-        is actually *not* deleted.
-    */
+    // frees the SdrObject pointed to by the argument
+    // In case the object has an SvxShape, which has the ownership of the object, it
+    // is actually *not* deleted.
     static  void    Free( SdrObject*& _rpObject );
 
-    // This method is only for access from Property objects
+    // this method is only for access from Property objects
     virtual void SetBoundRectDirty();
 
     virtual void SetObjList(SdrObjList* pNewObjList);
@@ -510,9 +490,9 @@ public:
     SdrObjUserCall* GetUserCall() const;
     void SendUserCall(SdrUserCallType eUserCall, const Rectangle& rBoundRect) const;
 
-    // Ein solcher Referenzpunkt ist z.B. der Punkt eines Symbols, der
-    // der beim Einfuegen des Symbols auf das Raster gefangen werden soll
-    // oder der Fixpunkt eines Bildes innerhalb eines Animationsobjektes.
+    // Such a reference point is for instance:
+    // - a symbol's point that should snap to the raster when inserting the symbol
+    // - or an image's fix point within an animation object
     virtual bool HasRefPoint() const;
     virtual Point GetRefPoint() const;
     virtual void SetRefPoint(const Point& rPnt);
@@ -528,7 +508,7 @@ public:
     void SetDescription(const OUString& rStr);
     OUString GetDescription() const;
 
-    // Fuer Gruppenobjekte
+    // for group objects
     bool IsGroupObject() const;
     virtual SdrObjList* GetSubList() const;
     SdrObject* GetUpGroup() const;
@@ -541,12 +521,10 @@ public:
     // werden die Ordnungsnummer aller Objekte der Liste neu bestimmt.
     sal_uInt32 GetOrdNum() const;
 
-    // Diese Methode sollte nur verwendet werden, wenn man ganz  genau weiss,
-    // was man macht:
+    // Warning: this method should only be used if you really knows what you're doing
     sal_uInt32 GetOrdNumDirect() const;
 
-    // Das Setzen der Ordnungsnummer sollte nur vom Model bzw. von der Page
-    // geschehen.
+    // setting the order number should only happen from the model or from the page
     void SetOrdNum(sal_uInt32 nNum);
 
     // GrabBagItem for interim interop purposes
@@ -554,23 +532,21 @@ public:
 
     void SetGrabBagItem(const com::sun::star::uno::Any& rVal);
 
-    /** Return the position in the navigation order for the called object.
-        Note that this method may update the navigation position of the
-        called and of other SdrObjects.  Therefore this method can not be
-        const.
-        @return
-            If no navigation position has been explicitly defined then the
-            result of GetOrdNum() is returned.
-    */
+    // Return the position in the navigation order for the called object.
+    // Note that this method may update the navigation position of the
+    // called and of other SdrObjects.  Therefore this method can not be
+    // const.
+    // @return
+    //     If no navigation position has been explicitly defined then the
+    //     result of GetOrdNum() is returned.
     sal_uInt32 GetNavigationPosition (void);
 
-    /** Set the position in the navigation position to the given value.
-        This method is typically used only by the model after a change to
-        the navigation order.
-        This method does not change the navigation position of other
-        objects.
-        Use SdrObjList::SetObjectNavigationPosition() instead.
-    */
+    // Set the position in the navigation position to the given value.
+    // This method is typically used only by the model after a change to
+    // the navigation order.
+    // This method does not change the navigation position of other
+    // objects.
+    // Use SdrObjList::SetObjectNavigationPosition() instead.
     void SetNavigationPosition (const sal_uInt32 nPosition);
 
     // #111111#
@@ -591,7 +567,7 @@ public:
 
     void BroadcastObjectChange() const;
 
-    // Modified-Flag am Model setzen
+    // set modified-flag in the model
     virtual void SetChanged();
 
     // Tooling for painting a single object to a OutputDevice. This will be needed as long
@@ -599,18 +575,14 @@ public:
     bool SingleObjectPainter(OutputDevice& rOut) const;
     bool LineGeometryUsageIsNecessary() const;
 
-    /**
-      Returns a copy of the object. Every inherited class must reimplement this (in class Foo
-      it should be sufficient to do "virtual Foo* Clone() const { return CloneHelper< Foo >(); }".
-      Note that this function uses operator= internally.
-    */
+    // Returns a copy of the object. Every inherited class must reimplement this (in class Foo
+    // it should be sufficient to do "virtual Foo* Clone() const { return CloneHelper< Foo >(); }".
+    // Note that this function uses operator= internally.
     virtual SdrObject* Clone() const;
-    /**
-      Implemented mainly for the purposes of Clone().
-    */
+    // implemented mainly for the purposes of Clone()
     SdrObject& operator=(const SdrObject& rObj);
 
-    // TakeObjName...() ist fuer die Anzeige in der UI, z.B. "3 Rahmen selektiert".
+    // TakeObjName...() is for the display in the UI, e.g. "3 frames selected"
     virtual OUString TakeObjNameSingul() const;
     virtual OUString TakeObjNamePlural() const;
 
@@ -677,9 +649,9 @@ public:
     // enthaelt die Anzahl der Mausklicks (so die App diese durchreicht).
     // BckCreate() -> Letztes EndCreate() rueckgaengig machen (z.B. letzten
     // Polygonpunkt wieder loeschen).
-    // RetrunCode: true=Weiter gehts, false=Create dadurch abgebrochen.
+    // ReturnCode: true=Weiter gehts, false=Create dadurch abgebrochen.
     virtual bool BegCreate(SdrDragStat& rStat);
-    virtual bool MovCreate(SdrDragStat& rStat); // TRUE=Xor muss repainted werden
+    virtual bool MovCreate(SdrDragStat& rStat); // if true, Xor needs to be repainted
     virtual bool EndCreate(SdrDragStat& rStat, SdrCreateCmd eCmd);
     virtual bool BckCreate(SdrDragStat& rStat);
     virtual void BrkCreate(SdrDragStat& rStat);
@@ -727,20 +699,19 @@ public:
     virtual void SetSnapRect(const Rectangle& rRect);
     virtual void NbcSetSnapRect(const Rectangle& rRect);
 
-    // Logic Rect: Beim Rect z.B. ohne Beruecksichtigung des Drehwinkels, Shear, ...
+    // Logic Rect: for the Rect for instance without regard to rotation angle, shear, ...
     virtual const Rectangle& GetLogicRect() const;
     virtual void SetLogicRect(const Rectangle& rRect);
     virtual void NbcSetLogicRect(const Rectangle& rRect);
 
-    /** the defaul is to set the logic rect to the given rectangle rMaxRect. If the shape
-        has an intrinsic aspect ratio it may set the logic rect so the aspect
-        ratio is kept but still inside the rectangle rMaxRect.
-
-        If bShrinkOnly is set to true, the size of the current logic rect will not
-        be changed if it is smaller than the given rectangle rMaxRect. */
+    // the default is to set the logic rect to the given rectangle rMaxRect. If the shape
+    // has an intrinsic aspect ratio it may set the logic rect so the aspect
+    // ratio is kept but still inside the rectangle rMaxRect.
+    // If bShrinkOnly is set to true, the size of the current logic rect will not
+    // be changed if it is smaller than the given rectangle rMaxRect.
     virtual void AdjustToMaxRect( const Rectangle& rMaxRect, bool bShrinkOnly = false );
 
-    // Drehwinkel und Shear
+    // rotation and shear angle
     virtual long GetRotateAngle() const;
     virtual long GetShearAngle(bool bVertical = false) const;
 
@@ -749,19 +720,18 @@ public:
     virtual sal_uInt32 GetSnapPointCount() const;
     virtual Point GetSnapPoint(sal_uInt32 i) const;
 
-    // Fuer Objekte, bei denen jeder einzelne Punkt verschoben werden kann,
-    // z.B. Polygone, Polylines, Linien, ... . Bei diesen Objekten werden
-    // Punkte selektiert (ggf. Mehrfachselektion), geloescht, eingefuegt,
-    // als Mehrfachselektion verschoben und gedreht, ...
-    // Nur solche Objekte koennen PlusHandles haben (z.B. die Gewichte an den
-    // Bezierkurven.
+    // For objects, whose points can be moved individually.
+    // (e.g. polygons, polylines, lines)
+    // The points of those objects are selected (if necessary multiselection),
+    // deleted, inserted, or as a multiselection moved or rotated...
+    // Only such objects can have PlusHandles (e.g. the weights of an Bezier curve).
     virtual sal_Bool IsPolyObj() const;
     virtual sal_uInt32 GetPointCount() const;
     virtual Point GetPoint(sal_uInt32 i) const;
     void SetPoint(const Point& rPnt, sal_uInt32 i);
     virtual void NbcSetPoint(const Point& rPnt, sal_uInt32 i);
 
-    // Alle geometrischen Daten holen fuer's Undo/Redo
+    // get all geometrical data for undo/redo
     virtual SdrObjGeoData* GetGeoData() const;
     virtual void SetGeoData(const SdrObjGeoData& rGeo);
 
@@ -786,26 +756,25 @@ public:
     // syntactical sugar for ItemSet accesses
     void SetMergedItemSetAndBroadcast(const SfxItemSet& rSet, bool bClearAllItems = false);
 
-    // NotPersistAttr fuer Layer, ObjName, geometrische Transformationen, ...
+    // NotPersistAttr for Layer, ObjName, geometrical transformations etc.
     void TakeNotPersistAttr(SfxItemSet& rAttr, bool bMerge) const;
     void ApplyNotPersistAttr(const SfxItemSet& rAttr);
     void NbcApplyNotPersistAttr(const SfxItemSet& rAttr);
 
-    // bDontRemoveHardAttr=FALSE: alle in der Vorlage gesetzten Attribute werden am
-    // Zeichenobjekt auf Default gesetzt; TRUE: alle harten Attribute bleiben erhalten.
+    // if bDontRemoveHardAttr is false, set all attributes, which were set in the style sheet, to their default value
+    // if true, all hard attributes keep their values
     void SetStyleSheet(SfxStyleSheet* pNewStyleSheet, bool bDontRemoveHardAttr);
     virtual void NbcSetStyleSheet(SfxStyleSheet* pNewStyleSheet, sal_Bool bDontRemoveHardAttr);
     SfxStyleSheet* GetStyleSheet() const;
 
-    // TextEdit
     virtual bool HasTextEdit() const;
 
-    // Return==TRUE: TextEditMode gestartet
+    // returns true if TextEditMode started
     virtual sal_Bool BegTextEdit(SdrOutliner& rOutl);
     virtual void EndTextEdit(SdrOutliner& rOutl);
 
-    // Text wird im Format des Outliners gehalten
-    // SetOutlinerParaObject: Eigentumsuebereignung von *pTextObject!
+    // keep text in outliner's format
+    // SetOutlinerParaObject: transfer ownership of *pTextObject!
     virtual void SetOutlinerParaObject(OutlinerParaObject* pTextObject);
     virtual void NbcSetOutlinerParaObject(OutlinerParaObject* pTextObject);
     virtual OutlinerParaObject* GetOutlinerParaObject() const;
@@ -814,7 +783,7 @@ public:
 
     void BurnInStyleSheetAttributes();
 
-    // Macrofaehigkeit, z.B. ein Rechteck als PushButton.
+    // macro abilities, e.g. a rectangle as PushButton.
     virtual bool HasMacro() const;
     virtual SdrObject* CheckMacroHit (const SdrObjMacroHitRec& rRec) const;
     virtual Pointer GetMacroPointer (const SdrObjMacroHitRec& rRec) const;
@@ -823,92 +792,84 @@ public:
     virtual OUString GetMacroPopupComment(const SdrObjMacroHitRec& rRec) const;
     bool IsMacroHit(const SdrObjMacroHitRec& rRec) const;
 
-    // Konnektoren. (siehe auch Dokumentation in SvdoEdge.HXX, SdrEdgeObj
-    //               sowie SvdGlue.HXX und SvdGlEV.HXX)
-    // Es gibt Knoten und Kanten. Eine Kante kann theoretisch auch Knoten
-    // sein, das ist jedoch in dieser Version noch nicht implementiert.
-    // Ein Knoten hat eine Anzahl von Klebepunkten, wo Kanten angeklebt
-    // werden koennen.
-    // Eine Kante kann
-    // - ohne Verbindungen sein
-    // - an einem Ende auf der Wiese stehen und am anderen Ende an
-    //   genau einem Knoten gebunden sein
-    // - an beiden Enden mit jeweils genau einem Knoten verbunden sein.
-    // Die Kante ist Listener bei seinen bis zu 2 Knoten.
-    // Wird der Knoten verschoben oder Resized, folgen alle angebundenen
-    // Kanten. Ebenso bei SetGluePoint()... am Knoten.
-    // Beim Verschieben/Resizen der Kante wird dagegen die Verbindung
-    // geloesst.
-    // Objekt ist ein Knoten?
+    // Connectors
+    // (see also documentation in SvdoEdge.hxx, SdrEdgeObj,
+    // as well as SvdGlue.hxx and SvdGlEV.hxx)
+    // There are nodes and edges. In theory an edge can also be a node, but this isn't implemented yet.
+    // A node has a number of glue points, onto which edges can glued to
+    // An edge can be either
+    // - without any connection to any node,
+    // - or connected on one end to a node, while the other end is not connected,
+    // - or connected on both ends with exactly one node each.
+    // The edge is listener for its upto two nodes.
+    // Whenever a node is moved or resized, all its connected edges follow.
+    // This is also true for SetGluePoint()... on the node.
+    // On the other hand, moving/resizing an edge breaks the connection.
+
+    // is object a node?
     virtual bool IsNode() const;
 
-    // Automatische Klebepunkte:
-    // je 4 Scheitelpunkt- und Eckpositionen muss ein Knotenobjekt liefern
-    // i.d.R. 0=oben, 1=rechts, 2=unten, 3=links
+    // automatic glue points:
+    // a node object must provide four vertex and corner positions
+    // usually 0: top, 1: right, 2: bottom, 3: left
     virtual SdrGluePoint GetVertexGluePoint(sal_uInt16 nNum) const;
 
-    // i.d.R. 0=linksoben, 1=rechtsoben, 2=rechtsunten, 3=linksunten
+    // usually:
+    // 0: top-left, 1: top-right, 2: bottom-right, 3: bottom-left
     virtual SdrGluePoint GetCornerGluePoint(sal_uInt16 nNum) const;
 
-    // Liste aller Klebepunkte. Kann NULL sein.
+    // list of all glue points, can be NULL
     virtual const SdrGluePointList* GetGluePointList() const;
     //virtual SdrGluePointList* GetGluePointList();
 
-    // Nach veraendern der GluePointList muss man am Obj SendRepaintBroadcast rufen!
+    // after changing the GluePointList, one has to call the object's SendRepaintBroadcast!
     virtual SdrGluePointList* ForceGluePointList();
 
-    // Temporaer zu setzen fuer Transformationen am Bezugsobjekt
+    // to be set temporarily when transforming related object(?)
     void SetGlueReallyAbsolute(bool bOn);
     void NbcRotateGluePoints(const Point& rRef, long nWink, double sn, double cs);
     void NbcMirrorGluePoints(const Point& rRef1, const Point& rRef2);
     void NbcShearGluePoints (const Point& rRef, long nWink, double tn, bool bVShear);
 
-    // Objekt ist eine Kante?
+    // is object an edge?
     virtual bool IsEdge() const;
 
-    // bTail1=TRUE: Linienanfang, sonst LinienEnde
-    // pObj=NULL: Disconnect
+    // if bTail1 is true, line start, otherwise line end
+    // if pObj is null disconnect
     virtual void ConnectToNode(bool bTail1, SdrObject* pObj);
     virtual void DisconnectFromNode(bool bTail1);
     virtual SdrObject* GetConnectedNode(bool bTail1) const;
 
-    /** sets the writing mode of the object's context
-
-        Objects which itself do not support different writing modes will ignore this call.
-
-        Objects which support different writing modes, but have an own, explicit writing mode set,
-        will also ignore this call.
-
-        Objects which support different writing modes, and whose own mode is set to css.text.WritingMode2.CONTEXT,
-        will use the given writing mode to calculate their "effective writing mode".
-
-        The behaviour of this method is undefined if you pass css.text.WritingMode2.CONTEXT.
-
-        @param _nContextWritingMode
-            the effective writing mode of the context of the object
-    */
+    // sets the writing mode of the object's context
+    // Objects which itself do not support different writing modes will ignore this call.
+    // Objects which support different writing modes, but have an own, explicit writing mode set,
+    // will also ignore this call.
+    // Objects which support different writing modes, and whose own mode is set to css.text.WritingMode2.CONTEXT,
+    // will use the given writing mode to calculate their "effective writing mode".
+    // The behaviour of this method is undefined if you pass css.text.WritingMode2.CONTEXT.
+    // @param _nContextWritingMode
+    //     the effective writing mode of the context of the object
     virtual void    SetContextWritingMode( const sal_Int16 _nContextWritingMode );
 
-    // Wenn ein Objekt in der Lage ist, sich in ein Polygon oder in eine
-    // Bezierkurve (oder beides) zu verwandeln, dann sollten die folgenden
-    // Methoden ueberladen werden.
-    // Z.B. Ein RectObj mit Strichstaerke 10, SOLID_PEN in Polygon wandeln:
-    // Im Modus bLineToArea=false soll ein PolyObj mit 4 Stuetzstellen,
-    // Strichstaerke 10 und SOLiD_PEN erzeugt werden.
-    // Im Modus bLineToArea=true dagegen soll das generierte Obj immer ein
-    // LinienAttribut NULL_PEN haben, und die Linie (auch Linienmuster) selbst
-    // durch Polygonflaechen emuliert werden, die dadurch anschliessend vom
-    // Anwender manipuliert werden koennen. Das RectObj kann sich somit also
-    // nur korrekt konvertieren, wenn es als Flaechenattribut NULL_BRUSH
-    // besitzt. Es muesste in diesem Fall dann:
-    // - SOLID_BRUSH mit der Farbe des gesetzten Pen setzen
-    // - NULL_PEN setzen
-    // - PolyPolygon mit 2 Polygonen zu je 4 Stuetzstellen generieren.
-    // Der Returnwert ist jeweils ein SdrObject*, da als Rueckgabe zur Not
-    // auch Gruppenobjekte erlaubt sind (z.B. fuer SdrTextObj).
-    // Bei der Konvertierung von TextObj nach PathObj wird es wohl so sein,
-    // dass beide Modi (bLineToArea=true/false) identisch sind.
-    // Defaulted sind diese Methoden auf "Ich kann das nicht" (FALSE/NULL).
+    // If an object is able to convert itself into a polygon or into a Bezier curve (or into both),
+    // then the following methods should be overridden.
+    // E.g., convert a RectObj with line width 10, SOLID_PEN into a polygon:
+    // In the bLineToArea=false mode a PolyObj with four supporting points,
+    // line width 10 and SOLID_PEN shall be created.
+    // On the contrary in the bLineToArea=true mode the generated object should
+    // still have a line attribute NULL_PEN, and the line (also line pattern)
+    // itself should be emulated by the polygon area, which thereby can be
+    // manipulated by the user afterwards.
+    // The RectObj therefore can only convert correctly if it has an area attribute NULL_BRUSH.
+    // In this case it would have to:
+    // - set SOLID_BRUSH with the color of the given pen,
+    // - set NULL_PEN, and
+    // - generate PolyPolygon with two polygons with four supporting points each.
+    // In each case the return value is a SdrObject*, because it is also
+    // allowed to return group objects (e.g. for SdrTextObj).
+    // In the case of the conversion from TextObj to PathObj,
+    // both modi (bLineToArea=true/false) would be identical.
+    // The methods' default implementations report "I'm unable to do this" (false/null).
     virtual SdrObject* DoConvertToPolyObj(sal_Bool bBezier, bool bAddText) const;
     SdrObject* ConvertToPolyObj(bool bBezier, bool bLineToArea) const;
 
@@ -918,11 +879,12 @@ public:
     SdrObject* ConvertToContourObj(SdrObject* pRet, bool bForceLineDash = false) const;
     SdrObject* ImpConvertToContourObj(SdrObject* pRet, bool bForceLineDash = false) const;
 
-    // TRUE: Referenz auf ein Obj
+    // if true, reference onto an object
     bool IsVirtualObj() const;
 
-    // true=Obj kann warsch. gefuellt werden; false=Obj kann warsch. Linienenden haben.
-    // ungueltig, wenn es sich um ein GroupObj handelt.
+    // is true, if object can probably be filled
+    // is false, if object has probably line ends
+    // is invalid, if this is a group object
     bool IsClosedObj() const;
 
     bool IsEdgeObj() const;
@@ -951,59 +913,50 @@ public:
     // #i25616#
     bool DoesSupportTextIndentingOnLineWidthChange() const;
 
-    // applikationsspeziefische Daten
+    // application specific data
     sal_uInt16 GetUserDataCount() const;
     SdrObjUserData* GetUserData(sal_uInt16 nNum) const;
 
     void AppendUserData(SdrObjUserData* pData);
 
-    // Delete entfernt den Record aus der Liste und ruft
-    // ein delete (FreeMem+Dtor).
+    // removes the record from the list and performs delete (FreeMem+Dtor).
     void DeleteUserData(sal_uInt16 nNum);
 
-    // ItemPool fuer dieses Objekt wechseln
+    // switch ItemPool for this object
     void MigrateItemPool(SfxItemPool* pSrcPool, SfxItemPool* pDestPool, SdrModel* pNewModel = 0L);
 
-    ////////////////////////////////////////////////////////////////////////////////////////////////////
     // access to the UNO representation of the shape
     virtual ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface > getUnoShape();
     ::com::sun::star::uno::WeakReference< ::com::sun::star::uno::XInterface > getWeakUnoShape() const { return maWeakUnoShape; }
 
     static SdrObject* getSdrObjectFromXShape( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& xInt );
 
-    /** Sets a new UNO representation of the shape
-      *
-      * This is only a public interface function. The actual work is
-      * done by impl_setUnoShape().
-      *
-      * Calling this function is only allowed for the UNO representation
-      * itself!
-      */
+    // sets a new UNO representation of the shape
+    //  This is only a public interface function. The actual work is
+    //  done by impl_setUnoShape().
+    // Calling this function is only allowed for the UNO representation
+    // itself!
     void setUnoShape(
             const com::sun::star::uno::Reference<
                 com::sun::star::uno::XInterface>& _rxUnoShape);
 
-    /** retrieves the instance responsible for notifying changes in the properties of the shape associated with
-        the SdrObject
-
-        @precond
-            There already exists an SvxShape instance associated with the SdrObject
-        @throws ::com::sun::star::uno::RuntimeException
-            if there does nt yet exists an SvxShape instance associated with the SdrObject.
-    */
+    // retrieves the instance responsible for notifying changes in the properties of the shape associated with
+    // the SdrObject
+    //
+    // @precond
+    //     There already exists an SvxShape instance associated with the SdrObject
+    // @throws ::com::sun::star::uno::RuntimeException
+    //     if there does nt yet exists an SvxShape instance associated with the SdrObject.
     ::svx::PropertyChangeNotifier&
         getShapePropertyChangeNotifier();
 
-    /** notifies a change in the given property, to all applicable listeners registered at the associated SvxShape
-
-        This method is equivalent to calling getShapePropertyChangeNotifier().notifyPropertyChange( _eProperty ),
-        exception that it is allowed to be called when there does not yet exist an associated SvxShape - in which
-        case the method will silently return without doing anything.
-    */
+    // notifies a change in the given property, to all applicable listeners registered at the associated SvxShape
+    //
+    // This method is equivalent to calling getShapePropertyChangeNotifier().notifyPropertyChange( _eProperty ),
+    // exception that it is allowed to be called when there does not yet exist an associated SvxShape - in which
+    // case the method will silently return without doing anything.
     void    notifyShapePropertyChange( const ::svx::ShapeProperty _eProperty ) const;
 
-    ////////////////////////////////////////////////////////////////////////////////////////////////////
-    //
     // transformation interface for StarOfficeAPI. This implements support for
     // homogen 3x3 matrices containing the transformation of the SdrObject. At the
     // moment it contains a shearX, rotation and translation, but for setting all linear
@@ -1019,7 +972,7 @@ public:
     virtual void TRSetBaseGeometry(const basegfx::B2DHomMatrix& rMatrix, const basegfx::B2DPolyPolygon& rPolyPolygon);
 
     // #116168#
-    // Give info if object is in destruction
+    // give info if object is in destruction
     bool IsInDestruction() const;
 
     // return if fill is != XFILL_NONE
@@ -1028,7 +981,7 @@ public:
 
     // on import of OLE object from MS documents the BLIP size might be retrieved,
     // the following methods are used to control it;
-    // usually this data makes no sence after the import is finished, since the object
+    // usually this data makes no sense after the import is finished, since the object
     // might be resized
     Rectangle GetBLIPSizeRectangle() const;
     void SetBLIPSizeRectangle( const Rectangle& aRect );
@@ -1044,58 +997,51 @@ public:
     virtual OString stringify() const;
 
 protected:
-    /** Sets a new UNO shape
-      *
-      * The default implementation of this function sets the new UNO
-      * shape. Derived classes should override the function to handle
-      * any other actions that are needed when the shape is being
-      * changed.
-      *
-      * The implementation _must_ call the same method of its parent
-      * class (preferably as the first step)!
-      */
+    // Sets a new UNO shape
+    //
+    // The default implementation of this function sets the new UNO
+    // shape. Derived classes should override the function to handle
+    // any other actions that are needed when the shape is being
+    // changed.
+    //
+    // The implementation _must_ call the same method of its parent
+    // class (preferably as the first step)!
     virtual void    impl_setUnoShape( const ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& _rxUnoShape );
 
-    /**
-     Helper function for reimplementing Clone().
-    */
+    // helper function for reimplementing Clone().
     template< typename T > T* CloneHelper() const;
 
 private:
-    /** only for internal use!
-    */
+    // only for internal use!
     SvxShape* getSvxShape();
 
-    /** do not use directly, always use getSvxShape() if you have to! */
+    // do not use directly, always use getSvxShape() if you have to!
     SvxShape*   mpSvxShape;
     ::com::sun::star::uno::WeakReference< ::com::sun::star::uno::XInterface >
                 maWeakUnoShape;
-    /** HACK: Do not automatically insert newly created object into a page.
-      *
-      * The user needs to do it manually later.
-      */
+    // HACK: Do not automatically insert newly created object into a page.
+    // The user needs to do it manually later.
     bool mbDoNotInsertIntoPageAutomatically;
 };
 
-// Wer sich eigene Objekte schafft muss einen Link in der Klasse
-// SdrObjFactory setzen. Der Handler hat folgendes aussehen:
+// Whoever creates his own objects must set a link in the SdrObjFactory class.
+// The handler must have the following signature:
 //    void Hdl(SdrObjFactory*)
-// Er muss sich aus der uebergebenen Instanz die Werte nInventor und
-// nIdentifier ansehen und entsprechend mit new eine Zeichenobjektinstanz
-// erzeugen. Einen Zeiger auf diese Instanz hat er in der Membervariablen
-// pNewObj zu hinterlassen.
+// He must take a look at the referenced instance's nInventor and nIdentifier values,
+// and must create a new drawing object instance accordingly.
+// He must also make the pNewObj pointer reference to this instance.
 class SVX_DLLPUBLIC SdrObjFactory
 {
 public:
     sal_uInt32                      nInventor;
     sal_uInt16                      nIdentifier;
 
-    // fuer MakeNewObj():
+    // for MakeNewObj():
     SdrPage*                    pPage;
     SdrModel*                   pModel;
     SdrObject*                  pNewObj;
 
-    // fuer MakeNewObjUserData():
+    // for MakeNewObjUserData():
     SdrObject*                  pObj;
     SdrObjUserData*             pNewData;