fdo#39468 Comment translation GER-ENG in sw/source/core/layout

Change-Id: Ia4bdd0fe4f515ae772685b10da519c4b3cf727c8
Reviewed-on: https://gerrit.libreoffice.org/5276
Reviewed-by: Miklos Vajna <vmiklos@suse.cz>
Tested-by: Miklos Vajna <vmiklos@suse.cz>

1 files changed, 216 insertions, 265 deletions

diff --git a/sw/source/core/layout/trvlfrm.cxx b/sw/source/core/layout/trvlfrm.cxx
index e4318507167e..843f39ab1fcd 100644
--- a/sw/source/core/layout/trvlfrm.cxx
+++ b/sw/source/core/layout/trvlfrm.cxx
@@ -114,19 +114,16 @@ namespace {
 }
 
 
-//Fuer SwFlyFrm::GetCrsrOfst
+//For SwFlyFrm::GetCrsrOfst
 class SwCrsrOszControl
 {
 public:
-    // damit schon der Compiler die Klasse initialisieren kann, keinen
-    // DTOR und member als publics:
+    // So the compiler can initialize the class already. No DTOR and member
+    // as public members
     const SwFlyFrm *pEntry;
     const SwFlyFrm *pStk1;
     const SwFlyFrm *pStk2;
 
-//public:
-//    SwCrsrOszControl() : pStk1( 0 ), pStk2( 0 ) {}; // ; <- ????
-
     bool ChkOsz( const SwFlyFrm *pFly )
         {
             bool bRet = true;
@@ -156,8 +153,8 @@ static SwCrsrOszControl aOszCtrl = { 0, 0, 0 };
 |*
 |*  SwLayoutFrm::GetCrsrOfst()
 |*
-|*  Beschreibung:       Sucht denjenigen CntntFrm, innerhalb dessen
-|*                      PrtArea der Point liegt.
+|*  Description:        Searches the CntntFrm owning the PrtArea
+|*                      containing the point.
 |*
 |*************************************************************************/
 sal_Bool SwLayoutFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
@@ -190,8 +187,7 @@ sal_Bool SwLayoutFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
 |*
 |*  SwPageFrm::GetCrsrOfst()
 |*
-|*  Beschreibung:       Sucht die Seite, innerhalb der der gesuchte Point
-|*                      liegt.
+|*  Description:        Searches the page containing the searched point.
 |*
 |*************************************************************************/
 
@@ -212,9 +208,9 @@ sal_Bool SwPageFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
 
     sal_Bool bTextRet, bBackRet = sal_False;
 
-    //Koennte ein Freifliegender gemeint sein?
-    //Wenn sein Inhalt geschuetzt werden soll, so ist nix mit Crsr
-    //hineinsetzen, dadurch sollten alle Aenderungen unmoeglich sein.
+    //Could it be a free flying one?
+    //If his content should be protected, we can't set the Crsr in it, thus
+    //all changes should be impossible.
     if ( GetSortedObjs() )
     {
         bRet = lcl_GetCrsrOfst_Objects( this, false, pPos, rPoint, pCMS );
@@ -225,9 +221,9 @@ sal_Bool SwPageFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
         SwPosition aBackPos( *pPos );
         SwPosition aTextPos( *pPos );
 
-        //Wenn kein Cntnt unterhalb der Seite 'antwortet', so korrigieren
-        //wir den StartPoint und fangen nochmal eine Seite vor der
-        //aktuellen an. Mit Flys ist es dann allerdings vorbei.
+        //We fix the StartPoint if no Cntnt below the page 'answers' and then
+        //start all over again one page before the current one.
+        //However we cant use Flys in such a case.
         if ( SwLayoutFrm::GetCrsrOfst( &aTextPos, aPoint, pCMS ) )
         {
             bTextRet = sal_True;
@@ -403,9 +399,8 @@ bool SwRootFrm::FillSelection( SwSelectionList& aSelList, const SwRect& rRect) c
 |*
 |*  SwRootFrm::GetCrsrOfst()
 |*
-|*  Beschreibung:       Reicht Primaer den Aufruf an die erste Seite weiter.
-|*                      Wenn der 'reingereichte Point veraendert wird,
-|*                      so wird sal_False zurueckgegeben.
+|*  Description:        Primary passes the call to the first page.
+|*                      If the passed Point gets changed we return sal_False.
 |*
 |*************************************************************************/
 sal_Bool SwRootFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
@@ -413,7 +408,7 @@ sal_Bool SwRootFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
 {
     sal_Bool bOldAction = IsCallbackActionEnabled();
     ((SwRootFrm*)this)->SetCallbackActionEnabled( sal_False );
-    OSL_ENSURE( (Lower() && Lower()->IsPageFrm()), "Keinen PageFrm gefunden." );
+    OSL_ENSURE( (Lower() && Lower()->IsPageFrm()), "No PageFrm found." );
     if( pCMS && pCMS->pFill )
         ((SwCrsrMoveState*)pCMS)->bFillRet = sal_False;
     Point aOldPoint = rPoint;
@@ -453,10 +448,10 @@ sal_Bool SwRootFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
 |*
 |*  SwCellFrm::GetCrsrOfst()
 |*
-|*  Beschreibung        Wenn es sich um eine Cntnt-tragende Cell handelt wird
-|*                      der Crsr notfalls mit Gewalt in einen der CntntFrms
-|*                      gesetzt.
-|*                      In geschuetzte Zellen gibt es hier keinen Eingang.
+|*  Description:        If this is about a Cntnt-carrying cell the Crsr will
+|*                      be force inserted into one of the CntntFrms if there are
+|*                      no other options.
+|*                      There is no entry for protected cells.
 |*
 |*************************************************************************/
 sal_Bool SwCellFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
@@ -526,32 +521,28 @@ sal_Bool SwCellFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
 |*  SwFlyFrm::GetCrsrOfst()
 |*
 |*************************************************************************/
-//Problem: Wenn zwei Flys genau gleich gross sind und auf derselben
-//Position stehen, so liegt jeder innerhalb des anderen.
-//Da jeweils geprueft wird, ob der Point nicht zufaellig innerhalb eines
-//anderen Flys liegt, der sich vollstaendig innerhalb des aktuellen befindet
-//und ggf. ein rekursiver Aufruf erfolgt wuerde o.g. Situation zu einer
-//endlosen Rekursion fuehren.
-//Mit der Hilfsklasse SwCrsrOszControl unterbinden wir die Rekursion. Das
-//GetCrsrOfst entscheidet sich bei einer Rekursion fuer denjenigen der
-//am weitesten oben liegt.
+//Problem: If two Flys have the same size and share the same position then
+//they end inside each other.
+//Because we recursively check if a Point doesn't randomly lie inside an other
+//fly which lies completely inside the current Fly we could trigger an endless
+//loop with the mentioned situation above.
+//Using the helper class SwCrsrOszControl we prevent the recursion. During
+// a recursion GetCrsrOfst picks the one which lies on top.
 
 sal_Bool SwFlyFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
                             SwCrsrMoveState* pCMS, bool ) const
 {
     aOszCtrl.Entry( this );
 
-    //Wenn der Point innerhalb des Fly sitzt wollen wir energisch
-    //versuchen den Crsr hineinzusetzen.
-    //Wenn der Point allerdings in einem Flys sitzt, der sich vollstaendig
-    //innerhalb des aktuellen befindet, so wird fuer diesen das
-    //GetCrsrOfst gerufen.
+    //If the Points lies inside the Fly, we try hard to set the Crsr inside it.
+    //However if the Point sits inside a Fly which is completely located inside
+    //the current one, we call GetCrsrOfst for it.
     Calc();
     sal_Bool bInside = Frm().IsInside( rPoint ) && Lower(),
          bRet = sal_False;
 
-    //Wenn der Frm eine Grafik enthaelt, aber nur Text gewuenscht ist, so
-    //nimmt er den Crsr grundsaetzlich nicht an.
+    //If an Frm contains a graphic, but only text was requested, it basically
+    //won't accept the Crsr.
     if ( bInside && pCMS && pCMS->eState == MV_SETONLYTEXT &&
          (!Lower() || Lower()->IsNoTxtFrm()) )
         bInside = sal_False;
@@ -616,7 +607,7 @@ sal_Bool SwFlyFrm::GetCrsrOfst( SwPosition *pPos, Point &rPoint,
 
 /*************************************************************************
 |*
-|*    Beschreibung      Layoutabhaengiges Cursortravelling
+|*    Description:      Layout dependent cursor travelling
 |*
 |*************************************************************************/
 sal_Bool SwCntntFrm::LeftMargin(SwPaM *pPam) const
@@ -649,7 +640,7 @@ static const SwCntntFrm *lcl_GetPrvCnt( const SwCntntFrm* pCnt )
 
 typedef const SwCntntFrm *(*GetNxtPrvCnt)( const SwCntntFrm* );
 
-//Frame in wiederholter Headline?
+//Frame in repeated headline?
 static bool lcl_IsInRepeatedHeadline( const SwFrm *pFrm,
                                     const SwTabFrm** ppTFrm = 0 )
 {
@@ -660,10 +651,9 @@ static bool lcl_IsInRepeatedHeadline( const SwFrm *pFrm,
 }
 
 
-//Ueberspringen geschuetzter Tabellenzellen. Optional auch
-//Ueberspringen von wiederholten Headlines.
-//MA 26. Jan. 98: Chg auch andere Geschuetzte Bereiche ueberspringen.
-// FME: Skip follow flow cells
+//Skip protected table cells. Optionally also skip repeated headlines.
+//MA 1998-01-26: Chg also skip other protected areas
+//FME: Skip follow flow cells
 static const SwCntntFrm * lcl_MissProtectedFrames( const SwCntntFrm *pCnt,
                                                        GetNxtPrvCnt fnNxtPrv,
                                                        sal_Bool bMissHeadline,
@@ -699,13 +689,14 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
                     GetNxtPrvCnt fnNxtPrv, sal_Bool bInReadOnly )
 {
     OSL_ENSURE( pPam->GetNode() == (SwCntntNode*)pStart->GetNode(),
-            "lcl_UpDown arbeitet nicht fuer andere." );
+            "lcl_UpDown doesn't work for others." );
 
     const SwCntntFrm *pCnt = 0;
 
-    //Wenn gerade eine Tabellenselection laeuft muss ein bischen getricktst
-    //werden: Beim hochlaufen an den Anfang der Zelle gehen, beim runterlaufen
-    //an das Ende der Zelle gehen.
+
+    //We have to cheat a little bit during a table selection: Go to the
+    //beginning of the cell while going up and go to the end of the cell while
+    //going down.
     sal_Bool bTblSel = false;
     if ( pStart->IsInTab() &&
         pPam->GetNode( sal_True )->StartOfSectionNode() !=
@@ -716,9 +707,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
         while ( !pCell->IsCellFrm() )
             pCell = pCell->GetUpper();
 
-        //
         // Check, if cell has a Prev/Follow cell:
-        //
         const bool bFwd = ( fnNxtPrv == lcl_GetNxtCnt );
         const SwLayoutFrm* pTmpCell = bFwd ?
             ((SwCellFrm*)pCell)->GetFollowCell() :
@@ -758,9 +747,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
     SwTwips nX = 0;
     if ( bTab )
     {
-        //
         // pStart or pCnt is inside a table. nX will be used for travelling:
-        //
         SwRect aRect( pStart->Frm() );
         pStart->GetCharRect( aRect, *pPam->GetPoint() );
         Point aCenter = aRect.Center();
@@ -781,9 +768,9 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
             nX =  (pCell->Frm().*fnRect->fnGetLeft)() +
                   (pCell->Frm().*fnRect->fnGetWidth)() / 2;
 
-            //Der Fluss fuehrt von einer Tabelle in die nachste. Der X-Wert
-            //muss ausgehend von der Mitte der Startzelle um die Verschiebung
-            //der Tabellen korrigiert werden.
+            //The flow leads from one table to the next. The X-value needs to be
+            //corrected based on the middle of the starting cell by the amount
+            //of the offset of the tables.
             if ( pStTab != pTable )
             {
                 nX += (pTable->Frm().*fnRect->fnGetLeft)() -
@@ -791,10 +778,8 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
             }
         }
 
-        //
         // Restrict nX to the left and right borders of pTab:
         // (is this really necessary?)
-        //
         if ( !pTable->GetUpper()->IsInTab() )
         {
             const sal_Bool bRTL = pTable->IsRightToLeft();
@@ -816,7 +801,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
 
     do
     {
-        //Wenn ich im DokumentBody bin, so will ich da auch bleiben
+        //If I'm in the DocumentBody, I wan't to stay there.
         if ( pStart->IsInDocBody() )
         {
             while ( pCnt && (!pCnt->IsInDocBody() ||
@@ -827,8 +812,8 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
             }
         }
 
-        //Wenn ich im Fussnotenbereich bin, so versuche ich notfalls den naechsten
-        //Fussnotenbereich zu erreichen.
+        //If I'm in the FootNoteArea, I try to reach the next FootNoteArea in
+        //case of necessity.
         else if ( pStart->IsInFtn() )
         {
             while ( pCnt && (!pCnt->IsInFtn() ||
@@ -839,8 +824,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
             }
         }
 
-        //In Flys kann es Blind weitergehen solange ein Cntnt
-        //gefunden wird.
+        //In Flys we can go ahead blindly as long as we find a Cntnt.
         else if ( pStart->IsInFly() )
         {
             if ( pCnt && pCnt->IsTxtFrm() && ((SwTxtFrm*)pCnt)->IsHiddenNow() )
@@ -850,8 +834,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
             }
         }
 
-        //Andernfalls weigere ich mich einfach den derzeitigen Bereich zu
-        //verlassen.
+        //Otherwise I'll just refuse to leave to current area.
         else if ( pCnt )
         {
             const SwFrm *pUp = pStart->GetUpper();               //Head/Foot
@@ -886,9 +869,9 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
                 {
                     if ( pTab != pTable )
                     {
-                        //Der Fluss fuehrt von einer Tabelle in die nachste. Der
-                        //X-Wert muss um die Verschiebung der Tabellen korrigiert
-                        //werden.
+                        //The flow leads from one table to the next. The X-value
+                        //needs to be corrected by the amount of the offset of
+                        //the tables
                          if ( pTable &&
                               !pTab->GetUpper()->IsInTab() &&
                             !pTable->GetUpper()->IsInTab() )
@@ -929,8 +912,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
                     if ( pCell && pCell->Frm().IsInside( aInsideCell ) )
                     {
                         bEnd = sal_True;
-                        //Jetzt noch schnell den richtigen Cntnt in der Zelle
-                        //greifen.
+                        //Get the right Cntnt out of the cell.
                         if ( !pCnt->Frm().IsInside( aInsideCnt ) )
                         {
                             pCnt = pCell->ContainsCntnt();
@@ -954,7 +936,7 @@ static sal_Bool lcl_UpDown( SwPaM *pPam, const SwCntntFrm *pStart,
               (pCnt && pCnt->IsTxtFrm() && ((SwTxtFrm*)pCnt)->IsHiddenNow()));
 
     if( pCnt )
-    {   // setze den Point auf den Content-Node
+    {   // set the Point on the Content-Node
         SwCntntNode *pCNd = (SwCntntNode*)pCnt->GetNode();
         pPam->GetPoint()->nNode = *pCNd;
         if ( fnNxtPrv == lcl_GetPrvCnt )
@@ -980,12 +962,10 @@ sal_Bool SwCntntFrm::UnitDown( SwPaM* pPam, const SwTwips, sal_Bool bInReadOnly
 |*
 |*  SwRootFrm::GetCurrPage()
 |*
-|*  Beschreibung:       Liefert die Nummer der aktuellen Seite.
-|*          Wenn die Methode einen PaM bekommt, so ist die aktuelle Seite
-|*          diejenige in der der PaM sitzt. Anderfalls ist die aktuelle
-|*          Seite die erste Seite innerhalb der VisibleArea.
-|*          Es wird nur auf den vorhandenen Seiten gearbeitet!
-|*
+|* Description:         Returns the number of the current page.
+|*          If the method gets a PaM then the current page is the one in which
+|*          the PaM sits. Otherwise the current page is the first one inside the
+|*          VisibleArea. We only work on available pages!
 |*************************************************************************/
 sal_uInt16 SwRootFrm::GetCurrPage( const SwPaM *pActualCrsr ) const
 {
@@ -1001,17 +981,15 @@ sal_uInt16 SwRootFrm::GetCurrPage( const SwPaM *pActualCrsr ) const
 |*
 |*  SwRootFrm::SetCurrPage()
 |*
-|*  Beschreibung:       Liefert einen PaM der am Anfang der gewuenschten
-|*          Seite sitzt.
-|*          Formatiert wird soweit notwendig
-|*          Liefert Null, wenn die Operation nicht moeglich ist.
-|*          Der PaM sitzt in der letzten Seite, wenn die Seitenzahl zu gross
-|*          gewaehlt wurde.
-|*
+|*  Description:        Returns a PaM which sits at the beginning of the
+|*          requested page.
+|*          Formatting is done as far as necessary.
+|*          Returns Null if the operation was not possible.
+|*          The PaM sits on the last page, if the page number was chosen to big.
 |*************************************************************************/
 sal_uInt16 SwRootFrm::SetCurrPage( SwCursor* pToSet, sal_uInt16 nPageNum )
 {
-    OSL_ENSURE( Lower() && Lower()->IsPageFrm(), "Keine Seite vorhanden." );
+    OSL_ENSURE( Lower() && Lower()->IsPageFrm(), "No page available." );
 
     SwPageFrm *pPage = (SwPageFrm*)Lower();
     sal_Bool bEnd =sal_False;
@@ -1019,27 +997,24 @@ sal_uInt16 SwRootFrm::SetCurrPage( SwCursor* pToSet, sal_uInt16 nPageNum )
     {   if ( pPage->GetNext() )
             pPage = (SwPageFrm*)pPage->GetNext();
         else
-        {   //Ersten CntntFrm Suchen, und solange Formatieren bis
-            //eine neue Seite angefangen wird oder bis die CntntFrm's alle
-            //sind.
+        {   //Search the first CntntFrm and format until a new page is started
+            //or until the CntntFrm are all done.
             const SwCntntFrm *pCntnt = pPage->ContainsCntnt();
             while ( pCntnt && pPage->IsAnLower( pCntnt ) )
             {
                 pCntnt->Calc();
                 pCntnt = pCntnt->GetNextCntntFrm();
             }
-            //Jetzt ist entweder eine neue Seite da, oder die letzte Seite
-            //ist gefunden.
+            //Either this is a new page or we found the last page.
             if ( pPage->GetNext() )
                 pPage = (SwPageFrm*)pPage->GetNext();
             else
                 bEnd = sal_True;
         }
     }
-    //pPage zeigt jetzt auf die 'gewuenschte' Seite. Jetzt muss noch der
-    //PaM auf den Anfang des ersten CntntFrm im Body-Text erzeugt werden.
-    //Wenn es sich um eine Fussnotenseite handelt, wird der PaM in die erste
-    //Fussnote gesetzt.
+    //pPage now points to the 'requested' page. Now we have to create the PaM
+    //on the beginning of the first CntntFrm in the body-text.
+    //If this is a footnote-page, the PaM will be set in the first footnote.
     const SwCntntFrm *pCntnt = pPage->ContainsCntnt();
     if ( pPage->IsFtnPage() )
         while ( pCntnt && !pCntnt->IsInFtn() )
@@ -1070,14 +1045,12 @@ sal_uInt16 SwRootFrm::SetCurrPage( SwCursor* pToSet, sal_uInt16 nPageNum )
 |*
 |*    SwCntntFrm::StartxxPage(), EndxxPage()
 |*
-|*    Beschreibung      Cursor an Anfang/Ende der aktuellen/vorherigen/
-|*      naechsten Seite. Alle sechs Methoden rufen GetFrmInPage() mit der
-|*      entsprechenden Parametrisierung.
-|*      Zwei Parameter steuern die Richtung: einer bestimmt die Seite, der
-|*      andere Anfang/Ende.
-|*      Fuer die Bestimmung der Seite und des Cntnt (Anfang/Ende) werden
-|*      die im folgenden definierten Funktionen benutzt.
-|*
+|*    Description:      Cursor at the beginning/end of the current/previous/next
+|*       page. All six methods call GetFrmInPage() using the according
+|*       parameters. Two parameters define the direction: one defines the
+|*       page, the other one the beginning/end.
+|*       For the determination of the page and the Cntnt (begin/end) the
+|*       following functions are going to be used.
 |*************************************************************************/
 SwCntntFrm *GetFirstSub( const SwLayoutFrm *pLayout )
 {
@@ -1118,28 +1091,26 @@ SwLayoutFrm *GetPrevFrm( const SwLayoutFrm *pFrm )
     return pPrev;
 }
 
-//Jetzt koennen auch die Funktionspointer initalisiert werden;
-//sie sind in cshtyp.hxx declariert.
+//Now we can also initialize de function pointers;
+//they are declared in cshtyp.hxx
 SwPosPage fnPageStart = GetFirstSub;
 SwPosPage fnPageEnd = GetLastSub;
 SwWhichPage fnPagePrev = GetPrevFrm;
 SwWhichPage fnPageCurr = GetThisFrm;
 SwWhichPage fnPageNext = GetNextFrm;
 
-//Liefert den ersten/den letzten Contentframe (gesteuert ueber
-//den Parameter fnPosPage) in der
-//aktuellen/vorhergehenden/folgenden Seite (gesteuert durch den
-//Parameter fnWhichPage).
+//Returns the first/last Contentframe (controlled using the parameter fnPosPage)
+//of the current/previous/next page (controlled using the parameter fnWhichPage).
 sal_Bool GetFrmInPage( const SwCntntFrm *pCnt, SwWhichPage fnWhichPage,
                    SwPosPage fnPosPage, SwPaM *pPam )
 {
-    //Erstmal die gewuenschte Seite besorgen, anfangs die aktuelle, dann
-    //die die per fnWichPage gewuenscht wurde
+    //First find the requested page, at first the current, then the one which
+    //was requests through fnWichPage.
     const SwLayoutFrm *pLayoutFrm = pCnt->FindPageFrm();
     if ( !pLayoutFrm || (0 == (pLayoutFrm = (*fnWhichPage)(pLayoutFrm))) )
         return sal_False;
 
-    //Jetzt den gewuenschen CntntFrm unterhalb der Seite
+    //Now the desired CntntFrm below the page
     if( 0 == (pCnt = (*fnPosPage)(pLayoutFrm)) )
         return sal_False;
     else
@@ -1184,19 +1155,16 @@ sal_Bool GetFrmInPage( const SwCntntFrm *pCnt, SwWhichPage fnWhichPage,
 |*
 |*  SwLayoutFrm::GetCntntPos()
 |*
-|*  Beschreibung        Es wird der nachstliegende Cntnt zum uebergebenen
-|*                      gesucht. Betrachtet werden die vorhergehende, die
-|*                      aktuelle und die folgende Seite.
-|*                      Wenn kein Inhalt gefunden wird, so wird der Bereich
- *                      erweitert bis einer gefunden wird.
-|*                      Zurueckgegeben wird die 'Semantisch richtige' Position
-|*                      innerhalb der PrtArea des gefundenen CntntFrm
-|*
+|*  Description         The nearest Cntnt to pass will be searched. Considered
+|*                      are the previous, the current and the next page.
+|*                      If no content is found, the area gets expanded until one
+|*                      is found. The 'semantically correct' position inside
+|*                      the PrtArea of the found CntntFrm will be returned.
 |*************************************************************************/
 sal_uLong CalcDiff( const Point &rPt1, const Point &rPt2 )
 {
-    //Jetzt die Entfernung zwischen den beiden Punkten berechnen.
-    //'Delta' X^2 + 'Delta'Y^2 = 'Entfernung'^2
+    //Calculate the distance between the two points.
+    //'delta' X^2 + 'delta'Y^2 = 'distance'^2
     sal_uInt32 dX = std::max( rPt1.X(), rPt2.X() ) -
                std::min( rPt1.X(), rPt2.X() ),
           dY = std::max( rPt1.Y(), rPt2.Y() ) -
@@ -1206,12 +1174,12 @@ sal_uLong CalcDiff( const Point &rPt1, const Point &rPt2 )
     return ::SqRt( dX1 + dY1 );
 }
 
-// lcl_Inside ueberprueft, ob der Punkt innerhalb des Seitenteils liegt, in dem
-// auch der CntntFrame liegt. Als Seitenteile gelten in diesem Zusammenhang
-// Kopfzeile, Seitenbody, Fusszeile und FussnotenContainer.
-// Dies dient dazu, dass ein CntntFrm, der im "richtigen" Seitenteil liegt,
-// eher akzeptiert wird als ein anderer, der nicht dort liegt, auch wenn
-// dessen Abstand zum Punkt geringer ist.
+// lcl_Inside checks if the point lies inside the page part in wich also the
+// CntntFrame lies. In this context header, page body, footer and footnote-
+// container count as page part.
+// This will suit the purpose that the CntntFrm which lies in the "right" page
+// part will be accepted instead of one which doesn't lie there although his
+// distance to the point is shorter.
 
 static const SwLayoutFrm* lcl_Inside( const SwCntntFrm *pCnt, Point& rPt )
 {
@@ -1238,7 +1206,7 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
                                             const SwCrsrMoveState *pCMS,
                                             const sal_Bool bDefaultExpand ) const
 {
-    //Ersten CntntFrm ermitteln.
+    //Determine the first CntntFrm.
     const SwLayoutFrm *pStart = (!bDontLeave && bDefaultExpand && GetPrev()) ?
                                     (SwLayoutFrm*)GetPrev() : this;
     const SwCntntFrm *pCntnt = pStart->ContainsCntnt();
@@ -1256,7 +1224,7 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
     Point aPoint = rPoint;
     sal_uLong nDistance = ULONG_MAX;
 
-    while ( true )  //Sicherheitsschleifchen, damit immer einer gefunden wird.
+    while ( true )  //A loop to be sure we always find one.
     {
         while ( pCntnt &&
                 ((!bDontLeave || IsAnLower( pCntnt )) &&
@@ -1265,8 +1233,8 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
             if ( ( bCalc || pCntnt->Frm().Width() ) &&
                  ( !bBodyOnly || pCntnt->IsInDocBody() ) )
             {
-                //Wenn der Cntnt in einem geschuetzen Bereich (Zelle, Ftn, Section)
-                //liegt, wird der nachste Cntnt der nicht geschuetzt ist gesucht.
+                //If the Cntnt lies in a protected area (cell, Ftn, section),
+                //we search the next Cntnt which is not protected.
                 const SwCntntFrm *pComp = pCntnt;
                 pCntnt = ::lcl_MissProtectedFrames( pCntnt, lcl_GetNxtCnt, sal_False,
                                         pCMS ? pCMS->bSetInReadOnly : sal_False, sal_False );
@@ -1285,34 +1253,34 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
                         aPoint = rPoint;
                         break;
                     }
-                    //Die Strecke von rPoint zum dichtesten Punkt von pCntnt wird
-                    //jetzt berechnet.
+                    //The distance from rPoint to the nearest Point of pCntnt
+                    //will now be calculated.
                     Point aCntntPoint( rPoint );
 
-                    //Erst die Vertikale Position einstellen
+                    //First set the vertical position
                     if ( aCntFrm.Top() > aCntntPoint.Y() )
                         aCntntPoint.Y() = aCntFrm.Top();
                     else if ( aCntFrm.Bottom() < aCntntPoint.Y() )
                         aCntntPoint.Y() = aCntFrm.Bottom();
 
-                    //Jetzt die Horizontale Position
+                    //Now the horizontal position
                     if ( aCntFrm.Left() > aCntntPoint.X() )
                         aCntntPoint.X() = aCntFrm.Left();
                     else if ( aCntFrm.Right() < aCntntPoint.X() )
                         aCntntPoint.X() = aCntFrm.Right();
 
-                    // pInside ist ein Seitenbereich, in dem der Punkt liegt,
-                    // sobald pInside!=0 ist, werden nur noch Frames akzeptiert,
-                    // die innerhalb liegen.
+                    // pInside is a page area in which the point lies. As soon
+                    // as pInside != 0 only frames are accepted which are
+                    // placed inside.
                     if( !pInside || ( pInside->IsAnLower( pCntnt ) &&
                         ( !pCntnt->IsInFtn() || pInside->IsFtnContFrm() ) ) )
                     {
                         const sal_uLong nDiff = ::CalcDiff( aCntntPoint, rPoint );
-                        sal_Bool bBetter = nDiff < nDistance;  // Dichter dran
+                        sal_Bool bBetter = nDiff < nDistance;  // This one is nearer
                         if( !pInside )
                         {
                             pInside = lcl_Inside( pCntnt, rPoint );
-                            if( pInside )  // Im "richtigen" Seitenteil
+                            if( pInside )  // In the "right" page area
                                 bBetter = sal_True;
                         }
                         if( bBetter )
@@ -1330,11 +1298,10 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
                     pCntnt = pCntnt->GetNextCntntFrm();
         }
         if ( !pActual )
-        {   //Wenn noch keiner gefunden wurde muss der Suchbereich erweitert
-            //werden, irgenwann muessen wir einen Finden!
-            //MA 09. Jan. 97: Opt fuer viele leere Seiten, wenn wir nur im
-            //Body suchen, koennen wir den Suchbereich gleich in einem
-            //Schritt hinreichend erweitern.
+        {   //If we not yet found one we have to expand the searched
+            //area, sometime we will find one!
+            //MA 1997-01-09: Opt for many empty pages - if we only search inside
+            //the body, we can expand the searched area sufficiently in one step.
             if ( bBodyOnly )
             {
                 while ( !pCntnt && pStart->GetPrev() )
@@ -1347,13 +1314,13 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
                                 ? pStart->ContainsCntnt()
                                 : pStart->FindPageFrm()->FindFirstBodyCntnt();
                 }
-                if ( !pCntnt )  //irgendwann muessen wir mit irgendeinem Anfangen!
+                if ( !pCntnt )  // Somewhere down the road we have to start with one!
                 {
                     pCntnt = pStart->FindPageFrm()->GetUpper()->ContainsCntnt();
                     while ( pCntnt && !pCntnt->IsInDocBody() )
                         pCntnt = pCntnt->GetNextCntntFrm();
                     if ( !pCntnt )
-                        return 0;   //Es gibt noch keine Dokumentinhalt!
+                        return 0;   // There is no document content yet!
                 }
             }
             else
@@ -1366,7 +1333,7 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
                     pStart = (SwLayoutFrm*)pStart->GetPrev();
                     pCntnt = pStart->ContainsCntnt();
                 }
-                else //irgendwann muessen wir mit irgendeinem Anfangen!
+                else // Somewhere down the road we have to start with one!
                     pCntnt = pStart->FindPageFrm()->GetUpper()->ContainsCntnt();
             }
             pActual = pCntnt;
@@ -1378,8 +1345,7 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
     OSL_ENSURE( pActual, "no Cntnt found." );
     OSL_ENSURE( !bBodyOnly || pActual->IsInDocBody(), "Cntnt not in Body." );
 
-    //Spezialfall fuer das selektieren von Tabellen, nicht in wiederholte
-    //TblHedlines.
+    //Special case for selecting tables not in repeated TblHeadlines.
     if ( pActual->IsInTab() && pCMS && pCMS->eState == MV_TBLSEL )
     {
         const SwTabFrm *pTab = pActual->FindTabFrm();
@@ -1390,7 +1356,7 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
         }
     }
 
-    //Jetzt noch eine kleine Korrektur beim ersten/letzten
+    //A small correction at the first/last
     Size aActualSize( pActual->Prt().SSize() );
     if ( aActualSize.Height() > pActual->GetUpper()->Prt().Height() )
         aActualSize.Height() = pActual->GetUpper()->Prt().Height();
@@ -1417,7 +1383,7 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
                           pActual->Prt().Right() );
     }
 
-    //Und den Point in die PrtArea bringen
+    //Bring the Point in to the PrtArea
     if ( bCalc )
         pActual->Calc();
     const SwRect aRect( pActual->Frm().Pos() + pActual->Prt().Pos(),
@@ -1438,17 +1404,17 @@ const SwCntntFrm *SwLayoutFrm::GetCntntPos( Point& rPoint,
 |*
 |*  SwPageFrm::GetCntntPosition()
 |*
-|*  Beschreibung        Analog zu SwLayoutFrm::GetCntntPos().
-|*                      Spezialisiert fuer Felder in Rahmen.
+|*  Description:        Same as SwLayoutFrm::GetCntntPos().
+|*                      Specialized for fields and border.
 |*
 |*************************************************************************/
 void SwPageFrm::GetCntntPosition( const Point &rPt, SwPosition &rPos ) const
 {
-    //Ersten CntntFrm ermitteln.
+    //Determine the first CntntFrm.
     const SwCntntFrm *pCntnt = ContainsCntnt();
     if ( pCntnt )
     {
-        //Einen weiter zurueck schauen (falls moeglich).
+        //Look back one more (if possible).
         const SwCntntFrm *pTmp = pCntnt->GetPrevCntntFrm();
         while ( pTmp && !pTmp->IsInDocBody() )
             pTmp = pTmp->GetPrevCntntFrm();
@@ -1467,21 +1433,21 @@ void SwPageFrm::GetCntntPosition( const Point &rPt, SwPosition &rPos ) const
         SwRect aCntFrm( pCntnt->UnionFrm() );
         if ( aCntFrm.IsInside( rPt ) )
         {
-            //dichter gehts nimmer.
+            //This is the nearest one.
             pAct = pCntnt;
             break;
         }
 
-        //Die Strecke von rPt zum dichtesten Punkt von pCntnt berechnen.
+        //Calculate the distance from rPt to the nearest point of pCntnt.
         Point aPoint( rPt );
 
-        //Erst die vertikale Position einstellen
+        //Calculate the vertical position first
         if ( aCntFrm.Top() > rPt.Y() )
             aPoint.Y() = aCntFrm.Top();
         else if ( aCntFrm.Bottom() < rPt.Y() )
             aPoint.Y() = aCntFrm.Bottom();
 
-        //Jetzt die horizontale Position
+        //And now the horizontal position
         if ( aCntFrm.Left() > rPt.X() )
             aPoint.X() = aCntFrm.Left();
         else if ( aCntFrm.Right() < rPt.X() )
@@ -1495,7 +1461,7 @@ void SwPageFrm::GetCntntPosition( const Point &rPt, SwPosition &rPos ) const
             pAct    = pCntnt;
         }
         else if ( aCntFrm.Top() > Frm().Bottom() )
-            //Dichter wirds im Sinne der Felder nicht mehr!
+            //In terms of fields, it's not possible to be closer any more!
             break;
 
         pCntnt = pCntnt->GetNextCntntFrm();
@@ -1503,7 +1469,7 @@ void SwPageFrm::GetCntntPosition( const Point &rPt, SwPosition &rPos ) const
             pCntnt = pCntnt->GetNextCntntFrm();
     }
 
-    //Und den Point in die PrtArea bringen
+    //Bring the point into the PrtArea.
     const SwRect aRect( pAct->Frm().Pos() + pAct->Prt().Pos(), pAct->Prt().SSize() );
     if ( aAct.Y() < aRect.Top() )
         aAct.Y() = aRect.Top();
@@ -1516,9 +1482,9 @@ void SwPageFrm::GetCntntPosition( const Point &rPt, SwPosition &rPos ) const
 
     if( !pAct->IsValid() )
     {
-        // CntntFrm nicht formatiert -> immer auf Node-Anfang
+        // CntntFrm not formated -> always on node-beginning
         SwCntntNode* pCNd = (SwCntntNode*)pAct->GetNode();
-        OSL_ENSURE( pCNd, "Wo ist mein CntntNode?" );
+        OSL_ENSURE( pCNd, "Where is my CntntNode?" );
         rPos.nNode = *pCNd;
         rPos.nContent.Assign( pCNd, 0 );
     }
@@ -1533,8 +1499,8 @@ void SwPageFrm::GetCntntPosition( const Point &rPt, SwPosition &rPos ) const
 |*
 |*  SwRootFrm::GetNextPrevCntntPos()
 |*
-|*  Beschreibung        Es wird der naechstliegende Cntnt zum uebergebenen
-|*                      Point gesucht. Es wird nur im BodyText gesucht.
+|* Description:         Search the nearest Cntnt to the passed point. Only
+|*                      search inside the BodyText.
 |*
 |*************************************************************************/
 
@@ -1560,7 +1526,7 @@ class DisableCallbackAction
         }
 };
 
-//!!!!! Es wird nur der vertikal naechstliegende gesucht.
+//!!!!! Only the nearest vertically one will be searched.
 //JP 11.10.2001: only in tables we try to find the right column - Bug 72294
 Point SwRootFrm::GetNextPrevCntntPos( const Point& rPoint, sal_Bool bNext ) const
 {
@@ -1568,9 +1534,9 @@ Point SwRootFrm::GetNextPrevCntntPos( const Point& rPoint, sal_Bool bNext ) cons
     // event during processing of this method. Needed because formatting is
     // triggered by this method.
     DisableCallbackAction aDisableCallbackAction( *this );
-    //Ersten CntntFrm und seinen Nachfolger im Body-Bereich suchen
-    //Damit wir uns nicht tot suchen (und vor allem nicht zuviel formatieren)
-    //gehen wir schon mal von der richtigen Seite aus.
+    //Search the first CntntFrm and his successor in the body area.
+    //To be efficient (and not formatting too much) we'll start at the correct
+    //page.
     SwLayoutFrm *pPage = (SwLayoutFrm*)Lower();
     if( pPage )
         while( pPage->GetNext() && pPage->Frm().Bottom() < rPoint.Y() )
@@ -1586,8 +1552,8 @@ Point SwRootFrm::GetNextPrevCntntPos( const Point& rPoint, sal_Bool bNext ) cons
     pCnt->Calc();
     if( !bNext )
     {
-        // Solange der Point vor dem ersten CntntFrm liegt und es noch
-        // vorhergehende Seiten gibt gehe ich jeweils eine Seite nach vorn.
+        // As long as the point lies before the first CntntFrm and there are
+        // still precedent pages I'll go to the next page.
         while ( rPoint.Y() < pCnt->Frm().Top() && pPage->GetPrev() )
         {
             pPage = (SwLayoutFrm*)pPage->GetPrev();
@@ -1604,30 +1570,30 @@ Point SwRootFrm::GetNextPrevCntntPos( const Point& rPoint, sal_Bool bNext ) cons
         }
     }
 
-    //Liegt der Point ueber dem ersten CntntFrm?
+    //Does the point lie above the first CntntFrm?
     if ( rPoint.Y() < pCnt->Frm().Top() && !lcl_IsInRepeatedHeadline( pCnt ) )
         return pCnt->UnionFrm().Pos();
 
     while ( pCnt )
     {
-        //Liegt der Point im aktuellen CntntFrm?
+        //Does the point lie in the current CntntFrm?
         SwRect aCntFrm( pCnt->UnionFrm() );
         if ( aCntFrm.IsInside( rPoint ) && !lcl_IsInRepeatedHeadline( pCnt ))
             return rPoint;
 
-        //Ist der aktuelle der letzte CntntFrm? ||
-        //Wenn der naechste CntntFrm hinter dem Point liegt, ist der
-        //aktuelle der gesuchte.
+        //Is the current one the last CntntFrm?
+        //If the next CntntFrm lies behind the point, then the current on is the
+        //one we searched.
         const SwCntntFrm *pNxt = pCnt->GetNextCntntFrm();
         while ( pNxt && !pNxt->IsInDocBody() )
             pNxt = pNxt->GetNextCntntFrm();
 
-        //Liegt der Point hinter dem letzten CntntFrm?
+        //Does the point lie behind the last CntntFrm?
         if ( !pNxt )
             return Point( aCntFrm.Right(), aCntFrm.Bottom() );
 
-        //Wenn der naechste CntntFrm hinter dem Point liegt ist er der
-        //gesuchte.
+        //If the next CntntFrm lies behind the point then it is the one we
+        //searched.
         const SwTabFrm* pTFrm;
         pNxt->Calc();
         if( pNxt->Frm().Top() > rPoint.Y() &&
@@ -1647,17 +1613,15 @@ Point SwRootFrm::GetNextPrevCntntPos( const Point& rPoint, sal_Bool bNext ) cons
 |*
 |*  SwRootFrm::GetPagePos()
 |*
-|*  Beschreibung:   Liefert die absolute Dokumentpositon der gewuenschten
-|*          Seite.
-|*          Formatiert wird nur soweit notwendig und nur dann wenn bFormat=sal_True
-|*          Liefert Null, wenn die Operation nicht moeglich ist.
-|*          Die Pos ist die der letzten Seite, wenn die Seitenzahl zu gross
-|*          gewaehlt wurde.
-|*
+|*  Description:    Returns the absolute document position of the desired page.
+|*           Formatting is done only as far as needed and only if bFormat=sal_True.
+|*           Returns Null if the operation failed.
+|*           Pos is set to the one of the last page, if the page number was
+|*           chosen to big.
 |*************************************************************************/
 Point SwRootFrm::GetPagePos( sal_uInt16 nPageNum ) const
 {
-    OSL_ENSURE( Lower() && Lower()->IsPageFrm(), "Keine Seite vorhanden." );
+    OSL_ENSURE( Lower() && Lower()->IsPageFrm(), "No page available." );
 
     const SwPageFrm *pPage = (const SwPageFrm*)Lower();
     while ( true )
@@ -1716,11 +1680,8 @@ sal_Bool SwRootFrm::IsDummyPage( sal_uInt16 nPageNum ) const
 |*
 |*    SwFrm::IsProtected()
 |*
-|*    Beschreibung      Ist der Frm bzw. die Section in der er steht
-|*                      geschuetzt?
-|*                      Auch Fly in Fly in ... und Fussnoten
-|*
-|*
+|*    Description:     Is the Frm or rather the Section in which it lies
+|*                     protected? Also Fly in Fly in .... and Footnotes
 |*************************************************************************/
 sal_Bool SwFrm::IsProtected() const
 {
@@ -1730,11 +1691,11 @@ sal_Bool SwFrm::IsProtected() const
         bool isFormProtected=pDoc->get(IDocumentSettingAccess::PROTECT_FORM );
         if (isFormProtected)
         {
-            return sal_False; // TODO a hack for now, well deal with it laster, I we return true here we have a "double" locking
+            return sal_False; // TODO a hack for now, well deal with it later, I we return true here we have a "double" locking
         }
     }
-    //Der Frm kann in Rahmen, Zellen oder Bereichen geschuetzt sein.
-    //Geht auch FlyFrms rekursiv hoch. Geht auch von Fussnoten zum Anker.
+    //The Frm can be protected in borders, cells or sections.
+    //Also goes up FlyFrms recursive and from footnote to anchor.
     const SwFrm *pFrm = this;
     do
     {
@@ -1755,8 +1716,8 @@ sal_Bool SwFrm::IsProtected() const
         }
         if ( pFrm->IsFlyFrm() )
         {
-            //Der Schutz des Inhaltes kann bei Verkettung vom Master der Kette
-            //vorgegeben werden.
+            //In a chain the protection of the content can be specified by the
+            //master of the chain.
             if ( ((SwFlyFrm*)pFrm)->GetPrevLink() )
             {
                 SwFlyFrm *pMaster = (SwFlyFrm*)pFrm;
@@ -1781,7 +1742,7 @@ sal_Bool SwFrm::IsProtected() const
 /*************************************************************************
 |*
 |*    SwFrm::GetPhyPageNum()
-|*    Beschreibung:     Liefert die physikalische Seitennummer
+|*    Description:      Returns the physical page number
 |*
 |*
 |*************************************************************************/
@@ -1881,7 +1842,7 @@ bool SwFrm::OnFirstPage() const
 /*************************************************************************
 |*
 |*    SwFrm::GetVirtPageNum()
-|*    Beschreibung:     Liefert die virtuelle Seitennummer mit Offset
+|*    Description:      Returns the virtual page number with the offset.
 |*
 |*************************************************************************/
 sal_uInt16 SwFrm::GetVirtPageNum() const
@@ -1894,11 +1855,10 @@ sal_uInt16 SwFrm::GetVirtPageNum() const
     if ( !((SwRootFrm*)pPage->GetUpper())->IsVirtPageNum() )
         return nPhyPage;
 
-    //Den am naechsten stehenden Absatz mit virtueller Seitennummer suchen.
-    //Da das rueckwaertsuchen insgesamt sehr viel Zeit verschlingt suchen
-    //wir jetzt gezielt ueber die Abhaengigkeiten.
-    //von den PageDescs bekommen wir die Attribute, von den Attributen
-    //wiederum bekommen wir die Absaetze.
+    //Search the nearest section using the virtual page number.
+    //Because searching backwards needs a lot of time we search specific using
+    //the dependencies. From the PageDescs we get the attributes and from the
+    //attributes we get the sections.
     const SwPageFrm *pVirtPage = 0;
     const SwFrm *pFrm = 0;
     const SfxItemPool &rPool = pPage->GetFmt()->GetDoc()->GetAttrPool();
@@ -1936,13 +1896,12 @@ sal_uInt16 SwFrm::GetVirtPageNum() const
 |*
 |*  SwRootFrm::MakeTblCrsrs()
 |*
+|*  Description:        Determines and sets those cells which are enclosed
+|*                      by the selection.
 |*************************************************************************/
-//Ermitteln und einstellen derjenigen Zellen die von der Selektion
-//eingeschlossen sind.
-
 bool SwRootFrm::MakeTblCrsrs( SwTableCursor& rTblCrsr )
 {
-    //Union-Rects und Tabellen (Follows) der Selektion besorgen.
+    //Find Union-Rects and tables (Follows) of the selection.
     OSL_ENSURE( rTblCrsr.GetCntntNode() && rTblCrsr.GetCntntNode( sal_False ),
             "Tabselection nicht auf Cnt." );
 
@@ -2005,7 +1964,7 @@ bool SwRootFrm::MakeTblCrsrs( SwTableCursor& rTblCrsr )
 
                     while ( pCell && pRow->IsAnLower( pCell ) )
                     {
-                        OSL_ENSURE( pCell->IsCellFrm(), "Frame ohne Celle" );
+                        OSL_ENSURE( pCell->IsCellFrm(), "Frame without cell" );
                         if( IsFrmInTblSel( pUnion->GetUnion(), pCell ) &&
                             (bReadOnlyAvailable ||
                              !pCell->GetFmt()->GetProtect().IsCntntProtected()))
@@ -2027,7 +1986,7 @@ bool SwRootFrm::MakeTblCrsrs( SwTableCursor& rTblCrsr )
                             {
                                 pCell = pCell->GetNextLayoutLeaf();
                             } while ( pCell && pLastCell->IsAnLower( pCell ) );
-                            // Fuer (spaltige) Bereiche...
+                            // For sections with columns
                             if( pCell && pCell->IsInTab() )
                             {
                                 while( !pCell->IsCellFrm() )
@@ -2058,33 +2017,29 @@ bool SwRootFrm::MakeTblCrsrs( SwTableCursor& rTblCrsr )
 |*************************************************************************/
 
 /*
- * nun koennen folgende Situationen auftreten:
- *  1. Start und Ende liegen in einer Bildschirm - Zeile und im
- *     gleichen Node
- *      -> aus Start und End ein Rectangle, dann Ok
- *  2. Start und Ende liegen in einem Frame (dadurch im gleichen Node!)
- *      -> Start nach rechts, End nach links erweitern,
- *         und bei mehr als 2 Bildschirm - Zeilen, das dazwischen
- *         liegende berechnen
- *  3. Start und Ende liegen in verschiedenen Frames
- *      -> Start nach rechts erweitern, bis Frame-Ende Rect berechnen
- *         Ende nach links erweitern, bis Frame-Start Rect berechnen
- *         und bei mehr als 2 Frames von allen dazwischen liegenden
- *         Frames die PrtArea dazu.
- *  4. Wenn es sich um eine Tabellenselektion handelt wird fuer jeden
- *     PaM im Ring der CellFrm besorgt, dessen PrtArea wird zu den
- *     Rechtecken addiert.
+ * The following situations can happen:
+ *  1. Start and end lie in one screen-row and in the same node
+ *     -> one rectangle out of start and end; and we're okay
+ *  2. Start and end lie in one frame (therefore in the same node!)
+ *     -> expand start to the right, end to the left and if more than two
+ *        screen-rows are involved - calculate the in-between
+ *  3. Start and end lie in different frames
+ *     -> expand start to the right until frame-end, calculate Rect
+ *        expand end to the left until frame-start, calculate Rect
+ *        and if more than two frames are involved add the PrtArea of all
+ *        frames which lie in between
+ *  4. If it's about a table-selection we have to obtain the CellFrm for every
+ *     PaM in the ring - its PrtArea will be added to the Rect.
  *
- * Grosser Umbau wg. der FlyFrm; denn diese muessen ausgespart werden.
- * Ausnahmen: - Der Fly in dem die Selektion stattfindet (wenn sie in einem Fly
- *              stattfindet).
- *            - Die Flys, die vom Text unterlaufen werden.
- * Arbeitsweise: Zuerst wird eine SwRegion mit der Root initialisiert.
- *               Aus der Region werden die zu invertierenden Bereiche
- *               ausgestantzt. Die Region wird Komprimiert und letztlich
- *               invertiert. Damit liegen dann die zu invertierenden
- *               Rechtecke vor.
- *               Am Ende werden die Flys aus der Region ausgestanzt.
+ * Big reorganization because of the FlyFrm - those need to be locked out.
+ * Exceptions:  - The Fly in which the selection took place (if it took place
+ *                 in a Fly)
+ *              - The Flys which are underrun by the text
+ * Functioning: First a SwRegion with a root gets initialized.
+ *              Out of the region the inverted sections are cut out. The
+ *              section gets compressed and finally inverted and thereby the
+ *              inverted rectangles are available.
+ *              In the end the Flys are cut out of the section.
  */
 
 inline void Sub( SwRegionRects& rRegion, const SwRect& rRect )
@@ -2101,7 +2056,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
 
     ViewShell *pSh = GetCurrShell();
 
-// #i12836# enhanced pdf
+    // #i12836# enhanced pdf
     SwRegionRects aRegion( pSh && !pSh->GetViewOptions()->IsPDFExport() ?
                            pSh->VisArea() :
                            Frm() );
@@ -2114,8 +2069,8 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
         return;
     }
 
-    //Erstmal die CntntFrms zum Start und End besorgen, die brauch ich auf
-    //jedenfall.
+    //First obtain the CntntFrms for the start and the end - those are needed
+    //anyway.
     SwCntntFrm const* pStartFrm = pStartPos->nNode.GetNode().
         GetCntntNode()->getLayoutFrm( this, &rCrsr.GetSttPos(), pStartPos );
 
@@ -2124,8 +2079,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
 
     OSL_ENSURE( (pStartFrm && pEndFrm), "Keine CntntFrms gefunden." );
 
-    //Damit die FlyFrms, in denen selektierte Frames stecken, nicht
-    //abgezogen werden
+    //Do not subtract the FlyFrms in which selected Frames lie.
     SwSortedObjs aSortObjs;
     if ( pStartFrm->IsInFly() )
     {
@@ -2140,7 +2094,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
         }
     }
 
-    //Fall 4: Tabellenselection
+    //Case 4: Table selection
     if( bIsTblMode )
     {
         const SwFrm *pCell = pStartFrm->GetUpper();
@@ -2154,8 +2108,8 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
     }
     else
     {
-        // falls eine nicht erlaubte Selection besteht, dann korrigiere das
-        // nicht erlaubt ist Header/Footer/TableHeadline ueber 2 Seiten
+        // if a selection which is not allowed exists, we correct what is not
+        // allowed (header/footer/table-headline) for two pages.
         do {    // middle check loop
             const SwLayoutFrm* pSttLFrm = pStartFrm->GetUpper();
             const sal_uInt16 cHdFtTblHd = FRM_HEADER | FRM_FOOTER | FRM_TAB;
@@ -2172,16 +2126,15 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
                 break;
 
             OSL_ENSURE( pEndLFrm->GetType() == pSttLFrm->GetType(),
-                "Selection ueber unterschiedliche Inhalte" );
+                "Selection over different content" );
             switch( pSttLFrm->GetType() )
             {
             case FRM_HEADER:
             case FRM_FOOTER:
-                // auf unterschiedlichen Seiten ??
-                // dann immer auf die Start-Seite
+                // On different pages? Then always on the start-page
                 if( pEndLFrm->FindPageFrm() != pSttLFrm->FindPageFrm() )
                 {
-                    // End- auf den Start-CntntFrame setzen
+                    // Set end- to the start-CntntFrame
                     if( pStartPos == rCrsr.GetPoint() )
                         pEndFrm = pStartFrm;
                     else
@@ -2189,9 +2142,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
                 }
                 break;
             case FRM_TAB:
-                // auf unterschiedlichen Seiten ??
-                // existiert
-                // dann teste auf Tabelle-Headline
+                // On different pages? Then check for table-headline
                 {
                     const SwTabFrm* pTabFrm = (SwTabFrm*)pSttLFrm;
                     if( ( pTabFrm->GetFollow() ||
@@ -2201,7 +2152,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
                         ( lcl_IsInRepeatedHeadline( pStartFrm ) ||
                         lcl_IsInRepeatedHeadline( pEndFrm ) ) )
                     {
-                        // End- auf den Start-CntntFrame setzen
+                        // Set end- to the start-CntntFrame
                         if( pStartPos == rCrsr.GetPoint() )
                             pEndFrm = pStartFrm;
                         else
@@ -2217,7 +2168,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
         aTmpState.bNoScroll = sal_True;
         aTmpState.nCursorBidiLevel = pStartFrm->IsRightToLeft() ? 1 : 0;
 
-        //CntntRects zu Start- und EndFrms.
+        //CntntRects to Start- and EndFrms.
         SwRect aStRect, aEndRect;
         pStartFrm->GetCharRect( aStRect, *pStartPos, &aTmpState );
         Sw2LinesPos *pSt2Pos = aTmpState.p2Lines;
@@ -2496,9 +2447,9 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
                 }
 
                 SwRect aTmp = SwRect( aTmpSt, aTmpEnd );
-                // Bug 34888: falls Inhalt selektiert ist, der keinen Platz
-                //            einnimmt (z.B. PostIts,RefMarks, TOXMarks),
-                //            dann mindestens die Breite des Crsr setzen.
+                // Bug 34888: If content is selected which doesn't take space
+                //            away (i.e. PostIts, RefMarks, TOXMarks), then at
+                //            least set the width of the Crsr.
                 if( 1 == (aTmp.*fnRect->fnGetWidth)() &&
                     pStartPos->nContent.GetIndex() !=
                     pEndPos->nContent.GetIndex() )
@@ -2561,7 +2512,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
                 Sub( aRegion, aSubRect );
             }
         }
-        //case 3: (Different frames, maybe with ohther frames between
+        //case 3: (Different frames, maybe with other frames between)
         else
         {
             //The startframe first...
@@ -2657,11 +2608,11 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
         delete pEnd2Pos;
     }
 
-    //Flys mit Durchlauf ausstanzen. Nicht ausgestanzt werden Flys:
-    //- die Lower des StartFrm/EndFrm sind (FlyInCnt und alle Flys die wiederum
-    //  darin sitzen)
-    //- in der Z-Order ueber denjenigen Flys stehen in denen sich der StartFrm
-    //  befindet.
+    // Cut out Flys during loop. We don't cut out Flys when:
+    // - the Lower is StartFrm/EndFrm (FlyInCnt and all other Flys which again
+    //   sit in it)
+    // - if in the Z-order we have Flys above those in which the StartFrm is
+    //   placed
     const SwPageFrm *pPage      = pStartFrm->FindPageFrm();
     const SwPageFrm *pEndPage   = pEndFrm->FindPageFrm();
 
@@ -2715,7 +2666,7 @@ void SwRootFrm::CalcFrmRects( SwShellCrsr &rCrsr, sal_Bool bIsTblMode )
             pPage = (SwPageFrm*)pPage->GetNext();
     }
 
-    //Weil's besser aussieht noch die DropCaps ausschliessen.
+    //Because it looks better, we close the DropCaps.
     SwRect aDropRect;
     if ( pStartFrm->IsTxtFrm() )
     {