rmagick 1.7.1

data/ChangeLog

@@ -0,0 +1,232 @@
+RMagick 1.7.1
+    o Fix bugs #1250, #1253
+    o Tested with ImageMagick 6.1.7, Ruby 1.8.2
+
+RMagick 1.7.0
+    o Added splice, set_channel_depth to Image class (ImageMagick 6.0.0)
+    o Added sharpen_channel, blur_channel to Image class (ImageMagick 6.0.1)
+    o Added get_multiline_type_metrics to Draw class (ImageMagick 6.1.5),
+      added new example scripts and images
+    o Added normalize_channel, unsharp_mask_channel to Image class
+      (ImageMagick 6.1.0)
+    o Added read_inline to Image class
+    o Renamed channel_compare to compare_channel, retained old name as an alias
+      for backward compatibility.
+    o Added default values for unsharp_mask arguments
+    o Fixed bug #1193
+    o Fixed segfault in destroy_Draw when Ruby gc'd the temp file name
+      array before calling destroy_Draw
+    o Tested with ImageMagick 6.1.6, GraphicsMagick 1.1.4, Ruby 1.8.2preview3.
+
+RMagick 1.6.2
+    o Fixed ImageList#deconstruct to return an imagelist
+    o Fixed installation procedure to propagate user's CFLAGS, CPPFLAGS,
+      and LDFLAGS through to the low-level Makefile
+    o Fixed bugs #1048, #1127
+
+RMagick 1.6.1
+    o Changed to match changes in ImageMagick 6.1.4 API
+    o Fixed bug #950
+
+RMagick 1.6.0
+    o Added posterize, gaussian_blur_channel, convolve_channel methods to Image class
+      (ImageMagick 6.0.0)
+    o Added new CompositeOperator constants (ImageMagick 6.0.0)
+    o Added trim and trim! methods to Image class
+    o Added each method to Enum subclasses
+    o Added stroke_width= attribute to the Draw class
+    o Fixed bugs #624, #642, #716, applied patch #819 (thanks to Daniel Quimper)
+    o Tested with ImageMagick 6.0.5-2, GraphicsMagick 1.1.3, Ruby 1.8.2
+
+RMagick 1.5.0
+    o Added meaningful implementations of dup and clone to the Image and Draw
+      classes. Clarified the documentation.
+    o Do not allow changes to frozen Image, ImageList, and Draw objects.
+    o Raise TypeError if freeze method sent to Image::Info or ImageList::Montage
+      object.
+    o Added view method to Image, Image::View class (thanks to Ara T. Howard and
+      Charles Comstock on c.l.r for the discussion which prompted me to add this class)
+    o Added grayscale_pseudo_class method to Image class (GraphicsMagick 1.1)
+    o Added radial_blur, random_threshold_channel methods to Image class
+      (ImageMagick 6.0.0)
+    o Added quantum_operator method to Image class (GraphicsMagick 1.1, ImageMagick 6.0.0)
+    o Added statistics method to Image class (GraphicsMagick 1.1)
+    o Support channel_extrema, channel_mean with GraphicsMagick 1.1
+    o Added endian attribute to Image class
+    o Added composite! method to Image class
+    o Deprecated random_channel_threshold method when linked with ImageMagick 6.0.0.
+
+RMagick 1.4.0
+    o Revised and updated documentation
+    o Implemented enumeration values as instances of an Enum
+      class. Based on a description by Paul Brannon in ruby-talk 79041.
+    o Added HSLColorspace, HWBColorspace constants (ImageMagick 5.5.7,
+      GraphicsMagick 1.0.2)
+    o Added CopyCyanCompositeOp, CopyMagentaCompositeOp,
+      CopyYellowCompositeOp, CopyBlackCompositeOp constants (ImageMagick 5.5.7,
+      GraphicsMagick 1.1)
+    o Added ReplaceCompositeOp. CopyCompositeOp constants (ImageMagick 6.0.0)
+    o Added color_histogram to Image class. (ImageMagick 6.0.0, GraphicsMagick 1.1)
+    o Added define method to Image::Info class (ImageMagick 6.0.0, GraphicsMagick 1.1)
+    o Added tint, each_profile, channel_extrema, channel_compare,
+      channel_depth, channel_mean, quantum_depth, preview, gamma_channel,
+      negate_channel, bilevel_channel methods to Image class (ImageMagick 6.0.0)
+    o Added get_exif_by_entry, get_exif_by_tag to Image class
+    o Added border! method to Image class
+    o Added fcmp, intensity methods to Pixel class
+    o Added Version_long constant
+    o The 'fuzz' attribute in the Image and ImageInfo classes now
+      accepts a percentage value as well as a numeric value.
+    o Added Geometry class and changed all methods that accept a geometry
+      string to accept a Geometry object as well
+    o Added dup and clone methods to the ImageList, Image, and Draw
+      classes (Fix for bug #254.)
+    o Tested with latest ImageMagick 6.0.0 beta and GraphicsMagick 1.1 snapshot
+
+RMagick 1.3.2
+    o Fix profile! to require only 2 arguments, as documented.
+    o Correct spelling of 'transparent' in text_antialias.rb example.
+    o Add output of `Magick-config --libs` to LIBS variable in configure
+    o Minor fixes in documentation
+    o Test with GraphicsMagick 1.0.4
+    o Test with latest ImageMagick 5.5.8 beta
+
+RMagick 1.3.1
+    o Fixed default base URI in the links to the installed xMagick doc
+    o Applied the patch for bug #76 that caused the rubyname.rb example
+      to hang when installing on FreeBSD.
+    o Fixed the <=> method in Image to return nil when the class of the
+      other object is not Image
+    o Added code to ensure that the `text' argument to Draw#text is not
+      nil or empty
+    o Fixed the handle_error function to re-initialize the exception
+      structure after destroying its contents.
+
+RMagick 1.3.0
+    o Added strip!, import_pixels, export_pixels, random_channel_threshold
+      to the Image class. (Available only with ImageMagick 5.5.8, which
+      is still in beta.)
+    o Added black_threshold and white_threshold to the Image class.
+    o Added format= attribute writer to the Image class
+    o Added monochrome= attribute writer to the Image::Info class
+    o Added annotate to the Image class.
+    o Made the image argument to get_type_metrics optional. (Thanks to
+      Hal Fulton for suggesting this change and the annotate change!)
+    o Enhance the read, write, and ping methods in both the Image
+      class and the ImageList class to accept an open File object as
+      well as a filename argument.
+    o Added change_geometry to the Image class
+    o Changed configure to generate top-level Makefile with install
+      and uninstall targets. (Thanks to Bob Friesenhahn for the
+      suggestion and the the Makefile!)
+    o Incorporated 1.2.2.1 patch to correct problems when building
+      with Ruby 1.6.7.
+    o Added "magick_location" attribute to the ImageMagickError
+      class. (Available only with GraphicsMagick 1.1, not yet released.)
+    o Tested with ImageMagick 5.5.8 beta
+    o Tested with GraphicsMagick 1.0.2 and 1.1 snapshot
+    o Tested with Ruby 1.8.0
+    o Changed to MIT license
+
+RMagick 1.2.2
+    o Fixed many bugs in configuration script
+    o Added support for GraphicsMagick 1.0 (with assistance from Bob Friesenhahn)
+    o Changed default documentation directory (--doc-dir option default) to
+      $prefix/share/RMagick
+    o Added "examples" directory to contain example programs that aren't
+      referenced by the documentation
+
+RMagick 1.2.1
+    o Yet another fix to the Cygwin installation procedure
+
+RMagick 1.2.0
+    o Changed install to work correctly on Cygwin
+      (Cygwin testing by Yuki Hirakawa and David Martinez Garcia.)
+    o Changed install to support Gentoo ebuild
+      (Gentoo support provided by Tom Payne.)
+    o Changed configure script to find IM doc in IM 5.5.7
+    o Added Image#capture
+    o Added optional matte_pct argument to Image#colorize
+    o Add default argument values to Image#gaussian_blur
+    o Fix bug in Image#store_pixels that prevented it from working with
+      GIF and other PseudoClass image formats
+    o Changed Image#crop and Image#crop! to accept a GravityType constant
+      as the first argument, instead of the x- and y-offset arguments.
+      (Suggested by Robert Wagner.)
+    o Added Image::Info#filename=, image_type=
+    o Added ImageList#__map__ as an alias for Enumerable#map
+    o Added fetch, insert, select, reject methods to ImageList class for
+      Ruby 1.8.0
+    o Undefined zip and transpose methods in ImageList class for Ruby 1.8.0
+    o ImageMagick 5.5.7 supported
+
+RMagick 1.1.0
+    o Fixed bug in handle_error that caused an abend when linked with IM 5.5.6
+    o Added RMAGICK image "format". When read, returns 252x108 RMagick logo
+      in PNG format.
+    o Changed examples to give all floating point constants a leading digit.
+    o Added Image#rotate!
+    o Tested with Ruby 1.8.0preview2
+    o Added Image#extract_info, Image::Info#extract=, Image::Info#scene=,
+      Image::Info#number_scenes=, Image::Info#tile=
+    o Added Draw#text_align, Draw#text_anchor, Draw#text_undercolor
+    o ImageMagick 5.5.6 supported
+
+RMagick 1.0.0
+    o Fixed warnings when compiling with Ruby 1.8.0
+    o Added Draw#rotation=, rotated_text.rb
+    o Fixed temp image files in Montage_texture and Draw_composite
+    o ImageMagick 5.5.5 supported
+
+RMagick 0.9.5
+    o Added channel.rb example
+    o Fixed install problems with IM 5.5.1
+
+RMagick 0.9.4
+    o Cleaned up documentation.
+    o Added logging methods Magick.set_log_event_mask and Magick.set_log_format
+    o Added Magick.set_monitor
+    o Added custom serialization methods _dump and _load to Image class.
+      Added marshaling section to usage doc.
+    o Added Image#mime_type
+    o Changed install to use autoconf-generated configure script
+    o Replaced makedoc.rb with post-install.rb hook
+    o Added rmconst.rb utility script
+    o ImageMagick 5.5.4 supported
+
+RMagick 0.9.3
+    o Changed ImageList#<=> to use same algorithm as Array#<=>
+    o Changed Draw class variables to class constants
+    o Fixed bug in Magick::colors method that caused some colors
+      to be repeated or missed when the optional block is used
+    o Changed fill classes to not inherit from common Fill class.
+      Removed Fill class.
+    o Improved usage documentation
+    o Added Image#level_channel, introduced with IM 5.5.3
+    o ImageMagick 5.5.3 supported
+    o Ruby 1.6.8, 1.8.0preview1 supported
+
+RMagick 0.9.2
+    o Added crop!, flip!, flop!, magnify!, minify!, resize!, sample!,
+      scale!, shave!, channel_threshold methods to Image class
+    o Documented DisposeType, ColorSeparationMatteType and OptimizeType
+      constants
+    o Changed Image#<=>, ImageList#<=> to raise TypeError if the other
+      argument is not in the same class
+    o Deleted Image#==, ImageList#==, include Comparable in both classes
+    o Added Image#thumbnail, thumbnail!, adaptive_threshold for 5.5.2 & later
+    o Used image list functions in 5.5.2 & later
+    o ImageMagick 5.5.2 supported
+    o Removed last vestiges of 5.4.9 support
+
+RMagick 0.9.1
+    o Added -Wl,rpath option to $LDFLAGS in extconf.rb
+    o #include <sys/types.h> in rmagick.h
+    o Changed set_cache_threshold to call SetMagickResourceLimit instead of SetCacheThreshold
+    o Changed Image_texture_flood_fill to clone texture image instead of adding a reference
+    o Many fixes to the Array methods in ImageList
+    o Defined Image#<=>, defined Image#== in terms of Image#<=>
+    o Defined ImageList#<=> in terms of Image#<=>
+
+RMagick 0.9.0
+    1st beta

data/Makefile.in

@@ -0,0 +1,28 @@
+
+# Path to ruby interpreter
+RUBY=@RUBY@
+
+# Any extra options from configure script to pass to 'install.rb config'
+RUBY_CONFIG_OPTS=@RUBY_CONFIG_OPTS@
+
+all: config.save
+	$(RUBY) install.rb setup
+
+install:
+	$(RUBY) install.rb install
+
+clean: config.save
+	$(RUBY) install.rb clean
+
+distclean: config.save
+	$(RUBY) install.rb clean
+	rm -f Makefile ext/RMagick/extconf.rb metaconfig
+	rm -f config.status Makefile config.cache config.log
+	rm -rf autom4te.cache
+
+uninstall: config.save
+	$(RUBY) uninstall.rb $(RUBY_CONFIG_OPTS)
+
+config.save: metaconfig
+	$(RUBY) install.rb config $(RUBY_CONFIG_OPTS)
+

data/README.html

@@ -0,0 +1,404 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <meta name="generator" content=
+    "HTML Tidy for Linux/x86 (vers 1st September 2002), see www.w3.org">
+    <title>RMagick 1.7.1 README</title>
+    <meta http-equiv="Content-Type" content=
+    "text/html; charset=ISO-8859-1">
+    <meta name="GENERATOR" content="Quanta Plus">
+  </head>
+  <body>
+    <div align="center">
+      <h1>RMagick 1.7.1</h1>
+      <h2>README</h2>
+      <h4>12/25/04</h4>
+    </div>
+    <h2>Table of Contents</h2>
+    <ul>
+      <li><a href="#introduction">Introduction</a></li>
+      <li><a href="#contact_information">Contact
+      information</a></li>
+      <li><a href="#prerequisites">Prerequisites</a></li>
+      <li><a href="#tips">Tips for installing and configuring
+      ImageMagick and GraphicsMagick</a></li>
+      <li><a href="#installing_rmagick">Installing RMagick</a>
+        <ul>
+          <li><a href="#configuration_options">Configuration
+          options</a></li>
+          <li><a href="#running">Running the configure and make
+          scripts</a></li>
+        </ul>
+      </li>
+      <li><a href="#things_that_can_go_wrong">Things that can go
+      wrong</a></li>
+      <li><a href="#upgrading">Upgrading</a></li>
+      <li><a href="#uninstalling">Uninstalling</a></li>
+      <li><a href="#more_samples">More samples</a></li>
+      <li><a href="#undocumented_features">Undocumented
+      features</a></li>
+      <li><a href="#known_issues">Known issues</a></li>
+      <li><a href="#reporting_bugs">Reporting bugs</a></li>
+      <li><a href="#credits">Credits</a></li>
+      <li><a href="#license">License</a></li>
+    </ul>
+    <h2><a name="introduction">Introduction</a></h2>
+    <p>RMagick is an interface between the Ruby programming
+    language and the ImageMagick and GraphicsMagick image
+    processing libraries.</p>
+    <h2><a name="contact_information">Contact Information</a></h2>
+    <b>Author:</b>&nbsp;Tim Hunter<br>
+     <b>Email:</b>&nbsp;<a href=
+    "mailto:rmagick@rubyforge.org">rmagick@rubyforge.org</a><br>
+    <b>RubyForge:</b>&nbsp;<a href="http://rubyforge.org/projects/rmagick">RMagick</a><br>
+
+    <h2><a name="prerequisites">Prerequisites</a></h2>
+    <dl>
+        <dt><b>O/S</b></dt>
+        <dd>Linux, Sun Solaris, Cygwin, FreeBSD, MS Windows 98 and later.</dd>
+        <dt><b>Ruby</b></dt>
+        <dd>Ruby 1.6.7 or later. You can get Ruby from
+            <a href="http://www.ruby-lang.org">www.ruby-lang.org</a></dd>
+    </dl>
+    One of
+    <dl>
+        <dt><b>ImageMagick</b></dt>
+        <dd>ImageMagick 6.0.0 or later. You can get ImageMagick
+        from <a href="http://www.imagemagick.org">www.imagemagick.org</a>.</dd>
+        <dt><b>GraphicsMagick</b></dt>
+        <dd>GraphicsMagick is a friendly fork of ImageMagick 5.5.1.
+        You can get GraphicsMagick from <a href="http://www.graphicsmagick.org">www.graphicsmagick.org</a>.</dd>
+    </dl>
+    <p>You only need one of ImageMagick or GraphicsMagick. RMagick
+    works equally well with both. Some RMagick methods may not be supported in one or the other library.</p>
+    <h2><a name="tips">Tips for installing and configuring
+    ImageMagick and GraphicsMagick</a></h2>
+    <p>if you are installing RMagick by compiling the source code,
+    I <em>strongly</em> encourage you to install the latest version
+    of ImageMagick or GraphicsMagick <em>from source</em>.
+    If you have never installed ImageMagick or GraphicsMagick
+    before, I also strongly encourage you to
+    read the README.txt file as many times as is necessary for you
+    to understand how to configure it. ImageMagick and
+    GraphicsMagick are large and complicated programs and can be
+    difficult to configure. Follow these tips to minimize the
+    amount of time you'll spend and your frustration level.</p>
+    <p>Do <i>not</i> simply type ./configure and expect the
+    defaults to be correct for you. Since you are installing ImageMagick/GraphicsMagick to use
+    with Ruby, consider whether you want to skip
+    ImageMagick's/GraphicMagicks' support for Perl and C++ by using
+    the --without-perl and --without-magick-plus-plus options.
+    Doing so will speed up the installation process and save some
+    disk space. You will almost certainly want to specify the
+    --enable-shared and --disable-static options.</p>
+    <p>Determine which image formats you are interested in using
+    and make sure that you have installed the libraries that
+    ImageMagick/GraphicsMagick uses to process these formats.
+    ImageMagick and GraphicsMagick use additional libraries to
+    support some image formats. If you do not install those
+    libraries you cannot read and write those image formats. You
+    will need to configure ImageMagick/GraphicsMagick to support
+    the JPG, PNG, TIFF, and WMF formats in order to execute all the
+    RMagick sample programs. See ImageMagick's or GraphicMagick's
+    README.txt file for more information.</p>
+    <p>Once you have determined the configuration options you need,
+    run the configure script. When it completes, read the summary
+    output to see if configuration worked the way you expected.
+    Here's an example of the summary output from ImageMagick's
+    configure script. Notice that the result of each option is
+    listed in the "Configured value" column.</p>
+<pre>
+                  Option                        Value
+-------------------------------------------------------------------------
+Shared libraries  --enable-shared=yes           yes
+Static libraries  --enable-static=no            no
+Module support    --with-modules=yes            yes
+GNU ld            --with-gnu-ld=yes             yes
+LZW support       --enable-lzw=yes              yes
+Quantum depth     --with-quantum-depth=8        8
+
+Delegate Configuration:
+BZLIB             --with-bzlib=yes              yes
+DPS               --with-dps=yes                yes
+FlashPIX          --with-fpx=yes                no
+FreeType 2.0      --with-ttf=yes                yes
+Ghostscript       None                          gs (7.07.2)
+Ghostscript fonts --with-gs-font-dir=default    /usr/share/fonts/default/Type1/
+Ghostscript lib   --with-gslib=no               no
+Graphviz          --with-dot=yes                no
+JBIG              --with-jbig=yes               no
+JPEG v1           --with-jpeg=yes               yes
+JPEG-2000         --with-jp2=yes                no
+LCMS              --with-lcms=yes               yes
+Magick++          --with-magick-plus-plus=no    no
+PERL              --with-perl=no                no
+PNG               --with-png=yes                yes
+TIFF              --with-tiff=yes               yes
+Windows fonts     --with-windows-font-dir=/mnt/windows/windows/fonts    /mnt/windows/windows/fonts/
+WMF               --with-wmf=yes                yes
+X11               --with-x=                     yes
+XML               --with-xml=yes                yes
+ZLIB              --with-zlib=yes               yes
+
+X11 Configuration:
+  X_CFLAGS     = -I/usr/X11R6/include
+  X_PRE_LIBS   = -lSM -lICE
+  X_LIBS       = -L/usr/X11R6/lib
+  X_EXTRA_LIBS =
+</pre>
+    <p>If the results are not what you wanted, install any missing
+    libraries, choose new or different options, or whatever it
+    takes, erase the config.cache file, and re-run configure.
+    Repeat as often as necessary before moving to the `make' and
+    `make install' steps.</p>
+    <p>Detailed information about all of ImageMagick's and
+    GraphicsMagick's configuration options may be found in their
+    README.txt and INSTALL.txt files.</p>
+    <h4>Windows Metafile Format</h4>
+    <p>As noted in the ImageMagick and GraphicsMagick README.txt
+    files, to support images in the Windows Metafile format,
+    ImageMagick/GraphicsMagick requires an additional library.
+    Without this library some of the RMagick sample programs will
+    not work. ImageMagick and GraphicsMagick require libwmf 0.2.5,
+    0.2.7, or 0.2.2 to support the WMF format. (Avoid libwmf
+    0.2.6!)</p>
+    <h2><a name="installing_rmagick">Installing RMagick</a></h2>
+    <p>Installing RMagick is much simpler than installing
+    ImageMagick or GraphicsMagick. Note that the <i>make</i> step
+    runs all the example programs. This process both builds the
+    example images used in the documentation and validates your
+    RMagick installation. This step can take 5-15 minutes depending
+    on the speed of your computer.</p>
+    <h4><a name="configuration_options">Configuration
+    options</a></h4>
+    <p>Type <code>./configure --help</code> to see a list of
+    configuration options. In addition to the regular options,
+    there are a few RMagick-specific options:</p>
+    <dl>
+      <dt>--with-doc-dir=directory</dt>
+      <dd>
+        Specify the directory to install the RMagick documentation.
+        By default this is $prefix/share/RMagick, where $prefix is
+        the prefix specified by --prefix. For example, to install
+        the documentation in /home/user/RMagick, specify:
+<pre>
+./configure --with-doc-dir=/home/user/RMagick
+</pre>
+      </dd>
+      <dt>--enable-allow-example-errors</dt>
+      <dd>Normally the documentation installation terminates if 5
+      examples fail. If you use this option, the installation does
+      not check for failing examples and will always complete. This
+      option is useful if you're having trouble installing RMagick
+      and you want to see all the failing examples.</dd>
+      <dt>--with-graphics-magick</dt>
+      <dd>If you have both ImageMagick and GraphicsMagick installed, this option will force RMagick to be configured with GraphicsMagick.</dd>
+      <dt>--with-so-dir=directory</dt>
+      <dd>The directory for ruby extensions.</dd>
+      <dt>--with-ruby-path=directory</dt>
+      <dd>The path to set the !# line in Ruby scripts. The default is <code>$prefix/bin/ruby</code>.</dd>
+      <dt>--with-ruby-prog=name</dt>
+      <dd>The name of the Ruby executable. The default is <code>ruby</code>.</dd>
+      <dt>--with-make-prog=name</dt>
+      <dd>The name of the <code>make</code> program.</dd>
+      <dt>--with-rbconfig=path</dt>
+      <dd>The path to the rbconfig.rb file to use. The default is Ruby's rbconfig.</dd>
+    </dl>
+    <br>
+
+    <h4><a name="running">Running the <code>configure</code> and
+    <code>make</code> scripts</a></h4>
+    <p>De-compress the RMagick-1.7.1.tar.gz archive and
+    enter the top directory. Then type:</p>
+<pre>
+    $ ./configure &lt;configuration options&gt;
+    $ make
+   ($ su)
+    $ make install
+   (optionally)
+    $ make clean
+</pre>
+    <h2><a name="things_that_can_go_wrong">Things that can go
+    wrong</a></h2>
+    <dl>
+      <dt><b>Cannot open shared object file</b></dt>
+      <dd>
+        <p>When <code>make</code> is running the examples, if you get
+        a message like this:</p>
+<pre>
+/home/you/RMagick-1.7.1/lib/RMagick.rb:11:in `require': libMagick.so.0:
+  cannot open shared object file: No such file or directory -
+  /home/you/RMagick-1.7.1/ext/RMagick/RMagick.so (LoadError)
+</pre>
+        <p>you probably do not have the directory in which the
+        ImageMagick or GraphicsMagick library is installed in your
+        load path. An easy way to fix this is to define the
+        directory in the LD_LIBRARY_PATH environment variable. For
+        example, suppose you installed the GraphicsMagick library
+        libGraphicsMagick.so in /usr/local/lib. (By default this is
+        where it is installed.) Create the LD_LIBRARY_PATH variable
+        like this:</p>
+<pre>
+export LD_LIBRARY_PATH=/usr/local/lib
+</pre>
+        <p>On Linux, see <code>ld(1)</code> and
+        <code>ld.so(8)</code> for more information. On other
+        operating systems, see the documentation for the dynamic
+        loading facility.</p>
+      </dd>
+      <dt><b>No such file or directory -
+      "/tmp/rmagick6872.6"</b></dt>
+      <dd>
+        <p>When <code>make</code> is running the examples, if you get
+        a message like this:</p>
+<pre>
+hook /home/me/src/RMagick-1.7.1/./post-setup.rb failed:
+No such file or directory - "/tmp/rmagick6872.6"
+</pre>
+        <p>you probably do not have a temporary directory
+        environment variable set. Set the TMPDIR environment
+        variable to your temporary directory. For example:</p>
+<pre>
+export TMPDIR=/home/me/tmp
+</pre>
+      </dd>
+    </dl>
+    <h2><a name="upgrading">Upgrading</a></h2>
+    <p>If you upgrade to a newer release of ImageMagick or
+    GraphicsMagick, make sure you're using a release of RMagick
+    that supports that release. Usually I put out a new release of
+    RMagick with every new release of ImageMagick. It's safe to
+    install a newer release of RMagick over an earlier release.</p>
+    <h2><a name="uninstalling">Uninstalling</a></h2>
+    <p>The `uninstall' target will uninstall RMagick completely:</p>
+    <blockquote><code>make uninstall</code></blockquote>
+    <h2>More samples</h2>
+    <p>You can find more sample RMagick programs in the /example
+    directory. These programs are not installed in the RMagick
+    documentation tree.</p>
+    <h2><a name="undocumented_features">Undocumented
+    features</a></h2>
+    <p>This release includes an extra feature that isn't in the
+    documentation. The Magick module defines two methods that
+    control ImageMagick's logging function. This function is not
+    officially documented by ImageMagick, so I have decided not to
+    add them to RMagick's documentation. However, you may find them
+    helpful for debugging your application. (Caveat: these two
+    methods may change behavior or be removed without advance
+    notice! You are on your own!)</p>
+    <p><i>Magick::set_log_event_mask(event [,...]) -&gt;
+    Magick</i></p>
+    <p>The arguments are one or more "event domains". The
+    set_log_event_mask method recognizes these event domains:
+    "all", "annotate", "blob", "cache", "coder", "configure",
+    "deprecate", "draw", "locale", "none", "resource", "transform", "user",
+    and "x11". ImageMagick events that match the mask are logged.
+    The default domain is "none". For example,</p>
+<pre>
+          Magick::set_log_event_mask("render")
+
+</pre>
+    <p>Logging is controlled by the log.mgk file, which may be
+    found in the same directory as the delegates.mgk files. (See
+    ImageMagick's README.txt file.) The purpose of the entries in
+    this file is undocumented, so your guess is as good as mine.
+    Also, the meaning of the event domains and exactly what events
+    are logged are undocumented.</p>
+    <p><i>Magick::set_log_format(format) -&gt; Magick</i></p>
+    <p>The default log format is described in the log.mgk file.
+    This method allows you to redefine the format at run-time. The
+    format argument is a string similar to an fprintf format
+    string. Each line in the log has the format described by the
+    format string. Characters that are not control characters are
+    printed as-is. The control characters are:</p>
+<pre>
+         %t - the current time
+         %r - the elapsed time
+         %u - the user time
+         %p - the pid (process id)
+         %m - the name of the ImageMagick source file that contains the
+              function that generated the event
+         %f - the name of the ImageMagick function that generated the
+              event
+         %l - the line number in the source file
+         %d - the event domain (one of the event mask strings listed above)
+         %e - the event name
+</pre>
+    <p>For example, the default log format is:</p>
+<pre>
+         Magick::set_log_format("%t %r %u %p %m/%f/%l/%d:\n  %e")
+</pre>
+    <h2><a name="known_issues">Known issues</a></h2>
+    <ol>
+      <li>
+        gcc 3.2, during the "install.rb setup" step, issues the
+        warning:
+<pre>
+cc1: warning: changing search order for system directory "/usr/local/include"
+cc1: warning:   as it has already been specified as a non-system directory
+</pre>
+        This does not indicate a problem.
+      </li>
+      <li>
+        With older releases of ImageMagick you may see the warning:
+<pre>
+/usr/include/sys/ipc.h:25:3: warning: #warning "Files using this header must be compiled with _SVID_SOURCE or _XOPEN_SOURCE"
+</pre>
+      This is harmless.
+      </li>
+    </ol>
+    <h2><a name="reporting_bugs">Reporting bugs</a></h2>
+    <p>Please report bugs in RMagick, its documentation, or its
+    installation programs to me via the bug tracker on the
+    <a href="http://rubyforge.org/projects/rmagick/">RMagick project page</a>
+    at RubyForge.
+    However, I cannot help with Ruby installation and configuration
+    or ImageMagick or GraphicsMagick installation and
+    configuration. Please report problems with that software to
+    their respective authors or distributors.</p>
+    <h2><a name="credits">Credits</a></h2>
+    <p>Thanks to</p>
+    <ul>
+      <li>Akinori MUSHA, for his work making RMagick available on
+      FreeBSD.</li>
+      <li>Tom Payne, for reporting bugs, sending me the Ruby 1.8.0
+      patches, and for the Gentoo ebuild.</li>
+      <li>Bob Friesenhahn, for GraphicsMagick. Also for his help with
+      the RMagick installation and many other things.</li>
+      <li>
+        Simple Systems, for hosting the RMagick documentation online.
+      </li>
+      <li>Mike Williams, for the RMagick Debian package</li>
+      <li>ImageMagick Studio LLC, for ImageMagick and for
+      hosting the RMagick documentation.</li>
+      <li>Kaspar Schiess, for the MS Windows gem.</li>
+    </ul>
+    <h2><a name="license">License</a></h2>
+
+      <div style="padding: 1em; margin-left: 5%; margin-right: 5%; background-color: #dcdcdc">
+
+      <p>Copyright &copy; 2004 by Timothy P. Hunter</p>
+<p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+</p>
+
+
+<p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p>
+
+
+
+<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. </p>     </div>
+    <div align="center" style="padding: 3em">
+    <table>
+    <tr>
+    <td>
+    <a href="http://www.opensource.org/docs/definition.php">
+    <img src="http://www.opensource.org/trademarks/osi-certified/web/osi-certified-60x50.gif"
+    border="0" width="60" height="50"></a>
+    <td align="center">
+    <p><strong>This software is OSI Certified Open Source Software.<br>
+OSI Certified is a certification mark of the Open Source Initiative.</strong></p>
+    </td></tr></table>
+    </div>
+  </body>
+</html>