svx: translate German comments on SdrObject/SdrPage

Change-Id: I6fcccc0c8a5ec75edc54f6b5a4675a7ed9e1ca8f

2 files changed, 141 insertions, 141 deletions

diff --git a/include/svx/svdobj.hxx b/include/svx/svdobj.hxx
index fd1f56f79af2..1113ef88118b 100644
--- a/include/svx/svdobj.hxx
+++ b/include/svx/svdobj.hxx
@@ -105,44 +105,46 @@ namespace svx
 
 // Defines
 
-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,  // 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,  // 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 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,  // 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_OPENGL     =36,  // opengl graphic
-                 OBJ_MAXI};
+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,  /// 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,  /// natural cubic Spline                  (ni)
+    OBJ_SPLNFILL   =15,  /// periodic cubic Spline                 (ni)
+    OBJ_TEXT       =16,  /// text object
+    OBJ_TEXTEXT    =17,  /// text extension frame                  (ni)
+    OBJ_wegFITTEXT,      /// FitToSize-Text (all lines equal)
+    OBJ_wegFITALLTEXT,   /// FitToSize-Text (by line)              (ni)
+    OBJ_TITLETEXT  =20,  /// TitleText, special text object for StarDraw
+    OBJ_OUTLINETEXT=21,  /// OutlineText, special text object for StarDraw
+    OBJ_GRAF       =22,  /// foreign graphic (StarView Graphic)
+    OBJ_OLE2       =23,  /// OLE object
+    OBJ_EDGE       =24,  /// connector object
+    OBJ_CAPTION    =25,  /// caption object
+    OBJ_PATHPOLY   =26,  /// Polygon/PolyPolygon represented by SdrPathObj
+    OBJ_PATHPLIN   =27,  /// Polyline represented by SdrPathObj
+    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,  /// continuously activated 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_OPENGL     =36,  /// opengl graphic
+    OBJ_MAXI
+};
 
 enum SdrUserCallType {SDRUSERCALL_MOVEONLY,         // only moved, size unchanged
                       SDRUSERCALL_RESIZE,           // size and maybe position changed
@@ -402,10 +404,10 @@ protected:
     virtual SdrObjPlusData* NewPlusData() const;
 
 protected:
-    // Diese 3 Methoden muss ein abgeleitetes Objekt ueberladen, wenn es eigene
-    // geometrische Daten besitzt, die fuer den Undo-Fall gesichert werden
-    // sollen. NewGeoData() erzeugt lediglich eine leere Instanz auf eine von
-    // SdrObjGeoData abgeleitete Klasse.
+    /// A derived class must override these 3 methods if it has own geometric
+    /// data that must be saved for Undo.
+    /// NewGeoData() creates an empty instance of a class derived from
+    /// SdrObjGeoData.
     virtual SdrObjGeoData* NewGeoData() const;
     virtual void SaveGeoData(SdrObjGeoData& rGeo) const;
     virtual void RestGeoData(const SdrObjGeoData& rGeo);
@@ -480,15 +482,15 @@ public:
     virtual SdrObjList* GetSubList() const;
     SdrObject* GetUpGroup() const;
 
-    // Ueber die Objekt-Ordnungsnummer kann man feststellen, ob ein Objekt vor
-    // oder hinter einem anderen liegt. Objekte mit kleinen Ordnungsnummern werden
-    // zuerst gezeichnet, Objekte mit grossen Ordnungsnummern zuletzt.
-    // Wird die Reihenfolge der Objekte in der Liste veraendert, so wird ein
-    // Dirty-Flag gesetzt (an der Page). Beim naechsten SdrObject::GetOrdNum()
-    // werden die Ordnungsnummer aller Objekte der Liste neu bestimmt.
+    /// The order number (aka ZOrder, aka z-index) determines whether a
+    /// SdrObject is located above or below another.  Objects are painted from
+    /// lowest to highest order number.  If the order of SdrObjects in the
+    /// SdrObjList is changed, the bObjOrdNumsDirty flag is set on the SdrPage
+    /// and the next GetOrdNum() call recalculates the order number of all
+    /// SdrObjects in the SdrObjList.
     sal_uInt32 GetOrdNum() const;
 
-    // Warning: this method should only be used if you really knows what you're doing
+    // Warning: this method should only be used if you really know what you're doing
     sal_uInt32 GetOrdNumDirect() const { return nOrdNum;}
 
     // setting the order number should only happen from the model or from the page
@@ -556,41 +558,41 @@ public:
     virtual OUString TakeObjNameSingul() const;
     virtual OUString TakeObjNamePlural() const;
 
-    // Das Xor-Polygon wird von der View zu Draggen des Objektes benoetigt.
-    // Alle Polygone innerhalb des tools::PolyPolygon werden als PolyLine interpretiert.
-    // Moechte man ein geschlossenes Polygon, so muss man es explizit schliessen.
+    /// The Xor-Polygon is required by the View to drag the object.
+    /// All polygons within the PolyPolygon are interpreted as PolyLine.
+    /// To get a closed Polygon, close it explicitly.
     virtual basegfx::B2DPolyPolygon TakeXorPoly() const;
 
-    // Die Kontur fuer TextToContour
+    /// contour for TextToContour
     virtual basegfx::B2DPolyPolygon TakeContour() const;
 
-    // Ueber GetHdlCount gibt ein Objekt die Anzahl seiner Handles preis.
-    // Im Normalfall werden dies 8 sein, bei einer Strecke 2. Bei Polygonobjekten
-    // (Polygon,Spline,Bezier) kann die Handleanzahl wesentlich groesser werden.
-    // Polygonobjekten wird ausserdem die Moeglichkeit eingeraeumt einen Punkt
-    // eines selektierten Objekts zu selektieren. Das Handle dieses Punktes wird
-    // dann durch einen Satz neuer Handles ausgetauscht (PlusHdl). Bei einem
-    // Polygon wird das wohl ein einfacher Selektionshandle sein, bei einer
-    // Bezierkurve dagegen koennen das schon bis zu 3 Handles werden (inkl Gewichte).
-    // GetHdl() und GetPlusHdl() muessen Handleinstanzen mit new erzeugen!
-    // Ein Objekt, das bei HasSpacialDrag() true liefert muss diese Methoden
-    // zur Verfuegung stellen (inkl. FillHdlList).
+    /// Via GetHdlCount the number of Handles can be retrieved.
+    /// Normally 8, if it's a line 2.
+    /// For Polygon objects (Polygon/Spline/Bezier) the number may be much
+    /// larger.  Polygon objects are also allowed to select a point of a
+    /// selected object.  The handle of that point will then be replaced by
+    /// a new set of handles (PlusHdl).  For a Polygon this would be a simple
+    /// selection Handle, for a Bezier curve this may be up to 3 Handles
+    /// (including Weights).
+    /// GetHdl() and GetPlusHdl() must create Handle instances with new!
+    /// An object that returns true from HasSpacialDrag() must provide these
+    /// methods (incl. FillHdlList()).
     virtual sal_uInt32 GetHdlCount() const;
     virtual SdrHdl* GetHdl(sal_uInt32 nHdlNum) const;
     virtual sal_uInt32 GetPlusHdlCount(const SdrHdl& rHdl) const;
     virtual SdrHdl* GetPlusHdl(const SdrHdl& rHdl, sal_uInt32 nPlNum) const;
     virtual void AddToHdlList(SdrHdlList& rHdlList) const;
 
-    // Die Standardtransformationen (Move,Resize,Rotate,Mirror,Shear) werden von der
-    // View uebernommen (TakeXorPoly(),...).
-    // Objektspeziefisches draggen wie z.B. Eckenradius bei Rechtecken,
-    // Stuetzstellen bei Splines, Gewichte bei Bezierkurven und Pointer von
-    // Labelobjekten muss vom Objekt selbst gehandled werden. Um das Model
-    // Statusfrei zu halten werden die Statusdaten an der View gehalten und dem
-    // Objekt dann uebergeben. EndDrag liefrt im Normalfall true fuer Erfolg.
-    // false kann zurueckgegeben werden, wenn das Dragging das Objekt nicht
-    // veraendert hat, wobei dir evtl. Tatsache das die Maus nicht bewegt wurde
-    // bereits von der View abgefangen wird.
+    /// The standard transformations (Move,Resize,Rotate,Mirror,Shear) are
+    /// taken over by the View (TakeXorPoly(),...).
+    /// Object type specific dragging like corner radius of Rectangle,
+    /// control points of Splines, weights of Bezier curves, pointer of
+    /// Label objects must be handled by the object itself.
+    /// To keep the Model free of state, the state is kept in the View
+    /// and then passed to the object. EndDrag usually returns true for success,
+    /// false may be returned if the dragging did not modify the object,
+    /// where the View already handles the case that the pointer was not
+    /// moved at all.
     virtual bool hasSpecialDrag() const;
     virtual bool beginSpecialDrag(SdrDragStat& rDrag) const;
     virtual bool applySpecialDrag(SdrDragStat& rDrag);
@@ -607,36 +609,36 @@ public:
     virtual bool supportsFullDrag() const;
     virtual SdrObject* getFullDragClone() const;
 
-    // Jedes Objekt muss in der Lage sein sich selbst interaktiv zu erzeugen.
-    // Beim MausDown wird zunaechst ein neues Objekt erzeugt und dann seine
-    // BegCreate()-Methode gerufen. Bei jedem MausMode wird dann MovCreate
-    // gerufen. BrkCreate() bedeutet, dass der User die interaktive Objekt-
-    // erzeugung abgebrochen hat. EndCreate() wird gerufen beim MouseUp-Event.
-    // Liefert EndCreate() ein true, so ist die Objekterzeugung abgeschlossen;
-    // das Objekt wird in die entsprechende Liste eingefuegt. Andernfalls
-    // (EndCreate()==false) gehe ich davon aus, dass weitere Punkte zur
-    // Objekterzeugung notwendig sind (Polygon,...). Der Parameter eCmd
-    // enthaelt die Anzahl der Mausklicks (so die App diese durchreicht).
-    // BckCreate() -> Letztes EndCreate() rueckgaengig machen (z.B. letzten
-    // Polygonpunkt wieder loeschen).
-    // ReturnCode: true=Weiter gehts, false=Create dadurch abgebrochen.
+    /// Every object must be able to create itself interactively.
+    /// On MouseDown first an object is created, and its BegCreate() method
+    /// is called.  On every MouseMove, MovCreate() is called.  BrkCreate()
+    /// is called if the user cancels the interactive object creation.
+    /// EndCreate() is called on the MouseUp event.  If EndCreate() returns
+    /// true, the creation is finished; the object is inserted into the
+    /// corresponding list.  Otherwise it is assumed that further points
+    /// are necessary to create the object (Polygon, ...).  The parameter
+    /// eCmd contains the number of mouse clicks (if the application
+    /// provides it).
+    /// BckCreate() will undo the previous EndCreate(), e.g. to delete the
+    /// last point of the Polygon.  If BckCreate() returns false, creation
+    /// is cancelled.
     virtual bool BegCreate(SdrDragStat& rStat);
     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);
 
-    // damit holt man sich den Pointer, der das Createn dieses Objekts symbolisiert
+    /// get the cursor/pointer that signals creating this object
     virtual Pointer GetCreatePointer() const;
 
-    // Polygon das waehrend des Erzeugens aufgezogen wird
+    /// Polygon dragged by the user when creating the object
     virtual basegfx::B2DPolyPolygon TakeCreatePoly(const SdrDragStat& rDrag) const;
 
-    // Die Methoden Move, Resize, Rotate, Mirror, Shear, SetSnapRect und
-    // SetLogicRect rufen jeweils die entsprechenden Nbc-Methoden, versenden einen
-    // Repaint-Broadcast und setzen den Modified-Status am Model. Abgeleitete
-    // Objekte sollten i.d.R. nur die Nbc-Methoden ueberladen.
-    // Nbc bedeutet: 'NoBroadcast'.
+    /// The methods Move, Resize, Rotate, Mirror, Shear, SetSnapRect and
+    /// SetLogicRect call the corresponding Nbc-methods, send a Repaint
+    /// broadcast and set the Modified state on the Model.
+    /// Derived classes should usually only override the Nbc methods.
+    /// Nbc means "no broadcast".
     virtual void NbcMove  (const Size& rSiz);
     virtual void NbcResize(const Point& rRef, const Fraction& xFact, const Fraction& yFact);
     virtual void NbcRotate(const Point& rRef, long nAngle, double sn, double cs);
@@ -649,9 +651,8 @@ public:
     virtual void Mirror(const Point& rRef1, const Point& rRef2);
     virtual void Shear (const Point& rRef, long nAngle, double tn, bool bVShear);
 
-    // Die relative Position eines Zeichenobjektes ist die Entfernung der
-    // linken oberen Eche des logisch umschliessenden Rechtecks (SnapRect)
-    // zum Anker.
+    /// The relative position of a SdrObject is the distance of the upper
+    /// left corner of the logic bounding rectangle (SnapRect) to the anchor.
     virtual void NbcSetRelativePos(const Point& rPnt);
     virtual void SetRelativePos(const Point& rPnt);
     virtual Point GetRelativePos() const;
@@ -660,10 +661,10 @@ public:
     virtual void SetAnchorPos(const Point& rPnt);
     virtual const Point& GetAnchorPos() const;
 
-    // Snap wird nicht auf dem BoundRect ausgefuehrt, sondern nach Moeglichkeit auf
-    // logischen Koordinaten (also ohne Beruecksichtigung von Strichstaerke, ... ).
-    // SetSnapRect() versucht das Objekt so hinzusizen, dass es in das uebergebene
-    // Rect passt (ohne Strichstaerke, ...)
+    /// Snap is not done on the BoundRect but if possible on logic coordinates
+    /// (i.e. without considering stroke width, ...)
+    /// SetSnapRect() tries to size the Object so that it fits into the
+    /// passed Rect (without stroke width, ...)
     virtual void RecalcSnapRect();
     virtual const Rectangle& GetSnapRect() const;
     virtual void SetSnapRect(const Rectangle& rRect);
@@ -685,8 +686,7 @@ public:
     virtual long GetRotateAngle() const;
     virtual long GetShearAngle(bool bVertical = false) const;
 
-    // Zum Fangen von/auf ausgezeichneten Punkten eines Obj (Polygonpunkte,
-    // Kreismittelpunkt, ...)
+    /// snap to special points of an Object (polygon points, center of circle)
     virtual sal_uInt32 GetSnapPointCount() const;
     virtual Point GetSnapPoint(sal_uInt32 i) const;
 
diff --git a/include/svx/svdpage.hxx b/include/svx/svdpage.hxx
index c186f3a592f6..833e0ce2383d 100644
--- a/include/svx/svdpage.hxx
+++ b/include/svx/svdpage.hxx
@@ -54,12 +54,14 @@ class Color;
 class SfxStyleSheet;
 class SvxUnoDrawPagesAccess;
 
-enum SdrInsertReasonKind {SDRREASON_UNKNOWN,    // unbekannt
-                          SDRREASON_STREAMING,  // einlesen eines Doks
-                          SDRREASON_UNDO,       // kommt aus dem Undo
-                          SDRREASON_COPY,       // irgendjemand kopiert...
-                          SDRREASON_VIEWCREATE, // vom Anwender interaktiv erzeugt
-                          SDRREASON_VIEWCALL};  // Durch SdrView::Group(), ...
+enum SdrInsertReasonKind {
+    SDRREASON_UNKNOWN,
+    SDRREASON_STREAMING,  /// importing document
+    SDRREASON_UNDO,       /// from Undo
+    SDRREASON_COPY,       /// something copied...
+    SDRREASON_VIEWCREATE, /// created by User interactively
+    SDRREASON_VIEWCALL    /// via SdrView::Group(), ...
+};
 
 class SdrInsertReason {
     const SdrObject* pRefObj;
@@ -88,10 +90,10 @@ private:
 protected:
 friend class SdrObjListIter;
 friend class SdrEditView;
-    SdrObjList* pUpList;   // Vaterliste
-    SdrModel*   pModel;    // Diese Liste gehoert zu diesem Model (Layer,ItemPool,Storage).
-    SdrPage*    pPage;     // Page, in die Liste haengt. Kann auch this sein.
-    SdrObject*  pOwnerObj; // OwnerObject, falls Liste eines GruppenObjekts.
+    SdrObjList* pUpList;   /// parent list
+    SdrModel*   pModel;    /// model to which the list belongs (Layer,ItemPool,Storage)
+    SdrPage*    pPage;     /// Page containing the list, may be "this".
+    SdrObject*  pOwnerObj; /// OwnerObject, if it's list of a Group object.
     Rectangle   aOutRect;
     Rectangle   aSnapRect;
     SdrObjListKind eListKind;
@@ -113,12 +115,12 @@ public:
 
     virtual SdrObjList* Clone() const;
 
-    // !!! Diese Methode nur fuer Leute, die ganz genau wissen was sie tun !!!
+    // !!! This method is only for people who know exactly what they do !!!
 
     // #110094# This should not be needed (!)
     void SetObjOrdNumsDirty()                           { bObjOrdNumsDirty=true; }
     void CopyObjects(const SdrObjList& rSrcList);
-    // alles Aufraeumen (ohne Undo)
+    /// clean up everything (without Undo)
     void    Clear();
     SdrObjListKind GetListKind() const                  { return eListKind; }
     void           SetListKind(SdrObjListKind eNewKind) { eListKind=eNewKind; }
@@ -130,7 +132,7 @@ public:
     virtual void     SetPage(SdrPage* pNewPage);
     virtual SdrModel* GetModel() const;
     virtual void      SetModel(SdrModel* pNewModel);
-    // Neuberechnung der Objekt-Ordnungsnummern
+    /// recalculate order numbers / ZIndex
     void     RecalcObjOrdNums();
     bool IsObjOrdNumsDirty() const        { return bObjOrdNumsDirty; }
     virtual void NbcInsertObject(SdrObject* pObj, size_t nPos=SAL_MAX_SIZE
@@ -139,15 +141,15 @@ public:
     virtual void InsertObject(SdrObject* pObj, size_t nPos=SAL_MAX_SIZE
                               , const SdrInsertReason* pReason=NULL
                                                                      );
-    // aus Liste entfernen ohne delete
+    /// remove from list without delete
     virtual SdrObject* NbcRemoveObject(size_t nObjNum);
     virtual SdrObject* RemoveObject(size_t nObjNum);
-    // Vorhandenes Objekt durch ein anderes ersetzen.
-    // Wie Remove&Insert jedoch performanter, da die Ordnungsnummern
-    // nicht Dirty gesetzt werden muessen.
+    /// Replace existing object by different one.
+    /// Same as Remove(old)+Insert(new) but faster because the order numbers
+    /// do not have to be set dirty.
     virtual SdrObject* NbcReplaceObject(SdrObject* pNewObj, size_t nObjNum);
     virtual SdrObject* ReplaceObject(SdrObject* pNewObj, size_t nObjNum);
-    // Die Z-Order eines Objekts veraendern
+    /// Modify ZOrder of an SdrObject
     virtual SdrObject* NbcSetObjectOrdNum(size_t nOldObjNum, size_t nNewObjNum);
     virtual SdrObject* SetObjectOrdNum(size_t nOldObjNum, size_t nNewObjNum);
 
@@ -156,23 +158,23 @@ public:
     const Rectangle& GetAllObjSnapRect() const;
     const Rectangle& GetAllObjBoundRect() const;
 
-    // Alle Textobjekte neu formatieren, z.B. bei Druckerwechsel
+    /// reformat all text objects, e.g. when changing printer
     void NbcReformatAllTextObjects();
     void ReformatAllTextObjects();
 
     /** #103122# reformats all edge objects that are connected to other objects */
     void ReformatAllEdgeObjects();
 
-    // Die Vorlagenattribute der Zeichenobjekte in harte Attribute verwandeln.
+    /// convert attributes of the style to hard formatting
     void BurnInStyleSheetAttributes();
 
     size_t GetObjCount() const;
     SdrObject* GetObj(size_t nNum) const;
 
-    // Gelinkte Seite oder gelinktes Gruppenobjekt
+    /// linked page or linked group object
     virtual bool IsReadOnly() const;
 
-    // Zaehlt alle Objekte inkl. Objekte in Objektgruppen, ...
+    /// count all objects including objects in Groups
     size_t CountAllObjects() const;
 
     /** Makes the object list flat, i.e. the object list content are
@@ -302,22 +304,13 @@ private:
         const sal_uInt32 nObjectPosition);
 };
 
-/*
-Eine Sdraw-Seite enthaelt genau eine Objektliste sowie eine Beschreibung
-der physikalischen Seitendimensionen (Groesse/Raender). Letzteres wird
-lediglich zum Fangen von Objekten beim Draggen benoetigt.
-An der Seite lassen sich (ueber SdrObjList) Objekte einfuegen und loeschen,
-nach vorn und nach hinten stellen. Ausserdem kann die Ordnungszahl eines
-Objektes abgefragt sowie direkt gesetzt werden.
-*/
-
 // Used for all methods which return a page number
 #define SDRPAGE_NOTFOUND 0xFFFF
 
 
 // class SdrPageGridFrame
 
-// Fuer das Fangraster/Punkgitter im Writer
+/// for the snap-to-grid in Writer
 class SdrPageGridFrame
 {
     Rectangle aPaper;
@@ -407,8 +400,15 @@ public:
 };
 
 
-// class SdrPage
-
+/**
+  A SdrPage contains exactly one SdrObjList and a description of the physical
+  page dimensions (size / margins).  The latter is required to "catch" objects
+  during drag-and-drop.
+  The SdrPage allows (via SdrObjList) inserting and removing SdrObjects,
+  as well as moving them into the foreground or background.
+  Also it's possible to request and directly set the order number (ZOrder)
+  of SdrObjects.
+*/
 class SVX_DLLPUBLIC SdrPage : public SdrObjList, public tools::WeakBase< SdrPage >
 {
     SdrPage& operator=(const SdrPage& rSrcPage) SAL_DELETED_FUNCTION;
@@ -541,15 +541,15 @@ protected:
     void TRG_ImpMasterPageRemoved(const SdrPage& rRemovedPage);
 public:
 
-    // Aenderungen an den Layern setzen nicht das Modified-Flag !
+    /// changing the layers does not set the modified-flag!
     const         SdrLayerAdmin& GetLayerAdmin() const                  { return *pLayerAdmin; }
                   SdrLayerAdmin& GetLayerAdmin()                        { return *pLayerAdmin; }
 
     virtual OUString GetLayoutName() const;
 
-    // fuer's Raster im Writer, auch fuer AlignObjects wenn 1 Objekt markiert ist
-    // wenn pRect!=NULL, dann die Seiten, die von diesem Rect intersected werden
-    // ansonsten die sichtbaren Seiten.
+    /// for snap-to-grid in Writer, also for AlignObjects if 1 object is marked
+    /// if pRect != null, then the pages that are intersected by this Rect,
+    /// otherwise the visible pages
     virtual const SdrPageGridFrameList* GetGridFrameList(const SdrPageView* pPV, const Rectangle* pRect) const;
     bool IsObjectsNotPersistent() const          { return mbObjectsNotPersistent; }
     void SetObjectsNotPersistent(bool b)     { mbObjectsNotPersistent = b; }