home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Programmer's Library 1.3 / Microsoft-Programers-Library-v1.3.iso / readme.doc < prev    next >
Text File  |  1991-02-28  |  20KB  |  506 lines
  1. ------------------------------------------------------------------------
  2. README.DOC            Microsoft Programmer's Library          March 1991
  3.                             Volume #2   Issue #1
  4. ------------------------------------------------------------------------
  5.  
  6.   This document covers topics not discussed in the Programmer's Library
  7.   printed documentation.  Please read it -- and your manual -- in their
  8.   entirety.
  9.  
  10.  
  11. ************************************************************************
  12. Programmer's Library Contents are detailed in the CONTENTS.DOC file
  13.   (in this directory).
  14. ************************************************************************
  15.  
  16. SETUP
  17. =====
  18. 1.  Set default to the CD-ROM drive.   [Example:  d:]
  19. 2.  Type SETUP                         [          SETUP]
  20.  
  21.  
  22. OS/2 CD-ROM SUPPORT
  23. ===================
  24. Microsoft Corporation has developed an installable file system for
  25. OS/2 (version 1.2), which is compatible with CD-ROM drives.  The
  26. operation of a CD-ROM drive also requires a device driver compatible
  27. with the device controller of your specific model, as well as your
  28. specific drive.  For availability of both components, please contact
  29. your CD-ROM drive manufacturer.
  30.  
  31.  
  32. For specific technical questions relating to device drivers, you may
  33. contact:
  34.  
  35. LASER MAGNETIC STORAGE (L.M.S.I.)
  36.            (800) 777-LMSI
  37.  
  38. ONLINE Corporation
  39.         Cheryl McGarry
  40.         Account Representative
  41.            (301) 601-2227
  42.            (800) 922-9204
  43.  
  44. SONY Corporation
  45.         Jacquie Cao
  46.            (408) 944-4118
  47.         Mike Yokoyama
  48.            (408) 944-4344
  49.     
  50.  
  51. DO NOT PASTE WHEN "UNKNOWN" IS DISPLAYED
  52. ========================================
  53. Programmer's Library can be run as a memory-resident T.S.R., which
  54. will pop-up for easy reference while you are in a text editor.  In
  55. many cases, you can also PASTE selected material from Programmer's
  56. Library into your editor.
  57.  
  58. If Programmer's Library is popped up over some text-editors, Pro-
  59. grammer's Library may enter "Unknown" mode (the word "Unknown" appears
  60. on the Programmer's Library title bar, above the Main menu bar).
  61.  
  62. In "Unknown" mode, paste and date stamp are enabled; however, WE
  63. STRONGLY RECOMMEND THAT YOU REFRAIN FROM PASTING WHENEVER "Unknown"
  64. IS DISPLAYED.  This condition can easily lead to a system crash.
  65.  
  66. In such cases, you can still collect material in the Programmer's
  67. Library clipboard.  Use the SAVE CLIPBOARD command (in the OPTIONS
  68. menu) to export the clipboard contents to an ASCII file, which can
  69. be easily imported by your program editor.  This practice also
  70. provides the advantage of being able to store various content in
  71. separate files, for easier inclusion in different parts of the
  72. program you are currently editing.
  73.  
  74.  
  75. PASTING IN MICROSOFT EDITORS FROM THE T.S.R.
  76. ============================================
  77. The following shows which Microsoft language editing environments
  78. support direct paste from Programmer's Library in T.S.R. mode:
  79.  
  80. Supported
  81. ---------
  82.   Microsoft-C Professional Development System (v6.0) using Programmer's
  83.      Work Bench.
  84.   Microsoft QuickC version 2.0
  85.   BASIC Professional Development System (v7.1) using PROGRAMMER's WORK
  86.      BENCH.  (Versions 7.0 and 7.1 using the QBX editor do not support
  87.      TSR-mode PASTE).
  88.   QuickBASIC version 4.5
  89.   QuickPASCAL version 1.0
  90.   Microsoft "M" Editor
  91.  
  92.  
  93. Known to Cause Problems (Does not support direct PASTE)
  94. -----------------------
  95.   Microsoft QuickC version 2.5
  96.   BASIC Professional Development System, v7.0 and v7.1 using QBX
  97.  
  98.  
  99.  
  100. GENERAL NOTES
  101. =============
  102.  
  103. Text Editors Only!
  104. ------------------
  105. Although you can use Microsoft Programmer's Library with almost any type
  106. of software, it is designed so that you can copy and paste into text
  107. editor and word-processor software ONLY.  If you try to copy and paste
  108. sample code or text into other types of software (for example, CAD pro-
  109. grams, software tutorials) that expect specific keystroke responses, you
  110. will likely experience problems.
  111.  
  112.  
  113. MS-DOS 4.x
  114. ----------
  115. If you intend to use Microsoft Library products with MS-DOS 4.x, you must
  116. use the MS-DOS CD-ROM Extensions version 2.1 (or higher).  To upgrade your
  117. version of the MS-DOS CD-ROM Extensions:
  118.     - Contact the manufacturer of your CD-ROM drive
  119.     - Call Meridian Data at (408) 476-5858.
  120.  
  121.  
  122. Sample Code
  123. -----------
  124. Programmer's Library sample code is contained in ASCII text files in the 
  125. \SAMPCODE directory on the Programmer's Library CD-ROM disc.  You can use 
  126. your editor to copy and paste any of these directly into your program's 
  127. source code independent of Programmer's Library.  Sample program subdir-
  128. ectories are explained in the CONTENTS.DOC file in the CD-ROM's root
  129. directory.   Sample code is provided for your convenience and education;
  130. but is not warrantied by Microsoft.
  131.  
  132.  
  133. Stand-alone operation
  134. ---------------------
  135. You can use Programmer's Library as a stand-alone program and still
  136. incorporate its text and sample code into your own programs.  To do so,
  137. copy the data you need into the Programmer's Library Clipboard (appending
  138. as necessary), and save the Clipboard data as an ASCII text file.  Later,
  139. you can call the ASCII text file you saved into your text editor.
  140.  
  141.  
  142. TSR operation
  143. -------------
  144. If you use Programmer's Library as a memory-resident program, load it
  145. into memory before loading your text editor or any other application and
  146. unload it only after exiting any other programs that were subsequently
  147. started.
  148.  
  149. Programmer's Library may behave erratically if it is popped up after
  150. another memory-resident program that was also popped up over your text
  151. editor.  For best results, pop up only one memory-resident program at a
  152. time.
  153.  
  154. Load keyboard enhancement programs BEFORE loading Programmer's Library.
  155. Load other memory-resident programs AFTER Programmer's Library.
  156.  
  157. We recommend that you edit your CONFIG.SYS file so that it assigns values
  158. of at least:
  159.          files = 15
  160.          buffers = 20
  161.  
  162.  
  163. Microsoft CD-ROM Extensions
  164. ---------------------------
  165. For the most efficient interaction between Programmer's Libarary and the
  166. MS CD-ROM Extensions, set the MSCDEX /M: buffers option to 10 (at a
  167. minimum) or 12 (for best effect).  The following is a sample command line
  168. that starts the Extensions with buffers set to 12:
  169.     C:\> MSCDEX /D:MSCD001 /M:12
  170.  
  171.  
  172.  
  173.  
  174. SPECIFIC TEXT EDITOR AND WORD PROCESSOR NOTES
  175. =============================================
  176.  
  177. Brief
  178. -----
  179. When Brief starts up, the default line length is 144 characters.  If the
  180. cursor is at the beginning of an 80-character line and if another 80-
  181. character line is pasted into Brief from Programmer's Library, then the
  182. last 16 characters to be pasted will be lost.  We recommend that when
  183. you start Brief you use the -lxxx switch to alter its default line
  184. length.  An example command-line call is: b -p -c1,1,3,3 -l160 <Enter>
  185.  
  186. Be sure to start Brief with the "-p" command line switch (as shown above).
  187. Doing so ensures that Programmer's Library and Brief do not try to write
  188. to the same video page at the same time.
  189.  
  190.  
  191. Microsoft QuickC
  192. ----------------
  193. -Version 2.5:
  194.  Programmer's Library can be run as a T.S.R. over QuickC 2.5; but does
  195.  not support direct paste operations.  Instead, select the text you wish
  196.  to save, COPY or APPEND to the Programmer's Library clipboard; and
  197.  use the Save Clipboard command (OPTIONS menu) to store the clipboard
  198.  contents in an ASCII file.  Return to QuickC and use the FILE OPEN
  199.  to include the ASCII file contents in your edit environment.
  200.  
  201. -Version 2.0:
  202.  Turn on insert mode before pasting sample code into your program.
  203.  
  204.  If you use the /h option with QC and are running Programmer's Library
  205.  in TSR mode, run the 43.COM program in the CD-ROM's \MSLIB directory
  206.  before starting QC.
  207.  
  208.  
  209. Microsoft QuickBASIC and Microsoft QuickPASCAL
  210. ----------------------------------------------
  211. Turn off syntax checking AND turn on insert mode before pasting sample
  212. code into your program.  To pop up Programmer's Library, press the
  213. shift key and THEN the Alt key.
  214.  
  215. If you use the /h option with QB and are running Programmer's Library
  216. in TSR mode, run the 43.COM program in the CD-ROM's \MSLIB directory
  217. before starting QB.
  218.  
  219.  
  220. Microsoft Programmer's Workbench, 'M' Editors
  221. ---------------------------------------------
  222. Turn on insert mode before pasting contents into your program.
  223.  
  224.  
  225. Microsoft BASIC: QBX Editor
  226. ---------------------------
  227. Programmer's Library can be run as a T.S.R. over QBX; but does
  228. not support direct paste operations.  Instead, select the text you wish
  229. to save, COPY or APPEND to the Programmer's Library clipboard; and
  230. use the Save Clipboard command (OPTIONS menu) to store the clipboard
  231. contents in an ASCII file.  Return to QBX and use the FILE LOAD
  232. to include the ASCII file contents in your edit environment.
  233.  
  234.  
  235. Microsoft Word
  236. --------------
  237. Versions 2.0 and 3.0
  238.   --Graphics mode not supported.  A beep sounds if you attempt to pop up
  239.     Programmer's Library over graphics mode.
  240. Versions 3.1, 3.2, and 4.0
  241.   --Programmer's Library will temporarily turn off graphics mode while it
  242.     is popped up.  Graphics mode will be turned on again when it is popped
  243.     down.
  244. Version 5.0
  245.   --Graphics mode not supported.  Before popping up Programmer's Library
  246.     over graphics mode, use the Alt-F9 key or the Options command to
  247.     switch to text mode.  The Alt-F9 key will return you to your previous
  248.     mode when Programmer's Library is popped down.
  249.   --When setting up Word 5.0, you must choose the "safe keyboard support"
  250.     option.
  251.  
  252.  
  253. Microsoft Works
  254. ---------------
  255. When pasting whole paragraphs into the header/footer, you must delete hard
  256. carriage returns (<Enter>) and insert soft carriage returns (<Shift>-
  257. <Enter>) in their place.
  258.  
  259.  
  260. WordPerfect
  261. -----------
  262. Version 4.2
  263. --Pasting lines that extend into the "hot zone" can cause WordPerfect to
  264.   prompt you for hyphen placement, and can cause the rest of the "to-be-
  265.   pasted" text to be "lost."  To avoid this situation, set your margins or
  266.   columns at least 80 characters apart.
  267. Version 5.0
  268. --Programmer's Library will not pop up when you are in Print Preview mode.
  269.  
  270. --If you redefine your default BLOCK mode toggle key default <Alt>-<F4>,
  271.   Programmer's Library will not know that BLOCK mode has been toggled, and
  272.   WordPerfect will ignore your paste.
  273.  
  274.  
  275. XyWrite III
  276. -----------
  277. Follow the instructions that accompany the XyWrite documentation for
  278. setting up XyWrite to run with memory-resident programs.  If you don't,
  279. you will likely experience serious problems.
  280.  
  281. You must use the default command prompt "CM" in order for Programmer's
  282. Library to "know" that it is to work with XyWrite III. For this reason,
  283. we recommend that you don't reconfigure the XyWrite III command prompt.
  284.  
  285. Don't pop up Programmer's Library over XyWrite III help screens.
  286.  
  287.  
  288. Wordstar Professional Releases 4.0 & 5.0
  289. ----------------------------------------
  290. Turn off Wordstar's special character-formatting symbols (^b, for bold,
  291. for example) before Programmer's Library is popped up.
  292.  
  293. Paste from Programmer's Library only when Wordstar is in insert mode.
  294.  
  295. You must be using help levels 1, 2, or 3 for Programmer's Library to
  296. "know" that it is working with Wordstar.
  297.  
  298.  
  299. DisplayWrite 3 version 1.10 and DisplayWrite 4 version 1.0
  300. ----------------------------------------------------------
  301. Supported by Programmer's Library in their default configurations
  302.  
  303.  
  304.  
  305. VIDEO DISPLAY NOTES
  306. ===================
  307. To correctly use a Hercules graphics adapter with Microsoft Word and
  308. Programmer's Library, the environment variable HERCGB102 must be set
  309. to TRUE.  Place the following entry in your AUTOEXEC.BAT file:
  310.            SET HERCGB102 = TRUE 
  311.  
  312. If you have a Hercules graphics adapter and you use Microsoft Word, you
  313. must use Word in character mode (all versions) if you intend to use
  314. Programmer's Library.
  315.  
  316. If you are using a monochrome monitor driven by a graphics video card, or
  317. a gas plasma display, start Programmer's Library using the /b command line
  318. switch.
  319.  
  320. Programmer's Library uses the current video page to display data.
  321. Occasionally, less well-behaved software will not inform the bios of what
  322. video page it is using.  This may cause a conflict with Programmer's
  323. Library, and Programmer's Library may appear not to be working.  If this
  324. is true with your software, please check the manual for instruction on how
  325. to make the first video page (page 0) the default.
  326.  
  327. If you have any difficulty using Programmer's Library in 43- or 50-line
  328. video modes, run the 43.COM program in the CD-ROM's \MSLIB directory be-
  329. fore popping up Programmer's Library.
  330.  
  331.  
  332. USING PROGRAMMER'S LIBRARY WITH A MOUSE
  333. =======================================
  334.  
  335. Occasionally, your text editor's mouse cursor will be "frozen" on your
  336. screen when you call up Programmer's Library.  In that case, you will see
  337. another mouse cursor, which Programmer's Library controls, and which will
  338. work properly.  When you pop out of Programmer's Library, your text editor's
  339. mouse cursor will be "unfrozen," and the Programmer's Library mouse cursor
  340. will disappear.
  341.  
  342.  
  343. Microsoft
  344. ---------
  345. If you use a Microsoft Mouse, we recommend that you upgrade your Microsoft
  346. Mouse driver IF it is a version earlier than 6.25.  If you upgrade and if
  347. you use the MOUSE.SYS driver, delete your earlier version of MOUSE.SYS and
  348. replace it with the MOUSE.SYS driver that resides on the Programmer's
  349. Library CD-ROM disc.  Likewise, if you use MOUSE.COM, delete your earlier
  350. version and replace it with the MOUSE.COM that resides on the Programmer's
  351. Library CD-ROM disc.
  352.  
  353. Note: The 6.25 driver on the CD-ROM is NOT the latest mouse software
  354. version.  The latest software is available from your computer software
  355. supplier.
  356.  
  357.  
  358. Mouse Systems
  359. -------------
  360. If you use the Mouse Systems PC Mouse and have problems with mouse behavior
  361. in Programmer's Library, be sure you are using an MSMOUSE driver version
  362. later than 4.70.  We recommend that you always use the latest mouse driver
  363. software.  Check with your mouse manufacturer about getting an update.
  364.  
  365. (Mouse Systems and PC Mouse are trademarks of Mouse Systems Corporation).
  366.  
  367.  
  368.  
  369. USING PROGRAMMER'S LIBRARY WITH MULTIPLE CD-ROM DRIVES
  370. ======================================================
  371. Programmer's Library setup creates a file called MSL.INI.  This file
  372. contains paths for each Microsoft Library product.  The paths assume that
  373. each product is in the same logical disk drive as it was when you first
  374. ran setup.
  375.  
  376. If you change the drive in which Microsoft Library products are found,
  377. you must also change the appropriate path names in MSL.INI.
  378.  
  379.  
  380. MANUAL SETUP PROCEDURES
  381. =======================
  382. If you encounter problems with the setup program or if you simply prefer
  383. to set up manually, follow the procedures below, which assume the
  384. following about your system configuration:
  385.         Hard Drive is drive C:
  386.         CD-ROM Drive is drive D:
  387.  
  388.   1. On your hard drive, create a subdirectory called "MSLIB".
  389.                 C:\>md MSLIB <Enter>
  390.  
  391.   2. Change to the MSLIB subdirectory by typing "cd MSLIB" and ENTER.
  392.                 C:\>cd MSLIB <Enter>
  393.  
  394.   3. Place the Programmer's Library CD-ROM disc in your D: drive.
  395.  
  396.   4. Copy all files in the MSLIB directory on drive D: (your CD-ROM
  397.      drive) to the MSLIB directory on drive C.
  398.                 C:\MSLIB>copy d:\MSLIB\*.* <Enter>
  399.  
  400.   5. With your text editor, create an ASCII text file named MSL.INI, which
  401.      should look like this:
  402.  
  403. [msl]
  404.         os2,     OS/2 References,     D:\BOOKS, 2011
  405.         windows, Windows References,  D:\BOOKS, 2012
  406.         net,     Network References,  D:\BOOKS, 2013
  407.         msdos,   MS-DOS References,   D:\BOOKS, 2014
  408.         msj,     MS Systems Journal,  D:\BOOKS, 4015
  409.         hw,      Hardware References, D:\BOOKS, 4016
  410.         c,       C References,        D:\BOOKS, 2017
  411.         masm,    MASM References,     D:\BOOKS, 2018
  412.         basic,   BASIC References,    D:\BOOKS, 2019
  413.         pascal,  Pascal References,   D:\BOOKS, 2020
  414.         fortran, FORTRAN References,  D:\BOOKS, 2021
  415.  
  416.   6. From the MSLIB directory on drive C:, type "MSL" to load Programmer's 
  417.      Library and to run it as a standalone application.
  418.                 C:\MSLIB>msl <Enter>
  419.  
  420.      To load Programmer's Library and run it as a memory-resident program,
  421.      type:
  422.              C:\MSLIB>msl -t <Enter>
  423.  
  424.  
  425.   See Appendix A in the User's Manual for more information on the individual
  426.   fields and format of the MSL.INI file.
  427.  
  428.  
  429. ERROR MESSAGES
  430. ==============
  431. When you use the following commands, your work may be interrupted by an
  432. error message.  If so, the following instructions will help you deal with
  433. its associated problem.
  434.  
  435.  
  436. CROSSREF, FIND, AND QUICKREF ERROR MESSAGES
  437. -------------------------------------------
  438. Error message: "Too many cross-references"
  439. --Choose the OK button or press <Enter>.
  440. --You have exceeded cross-reference capacity.  Save your current cross-
  441.   reference location with a bookmark, choose View Bookmark, and then select
  442.   the bookmark you just created.  This procedure clears the previous cross-
  443.   references you've viewed.
  444.  
  445. Error message: "Unable to find datafiles"
  446. --Choose the OK button or press <Enter>.
  447. --Be sure the Programmer's Library disc is in your CD-ROM drive.
  448.  
  449.  
  450. SEARCH ERROR MESSAGES
  451. ---------------------
  452. Error message: "No terms specified in search"
  453. --Choose the OK button or press <Enter>.
  454. --Enter the word or phrase you want to search for in the Term box 
  455.   and restart your search.
  456.  
  457.  
  458. Error message: "Too many high frequency words.  Search canceled"
  459. --Choose the OK button or press <Enter>.  
  460. --Try redefining your search by using either fewer words in the Term 
  461.   boxes or by using more specific words.
  462.  
  463.  
  464. BOOKMARKS ERROR MESSAGES
  465. ------------------------
  466. Error message: "Can't save updated bookmark list"
  467.   "      "   : "Can't open bookmark file for updating"
  468.   "      "   : "Can't add any more bookmarks, delete one first" 
  469.   "      "   : "Couldn't save bookmark file" 
  470.   "      "   : "Couldn't open bookmark file"
  471.   "      "   : "Bookmark not saved"
  472.  
  473. --Choose the OK button or press <Enter>.
  474.  
  475.   If any of the above messages appears, one of the following problems
  476.   exists:
  477.   --You have reached the bookmark capacity limit.  Delete unnecessary 
  478.     bookmarks.
  479.   --You have insufficient disk space on your computer.  Exit
  480.     Programmer's Library and delete unnecessary files on your disk.
  481.   --You have made your bookmark file (BKMARKS.INF) read-only.  Exit
  482.     Programmer's Library, be sure you are in your \MSLIB directory,
  483.     and then type:
  484.          Attrib -r bkmarks.inf <Enter>
  485.  
  486.   --You do not have enough files specified in your CONFIG.SYS file.
  487.     Exit Programmer's Library, and edit CONFIG.SYS to specify a larger
  488.     "FILES =" value.
  489.  
  490. Error message: "Product not found"
  491. --Choose the OK button or press <Enter>.
  492. --Be sure an installed Microsoft CD-ROM Library disc is inserted in your
  493.   CD-ROM drive.
  494.  
  495.  
  496. "RE-RUN SETUP" 
  497. --------------
  498. When a file necessary to Programmer's Library operation is corrupted or
  499. deleted, an error message prompts you to rerun setup.  First, delete the
  500. file "MSL.VER", and then rerun setup for the product that was being used
  501. when the error message was produced.  If you are using more than one
  502. CD-ROM disc (for example, Programmer's Library, Small Business Consultant, and
  503. Stat Pack) and you encounter another "rerun setup" error message, then
  504. repeat the procedure for the disc that you were using when you encountered
  505. the message.
  506.