LDcd 3.0a - ldcd.doc file

Use: LDcd is a DOS based program that will run under DOS, Windows (Dos prompt)
^^^  It decodes all uuencoded part(s) either in a file, separated or mixed 
     into file(s).

Requirement: Must be working under MS-DOS 5.0 or above!!
^^^^^^^^^^^
Usage: LDcd [option(s)] <filename/wildcard> [FILENAME <= use only with /o ]
^^^^^
Features:
^^^^^^^^^
   - able to decode uuencoded files, either in separated file, a file
     or mixed to file(s).
   - U may choose whether to delete all the successful uudecoded parts 
     automatically or manually.
   - wildcards (i.e. a.* *.*) or a given bound for input filename.
   - rename the uudecoded file name automatically or manually if
     the filename is not a standard MS-DOS one or duplicated.
   - will do the sorting for the parts. No need to worry about
     their order. (Only work will separated parts)
   - create a Log file (ie. LDCD.LOG ) for U to reivew the decoding 
     process, so that if any error happened while decoding. U can go 
     through it and get some hints to correct the problem.
   - users friendly help menu. (Hope so!)
   
note: READ through [OPTION PART] as follows to get an idea of how it works.

Description for Usage:
^^^^^^^^^^^^^^^^^^^^^       
Usage: LDcd [option(s)] <filename/wildcard> [FILENAME <= use only with /o ]

<filename/wildcard> - Can be any string if valid to DOS DIR COMMAND
                      eg. ldcd *.*  or  ldcd a.*  or  ldcd abc

[FILENAME]   - Need It Only with Option /o Only, Read /o for Details

[option(s)]

          /l - It will Create a Log File LDCD.LOG to report the 
               Decode Process.

          /r - Without Using /d, It will prompt U whether to Delete those
               Successful UUDeCoded Parts or to Do It Later so that U Can
               See if those Parts were UUDeCoded Properly and then Exexcute
               the Remove Process to delete those Files. In addtion,
               a file LDCD_OK.LOG will be created and contains all
               successful uudecoded file parts name. U can edit it 
               for choice of deletion. 
               There are 3 different choice for the prompt and 
               shows as follows:
               "y" - will delete all successful uudecoded encoded parts
               "n" - will remove LDCD_OK.LOG file
               "l" - will keep LDCD_OK.LOG for U to execute the
                     deletion later by typing "ldcd /r"
               
          /d - It Deletes All Successful UUDeCoded Parts Automatically
          
          /o - It Uses Two Index Filename as the Bound of those Input File
               The Rules for Index Filename and Examples are as follows:
             - String of first filename must be smaller than string
               of second FILENAME.
                  eg:  1) Decodes a list of files 'a.01','a.002',...,'a.100'
                          ldcd /o a.01 a.100
             - On the above case, Saved UUEncoded parts can be 
               in incorrect order.
                  eg:  2) Decodes one file 'picture'
                           ldcd /o picture
             - On the above case, Saved UUEncoded parts must be 
               in ascending order.
             
             NOTE: Any alphabetic or numberic character will work 
                   fine. Not sure other character such as @#%$, etc.

What's news?!
^^^^^^^^^^^^^
- New Options. (I think it's much better than before.)

Examples
^^^^^^^^
1) ldcd a*.*
      - it decodes all file with first character "a" and
        prompt U whether to delete the succesful decoded file parts.
        U have 3 choices:
        "y" - delete now
        "n" - not do it and won't create a successful decoded file log list
        "l" - do it later and will create a successful decoded file log list
              and U can execute the delete process again by typing
              "ldcd /r".

2) ldcd /d a*.*
      - same as above, but it won't prompt U and will delete all
        successful decode file parts automatically while decoding.
3) ldcd /l a*.*
      - create a log file and prompt for deletion
4) ldcd /r
      - read 1) for details.
5) ldcd /o abc.001 abc.100
      - it will decode all file bounded 
        from abc.001, abc.002, ... abc.099, abc.100
        and prompt U for deletion.
6) ldcd /o /d abc.001 abc.100
      - it will decode all file bounded and do the deletion automatically.

REMARK!!!
^^^^^^^^^
HINTS on filter out those file with errors.
Choose not to decode files with SUSPECTED errors, and then
All files decoded should have no errors. (But, it's not absolutely true!
Sometimes, the parts no. is correct, but the content is not correct!)
And then choose to delete those SUSPECTED Decoded Successful Parts by 
asking the prompt with "y" or using the option /d. Then, the
remain not decoded files will be the parts for SUSPECTED errors file.
So that, U could look through the parts no. to see if they could really be
decoded or not. And delete them yourself....
The following is an example of the response,
e.g. DOS PROMPT>ldcd *.*
     Decode those suspected error parts??  n
     Delete all those suspected successful uudecoded parts?? y  
                                                          or l (then ldcd /r)
     Then the remain will be all parts suspected contains error.
     And run ldcd *.* again to step through the rest... 
     hopefully, some files will have error and some aren't....


Reward?!!
^^^^^^^^^
Ah ha... Just curious, I want U to send me US$ 2 to 5 cheque for using
this program. Is it okay?! OH.. Just kiddings...
Anyway, if U like to send me one, no problem... I will thankx you very
much!!

The following is my address...
To: WH, Lewis Lam
    13/F, 121 Sai Yee Street,
    Mongkok, Kowloon,
    Hong Kong

Lastly, hope U like this program!!

Lewis Lam (e-mail: lamx5870@mach1.wlu.ca)
Wilfrid Laurier University, CANADA.


History:

Ver3.0a - 4/95
          New options added (suggested by USER)
          For my Camille

Ver2.2a - New algorithm for analyzing the subject line. (smart!)
        - Minor bugs fixed.
Ver2.1l - Add the ability to analyze the file list before decoding.
          Modify the user interface.
Ver2.1  - Fixed a number of bugs such as memory errors, etc!!
Ver2.0  - Add the ability to do sorting stuff!! Much better!!
Ver1.7  - Fixed a minor bug! (Have not released to public!)
Ver1.6  - Totally fixed the error descibed in History of Ver1.4
Ver1.5  - Create a log file after execution.
        - Add some new error messages.
        - Add an option for help. i.e. ldcd ?
        - Fix an error owing to reading a file without end.
          (which causes all the rest of file won't be extracted or
          just have a filename without size!!)
Ver1.4  - Try to fix an error on decoding weird encoded file!!
          (But haven't been totally fixed yet! Coz... I don't really know
          by what equation to get those stuff?! Also, I am not sure,
          mine is a standard or THAT is a standard! Anyway, I will
          try to figure it out after the FINAL EXAM 93)
Ver1.3  - Uses another method to search for the next filename. (The cheap way!)
        - Add the ability to rename file if already found in the dir.
        - Add the ability to rename file if it's not a standard MS-DOS file name.
        - JUST a remind, LPACK was replaced by its Version 0.7 coz, its
          work better than Ver 0.9's, Just a remark, if U would like
          to pack file from "file.001" to "file.011", please type in
          "lpack file.001 file.012" instead, if not, it will just
          pack "file.001" and "file.011" only due to the disability of
          the program. Hope.. U know what I mean to..
          (This disability only exists in LPACK not in LDCD coz.. LDCD
          does work in clever way!!)
Ver0.9  - fixes the other errors on finding the next filename in LDCD.exe &
          LPACK.exe
        - Add the ability to decode a number of encoded files in a list of
          file or in a file. (very convienient)
        - KILLs LDC.exe (it disappers in this release!)
Ver0.7  - fixes the errors on finding the next filename in LDCD.exe & LPACK.exe
          (which causes infinite looping and hang the computer sometimes)
Ver0.4  - fixes the memory errors
        - Add LDCD.exe to decode a list of file at a time
Ver0.3  - Beta release


IMPORTANT!!!!
^^^^^^^^^^^^^
YOU ARE USING LDCD AT YOUR OWN RISK!  THE AUTHOR, LEWIS LAM IS NOT
RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF LDCD OR BY THE INABILITY
TO USE LDCD.

