home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR8 / 6TOOLS.ZIP / 6TOOLS.DOC next >
Text File  |  1993-10-12  |  70KB  |  1,594 lines

  1. David Seidman
  2. Software by Seidman
  3. 2737 Devonshire Place, N.W.
  4. Washington, D. C. 20008
  5.  
  6. October 1993
  7.  
  8. Copyright (c) 1993 by David Seidman
  9.  
  10.  
  11.                          SOFTWARE BY SEIDMAN'S
  12.  
  13.                             6TOOLS VERSION 1
  14.  
  15.                Essential Utilities for WordPerfect(r) 6.0
  16.  
  17.  
  18.  
  19. INTRODUCTION
  20.  
  21. 6TOOLS includes 15 utility programs for use with WordPerfect 6.0 (WP6).
  22. Much of it is based on WPTOOLS, a popular collection of utility
  23. programs for use with WordPerfect Versions 5.0, 5.1, and 5.2 (WP5).
  24. The shareware distribution of 6TOOLS consists of this documentation
  25. file in ASCII format and ten programs:  BOOKS, COMMENTS, FONTLIST,
  26. MERGESUM, SIXPRE, SWAPREF, TARGETS, TEXTSIZE, WP6LOOK, and WPMCRUSH.
  27. Registered users will also receive five additional programs, DOCINFO,
  28. SIXTXT, STYLIST, WPMSUM and 5or6.  All are described here.
  29.  
  30. NOTE:  WordPerfect is a registered trademark of WordPerfect
  31. Corporation.  There is no connection between WordPerfect Corporation
  32. and Software by Seidman.
  33.  
  34.  
  35. Briefly, this is what the 6TOOLS programs do:
  36.  
  37.  
  38. BOOKS    Writes a list of the bookmarks in a WP6 document, including
  39.          each bookmark's type and the number of the page on which it
  40.          appears.
  41.  
  42. COMMENTS Reads WP6 and WP5 document files, extracts the comments, and
  43.          writes them to standard output, indicating the pages on which
  44.          they appear.
  45.  
  46. DOCINFO  Extracts and lists useful information about WP6 document
  47.          files.
  48.  
  49.  
  50. FONTLIST Writes a lists of the fonts used in a WP6 or WP5 document and
  51.          shows the PRS file the document calls for.
  52.  
  53. MERGESUM Makes a WP6 secondary merge file (data text file) from
  54.          document summaries and DOS directory information, creating a
  55.          simple document management system.
  56.  
  57. SIXPRE   Removes deleted (and optionally other) data packets from the
  58.          prefix of WP6 document files and removes deleted data packets
  59.          from WP6 .SET files.  SIXPRE will often significantly reduce
  60.          the size of files.  It optionally deletes styles, document
  61.          summaries, and printer-related information.
  62.  
  63. SIXTXT   Removes unnecessary bytes from the body of a WP6 document,
  64.          making the document file smaller.
  65.  
  66. STYLIST  Lists names and descriptions of styles, optionally sorted.
  67.  
  68. SWAPREF  Changes automatic cross references from one type to another
  69.          (such as footnote to endnote).
  70.  
  71. TARGETS  Lists the automatic reference targets and references (and
  72.          their page numbers) in a WP6 document file, indicating
  73.          unreferenced targets and references to nonexistent targets.
  74.  
  75. TEXTSIZE Shows the size, in bytes, of the prefix and the body of WP6
  76.          and WP5 document files.
  77.  
  78. WP6LOOK  Displays one or more WP6 (or WP5) document files specified on
  79.          the command line, piped to the program, or entered in response
  80.          to prompts.  WP6LOOK may be more convenient than WP6 itself
  81.          for browsing through documents.  Also displays other kinds of
  82.          files.
  83.  
  84. WPMCRUSH Reduces the size of macros by deleting unneeded prefix data
  85.          and optionally eliminating the macro source code.
  86.  
  87. WPMSUM   Writes document summaries to standard output for reading,
  88.          printing, or processing in useful ways.  Can read document
  89.          summaries in protected macros, which WP6 and other programs
  90.          cannot.
  91.  
  92. 5or6     Allows batch files to identify WP6, WP5.1, and WP5.0 files.
  93.  
  94.  
  95. Running most of these programs from the DOS command line without any
  96. parameters will produce a brief explanation of program usage.
  97.  
  98.  
  99. Notes on Command Line Switches
  100.  
  101. Most of these programs require or allow you to select options by using
  102. "switches" on the DOS command line.  The switches for each program are
  103. described below.  (Brackets indicate that the switches are optional.)
  104. The discussion indicates that switches are preceded by a hyphen or
  105. minus sign (for example, -P is an optional command line switch for
  106. SIXPRE), but you can always use a slash ("/") instead.  Thus, -P and /P
  107. on the command line have the same meaning.
  108.  
  109. Each item you enter on the DOS command line is separated from the next
  110. by a blank space.  Thus, if you use the -C and -R switches with
  111. MERGESUM, your command line might look like this:
  112.  
  113.          MERGESUM *.* -omydocs -R -C
  114.  
  115. In most cases, where options must consist entirely of single letters,
  116. you can combine them:
  117.  
  118.          MERGESUM *.* -omydocs -RC
  119.  
  120. Note that case does not matter.  The previous example could just as
  121. well be written this way:
  122.  
  123.          MERGESUM *.* -Omydocs -rc
  124.  
  125.  
  126. Notes on Input and Output
  127.  
  128. You normally supply one or more input file names ("Infile") and
  129. sometimes an output file name ("Ofile") on the DOS command line.  The
  130. file name may always include drive and path specifications.  The
  131. program descriptions mention where wildcards (* and ?) can be used.
  132.  
  133. Many of the programs write their output to "standard output."  By
  134. default, standard output means the screen, so output goes to the screen
  135. in a continuous flow.  Instead of letting standard output go directly
  136. to the screen, you can, and usually should, pipe it to another program,
  137. or redirect it to either the printer or a file.  For example, screen
  138. display is more useful if you pipe output to the DOS filter MORE:
  139.  
  140.          STYLIST *.* |MORE
  141.  
  142. You can also redirect the output to your printer:
  143.  
  144.          STYLIST *.* >prn
  145.  
  146. or to an ASCII text file:
  147.  
  148.          STYLIST *.*>outfile
  149.  
  150.  
  151.  
  152.                                 PROGRAMS
  153.  
  154.  
  155. I.       BOOKS
  156.  
  157. BOOKS lists the names of the bookmarks in a WP6 file, in alphabetical
  158. order.  Bookmarks marking blocks are indicated with a B next to the
  159. name.  The quick mark is indicated with a Q.  The page number on which
  160. the bookmark appears is also listed.  Deleted bookmarks sometimes
  161. remain in a WP6 file.  They are indicated by a D before the page
  162. number.  (A page number of zero will generally indicate that the
  163. reference to a deleted bookmark does not exist.)  Since WP6 also
  164. provides a list of bookmarks, BOOKS is useful primarily if you find the
  165. page numbers useful.
  166.  
  167. Usage:   BOOKS Infile
  168.  
  169.                  Infile is a WP6 document file
  170.                  Output written to standard output.
  171.  
  172.  
  173.  
  174. II.      COMMENTS
  175.  
  176. COMMENTS extracts the comments (if any) in one or more WP5 or WP6
  177. document files and writes them to standard output.  This allows you to
  178. read all the comments in a document without retrieving the document
  179. into WordPerfect and searching for the comments individually.  The
  180. COMMENTS output is sent to standard output, so you can read it on the
  181. screen, send it to the printer, or capture it in an ASCII text file.
  182. The output identifies the page on which the comments appear (for
  183. comments in footnotes that are split between pages in printed output,
  184. the page indicated is the page on which the footnote starts).   The
  185. page number for comments in headers or footers is the page on which the
  186. header or footer code is located.
  187.  
  188.  
  189. Usage:  COMMENTS Infile [-c]
  190.  
  191.                  Infile is a WP5 or WP6 document file specification.
  192.                  It may include DOS wildcards, path, and directory.
  193.  
  194.                  Output is written to standard output.
  195.  
  196.                  Option:
  197.  
  198.                  -c      Do not include high ascii characters in the
  199.                          output.  Note that a few high ascii characters
  200.                          may be incorrectly treated in versions of
  201.                          WordPerfect that do not use the Roman
  202.                          alphabet.  Note also that characters not part
  203.                          of the standard ascii character set are
  204.                          displayed as an upside down question mark.
  205.  
  206.          Examples:
  207.  
  208.          COMMENTS Myfile
  209.  
  210.          The comments in Myfile are written to standard output.
  211.  
  212.          COMMENTS *.*  >prn
  213.  
  214.          Comments in all files in the default directory are printed.
  215.  
  216.          COMMENTS Myfile -c >Comments.out
  217.  
  218.          Comments in Myfile are written to the ASCII text file
  219.          Comments.out in the default directory.  High ascii characters,
  220.          such as letters with accents, are not included in the output.
  221.  
  222.  
  223. III.     DOCINFO
  224.  
  225. DOCINFO extracts a variety of useful information from WP6 document
  226. files and writes it to standard output.  Here is sample DOCINFO output,
  227. for a single file:
  228.  
  229. Report for file TEST
  230. Baseline placement is not set
  231. Redline indicator: Font change
  232. Document does not need to be formatted
  233. Document does not need to be generated
  234. Automatic display pitch
  235. Width of screen char: 0.1"
  236. Links should not be updated on retrieval
  237. Links codes should be displayed
  238. Text Quality: High
  239. Graphics Quality: Medium
  240. Show full merge codes
  241. Ink Color: Full color
  242. Hypertext mode is not active
  243. Hiding text not marked for hiding
  244. Set up for printer HP LaserJet IIP
  245. Uses prsfile HP2P.PRS
  246. Personal style library: DS.STY
  247. Shared  style library: LIBRARY.STY
  248.  
  249.  
  250. Usage: DOCINFO Infile [... Infile]
  251.  
  252.                  Infile is a WP6 file specification that may include
  253.                  drive, directory, and wildcards.  Up to 5 Infiles may
  254.                  be listed.
  255.  
  256.                  Output to standard output.
  257.  
  258.          Example
  259.  
  260.          DOCINFO My.Let My.Mem |MORE
  261.  
  262.          Pipes reports for the files My.Let and My.Mem to the DOS
  263.          program MORE for convenient viewing.
  264.  
  265.  
  266. IV.      FONTLIST
  267.  
  268. FONTLIST displays a list of the names of the fonts used in a WP5 or WP6
  269. document file.  (This list is found in the document's prefix.)  The
  270. output also identifies the PRS file and printer assumed by the
  271. document.  This can be particularly helpful if you have received the
  272. file from someone else.
  273.  
  274. FONTLIST output may be misleading in several ways.  First, the initial
  275. font, or any font specified in initial codes, or any font specified in
  276. a document's initial font setting, may appear on the list even if you
  277. did not use it in the document.
  278.  
  279. Second, fonts once used in a document but later replaced or removed may
  280. also appear in the list.  To avoid listing these fonts, you can FIXPRE
  281. (for WP5 documents) or SIXPRE (for WP6 documents) the document, read it
  282. into WP5 or WP6, and then save it.  FONTLIST should then produce a
  283. better list of fonts.
  284.  
  285. Third, WP6 may list fonts in sizes you did not think you used.  Because
  286. you select a font name and a point size separately in WP6, the list may
  287. show combinations of names and point sizes that were not used.  And if
  288. you use a character not in a font's character set, WP6 may use
  289. unexpected fonts for that character, with resulting surprises in the
  290. list.
  291.  
  292. Output for WP5 files lists the fonts in the order found.  Output for
  293. WP6 fonts lists them in alphabetical order.  Output for WP6 also
  294. indicates whether the font is installed via the PRS file or the DRS
  295. file.  Generally, scalable fonts will be installed in the DRS file.
  296. Some WP6 files do not include a list of fonts used, but do include
  297. identification of each font indicated as intended for use.  If there is
  298. no list of fonts in the file, FONTLIST lists the individual fonts as
  299. intended, but the point size is not indicated.  The PRS and DRS
  300. designations may not be meaningful in that case.
  301.  
  302.  
  303. Usage:  FONTLIST Infile
  304.  
  305.                  Infile is a WP5 or WP6 document file.
  306.  
  307.                  Output goes to standard output.
  308.  
  309.  
  310. V.       MERGESUM
  311.  
  312. MERGESUM extracts document summaries from WP6 files and writes or
  313. appends them, along with DOS file directory information, to a WP6 data
  314. text file (secondary merge file).  The result is a database of document
  315. summaries.  You can then use the WP6 Merge and Sort functions to
  316. manipulate the output, creating whatever reports you desire.  If you
  317. then convert the WP6 file to a WP5 secondary merge file, you can also
  318. use WordPerfect's Notebook program, a part of Office and Library, or
  319. its DB program, a part of WordPerfect Works, to display and manipulate
  320. the document summaries.  MERGESUM can therefore be the basis of a
  321. simple system of document management.
  322.  
  323. Every MERGESUM output file includes the following fields, which are
  324. taken from the DOS directory information, not the document summary:
  325.  
  326.          1:      Volume Label
  327.          2:      File path (directory)
  328.          3:      File name (without extension)
  329.          4:      File extension
  330.          5:      File size (bytes, 7 column field, right justified)
  331.          6:      File date (yyyy/mm/dd) from DOS directory (this is the
  332.                  same as the Revision Date in the document summary)
  333.  
  334. The remaining fields in the output file depend on your choices.  By
  335. default, MERGESUM uses the same fields as are the default fields in a
  336. WP6 document summary.  They appear in alphabetical order.  Thus, by
  337. default, the remaining fields are the following:
  338.  
  339.          7:      Abstract
  340.          8:      Account
  341.          9:      Author
  342.          10:     Creation Date (yyyy/mm/dd)
  343.          11:     Descriptive Name
  344.          12:     Descriptive Type
  345.          13:     Keywords
  346.          14:     Subject
  347.          15:     Typist
  348.  
  349. Note that Revision Date, although one of the default document summary
  350. fields, does not appear on this list, because it is always included as
  351. Field 6 in the secondary merge file.
  352.  
  353. Using a configuration file, as described below, you can select other
  354. fields to appear after the first six fields in the output secondary
  355. merge file.  You specify them by number.  The numbers assigned to each
  356. of the predefined fields in the document summary are indicated in the
  357. following list:
  358.  
  359. 1        Abstract
  360. 2        Account
  361. 3        Address
  362. 4        Attachments
  363. 5        Author
  364. 6        Authorization
  365. 7        Bill To
  366. 8        Blind Copy
  367. 9        Carbon Copy
  368. 10       Category
  369. 11       Checked By
  370. 12       Client
  371. 13       Comments
  372. 14       Creation Date
  373. 15       Date Completed
  374. 16       Department
  375. 17       Descriptive Name
  376. 18       Descriptive Type
  377. 19       Destination
  378. 20       Disposition
  379. 21       Division
  380. 22       Document #
  381. 23       Editor
  382. 24       Forward To
  383. 25       Group
  384. 26       Keywords
  385. 27       Language
  386. 28       Mail Stop
  387. 29       Matter
  388. 30       Office
  389. 31       Owner
  390. 32       Project
  391. 33       Publisher
  392. 34       Purpose
  393. 35       Received From
  394. 36       Recorded By
  395. 37       Recorded Date
  396. 38       Reference
  397. 39       Revision Date [always included as Field 6]
  398. 40       Revision Notes
  399. 41       Revision #
  400. 42       Section
  401. 43       Security
  402. 44       Source
  403. 45       Status
  404. 46       Subject
  405. 47       Telephone #
  406. 48       Typist
  407. 49       Version Date
  408. 50       Version Notes
  409. 51       Version #
  410.  
  411.  
  412. Obviously, you would want MERGESUM to include those fields you have
  413. chosen to have appear in your document summaries.  Specified fields
  414. that are not in document summaries appear in the output file as blank
  415. fields.
  416.  
  417. With two exceptions, Fields 7 and up in the output record for a file
  418. contain whatever is found in the corresponding field in the document
  419. summary.  The first exception is that dates include only the year,
  420. month, and day (and always in the format yyyy/mm/dd, for convenient
  421. sorting).  The second exception is the Abstract field.  By default, if
  422. you select the Abstract field, the Abstract field in the output will
  423. contain whatever the Abstract field contained in the document summary.
  424. However, you can specify that it instead contain roughly the first 400
  425. characters of the document itself (a) always, (b) if there is no
  426. document summary in the document, (c) if there is a document summary
  427. but it does not contain an Abstract field, or (d) if there is a
  428. document summary with an Abstract field, but the Abstract field is
  429. empty (blank).
  430.  
  431. By default, the output file does not include records for WP6 document
  432. files that lack document summaries.  However, DOS directory information
  433. for these files is available.  One option (-S) writes this information
  434. to standard output, so you can capture it to an ASCII text file or send
  435. it to the printer.  You can also choose to include records for these
  436. files in the output file, using just the DOS file directory information
  437. (-A) or also including the first roughly 400 characters of the document
  438. text as the abstract (-C) (assuming you selected Abstract as one of the
  439. fields in the output).
  440.  
  441. MERGESUM permits use of an "indirect" input file specification.  If an
  442. input file name on the command line is preceded by @ (e.g.,
  443. @c:\wp60\flist), the file is not a WP6 document, but an ASCII text file
  444. containing a list of input file specifications, one per line. (If you
  445. want to use MERGESUM on a WP6 file whose name begins with @, you must
  446. specify that file in an indirect file, not on the command line.)
  447.  
  448.  
  449. Usage:  MERGESUM Infile [Infile] -oOfile [-Gconfigfile] [Options]
  450.  
  451.                  Up to 5 Infiles, which may include wildcards.
  452.  
  453.                  If Infile is specified as @Infile, infile is an ASCII
  454.                  text file containing a list of filenames
  455.  
  456.                  -oOfile the secondary merge output file
  457.  
  458.                  -gConfigfile (Optional)
  459.  
  460.                  Configfile is an ascii text file containing the
  461.                  numbers of the document summary fields you wish to
  462.                  include in the output file.  Fields 1 through 6 of the
  463.                  output will be included in any event.  If you do not
  464.                  include a Configfile, the default fields are selected.
  465.                  If you do include a Configfile, the default fields are
  466.                  NOT selected unless you include their numbers in the
  467.                  Configfile.
  468.  
  469.                  Options: (separated by blanks, e.g., -A -U, or single
  470.                  letter options, but not -D, can be combined, e.g.,
  471.                  -AU)
  472.  
  473.  
  474.                 -U      Update the output file (appends to the output
  475.                         file if it already exists, but does not check
  476.                         for duplicates).  IMPORTANT NOTE: each record
  477.                         in a data file must have the same fields
  478.                         defined, and they must appear in the same
  479.                         order.  Therefore, if you use a Configfile,
  480.                         make sure you use the same Configfile each time
  481.                         you update the output file as you did when you
  482.                         first created the output file.
  483.  
  484.                 -E      Process Infile through directory trEE.  Thus,
  485.                         if an infile is c:\*.* and you use the -E
  486.                         option, MERGESUM will process every file on
  487.                         drive C. Similarly, c:\wp60\*.* with the -E
  488.                         option will process every file in directory
  489.                         c:\wp60 and each of its subdirectories.
  490.  
  491.                 -A      include All WP6 files in Ofile, even if they
  492.                         have no document summary.
  493.  
  494.                 -C      like -A, but includes the beginning of the
  495.                         document text as the Abstract for those files
  496.                         lacking a document summary.
  497.  
  498.                 -B      replace Blank abstract fields by the beginning
  499.                         of the document.
  500.  
  501.                 -R      Replace all abstract fields by the beginning of
  502.                         the document.
  503.  
  504.                 -Dmmddyy or mmddyyyy
  505.  
  506.                         Process only files dated mmddyy or later.  If
  507.                         yy, century is 19.  For months, days, or years
  508.                         less than 10, initial zero must be specified
  509.                         (e.g., 060991).  Year must be greater than 1979
  510.                         and less than 2100.
  511.  
  512.                 -S      information on files with no summaries written
  513.                         to Standard output.
  514.  
  515.                 Note:  You can use -S along with -A or -C.
  516.  
  517.                          Example
  518.  
  519. MERGESUM c:\memos\*.*  c:\notes\*.*  -oe:\admin\mydocs  -CRU  -d010191
  520.  
  521.                 This example processes all the files with DOS file
  522.                 dates (i.e., revision dates) of January 1, 1991, or
  523.                 later in subdirectories memos and notes on drive c:,
  524.                 adding the output to the existing data file
  525.                 c:\admin\mydocs (or creating a new file of that name if
  526.                 one does not already exist).  Files are included in the
  527.                 output whether or not they have document summaries
  528.                 (-C). In all cases, the abstract field in the output
  529.                 consists of the first 400 characters in the document
  530.                 file (-C for documents without document summaries, -R
  531.                 for documents with document summaries).  The default
  532.                 field selections are used.
  533.  
  534.  
  535. The Configuration File
  536.  
  537. The optional configuration file is an ASCII text file, each line of
  538. which specifies one and only one document summary field to include in
  539. the output file.  Fields are indicated by number, and the number must
  540. begin in the first column on the line. You may find it convenient also
  541. to indicate the name of the field on the line.  You can leave a blank
  542. following the number of the field and then enter its name and any other
  543. information you want.  For example, here is what a short configuration
  544. file might look like (remember that the numbers begin at the extreme
  545. left of the line, with no leading blanks):
  546.  
  547. 5 Author
  548. 12
  549. 16 Department
  550.  
  551. This file would cause document summary fields 5 (author), 12 (client),
  552. and 16 (Department) to appear in the output file, in addition to the
  553. six fields that always appear.  Note that because document summary
  554. field 1 (abstract) is not included, abstracts will not appear in the
  555. output file no matter what command line switches you use.
  556.  
  557.  
  558. VI.      SIXPRE
  559.  
  560. A.  WP6 Document Files
  561.  
  562. WP6 document files have two sections:  the prefix (created by WP6),
  563. which contains document default settings, font information, styles,
  564. footnotes, and much more information; and the document body, which
  565. contains text and codes the user entered.  SIXPRE strips certain
  566. information out of the prefix, including both obsolete information
  567. ("deleted data packets") that is simply taking up space unnecessarily,
  568. and other information (depending on your choices).  Much of the
  569. optionally stripped information concerns printers and fonts.  When you
  570. retrieve the stripped file back into WP6, WP6 restores the printer and
  571. font information.  (Note: SIXPRE leaves in the file the information
  572. about which fonts you selected, so the document should use the same
  573. fonts after restoration -- unless they are no longer available.)  The
  574. restored PRS file is the default PRS file at the time you retrieve the
  575. document, not necessarily the original PRS file.
  576.  
  577. The most common reason for using SIXPRE is simply to make document
  578. files smaller, which SIXPRE can do in several ways.  Getting rid of the
  579. obsolete information obviously leads to smaller files.  Getting rid of
  580. printer and font information can save space on disk while you are
  581. simply storing a file; if the file is used again, the information gets
  582. added back.  And once you have finished spell checking a document for
  583. the last time, there is no longer any need to take up space on disk
  584. with the list of words you told the spell checker to skip for this
  585. document only, the document's own dictionary.  You can also use SIXPRE
  586. on macros; none of the information SIXPRE removes from a prefix is
  587. essential to macros (but WPMCRUSH is a better choice for shrinking
  588. macros).
  589.  
  590. SIXPRE's predecessor, FIXPRE, which performs similar functions for WP5
  591. files, is useful in a number of other situations as well.  It often
  592. cures strange and puzzling problems with files.  The same appears to be
  593. true of Sixpre.
  594.  
  595.  
  596. B.  WP6 .SET files
  597.  
  598. SIXPRE can also remove deleted data packets from your WordPerfect 6.0
  599. .SET file, which is usually named WP{WPC}.SET (the .SET file normally
  600. has a different name if you are using WordPerfect on a network).
  601.  
  602.  
  603. C.  Using SIXPRE
  604.  
  605. Usage:  SIXPRE Infile [Outfile] [-Option] . . [-Option]
  606.  
  607.                  Infile is the WP6 document or .SET file to be fixed.
  608.                  May include wildcards, path, and directory.
  609.  
  610.                  Outfile is not required.  It will not be used if
  611.                  Infile contains wildcards.  If Outfile is used, Infile
  612.                  will be unchanged, and the SIXPREd file written to
  613.                  Outfile.  If Outfile is not used, Infile will be
  614.                  renamed (as a backup), and the SIXPREd file will be
  615.                  written under the original Infile name.  The backup
  616.                  file name is based on the Infile name.  It is the main
  617.                  part of the Infile name, with a new extension. The
  618.                  backup file will NOT overwrite any existing file.
  619.                  Suppose the Infile you supply is LETTER.DOC.  The
  620.                  program tries to use the name LETTER.F01 for the
  621.                  backup.  If a file with that name exists, the program
  622.                  tries LETTER.F02, and so on through F99 (where the
  623.                  program gives up and asks you to provide an output
  624.                  file name).  When the program is finished, LETTER.DOC
  625.                  will be the SIXPREd file.
  626.  
  627.  
  628.                  Options:  (Each may be listed with - and separated
  629.                  from the next by a blank, or you may combine options
  630.                  after a single -.  Thus -K -E and -KE are both valid.)
  631.  
  632.                  -K      Kill (do not preserve) the backup file.  The
  633.                          .Fxx file will be deleted when the program
  634.                          finishes.  This option can be DANGEROUS.  Use
  635.                          it only after careful testing shows that
  636.                          SIXPRE will do exactly what you want to do.
  637.  
  638.                  -E      Process input wildcard specification through
  639.                          the directory treE.  For example, if Infile is
  640.                          c:\wp60\*.*, SIXPRE will process all files in
  641.                          c:\wp60 and all files in the tree of
  642.                          subdirectories branching from subdirectory
  643.                          wp51.  Thus it would process all files in
  644.                          subdirectories c:\wp60\memos, c:\wp60\letters,
  645.                          c:\wp60\letters\jan, etc.
  646.  
  647.                  -T      DOS directory entry for the output file has
  648.                          the date and Time of the input file.
  649.                          Otherwise, current date and time are used.
  650.  
  651.                  -A      Process wildcard files only if Archive bit is
  652.                          set.  Useful if you use SIXPRE to save space
  653.                          before backing up your files.  Avoids re-
  654.                          SIXPREing files already backed up.
  655.  
  656.                  The remaining options are ignored if the input file is
  657.                  a setup file.
  658.  
  659.                  -D      With this option, SIXPRE strips only Deleted
  660.                          data packets from the document prefix.
  661.                          Without it, other information is also
  662.                          stripped.
  663.  
  664.                  The remaining options have no effect if -D is chosen.
  665.  
  666.                  No Strip Options:
  667.  
  668.                  -P      With this option, SIXPRE does not strip
  669.                          Printer-related information from the prefix.
  670.                          -P is equivalent to -BLR.  There is little
  671.                          reason to use any of the options PBL and R,
  672.                          and still less reason to use BL or R instead
  673.                          of P.
  674.  
  675.                  -B      Do not strip proportional spacing taBles.
  676.  
  677.                  -L      Do not strip font List.
  678.  
  679.                  -R      Do not strip PRS file information.
  680.  
  681.                  Strip Options:
  682.  
  683.                  -U      Strip document sUmmary.
  684.  
  685.                  -S      Strip all Styles from the prefix (but the
  686.                          similarly-named structures related to
  687.                          graphics, such as box styles, are not
  688.                          stripped; outline styles themselves are not
  689.                          stripped, but the styles for each level of the
  690.                          outline are stripped).  This option has no
  691.                          effect if the "document" has no body.
  692.                          Therefore, the option can be used safely even
  693.                          if the file specification causes SIXPRE to
  694.                          process style libraries.  If you want to
  695.                          delete all styles from the prefix of a style
  696.                          library, you might as well simply delete the
  697.                          file entirely.  Note that stripped styles
  698.                          disappear not only from the prefix, but also
  699.                          from the document (but the codes placed in the
  700.                          document by the style remain).  The effect is
  701.                          equivalent to choosing Delete Leaving Codes
  702.                          from the Style menu in WordPerfect.
  703.  
  704.                  -C      Strip the document's diCtionary.
  705.  
  706.  
  707. WARNING:  If SIXPRE has stripped the printer-related information, do
  708. not attempt to print the document file from disk before WP6 has
  709. restored the printer-related information.
  710.  
  711.  
  712. VII.     SIXTXT
  713.  
  714. In addition to unnecessary bytes in its prefix, a WP6 document also
  715. contains unnecessary bytes in the document text itself.  (Some of these
  716. are in the prefix, because the text of substructures, such as
  717. footnotes, is actually stored in the document prefix.)  Two types of
  718. bytes are unnecessary.  The first has formatting information placed in
  719. the document by WordPerfect itself.  These bytes are unnecessary while
  720. your document is simply stored on disk, because WordPerfect will
  721. recreate them when the document is retrieved.  The second results from
  722. the Undo function.  These bytes are unnecessary because the Undo
  723. function allows you to undo actions taken only within the current
  724. WordPerfect session.  Nevertheless, bytes related to the Undo function,
  725. including deleted text, may be stored in the document.
  726.  
  727. SIXTXT deletes these unnecessary bytes from a document.  The result is
  728. a smaller document, so that you save disk space, although the saving is
  729. not large.  You may want to use both SIXPRE and SIXTXT on a document,
  730. retrieve the document, save it, and then use SIXPRE and SIXTXT again.
  731. This is likely to produce the maximum savings in bytes.
  732.  
  733. Note that SIXTXT also removes identification of the document's PRS file
  734. from the document prefix.  When you retrieve the document after using
  735. SIXTXT, the default PRS file will be selected for use with the
  736. document.  While this may sometimes be inconvenient, it is necessary so
  737. that WordPerfect will know it has to replace missing bytes in the
  738. document.
  739.  
  740. SIXTXT gives you a number of options for processing files.  These are
  741. identical to options available in SIXPRE, and they are more fully
  742. discussed under that heading.
  743.  
  744.  
  745. Usage: SIXTXT Infile [Outfile] [-Option] .. [-Option]
  746.  
  747.                  Infile: WP60 Doc. May include wildcards.
  748.                  Outfile:output file - not used with wildcard input.
  749.                          If no Outfile, output written to Infile,
  750.                          backup created (in .T01 pattern).
  751.  
  752.                  Options: (format: e.g., -K -T or,  e.g., -KT)
  753.  
  754.                  -K      Kills the backup if no outfile specified
  755.                  -T      output gets Time and date of input file
  756.                  -A      process wildcard files only if Archive bit set
  757.                  -E      process wildcard through directory treE
  758.  
  759.  
  760.  
  761. VIII.    STYLIST
  762.  
  763. STYLIST produces a list of up to 1000 styles in document files and
  764. style libraries.  The list includes the filename, the name of the
  765. style, and the style description, as well as code indicating the style
  766. location and style type and whether the style is linked to another
  767. style or includes another style.  By default, the output is sorted by
  768. filename and within filename by style name.  Other sorting options are
  769. available.
  770.  
  771. Here is a small sample of the output, sorted by style name, from
  772. running STYLIST on the single file LIBRARY.STY that comes with WP6.
  773. Usually, of course, the output would be based on many more files.
  774.  
  775. LIBRARY .STY  Caption      O L S - I Caption
  776. LIBRARY .STY  Document     C D - - - Document Style (Turns on Doc Outline)
  777. LIBRARY .STY  FooterA      O L S - I Footer A
  778. LIBRARY .STY  FooterB      O L S - I Footer B
  779. LIBRARY .STY  Header 1     O D - - - Alternating Headers with "Page n"
  780. LIBRARY .STY  HeaderB      O L S - I Header B
  781. LIBRARY .STY  Level 1      P L S - - Level 1
  782. LIBRARY .STY  Outln Tech 1 P D - L - Level 1 for Technical Outline Style
  783.  
  784. The first column is the file name, the second is the extension, and the
  785. third is the style name.  After the style name there are five columns
  786. with a single character each.  The first indicates the type of style (O
  787. for Open, C for Character, P for Paragraph).  The next indicates
  788. whether the style is a document style (D) or a library style (L).  The
  789. third indicates whether it is a system style (S) or not (-).  The
  790. fourth column indicates whether the style is linked to another style
  791. (L) or not (-).  The fifth indicates whether the style includes another
  792. style (I) or not (-).  The last column has the style description.
  793.  
  794.  
  795. Usage:  STYLIST Infile [... Infile] [-sortoption]
  796.  
  797.                  Up to 5 Infiles may include drive, directory, and
  798.                  wildcards.
  799.  
  800.                  Output to standard output
  801.  
  802.                  Sort options (default is sort by filename):
  803.  
  804.                  -N      No sort
  805.                  -D      Sort on style Description
  806.                  -M      Sort on style naMe
  807.                  -T      Sort on style Type (Open, Paragraph, Character)
  808.                  -E      Sort on file Extension
  809.                  -L      Sort on Location (Lib, Doc)
  810.  
  811.                  Example: STYLIST c:\wp\*.sty c:\wp\*.doc -D>styles
  812.  
  813.                  List all the styles in the files in subdirectory c:\wp
  814.                  with extensions .sty and .doc, sorted on the style
  815.                  description, and write the results to the ascii text
  816.                  file Styles in the default directory.
  817.  
  818.  
  819. IX.      SWAPREF
  820.  
  821. SWAPREF changes all the automatic cross references of one type to
  822. another type.  For example, it can make all automatic cross references
  823. to footnotes into cross references to endnotes.
  824.  
  825. The most obvious reason to do this is if you have used the macro that
  826. comes with WP6 to convert all your footnotes to endnotes (or endnotes
  827. to footnotes) in a document.  The macro does not fix up your cross
  828. references.  If you created a document using footnotes and included
  829. statements like "see n. 1 supra" using automatic cross references,
  830. after you convert the footnotes to endnotes and generate the document,
  831. those statements will no longer work, because there are no longer any
  832. footnotes to refer to -- "see n. ? supra" is not quite what you had in
  833. mind.  SWAPREF fixes up the problem.
  834.  
  835. You might also want to, for example, change references to outline
  836. sections to references to pages, simply because you changed your mind
  837. about which is preferable.  In that event, the text ("See section A")
  838. may need changing as well ("See page 1").  For that, you can use the
  839. search and replace function in WP6.
  840.  
  841. SWAPREF cannot handle references to counters.
  842.  
  843. SWAPREF does not change the numbers already generated.  After using
  844. SWAPREF, you must Generate again so that the new references are updated
  845. properly.
  846.  
  847. Usage: SWAPREF Infile Outfile [-Option] .. [-Option]
  848.  
  849.                  Infile is WP6 doc file to change.
  850.                  Outfile is a new file with the changed references
  851.  
  852.                  Options: one or more. Each indicates two types of
  853.                  references and tells SWAPREF to change the first to
  854.                  the second. E.g., -FE changes all Footnote references
  855.                  to Endnote references
  856.  
  857.                  Use these letters:
  858.                  P - Page
  859.                  S - Secondary page
  860.                  C - Chapter
  861.                  V - Volume
  862.                  E - Endnote
  863.                  F - Footnote
  864.                  G - paraGraph/outline number
  865.                  N - caption Numbers
  866.  
  867.  
  868. X.       TARGETS
  869.  
  870. TARGETS lists the automatic reference targets and references in a WP6
  871. document.  It first lists the targets by name, with the number of times
  872. that target name is used.  Targets not referenced in the document are
  873. marked by an asterisk.  The list of targets is followed by a list of
  874. references, which includes the name of the target referenced, the type
  875. of reference, and the number of references of that type to the
  876. particular target.  References to targets not found in the file are
  877. marked with an asterisk.  By default, the line after the listing for
  878. each target or reference lists the page numbers on which that target or
  879. reference can be found.  (For targets or references in notes, the page
  880. listed is the page where the note call appears.)
  881.  
  882.  
  883. Usage:  Targets  Infile  [-n]
  884.  
  885.                  Infile is a WP6 document.
  886.                  Output is written to standard output.
  887.                  -n      Do not include page numbers in output
  888.  
  889.  
  890. XI.      TEXTSIZE
  891.  
  892. TEXTSIZE shows the sizes, in bytes, of the two parts of a WP6 or WP5
  893. document file, the prefix (see discussion under SIXPRE above) and the
  894. body.  It also shows the sum of those two sizes, which is the total
  895. size of the document.  This information may not be useful, but it can
  896. be interesting.  If nothing else, it can help you understand better
  897. what SIXPRE and SIXTEXT do.
  898.  
  899. You should not leap to any conclusions about efficiency from
  900. comparisons of WP6 and WP5 documents with TEXTSIZE.  WP6 stores in
  901. document prefixes a good deal of information that WP5 stores in the
  902. body.  For example, comments, footnotes, header, and footers are all
  903. stored in the WP6 document prefix, but in the WP5 document body.
  904.  
  905.  
  906. Usage: TextSize Infile [-E]
  907.                  Infile: WP5 or WP6 file specification. May include
  908.                  wildcards and full path.
  909.                  -E  process wildcard through directory trEE
  910.                  Output to standard output. Pipe or redirect as needed.
  911.  
  912.  
  913. XII.     WP6LOOK
  914.  
  915. WP6LOOK is a file browsing program for WP6 and WP5 (for simplicity
  916. here, just "WP") document files (but it will also browse other files).
  917. It displays WP document files listed on the command line, supplied in
  918. response to prompts, selected from pick lists, or piped from another
  919. program, such as a file uncompressor.  The document summary is
  920. displayed if it exists.  The program pauses as each screen is
  921. displayed.  If there is more information in the document, you can page
  922. forward.  Generally, you can also page backward, although only for a
  923. few screens (the number varies, but is never more than nine).  At each
  924. screen, you also have the options of going back to the beginning of the
  925. file (Home), jumping to the end of the file, going on to the next file,
  926. adding to the list of files to browse, or quitting the program.  (If
  927. there are no more files, the next file and quit options produce the
  928. same results.)   If you chose the file from a pick list, you can return
  929. to the pick list to select another file.  You can also search for
  930. strings in the displayed file.  And you can "dump" the information on
  931. the screen to an ASCII text file.  The top line of the display
  932. indicates the corresponding WordPerfect page numbers.
  933.  
  934. Because WP6LOOK will accept piped input, it can be used with many file
  935. manager and shell programs to display files.  If the program with which
  936. you want to use it allows you to specify the file browser, you simply
  937. specify WP6LOOK.  Some programs do not allow you to specify the file
  938. browser, and then some ingenuity is required.  For example, QFiler, an
  939. excellent file management program, assumes the file browser is
  940. List.com.  You can use WP6LOOK with QFiler by renaming WP6LOOK.EXE as
  941. List.com.
  942.  
  943. WP6LOOK does not correctly format files, but it usually does a
  944. reasonable approximation.  The program is designed for use when you
  945. need to rummage through one or more WP documents quickly (or when not
  946. enough memory is available to use WP itself), not for when you care
  947. about the details of formatting.  Here are some of the formatting
  948. problems:
  949.  
  950.          By default, WP6LOOK reformats documents so that they fit
  951.          within the confines of the screen width (although an option
  952.          allows lines of up to 254 characters, so that you must scroll
  953.          the screen to see the entire line).  Paragraphs are
  954.          reformatted by default to a 75-character line, although you
  955.          can change the number; the right margin is ragged, because
  956.          WP6LOOK does not hyphenate.  Margin changes and line spacing
  957.          are ignored.  Multiple columns are placed end to end.
  958.  
  959.          Everything is displayed in the same font.
  960.  
  961.          Tab settings are ignored.  Ordinary tabs are displayed as five
  962.          spaces, more exotic tabs as a single space.  Indent codes are
  963.          all treated as ordinary, not left-right.  An indent code is
  964.          represented as five spaces.  Indented text is indented five
  965.          spaces, regardless of how deeply the text is indented.
  966.  
  967.          Characters a standard IBM PC cannot display and overstruck
  968.          characters are displayed as upside down question marks.
  969.  
  970.          Footnotes and endnotes are displayed embedded in the text
  971.          where they occur.  They are set off by line breaks and
  972.          enclosed between markers (each on its own line) identifying
  973.          them.  The markers are slightly different for WP6 and WP5, and
  974.          for WP5 there is no difference in marking between footnotes
  975.          and endnotes.  The footnote (or endnote) number is indicated
  976.          for WP6 but not WP5.
  977.  
  978.          Initial codes are ignored.
  979.  
  980.          Text within boxes is displayed.  Other box content (graphics,
  981.          equations) is ignored, although the presence of a box is
  982.          indicated and the caption is displayed.
  983.  
  984.          Tables are not displayed as tables.  The cells are listed in
  985.          sequence, identified by row and column.  Certain kinds of cell
  986.          contents are not displayed.
  987.  
  988.  
  989. If a file selected for viewing is not a WP document file (and if you
  990. are not using piped input), the file is also displayed -- but in a very
  991. different way, with a different kind of display and a different set of
  992. commands.  This alternative display mode is described below.
  993.  
  994.  
  995. Usage:  WP6LOOK  [options] [Infile] .. [Infile]
  996.  
  997.  
  998.          Options and Infiles may appear in any order.  Infile may
  999.          include wildcards.  You may specify as many Infiles as fit on
  1000.          the command line.  If no input file is specified and input is
  1001.          not piped to the program, you are prompted for a file
  1002.          specification.  If the input file specification you supply in
  1003.          response to the prompt contains wildcards, you are asked
  1004.          whether you want to view all files matching the file
  1005.          specification.  If you response N (for no), a list of files
  1006.          matching the file specification is displayed.  You may browse
  1007.          this list using standard cursor movement keys and select a
  1008.          single file to browse by hitting the Return key while the file
  1009.          is highlighted.
  1010.  
  1011.          Options
  1012.  
  1013.          -R(Y/N) Reformat text.  The default is RY.  If you select RN,
  1014.                  text is not reformatted, and the display may be
  1015.                  scrolled so that you can view long lines.
  1016.  
  1017.          -P      Pick list.  If you have wildcard file specifications
  1018.                  on the command line, -P produces a pick list (for the
  1019.                  first file specification, and later for the others
  1020.                  when they are encountered as files are processed)
  1021.                  instead of a display of the first file matching the
  1022.                  wildcard specification.
  1023.  
  1024.          -M      Force Mono.  If you have a color computer system and
  1025.                  do not like WP6LOOK's color choices, use this option.
  1026.  
  1027.          -Wnn    Screen Width in characters (default is -W75).  This
  1028.                  option is like key W, discussed below.  It has no
  1029.                  effect if you select RN.
  1030.  
  1031.          -H      Displays help messages.
  1032.  
  1033.          -?      Same as -H
  1034.  
  1035. The command line options (other than -H and -?) may also be provided by
  1036. means of a configuration file.  On startup, WP6LOOK looks for a
  1037. configuration file, WP6LOOK.CFG, in the default directory and then, if
  1038. you are using DOS 3.0 or greater, in the directory where WP6LOOK is
  1039. located.  The configuration file is an ASCII text file that includes
  1040. one or more of the command line options, one per line, exactly as they
  1041. would appear on the command line.  (If you include an option in the
  1042. configuration file and also on the command line, the command line
  1043. option overrides the option selected in the configuration file.)
  1044.  
  1045. Once the program starts, operation with WP files is prompted and for
  1046. the most part intuitive.  The bottom screen line indicates which
  1047. keystroke options may be chosen (except for W, D, P, and Alt- F, which
  1048. are never indicated explicitly).  In some cases, you can use different
  1049. keystrokes to achieve the same result.  The prompt does not indicate
  1050. that flexibility.  Here is the full set of options, only some of which
  1051. may be available at particular screens:
  1052.  
  1053.  
  1054.          Move one screen forward:        PgD, [space], [return]
  1055.          To last screen in file:         [End]
  1056.          Move one screen Back:           PgU, b, B
  1057.          To first screen in file:        [Home]
  1058.          To next file (or pick list
  1059.           if you started there):         N
  1060.          New file spec:                  Alt-F
  1061.          Scroll right (left):            -> (<-)
  1062.          Scroll full left:               Ctrl <-
  1063.          Exit from the program:          Q, [esc], F7
  1064.          Search (exact match):           S
  1065.          Find (match ignoring case):     F
  1066.          Line Width: 10-80 chars:        W
  1067.          Dump screen to file:            D
  1068.          Display Pick List               P, F5
  1069.  
  1070. Displaying Pick Lists
  1071.  
  1072. Choosing P (or F5) displays the pick list generated from the most
  1073. recently evaluated wildcard file specification.  Normally this will be
  1074. the wildcard specification that resulted in the file you were viewing
  1075. when you chose P, but it will not always be.  Note also that if you
  1076. used a pick list to select the file currently displayed, the N command
  1077. returns you to a pick list.
  1078.  
  1079.  
  1080. New File Spec
  1081.  
  1082. Alt-F allows you to add a file specification to those you are already
  1083. browsing.  The prompts work in much the same manner as the prompts
  1084. resulting from omitting file specifications from the command line.
  1085. Alt-F in effect interrupts the sequence of files to be browsed and
  1086. begins a new sequence.  After the program finishes browsing the files
  1087. resulting from Alt-F, it returns to the sequence it had temporarily
  1088. abandoned.
  1089.  
  1090.  
  1091. Searching and Finding
  1092.  
  1093. Search and Find prompt for a search string.  Search looks for an exact
  1094. match to your search string.  Find looks for a match but ignores
  1095. differences in case.  (Searching for cat will not match CAT, but
  1096. Finding cat will match CAT.)  If you have previously done a Search or
  1097. Find in the same WP6LOOK session, you will be shown your previous
  1098. search string.  If you want to use the same search string, simply hit
  1099. <Enter>.  You can also edit the search string.  If the first keystroke
  1100. you hit is a character rather than an editing key, the previous search
  1101. string will disappear, and you simply enter (and edit) a new one.  If
  1102. you are using the RN option, the match may not be located in the
  1103. visible part of the screen, but you can scroll the screen to view it.
  1104.  
  1105. Search and Find search from the currently displayed screen to the end
  1106. of the file.  The first screen containing a match is displayed, with
  1107. each line containing the match highlighted.  After each match, you are
  1108. asked whether you want to continue looking for the same string.  To
  1109. search the entire file, you must start the search at the beginning of
  1110. the file (which you can reach with the Home key).
  1111.  
  1112. Leading and trailing blanks in the search string can be used if you
  1113. want to limit searches to matching whole words.  For this purpose,
  1114. screen display lines of your WP document file are treated as beginning
  1115. and ending with blanks.  The search string may include blanks, so you
  1116. can search for phrases (limited to 60 characters).  However, matches
  1117. are limited to a single line if a phrase is split between lines in the
  1118. display, you cannot match it.
  1119.  
  1120. The search string can be edited using the cursor keys and other keys.
  1121. WordStar editing commands are also available.  A complete list of
  1122. editing commands follows (commas indicate alternatives):
  1123.  
  1124.  
  1125.          <Enter> (<Return>)      Accept line
  1126.          <Esc>                   Quit without changing line; don't search
  1127.          <Left>,<CtrlS>          Cursor left one character
  1128.          <Right>,<CtrlD>         Cursor right one character
  1129.          <CtrlLeft>,<CtrlA>      Cursor left one word
  1130.          <CtrlRight>,<CtrlF>     Cursor right one word
  1131.          <Home>,<CtrlQ><S>       Cursor to line beginning
  1132.          <End>,<CtrlQ><D>        Cursor to line end
  1133.          <Del>,<CtrlG>           Delete character at cursor
  1134.          <Bksp>,<CtrlH>,<CtrlBksp>Delete character to left of cursor
  1135.          <CtrlEnd>,<CtrlQ><Y>    Delete to end of line
  1136.          <CtrlY>, <CtrlX>        Delete entire line
  1137.          <CtrlHome>              Delete from beginning of line
  1138.          <CtrlT>                 Delete word to right of cursor
  1139.          <Ins>                   Toggle insert mode on or off.  Size of
  1140.                                  cursor indicates the mode.  Default is
  1141.                                  insert mode off.
  1142.          <CtrlR>,<CtrlQ><L>      Restore original contents of line
  1143.                                  after editing
  1144.  
  1145. These editing commands work with responses to other prompts as well.
  1146.  
  1147.  
  1148. Dumping Screens to a File
  1149.  
  1150. When you type a D to dump a screen to an ASCII text file, you are asked
  1151. for a file name.  The next time you type a D, the same file name will
  1152. be proposed.  Hit Return to append to that file, or enter a new file
  1153. name to use a different file.
  1154.  
  1155.  
  1156. Piped Input
  1157.  
  1158. Piped input can present problems when more than one file is piped.
  1159. Suppose you want to pipe all the files in MYDOCS.ZIP to WP6LOOK, using
  1160. Phil Katz's PKUNZIP program.  The command line would look something
  1161. like this:
  1162.  
  1163.          >PKUNZIP -c MYDOCS |WP6LOOK
  1164.  
  1165. This works well if all the files in MYDOCS.ZIP are WP document files.
  1166. It will also work well if all the files that are not WP document files
  1167. are extracted before the WP document files are extracted.  But if the
  1168. WP document files are interspersed with the other files, there can be a
  1169. problem.  The reason is that when input is piped, WP6LOOK can locate
  1170. the beginning of a WP document file, but it cannot locate the end of a
  1171. WP document file.  So once WP6LOOK begins processing a piped WP
  1172. document file, it will continue processing until either the end of all
  1173. piped input or the beginning of the next WP document file.  Thus an
  1174. ASCII file which follows a WP document file in a stream of piped input
  1175. will be displayed as part of the preceding WP document file.  The same
  1176. is true of binary files, such as EXE and COM files.  However, binary
  1177. files may contain information that will cause WP6LOOK to behave in very
  1178. strange ways.
  1179.  
  1180.  
  1181. Browsing non-WP files
  1182.  
  1183. If WP6LOOK finds a file that is not a WP document file, it displays it
  1184. in an entirely different way -- the screen looks different, and there
  1185. are different commands.  The display is not page oriented. Instead, you
  1186. can simply scroll backwards and forwards.
  1187.  
  1188. Here is a summary of the commands:
  1189.  
  1190. Cursor movement:  The cursor arrow keys move you one line, or one
  1191. column, in the appropriate direction.  <CtrlRight> and <CtrlLeft> move
  1192. ten columns right or left.  <Home> moves to the first column, <End>
  1193. moves to display the end of the longest line on screen.  <PgUp> and
  1194. <PgDn> scroll one screen up or down.  <CtrlPgUp> and <CtrlPgDn> move to
  1195. the beginning or the end of the file.  (For all these movements,
  1196. WordStar-like commands also work.)  To jump to a particular line, use
  1197. <CtrlJ><L> and you will be prompted for the line number.
  1198.  
  1199. Searching and Finding:  To search for a string, use S or F (or
  1200. <CtrlQ><F>).  You will be prompted for a string, as in WP display mode.
  1201. After you have entered the string, you will be prompted for options;
  1202. enter as many as you need.  Option U yields a case-insensitive search
  1203. (like Find in WP5 mode); otherwise the search is case sensitive (like
  1204. Search in WP5 mode).  Option G searches the entire file, instead of
  1205. just from the cursor.  Option B searches backward instead of forward.
  1206. To repeat the last search, use <CtrlL>.
  1207.  
  1208. Other Commands:  <CtrlH> toggles between the normal ASCII display mode
  1209. and hex mode.  <CtrlQ><H> strips the high bit of each character, which
  1210. is useful for viewing WordStar files.  <CtrlQ><T> toggles the display
  1211. of tabs between spaces and tab characters.  <esc>, <Q>, and <F7> exit
  1212. from the program.  <N>, <P>, and <F5> all exit from the display of the
  1213. particular file;  if you selected the file from a pick list, you are
  1214. returned to the pick list, and otherwise you move to the next file.
  1215.  
  1216.  
  1217. Memory Requirements
  1218.  
  1219. WP6LOOK takes a fair amount of memory.  Loading the program requires
  1220. about 175K, and once loaded the program demands additional memory.  If
  1221. not enough is available to meet the demand (the amount demanded depends
  1222. on the dimensions of your screen display), the program exits with an
  1223. explanation.  Beyond that point, insufficient memory may affect program
  1224. functions.  The number of screens you can move backward is limited by
  1225. memory -- with tight memory constraints, there may be no ability to
  1226. move backward.  Display of non-WP files requires additional memory,
  1227. which may not be available.  It is even possible there will not be
  1228. enough memory to display a pick list under certain circumstances.
  1229.  
  1230.  
  1231. XIII.    WPMCRUSH
  1232.  
  1233. WPMCRUSH makes macros smaller in several different ways, which serve
  1234. several different purposes.  A WP6 macro file has two parts, the text
  1235. (or "source code"), which is just ordinary document text, and the
  1236. executable code, which is stored in the prefix, and which WordPerfect
  1237. creates when it "compiles" the macro.  WPMCRUSH always removes from the
  1238. prefix of a macro file all the information that is not related to the
  1239. executable code (except for the document summary, but you can also
  1240. delete that if you wish), which is all WordPerfect needs to run the
  1241. macro.  Depending on the options you select, it will also remove the
  1242. source code, or the executable code, but never both at the same time.
  1243.  
  1244. Once you have finished writing and debugging a macro, you no longer
  1245. need to keep the source code in the file with the executable macro
  1246. code, because WordPerfect needs only the executable code to run the
  1247. macro.  (You should, of course, save the source code in case you ever
  1248. want to modify the macro, but you can save that in another file.
  1249. WPMCRUSH by default always makes a backup, which you should generally
  1250. keep.)  By default, WPMCRUSH deletes not only the prefix information
  1251. not necessary for running the macro (except the document summary), but
  1252. also the source code.  Whenever WPMCRUSH deletes the source code, it
  1253. also changes the byte in the macro that tells WordPerfect that the file
  1254. is a WP6 document file.  This means you can no longer retrieve the
  1255. macro file into WordPerfect (although you can still run the macro).
  1256. The resulting file format is identical to the file format WordPerfect
  1257. Corporation uses for the Coaches it distributes with the program.  The
  1258. file type is changed because if you retrieve and then save a macro file
  1259. that has no source code, the executable code will also disappear,
  1260. leaving you with a useless file.
  1261.  
  1262. If you delete the source code from a macro, only the file name (or what
  1263. the macro displays on the screen when it runs) indicates what the macro
  1264. does, and it is easy to forget what it does.  You may therefore want to
  1265. put some explanation into the document summary.  However, because
  1266. WPMCRUSH changes the file identification byte when it deletes the
  1267. source code, you cannot read the document summary using WordPerfect (or
  1268. WP6LOOK or MERGESUM).  But you can use WPMSUM, described below, to read
  1269. the document summary.  If you do not want to use the document summary
  1270. for this purpose and the file contains one, you can delete it with the
  1271. -U option.
  1272.  
  1273. You can also tell WPMCRUSH to preserve the source code.  This will
  1274. reduce the size of the macro file by getting rid of unnecessary prefix
  1275. information, while still leaving a modifiable macro.  (The file will
  1276. still be identified as a WP6 macro file.)  But you will lose certain
  1277. kinds of formatting information, such as styles.
  1278.  
  1279. Finally, you can tell WPMCRUSH to delete the executable macro code.
  1280. (If you tell WPMCRUSH to delete the executable macro code, it will not
  1281. delete the source code even if you tell it to delete the source code.)
  1282. The macro must then be compiled again before it can be run.  This
  1283. format is useful if you wish to transmit the file electronically so
  1284. someone else can use the macro.  By reducing the file size in this way,
  1285. you save transmission time.  It is also useful if you want to archive
  1286. the source code while keeping the executable macro on your hard disk.
  1287.  
  1288.  
  1289. Usage:  WPMCrush Infile [Outfile] [-Option] .. [-Option]
  1290.  
  1291.                  Infile: WP60 Macro. May include wildcards.
  1292.                  Outfile:Crushed macro - not used with wildcard input.
  1293.                          If no outfile, output written to Infile,
  1294.                          backup created (in .M01 pattern).
  1295.  
  1296.                  Options: (format: e.g., -K -T or,  e.g., -KT)
  1297.  
  1298.                  -K      kills the backup if no outfile specified
  1299.                  -T      output gets new time and date
  1300.                  -A      process wildcard files only if archive bit set
  1301.                  -E      process wildcard through directory trEE
  1302.                  -S      preserve Source text
  1303.                  -U      delete document sUmmary
  1304.                  -N      Non-running macro (executable code deleted)
  1305.  
  1306.  
  1307. XIV.     WPMSUM
  1308.  
  1309. WPMSUM extracts document summaries and writes them, in more or less the
  1310. format displayed by WP6LOOK, to standard output.  You can, of course,
  1311. pipe the output to another program or redirect to your printer or a
  1312. file.
  1313.  
  1314. Although WPMSUM will extract the document summary from any WP6 file
  1315. that has one, for most users it is useful mainly because it, unlike
  1316. WP6, MERGESUM, or WP6LOOK, will allow you to examine the document
  1317. summary of a macro that has been protected so that you cannot retrieve
  1318. it into WP6.  WPMCRUSH produces such macros.  And the Coaches that ship
  1319. with WP6 are also macros of this kind.  If you want to read the
  1320. document summaries of these files, WPMSUM may be your only alternative.
  1321.  
  1322. If you use 4DOS (or NDOS), there is another use for WPMSUM.  When used
  1323. in conjunction with awk, it can turn your WP6 descriptive filenames
  1324. into 4DOS file descriptions, so that a 4DOS directory listing will show
  1325. those names.  awk is a very handy cross between a utility program and a
  1326. programming language.  Originally a Unix program, it has been ported to
  1327. DOS.  At least two DOS versions of awk that will serve the purpose
  1328. (MAWK, version 1.1.1 or later) and GAWK (Version 2.15 is suitable;
  1329. perhaps earlier ones are also) are available for use without charge.
  1330. You can find them on various BBS systems, commercial services, and ftp
  1331. sites.  Instructions for handling the descriptive filenames are given
  1332. below.
  1333.  
  1334.  
  1335. Usage: WPMSUM Infile [-Option] .. [-Option]
  1336.  
  1337.                  Infile: WP6 macro or WP6 document). May include wildcards.
  1338.  
  1339.                  Options:(format: e.g., -A -E or,  -AE)
  1340.  
  1341.                  -A      process wildcard files only if archive bit set
  1342.                  -E      process wildcard through directory trEE
  1343.  
  1344.          Output to standard output. Pipe or redirect as needed.
  1345.  
  1346.          Example
  1347.  
  1348.          WPMSUM C:\WP60MAC\WPCH*.WPM |MORE
  1349.  
  1350.          Extracts the documents summaries of all the WordPerfect
  1351.          coaches and pipes them to MORE for reading.
  1352.  
  1353.  
  1354. Moving Descriptive Filenames to 4DOS
  1355.  
  1356. To move WP6 descriptive filenames to 4DOS descript.ion files as
  1357. descriptions, simply run this 4DOS batch file (see the REM lines in the
  1358. batch file for further instructions):
  1359.  
  1360. REM This NDOS (4DOS) batch file takes a wildcard filespec
  1361. REM on the command line.  For any files matching the wildcard
  1362. REM filespec, it extracts the WP6 descriptive file name and makes
  1363. REM that the description of the file in the NDOS (4DOS) descript.ion
  1364. REM file for the appropriate directory, assuming there is not already
  1365. REM a description for that file in descript.ion.
  1366. REM As written, this batch file requires that ATTRIB, WPMSUM, and
  1367. REM MAWK be in the current directory or pathed, and that sum.awk be
  1368. REM in the current directory.  ATTRIB is a utility included with DOS.
  1369.  
  1370. @echo off
  1371. if ".%1"=="." quit
  1372. set df=%@path[%@full[%1]]descript.ion
  1373. attrib -H %df%
  1374. wpmsum %@full[%1] | mawk -f sum.awk -v descfile=%df%
  1375. attrib +h %df%
  1376.  
  1377.  
  1378. Here is the awk program sum.awk that the batch file requires:
  1379.  
  1380. # This awk script was written to be used with MAWK 1.1.1.
  1381. # It should work with other versions of new awk, except that
  1382. # it assumes a built-in function tolower, which many awks do not
  1383. # include.  But you can write a tolower function.  The function should
  1384. # lower case a string.
  1385.  
  1386. BEGIN{ while (getline < descfile > 0)
  1387.               ion[tolower($1)] = 1
  1388.               close(descfile)
  1389. }
  1390. /^FILE:/{file = $NF}
  1391. /^DESCRIPTIVE NAME:/{file = getname(file)
  1392.                   if (file in ion)
  1393.                      ;
  1394.                    else
  1395.                    print file, substr($0,19,40) >>descfile
  1396.                   }
  1397. function getname(f,   a,n)
  1398.  {n=split(f,a,"\\")
  1399.   a[n] = tolower(a[n])
  1400.   return a[n]
  1401.  }
  1402.  
  1403.  
  1404. XV.      5or6
  1405.  
  1406. 5or6 allows a batch file to determine whether another file is a WP5.0,
  1407. WP5.1, or WP6.0 document file (WP5.2 files are identified internally as
  1408. WP5.1 files, so 5or6 reports them as 5.1 files).  It does this by
  1409. setting the DOS errorlevel.
  1410.  
  1411.  
  1412. Usage: 5or6 Infile
  1413.  
  1414.          Resulting errorlevel:
  1415.  
  1416.          50      WP50 document file
  1417.          51      WP51 document file
  1418.          60      WP60 document file
  1419.          98      Other file
  1420.          99      File not found, etc.
  1421.  
  1422.  
  1423. If WordPerfect Corporation follows its recent pattern, a WordPerfect
  1424. 6.1 file should produce an error level of 61, and so forth.  Of course,
  1425. at this point there is no way to be certain.
  1426.  
  1427. How can you use this?  Suppose you had all your WordPerfect files in a
  1428. single directory but wanted to separate them out so that the 6.0 files
  1429. were in subdirectory WP60, the 5.1 files in subdirectory WP51, and the
  1430. 5.0 files in subdirectory WP50, while leaving all other files uncopied.
  1431. The following two batch files would handle the problem.
  1432.  
  1433.          First batch file:
  1434.  
  1435.          for %%f in (*.*) do call mover %%f
  1436.  
  1437.  
  1438.          Second batch file (Mover.bat)
  1439.  
  1440.          5or6  %1
  1441.          if errorlevel 98 goto quit
  1442.          if errorlevel 60 goto WP60
  1443.          if errorlevel 51 goto WP51
  1444.          if errorlevel 50 goto WP50
  1445.          goto quit
  1446.          :wp60
  1447.          copy %1 \wp60
  1448.          goto quit
  1449.          :wp51
  1450.          copy %1 \wp51
  1451.          goto quit
  1452.          :wp50
  1453.          copy %1 \wp50
  1454.          :quit
  1455.  
  1456.  
  1457. You might also find 5or6 helpful if certain of your programs work with
  1458. 5.1 files but not 6.0 files.
  1459.  
  1460.  
  1461.                               GETTING HELP
  1462.  
  1463.  
  1464. Help in using 6TOOLS is available by mail, telephone, and several forms
  1465. of E-mail.  The best time for telephone calls is weekdays 8pm-11pm
  1466. Eastern time.  At other hours, you are likely to reach only an
  1467. answering machine.  E-mail and fax are recommended.
  1468.  
  1469. David Seidman
  1470. Software by Seidman
  1471. 2737 Devonshire Pl. NW
  1472. Washington, DC 20008
  1473. 202/462-7381
  1474. FAX: 202/462-8601
  1475. CompuServe: [70441,2414]
  1476. Internet: 70441.2414@Compuserve.com
  1477. GEnie: D.SEIDMAN
  1478.  
  1479.  
  1480.                           LICENSE INFORMATION
  1481.  
  1482.  
  1483. 6TOOLS is not in the public domain.  Both the collection and the
  1484. individual programs are fully protected by copyright.
  1485.  
  1486. For purposes of evaluation and testing only, some of the programs in
  1487. 6TOOLS are distributed as shareware, along with the documentation in
  1488. ASCII format only.  The first page of this documentation indicates
  1489. which 6TOOLS programs are included in the shareware distribution.  As
  1490. to those programs and the ASCII documentation only, everyone is granted
  1491. without charge a license which permits (a) use of the programs for a
  1492. period of 30 days for evaluation and testing; (b) making copies for
  1493. distribution to others without charge, provided the programs and the
  1494. accompanying documentation are distributed together and without
  1495. modification; (c) posting the programs, together with the accompanying
  1496. documentation, on electronic bulletin board systems.  The permissions
  1497. granted in this paragraph do NOT apply to the programs, indicated on
  1498. the first page of this documentation, that are NOT included in the
  1499. shareware distribution.
  1500.  
  1501. Use after the 30 day evaluation and testing period requires payment of
  1502. a license fee (sometimes referred to as a registration fee).  For a
  1503. single copy (plus necessary archival copies), to be used on only one
  1504. computer at a time, the fee is $25.00.  For large quantities, discounts
  1505. and site licenses are available.  Write for information.  Any license
  1506. for which payment is properly made is valid for this version of 6TOOLS
  1507. and all subsequent minor version changes.  For major version changes
  1508. (the major version is indicated by the number to the left of the
  1509. decimal point -- this version is 1.0, and the next major version would
  1510. be 2.0), we reserve the right to charge a license upgrade fee, but we
  1511. may or may not require such a fee for major version upgrades.
  1512.  
  1513. What do you get for your license fee?  You get the latest version of
  1514. the all the 6TOOLS programs, including the programs which are not
  1515. distributed for evaluation.  You get permission to use the programs on
  1516. a one computer at a time (and to make archival copies).  You get the
  1517. warm feeling that you are not violating the copyright laws.  You get a
  1518. copy of the complete documentation in WordPerfect format.  We will
  1519. generally send you notification of new versions.  And if you let us
  1520. know about any problems you have with the programs, we will try to
  1521. solve them.
  1522.  
  1523. The United States Department of Justice is granted a license, without
  1524. payment of fee, for all official use of 6TOOLS.
  1525.  
  1526.                           WARRANTY INFORMATION
  1527.  
  1528.  
  1529. These programs are distributed without warranties of any kind, express
  1530. or implied, including, but not limited to, the implied warranties of
  1531. merchantability and fitness for a particular purpose.
  1532.  
  1533. No representation or other affirmation of fact, including but not
  1534. limited to statements regarding suitability for use, or performance of
  1535. the programs, shall be or be deemed a warranty by the licensor for any
  1536. purpose, nor give rise to any liability or obligation of the licensor
  1537. whatever.
  1538.  
  1539. In particular, no statement in program documentation shall be deemed a
  1540. representation or warranty that the programs will perform in any
  1541. particular manner, or perform in any manner whatsoever, or that the
  1542. programs are suitable for any particular use or any use at all.
  1543.  
  1544. ************************************************************************
  1545.  
  1546.                                 INVOICE
  1547.  
  1548.  
  1549. David Seidman
  1550. Software by Seidman
  1551. 2737 Devonshire Place, N. W.
  1552. Washington, D. C. 20008
  1553.  
  1554.                                               DATE:
  1555.  
  1556. SOLD TO:
  1557.  
  1558. __________________________
  1559. __________________________
  1560. __________________________
  1561.  
  1562.  
  1563. ┌──────────────────────────────────┬───────┬────────────────────────┐
  1564. │ Description                      │ Qty.  │     Price              │
  1565. │                                  │       │                        │ 
  1566. ├──────────────────────────────────┼───────┼────────────────────────┤
  1567. │                                  │       │                        │
  1568. │ Licensed copy of 6TOOLS @US$25.00│       │      $_____.__         │
  1569. │                                  │       │                        │
  1570. │ Licensed copy of 6TOOLS for      │       │       _____.__         │
  1571. │  registered user of WPTOOLS      │       │                        │
  1572. │                        @US$15.00 │       │       _____.__         │
  1573. │                                  │       │                        │
  1574. │                                  │       │                        │
  1575. └──────────────────────────────────┴───────┴────────────────────────┘
  1576.  
  1577.                                 Total:       $_____.__
  1578.  D.C. Residents add 6% D.C. Sales Tax:          ___.__
  1579.  
  1580.                          Total Charge:       $_____.__
  1581.  
  1582.  
  1583. Make checks payable to Software by Seidman.  Please mark checks
  1584. "6TOOLS".
  1585.  
  1586. For Credit Card orders, Circle one:   VISA   MasterCard  Diners Club
  1587.  
  1588. Card Number:     __________________________  Exp. Date: _____________
  1589.  
  1590. Name on card:    __________________________________________________
  1591.  
  1592. Signature:       __________________________________________________
  1593.  
  1594.