AGuideConv V1.0 copyright 1994 by =============== Michael Friedrich All Rights Reserved. Converts OS3.x-AmigaGuide-Texts to OS2.x-AmigaGuide-Texts Copyright ========= This software is copyright 1994 by Michael Friedrich. All Rights Reserved. Is is PUBLIC DOMAIN, so you may use this piece of software freely. This software may be freely distributed as long as no more than a nominal fee is charged to cover time and copying costs. Commercial usage is only allowed with the written permission of the author. Disclaimer: The author makes no warranties, either expressed or implied. This program is provided on an "as is" basis and the author will not be liable for any damages caused or alleged to be caused directly or indirectly by using or not using this program. Use at your own risk. Introduction ============ For all those OS2.x-users: Starting with OS3.0 the AmigaGuide-Format has been enhanced. Besides other new features the keyword @WORDWRAP was introduced allowing the texts to adapt to the user's window-width. AmigaGuide-Texts using this keyword can't be opened with AmigaGuide- Viewers from OS2.x. AGuideConv removes this keyword and reformats the text to a fixed text-width. This way OS2.x-users should be able to read (some of) the OS3-AmigaGuide-Texts. Annotation: 'AGuideConv' has been written to convert the AmigaGuide-Help from TurboCalc. I then decided to release it freely, perhaps you can use it for any other text, too. Please excuse some limitations that might arise from this fact, but first of all AGuideConv was designed to work correctly with TurboCalc.guide - and I'm really lazy ;^) (See Limitations below.) Usage ===== AGuideConv can be started either from workbench or from shell. WorkBench-Usage --------------- Select the AmigaGuide-Text-Icon(s) then shift-double-click on the AGuideConv-Icon. (i.e. press down the shift-key and double-click on the icon). For every text a requester with the filename appears. This is your last chance to abort the conversion. If you select 'OK' the text will be modified. (If you own OS1.2/1.3 no messages will be shown but the conversion with start immediately.) CLI-Usage --------- AGuideConv textname Start AGuideConv with the parameter 'textname' being the AmigaGuide-Text. Example: AGuideConv dh0:TurboCalc/TurboCalc.guide Attention: ---------- AGuideConv replaces the texts by their converted versions, i.e. the old version will be lost!!! If AGuideConv fails, the texts will be lost. Thus it is recommended to duplicate the text before starting AGuideConv, i.e.: never ever convert a unique original version! What is done: ------------- * @WORDWRAP, @INDEX and @FONT commands are removed * text will be wordwrapped to a fixed width of 77 * style-commands (@{b}, @{ub}, @{i}, @{ui}, @{u} and @{uu}) are removed, this is not absolutly necessary, but it should look better afterwards. Limitations: (see note above) ----------------------------- * used textwidth cannot be changed * Reads the complete text to memory before converting * Saves the converted version to the same file! The Auther ========== This program was written by Michael Friedrich Mühlenstr.25 77694 Kehl Germany EMail: ------ s_friedr@ira.uka.de ukrc@rz.uni-karlsruhe.de If you have any problems, suggestions or bug reports (oh no :) feel free to send an EMail.