***** NOTE ***** The complete package contains the following files: -File- -CRC- -Description- CRC $DEDC902B Calculates the CRC-checksum of a file LightConv $E44A0B16 The converter LightConv.doc This document CharSet.doc The complete Amiga character set ReturnCodes.doc Return codes Uppercase.cnm A conversion module (scands to upper case) 7to8bit.cnm 7-bit scands to 8-bit (Amiga) scands PCtoAmiga.cnm PC-text to Amiga-text The checksums can be calculated with CRC. If some of the checksums is wrong, the file might contain a virus or somebody has changed it. If this happens, do NOT use the file. - - - - - - - - These files are freeware and they may be freely spread and used as long as they are left unchanged. These programs are written in assembly. They are completely re-entrant (pure) and pc-relocatable. They should work on all Amiga models and configurations and they are carefully tested, but we are not responsible for any damage caused by them. Lightning Inc. is not a pirate crew, we are completely legal! Send bug reports, suggestions and other mail to: Markku Vähäaho or Terje Bergström Eerontie 17 Jukolanahde 4 D 15 02180 Espoo 02180 Espoo Finland Finland Usenet: terje.bergstrom@f500.n515.z2.fidonet.org Fidonet: Terje Bergstrom@2:515/500.14 ***** ***** LightConv V1.25a is a lightning fast Convert V3.0 replacement, written in assembly by Markku Vähäaho / Lightning Inc. (I didn't use Convert30.c, I wrote LightConv completely myself!) Features: * Small size * Superfast * Completely Convert V3.0 compatible * New features: - Comment lines in conversion modules can be longer than 78 chars - Chars can be quoted (LightConv: "ä" "Ä", Convert V3.0: 228 196) Of course the old format is still supported - The module may include empty lines - Files can be converted to upper/lower case with the "U" flag - StripCR- and AddCR-options for line feed/carriage return handling * Full ASCII character set included * Three conversion modules included: 7to8bit (7 bit scands to 8 bit), Uppercase (scands to upper/lower case, usually used with the "U" flag) and PCtoAmiga (PC-text to Amiga-text) * Uses the arp.library - Supports full AmigaDOS filenames (quotes and spaces), ARP escape characters and other ARP stuff * Returns valid DOS return codes, so you can redirect the output to NIL: or NULL: and still notice if something went wrong LightConv is made for converting charsets, for example 7-bit scands to 8-bit scands, all letters to upper/lower case etc. Usage: LightConv [R][U] (Of course everything is case-independent.) The source file must be different from the destination file, as the same file can't be opened for different purposes. The R-flag reverses the module. The U-flag converts chars (a-z) to upper case. To convert national chars to upper case, use Uppercase.cnm. The following example converts the file RAM:Text1 to upper case (to the file RAM:Text2) LightConv Uppercase.cnm RAM:Text1 RAM:Text2 u To lower case: LightConv Uppercase.cnm RAM:Text1 RAM:Text2 ru If you want to convert other national chars than "å", "ä" and "ö", just add them to Uppercase.cnm. A little example of a conversion module which converts all '\'-chars to '/'-chars: --- Cut here --- ; This module converts all \-chars to /-chars ; These comment lines are printed on screen while converting, ; so you can write here the credits and conversion type (see the ; first line) ; This one uses the new format ("X" "X") "\" "/" --- Cut here --- If you use the R-switch, all /-chars will be converted to \-chars. LightConv also accepts the older Convert V3.0 format: --- Cut here --- ; This example shows the older Convert V3.0 format (NNN NNN) 092 047 --- Cut here --- You can also combine these formats: 092 "/" and "\" 047 If you for example want to convert PC-text, you need new options: StripCR and AddCR. StripCR strips all carriage returns (13) and AddCR adds a carriage return before a linefeed (10). An example: --- Cut here --- ; This module adds CR:s before LF:s ; LF (Amiga) --> CR+LF (PC-compatibles) AddCR --- Cut here --- If you want to convert all CR+LF:s to CR:s, you can do it like this: --- Cut here --- ; This module strips all CR:s and then converts LF:s to CR:s ; 1. CR+LF --> LF ; 2. LF --> CR StripCR 010 013 --- Cut here --- If you use the R (reverse)-flag, StripCR and AddCR are also reversed (AddCR <--> StripCR). If you still have problems with conversion modules, take a look at 7to8bit.cnm, Uppercase.cnm and PCtoAmiga.cnm. The ASCII values for all chars can be found from the file CharSet. All conversion modules are freely distributable, but if you make a new module you must send it to Camillo Särs, the author of the original Convert. If you use the new format in your module, tell him about it. One day you might find that you need a specific module, and you can't create it yourself for some reason. When this happens, just send Camillo a request, he might have the needed module and he will send it to you. Camillo's address is: Camillo Särs Nordostpassagen 12 A 17 00200 HELSINKI FINLAND If you want to get your disk back, remember to pay the return postage!! ------ I hope you enjoy this little proggy... Markku Vähäaho History ~~~~~~~ V1.00 Works like Convert V3.0 V1.10 Uppercase and quote-features added and bugs removed V1.20 Uses arp.library, size reduced about 300 bytes V1.22 Size reduced and some 'little' stuff added V1.23 One little improvement made. Many mistakes in the document corrected V1.25 StripCR- and AddCR-options added, increased buffer size to 16k V1.25a Checks CTRL-C (whoops, I should have done this earlier... :^)