home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / wvhtm064.zip / notes / macros-notes / LWM110.ZIP / LWM.TXT < prev   
Text File  |  1997-06-01  |  6KB  |  124 lines
  1.                                List Word Macros
  2.                                LWM version 1.10
  3.                              Minimal Documentation
  4.                                   1 June 1997
  5.  
  6. Legal
  7. ~~~~~
  8. Program and documentation are Copyright 1997 by Mike Janda, Madison, WI USA.
  9. All rights reserved.  Distribution and use of this program are free.  No fee
  10. may be charged for the use and/or distribution of the program.  Do not modify
  11. the program and redistribute it.  Do not distribute the program in archives
  12. containing computer viruses, source code or virus listings.
  13.  
  14. As usual, there is no warranty or guarantee that this program will function
  15. correctly.  Use it at your own risk.  Also, it is a good idea to scan the
  16. program for viruses and trojans BEFORE using it.
  17.  
  18. Introduction
  19. ~~~~~~~~~~~~
  20. LWM will allow you to safely examine the macros present in Word version 6 and 7
  21. templates without the need to load the file into Word and possibly activate a
  22. virus or trojan that could delete files, format the drive or install a virus on
  23. your system.  Since LWM does not use Word (or Windows!) to read the file, there
  24. is no chance that any malicious macros can do anything to your system.  Just
  25. run LWM with the name of the Word template and it will write out a new file
  26. with the extension 'mac' containing all the macros listed much like they would
  27. be listed in Word (see program notes below for some exceptions).
  28.  
  29. System Requirements
  30. ~~~~~~~~~~~~~~~~~~~
  31. A PC (8088 CPU or above) running MS/PC/DR-DOS 2.0 or above.  If you're running
  32. Windows or OS/2, run it in a DOS window.  Memory requirements are variable.
  33. The program will require at least 128K of conventional memory to start and will
  34. use up to the 640K DOS limit, depending on the size and complexity of the file
  35. being examined.  The program does not use any XMS or EMS memory, even if it is
  36. available.
  37.  
  38. Usage
  39. ~~~~~
  40. Enter on the command line:
  41.  
  42.   LWM filename.ext
  43.  
  44. where 'filename.ext' is the name of a Word template file.  Drive and path names
  45. are allowed.  Wildcards (* and ?) are not allowed.  The Word file will not be
  46. modified, but it is always a good idea to work with a backup file.  The output
  47. file will have the same filename and the extension 'mac' (e.g., 'filename.mac')
  48. in the same directory as the input file.  If the output file already exists, it
  49. will be overwritten.  If the file being examined ends with a 'mac' extension,
  50. it will be overwritten.  The program offers no warning when it does this, so
  51. consider yourself warned here.
  52.  
  53. If the Word file is protected by a password, the program will prompt for the
  54. password.  Type in the correct password and press Enter.  Just pressing Enter
  55. will cause the program to terminate, as will an incorrect password.
  56.  
  57. Program Notes
  58. ~~~~~~~~~~~~~
  59. LWM is able to read and correctly process most Word 6.x and 7.x files.  The
  60. output listing is quite close to what Word produces with a few exceptions.
  61.  
  62. Windows uses the ANSI character set, while DOS uses the ASCII character set
  63. with the IBM extensions.  ANSI and ASCII are basically the same for the lower
  64. characters (0-127), but differ substantially for the higher characters
  65. (128-255).  LWM uses the ASCII (with IBM extensions) character set.  Most
  66. symbols and non-English language characters will not be correctly displayed.
  67. No attempt is made to translate the ASCII characters to ANSI.
  68.  
  69. Several versions of Word offer Unicode support which has the ability to handle
  70. 65,536 different characters (useful for Asian languages).  DOS doesn't handle
  71. Unicode very well, so LWM displays Unicode as a series of hexadecimal digits
  72. separated by hyphens (e.g., A6DB-B0CA-B0F5-A6E6-A143).  If there are ANSI text
  73. characters (0-255) imbedded in the Unicode text string, they will be displayed
  74. as ASCII (see above paragraph for limitations).
  75.  
  76. Word offers a line break (Shift-Enter) which can be used in comments.  Line
  77. breaks are marked with a " " so they can be easily seen (if you can't see it,
  78. change viewers).  The reason for this is that when examining certain macros,
  79. what looks like macro code is really part of the comment above it.  So, when
  80. a line ends with a  , the next line is a continuation of the line above it.
  81.  
  82. If LWM encounters an unknown macro function, it will display "UNK-" followed by
  83. the hexadecimal code for the function (e.g., UNK-81C3 means LWM didn't know the
  84. function's name).  If you see many UNK-xx in a row, it means LWM got lost while
  85. reading the macro (fairly rare) or the macro is corrupted (which happens quite
  86. often with macro viruses).
  87.  
  88. Here are the program termination return codes (useful in batch files) and some
  89. error messages the program displays:
  90.   Return Code    Meaning
  91.   -----------    -------
  92.        0         Success
  93.        1         No Filename Specified on Command Line
  94.        2         Input File Not Found
  95.        3         File is Not a Word 6/7 Template
  96.        4         Incorrect Password Provided
  97.        5         No Macros Found in File
  98.        6         Error Creating Output File
  99.        7         Error Reading File
  100.        8         Error Writing File
  101.        9         Not Enough Memory to Process the File
  102.       10         Error Processing the File
  103.       11         Unknown Error <-- hopefully you'll never see this one
  104.  
  105. Limitations
  106. ~~~~~~~~~~~
  107. LWM can only read Word 6.x and 7.x files and occasionally other files that have
  108. Word 6.x/7.x macros imbedded in them.  It does not read Word 2.x, 5.x and 8.x
  109. (Office 97) files, Excel files, or other types of files.  If the Word file is
  110. open and in use by another program (e.g. Word), LWM won't be able to read it.
  111.  
  112. Acknowledgements
  113. ~~~~~~~~~~~~~~~~
  114. Thanks to Randall Hyde for the public domain floating point routines used to
  115. display the double-precision floating point numbers.  Thanks to Microsoft for
  116. the complex Word file format that took more time to decipher than this program
  117. took to write.  No thanks to the plethora of macro virus writers that inspired
  118. the development of this program.
  119.  
  120. Contact
  121. ~~~~~~~
  122. Send bug reports, comments and accolades to mike.janda@mpcug.com
  123. Send summonses, complaints and flames to dev/nul (that's ">NUL" for PC users)
  124.