Copernicus 1996 #3

home *** CD-ROM | disk | FTP | other *** search

/ Copernicus 1996 #3 / Image.iso / program / internet / uue100.exe / UUE.DOC < prev next >

Wrap

Text File | 1995-09-09 | 14.0 KB | 403 lines

Batch Encoder Version 1.00 for DOS By Jeff Lee Released: 09/09/95 Introduction ------------ Welcome to the first ever (at least to my knowledge) batch UUEncoder! This program was primarily written for my own purposes because I got terribly tired of uuencoding each file in a directory manually. You probably know the feeling.. Type uuencode dog.. Wait for it to finish.. Type uuencode cat.. Wait for it to finish.. etc.. Even worse were the directories full of them! Well, with this program, if you know how to use DOS 'dir' you know how to use UUE! The reason for this is that UUE can accept all standard DOS wildcards. In the next couple of sections, you'll learn how to use UUE and use it to its maximum potential. What is a wildcard? ------------------- For those of you who have no idea what a wildcard is, it is defined in THE COMPUTER GLOSSARY by Alan FREEDMAN as "symbols used to represent any value when naming files". Others of you may know it as the symbols '*' and '?' used in the DOS DIR command. Basically, it makes it easier to group items toghther. Although the '*' and the '?' are both wildcards, they have slightly different functions. Here, I'll show you what I mean with a couple of examples. Lets say you had the following directory: C:\>DIR Volume in drive D is STACVOL_000 Directory of D:\DOWNLOAD . <DIR> 03-07-93 9:20p .. <DIR> 03-07-93 9:20p ALLDOOM <DIR> 03-02-94 7:34p EMS <DIR> 02-12-94 8:38a FNTLIN10 <DIR> 03-28-93 2:37p GUI <DIR> 02-17-94 7:15a ISSUE15 <DIR> 05-26-94 1:11p WMP <DIR> 08-28-93 4:05a ARMADA ZIP 219340 06-01-94 3:13p BRISCOJR ZIP 87031 05-29-94 8:00a DMAREACD ZIP 3362 03-02-94 3:01p DOOMV55 FAQ 142039 02-24-94 6:20p DOOMV55 ZIP 49793 02-26-94 4:22p EMSCL13 ZIP 20593 02-12-94 8:20a EZDB ZIP 49271 02-26-94 6:52p FBTRNS ZIP 7880 05-27-94 4:27p GAMMA ZIP 91486 02-21-94 10:27p GIF_LIBL LIB 25600 02-20-94 5:39p GUI ZIP 199857 02-17-94 7:14a HOWTOVC TXT 28422 02-26-94 6:54p ISSUE15 ZIP 629578 05-26-94 1:02p NUSER EXE 36687 02-23-94 7:31p NUSER ZIP 19328 02-26-94 4:01p PROMODEM ZIP 65637 02-20-94 5:35p SYSSHOK ZIP 159176 06-01-94 3:16p UNPROT BAS 2 07-07-87 10:01a UNPROT DOC 1476 07-07-87 9:56a UNPROT ZIP 939 03-03-94 9:34p VOCFMAT TXT 6212 02-12-94 2:47p UUCODE ZIP 5289 06-09-94 7:09p DIRLIST 0 06-11-94 12:05p ASP <DIR> 06-10-94 2:34p 32 file(s) 1848998 bytes 9142272 bytes free You could use a command like "dir *.zip" to view all the .zip files as so: C:\>dir *.zip Volume in drive D is STACVOL_000 Directory of D:\DOWNLOAD ARMADA ZIP 219340 06-01-94 3:13p BRISCOJR ZIP 87031 05-29-94 8:00a DMAREACD ZIP 3362 03-02-94 3:01p DOOMV55 ZIP 49793 02-26-94 4:22p EMSCL13 ZIP 20593 02-12-94 8:20a EZDB ZIP 49271 02-26-94 6:52p FBTRNS ZIP 7880 05-27-94 4:27p GAMMA ZIP 91486 02-21-94 10:27p GUI ZIP 199857 02-17-94 7:14a ISSUE15 ZIP 629578 05-26-94 1:02p NUSER ZIP 19328 02-26-94 4:01p PROMODEM ZIP 65637 02-20-94 5:35p SYSSHOK ZIP 159176 06-01-94 3:16p UNPROT ZIP 939 03-03-94 9:34p UUCODE ZIP 5289 06-09-94 7:09p 15 file(s) 1608560 bytes 9142272 bytes free The reason for this is because the '*' symbol means basically 'all'. So, when you type in "DIR *.zip", you basically are telling the computer to display any and all files with any filename, with a .ZIP extention. You can reverse this as well. Doing a DIR NUSER.* would output: C:\>dir nuser.* Volume in drive D is STACVOL_000 Directory of D:\DOWNLOAD NUSER EXE 36687 02-23-94 7:31p NUSER ZIP 19328 02-26-94 4:01p 2 file(s) 56015 bytes 9166848 bytes free A final use of it would be to find files starting with a letter, or group of letters. Take a guess at what DIR G*.* would do: C:\>dir g*.* Volume in drive D is STACVOL_000 Directory of D:\DOWNLOAD GUI <DIR> 02-17-94 7:15a GAMMA ZIP 91486 02-21-94 10:27p GIF_LIBL LIB 25600 02-20-94 5:39p GUI ZIP 199857 02-17-94 7:14a 4 file(s) 316943 bytes 9166848 bytes free Get it? Not that hard right? The G*.* meant all files beginning with G with any extention. The '?' symbol is similiar to the '*' except that it replaces only 1 letter, instead of an entire filename or exention. This becomes useful when you don't want all the files matching a '*' specification. Lets say we only wanted the files that had 3 letters in their filename not including extention. We would do the following: C:\>dir ???.zip As expected, the following would occur: Volume in drive D is STACVOL_000 Directory of D:\DOWNLOAD GUI ZIP 199857 02-17-94 7:14a 1 file(s) 199857 bytes 9166848 bytes free Well, that about covers everything with wildcards. Just in case you didn't know, many DOS commands accept wildcards. As shown here, DIR allows it. Others include COPY, MOVE, XCOPY, ATTRIB, and many more. Now that you have a general idea of there usage, lets use this knowledge to use UUD. Usage ----- If you're here, I assume you either read the section on WILDCARDS, or you already know how to use them. Like I said before, UUE has much the same format as dir in the sense that UUE accepts wildcards. For instance, if you had a directory full of UUENCODED files, all you would have to do is: UUE *.* and voila! All the files will automatically be Encoded! UUE also recognizes the '?' wildcard. So, lets say you had a directory of files names FILE.000-FILE.500. You could easily encode only FILE.000-FILE.009 by using: UUE FILE.00? See how easy it is? Of course, you can also encode one file at a time like so: UUE FILE.000 SWITCHES -------- UUE [options] filenames [output directory] Things in [] are optional. [Options]: -? or -h Brings up the help screen giving brief details on how to use them. Also displays any options that are default on. -v Verbose Mode. The program will display all files that have been processed instead of showing the most recent processed file. -e# Encoding mode. This setting tells the encoder which type of Encoding to use. 1=UUEncode(default), 2=XXEncode, 3=MIME(base 64) Encoding -s# Number of lines per section. This tells the encoder how many lines of Encoded information to be allowed in each section. If this option is not used, it defaults to UNLIMITED number of lines. In other words, no matter how long the file may be, UUE will fit it all into one file. If you use the -s option alone, without a number, UUE will default to 950 lines of Encoded info. A number may be specified to override both options i.e. -s500 (500 lines of encoded info per section) -n Disables Alphabetical sorting. All files will be processed in the order they appear in the directory. -o Overwrite All Existing Files. When UUE encodes, it usually checks to make sure the new file being created will not overwrite an existing file. If -o is used, it will not ask for permission but just write over them. -d"directory" Where "directory" is, is a valid directory anywhere or anyplace on your computer. This argument specifies the directory in which the files will be encoded to. This has the same effect as using the "output directory" as the last argument. -k This installs the "break out" key (Control-Break). Its very useful when you find that UUE hangs on certain files. Filenames: This can include as many files as you like, all which can take wildcards. You could do: UUE dog*.* cat*.* bird*.* cow*.* UUE will gather up all the files that match the file specifications, and then, according to switches, alphabatize or leave them alone. [output directory]: Internally, all UUE does with this is convert it into a -d argument. Refer to that argument for more info. The Configuration File ---------------------- The configuration file is a simple means of saving defaults that UUE can later recall. To create one, or edit the one provided with UUE, all you have to do is seperate each new command with a return. Once completed and to your satisfaction, you MUST PLACE "UUD.CFG" ALONG THE PATH, or UUE WILL NOT FIND IT. Here's an example UUD.CFG: -v -o -dd:\encodes By creating this file, UUE will automatically activate Verbose Mode, Overwrite Mode, and encode all files to the directory "D:\encodes". If, at any time you want to disable some of these options, simply reuse that command on the command line when using UUD. Example using the UUD.CFG mentioned above: UUE -v -d *.* This command would disable verbose mode and disable the output directory while leaving Overwrite on. You can view what options are on at any time by just doing a "UUE /?". REGISTRATION of UUE ------------------- Think back.. Way back.. To the point in time where you were a 16 year old kid in High School. Remember how much money meant to you? Now think about me. I currently am 16 and, like you at that time, value money A LOT. That's why I'm placing this program in here as SHAREWARE. Unlike all those big guys who charge 30-40 buckaroos for a simple program, I'm asking for only a measly 18 that's EIGHTteen dollars. If you liked this program, I would really REALLY appreciate it if you payed the Registration fee. If you can't afford to pay the registration fee, let me know you exist, and I'll send it to you EMAIL ONLY free. I'm basing this policy on your HONESTY. WHAT DO I GET WHEN I REGISTER??!! --------------------------------- Well, first of all and most importantly, you get my never ending thanks :). I would be so grateful that if I were able to fly out to wherever you live, I'd give you a big smack on the cheek and ask you if you had a NICE, TEENage DAUGHTER that doesn't currently have a boyfriend.. Just kidding! (although that would be nice). Seriously, I'll send you the registered version either by EMAIL or SNAIL MAIL whichever you choose. You'd get FREE upgrades to the program for as long as I update this thing. You would also have the option to BETA test for me if you want. Trust me, you don't want to miss out on the upcoming versions! Upgrades to registered users will come through EMAIL only. HOW DO I REGISTER??!! --------------------- If you have a printer, print the file "ORDER.DOC" If you don't have a printer - First, you would make a check or money order out to "Jeff Lee". Then, you would send that to: Carrot Utilities 15284 Karl Ave Los Gatos, CA 95030 Lastly, Be sure to specify either EMAIL or SNAIL MAIL. Whatever it is, be sure to include your NAME, ADDRESS, EMAIL ACCOUNT, and DISK SIZE. SHAREWARE CATALOGS ------------------ I'd be glad for any and all Shareware Catalogs to incorporate this program into their catalog or software library of some sort. I'm not asking any money from you, but I AM asking you to TELL ME if you do include this in a catalog. You need my written permission to encorporate UUE into your product line. After all, at 16 I'm looking for things to stick on my Resume, and having a piece of software published (kinda) would be a very unique thing! REPORTING BUGS -------------- This is a very important asset to me, especially if you find that UUE encoded a file incorrectly I need people to tell me if they encounter any misspellings, bugs, etc. in the program. If possible, send me the files you were trying to encodE. Send them to me at the EMAIL addresses that appear in the next section. Not only will I be deeply gratified (almost as much as you paying the registration fee), but I'll be extremely happy as well. WHERE CAN I UPLOAD PROBLEM FILES -------------------------------- 1) You can upload them to my FTP site at FTP.NETCOM.COM in the pub/ts/tsngonzo/incoming directory. 2) You can attach them to a EMAIL message and send it to me THROUGH MY NETCOM ACCOUNT. WHERE TO REACH THE AUTHOR ------------------------- Well, I'm basically everywhere: America On-line: TSNGonzo <----2nd preferred Compuserve: 70740,2337 <----Least preferred Internet: TSNGonzo@Netcom.com <----Preferred TROUBLESHOOTING AND EVERYDAY QUESTIONS -------------------------------------- When I try to run UUE from the program manager, all that happens is the screen flashes and then UUE returns me back to windows Well, first of all, UUE is not a Windows program. It requires the use of arguments passed on the command line. Read this manual or type in just 'UUE' while in DOS or a DOS box. The Computer is talking to me now! How'd that happen.. I know i'm a good programmer.. I'm not THAT good. Check to make sure your keyboard is plugged in backward so that the oscillating chip within the computer can put the demons away. Why doesn't UUE fax anything? Try putting the sheet of paper you want to fax up to the monitor. Make sure the monitor has plenty of static so the paper will stick! What's wrong with the author? Right now, he's in deep mourning over the cancellation of Star Trek: The Next Generation. Since Voyager is on, he's a little better. Your registration would make him feel ALOT better though! DISCLAIMER ---------- Ok.. I don't want anyone sueing me because this program messed them bad or anything. Although this program has been tested thorougly by the author, I make no guarantee it will work correctly on all systems. If it messes you up, TOUGH - that's your problem. All in all, I hope this program isn't TOO hard to learn. I tried to make it as simple as possible. BYE!! REMEMBER TO REGISTER THIS PROGRAM!!