Translated German comments to English in folder 'sal'.

sal/qa/rtl_strings/rtl_old_testostring.cxx contains some German comments still
but the code itself uses test strings in German. When the test strings appear
in the comments, they were left unchanged to maintain consistency.

Mark Wolf

4 files changed, 98 insertions, 105 deletions

diff --git a/sal/workben/clipboardwben/testcopy/cbcpytest.cxx b/sal/workben/clipboardwben/testcopy/cbcpytest.cxx
index 7e84811de512..3e970c482397 100644
--- a/sal/workben/clipboardwben/testcopy/cbcpytest.cxx
+++ b/sal/workben/clipboardwben/testcopy/cbcpytest.cxx
@@ -27,7 +27,7 @@
  ************************************************************************/
 
 
-// TestWin32.cpp : Definiert den Einsprungpunkt für die Anwendung.
+// TestWin32.cpp : Defines the entry point for the application.
 //
 
 #define _WIN32_DCOM
@@ -54,10 +54,10 @@
 
 #define MSG_FLUSHCLIPBOARD WM_USER + 1
 
-// Globale Variablen:
-HINSTANCE           hInst;                      // aktuelle Instanz
-TCHAR               szTitle[MAX_LOADSTRING];            // Text der Titelzeile
-TCHAR               szWindowClass[MAX_LOADSTRING];  // Text der Titelzeile
+// Global variables:
+HINSTANCE           hInst;                      // current instance
+TCHAR               szTitle[MAX_LOADSTRING];            // Text of the title
+TCHAR               szWindowClass[MAX_LOADSTRING];  // Text of the title
 ATOM                MyRegisterClass( HINSTANCE hInstance );
 BOOL                InitInstance( HINSTANCE, int );
 LRESULT CALLBACK    WndProc( HWND, UINT, WPARAM, LPARAM );
@@ -100,7 +100,7 @@ int APIENTRY WinMain(HINSTANCE hInstance,
                      LPSTR     lpCmdLine,
                      int       nCmdShow )
 {
-     // ZU ERLEDIGEN: Fügen Sie hier den Code ein.
+    // TODO: Add code here.
     MSG     msg;
     HACCEL  hAccelTable;
     HRESULT hr = E_FAIL;
@@ -114,12 +114,12 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 #endif
 
 
-    // Globale Zeichenfolgen initialisieren
+    // Initialize global strings
     LoadString(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
     LoadString(hInstance, IDC_TESTWIN32, szWindowClass, MAX_LOADSTRING);
     MyRegisterClass(hInstance);
 
-    // Initialisierung der Anwendung durchführen:
+    // Initialization of the applications to carry out:
     if( !InitInstance( hInstance, nCmdShow ) )
     {
         return FALSE;
@@ -127,7 +127,7 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
     hAccelTable = LoadAccelerators(hInstance, (LPCTSTR)IDC_TESTWIN32);
 
-    // Hauptnachrichtenschleife:
+    // Main message loop:
     while( GetMessage(&msg, NULL, 0, 0) )
     {
         if( !TranslateAccelerator (msg.hwnd, hAccelTable, &msg) )
@@ -152,17 +152,15 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
 
 //----------------------------------------------------------------
-//  FUNKTION: MyRegisterClass()
+//  FUNCTION: MyRegisterClass()
 //
-//  AUFGABE: Registriert die Fensterklasse.
+//  PURPOSE: Registers the window class.
 //
-//  KOMMENTARE:
-//
-//    Diese Funktion und ihre Verwendung sind nur notwendig, wenn dieser Code
-//    mit Win32-Systemen vor der 'RegisterClassEx'-Funktion kompatibel sein soll,
-//    die zu Windows 95 hinzugefügt wurde. Es ist wichtig diese Funktion aufzurufen,
-//    damit der Anwendung kleine Symbole mit den richtigen Proportionen zugewiesen
-//    werden.
+//  COMMENTS:
+//    This function and its usage are only necessary if this code
+//    needs to be compatible with Win32 systems prior to 'RegisterClassEx'
+//    function, which was added to Windows 95. If it important to call
+//    this function to allow the use of small icons in the correct proportions.
 //----------------------------------------------------------------
 
 ATOM MyRegisterClass( HINSTANCE hInstance )
@@ -187,19 +185,18 @@ ATOM MyRegisterClass( HINSTANCE hInstance )
 }
 
 //----------------------------------------------------------------
-//   FUNKTION: InitInstance(HANDLE, int)
-//
-//   AUFGABE: Speichert die Instanzzugriffsnummer und erstellt das Hauptfenster
+//   FUNCTION: InitInstance(HANDLE, int)
 //
-//   KOMMENTARE:
+//   PURPOSE: Saves instance access number and creates main window
 //
-//        In dieser Funktion wird die Instanzzugriffsnummer in einer globalen Variable
-//        gespeichert und das Hauptprogrammfenster erstellt und angezeigt.
+//   Comments:
+//        In this function, the instance access number is stored in a global variable
+//        and the main program window is displayed.
 //----------------------------------------------------------------
 
 BOOL InitInstance( HINSTANCE hInstance, int nCmdShow )
 {
-   hInst = hInstance; // Instanzzugriffsnummer in unserer globalen Variable speichern
+   hInst = hInstance; // Store instance access number in our global variable.
 
    g_hWnd = CreateWindowEx(0, szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
       CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, hInstance, NULL);
@@ -216,13 +213,13 @@ BOOL InitInstance( HINSTANCE hInstance, int nCmdShow )
 }
 
 //----------------------------------------------------------------
-//  FUNKTION: WndProc(HWND, unsigned, WORD, LONG)
+//  FUNCTION: WndProc(HWND, unsigned, WORD, LONG)
 //
-//  AUFGABE:  Verarbeitet Nachrichten für das Hauptfenster.
+//  PURPOSE: Processes messages for the main window.
 //
-//  WM_COMMAND  - Anwendungsmenü verarbeiten
-//  WM_PAINT    - Hauptfenster darstellen
-//  WM_DESTROY  - Beendigungsnachricht ausgeben und zurückkehren
+//  WM_COMMAND  - Handle application menu
+//  WM_PAINT    - Display main windows
+//  WM_DESTROY  - Output completion message and return
 //----------------------------------------------------------------
 
 LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
@@ -239,7 +236,7 @@ LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
     {
         case WM_COMMAND:
             wmId    = LOWORD(wParam);
-            // Menüauswahlen analysieren:
+            // Analyze menu selections:
             switch( wmId )
             {
                 case IDD_COPY:
@@ -262,7 +259,7 @@ LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
 
         case WM_PAINT:
             hdc = BeginPaint (hWnd, &ps);
-            // ZU ERLEDIGEN: Hier beliebigen Code zum Zeichnen hinzufügen...
+            // TODO: Add any code for drawing
             RECT rt;
             GetClientRect( hWnd, &rt );
 
diff --git a/sal/workben/clipboardwben/testpaste/cbptest.cxx b/sal/workben/clipboardwben/testpaste/cbptest.cxx
index 695ab9752ca8..06440d9eff3f 100644
--- a/sal/workben/clipboardwben/testpaste/cbptest.cxx
+++ b/sal/workben/clipboardwben/testpaste/cbptest.cxx
@@ -27,7 +27,7 @@
  ************************************************************************/
 
 
-// TestWin32.cpp : Definiert den Einsprungpunkt für die Anwendung.
+// TestWin32.cpp : Defines the entry point for the application
 //
 
 #define _WIN32_DCOM
@@ -49,10 +49,10 @@
 
 #define MAX_LOADSTRING 100
 
-// Globale Variablen:
-HINSTANCE           hInst;                      // aktuelle Instanz
-WCHAR               szTitle[MAX_LOADSTRING];            // Text der Titelzeile
-WCHAR               szWindowClass[MAX_LOADSTRING];  // Text der Titelzeile
+// Global variables:
+HINSTANCE           hInst;                      // current instance
+WCHAR               szTitle[MAX_LOADSTRING];            // Text for title
+WCHAR               szWindowClass[MAX_LOADSTRING];  // Text for title
 ATOM                MyRegisterClass( HINSTANCE hInstance );
 BOOL                InitInstance( HINSTANCE, int );
 LRESULT CALLBACK    WndProc( HWND, UINT, WPARAM, LPARAM );
@@ -137,7 +137,7 @@ int APIENTRY WinMain(HINSTANCE hInstance,
                      LPSTR     lpCmdLine,
                      int       nCmdShow )
 {
-     // ZU ERLEDIGEN: Fügen Sie hier den Code ein.
+    // TODO: Add code here.
     MSG     msg;
     HACCEL  hAccelTable;
     HRESULT hr = E_FAIL;
@@ -148,12 +148,12 @@ int APIENTRY WinMain(HINSTANCE hInstance,
     hr = CoInitializeEx( NULL, COINIT_MULTITHREADED );
     //hr = CoInitializeEx( NULL, COINIT_APARTMENTTHREADED );
 
-    // Globale Zeichenfolgen initialisieren
+    // Initialize global strings
     LoadStringW(hInstance, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
     LoadStringW(hInstance, IDC_TESTWIN32, szWindowClass, MAX_LOADSTRING);
     MyRegisterClass(hInstance);
 
-    // Initialisierung der Anwendung durchführen:
+    // Initialization of the application to perform:
     if( !InitInstance( hInstance, nCmdShow ) )
     {
         return FALSE;
@@ -161,7 +161,7 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
     hAccelTable = LoadAccelerators(hInstance, (LPCTSTR)IDC_TESTWIN32);
 
-    // Hauptnachrichtenschleife:
+    // Main message loop:
     while( GetMessage(&msg, NULL, 0, 0) )
     {
         if( !TranslateAccelerator (msg.hwnd, hAccelTable, &msg) )
@@ -181,18 +181,16 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
 
 //
-//  FUNKTION: MyRegisterClass()
+//  FUNCTION: MyRegisterClass()
 //
-//  AUFGABE: Registriert die Fensterklasse.
-//
-//  KOMMENTARE:
-//
-//    Diese Funktion und ihre Verwendung sind nur notwendig, wenn dieser Code
-//    mit Win32-Systemen vor der 'RegisterClassEx'-Funktion kompatibel sein soll,
-//    die zu Windows 95 hinzugefügt wurde. Es ist wichtig diese Funktion aufzurufen,
-//    damit der Anwendung kleine Symbole mit den richtigen Proportionen zugewiesen
-//    werden.
+//  PURPOSE: Registers the window class
 //
+//  COMMENTS:
+//    This function and its usage are only necessary if this code
+//    needs to be compatible with Win32 systems prior to 'RegisterClassEx'
+//    function, which was added to Windows 95. If it important to call
+//    this function to allow the use of small icons in the correct proportions.
+
 ATOM MyRegisterClass( HINSTANCE hInstance )
 {
     WNDCLASSEXW wcex;
@@ -215,20 +213,19 @@ ATOM MyRegisterClass( HINSTANCE hInstance )
 }
 
 //
-//   FUNKTION: InitInstance(HANDLE, int)
+//   FUNCTION: InitInstance(HANDLE, int)
 //
-//   AUFGABE: Speichert die Instanzzugriffsnummer und erstellt das Hauptfenster
+//   PURPOSE: Saves instance handle and creates main window
 //
-//   KOMMENTARE:
-//
-//        In dieser Funktion wird die Instanzzugriffsnummer in einer globalen Variable
-//        gespeichert und das Hauptprogrammfenster erstellt und angezeigt.
+//   COMMENTS:
+//        In this function, the instance access number is stored in a global variable
+//        and the main program window is displayed.
 //
 BOOL InitInstance( HINSTANCE hInstance, int nCmdShow )
 {
    HWND hWnd;
 
-   hInst = hInstance; // Instanzzugriffsnummer in unserer globalen Variable speichern
+   hInst = hInstance; // Store instance access number in our global variable
 
    hWnd = CreateWindowExW(0, szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
       CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, hInstance, NULL);
@@ -245,15 +242,15 @@ BOOL InitInstance( HINSTANCE hInstance, int nCmdShow )
 }
 
 //
-//  FUNKTION: WndProc(HWND, unsigned, WORD, LONG)
-//
-//  AUFGABE:  Verarbeitet Nachrichten für das Hauptfenster.
+//  FUNCTION: WndProc(HWND, unsigned, WORD, LONG)
 //
-//  WM_COMMAND  - Anwendungsmenü verarbeiten
-//  WM_PAINT    - Hauptfenster darstellen
-//  WM_DESTROY  - Beendigungsnachricht ausgeben und zurückkehren
+//  PURPOSE: Processes messages for the main window.
 //
+//  WM_COMMAND  - Handle application menu
+//  WM_PAINT    - Display main windows
+//  WM_DESTROY  - Output completion message and return
 //
+
 LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
 {
     int         wmId;
@@ -268,7 +265,7 @@ LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
     {
         case WM_COMMAND:
             wmId    = LOWORD(wParam);
-            // Menüauswahlen analysieren:
+            // Analyze menu selections
             switch( wmId )
             {
                 case IDD_PASTE:
@@ -287,7 +284,7 @@ LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
 
         case WM_PAINT:
             hdc = BeginPaint (hWnd, &ps);
-            // ZU ERLEDIGEN: Hier beliebigen Code zum Zeichnen hinzufügen...
+            // TODO: Add any code for drawing
             RECT rt;
             GetClientRect( hWnd, &rt );
 
diff --git a/sal/workben/clipboardwben/testviewer/cbvtest.cxx b/sal/workben/clipboardwben/testviewer/cbvtest.cxx
index 4608dad205e3..8e1a05ebb04c 100644
--- a/sal/workben/clipboardwben/testviewer/cbvtest.cxx
+++ b/sal/workben/clipboardwben/testviewer/cbvtest.cxx
@@ -27,7 +27,7 @@
  ************************************************************************/
 
 
-// TestWin32.cpp : Definiert den Einsprungpunkt für die Anwendung.
+// TestWin32.cpp : Defines the entry point for the application.
 //
 
 #define _WIN32_DCOM
@@ -50,11 +50,11 @@
 
 #define MAX_LOADSTRING 100
 
-// Globale Variablen:
-HINSTANCE           g_hInst;                        // aktuelle Instanz
+// Global variables:
+HINSTANCE           g_hInst;                        // current instance
 HWND                g_hwndMain;
-WCHAR               szTitle[MAX_LOADSTRING];            // Text der Titelzeile
-WCHAR               szWindowClass[MAX_LOADSTRING];  // Text der Titelzeile
+WCHAR               szTitle[MAX_LOADSTRING];            // Text for title
+WCHAR               szWindowClass[MAX_LOADSTRING];  // Text for title
 LPSTREAM            g_pStm    = NULL;
 char*               pTextBuff = NULL;
 DWORD               lData     = 0;
@@ -83,7 +83,7 @@ int APIENTRY WinMain(HINSTANCE hInstance,
                      LPSTR     lpCmdLine,
                      int       nCmdShow )
 {
-     // ZU ERLEDIGEN: Fügen Sie hier den Code ein.
+    // TODO: Add code here.
     MSG     msg;
     HACCEL  hAccelTable;
     HRESULT hr = E_FAIL;
@@ -95,12 +95,12 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
     g_hInst = hInstance;
 
-    // Globale Zeichenfolgen initialisieren
+    // Initialize global strings
     LoadStringW(g_hInst, IDS_APP_TITLE, szTitle, MAX_LOADSTRING);
     LoadStringW(g_hInst, IDC_TESTWIN32, szWindowClass, MAX_LOADSTRING);
     MyRegisterClass(g_hInst);
 
-    // Initialisierung der Anwendung durchführen:
+    // Initialization of the applications to carry out
     if( !InitInstance( g_hInst, nCmdShow ) )
     {
         return FALSE;
@@ -108,7 +108,7 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
     hAccelTable = LoadAccelerators(hInstance, (LPCTSTR)IDC_TESTWIN32);
 
-    // Hauptnachrichtenschleife:
+    // Main message loop:
     while( GetMessage(&msg, NULL, 0, 0) )
     {
         if( !TranslateAccelerator (msg.hwnd, hAccelTable, &msg) )
@@ -128,17 +128,15 @@ int APIENTRY WinMain(HINSTANCE hInstance,
 
 
 //
-//  FUNKTION: MyRegisterClass()
+//  FUNCTION: MyRegisterClass()
 //
-//  AUFGABE: Registriert die Fensterklasse.
+//  PURPOSE: Registers the window class.
 //
-//  KOMMENTARE:
-//
-//    Diese Funktion und ihre Verwendung sind nur notwendig, wenn dieser Code
-//    mit Win32-Systemen vor der 'RegisterClassEx'-Funktion kompatibel sein soll,
-//    die zu Windows 95 hinzugefügt wurde. Es ist wichtig diese Funktion aufzurufen,
-//    damit der Anwendung kleine Symbole mit den richtigen Proportionen zugewiesen
-//    werden.
+//  COMMENTS:
+//    This function and its usage are only necessary if this code
+//    needs to be compatible with Win32 systems prior to 'RegisterClassEx'
+//    function, which was added to Windows 95. If it important to call
+//    this function to allow the use of small icons in the correct proportions.
 //
 ATOM MyRegisterClass( HINSTANCE hInstance )
 {
@@ -164,13 +162,13 @@ ATOM MyRegisterClass( HINSTANCE hInstance )
 //
 //   FUNKTION: InitInstance(HANDLE, int)
 //
-//   AUFGABE: Speichert die Instanzzugriffsnummer und erstellt das Hauptfenster
-//
-//   KOMMENTARE:
+//   PURPOSE: Saves instance access number and creates main window
 //
-//        In dieser Funktion wird die Instanzzugriffsnummer in einer globalen Variable
-//        gespeichert und das Hauptprogrammfenster erstellt und angezeigt.
+//   Comments:
+//        In this function, the instance access number is stored in a global variable
+//        and the main program window is displayed.
 //
+
 BOOL InitInstance( HINSTANCE hInstance, int nCmdShow )
 {
    g_hwndMain = CreateWindowExW(0, szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
@@ -190,12 +188,13 @@ BOOL InitInstance( HINSTANCE hInstance, int nCmdShow )
 //
 //  FUNKTION: WndProc(HWND, unsigned, WORD, LONG)
 //
-//  AUFGABE:  Verarbeitet Nachrichten für das Hauptfenster.
+//  FUNCTION: WndProc(HWND, unsigned, WORD, LONG)
 //
-//  WM_COMMAND  - Anwendungsmenü verarbeiten
-//  WM_PAINT    - Hauptfenster darstellen
-//  WM_DESTROY  - Beendigungsnachricht ausgeben und zurückkehren
+//  PURPOSE: Processes messages for the main window.
 //
+//  WM_COMMAND  - Handle application menu
+//  WM_PAINT    - Display main windows
+//  WM_DESTROY  - Output completion message and return
 //
 LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
 {
@@ -215,7 +214,7 @@ LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
 
         case WM_COMMAND:
             wmId    = LOWORD(wParam);
-            // Menüauswahlen analysieren:
+            // Analyze menu selections:
             switch( wmId )
             {
                 case IDD_CBVIEWER:
@@ -234,7 +233,7 @@ LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
 
         case WM_PAINT:
             hdc = BeginPaint (hWnd, &ps);
-            // ZU ERLEDIGEN: Hier beliebigen Code zum Zeichnen hinzufügen...
+            // TODO: Add any code for drawing
             RECT rt;
             GetClientRect( hWnd, &rt );
 
diff --git a/sal/workben/testpipe.cxx b/sal/workben/testpipe.cxx
index ca54b176e33c..4b3f1a6a199a 100644
--- a/sal/workben/testpipe.cxx
+++ b/sal/workben/testpipe.cxx
@@ -36,7 +36,7 @@
 #include <osl/process.h>
 #include <rtl/ustring.h>
 
-// eindeutiger Name f�r die Pipe
+// clear Name for the Pipe
 const char pszPipeName[] = "TestPipe";
 const char szTestString[] = "This is a test";
 char       szBuffer[256];
@@ -64,12 +64,12 @@ void fail( const char * pszText, int retval )
 
 
 /*
- * Teste die Pipe-Implementation in osl
+ * Test the Pipe-Implementation in osl
  */
 
 int main (int argc, const char *argv[])
 {
-    // erzeuge die Pipe
+    // create the Pipe
     rtl_uString* ustrPipeName=0;
     rtl_uString* ustrExeName=0;
 
@@ -83,7 +83,7 @@ int main (int argc, const char *argv[])
         fail( "unable to create Pipe.\n",
               osl_getLastPipeError(NULL));
 
-    // starte client process
+    // start client process
     ProcessError = osl_executeProcess( ustrExeName,
                                        NULL,
                                        0,
@@ -116,14 +116,14 @@ int main (int argc, const char *argv[])
         n  = sizeof(szTestString);
     }
 
-    // sende TestString zum Client
+    // send TestString to Client
     nChars = osl_sendPipe( C1Pipe, cp, n );
 
     if( nChars < 0 )
         fail( "unable to write on pipe.\n",
               osl_getLastPipeError( Pipe ) );
 
-    // empfange Daten vom Server
+    // receive data from the server
     nChars = osl_receivePipe( C1Pipe, szBuffer, 256 );
 
     if( nChars < 0 )
@@ -132,14 +132,14 @@ int main (int argc, const char *argv[])
 
     printf( "TestPipe Server: received data: %s.\n", szBuffer );
 
-    // warte bis das Client-Programm sich beendet
+    // wait until the client-program terminates
     ProcessError = osl_joinProcess( Process );
 
     if( ProcessError != osl_Process_E_None )
         fail( "unable to wait for client.\n",
               ProcessError );
 
-    // ermittle den R�ckgabewert des Client-Programms
+    // investigate the return-value of the client-program
     ProcessInfo.Size = sizeof( ProcessInfo );
 
     ProcessError = osl_getProcessInfo( Process, osl_Process_EXITCODE, &ProcessInfo );
@@ -151,10 +151,10 @@ int main (int argc, const char *argv[])
     if( ProcessInfo.Code != 0 )
         fail( "client aborted.\n", ProcessInfo.Code );
 
-    // gib das Handle fuer den Client-Prozess frei
+    // give the handle for the free client-process
     osl_freeProcessHandle( Process );
 
-    // schliesse die Pipes
+    // close the pipes
     osl_releasePipe( C1Pipe );
     osl_releasePipe( Pipe );