PCEToy32 1.0 - (c)June 2000, D-Tox Software  E-Mail: digitoxin@mindspring.com
http://romcollectors.cjb.net (Will always work)

I have taken every precaution to ensure this program does nothing funky
to your ROMs, but still... (BETA Software, Use At Own Risk)

For each entry in PCEToy's database, PCEToy can automatically detect
overdumped versions of that ROM.  Also, for US ROMs, PCEToy automatically
detects encrypted and unencryped versions of the ROM as well as ROMs
containing a specific one byte hack.  This is one of the reasons why PCEToy's
database contains less entries than other cataloging programs (like GoodPCE.)


usage: PCEToy.exe [parameters] pathname1 [pathname2] [pathname3] ...

Filenames can include wildcards (*,?) anywhere inside the filename.  Long
file names are allowed.  If no filename is given, (*.pce) is assumed.  Only
files with an extension of (.pce) will be scanned.


Parameters
----------
  -i             Outputs extended info if ROM needs repairing or renaming.

  -o[file]       Sends output to file. (DOS 8.3 filenames) If no filename
                 is specified, it defaults to output.txt.  If the file
                 exists, PCEToy will append data to the end of the file.

  -ren[uscltp]   Renames ROMs to names stored in database
                   u- Replace spaces with underscores
                   s- Remove spaces completely from filename
                   c- Attach country codes to end of filenames
                   l- Convert ROMs to all lowercase names
                   t- Places the word "The" at the beginning of ROM names
                      instead of at the end.
                   p- Use periods in appropriate ROM names

  -rep,-repair   Repairs hacked USA ROMs.  This only applies to a specific type
                 of country hack which allowed US games to run on Japanese 
		 hardware.  

  -res,-resize   Automatically resizes ROMs if they contain duplicate or
                 unused banks of data.

  -rh            Removes 512 byte ROM headers

  -encrypt       Encrypts USA ROMs.  This encryption is a standard inverted-bit
		 encryption. (Example: 00101001 would become 10010100.)

  -decrypt       Decrypts encrypted USA ROMs

  -u             Only display unknown ROMs 
                 Only ROMs that are not found in the database will be
                 displayed.  If you have a ROM that you know is good, but
                 it is not in my database, please let me know so I can add
                 it to the database.

  -sub           Process all subdirectories under directories specified on
                 the path.  Scans up to six directories deep.

                 PCEToy will alway skip over the duplicates directory in a
                 scan unless you directly specify it on the command line.

  -nobackup      Don't make backups before repairing or resizing ROMs.

  -log           Log to PCETOY.LOG any problems PCEToy encounters while
                 sorting, renaming, or repairing ROMs.

  -missing[cn]   Create a listing of missing ROMs.  If listing exists, it
                 will be updated.  Filename is defined in PCETOY.CFG.
                    c- Sort missing list by country
                    n- Force PCEToy to create a new missing list, even if
                       one already exists (It will be overwritten.)

                 If a missing list already exists, PCEToy will update the
                 list by removing any ROMs from the list that now exist.
                 PCEToy will never add ROMs to the missing file, so when a
                 new release comes out with a database update, it is probably
                 a good idea to delete the missing file and have PCEToy
                 create a new one to reflect the changes in the database.

  -sort		 Sorts ROMs into directories by country or type

  -q[o]          Suppresses output to the screen (for those of you who
                 would prefer not to see what PCEToy is up to.)
                    o- Suppresses output to the output file as well.

  -doall         Enables -i,-ren,-repair,-resize,-sort, and -missing.

  -h,-?,-help    Displays the help screen

Paramters in brackets are optional.  Do not include the brackets when using
these paramaters.  Example:  You would use -missingc, not -missing[c].

All pathnames will be processed in the order they are entered on the
command line.  you may abort the program at any time by pressing ESC.  PCEToy
will stop on the ROM it is at and then quit.


PCETOY.CFG
----------
You can assign the directories PCEToy will sort your ROMs into if the -sort
command line option is used with the following entries.  Default entries are
shown.

  DIR_BASE =                         DIR_OTHER = Other\
  DIR_BACKUP = Backup\               DIR_PD = PD\
  DIR_BAD = Bad\                     DIR_PIRATE = Pirate\
  DIR_CDROM = CDROM\                 DIR_UNKNOWN = Unknown\
  DIR_DUPLICATES = Dupes\            DIR_USA = USA\
  DIR_JAPAN = Japan\

DIR_BASE sets the base directory all the other directories will fall under.
If DIR_BASE is left empty, the base directory will default to the current
directory you run PCEToy from.  DIR_BASE will only affect relative pathnames.
For example, if DIR_BASE is set to C:\ROMS\ and DIR_USA is set to USA\, then
DIR_USA will be expanded to C:\ROMS\USA\.  However, if DIR_USA is set to
something similar to C:\ROMS2\USA\, it will not be affected by DIR_BASE.

PARAM_MISSING = [cn]    Default parameters can be assigned to be used with
PARAM_REN = [uscltp]    the -missing and -ren command line options with these
                        settings.  Valid parameters are shown in brackets.
                        These parameters are described in the "parameters"
                        section of these docs.

NO_BACKUP = FALSE       When set to TRUE,  has the same effect as the
                        -nobackup command line parameter


Output
------
* Bonk's Adventure.pce                                         USA - 599ead9b
|          |                                                    |  |    |
1          2                                                    3  4    5

  1 - ROM Status
     * - ROM is identified and good.
     ? - Unknown ROM
     x - ROM is identified and contains a repairable hack.  Use
         -repair to fix.
     d - ROM is a duplicate
     n - Name does not match ROM name in database
     b - ROM is a bad dump
 2 - File Name
 3 - Country or ROM Type (USA, Jap, or PD)
 4 - Shows whether a header is present (+ = yes, - = no)
 5 - Checksum (CRC-32)


Known Issues
------------
* If you do not create a new missing file with each new release, any database
  additions made will not show up on the list.

* Bad Dumps automatically detected by PCEToy that are not in the database
  will never show up on the missing list.  ROMs of this type are obviously
  corrupt and I see no reason to add them to the database.

* When PCEToy is moving and/or renaming a ROM, sometimes it encounters a ROM
  already there with the same name.  PCEToy will first try to attach a
  country code to the ROM it is moving to differentiate it.  If that fails,
  PCEToy will be unable to move/rename the ROM.  You will usually encounter
  this if you are using the same directory to store Japanese and USA ROMs or
  if you have unknown or misplaced ROMs in the destination directory.

* Remember, even though PCEToy -doall invokes the default settings for
  -missing and -ren, you can still specify your own settings for these
  options on the command line or in the pcetoy.cfg file.
  Example: PCEToy -doall -renc will rename all your ROMs with country codes
  attached while still performing all the other options invoked by (-doall)
  normally.

* PCEToy has an internal limit of 4000 files per directory.  If you have
  more than 4000 files in a directory, PCEToy will only process up to the
  4000th file.  If you have PCEToy set to sort the ROMs it processes into
  different directories, you can just run PCEToy again to process the
  remaining ROMs.


Everything Else
---------------
If you have any suggestions, praise, criticism (the constructive kind),
or comments, please e-mail me at digitoxin@mindspring.com.
