doc/genisoimage/README.releasenotes

   1 # @(#)README    1.7 99/11/23 joerg
   2 #                   06/09/11 christian
   3
   4 This describes the program as shipped with cdrkit, a spinoff from the
   5 cdrtools project. However, the cdrtools developers are no longer
   6 involved in the development of this spinoff and therefore shall not
   7 be made responsible for any problem caused by it. Do not try to get
   8 support for this program by contacting the original authors.
   9
  10 Note:
  11
  12         This program requires a lot of virtual memory to run since it
  13 builds all of the directories in memory.  The exact requirements
  14 depend upon a lot of things, but for Rock Ridge discs 12Mb would not
  15 be unreasonable.  Without RockRidge and without the translation
  16 tables, the requirements would be considerably less.
  17
  18
  19 *****************************
  20 Notes for version 1.12
  21
  22         Joliet support is now complete.  See the -J option.
  23
  24         The file scanning code is much improved - mkisofs can use multiple
  25         sources of input files and merge them together to form the output
  26         image.  In addition, each source can be grafted at any point in the
  27         iso9660 image.
  28
  29         The image writing code has been cleaned up to make it much easier
  30         to add custom extensions.
  31
  32         The ADD_FILES feature has been removed as it didn't work well,
  33 and it was hard to figure out.  The recent rearrangements in the
  34 file scanning code would tend to solve these issues.
  35
  36 *****************************
  37 Notes for version 1.11
  38
  39         There is a feature which can be optionally compiled into
  40 mkisofs that allows you to merge arbitrary directory trees into the
  41 image you are creating.  You need to compile with -DADD_FILES for my
  42 changes to take effect.   Thanks to Ross Biro biro@yggdrasil.com.
  43
  44 *****************************
  45 Notes for version 1.10b1
  46
  47         Big news is that multi-session capability is very close to being
  48         done.  There is still a missing interface to cdwrite that is
  49         used to determine the next writable address and the sector number
  50         of the last existing session.  Until we get the interface to cdwrite
  51         done, this is a beta version.
  52
  53         Bug involving DST fixed (dates are always calculated, since some
  54         files may be DST and other ones would not be).
  55
  56         Unfortunately the notes on some of the small patches got lost.
  57
  58 *****************************
  59 Notes for version 1.06
  60
  61         Jan-Piet Mens <jpm@mens.de> added support for the '-m' switch. This
  62         allows exclusion of shell-style globs from the CDROM.
  63         See manual mkisofs.8 for more information.
  64
  65 *****************************
  66 Notes for version 1.05
  67
  68         Added support for '-r' switch.  This is very similar to -R for
  69 Rock Ridge, but echos of the development environment are removed
  70 (i.e. uid/gid set to 0, and permissions of the files are canonicalized).
  71 Useful in applications where a distribution medium is being produced.
  72
  73 *****************************
  74 Notes for version 1.04
  75
  76         No notes for 1.04.
  77
  78 *****************************
  79 Notes for version 1.03
  80
  81         No notes for 1.03.
  82
  83 *****************************
  84 Notes for version 1.02.
  85
  86         Minor bugfixes here and there.  Support for compiled in
  87 defaults for many of the text fields in the volume header are now
  88 present, and there is also support for a file ".mkisofsrc" that can
  89 also read settings for these parameters.
  90
  91         A short script "Configure" was added to allow us to set up special
  92 compile options that depend upon the system that we are running on.
  93 This should help stamp out the sphaghetti-isms that were starting to grow
  94 up in various places in the code.
  95
  96         You should get more meaningful error messages if you run out of
  97 memory.
  98
  99 *****************************
 100 Notes for version 1.1.
 101
 102         The big news is that SUSP CE entries are now generated for
 103 extremely long filenames and symlink names.  This virtually guarantees
 104 that there is no limit (OK, well, about 600Mb) for file name lengths.
 105 I have tested this as well as I can, and it seems to work with linux.
 106 This would only be used very rarely I suspect.
 107
 108         Also, I believe that support for VMS is done.  You must be
 109 careful, because only Stream-LF and FIxed length record files can be
 110 recorded.  The rest are rejected with error messages.  Perhaps I am
 111 being too severe here.
 112
 113         There is a bugfix in the sorting of entries on the disc - we
 114 need to stop comparing once we reach the ';' character.
 115
 116         There are four new options -z -d -D -l -V.  Some of these tell
 117 mkisofs to relax some of the iso9660 restrictions, and many systems
 118 apparently do not really seem to mind.  Use these with caution.
 119
 120         Some diagnostic programs to scan disc images are in the diag
 121 directory.  These are not as portable as mkisofs, and may have some
 122 bugs.  Still they are useful because they can check for bugs that I might
 123 have introduced as I add new features.
 124
 125 *****************************
 126 Notes for version 1.0.
 127
 128         In version 1.0, the date fields in the TF fields were fixed -
 129 previously I was storing st_ctime as the file creation time instead of
 130 the file attribute change time.  Thanks to Peter van der Veen for
 131 pointing this out.  I have one slight concern with this change,
 132 however.  The Young Minds software is definitely supplying 3 dates
 133 (creation, modification and access), and I would strongly suspect that
 134 they are incorrectly putting the file attribute change time in the
 135 file creation slot.  I would be curious to see how the different RRIP
 136 filesystems treat this.  Anyway, this is something to keep in the back
 137 of your mind.
 138
 139         The symlink handling was not quite correct in 0.99 - this is
 140 now fixed.  Only some systems seemed to have been affected by this bug.
 141
 142         A command line option is now present to allow you to
 143 specifically exclude certain files from the distribution.
 144
 145         The case where you do not have permissions to read a directory
 146 is now handled better by mkisofs.  The directory that cannot be opened
 147 is converted into a zero-length file, and processing continues normally.
 148
 149         A few portability things have been fixed (hopefully).
 150
 151
 152 Source: README from cdrtools package
 153 Edited for cdrkit by Christian Fromme <kaner@strace.org>
 154