Documentation updates.

BUGS

+***** this file is horribly outdated - please update ! *****
+
 For information on how to post a useful bug report, please
 read documentation/bugreports.
 
@@ -20,14 +22,14 @@ General:
 
  * Very alpha printing code using win16 drivers.
 
- * Very alpha internal PostScript driver. [h.davies1@physics.ox.ac.uk]
+ * internal PostScript driver not finished. [h.davies1@physics.ox.ac.uk]
 
  * Extremely alpha Win95 interface code (some apps, like Opera, choke on it).
 
  * No OLE2 and OLE32 support (including OLE2 interfaces etc.).
 	 (started work on pidl-handling, IShellFolders IEnumIdLists 
 	 and SH* functions juergen.schmied@metronet.de)	
-	(Corel is working on it)
+	(Corel has been working on it)
 
  * No MS Video support. [just started, marcus@jet.franken.de]
 

include/winnt.h

@@ -2032,44 +2032,44 @@ typedef struct _IMAGE_OPTIONAL_HEADER {
 
   /* Standard fields */
 
-  WORD  Magic;
+  WORD  Magic; /* 0x10b or 0x107 */	/* 0x00 */
   BYTE  MajorLinkerVersion;
   BYTE  MinorLinkerVersion;
   DWORD SizeOfCode;
   DWORD SizeOfInitializedData;
   DWORD SizeOfUninitializedData;
-  DWORD AddressOfEntryPoint;
+  DWORD AddressOfEntryPoint;		/* 0x10 */
   DWORD BaseOfCode;
   DWORD BaseOfData;
 
   /* NT additional fields */
 
   DWORD ImageBase;
-  DWORD SectionAlignment;
+  DWORD SectionAlignment;		/* 0x20 */
   DWORD FileAlignment;
   WORD  MajorOperatingSystemVersion;
   WORD  MinorOperatingSystemVersion;
   WORD  MajorImageVersion;
   WORD  MinorImageVersion;
-  WORD  MajorSubsystemVersion;
+  WORD  MajorSubsystemVersion;		/* 0x30 */
   WORD  MinorSubsystemVersion;
   DWORD Win32VersionValue;
   DWORD SizeOfImage;
   DWORD SizeOfHeaders;
-  DWORD CheckSum;
+  DWORD CheckSum;			/* 0x40 */
   WORD  Subsystem;
   WORD  DllCharacteristics;
   DWORD SizeOfStackReserve;
   DWORD SizeOfStackCommit;
-  DWORD SizeOfHeapReserve;
+  DWORD SizeOfHeapReserve;		/* 0x50 */
   DWORD SizeOfHeapCommit;
   DWORD LoaderFlags;
   DWORD NumberOfRvaAndSizes;
-  IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES];
+  IMAGE_DATA_DIRECTORY DataDirectory[IMAGE_NUMBEROF_DIRECTORY_ENTRIES]; /* 0x60 */
 } IMAGE_OPTIONAL_HEADER, *PIMAGE_OPTIONAL_HEADER;
 
 typedef struct _IMAGE_NT_HEADERS {
-  DWORD Signature;
+  DWORD Signature; /* "PE"\0\0 */
   IMAGE_FILE_HEADER FileHeader;
   IMAGE_OPTIONAL_HEADER OptionalHeader;
 } IMAGE_NT_HEADERS, *PIMAGE_NT_HEADERS;

objects/region.c

@@ -1237,7 +1237,7 @@ INT WINAPI CombineRgn(HRGN hDest, HRGN hSrc1, HRGN hSrc2, INT mode)
 
 	if (src1Obj)
 	{
-	    TRACE("dump:\n");
+	    TRACE("dump src1Obj:\n");
 	    if(TRACE_ON(region)) 
 	      REGION_DumpRegion(src1Obj->rgn);
 	    if (mode == RGN_COPY)
@@ -1251,7 +1251,7 @@ INT WINAPI CombineRgn(HRGN hDest, HRGN hSrc1, HRGN hSrc2, INT mode)
 
 		if (src2Obj)
 		{
-		    TRACE("dump:\n");
+		    TRACE("dump src2Obj:\n");
 		    if(TRACE_ON(region)) 
 		        REGION_DumpRegion(src2Obj->rgn);
 		    switch (mode)
@@ -1275,7 +1275,7 @@ INT WINAPI CombineRgn(HRGN hDest, HRGN hSrc1, HRGN hSrc2, INT mode)
 	    }
 	    GDI_ReleaseObj( hSrc1 );
 	}
-	TRACE("dump:\n");
+	TRACE("dump destObj:\n");
 	if(TRACE_ON(region)) 
 	  REGION_DumpRegion(destObj->rgn);
 

programs/regapi/regapi.c

@@ -169,15 +169,16 @@ static void    processQueryValue(LPSTR cmdline);
  */
 static char helpText[] =
 "NAME\n"
-"          regapi - provide a command line interface to the wine registry.\n"
+"          regapi - perform certain actions on the wine registry.\n"
 "\n"
 "SYNOPSIS\n"
 "          regapi commandName [-force] < file\n"
 "\n"
 "DESCRIPTION\n"
-"          regapi allows editing the wine registry.  It processes the given\n"
-"          commandName for every line in the stdin data stream.  Input data\n"
-"          format may vary depending on the commandName see INPUT FILE FORMAT.\n"
+"          regapi modifies settings in the wine registry.  It processes\n"
+"          the given commandName for every line in the stdin data stream.\n"
+"          Input data format may vary depending on the commandName\n"
+"          (see INPUT FILE FORMAT).\n"
 "\n"
 "OPTIONS\n"
 "          commandName\n"
@@ -997,8 +998,8 @@ static void doUnregisterDLL(LPSTR stdInput) {
 }
 
 /******************************************************************************
- * MAIN - The main simply validate the first parameter (command to perform)
- *        It then read the STDIN lines by lines forwarding their processing
+ * MAIN - WinMain simply validates the first parameter (command to perform)
+ *        It then reads the STDIN lines by lines forwarding their processing
  *        to the appropriate method.
  */
 int PASCAL WinMain (HINSTANCE inst, HINSTANCE prev, LPSTR cmdline, int show)

win32/file.c

@@ -103,7 +103,8 @@ BOOL WINAPI SetFileAttributesA(LPCSTR lpFileName, DWORD attributes)
     if (-1==chmod(full_name.long_name,buf.st_mode))
     {
         FILE_SetDosError();
-        MESSAGE("Wine ERROR: Couldn't set file attributes for existing file \"%s\". Check permissions or set VFAT \"quiet\" flag !\n", full_name.long_name);
+        MESSAGE("Wine ERROR: Couldn't set file attributes for existing file \"%s\".\n"
+                "Check permissions or set VFAT \"quiet\" mount flag\n", full_name.long_name);
         return TRUE;
     }
     return TRUE;