Translate German comments, fix some WS

Change-Id: I5dcf6a911275e9fcb07d21b810591237a0f1ab9f
Reviewed-on: https://gerrit.libreoffice.org/4747Reviewed-by: Thorsten Behrens <tbehrens@suse.com>
Tested-by: Thorsten Behrens <tbehrens@suse.com>

include/svx/SvxColorChildWindow.hxx

@@ -21,12 +21,9 @@
 #include <sfx2/childwin.hxx>
 #include "svx/svxdllapi.h"
 
-/*************************************************************************
-|*
-|* Ableitung vom SfxChildWindow als "Behaelter" fuer Controller
-|*
-\************************************************************************/
-
+/**
+ * Child of SfxChildWindow as a "container" for Controller
+ */
 class SVX_DLLPUBLIC SvxColorChildWindow : public SfxChildWindow
 {
  public:

include/svx/fmsrcimp.hxx

@@ -38,10 +38,9 @@
 
 #include <deque>
 
-// ===================================================================================================
-// = class FmSearchThread
-// ===================================================================================================
-
+/**
+ * class FmSearchThread
+ */
 class FmSearchEngine;
 class FmSearchThread : public ::osl::Thread
 {
@@ -56,11 +55,10 @@ public:
     void setTerminationHandler(Link aHdl) { m_aTerminationHdl = aHdl; }
 };
 
-// ===================================================================================================
-// = struct FmSearchProgress - the owner of SearchEngine receives this structure for status updates
-// = (at the end of the search)
-// ===================================================================================================
-
+/**
+ * struct FmSearchProgress - the owner of SearchEngine receives this structure for status updates
+ * (at the end of the search)
+ */
 struct FmSearchProgress
 {
     enum STATE { STATE_PROGRESS, STATE_PROGRESS_COUNTING, STATE_CANCELED, STATE_SUCCESSFULL, STATE_NOTHINGFOUND, STATE_ERROR };
@@ -79,11 +77,10 @@ struct FmSearchProgress
     sal_Int32   nFieldIndex;
 };
 
-// ===================================================================================================
-// = class FmRecordCountListener - utility class for FmSearchEngine, listens at a certain cursor and provides
-// =                                the differences in RecordCount
-// ===================================================================================================
-
+/**
+ * class FmRecordCountListener - utility class for FmSearchEngine, listens at a certain cursor and provides
+ *                               the differences in RecordCount
+ */
 class FmRecordCountListener : public ::cppu::WeakImplHelper1< ::com::sun::star::beans::XPropertyChangeListener>
 {
 // attribute
@@ -103,10 +100,10 @@ public:
     //  DECLARE_UNO3_AGG_DEFAULTS(FmPropertyListener, UsrObject);
     //  virtual sal_Bool queryInterface(::com::sun::star::uno::Uik aUik, ::com::sun::star::uno::Reference< ::com::sun::star::uno::XInterface >& rOut);
 
-// ::com::sun::star::lang::XEventListener
+    // ::com::sun::star::lang::XEventListener
     virtual void SAL_CALL disposing(const ::com::sun::star::lang::EventObject& Source) throw(::com::sun::star::uno::RuntimeException);
 
-// ::com::sun::star::beans::XPropertyChangeListener
+    // ::com::sun::star::beans::XPropertyChangeListener
     virtual void SAL_CALL propertyChange(const ::com::sun::star::beans::PropertyChangeEvent& evt) throw(::com::sun::star::uno::RuntimeException);
 
     void DisConnect();
@@ -116,12 +113,12 @@ private:
 
 };
 
-// ===================================================================================================
-// = class FmSearchEngine - Impl class for FmSearchDialog
-// ===================================================================================================
-
+/**
+ * class FmSearchEngine - Impl class for FmSearchDialog
+ */
 namespace svxform {
-    // We have three possible control types we may search in, determined by the supported interfaces : ::com::sun::star::awt::XTextComponent, ::com::sun::star::awt::XListBox, ::com::sun::star::awt::XCheckBox.
+    // We have three possible control types we may search in, determined by the supported interfaces : ::com::sun::star::awt::XTextComponent,
+    // ::com::sun::star::awt::XListBox, ::com::sun::star::awt::XCheckBox.
     // While searching we don't want to do this distinction for every control in every round. So we need some helpers.
     class ControlTextWrapper
     {
@@ -172,7 +169,7 @@ class SVX_DLLPUBLIC FmSearchEngine
 
     CursorWrapper                   m_xSearchCursor;
     std::deque<sal_Int32>           m_arrFieldMapping;
-        // since the iterator could have more columns, as managed here (in this field listbox),
+    // Since the iterator could have more columns, as managed here (in this field listbox),
     // a mapping of this ::com::sun::star::form keys on the indices of the respective columns is kept in the iterator
 
     // the formatter
@@ -201,19 +198,19 @@ class SVX_DLLPUBLIC FmSearchEngine
     CursorWrapper           m_xOriginalIterator;
     CursorWrapper           m_xClonedIterator;
 
-    // data for the decision in which field a "Found" is accepted
+    // Data for the decision in which field a "Found" is accepted
     ::com::sun::star::uno::Any  m_aPreviousLocBookmark;     // position of the last finding
     FieldCollectionIterator     m_iterPreviousLocField;     // field of the last finding
 
-    // Kommunikation mit dem Thread, der die eigentliche Suche durchfuehrt
+    // Communication with the thread that does the actual searching
     OUString            m_strSearchExpression;              // forward direction
     SEARCHFOR_TYPE      m_eSearchForType;                   // ditto
     SEARCH_RESULT       m_srResult;                         // backward direction
 
-    // der Link, dem ich Fortschritte und Ergebnisse mitteile
+    // The link we broadcast the progress and the result to
     Link                m_aProgressHandler;
     sal_Bool            m_bSearchingCurrently : 1;      // is an (asynchronous) search running?
-    sal_Bool            m_bCancelAsynchRequest : 1;     // should be cancelled ?
+    sal_Bool            m_bCancelAsynchRequest : 1;     // should be cancelled?
     ::osl::Mutex        m_aCancelAsynchAccess;          // access to_bCancelAsynchRequest (technically only
                                                         // relevant for m_eMode == SM_USETHREAD)
     FMSEARCH_MODE   m_eMode;                            // current mode

include/svx/msdffdef.hxx

@@ -781,7 +781,7 @@ typedef enum
    mso_sptActionButtonMovie = 200,
    mso_sptHostControl = 201,
    mso_sptTextBox = 202,
-   //for pptx shape which not exist in ppt
+   //for pptx shape which doesn't exist in ppt
    mso_sptTearDrop = 203,
    mso_sptMax = 0x0FFF,
    mso_sptNil = mso_sptMax
@@ -1068,7 +1068,7 @@ enum MSO_LineCap {
    mso_lineEndCapSquare,  // Square protrudes by half line width
    mso_lineEndCapFlat     // Line ends at end point
 };
-// verschiedene enums aus der OfficeDraw-Doku, Appendix D - Ende
+// Various enums from the OfficeDraw documentation Appendix D - End
 
 // BStore-Container
 // FBSE - File Blip Store Entry

include/svx/sderitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/sdmetitm.hxx>
 #include <svx/svddef.hxx>
 
-//------------------------------
-// class SdrEckenradiusItem
-//------------------------------
+/**
+ * class SdrEckenradiusItem
+ */
 class SdrEckenradiusItem: public SdrMetricItem {
 public:
     SdrEckenradiusItem(long nRadius=0): SdrMetricItem(SDRATTR_ECKENRADIUS,nRadius) {}

include/svx/sdshitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/sdooitm.hxx>
 #include <svx/svddef.hxx>
 
-//------------------------------
-// class SdrShadowItem
-//------------------------------
+/*
+ * class SdrShadowItem
+ */
 class SdrShadowItem: public SdrOnOffItem {
 public:
     SdrShadowItem(sal_Bool bShadow=sal_False): SdrOnOffItem(SDRATTR_SHADOW, bShadow) {}

include/svx/sdshtitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/sdprcitm.hxx>
 #include <svx/svddef.hxx>
 
-//---------------------
-// class SdrShadowTransparenceItem
-//---------------------
+/**
+ * class SdrShadowTransparenceItem
+ */
 class SdrShadowTransparenceItem: public SdrPercentItem {
 public:
     SdrShadowTransparenceItem(sal_uInt16 nTransp=0): SdrPercentItem(SDRATTR_SHADOWTRANSPARENCE,nTransp) {}

include/svx/sdtcfitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/sdooitm.hxx>
 #include <svx/svddef.hxx>
 
-//------------------------------------
-// class SdrTextContourFrameItem
-//------------------------------------
+/*
+ * class SdrTextContourFrameItem
+ */
 class SdrTextContourFrameItem: public SdrOnOffItem {
 public:
     SdrTextContourFrameItem(sal_Bool bOn=sal_False): SdrOnOffItem(SDRATTR_TEXT_CONTOURFRAME,bOn) {}

include/svx/sphere3d.hxx

@@ -23,13 +23,10 @@
 #include <svx/obj3d.hxx>
 #include "svx/svxdllapi.h"
 
-/*************************************************************************
-|*
-|* Kugelobjekt mit Durchmesser r3DSize; Anzahl der Flaechen wird durch
-|* die horizontale und vertikale Segmentanzahl vorgegeben
-|*
-\************************************************************************/
-
+/**
+ * SphereObject with diameter r3DSize.
+ * The count of planes depends on the horizontal and vertical segment count.
+ */
 class SVX_DLLPUBLIC E3dSphereObj : public E3dCompoundObject
 {
 private:

include/svx/svdcrtv.hxx

@@ -89,8 +89,7 @@ public:
     void SetMeasureLayer(const String& rName) { aMeasureLayer=rName; }
     const String& GetMeasureLayer() const { return aMeasureLayer; }
 
-    // If the MeasureLayer is not set (empty string), then
-    // use the active layer for measuring.
+    // If the MeasureLayer is not set (empty string), then use the active layer for measuring.
     void SetEditMode(SdrViewEditMode eMode) { SdrDragView::SetEditMode(eMode); CheckEdgeMode(); }
     void SetEditMode(sal_Bool bOn=sal_True) { SdrDragView::SetEditMode(bOn); CheckEdgeMode(); }
     void SetCreateMode(sal_Bool bOn=sal_True) { SdrDragView::SetCreateMode(bOn); CheckEdgeMode(); }
@@ -110,7 +109,7 @@ public:
     sal_uInt32 GetCurrentObjInventor() const { return nAktInvent; }
     sal_uInt16 GetCurrentObjIdentifier() const { return nAktIdent; }
 
-    // Starten des normalen Create
+    // Beginning the regular Create
     sal_Bool BegCreateObj(const Point& rPnt, OutputDevice* pOut=NULL, short nMinMov=-3, SdrPageView* pPV=NULL);
     sal_Bool BegCreatePreparedObject(const Point& rPnt, sal_Int16 nMinMov, SdrObject* pPreparedFactoryObject);
     void MovCreateObj(const Point& rPnt);
@@ -122,7 +121,7 @@ public:
 
     // BegCreateCaptionObj() creates a SdrCaptionObj (legend item).
     // rObjSiz is the initial size of the legend text frame.
-    // only the length of the tip is dragged
+    // Only the length of the tip is dragged
     sal_Bool BegCreateCaptionObj(const Point& rPnt, const Size& rObjSiz, OutputDevice* pOut=NULL, short nMinMov=-3, SdrPageView* pPV=NULL);
 
     // If TextEditAfterCreate is sal_True (the default),
@@ -132,7 +131,7 @@ public:
     sal_Bool IsTextEditAfterCreate() const { return bAutoTextEdit; }
     void SetTextEditAfterCreate(sal_Bool bOn) { bAutoTextEdit = bOn; }
 
-    // Create a circle / rectangle / text frame with the first Point being
+    // Create a circle/rectangle/text frame with the first Point being
     // the center of the object instead of the upper-left corner.
     // Persistent flag. Default = FALSE.
     sal_Bool IsCreate1stPointAsCenter() const { return b1stPointAsCenter; }
@@ -143,33 +142,34 @@ public:
     // converted to Polygon (OBJ_POLY) or freehand fill (OBJ_FREEFILL) if
     // the distance between the start point and end point of the
     // Object <= nAutoCloseDistPix pixels.
-    // Default is TRUE.
+    // Default = TRUE.
     sal_Bool IsAutoClosePolys() const { return bAutoClosePolys; }
     void SetAutoClosePolys(sal_Bool bOn) { bAutoClosePolys=bOn; }
 
-    // Default=5 Pixel.
+    // Default = 5 Pixel
     sal_uInt16 GetAutoCloseDistPix() const { return sal_uInt16(nAutoCloseDistPix); }
     void SetAutoCloseDistPix(sal_uInt16 nVal) { nAutoCloseDistPix=nVal; }
 
-    // Vorgabe des minimalen Pixelabstands zwischen 2 Bezierpunkten bei der
-    // Erzeugung einer Freihandlinie.
-    // Default=10 Pixel.
+    // Setting for the minimum distantce in pixels between 2 bezier points when
+    // creating a freehand line.
+    // Default = 10 Pixel
     sal_uInt16 GetFreeHandMinDistPix() const { return sal_uInt16(nFreeHandMinDistPix); }
     void SetFreeHandMinDistPix(sal_uInt16 nVal) { nFreeHandMinDistPix=nVal; }
 
-    // Wer das (zur restlichen Create-Funktionalitaet von SvDraw) inkompatible
-    // Create-Interface am PathObj beibehalten moechte muss das nachfolgende
-    // Flag setzen. Dieses wirkt sich aus bei den Objekttypen:
+    // FIXME: Whoever wants to keep the Create Interface for the PathObj which is
+    // incompatible with the rest of the Create functionality of SvDraw, needs
+    // to set the following flag. It affects the following object types:
     // OBJ_POLY, OBJ_PLIN, OBJ_PATHLINE, OBJ_PATHFILL
-    // Dieses Flag hat nur voruebergehenden Character. Die betroffenen
-    // Applikationen sollten alsbald umgestellt werden.
-    // Default=sal_False;
+    //
+    // This flag should be regarded as temporary. The affected applications should
+    // be changed soon.
+    // Default = sal_False;
     sal_Bool IsUseIncompatiblePathCreateInterface() const { return bUseIncompatiblePathCreateInterface; }
     void SetUseIncompatiblePathCreateInterface(sal_Bool bOn) { bUseIncompatiblePathCreateInterface = bOn; }
     void SetConnectMarker(const SdrObjConnection& rCon, const SdrPageView& rPV);
     void HideConnectMarker();
 
-    // Attribute des ggf. gerade in der Erzeugung befindlichen Objekts
+    // Attributes of the object that is in the process of being created
     /* new interface src537 */
     sal_Bool GetAttributes(SfxItemSet& rTargetSet, sal_Bool bOnlyHardAttr=sal_False) const;
 

include/svx/sxcgitm.hxx

@@ -22,10 +22,10 @@
 #include <svx/svddef.hxx>
 #include <svx/sdmetitm.hxx>
 
-//------------------------------------
-// class SdrCaptionGapItem
-// Abstand des Linienanfangs vom Rect
-//------------------------------------
+/**
+ * class SdrCaptionGapItem
+ * Distance of the line start from the Rect
+ */
 class SdrCaptionGapItem: public SdrMetricItem {
 public:
     SdrCaptionGapItem(long nGap=0)  : SdrMetricItem(SDRATTR_CAPTIONGAP,nGap) {}

include/svx/sxmfsitm.hxx

@@ -22,8 +22,8 @@
 #include <svx/svddef.hxx>
 #include <svl/stritem.hxx>
 
-// Formatstring (aehnl. Calc), z.B. "#.###,00km"
-// ueberschreibt SdrMeasureUnitItem und SdrMeasureShowUnitItem (n.i.)
+// Format string (similar to Calc), e.g. "#.###,00km"
+// overwrites SdrMeasureUnitItem and SdrMeasureShowUnitItem
 class SdrMeasureFormatStringItem: public SfxStringItem {
 public:
     SdrMeasureFormatStringItem()                   : SfxStringItem() { SetWhich(SDRATTR_MEASUREFORMATSTRING); }

include/svx/sxmoitm.hxx

@@ -22,8 +22,8 @@
 #include <svx/svddef.hxx>
 #include <svx/sdmetitm.hxx>
 
-// Ueberstand der Masslinie ueber die Masshilfslinien
-// Nur wenn die Masspfeile aussen sind (n.i.)
+// Overlap of the measure line over the measure helper lines
+// Only of the measure arrows are on the outside
 class SdrMeasureOverhangItem: public SdrMetricItem {
 public:
     SdrMeasureOverhangItem(long nVal=0): SdrMetricItem(SDRATTR_MEASUREOVERHANG,nVal)  {}

include/svx/sxmsitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/svddef.hxx>
 #include <svx/sxsiitm.hxx>
 
-// Massstabsvorgabe. Wenn bereits am Model ein Massstab (UIScale) gesetzt
-// ist wird dieser nicht ueberschrieben. Stattdessen werden beide Massstaebe
-// miteinander multipliziert.
+// Measure scale setting
+// We do not overwrite a measure scale (UIScale), If the model already has one set.
+// Instead, we multiply them with each other.
 class SdrMeasureScaleItem: public SdrScaleItem {
 public:
     SdrMeasureScaleItem()                   : SdrScaleItem(SDRATTR_MEASURESCALE,Fraction(1,1)) {}

include/svx/sxmsuitm.hxx

@@ -22,7 +22,7 @@
 #include <svx/svddef.hxx>
 #include <svx/sdynitm.hxx>
 
-// Die Masseinheit mit anzeigen
+// Include the unit of measure when displaying
 class SdrMeasureShowUnitItem: public SdrYesNoItem {
 public:
     SdrMeasureShowUnitItem(bool bOn=false): SdrYesNoItem(SDRATTR_MEASURESHOWUNIT,bOn) {}

include/svx/sxonitm.hxx

@@ -22,10 +22,9 @@
 #include <svx/svddef.hxx>
 #include <svl/stritem.hxx>
 
-//------------------------------
-// class SdrObjectNameItem
-//------------------------------
-
+/**
+ * class SdrObjectNameItem
+ */
 class SdrObjectNameItem: public SfxStringItem {
 public:
     SdrObjectNameItem()                   : SfxStringItem() { SetWhich(SDRATTR_OBJECTNAME); }

include/svx/sxraitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/svddef.hxx>
 #include <svx/sdangitm.hxx>
 
-//------------------------------
-// class SdrRotateAngleItem
-//------------------------------
+/**
+ * class SdrRotateAngleItem
+ */
 class SdrRotateAngleItem: public SdrAngleItem {
 public:
     SdrRotateAngleItem(long nAngle=0): SdrAngleItem(SDRATTR_ROTATEANGLE,nAngle) {}

include/svx/sxroaitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/svddef.hxx>
 #include <svx/sdangitm.hxx>
 
-//------------------------------
-// class SdrRotateAllItem
-//------------------------------
+/**
+ * class SdrRotateAllItem
+ */
 class SdrRotateAllItem: public SdrAngleItem {
 public:
     SdrRotateAllItem(long nAngle=0): SdrAngleItem(SDRATTR_ROTATEALL,nAngle) {}

include/svx/sxrooitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/svddef.hxx>
 #include <svx/sdangitm.hxx>
 
-//------------------------------
-// class SdrRotateOneItem
-//------------------------------
+/**
+ * class SdrRotateOneItem
+ */
 class SdrRotateOneItem: public SdrAngleItem {
 public:
     SdrRotateOneItem(long nAngle=0): SdrAngleItem(SDRATTR_ROTATEONE,nAngle) {}

include/svx/sxsaitm.hxx

@@ -22,9 +22,9 @@
 #include <svx/svddef.hxx>
 #include <svx/sdangitm.hxx>
 
-//------------------------------
-// class SdrShearAngleItem
-//------------------------------
+/**
+ * class SdrShearAngleItem
+ */
 class SdrShearAngleItem: public SdrAngleItem {
 public:
     SdrShearAngleItem(long nAngle=0): SdrAngleItem(SDRATTR_SHEARANGLE,nAngle) {}