You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by ma...@apache.org on 2016/11/10 14:12:56 UTC

svn commit: r1769121 - in /openoffice/trunk/main/sw/source/core/doc: doc.cxx docdesc.cxx

Author: marcus
Date: Thu Nov 10 14:12:56 2016
New Revision: 1769121

URL: http://svn.apache.org/viewvc?rev=1769121&view=rev
Log:
#i39199# Translated comments from German to English

Modified:
    openoffice/trunk/main/sw/source/core/doc/doc.cxx
    openoffice/trunk/main/sw/source/core/doc/docdesc.cxx

Modified: openoffice/trunk/main/sw/source/core/doc/doc.cxx
URL: http://svn.apache.org/viewvc/openoffice/trunk/main/sw/source/core/doc/doc.cxx?rev=1769121&r1=1769120&r2=1769121&view=diff
==============================================================================
--- openoffice/trunk/main/sw/source/core/doc/doc.cxx (original)
+++ openoffice/trunk/main/sw/source/core/doc/doc.cxx Thu Nov 10 14:12:56 2016
@@ -73,32 +73,32 @@
 #include <swtable.hxx>
 #include <pam.hxx>
 #include <ndtxt.hxx>
-#include <swundo.hxx>			// fuer die UndoIds
+#include <swundo.hxx>		// for the UndoIds
 #include <UndoCore.hxx>
 #include <UndoInsert.hxx>
 #include <UndoSplitMove.hxx>
 #include <UndoTable.hxx>
-#include <pagedesc.hxx> //DTor
+#include <pagedesc.hxx>		//DTor
 #include <breakit.hxx>
 #include <ndole.hxx>
 #include <ndgrf.hxx>
-#include <rolbck.hxx>			// Undo-Attr
-#include <doctxm.hxx>			// fuer die Verzeichnisse
+#include <rolbck.hxx>		// Undo-Attr
+#include <doctxm.hxx>		// for the directories
 #include <grfatr.hxx>
-#include <poolfmt.hxx>			// PoolVorlagen-Id's
-#include <mvsave.hxx>			// fuer Server-Funktionalitaet
+#include <poolfmt.hxx>		// PoolTemplate ID's
+#include <mvsave.hxx>		// for server functionality
 #include <SwGrammarMarkUp.hxx>
 #include <scriptinfo.hxx>
-#include <acorrect.hxx>			// Autokorrektur
-#include <mdiexp.hxx>	   		// Statusanzeige
+#include <acorrect.hxx>		// AutoCorrect
+#include <mdiexp.hxx>	   	// status display
 #include <docstat.hxx>
 #include <docary.hxx>
 #include <redline.hxx>
 #include <fldupde.hxx>
 #include <swbaslnk.hxx>
 #include <printdata.hxx>
-#include <cmdid.h>              // fuer den dflt - Printer in SetJob
-#include <statstr.hrc>      	// StatLine-String
+#include <cmdid.h>              // for the dflt - Printer in SetJob
+#include <statstr.hrc>      	// StatLine string
 #include <comcore.hrc>
 #include <SwUndoTOXChange.hxx>
 #include <SwUndoFmt.hxx>
@@ -126,11 +126,11 @@ using namespace ::com::sun::star;
 using ::rtl::OUString;
 
 
-// Seiten-Deskriptoren
+// Page descriptors
 SV_IMPL_PTRARR(SwPageDescs,SwPageDescPtr);
-// Verzeichnisse
+// Directories
 SV_IMPL_PTRARR( SwTOXTypes, SwTOXTypePtr )
-// FeldTypen
+// Field types
 SV_IMPL_PTRARR( SwFldTypes, SwFldTypePtr)
 
 /** IInterface
@@ -609,7 +609,7 @@ void SwDoc::setJobsetup(/*[in]*/ const J
 
     if( !pPrt )
     {
-        //Das ItemSet wird vom Sfx geloescht!
+        // the ItemSet will be deleted by Sfx!
         SfxItemSet *pSet = new SfxItemSet( GetAttrPool(),
                         FN_PARAM_ADDPRINTER, FN_PARAM_ADDPRINTER,
                         SID_HTML_MODE,  SID_HTML_MODE,
@@ -659,8 +659,8 @@ void SwDoc::setPrintData(/*[in]*/ const
 */
 
 /*
- * Dokumenteditieren (Doc-SS) zum Fuellen des Dokuments
- * durch den RTF Parser und fuer die EditShell.
+ * Document editing (Doc-SS) to fill the documents
+ * by the RTF parser and for the EditShell.
  */
 void SwDoc::ChgDBData(const SwDBData& rNewData)
 {
@@ -679,9 +679,9 @@ bool SwDoc::SplitNode( const SwPosition
         return false;
 
 	{
-		// Bug 26675:	DataChanged vorm loeschen verschicken, dann bekommt
-		//			man noch mit, welche Objecte sich im Bereich befinden.
-		//			Danach koennen sie vor/hinter der Position befinden.
+		// Bug 26675:	Sent DataChanged before deletion, then you can
+		//		still notice which objects are in the range.
+		//		After that the objects can be before/after the position.
 		SwDataChanged aTmp( this, rPos, 0 );
 	}
 
@@ -689,7 +689,7 @@ bool SwDoc::SplitNode( const SwPosition
     if (GetIDocumentUndoRedo().DoesUndo())
     {
         GetIDocumentUndoRedo().ClearRedo();
-		// einfuegen vom Undo-Object, z.Z. nur beim TextNode
+		// insert the Undo object, currentlx only in TextNode
 		if( pNode->IsTxtNode() )
         {
             pUndo = new SwUndoSplitNode( this, rPos, bChkTableStart );
@@ -697,10 +697,9 @@ bool SwDoc::SplitNode( const SwPosition
         }
     }
 
-	//JP 28.01.97: Sonderfall fuer SplitNode am Tabellenanfang:
-	//				steht die am Doc/Fly/Footer/..-Anfang oder direkt
-	//				hinter einer Tabelle, dann fuege davor
-	//				einen Absatz ein
+	//JP 28.01.97:	Special case for SplitNode at table start:
+	//		Are they at Doc/Fly/Footer/..-Start or directly
+	//		behind a table, then insert a paragraph before it
 	if( bChkTableStart && !rPos.nContent.GetIndex() && pNode->IsTxtNode() )
 	{
 		sal_uLong nPrevPos = rPos.nNode.GetIndex() - 1;
@@ -717,14 +716,13 @@ bool SwDoc::SplitNode( const SwPosition
 			if( pNd->IsCntntNode() )
 			{
 				//JP 30.04.99 Bug 65660:
-				// ausserhalb des normalen BodyBereiches gibt es keine
-				// Seitenumbrueche, also ist das hier kein gueltige
-				// Bedingung fuers einfuegen eines Absatzes
+				// Outside of the normal BodyArea there are no page breaks,
+				// therefore this is no valid condition for inserting a paragraph
 				if( nPrevPos < GetNodes().GetEndOfExtras().GetIndex() )
 					pNd = 0;
 				else
 				{
-					// Dann nur, wenn die Tabelle Umbrueche traegt!
+					// only when the table has breaks!
 					const SwFrmFmt* pFrmFmt = pTblNd->GetTable().GetFrmFmt();
 					if( SFX_ITEM_SET != pFrmFmt->GetItemState(RES_PAGEDESC, sal_False) &&
 						SFX_ITEM_SET != pFrmFmt->GetItemState( RES_BREAK, sal_False ) )
@@ -742,7 +740,7 @@ bool SwDoc::SplitNode( const SwPosition
 					((SwPosition&)rPos).nNode = pTblNd->GetIndex()-1;
 					((SwPosition&)rPos).nContent.Assign( pTxtNd, 0 );
 
-					// nur im BodyBereich den SeitenUmbruch/-Vorlage umhaengem
+					// only move the page break/page style inside the BodyArea
 					if( nPrevPos > GetNodes().GetEndOfExtras().GetIndex() )
 					{
 						SwFrmFmt* pFrmFmt = pTblNd->GetTable().GetFrmFmt();
@@ -778,7 +776,7 @@ bool SwDoc::SplitNode( const SwPosition
     pNode = pNode->SplitCntntNode( rPos );
     if (pNode)
 	{
-		// verschiebe noch alle Bookmarks/TOXMarks/FlyAtCnt
+		// now move all Bookmarks/TOXMarks/FlyAtCnt
 		if( aBkmkArr.Count() )
 			_RestoreCntntIdx( this, aBkmkArr, rPos.nNode.GetIndex()-1, 0, sal_True );
 
@@ -804,7 +802,7 @@ bool SwDoc::AppendTxtNode( SwPosition& r
     SwTxtNode * pCurNode = rPos.nNode.GetNode().GetTxtNode();
 	if( !pCurNode )
 	{
-		// dann kann ja einer angelegt werden!
+		// now a node can be created!
 		SwNodeIndex aIdx( rPos.nNode, 1 );
 		pCurNode = GetNodes().MakeTxtNode( aIdx,
 						GetTxtCollFromPool( RES_POOLCOLL_STANDARD ));
@@ -845,7 +843,7 @@ bool SwDoc::InsertString( const SwPaM &r
 
     const SwPosition& rPos = *rRg.GetPoint();
 
-	if( pACEWord )					// Aufnahme in die Autokorrektur
+	if( pACEWord )					// take it to AutoCorrect
 	{
 		if( 1 == rStr.Len() && pACEWord->IsDeleted() )
         {
@@ -875,7 +873,7 @@ bool SwDoc::InsertString( const SwPaM &r
         }
     }
     else
-	{			// ist Undo und Gruppierung eingeschaltet, ist alles anders !
+	{			// if Undo and Grouping is enabled, then all is different!
         SwUndoInsert * pUndo = NULL; // #111827#
 
         // don't group the start if hints at the start should be expanded
@@ -907,7 +905,7 @@ bool SwDoc::InsertString( const SwPaM &r
 		for( xub_StrLen i = 0; i < rStr.Len(); ++i )
 		{
 			nInsPos++;
-			// wenn CanGrouping() sal_True returnt, ist schon alles erledigt
+			// if CanGrouping() is returning sal_True, then all is already done
 			if( !pUndo->CanGrouping( rStr.GetChar( i ) ))
 			{
                 pUndo = new SwUndoInsert( rPos.nNode, nInsPos, 1, nInsertMode,
@@ -1035,7 +1033,7 @@ SwFlyFrmFmt* SwDoc::InsertOLE(const SwPa
 
 /*************************************************************************
 |*				  SwDoc::GetFldType()
-|*	  Beschreibung: liefert den am Doc eingerichteten Feldtypen zurueck
+|*	  Description: delievers the field type back which is arranged at the Doc
 *************************************************************************/
 
 SwFieldType *SwDoc::GetSysFldType( const sal_uInt16 eWhich ) const
@@ -1083,12 +1081,11 @@ sal_uInt16 _PostItFld::GetPageNo(
     const std::set< sal_Int32 > &rPossiblePages,
     /* out */ sal_uInt16& rVirtPgNo, /* out */ sal_uInt16& rLineNo )
 {
-    //Problem: Wenn ein PostItFld in einem Node steht, der von mehr als
-    //einer Layout-Instanz repraesentiert wird, steht die Frage im Raum,
-    //ob das PostIt nur ein- oder n-mal gedruck werden soll.
-    //Wahrscheinlich nur einmal, als Seitennummer soll hier keine Zufaellige
-    //sondern die des ersten Auftretens des PostIts innerhalb des selektierten
-    //Bereichs ermittelt werden.
+    // Problem:
+    // When a PostItFld is in a Node that is represented by more than one layout
+    // instance, then there is the question, whether the PostIt should be printed
+    // 1 or n-times. Likely only 1 time. Don't seek a random one as page number
+    // but the first occurrence of the PostIt within the selected area.
     rVirtPgNo = 0;
     sal_uInt16 nPos = GetCntnt();
     SwIterator<SwTxtFrm,SwTxtNode> aIter( GetTxtFld()->GetTxtNode() );
@@ -1121,7 +1118,7 @@ bool lcl_GetPostIts(
 
     if( pFldType->GetDepends() )
     {
-        // Modify-Object gefunden, trage alle Felder ins Array ein
+        // Modify object found, insert all fields into the array
         SwIterator<SwFmtFld,SwFieldType> aIter( *pFldType );
         const SwTxtFld* pTxtFld;
         for( SwFmtFld* pFld = aIter.First(); pFld;  pFld = aIter.Next() )
@@ -1275,11 +1272,12 @@ void SwDoc::CalculatePagesForPrinting(
     DBG_ASSERT( nFirstPageNo, "first page not found!  Should not happen!" );
     if (nFirstPageNo)
     {
-// HACK: Hier muss von der MultiSelection noch eine akzeptable Moeglichkeit
-// geschaffen werden, alle Seiten von Seite x an zu deselektieren.
-// Z.B. durch SetTotalRange ....
+// Start of HACK:
+// Here an acceptable possibility has to be created by the MultiSelection,
+// to deselect all pages starting from page x.
+// E.g., with SetTotalRange ....
 
-//              aMulti.Select( Range( nLastPageNo+1, SELECTION_MAX ), sal_False );
+// aMulti.Select( Range( nLastPageNo+1, SELECTION_MAX ), sal_False );
         MultiSelection aTmpMulti( Range( 1, nLastPageNo ) );
         long nTmpIdx = aMulti.FirstSelected();
         static long nEndOfSelection = SFX_ENDOFSELECTION;
@@ -1289,7 +1287,7 @@ void SwDoc::CalculatePagesForPrinting(
             nTmpIdx = aMulti.NextSelected();
         }
         aMulti = aTmpMulti;
-// Ende des HACKs
+// End of HACK
 
         nPageNo = nFirstPageNo;
 
@@ -1326,14 +1324,11 @@ void SwDoc::CalculatePagesForPrinting(
             }
         }
     }
-
     
-    //
     // now that we have identified the valid pages for printing according
     // to the print settings we need to get the PageRange to use and
     // use both results to get the actual pages to be printed
     // (post-it settings need to be taken into account later on!)
-    //
 
     // get PageRange value to use
     OUString aPageRange;
@@ -1655,12 +1650,11 @@ void SwDoc::CalculatePagePairsForProspec
             aVec.push_back( 0 );
     }
 
-    // dann sorge mal dafuer, das alle Seiten in der richtigen
-    // Reihenfolge stehen:
+    // now make sure that all pages are in the correct order
     sal_uInt16 nSPg = 0;
     sal_uInt32 nEPg = aVec.size();
     sal_uInt16 nStep = 1;
-    if ( 0 == (nEPg & 1 ))      // ungerade gibt es nicht!
+    if ( 0 == (nEPg & 1 ))      // there is no odd!
         --nEPg;
 
     if ( !bPrintLeftPages )
@@ -1721,7 +1715,7 @@ void SwDoc::UpdateDocStat( SwDocStat& rS
 	if( rStat.bModified )
 	{
 		rStat.Reset();
-		rStat.nPara = 0;        // Default ist auf 1 !!
+		rStat.nPara = 0;        // default is 1 !!
 		SwNode* pNd;
 
         for( sal_uLong i = GetNodes().Count(); i; )
@@ -1795,14 +1789,14 @@ void SwDoc::UpdateDocStat( SwDocStat& rS
             }
         }
 
-		// event. Stat. Felder Updaten
+		// if necessary update statistical fields
 		SwFieldType *pType = GetSysFldType(RES_DOCSTATFLD);
 		pType->UpdateFlds();
 	}
 }
 
 
-// Dokument - Info
+// Document - Info
 
 void SwDoc::DocInfoChgd( )
 {
@@ -1811,7 +1805,7 @@ void SwDoc::DocInfoChgd( )
 	SetModified();
 }
 
-	// returne zum Namen die im Doc gesetzte Referenz
+	// return the reference that is set in the Doc, together with the name
 const SwFmtRefMark* SwDoc::GetRefMark( const String& rName ) const
 {
 	const SfxPoolItem* pItem;
@@ -1830,7 +1824,7 @@ const SwFmtRefMark* SwDoc::GetRefMark( c
 	return 0;
 }
 
-	// returne die RefMark per Index - fuer Uno
+	// return the RefMark by Index - for Uno
 const SwFmtRefMark* SwDoc::GetRefMark( sal_uInt16 nIndex ) const
 {
 	const SfxPoolItem* pItem;
@@ -1854,10 +1848,9 @@ const SwFmtRefMark* SwDoc::GetRefMark( s
    return pRet;
 }
 
-	// returne die Namen aller im Doc gesetzten Referenzen
-	//JP 24.06.96: Ist der ArrayPointer 0 dann returne nur, ob im Doc. eine
-	//				RefMark gesetzt ist
-	// OS 25.06.96: ab jetzt wird immer die Anzahl der Referenzen returnt
+	// return the names of all references that are set in the Doc
+	// JP 24.06.96: If the ArrayPointer is 0 then return only when a RefMark is set in the Doc
+	// OS 25.06.96: from now on always return the number of the references
 sal_uInt16 SwDoc::GetRefMarks( SvStringsDtor* pNames ) const
 {
     const SfxPoolItem* pItem;
@@ -1936,9 +1929,9 @@ void SwDoc::SetModified()
     // --> OD 2006-05-10 #i65250#
     SwLayouter::ClearMoveBwdLayoutInfo( *this );
     // <--
-	// dem Link wird der Status returnt, wie die Flags waren und werden
-	// 	Bit 0:	-> alter Zustand
-	//	Bit 1: 	-> neuer Zustand
+	// return the status to the link, how the flags were and will be
+	// 	Bit 0:	-> old status
+	//	Bit 1: 	-> new status
 	long nCall = mbModified ? 3 : 2;
 	mbModified = sal_True;
 	pDocStat->bModified = sal_True;
@@ -1955,9 +1948,9 @@ void SwDoc::SetModified()
 
 void SwDoc::ResetModified()
 {
-	// dem Link wird der Status returnt, wie die Flags waren und werden
-	// 	Bit 0:	-> alter Zustand
-	//	Bit 1: 	-> neuer Zustand
+	// return the status to the link, how the flags were and will be
+	// 	Bit 0:	-> old status
+	//	Bit 1: 	-> new status
     long nCall = mbModified ? 1 : 0;
 	mbModified = sal_False;
     // If there is already a document statistic, we assume that
@@ -1988,8 +1981,8 @@ void SwDoc::ReRead( SwPaM& rPam, const S
             GetIDocumentUndoRedo().AppendUndo(new SwUndoReRead(rPam, *pGrfNd));
         }
 
-		// Weil nicht bekannt ist, ob sich die Grafik spiegeln laesst,
-		// immer das SpiegelungsAttribut zuruecksetzen
+		// Because it's not known if the graphic can be mirrored,
+		// always set back the MirrorAttribute
         if( RES_MIRROR_GRAPH_DONT != pGrfNd->GetSwAttrSet().
 												GetMirrorGrf().GetValue() )
 			pGrfNd->SetAttr( SwMirrorGrf() );
@@ -2049,12 +2042,12 @@ sal_Bool lcl_CheckSmartTagsAgain( const
 /*************************************************************************
  * 		SwDoc::SpellItAgainSam( sal_Bool bInvalid, sal_Bool bOnlyWrong )
  *
- * stoesst das Spelling im Idle-Handler wieder an.
- * Wird bInvalid als sal_True uebergeben, so werden zusaetzlich die WrongListen
- * an allen Nodes invalidiert und auf allen Seiten das SpellInvalid-Flag
- * gesetzt.
- * Mit bOnlyWrong kann man dann steuern, ob nur die Bereiche mit falschen
- * Woertern oder die kompletten Bereiche neu ueberprueft werden muessen.
+ * Is activating again the spelling in the Idle handler.
+ * When bInvalid will be hand over as sal_True, then additionally the WrongLists
+ * on all Nodes will be invalidated and on all pages the SpellInvalid flag
+ * will be set.
+ * With bOnlyWrong you can controll, whether only the areas with wrong words
+ * or the complete areas have to be checked again.
  ************************************************************************/
 
 void SwDoc::SpellItAgainSam( sal_Bool bInvalid, sal_Bool bOnlyWrong, sal_Bool bSmartTags )
@@ -2184,8 +2177,8 @@ void SwDoc::Summary( SwDoc* pExtDoc, sal
 	}
 }
 
-	// loesche den nicht sichtbaren Content aus dem Document, wie z.B.:
-	// versteckte Bereiche, versteckte Absaetze
+	// don't delete the visible content from the document, like e.g.,
+	// hidden sections, hidden paragraphs
 bool SwDoc::RemoveInvisibleContent()
 {
 	sal_Bool bRet = sal_False;
@@ -2274,7 +2267,7 @@ bool SwDoc::RemoveInvisibleContent()
     }
 
 	{
-		// dann noch alle versteckten Bereiche loeschen/leeren
+		// now delete/empty all hidden sections
 		SwSectionFmts aSectFmts;
 		SwSectionFmts& rSectFmts = GetSections();
 		sal_uInt16 n;
@@ -2324,7 +2317,7 @@ bool SwDoc::RemoveInvisibleContent()
                         pSectNd->StartOfSectionNode()->EndOfSectionIndex() ==
 						pSectNd->EndOfSectionIndex() + 1 )
 					{
-						// nur den Inhalt loeschen
+						// delete only the content
 						SwCntntNode* pCNd = GetNodes().GoNext(
 												&aPam.GetPoint()->nNode );
 						aPam.GetPoint()->nContent.Assign( pCNd, 0 );
@@ -2338,7 +2331,7 @@ bool SwDoc::RemoveInvisibleContent()
                     }
 					else
 					{
-						// die gesamte Section loeschen
+						// delete the complete section
 						aPam.SetMark();
 						aPam.GetPoint()->nNode = *pSectNd->EndOfSectionNode();
 						DelFullPara( aPam );
@@ -2528,7 +2521,7 @@ bool SwDoc::LinksUpdated() const
     return mbLinksUpdated;
 }
 
-	// embedded alle lokalen Links (Bereiche/Grafiken)
+	// embed all local links (sections/graphics)
 ::sfx2::SvBaseLink* lcl_FindNextRemovableLink( const ::sfx2::SvBaseLinks& rLinks, sfx2::LinkManager& rLnkMgr )
 {
     for( sal_uInt16 n = 0; n < rLinks.Count(); ++n )
@@ -2565,10 +2558,10 @@ bool SwDoc::EmbedAllLinks()
         while( 0 != (pLnk = lcl_FindNextRemovableLink( rLinks, rLnkMgr ) ) )
 		{
             ::sfx2::SvBaseLinkRef xLink = pLnk;
-            // dem Link sagen, das er aufgeloest wird!
+            // tell the link that it will be cleared!
             xLink->Closed();
 
-            // falls einer vergessen hat sich auszutragen
+            // in the case a link was not deregistered
             if( xLink.Is() )
                 rLnkMgr.Remove( xLink );
 
@@ -2582,7 +2575,7 @@ bool SwDoc::EmbedAllLinks()
 }
 
 /*--------------------------------------------------------------------
-	Beschreibung:
+	Description:
  --------------------------------------------------------------------*/
 
 sal_Bool SwDoc::IsInsTblFormatNum() const
@@ -2596,7 +2589,7 @@ sal_Bool SwDoc::IsInsTblChangeNumFormat(
 }
 
 /*--------------------------------------------------------------------
-	Beschreibung:
+	Description:
  --------------------------------------------------------------------*/
 
 sal_Bool SwDoc::IsInsTblAlignNum() const
@@ -2604,7 +2597,7 @@ sal_Bool SwDoc::IsInsTblAlignNum() const
 	return SW_MOD()->IsInsTblAlignNum(get(IDocumentSettingAccess::HTML_MODE));
 }
 
-        // setze das InsertDB als Tabelle Undo auf:
+        // set the InsertDB as table Undo to:
 void SwDoc::AppendUndoForInsertFromDB( const SwPaM& rPam, sal_Bool bIsTable )
 {
 	if( bIsTable )

Modified: openoffice/trunk/main/sw/source/core/doc/docdesc.cxx
URL: http://svn.apache.org/viewvc/openoffice/trunk/main/sw/source/core/doc/docdesc.cxx?rev=1769121&r1=1769120&r2=1769121&view=diff
==============================================================================
--- openoffice/trunk/main/sw/source/core/doc/docdesc.cxx (original)
+++ openoffice/trunk/main/sw/source/core/doc/docdesc.cxx Thu Nov 10 14:12:56 2016
@@ -48,8 +48,8 @@
 #include <doc.hxx>
 #include <IDocumentUndoRedo.hxx>
 #include <docary.hxx>
-#include <pagefrm.hxx>	//Fuer DelPageDesc
-#include <rootfrm.hxx>	//Fuer DelPageDesc
+#include <pagefrm.hxx>	// for DelPageDesc
+#include <rootfrm.hxx>	// for DelPageDesc
 #include <ndtxt.hxx>
 #include <frmtool.hxx>
 #include <pagedesc.hxx>
@@ -90,10 +90,9 @@ static void lcl_DefaultPageFmt( sal_uInt
     const Size aPhysSize = SvxPaperInfo::GetDefaultPaperSize();
     aFrmSize.SetSize( aPhysSize );
 
-    //Auf Default-Raender vorbereiten.
-    //Raender haben eine defaultmaessige Mindestgroesse.
-    //wenn der Drucker einen groesseren Rand vorgibt, so
-    //ist mir dass auch recht.
+    // Prepare for default margins.
+    // Margins have a default minimum size.
+    // If the printer gives a larger margin, then it's OK as well.
     // MIB 06/25/2002, #99397#: The HTML page desc had A4 as page size
     // always. This has been changed to take the page size from the printer.
     // Unfortunately, the margins of the HTML page desc are smaller than
@@ -108,15 +107,15 @@ static void lcl_DefaultPageFmt( sal_uInt
     }
     else if( MEASURE_METRIC == SvtSysLocale().GetLocaleData().getMeasurementSystemEnum() )
     {
-        nMinTop = nMinBottom = nMinLeft = nMinRight = 1134; //2 Zentimeter
+        nMinTop = nMinBottom = nMinLeft = nMinRight = 1134; //2 centimeters
     }
     else
     {
-        nMinTop = nMinBottom = 1440;    //al la WW: 1Inch
+        nMinTop = nMinBottom = 1440;    //al la WW: 1 Inch
         nMinLeft = nMinRight = 1800;    //          1,25 Inch
     }
 
-    //Raender einstellen.
+    // set the margins
     SvxLRSpaceItem aLR( RES_LR_SPACE );
     SvxULSpaceItem aUL( RES_UL_SPACE );
 
@@ -138,8 +137,8 @@ static void lcl_DefaultPageFmt( sal_uInt
 |*
 |*	SwDoc::ChgPageDesc()
 |*
-|*	Ersterstellung		MA 25. Jan. 93
-|*	Letzte Aenderung	MA 01. Mar. 95
+|*	Created			MA 25. Jan. 93
+|*	Last change		MA 01. Mar. 95
 |*
 |*************************************************************************/
 
@@ -148,10 +147,10 @@ void lcl_DescSetAttr( const SwFrmFmt &rS
 {
 /////////////// !!!!!!!!!!!!!!!!
 //JP 03.03.99:
-// eigentlich sollte hier das Intersect von ItemSet benutzt werden, aber das
-// funktioniert nicht richtig, wenn man unterschiedliche WhichRanges hat.
+// Actually the Intersect from ItemSet should be used here but that doesn't
+// work correctly when you have different WhichRanges.
 /////////////// !!!!!!!!!!!!!!!!
-    //Die interressanten Attribute uebernehmen.
+    // Take over the interesting attributes.
     sal_uInt16 __READONLY_DATA aIdArr[] = {
         RES_FRM_SIZE,                   RES_UL_SPACE,                   // [83..86
         RES_BACKGROUND,                 RES_SHADOW,                     // [99..101
@@ -222,7 +221,7 @@ void lcl_DescSetAttr( const SwFrmFmt &rS
         }
     }
 
-	// auch Pool-, Hilfe-Id's uebertragen
+	// transfer also the Pool-, Help-ID's
 	rDest.SetPoolFmtId( rSource.GetPoolFmtId() );
 	rDest.SetPoolHelpId( rSource.GetPoolHelpId() );
 	rDest.SetPoolHlpFileId( rSource.GetPoolHlpFileId() );
@@ -243,26 +242,26 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
     }
     ::sw::UndoGuard const undoGuard(GetIDocumentUndoRedo());
 
-	//Als erstes wird ggf. gespiegelt.
+	// first mirror if necessary
 	if ( rChged.GetUseOn() == nsUseOnPage::PD_MIRROR )
 		((SwPageDesc&)rChged).Mirror();
 	else
-		//sonst Werte aus Master nach Left uebertragen.
+		// otherwise transfer the values from Master to Left.
 		::lcl_DescSetAttr( ((SwPageDesc&)rChged).GetMaster(),
 					   ((SwPageDesc&)rChged).GetLeft() );
 
-    //NumType uebernehmen.
+    // take over NumType.
 	if( rChged.GetNumType().GetNumberingType() != pDesc->GetNumType().GetNumberingType() )
 	{
 		pDesc->SetNumType( rChged.GetNumType() );
-		// JP 30.03.99: Bug 64121 - den Seitennummernfeldern bescheid sagen,
-		//		das sich das Num-Format geaendert hat
+		// JP 30.03.99: Bug 64121 - tell it to the page number fields
+		//		that the numbering format has changed
 		GetSysFldType( RES_PAGENUMBERFLD )->UpdateFlds();
 		GetSysFldType( RES_REFPAGEGETFLD )->UpdateFlds();
 
-		// Wenn sich die Numerierungsart geaendert hat, koennte es QuoVadis/
-		// ErgoSum-Texte geben, die sich auf eine geaenderte Seite beziehen,
-		// deshalb werden die Fussnoten invalidiert
+		// When the numbering type has changed, it's possible that there are QuoVadis/
+		// ErgoSum texts, that are referring to a changed page,
+		// therefore the foot notes will be invalidated
 		SwFtnIdxs& rFtnIdxs = GetFtnIdxs();
 		for( sal_uInt16 nPos = 0; nPos < rFtnIdxs.Count(); ++nPos )
 		{
@@ -272,18 +271,18 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 		}
 	}
 
-	//Orientierung uebernehmen
+	// take over the orientation
 	pDesc->SetLandscape( rChged.GetLandscape() );
 
     // #i46909# no undo if header or footer changed
     bool bHeaderFooterChanged = false;
 
-	//Header abgleichen.
+	// align header
 	const SwFmtHeader &rHead = rChged.GetMaster().GetHeader();
     if (undoGuard.UndoWasEnabled())
     {
         // #i46909# no undo if header or footer changed
-		// hat sich an den Nodes etwas veraendert ?
+		// are there changes in the Nodes?
 		const SwFmtHeader &rOldHead = pDesc->GetMaster().GetHeader();
         bHeaderFooterChanged |=
             ( rHead.IsActive() != rOldHead.IsActive() ||
@@ -292,21 +291,20 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
     pDesc->GetMaster().SetFmtAttr( rHead );
 	if ( rChged.IsHeaderShared() || !rHead.IsActive() )
 	{
-		//Left teilt sich den Header mit dem Master.
+		// Left is sharing the Header with the Master
         pDesc->GetLeft().SetFmtAttr( pDesc->GetMaster().GetHeader() );
 	}
 	else if ( rHead.IsActive() )
-	{	//Left bekommt einen eigenen Header verpasst wenn das Format nicht
-		//bereits einen hat.
-		//Wenn er bereits einen hat und dieser auf die gleiche Section
-		//wie der Rechte zeigt, so muss er einen eigenen bekommen. Der
-		//Inhalt wird sinnigerweise kopiert.
+	{	// Left get an own Header, when the Format hasn't one already.
+		// If it has already one and it refers to the same section like the Right,
+		// then it has to get an own Header. The content will be copied accordingly.
+
 		const SwFmtHeader &rLeftHead = pDesc->GetLeft().GetHeader();
 		if ( !rLeftHead.IsActive() )
 		{
             SwFmtHeader aHead( MakeLayoutFmt( RND_STD_HEADERL, 0 ) );
             pDesc->GetLeft().SetFmtAttr( aHead );
-			//Weitere Attribute (Raender, Umrandung...) uebernehmen.
+			// take over further attributes (margins, borders ...)
 			::lcl_DescSetAttr( *rHead.GetHeaderFmt(), *aHead.GetHeaderFmt(), sal_False);
 		}
 		else
@@ -321,9 +319,8 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 				SwFrmFmt *pFmt = new SwFrmFmt( GetAttrPool(), "Header",
 												GetDfltFrmFmt() );
 				::lcl_DescSetAttr( *pRight, *pFmt, sal_False );
-				//Der Bereich auf den das rechte Kopfattribut zeigt wird
-				//kopiert und der Index auf den StartNode in das linke
-				//Kopfattribut gehaengt.
+				// The section that refers to the right head attribute will be copied and
+				// the index on the StartNode will be attached into the left head attribute.
 				SwNodeIndex aTmp( GetNodes().GetEndOfAutotext() );
 				SwStartNode* pSttNd = GetNodes().MakeEmptySection( aTmp, SwHeaderStartNode );
 				SwNodeRange aRange( aRCnt.GetCntntIdx()->GetNode(), 0,
@@ -342,12 +339,12 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 	}
 	pDesc->ChgHeaderShare( rChged.IsHeaderShared() );
 
-	//Footer abgleichen.
+	// align footer
 	const SwFmtFooter &rFoot = rChged.GetMaster().GetFooter();
     if (undoGuard.UndoWasEnabled())
     {
         // #i46909# no undo if header or footer changed
-		// hat sich an den Nodes etwas veraendert ?
+		// are there changes in the Nodes?
         const SwFmtFooter &rOldFoot = pDesc->GetMaster().GetFooter();
         bHeaderFooterChanged |=
             ( rFoot.IsActive() != rOldFoot.IsActive() ||
@@ -355,20 +352,18 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
     }
     pDesc->GetMaster().SetFmtAttr( rFoot );
 	if ( rChged.IsFooterShared() || !rFoot.IsActive() )
-		//Left teilt sich den Header mit dem Master.
+		// Left is sharing the Footer with the Master
         pDesc->GetLeft().SetFmtAttr( pDesc->GetMaster().GetFooter() );
 	else if ( rFoot.IsActive() )
-	{	//Left bekommt einen eigenen Footer verpasst wenn das Format nicht
-		//bereits einen hat.
-		//Wenn er bereits einen hat und dieser auf die gleiche Section
-		//wie der Rechte zeigt, so muss er einen eigenen bekommen. Der
-		//Inhalt wird sinnigerweise kopiert.
+	{	// Left get an own Footer, when the Format hasn't one already.
+		// If it has already one and it refers to the same section like the Right,
+		// then it has to get an own Footer. The content will be copied accordingly.
 		const SwFmtFooter &rLeftFoot = pDesc->GetLeft().GetFooter();
 		if ( !rLeftFoot.IsActive() )
 		{
             SwFmtFooter aFoot( MakeLayoutFmt( RND_STD_FOOTER, 0 ) );
             pDesc->GetLeft().SetFmtAttr( aFoot );
-			//Weitere Attribute (Raender, Umrandung...) uebernehmen.
+			// take over further attributes (margins, borders ...)
 			::lcl_DescSetAttr( *rFoot.GetFooterFmt(), *aFoot.GetFooterFmt(), sal_False);
 		}
 		else
@@ -383,9 +378,8 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 				SwFrmFmt *pFmt = new SwFrmFmt( GetAttrPool(), "Footer",
 												GetDfltFrmFmt() );
 				::lcl_DescSetAttr( *pRight, *pFmt, sal_False );
-				//Der Bereich auf den das rechte Kopfattribut zeigt wird
-				//kopiert und der Index auf den StartNode in das linke
-				//Kopfattribut gehaengt.
+				// The section that refers to the right head attribute will be copied and
+				// the index on the StartNode will be attached into the left head attribute.
 				SwNodeIndex aTmp( GetNodes().GetEndOfAutotext() );
 				SwStartNode* pSttNd = GetNodes().MakeEmptySection( aTmp, SwFooterStartNode );
 				SwNodeRange aRange( aRCnt.GetCntntIdx()->GetNode(), 0,
@@ -406,11 +400,10 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 	if ( pDesc->GetName() != rChged.GetName() )
 		pDesc->SetName( rChged.GetName() );
 
-	// Dadurch wird ein RegisterChange ausgeloest, wenn notwendig
+	// this will trigger a RegisterChange if necessary
 	pDesc->SetRegisterFmtColl( rChged.GetRegisterFmtColl() );
 
-	//Wenn sich das UseOn oder der Follow aendern muessen die
-	//Absaetze das erfahren.
+	// when UseOn or Follow are changed, then the paragraphs have to know this
 	sal_Bool bUseOn  = sal_False;
 	sal_Bool bFollow = sal_False;
 	if ( pDesc->GetUseOn() != rChged.GetUseOn() )
@@ -431,18 +424,17 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 	}
 
 	if ( (bUseOn || bFollow) && pTmpRoot)
-		//Layot benachrichtigen!
+		// notify Layot!
 	{				
 		std::set<SwRootFrm*> aAllLayouts = GetAllLayouts();
 		std::for_each( aAllLayouts.begin(), aAllLayouts.end(),std::mem_fun(&SwRootFrm::AllCheckPageDescs));//swmod 080304
 	}
 
-	//Jetzt noch die Seiten-Attribute uebernehmen.
+	// now take over the page attributes
 	::lcl_DescSetAttr( rChged.GetMaster(), pDesc->GetMaster() );
 	::lcl_DescSetAttr( rChged.GetLeft(), pDesc->GetLeft() );
 
-	//Wenn sich FussnotenInfo veraendert, so werden die Seiten
-	//angetriggert.
+	// when FootnotesInfo are changed, then trigger the pages
 	if( !(pDesc->GetFtnInfo() == rChged.GetFtnInfo()) )
 	{
 		pDesc->SetFtnInfo( rChged.GetFtnInfo() );
@@ -479,10 +471,11 @@ void SwDoc::ChgPageDesc( sal_uInt16 i, c
 |*
 |*	SwDoc::DelPageDesc()
 |*
-|* 	Beschreibung		Alle Descriptoren, deren Follow auf den zu loeschenden
-|*		zeigen muessen angepasst werden.
-|*	Ersterstellung		MA 25. Jan. 93
-|*	Letzte Aenderung	JP 04.09.95
+|* 	Description		All descriptors have to be adapted whose Follow
+|*				refers to the one that has to be deleted.
+|*		
+|*	Created			MA 25. Jan. 93
+|*	Last change		JP 04.09.95
 |*
 |*************************************************************************/
 
@@ -551,8 +544,8 @@ void SwDoc::BroadcastStyleOperation(Stri
 
 void SwDoc::DelPageDesc( sal_uInt16 i, sal_Bool bBroadcast )
 {
-	ASSERT( i < aPageDescs.Count(), "PageDescs ueberindiziert." );
-	ASSERT( i != 0, "Default Pagedesc loeschen is nicht." );
+	ASSERT( i < aPageDescs.Count(), "PageDescs are over-indexed." );
+	ASSERT( i != 0, "Default Pagedesc cannot be deleted." );
 	if ( i == 0 )
 		return;
 
@@ -583,8 +576,8 @@ void SwDoc::DelPageDesc( sal_uInt16 i, s
 |*
 |*	SwDoc::MakePageDesc()
 |*
-|*	Ersterstellung		MA 25. Jan. 93
-|*	Letzte Aenderung	MA 20. Aug. 93
+|*	Created			MA 25. Jan. 93
+|*	Last change		MA 20. Aug. 93
 |*
 |*************************************************************************/
 
@@ -606,7 +599,7 @@ sal_uInt16 SwDoc::MakePageDesc( const St
 	else
 	{
 		pNew = new SwPageDesc( rName, GetDfltFrmFmt(), this );
-		//Default-Seitenformat einstellen.
+		// set default page format
         lcl_DefaultPageFmt( USHRT_MAX, pNew->GetMaster(), pNew->GetLeft() );
 		
 		SvxFrameDirection aFrameDirection = bRegardLanguage ?
@@ -651,15 +644,15 @@ SwPageDesc* SwDoc::FindPageDescByName( c
 }
 
 /******************************************************************************
- *  Methode     :   void SwDoc::PrtDataChanged()
- *	Beschreibung:
- *	Erstellt	:	OK 27.10.94 10:20
- *	Aenderung	:	MA 26. Mar. 98
+ *	Method			void SwDoc::PrtDataChanged()
+ *	Description
+ *	Created			OK 27.10.94 10:20
+ *	Last change		MA 26. Mar. 98
  ******************************************************************************/
 
 void SwDoc::PrtDataChanged()
 {
-//!!!!!!!! Bei Aenderungen hier bitte ggf. InJobSetup im Sw3io mitpflegen
+//!!!!!!!! In case of changes please look after InJobSetup in Sw3io if necessary
 
     // --> FME 2005-01-21 #i41075#
     ASSERT( get(IDocumentSettingAccess::USE_VIRTUAL_DEVICE) ||
@@ -727,11 +720,11 @@ void SwDoc::PrtDataChanged()
 	delete pWait;
 }
 
-//Zur Laufzeit sammeln wir die GlobalNames der Server, die keine
-//Benachrichtigung zu Druckerwechseln wuenschen. Dadurch sparen wir
-//das Laden vieler Objekte (gluecklicherweise werden obendrein alle
-//Fremdobjekte unter einer ID abgebuildet). Init und DeInit vom Array
-//ist in init.cxx zu finden.
+// At run time collect the GlobalNames of the server that don't want
+// to be notified when printer have changed.
+// Due to this many objects don't need to be loaded (luckily on top of
+// this all alien objects are mapped to a single ID). Init and DeInit
+// of the array can be found in init.cxx.
 extern SvPtrarr *pGlobalOLEExcludeList;
 
 void SwDoc::PrtOLENotify( sal_Bool bAll )
@@ -751,11 +744,10 @@ void SwDoc::PrtOLENotify( sal_Bool bAll
 	}	//swmod 071107//swmod 071225
 	if ( !pShell )
 	{
-		//Das hat ohne Shell und damit ohne Client keinen Sinn, weil nur darueber
-		//die Kommunikation bezueglich der Groessenaenderung implementiert ist.
-		//Da wir keine Shell haben, merken wir uns diesen unguenstigen
-		//Zustand am Dokument, dies wird dann beim Erzeugen der ersten Shell
-		//nachgeholt.
+		// This doesn't make sense without Shell and therefore without Client because
+		// communication relating to change in size is implemented only in this way.
+		// As there is no Shell, note this unfavorable status in the Document, this
+		// will be catched up when creating the first Shell.
 		mbOLEPrtNotifyPending = sal_True;
 		if ( bAll )
 			mbAllOLENotify = sal_True;
@@ -781,14 +773,13 @@ void SwDoc::PrtOLENotify( sal_Bool bAll
 				SwOLENode* pOLENd = (*pNodes)[i];
 				pOLENd->SetOLESizeInvalid( sal_False );
 
-				//Ersteinmal die Infos laden und festellen ob das Teil nicht
-				//schon in der Exclude-Liste steht
+				// first load the information and determine whether it is already in the exclude list
 				SvGlobalName aName;
 
                 svt::EmbeddedObjectRef& xObj = pOLENd->GetOLEObj().GetObject();
                 if ( xObj.is() )
                     aName = SvGlobalName( xObj->getClassID() );
-                else  //Noch nicht geladen
+                else  // not yet loaded
 				{
                         // TODO/LATER: retrieve ClassID of an unloaded object
                         // aName = ????
@@ -805,8 +796,8 @@ void SwDoc::PrtOLENotify( sal_Bool bAll
 				if ( bFound )
 					continue;
 
-				//Kennen wir nicht, also muss das Objekt geladen werden.
-				//Wenn es keine Benachrichtigung wuenscht
+				// not known, therefore the object has to be loaded
+				// when notification is not requested
                 if ( xObj.is() )
 				{
                     //TODO/LATER: needs MiscStatus for ResizeOnPrinterChange
@@ -816,7 +807,7 @@ void SwDoc::PrtOLENotify( sal_Bool bAll
 						if ( pOLENd->GetFrm() )
 						{
                             xObj->OnDocumentPrinterChanged( pPrt );
-                            pShell->CalcAndSetScale( xObj );//Client erzeugen lassen.
+                            pShell->CalcAndSetScale( xObj );// create client
 						}
 						else
 							pOLENd->SetOLESizeInvalid( sal_True );
@@ -856,9 +847,9 @@ IMPL_LINK( SwDoc, DoUpdateModifiedOLE, T
 				SwOLENode* pOLENd = (*pNodes)[i];
 				pOLENd->SetOLESizeInvalid( sal_False );
 
-				//Kennen wir nicht, also muss das Objekt geladen werden.
-				//Wenn es keine Benachrichtigung wuenscht
-                if( pOLENd->GetOLEObj().GetOleRef().is() ) //Kaputt?
+				// not known, therefore the object has to be loaded
+				// when notification is not requested
+                if( pOLENd->GetOLEObj().GetOleRef().is() ) // broken?
 				{
                     //TODO/LATER: needs MiscStatus for ResizeOnPrinterChange
                     /*
@@ -868,7 +859,7 @@ IMPL_LINK( SwDoc, DoUpdateModifiedOLE, T
 						if( pOLENd->GetFrm() )
 						{
 							xRef->OnDocumentPrinterChanged( pPrt );
-							pSh->CalcAndSetScale( xRef );//Client erzeugen lassen.
+							pSh->CalcAndSetScale( xRef );// create client
 						}
 						else
 							pOLENd->SetOLESizeInvalid( sal_True );