@database WordConverter @master Union:Developer/Projects/Sources/C/WordConv/dist/WordConverter.guide @$VER: 0.9.4 @author "Peter Drapich" @(c) "1997 Union Systems, ul. Karowa 18a/20, Poland. tel. +48 22 8266607, fax +48 22 6593040" @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "Word Converter Main Menu" @{b}Word Converter v0.9.4@{ub} © 1997 Peter Drapich @{i}evaluation version@{ui} Word Converter IS A @{fg shine}SHAREWARE@{fg text} PRODUCT READ THE DISTRIBUTION SECTION FOR INFORMATION ON DISTRIBUTION AND REGISTERING Contents @{" Copyright        " link "copyright" 0} Copyright notes @{" Disclaimer       " link "Disclaimer" 0} Warranties? No way. @{" Distribution     " link "Distribution" 0} How to distribute @{" Shareware        " link "Shareware" 0} About the shareware concept @{" Registration     " link "Registration" 0} How to register @{" Author           " link "Author" 0} About the author and how to reach him @{" Introduction     " link "Introduction" 0} Introducing Word Converter @{" Features         " link "Features" 0} Brief feature list @{" Requirements     " link "SystemRequirements" 0} What's required to run Word Converter @{" Installation     " link "Instalation" 0} How to install Word Converter @{" Usage            " link "Usage" 0} Description of all available options @{" General notes    " link "Notes" 0} How to use Word Converter @{" Additional notes " link "RegUsers" 0} For registered users @{" Future plans     " link "FuturePlans" 0} What's up to come @{" History          " link "history" 0} The History of Word Converter @{" Known bugs       " link "bugs" 0} Not fixed yet. @endnode @node "copyright" "Copyrights" @{b}Copyright@{ub} The entire Word Converter package was created by Peter Drapich and is copyrighted ©1997 by Peter Drapich, except for reqtools.library, which is copyrighted © by Nico François. Word for Windows, OLE, Windows, Microsoft are registered trademarks of Microsoft Inc. @endnode @node "Disclaimer" "Disclaimer" @{b} Disclaimer@{ub} The  author  makes no guarantee of any kind for the reliability of the software described in this documentation, and thereof he is in no way liable for any damages or loss of data directly or indirectly caused by the use or misuse of this software. This documentation and the Word  Converter program are  provided  "as is"  without  any warranty, either  expressed or implied. @endnode @node "Distribution" "Distribution" @{b}Distribution@{ub} The Word Converter evaluation package may be distributed freely, as long as there are no changes made to any part of this software. No parts of this package may be omitted or altered by any means except for archiving. You are not allowed to copy single parts, you have to reproduce the package completely. Please refer to the list of contents for verification: WordConverter (dir) libs (dir) reqtools.library Rexx (dir) CEDImportWord.ced PGSImportWord.rexx WordConverter WordConverter.info WordConverter.guide WordConverter.guide.info Orderform.txt WordConverter.info Neither fees may be charged nor profits may be made by distributing this piece of software. Only a nominal fee for costs of magnetic media is acceptable, whereby the amount of US $3 or DM 4,- must not be exceeded for a disk containing Word Converter. @endnode @node "Shareware" "Shareware" @{b}Shareware@{ub} Word Converter is shareware, which means this software may be used and redistributed freely, as long you accept the conditions and limitations stated in the  @{"distribution" link "Distribution" 0}  and  @{"disclaimer" link "Disclaimer" 0}  sections. Please consider @{"registration" link "Registration" 0} if you wish to use Word Converter frequently. @endnode @node "Registration" "Registration" @{b} Registration@{ub} To register, fill out the registration form included, email it or print it out in some way and send it to the author. The registration fee is as follows: Amiga version Word Converter - UK £10, US $15, DM 30 or (only valid for Poland) PLN 25 SGI/Linux/Win95 version Word Converter - UK £20, US $30, DM 60 or (only valid for Poland) PLN 50 For versions for other Unix systems, add the Amiga version costs. For registered users, all new versions of Word Converter are available by email for free. Other means of delivery :) will cost a little (P&P costs). You will obtain registered version by email or by post. If post is the preferred way, please add UK £3, US $5, DM 10, PLN 5 to cover P&P. Please fill out the order form, included in the original archive under OrderForm.txt file name. You can pay with cash (most preferred method) or money transfer. Coins cannot be accepted. For bank details, please contact me by email or phone (+48 22 8266607). For registration and sending money, please use the following address: Peter Drapich ul. Karowa 18a/20 00-324 Warsaw Poland or e-mail: docent@union.org.pl docent@union.medianet.pl !AND ALWAYS REMEMBER: FOR SENDING MONEY USE ONLY REGISTERED MAIL.! @endnode @node "Author" "Author" @{b}About the Author@{ub} I'm working for Union Systems, a company who develops games for PCs and PlayStation consoles. As I prefer to use Amiga for my home use, I needed a tool for reading files, created with Word - a word processor by Microsoft, very popular in Wintel world and commonly used in business. There was nothing of this type on Aminet which suited me and I really hated to turn on my PC just to read a small Word document. Thats why someday I decided to write my own utility. It took me a lot of time, because Word file format is quite weird, especially in its Windows version. Anyway, here it is and even works :). Have fun with this nice program and register, if you are using it. CONTACT ADDRESSES The best way is to use e-mail. You can reach me at: docent@union.org.pl docent@union.medianet.pl on IRC channels #amiga,#amigapl,#coders,#yaroze - nick Docent or by normal mail: Peter Drapich ul. Karowa 18a/20, 00-324 Warsaw, Poland Please write on the envelope "Word Converter" DISCLAIMER: In this documentation I don't speak for Union Systems and Union Systems has nothing in common with this software except using it.:) Any problems, questions, flames go personally to me and only to me. @endnode @node "Introduction" "Introduction" @{b}Introduction@{ub} This program is a useful tool for everybody, who needs the possibility to read documents, created with Word, a famous word processor by Microsoft, available on Wintel and Mac platforms. Thanks to Word Converter, you are able to convert documents, created with Word for Windows version 2, 6,7 and 8 and Word 4, 5 for Mac or even imports them directly into PageStream 3 DTP program or CygnusEd text editor through additional ARexx scripts. This is the evaluation version of Word Converter. There are only one difference between full registered version and this version. Full version saves the whole text, not only first 1000 characters. @endnode @node "Features" "Features" @{b}Key Features@{ub} - Simple, intuitive way of converting Word documents. - Converts documents, created with Word for Windows version 2, 6, 7 and 8. - Converts documents, created with Word 4, 5 for Mac. - Converts documents, created with Word for DOS (hopefully). - Document can be converted to ASCII text, HTML and AmigaGuide. - Works as a command line tool too. - Additional ARexx scripts allow easy import of Word document directly into PageStream 3 DTP program or CygnusEd text editor. - Context help (requires Kickstart 3.0) - Quite stable. @endnode @node "SystemRequirements" "Requirements" @{b} System requirements@{ub} Word Converter requires an Amiga with operating system 2.04 (V37) or above and reqtools.library to run. For context help, version 3.0 (V39) or higher of operating system is required. Word Converter also requires enough space in T: - roughly equals the size of the file to convert. All other memory requirements are handled dynamically, so you are able to use it even if you are low on memory. Hard disk is not required but recommended. @endnode @node "Instalation" "Installation" @{b} Installation@{ub} To install Word Converter, please run supplied Installer script. This release can be installed so easily on your system that you can also perform that task manually: - Copy WordConverter and WordConverter.info to any location on your hard drive or disk. - Copy Rexx/CEDImportWord.ced to your REXX: directory or ced/rexx directory. Follow instructions supplied with CygnusEd to install this ARexx script in CygnusEd. - Copy Rexx/PGSImportWord.rexx to your REXX: directory or PageStream:scripts directory. Follow instructions supplied with PageStream 3 to install this ARexx script in PageStream 3. - If not already present, copy reqtools.library into your sys:libs drawer. After these steps, Word Converter can be started via Shell or Workbench. @endnode @node "Usage" "Usage" @{b} Usage@{ub} After starting Word Converter from either Shell or Workbench, you'll find its main window opened. All actions can be performed by clicking on the appropriate buttons. Currently, there are four button gadgets: @{"Convert" link "Convert" 0}, @{"Decrypt" link "decrypt" 0}, @{"About" link "about" 0} and @{"Quit" link "quit" 0} and one cycle gadget @{"Save as" link "SaveAs" 0}. @{b} Shell Usage@{ub} Word Converter can be used also from Shell. Parameters are: WordConv InputFileName OutputFileName OutputFormat Switch where: - InputFileName is the name of the Word document. - OutputFileName is the name of output file. - OutputFormat is an optional parameter, which defines the output file format. Possible choices are: ASCII - converts to pure ASCII. GUIDE - converts to AmigaGuide document. HTML - converts to HTML document. HTMLP - converts to HTML with preformatting to keep the original text layout. - Switch is an optional switch :) FORCE - will force conversion, if document has an unknown revision. When not set, such document will not be converted. @endnode @node "futureplans" "Future plans" In the nearest future, I'll add: - Decryption of password protected documents (almost finished) - Support for more different versions of Word. - Conversion of text embedded macros to AmigaGuide buttons or HTML links. When there will be enough interest and registrations :) I'll add: - Full document conversion (with text attributes, fonts, sizes etc.) - rtf, pdf and postscript output. - other ideas ? @endnode @node "history" "History" » version 0.9.4 · NEW: Completely rewritten OLE wrapper. Decryption is coming! · NEW: Added support for WinWord 2 and Word for Mac 4 and 5 documents. · ADD: The name of the selected file in the filerequester is kept for the next filename selection - requested by several users. · FIX: PSGImportWord.rexx now works correctly again - thanks to Jon Peterson for this bug report. · FIX: Removed improperly used tag in HTML saver - thanks to Philip Steffan for this. · ADD: Arexx script PSGImportWord.rexx updated to detect if the cursor is in a text box - thanks to Ezequiel Partida for this one! » version 0.9.3 · FIX: Fixed a serious bug, which caused crashes on pre V39 machines. Thanks to Yama for reporting this one. · FIX: Fixed a serious bug, which caused crashes while trying to convert non-Word documents with command line parameters. This solves all problems with ARexx scripts. » version 0.9.2 · NEW: Added a new commandline option 'FORCE'. · NEW: Added PSGImportWord.rexx - Arexx script for importing texts into PageStream 3 documents. · ADD: Arexx script CEDImportWord.ced rewritten to be more safe. · ADD: Cleaned up error codes, returned by various functions. » version 0.9.1 · FIX: A couple of fixes in docs. · ADD: Added a couple of new Word 6 revisions to recog function. · ADD: Added wordwrap option to AmigaGuide saver. This will allow reading converted documents without scrolling to the right in case of long text paragraphs. » version 0.9.0 First public release. · all older versions were internal and not publicly available. @endnode @node "about" "About..." This option will display usual copyright information, developers address and other interesting messages. @endnode @node "quit" "Quit" Selecting this option quits the program. @endnode @node "Convert" "Convert" This button begins the conversion. @endnode @node "SaveAs" "Save as" This cycle button lets you set the save format. There are three formats currently available: ASCII - saves text as pure ASCII file. AGuide - saves text as an AmigaGuide file. HTML - saves text as simple HTML file. HTML/P - saves text as simple HTML file with preformatting to keep the original text layout. @endnode @node "notes" "Additional Notes" @{b} How to use Word Converter@{ub} After running the program from Workbench or Shell without any parameters, the main window will appear. The most important is button, labelled @{"Convert" link "Convert" 0}. This button begins the conversion. First, you'll be prompted with the file requester for a file in Word format. After selecting and clicking on OK, Word Converter will evaluate selected file to detect if it is a valid Word file. When this evaluation will succeed, Word Converter will ask you for the destination file name and directory with another file requester. Additional information about the file and its processing will be displayed in the main window during conversion. In case of any error, additional information about the error and its cause will be displayed in the bottom of the main window or message requester. @endnode @node "Bugs" "Bugs" - Small documents (below 4 kb), created with Word for Windows, can be converted wrongly (my OLE wrapper doesn't support small blocks - yet). @endnode @node "decrypt" "Decrypt" This button starts decrypting of password protected Word document. Such file is crypted with the password and Word Converter tries to guess it. Fortunately, the crypting algorithm used by Microsoft in Word is very simple and can be very easily guessed. You'll be prompted with a filerequester for the name of the file to decrypt and for the destination name of the decrypted file. The resulting decrypted file will be in normal Word format and can be used with Word. @endnode @node "RegUsers" "For registered users" Please do not pass the registered version to your friends or redistribute it over the net or in any other way. This registered version is only for your own, private use. I reserve the right to put the name of a person who spreaded his registered version into "The Hall Of Shame" :), which will be included in the archive. @endnode