DOCUMENT:Q101908 25-SEP-1999 [win95x] TITLE :Comprehensive List of WRK Version 3.1 Doc Errors, Part 2 PRODUCT :Microsoft Windows 95.x Retail Product PROD/VER:WINDOWS:3.1,3.11 OPER/SYS: KEYWORDS: ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft Windows versions 3.1, 3.11 ------------------------------------------------------------------------------- SUMMARY ======= This article contains a comprehensive list of documentation errors in the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1. This article covers errors on pages 200-501 of the guide. - Page 220 Incorrectly Places Order= Line in the PROGMAN.INI - Page 220 Incorrectly Describes Window= Line - Page 239 Incorrectly References CommandEnvSize Variable - Page 244 Incorrectly States Permanent Swap File Name - Page 244 Incorrectly States Can't Create a Permanent Swap File with Stacker - Page 248 Incorrectly Describes Windows 3.1 Support for VCPI - Page 262 Doesn't Mention 32-Bit Disk Access - Page 269 Translation Buffer Information Is Incorrect - Page 310 Incorrectly References Character Map Information - Page 317 Chart Incorrectly States Vector Fonts Can't Print - Page 317 Doesn't List Wingdings as an Installed Font - Page 324 Incorrectly States PFM Editor Kit Available From PSS - Page 327 Incorrectly Describes How to Create FINSTALL.DIR File - Page 334 Incorrectly References Virtual Printer Memory Information - Page 337 Incorrectly Describes Changing TrueType Names - Page 343 and page 348 Incorrectly State COM Addresses - Page 348 Provides Incorrect Examples of MODE Command - Page 388 Incorrectly Describes Logging On/Off Novell Server - Page 391 Incorrectly States the Requirements for IRQ 2 Setting - Page 398 Incorrectly Describes How to Make a Boot Disk - Page 414 Incorrectly States SMARTDRV.EXE Must Load Low - Page 419 HIMEM.SYS Machine-Type Chart Incorrect - Page 440 Shows Incorrect Menu Bar for Network Assistant Utility - Page 441 Incorrectly States Use F1 to Activate SMARTMON Help - Page 444 Incorrectly States Audio Drivers Available with WRK - Page 500 Incorrectly States README.WRI Contents - Page 501 Incorrectly Describes Removing Unused Fonts - Page 526 Incorrectly Indexes DDE Definition MORE INFORMATION ================ Page 220 Incorrectly Places Order= Line in the PROGMAN.INI ---------------------------------------------------------- On page 220 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1, the Order= line of the PROGMAN.INI file is incorrectly placed under the [Groups] section. The Order= line should be under the [Settings] section. The WRK guide lists the order= line as follows: [Groups] order=1 2 3 4 5 The correct placement is as follows: [Settings] order=1 2 3 4 5 Page 220 Incorrectly Describes Window= Line ------------------------------------------- On page 220 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1, the Window= line value incorrectly states: Four numbers that indicate the position of the window when Program Manager is opened, followed by a 1 if the window is maximized. The number 1 should be a 3 to indicate a maximized window. Page 239 Incorrectly References CommandEnvSize Variable ------------------------------------------------------- Page 239 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly states: Windows 386 Enhanced mode provides access to extended memory for non-Windows applications by creating virtual machines up to 640k in size, or the size defined by the CommandEnvSize= entry in the [NonWindowsApp] section of the SYSTEM.INI. This is incorrect because CommandEnvSize is only used to specify the COMMAND.COM environment size. Page 244 Incorrectly States Permanent Swap File Name ---------------------------------------------------- Page 244 of the "Microsoft Windows Resource Kit" (WRK) guide for Windows 3.1 incorrectly identifies the permanent swap file in the following line: A permanent swap file is a hidden file named 386PART.PAR... The correct name of the permanent swap file is 386SPART.PAR. Page 244 Incorrectly States Can't Create a Permanent Swap File with Stacker --------------------------------------------------------------------------- On page 244 of the Windows Resource Kit (WRK) guide for version 3.1, the "Creating Swap Files for Virtual Memory" section incorrectly states the following: You cannot create a permanent swap file if Stacker is running on your system. You can create a permanent swap file when Stacker is running on your system properly as specified by Stacker. The correct statement should read as follows: You cannot create a permanent swap file on a compressed (Stacked) drive since an uncompressed contiguous space is required for a permanent swap file. Page 248 Incorrectly Describes Windows 3.1 Support for VCPI ----------------------------------------------------------- The "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly states on page 248: Windows 3.1 supports VCPI in both standard mode and 386 enhanced mode. Windows 3.1 is a Virtual Control Program Interface (VCPI) client in standard mode (using DOSX.EXE). Windows 3.1 in 386 enhanced mode is a DOS Protected Mode Interface (DPMI) server (using WIN386.EXE); it does not support VCPI. It is possible to run some VCPI applications in standard mode. It is not possible to run VCPI applications in 386 enhanced mode. Page 262 Doesn't Mention 32-Bit Disk Access ------------------------------------------- The "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 should include the following item in the subheading titled "To ensure optimal speed performance" on page 262: Use 32-bit disk access to speed up the access time to hard disk. For a technical discussion of this feature, see "An Introduction to 32-Bit Disk Access" in Appendix D. Chapter 6 of WRK is dedicated to Windows performance tips. 32-bit disk access is a speed enhancement feature in Windows 3.1. 32-bit disk access is a device driver that allows Windows to talk directly to the hard disk. Windows 3.1 supports the industrial standards introduced by Western Digital 1003 controllers. If your hard disk controller is not Western Digital 1003 compatible, you do not have this option available in Windows. Page 269 Translation Buffer Information Is Incorrect ---------------------------------------------------- Page 269 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 gives inaccurate instructions for placing the 386 enhanced mode translation buffers in the upper memory area (UMA). Paragraph 3 of the section titled "Freeing Conventional Memory in 386 Enhanced Mode" states: Then add an x= switch to the EMM386 line in the CONFIG.SYS to exclude the unused UMB ranges. Other information in this section indicates that Windows 3.1 uses these excluded ranges for placement of the translation buffers. This is incorrect; any UMAs excluded by an upper memory block (UMB) provider are also excluded from use by Windows 3.1. Windows running in 386 enhanced mode queries any UMB provider (such as EMM386.EXE, QEMM, and 386MAX) for information about the UMB area. Page 310 Incorrectly References Character Map Information --------------------------------------------------------- Page 310 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 contains the following statement: For details about special character sets in Windows, see Appendix A, "Special Characters," in the "Windows User's Guide." This is incorrect. Appendix A is actually titled "Windows and Networks." Information on inserting special characters can be found in the Character Map section of Chapter 12, "Additional Accessories," on pages 447-449 of the "Microsoft Windows User's Guide." Unlike the "Windows User's Guide" for version 3.0, no reference table for any kind of special characters is included in the Windows 3.1 manual. Appendix B in the Windows 3.0 manual contains the table references for the special character codes (that is, ANSI and IBM PC). Windows 3.1 users can use Character Map to reproduce any special characters and available in the Windows environment. Most of the character table from Appendix B of the "Windows User's Guide" for version 3.0 is also valid for Windows 3.1. Users who have this guide and who are now running version 3.1 can refer to this table if they need to enter characters through keyboard commands. (Note that the table may not work with certain TrueType fonts.) Page 317 Chart Incorrectly States Vector Fonts Can't Print ---------------------------------------------------------- Page 317 of the version 3.1 "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 includes a chart that incorrectly states that the Windows vector fonts Modern, Roman, and Script cannot print on dot- matrix printers. In the third paragraph on page 322, the WRK guide correctly states that vector fonts are printable on dot-matrix printers. Page 317 Doesn't List Wingdings as an Installed Font ---------------------------------------------------- Page 317 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 does not list Wingdings as a character set that is installed with Windows 3.1. A line should be added to the table that reads: Wingdings*** TrueType, proportional, scalable Also, an additional footnote should be added: ***Wingdings character set, rather than ANSI character set Page 324 Incorrectly States PFM Editor Kit Available From PSS ------------------------------------------------------------- Page 324 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly states that the PFM Editor Kit is available from Microsoft Product Support Services. The PFM Editor Kit is only included with the Microsoft Windows Device Development Kit (DDK). The Microsoft Windows DDK contains the Windows Printers and Fonts Kit, which includes information on the Printer Font and Cartridge Metrics (PFM and PCM) file formats and the new PFM Editor. It also contains technical notes on the PCL/HP LaserJet and PostScript printer drivers. The Microsoft Windows Device Development Kit (DDK) is a retail package that can assist in writing device drivers for printers, video display cards, and networks. It may be ordered through software dealers, or directly from Microsoft by calling (425) 882-8088. Page 327 Incorrectly Describes How to Create FINSTALL.DIR File -------------------------------------------------------------- The "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly describes how to create the FINSTALL.DIR file. Page 327 of the WRK guide incorrectly describes step 2 as: In the Font Installer dialog box, hold down the CTRL and SHIFT keys and click the Exit button. This step should read: In the Font Installer dialog box, hold down the CTRL and SHIFT keys and choose the Add Fonts button. Page 334 Incorrectly References Virtual Printer Memory Information ------------------------------------------------------------------ Although page 334 of the "Microsoft Windows Resource Kit" Windows 3.1 implies that more details exist concerning virtual printer memory in chapter 4 ("Troubleshooting") of the "Getting Started with Microsoft Windows" guide, no additional information specific to printer virtual memory exists there. Nonetheless, the "To change a PostScript printer's options" section on page 84 of the "Getting Started with Microsoft Windows" guide does provide information about the Clear Memory Per Page check box. Other information about virtual memory is found by choosing the Help button or by pressing F1 while the insertion point is in the Virtual Memory settings box. Page 337 Incorrectly Describes Changing TrueType Names ------------------------------------------------------ On page 337 of the "Microsoft Windows Resource Kit" guide for version 3.1, the first paragraph under the section titled "Changing Typeface Names for Soft Fonts" states: If you purchase a TrueType font or other soft font that has the same name as a font you are already using, you should use the Font Installer to change the name of the font. This information is incorrect. TrueType font names cannot be changed using the Font Installer. In the Font Installer dialog box, if you have no fonts installed, choose Add fonts and specify the WINDOWS\SYSTEM directory. A message "No fonts compatible with this printer" or "No fonts found" is returned. Pages 343 and 348 Incorrectly State COM Addresses ------------------------------------------------- In the "Microsoft Windows Resource Kit" (WRK) for version 3.1, incorrect base I/O addresses and IRQs for COM1, COM2, COM3, and COM4 occur in the following places: - Page 2 of the COMMQA.WRI file - Page 343 of the WRK guide - Page 348 of the WRK guide The correct addresses and IRQs are as follows: Port Address IRQ -------------------- COM1 3F8h IRQ4 COM2 2F8h IRQ3 COM3 3E8h IRQ4 COM4 2E8h IRQ3 Page 348 Provides Incorrect Examples of MODE Command ---------------------------------------------------- The "Microsoft Windows Resource Kit" (WRK) guide for Windows version 3.1 has an incorrect example of the MS-DOS MODE redirector command. Page 348 of the WRK guide states the following: ...if you have a physical LPT1, but not an LPT3, and you execute MODE LPT3=LPT1, output sent to LPT3 will be redirected to LPT1. The MS-DOS MODE command can be used to redirect output from a parallel port to a serial communications port, but not to another parallel port. The following is an example of a valid command: MODE LPT1=COM1 Redirecting output to a parallel port generates the following error message: Invalid Parameter - =LPTx A redirection of COM1: to LPT1: requires the use of a special buffer for which the MODE command would have to allocate space. The MS-DOS MODE command does not have this capability. For more information on port redirection, query on the following words in the Microsoft Knowledge Base: mode and redirect and port Page 388 Incorrectly Describes Logging On/Off Novell Server ----------------------------------------------------------- Page 388 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 has the following documentation error: Do not try to log on, log out, attach, or detach a Novell server from the MS-DOS Prompt within Windows. You must perform these operations before starting Windows. It should state: Do not try to log on, log out, attach, or detach a Novell server from the MS-DOS Prompt within Windows. You must log on to or log out of the Novell server before starting Windows. You can then attach and detach from Novell servers through Windows File Manager. Page 391 Incorrectly States the Requirements for IRQ 2 Setting -------------------------------------------------------------- The "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 has the following documentation error on page 391: Do not use INT 2, INT 9, or above and do not use a base I/O port address below 300 for your LAN card (such as ArcNet or Token Ring) unless you use VPICDA.386, which you can obtain from either Microsoft or Novell. Windows 3.1 does not require VPICDA.386 to work with IRQ 2 in the Novell network environment. NOTE: The words INT 2 and INT 9 as stated above should be IRQ 2 and IRQ 9. For more information on VPICDA.386 and Windows 3.1, query on the following words in the Microsoft Knowledge Base: VPICDA.386 and patch Page 398 Incorrectly Describes How to Make a Boot Disk ------------------------------------------------------ Page 398 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 gives inaccurate syntax for creating a bootable floppy disk with the FORMAT command. Step 3 of the section titled "To create a 'clean boot' disk for troubleshooting" incorrectly states: Make a boot disk. To do this, place a disk in drive A, type the following command at the command prompt: FORMAT A: This syntax does not create a boot disk. The correct syntax is: FORMAT A: /S The /S switch causes the MS-DOS FORMAT command to copy the MS-DOS operating system files to the formatted disk. These files must be on the disk to enable the operating system to boot itself up. Page 414 Incorrectly States SMARTDRV.EXE Must Load Low ------------------------------------------------------ Page 414 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly states that SMARTDRV.EXE must be loaded into 640K conventional memory and cannot be loaded high. SMARTDRV.EXE in the AUTOEXEC.BAT file loads itself into upper memory blocks (UMBs) if they are available and are managed by MS-DOS 5.0 or 6.0 with the command DOS=UMB. If you are using a third-party memory manager, such as QEMM or 386MAX, consult the documentation for that product. SMARTDRV.EXE installed in the CONFIG.SYS file for double buffering must not be loaded high. On page 414, the WRK guide also states that HIMEM.SYS and EMM386.EXE must be loaded in conventional memory. This is partially correct. A DEVICEHIGH command for these drivers has no effect. Once they are loaded, however, these drivers do use memory beyond the 640K conventional memory. Page 419 HIMEM.SYS Machine-Type Chart Incorrect ----------------------------------------------- Page 419 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 contains an incorrect HIMEM.SYS machine-type chart. The chart displayed refers to the HIMEM.SYS driver version included with Windows version 3.0. The proper switches for Windows 3.1 are documented on page 545 of the "Microsoft Windows User's Guide" for version 3.1. Page 419 of the WRK guide also refers to pages 283-287 of the "Microsoft MS-DOS User's Guide and Reference" to aid you in configuring device drivers, such as EMM386 and RAMDrive. However, the page numbers discussed (283-287) refer to the MS-DOS version 5.0 manual manufactured by Microsoft. These page numbers may differ between versions of MS-DOS. Manuals that are manufactured by original equipment manufacturers (OEMs), which are often included with the purchase of a computer, may also differ. If you do not have the "Microsoft MS-DOS User's Guide and Reference" for MS-DOS version 5.0 or 6.0, refer to your MS-DOS reference guide's index for topics relating to the CONFIG.SYS and AUTOEXEC.BAT files. For specific advice on configuring and using the EMM386.EXE and RAMDRIVE.SYS devices, see pages 547-555 of the "Microsoft Windows User's Guide" for version 3.1. Page 440 Shows Incorrect Menu Bar for Network Assistant Utility --------------------------------------------------------------- Page 440 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly shows the menu bar for the Network Assistant utility as having "Utilities" and "Help" as menu options. The menu bar for the Network Assistant utility actually has "File," "Window," and "Help" as menu options. Page 441 Incorrectly States Use F1 to Activate SMARTMON Help ------------------------------------------------------------ The "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 states the following in the SMARTDrive Monitor (SMARTMON) section on page 441: When SMARTDrive Monitor is running, press F1 for information about its features. This is a documentation error. To properly activate the Help feature, choose the Help button in SMARTDrive Monitor or press ALT+H. The SMARTDrive Monitor (SMARTMON.EXE) provides an interface to the performance of SMARTDrive 4.0, the disk cache included with Microsoft Windows 3.1. Page 444 Incorrectly States Audio Drivers Available with WRK ------------------------------------------------------------ Page 444 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 indicates that the WRK includes device drivers for the IBM Multimedia Audio Board and the CompuAdd Multimedia Board. For a sound driver for the CompuAdd Multimedia Board, please contact CompuAdd. Page 500 Incorrectly States README.WRI Contents ----------------------------------------------- Page 500 of the "Microsoft Windows Resource Kit" (WRK) guide for Windows 3.1 incorrectly states: See README.WRI on the Windows Resource Kit disk for a complete list of files that includes: - The disk location for each Windows file, based on the disk format size. - The expanded file size for each file. - A description of the purpose of each file. The actual lists can be found in the LAYOUTS.WRI file from the WRK. The WRK README.WRI has a section (7.0) titled "Windows 3.1 Disk Layouts"; however, it only contains the following line: Please refer to the file LAYOUTS.WRI located in your Windows Resource Kit directory. Page 501 Incorrectly Describes Removing Unused Fonts ---------------------------------------------------- On page 501 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1, the following steps incorrectly outline how to remove unused fonts. 3. Make sure the Delete Font File from Disk option is checked, and choose Remove. 4. When the dialog box prompt appears, choose Yes to remove the file. The correct instructions are: 3. Choose Remove. The Remove Font dialog box appears. Make sure the Delete Font From Disk check box is selected. 4. Choose Yes to remove the file. Page 526 Incorrectly Indexes DDE Definition ------------------------------------------- Page 526 of the "Microsoft Windows Resource Kit" (WRK) guide for version 3.1 incorrectly lists Page 439 as the index reference for the DDE (Dynamic Data Exchange) definition. The correct page number is 449. KBCategory: kbnetwork kbdisplay kbsound kb3rdparty kbdocerr kbmm kbsetup KBSubcategory: win31 winmem wincom Additional query words: 3.1 3.11 3.10 WRK wrkit guide documentation error MMDISP.EXE windrvr systems administrator EMM386.SYS a20 handler incorrect smart drive wrk2 hp font installer patch vpicda IRQ2 compression winwrk attaching detaching crc xmodem swapfile money AIF setup.inf minoutlineppm minoutlineeppem minoutlineeppm dot matrix sndblst default.pif pif editor default VM Size fastdisk ====================================================================== Keywords : Technology : kbWin3xSearch kbZNotKeyword3 kbWin310 kbWin311 Version : WINDOWS:3.1,3.11 ============================================================================= THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY. Copyright Microsoft Corporation 1999.