home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 203.lha / WP_Util / fileconvert / FC.doc < prev    next >
Text File  |  1988-12-28  |  10KB  |  198 lines
  1.     This article and the accompanying program FC are freely distributable!
  2.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.   
  4.                       _________________________________
  5.                      |                                 |
  6.                      |   WordPerfect File Conversion   |
  7.                      |                                 |
  8.                      |          by Bob Eller           |
  9.                      |_________________________________|
  10.   
  11.   
  12.                          Copyright 1988 AMnews Corp.
  13.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  14.                  In cooperation with WordPerfect Corporation
  15.                  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  16.               Reprinted from New AMnews Vol.1 No.1 by permission
  17.                              ~~~~~~~~~~~~~~~~~~~~~
  18.   
  19.   
  20.      AMnews proudly presents File Conversion, the first freely distributable
  21. Amiga utility from WordPerfect Corporation!  This nifty utility program lets
  22. you transfer your Amiga WordPerfect files to either the 4.2 file format used
  23. in the IBM version of WordPerfect, or to the .doc(ument) format used by
  24. Micro-System Software's word processor Scribble!.  Even better, you can also
  25. convert documents FROM IBM and Scribble! formats TO Amiga WordPerfect
  26. format.  And if that's not enough, merge files created with WordPerfect and
  27. Scribble! can be transformed for use with either word processr.  If you need
  28. processing and merge file compatibility, File Conversion is the utility
  29. you've been looking for!
  30.  
  31. Getting Started
  32. ~~~~~~~~~~~~~~~
  33.      File Conversion, which is named FC in this group of files, can be used
  34. from either Workbench or the CLI.  In order to become acquainted with the
  35. options available for it, we suggest you begin by copying FC to a working
  36. disk such as the back-up copy of your word processing disk or hard disk.
  37.   
  38.      Starting FC from the Workbench by double clicking its icon displays its
  39. conversion window and six boxes for file and directory information. These
  40. boxes, from left to right, allow you to:
  41.   
  42. 1)  Input the directory and name of the file you wish to convert;
  43.  
  44. 2)  Input the name you choose for your converted file and the direcory you
  45. wish to store it in;
  46.  
  47. 3)  Input the directory containing the Scribble! format (.fmt) file you want
  48. to use or create, and the name of this file.
  49.   
  50.      When started from the Workbench, FC automatically inputs the name of
  51. the directory containing your FC program file.
  52.   
  53.      For example, if you started from a disk named WordStuff in DF1: (the
  54. external drive), your directory requestors would list WordStuff: in each of
  55. the directory boxes.  The three file requestor boxes would contain, from
  56. left to right, Default.IN, Default.OUT, and Default.FMT.
  57.   
  58.      To change any of the file or directory names simply point at the box
  59. with your mouse pointer and click the left mouse button.  You may edit the
  60. names using the follwing keys:
  61.   
  62.             KEY(S)              FUNCTION
  63.             ~~~~~~              ~~~~~~~~
  64.           Right Cursor        Move cursor one position right
  65.           Left Cursor         Move cursor one position left
  66.           Shift/right Cursor  Move cursor to end of line
  67.           Shift/left cursor   Move cursor to beginning of line
  68.           Del                 Delete character under cursor
  69.           Backspace           Delete character left of cursor
  70.           Return              Stop Editing
  71.           Right AMIGA/Q       Undo last editing change
  72.           Right AMIGA/X       Clear the box
  73.   
  74.           For keys listed with a slash (/) such as Right AMIGA/X,
  75.           hold down the key shown to the left of the slash and then
  76.           press the second key.
  77.   
  78. File Formats
  79. ~~~~~~~~~~~~
  80.      Under the directory and filename boxes in FC are two columns marked
  81. INPUT FORMAT and OUTPUT FORMAT.  Available in FC are WordPerfect 4.1,
  82. WordPerfect 4.2, WordPerfect Secondary, and Scribble! Merge formats.  Both
  83. WordPerfect Secondary and Scribble! Merge formats are used to input lists of
  84. information into a primary document such as inserting the name, address, and
  85. salutation in a mass mail letter.
  86.   
  87.      If you are converting a WordPerfect file from another computer you
  88. should try to determine which file format was used in the original document.
  89. Older versions of IBM WordPerfect create a 5.0 format file as its default
  90. but will save in 4.2 format.  With the range of WordPerfect formats
  91. available in FC, you should have no trouble creating a file on any computer
  92. supporting WordPerfect provided that file can be edited using WordPerfect on
  93. your Amiga. (Editor's Note: This is where the Amiga 2000 comes in handy!)
  94.   
  95. Conversion
  96. ~~~~~~~~~~
  97.      Once you've chosen the proper directories, entered the file names in
  98. the proper boxes, and chosen the format of the input and output files, all
  99. that's left is to begin the conversion.  To the right of format names is the
  100. GO box.  Move your mouse pointer to GO, click the left mouse button and your
  101. conversion is underway!
  102.   
  103.      While GO won't earn you $200, clicking on it opens an additional window
  104. labeled PROGRESS.  This window informs you of the status of the conversion
  105. and any problem that FC may encounter while converting your files.  If you
  106. wish to stop the conversion click the ABORT box.
  107.   
  108.      Error messages reported in the PROGRESS window provide an explanation
  109. of any problem encountered by FC.  Many messages are the result of
  110. incorrectly naming the file to be converted or the directory containing the
  111. file.  Others involve the conversion process itself.  If FC encounters an
  112. error you will be given the option of continuing or stopping the conversion.
  113. Choosing to continue will generally result in a satisfactory conversion
  114. although minor edits in the converted document may be necessary.  If in
  115. doubt, continue the conversion if possible, and review the resulting file to
  116. determine its acceptability.
  117.   
  118. Advanced FC
  119. ~~~~~~~~~~~
  120.       Using FileConvert from the CLI reduces the amount of input needed when
  121. FC appears on the screen.  At the CLI prompt the command structure to start
  122. it is:
  123.   
  124.       FC <dir:input file(s)> <dir:output files(s)> <dir:option file(s)>
  125.   
  126.      You may, of course, type in upper or lower case but be careful with
  127. spaces and what looks to be punctuation marks. Here's what all that means:
  128.   
  129.      FC is the Program Name;
  130.   
  131.      dir: is the directory where the file is located;
  132.   
  133.      <input file(s)> are the file name(s) to be converted;
  134.   
  135.      <output file(s)> are the files name(s) of the converted files;
  136.   
  137.      <option file(s)> are the .fmt (format) files to create or use during
  138.                       the conversion.
  139.   
  140.     When you start FC from the CLI in this way, it comes up (appears on the
  141. screen) with the names of the directories and files you've specified.
  142. Again, the conversion is started by clicking the GO box.
  143.   
  144. Matching File Patterns
  145. ~~~~~~~~~~~~~~~~~~~~~~
  146.      When using FC from either the CLI or Workbench you may use file
  147. patterns to choose several files to convert.  Patterns for input files are a
  148. combination of letters, numbers and wild cards.  An asterick (*) indicates a
  149. match to a file name of any length.  A question mark (?) indicates a match
  150. to a single character in the file name.  Thus, a file name pattern of
  151. TH?12.* would match files names THE12. and TH512.C and THR12.HELLO.
  152.   
  153.      Patterns for output and option files are a combination of letters,
  154. numbers and the * wildcard.  The asterisk will match the complete name of
  155. the current input file.  If the input file is THEFILE and the output file
  156. pattern is *.out then the resulting converted file would be named
  157. THEFILE.out.
  158.  
  159.      Be careful to choose output patterns that do not create more input
  160. files or write over existing files.  For instance, within the same directory
  161. an input file pattern of *.doc and an output pattern of *.doc can cause the
  162. OUTPUT to create files suitable for the INPUT pattern.  FC will be working
  163. an awfully long time if you do that.  Like forever.
  164.   
  165. Final Notes
  166. ~~~~~~~~~~~
  167.      What can you expect from your converted document?  Well, for the most
  168. part converted documents will retain all the formatting and style of the
  169. original.  This is especially true when converting between WordPerfect 4.1
  170. and 4.2.  When converting from WordPerfect to Scribble! however, you should
  171. be aware that Micro-Systems Software's Scribble! does not accomodate all of
  172. the features available in WordPerfect.  As a result, your WordPerfect
  173. document will lose footnotes, super- and sub-scripted letters, specialized
  174. fonts, and special formats when converted to a Scribble! document.
  175.   
  176.      When working with valuable documents be sure to use a copy of the
  177. document when you convert it using FC.  Neither AMnews Corp. nor WordPerfect
  178. Corporation accept responsiility for any loss of data due to the use of this
  179. program.
  180.   
  181. Coming Attractions
  182. ~~~~~~~~~~~~~~~~~~
  183.      FC is freely distributable so you can legally copy it (along with this
  184. instruction file) and give both to anyone who wants them.  If you're a
  185. WordPerfect owner and you find FC helpful, tune into the next issue of
  186. AMnews (Vol.1, No.2, Novewmber/December 1988).  We'll have another utility
  187. from WordPerfect in that issue:  MacroConvert (Note:  MacroConvert is
  188. included with this distribution).  Written by WordPerfect Corporation with
  189. an AMnews tutorial, MacroConvert will help you understand, construct and
  190. edit macros that drastically reduce your working and set-up time with
  191. WordPerfect.  Other than coming over and doing the work for you, what else
  192. can we do?
  193.   
  194.   
  195.                                -AMnews Corp.-
  196.   
  197.  
  198.