1 files changed, 132 insertions, 0 deletions
diff --git a/system/bin2iso/readme.txt b/system/bin2iso/readme.txt
new file mode 100644
index 0000000000..62309bfbda
--- /dev/null
+++ b/system/bin2iso/readme.txt
@@ -0,0 +1,132 @@
+Jul 25 1999, 09:29:46
+bin2iso V1.9b - Converts RAW format (.bin) files to ISO/WAV format
+               Bob Doiron, ICQ#280251
+
+Linux port by Owen: mxu@cae.wisc.edu
+
+Check for updates at http://users.andara.com/~doiron
+
+Usage: bin2iso <cuefile> [<output dir>] [-[a]wg] [-t XX] [-i] [-nob]
+or   : bin2iso <cuefile> -c <binfile>
+
+Where:
+   <cuefile>    - the .cue file that belongs to the .bin file to
+                  be converted
+   <output dir> - the output directory (defaults to current dir)
+   -nwg         - indicates that audio data found in the track
+                  'gaps' shouldn't be appended to the audio tracks
+   -awg         - looks for non-zero data in the 'gaps', if found
+                  then gaps are appended to audio tracks. Looks
+                  for more than 1/2 of a sector of non-zero values
+                  (588 values),
+   -t XX        - Extracts the XX'th track.
+   -i           - Performs the conversion 'in place'. Meaning it
+                  truncates the binfile after each track is
+                  created to minimize diskspace requirements.
+                  [not valid with -t]
+   -nob         - Doesn't use overburn data past 334873 sectors.
+                  This of course presumes that the data is not
+                  useful.
+   -c           - Attempts to create a <cuefile> from an existing
+                  <binfile>
+
+
+---------------------------------------------------------------------
+NOTE: This is a work in progress!
+
+So far I beleive it handles MODE1, MODE2 and AUDIO tracks.
+
+Since I have little exposure to .bin files, and little expertise in 
+CD formats, I can't guarantee this will work for all .bin's.
+
+so... TEST the output before burning. Use Winimage on the ISO files  
+and a wave player on the WAVs.
+
+If you do run into trouble, send me the following info:
+- .cue file
+- command line used
+- the screen output 
+- directory listing of source and files created (with sizes)
+and I'll fix it up.
+
+Revision History 
+
+v1.9b
+ - Oops.. was no way to turn writegap off: 
+   changed -wg option to -nwg
+
+v1.9a
+ - Fixed bug in extracting single track
+ - changed code to default to writing gap data because of the way 
+   easycd pro writes the table of contents for the cd
+
+v1.9
+ - revamped internally allowing me to do add some functionality...
+   Added a -i option to allow converting a bin using a little diskspace
+   as possible. !NOTE! This is destructive to the original .bin
+ - No longer barfs on PREGAP lines...
+ - Added a -awg option that checks for non-zero data in the gaps between 
+   audio tracks and turns on the -wg feature if it finds more than half
+   a sector of non-zero values.
+ - Added a -nob option that ditches overburn data. I haven't tested this,
+   but rumour has it that some cd players can't access data over 74.XX 
+   minutes. I'm not sure if I beleive this, but I put the option in in
+   case I get a chance to try it. (so far untested!)
+
+v1.8b
+ - modified the audio gap detection scheme for creating cue files...
+   Now it may detect extra gaps, but they are easily removed by editing
+   the cuefile. Before it would sometimes not detect gaps, so I think
+   this is better.
+
+v1.8
+ - Added the ability to create a cuefile from a binfile.
+   (assumes MODE1/2352, MODE2/2352 or AUDIO tracks)
+ - Added ISO track numbering for cd's with more than one data track
+
+v1.7
+ - Made the reads/writes happen in 4Meg chunks... should speed things up 
+   when read from and writing to the same disk. (less head thrashing)
+ - Added Mode2/2336: When this type of track is encountered, it converts
+   it to the trusty Mode2/2352 track we're used to. (Burn with EasyCD
+   or open with WinImage)
+   Or, if you like, you can rename the output from a .iso to a .bin and then 
+   edit the cue file track type from MODE2/2336 to MODE2/2352 to burn with 
+   cdrwin.
+
+v1.6
+ - Added a '-wg' command switch to make bin2iso append pregap sectors to the
+   last wav file. Useful because some cd's have music in the pregaps.
+   Note: most TAO burning leaves 2 second gaps between songs, so if you copy
+         a copy, then don't use the -wg option. If you do use it, then the 
+         audio track will grow by 2 seconds.
+
+v1.5
+ - Fixed parsing of the filename from the cue file. (handles spaces etc)
+ - Added progress display
+ - Detects a single track, mode2 bin which can be burnt as is.
+ - Verifies data tracks (checks the mode and frame sequence)
+
+v1.4
+ - fixed bug that occured when tracks had no pregap index
+ - parsing of .bin filename out of .cue file now ditches path info
+ - fixed bugs in [<output dir>] parsing. (trailing '\' or ':')
+
+v1.3
+ - first release to public
+
+Suggested programs:
+WinImage - for viewing ISO images
+EasyCD Pro 2.11 (020) - for burning ISO or Mixed mode ISO/WAV
+                         (rumour is that creator doesn't always burn the 
+                          images as is, sometimes screws long filenames
+                          or burns a mode2 iso in mode1 form, etc, etc)
+Nero - Burning Rom    - For burning AUDIO disks because it allows changing 
+                        the gap size on my sony928e.
+
+!DO NOT USE! Easy CD Creator for burning mode2/2352 images. You'll get a coaster.
+                   
+
+TROUBLESHOOTING
+
+Don't know of any problems right now. Let me know.