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