(Note: This has been changed, and hopefully clarified, from the 3.00
version of this info.  Please read it.)

Thank you for acquiring a copy of XV, a pretty nifty X program.
I hope you enjoy using it, as I've enjoyed writing it.

The latest version of XV (or at least a pointer to it) is available
via anonymous ftp on ftp.cis.upenn.edu, in the directory pub/xv.  If
you're not sure if you have the latest version, or you are missing the
source or documentation for XV, PLEASE pick up the latest version of
the xv distribution.  Do *not* send mail unless absolutely necessary
(ie, you don't have ftp capability).

Note:  The documentation ('xvdocs.ps') may be installed in '/usr/local'.

If you're viewing this information via the 'About XV' command, and
you'd like to print it out, a copy of this info can be found in the
README file in the top-level XV source directory.  Print that.  If you
don't have it, see the previous paragraph.


XV Licensing Information
------------------------
XV IS SHAREWARE FOR PERSONAL USE ONLY.

You may use XV for your own amusement, and if you find it nifty,
useful, generally cool, or of some value to you, your registration fee
would be greatly appreciated.  $25 is the standard registration fee,
though of course, larger amounts are quite welcome.  Folks who donate
$40 or more can receive a printed, bound copy of the XV manual for no
extra charge.  If you want one, just ask.  BE SURE TO SPECIFY THE
VERSION OF XV THAT YOU ARE USING!

COMMERCIAL, GOVERNMENT, AND INSTITUTIONAL USERS MUST REGISTER THEIR
COPIES OF XV.

This does *not* mean that you are required to register XV just because
you play with it on the workstation in your office.  This falls under
the heading of 'personal use'.  If you are a sysadmin, you can put XV
up in a public directory for your users amusement.  Again, 'personal
use', albeit plural.

On the other hand, if you use XV in the course of doing your work,
whatever your 'work' may happen to be, you *must* register your
copy of XV.  (Note:  If you are a student, and you use XV to do
classwork or research, you should get your professor/teacher/advisor
to purchase an appropriate number of copies.)

XV licenses are $25 each.  You should purchase one license per
workstation, or one per XV user, whichever is the smaller number.  XV
is *not* sold on a 'number of concurrent users' basis.  If XV was some
$1000 program, yes, that would be a reasonable request, but at $25,
it's not.  Also, given that XV is completely unlocked, there is no way
to enforce any 'number of concurrent users' limits, so it isn't sold
that way.

Printed and bound copies of the 100-odd page XV manual are available
for $15 each.  Note that manuals are *only* sold with, at minimum, an
equal number of licenses.  (e.g.  if you purchase 5 licenses, you can
also purchase *up to* 5 copies of the manual)

The source code to the program can be had (as a compressed 'tar' file
split over a couple 3.5" MS-DOS formatted floppies) for $15, for those
who don't have ftp capabilities.

Orders outside the US and Canada must add an additional $5 per manual
ordered to cover the additional shipping charges.

Checks, money orders, and purchase orders are accepted.  Credit cards
are not.  All forms of payment must be payable in US Funds.  Checks
must be payable through a US bank (or a US branch of a non-US bank).
Purchase orders for less than $50, while still accepted, are not
encouraged.

All payments should be payable to 'John Bradley', and mailed to:
        John Bradley
        1053 Floyd Terrace
        Bryn Mawr, PA  19010
        USA


Site Licenses
-------------
If you are planning to purchase 10 or more licenses, site licenses are
available, at a substantial discount.  Site licenses let you run XV on
any and all computing equipment at the site, for any purpose
whatsoever.  The site license covers the current version of XV, and
any versions released within one year of the licensing date.  You are
also allowed to duplicate and distribute an unlimited number of copies
of the XV manual, but only for use within the site.  Covered versions
of the software may be run in perpetuity.

Also, it should be noted that a 'site' can be defined as anything
you'd like.  It can be a physical location (a room, building,
location, etc.), an organizational grouping (a workgroup, department,
division, etc.) or any other logical grouping ("the seventeen
technical writers scattered about our company", etc.).

The site license cost will be based on your estimate of the number of
XV users or workstations at your site, whichever is the smaller
number.

If you are interested in obtaining a site license, please contact the
author via electronic mail or FAX (see below for details).  Send
information regarding your site (the name or definition of the 'site',
a physical address, a fax number, and an estimate of the number of
users or workstations), and we'll get a site license out to you for
your examination.


Copyright Notice
----------------
XV is Copyright 1989, 1994 by John Bradley

Permission to copy and distribute XV in its entirety, for
non-commercial purposes, is hereby granted without fee, provided that
this license information and copyright notice appear in all copies.

If you redistribute XV, the *entire* contents of this distribution
must be distributed, including the README, and INSTALL files, the
sources, and the complete contents of the 'docs' directory.

Note that distributing XV 'bundled' in with any product is considered
to be a 'commercial purpose'.

Also note that any copies of XV that are distributed MUST be built
and/or configured to be in their 'unregistered copy' mode, so that it
is made obvious to the user that XV is shareware, and that they should
consider registering, or at least reading this information.

The software may be modified for your own purposes, but modified
versions may not be distributed without prior consent of the author.

This software is provided 'as-is', without any express or implied
warranty.  In no event will the author be held liable for any damages
arising from the use of this software.

If you would like to do something with XV that this copyright
prohibits (such as distributing it with a commercial product, using
portions of the source in some other program, distributing registered
copies, etc.), please contact the author (preferably via email).
Arrangements can probably be worked out.


The author may be contacted via:
    US Mail:  John Bradley
              1053 Floyd Terrace
              Bryn Mawr, PA  19010

    FAX:     (610) 520-2042

Electronic Mail regarding XV should be sent to one of these three addresses:
     xv@devo.dccs.upenn.edu               - general XV questions
     xvbiz@devo.dccs.upenn.edu            - all XV licensing questions
     xvtech@devo.dccs.upenn.edu           - bug reports, technical questions

Please do *not* send electronic mail directly to the author, as he
gets more than enough as it is.

This is the latest version of the XV jumbo patches I originally created in
February 2000 (but never distributed) and eventually updated and released in
May 2004, prompted by a discussion on LWN (http://lwn.net/Articles/76391/).
Information about the patches, updates to the patches, and the patches
themselves can all be found here:

	http://pobox.com/~newt/greg_xv.html
	http://freshmeat.net/projects/xvjumbopatches/

(Use the "Subscribe to new releases" link on the latter page if you want to
be notified of new versions automatically; trivial registration required.)

These patches incorporate all of the fix- and enhancement-patches available
from John's XV site (http://www.trilon.com/xv/downloads.html and
ftp://ftp.trilon.com/pub/xv/patches/), plus a number of my own fixes and
additions (security-related and otherwise), plus quite a few from other
people.  They're still not fully complete, and it's probable they never
will be, but I do plan to continue tinkering with them whenever the mood
strikes--and I may even release them publicly on rare occasions.  (At the
current rate, once every few years may be the best we can hope for....)

Also be aware that several other people have had the same idea over the
years.  Ones I've found, more or less by accident, include:

 - Landon Curt "chongo" Noll (http://www.isthe.com/chongo/)
   http://www.isthe.com/chongo/src/xv-patch/
 - Mark Ashley <mark ibiblio.org>
   http://www.ibiblio.org/pub/packages/solaris/sparc/html/xv.3.10a.p19.html
 - Peter Jordan <pete dc.seflin.org>
   http://www.ibiblio.org/pub/Linux/apps/graphics/viewers/X/xv-3.10a.patch.*
 - Uwe F. Mayer (http://www.tux.org/~mayer/)
   http://www.tux.org/~mayer/linux/book/node311.html
 - Kurt Wall <kwall kurtwerks.com>
   http://www.kurtwerks.com/software/xv.html
 - Chisato Yamauchi (http://phe.phyas.aichi-edu.ac.jp/~cyamauch/index_en.html)
   http://phe.phyas.aichi-edu.ac.jp/~cyamauch/xv.html
 - Daisuke Yabuki <dxy optix.org>
   http://www.optix.org/~dxy/solaris/xv/
 - Pekoe (http://pekoe.lair.net/)
   http://pekoe.lair.net/diary/xv.html
 - FreeBSD FreshPorts
   http://www.freshports.org/graphics/xv/
 - Kyoichiro Suda <sudakyo fat.coara.or.jp>
   http://www.coara.or.jp/~sudakyo/XV_jp.html

This is not an exhaustive list (e.g., J�rgen Grahn also had one).  So far,
most of the other patch-sets appear not to be as extensive or as up-to-date
as my own, particularly now that the (very large) "Japanese extension" patches
are incorporated--big thanks to Werner Fink of SuSE for that!

Below I summarize the component patches that are encompassed by my jumbo
bugfixes and jumbo enhancements patches, circa 2005.  (As of 2007, they're
distributed as a single monster-patch, and the "component patches" are now
listed in the changelog section at the bottom of this file.)  Unfortunately,
some of my own additions never saw the light of day as standalone patches,
but considering the number of overlaps (collisions) already implicit in the
list, that would have been difficult to accomplish even if I'd had the time.

Here's a quick guide to the "third-party" credits in the lists and changelog
below:

  AAC = Andrey A. Chernov [ache]
        (http://cvsweb.freebsd.org/ports/graphics/xv/files/patch-ab)
  AD  = Andreas Dilger (adilger clusterfs.com)
  AL  = Alexander Lehmann (lehmann usa.net)
  AS  = Alexey Spiridonov (http://www-math.mit.edu/~lesha/)
  AT  = Anthony Thyssen (http://www.cit.gu.edu.au/~anthony/)
  BR  = Bruno Rohee (http://bruno.rohee.com/)
  DAC = David A. Clunie (http://www.dclunie.com/xv-pcd.html)
  EAJ = Erling A. Jacobsen (linuxcub email.dk)
  EK  = Egmont Koblinger (egmont users.sourceforge.net)
  FG  = Fabian Greffrath (fabian debian-unofficial.org)
  GRR = Greg Roelofs (http://pobox.com/~newt/greg_contact.html)
  GV  = Guido Vollbeding (http://sylvana.net/guido/)
  IM  = IKEMOTO Masahiro (ikeyan airlab.cs.ritsumei.ac.jp)
  JC  = John Cooper (john.cooper third-harmonic.com)
  JCE = John C. Elliott (http://www.seasip.demon.co.uk/ZX/zxdload.html)
  JDB = John D. Baker (http://mylinuxisp.com/~jdbaker/)
  JG  = J�rgen Grahn (jgrahn algonet.se)
  JHB = John H. Bradley, of course (http://www.trilon.com/xv/)
  JPD = Jean-Pierre Demailly (http://www-fourier.ujf-grenoble.fr/~demailly/)
  JR  = John Rochester (http://www.freebsd.org/cgi/query-pr.cgi?pr=2920)
        (also http://cvsweb.freebsd.org/ports/graphics/xv/files/patch-af, -ag)
  JRK = James Roberts Kirkpatrick (uwyo.edu)
  JZ  = Joe Zbiciak (http://spatula-city.org/~im14u2c/)
  KS  = Kyoichiro Suda (http://www.coara.or.jp/~sudakyo/XV_jp.html)
  LCN = Landon Curt "chongo" Noll (http://www.isthe.com/chongo/)
  LJ  = Larry Jones (lawrence.jones ugs.com)
  PBJ = Peter Jordan (http://www.ibiblio.org/pub/Linux/apps/graphics/viewers/X/)
  PSV = Pawel S. Veselov (http://manticore.2y.net/wbmp.html)
  RAC = Ross Combs (rocombs cs.nmsu.edu)
  RJH = Robin Humble (http://www.cita.utoronto.ca/~rjh/)
  SB  = Sean Borman (http://www.nd.edu/~sborman/software/xvwheelmouse.html)
  SJT = TenThumbs (tenthumbs cybernex.net)
  SBM = Scott B. Marovich (formerly marovich hpl.hp.com)
  TA  = Tim Adye (http://hepwww.rl.ac.uk/Adye/xv-psnewstyle.html)
  TAR = Tim Ramsey (tar pobox.com)
  TI  = Tetsuya INOUE (tin329 chino.it.okayama-u.ac.jp)
  TO  = Tavis Ormandy (taviso gentoo.org)
  WF  = Werner Fink (http://www.suse.de/~werner/)

Other credits are as listed on the XV Downloads page or in the respective
patches (e.g., the jp-extension patches or within the PNG patch).

Finally, please note that these patches have not been blessed by John Bradley
in any way (although I copied him on the May 2004 announcement and wrote to
him again in May 2005), unless you count Debian's redistribution permission
(Daniel Kirchheimer, 5 Dec 2005).  Nor have I personally tested every change
and feature!  (See the BIG SCARY WARNING below for further caveats.)  In other
words, they're both completely unofficial and completely unguaranteed.  But
they seem to work for me.  (And when they don't, I try to fix 'em--eventually,
anyway... ;-) )

Greg Roelofs, 20070520
http://pobox.com/~newt/greg_contact.html


How to build
------------

The following assumes you, the user, already have the libtiff,[1] libjpeg,[2]
libpng,[3] zlib,[4] and JasPer[5] libraries downloaded, patched (if necessary),
compiled, and installed, not to mention a C compiler and the bzip2,[6] tar,[7]
patch,[8] and make[9] utilities.  You should also have downloaded the original
XV 3.10a source distribution from the XV Downloads page[10] and be able to edit
its Makefile and config.h files as indicated in the INSTALL file.  (Editing
the Makefile will also allow you to disable some of the third-party libraries
if you wish.)  Finally, you should know what a Unix(-style) command line is,
where to find one, and how to wield it with abandon (or at least with adult
supervision)--and preferably not as the root user until the "make install"
step.  (A filesystem is a terrible thing to waste.)

   [1] http://www.remotesensing.org/libtiff/
   [2] http://www.ijg.org/
   [3] http://www.libpng.org/pub/png/libpng.html
   [4] http://www.zlib.net/
   [5] http://www.ece.uvic.ca/~mdadams/jasper/
   [6] http://sources.redhat.com/bzip2/
   [7] http://www.gnu.org/directory/devel/specific/tar.html
   [8] http://www.gnu.org/directory/devel/specific/patch.html
   [9] http://www.gnu.org/directory/devel/specific/make.html
  [10] http://www.trilon.com/xv/downloads.html#src-distrib

+-------------------------------------------------------------------------+
|                                                                         |
|                            BIG SCARY WARNING                            |
|                                                                         |
|  These patches work for Greg (and parts of them reportedly work for     |
|  various other people), and so far Greg's CPU still computes and his    |
|  hard disks haven't been wiped.  But there's no guarantee that this     |
|  will be the case for you! In particular, not every incorporated patch  |
|  has been explicitly tested, nor has every possible subcase of the      |
|  explicitly tested subset. (Read that again; it's grammatical.)  Nor    |
|  are these patches officially blessed by John Bradley in any way. In    |
|  other words, if you use these patches, you do so at your own risk.     |
|  (Greg doesn't believe there are any serious problems remaining, but    |
|  then, what programmer ever does? Bugs happen.)                         |
|                                                                         |
+-------------------------------------------------------------------------+

Assuming you have the prerequisites out of the way and aren't scared
off by the Big Scary Warning, here's the build procedure:

      tar xvzf xv-3.10a-jumbo-patches-20070520.tar.gz
      (or:  gzip -dc xv-3.10a-jumbo-patches-20070520.tar.gz | tar xvf - )

      tar xvzf xv-3.10a.tar.gz

      cd xv-3.10a

      patch -p1 < ../xv-3.10a-jumbo-fix-enh-patch-20070520.txt

      edit Makefile and config.h as directed in INSTALL file (in particular,
      ensure paths to external libraries and header files are correct)

      make

      ./xv  your_favorite_image  your_other_favorite_image  etc.

If everything seems to be working to your satisfaction, go ahead and install:

      make -n install (and double-check that things will be installed
      where you want them to be)

      become root if necessary (e.g., type su)

      make install
      (or:  sudo make install)

That wasn't so hard, was it?


Summary of incorporated and unincorporated patches (through 20050501)
---------------------------------------------------------------------
(See the ChangeLog at the bottom for more recent incorporated patches.)

fixes ((*) = listed on XV Downloads page, (f) = on ftp site only):

20040516:
 - grabpatch (*)		[obsoleted by new-xvgrab.c below]
 - vispatch (*)
 - mp-tiff-patch (*)		[technically an enhancement, but JHB says...]
 - longname.patch (*)		[*SECURITY*]
 - xpm.patch (*)
 - deepcolor.patch (*)		[slightly modified for language conformance]
 - gifpatch (*)
 - exceed_grab.patch (*)
 - xv-redhat6-readme.txt (*)	[slightly modified for portability]
 - beos.patch (*)		[modified for portability]
 - croppad.patch (f)
 - epsfpatch (f)
 - tiff1200.patch (*)
 - gssafer.patch (*)		[*SECURITY*]
 - new-xvgrab.c (f)		[includes grabpatch but not exceed_grab.patch]
 - xcmap.diff (AD)		[part of xv-3.10a-png-1.2d.tar.gz]
 - fixes for huge number gcc -Wall warnings--including two bugs (GRR)
 - fix for cleandir script when no makefile exists (GRR)
 - *SECURITY* fix for gets() in vdcomp.c (GRR, LCN vdcomp-security.patch)
 - *SECURITY* fix for getwd() on Linux (GRR, LCN Linux-compile.patch)
 - fix for "no fuss" Linux compiles (LCN Linux-compile.patch)
 - partial *SECURITY* fix for mktemp() in xv.c and xvdir.c (GRR)
   (remaining instances in xv.c (2), xvimage.c, xvfits.c, xvpds.c, xvps.c, and
   possibly xvtiff.c--most involve system())
 - freebsd-vdcomp-newline.patch (AAC)
 - xv-3.10a.patch.linux (PBJ)	[/bin/sh versions of cleandir, RANLIB.sh only]
 - removed trailing white space (GRR)  [purely cosmetic]
20040523:
 - fixed compilation error in registered versions (GRR)
20050410:
 - fix for YCbCr oversaturated-green bug(s) in TIFF decoder (GRR)
 - provisional fix for contiguous tiled TIFFs with bottom-* orientation (GRR)
 - fixes for gcc 3.3 -Wall warnings (GRR)
 - fix for incorrect 16/24-bit display of xwd dumps (SJT)
 - *SECURITY* fix for multiple input-validation bugs (OpenBSD/SuSE, Gentoo, GRR)
   (this also completes the partial mktemp() security fix listed above)
 - fix for (probable) 24-bit endianness bug in fixpix code (GRR)


enhancements ((*) = listed on XV Downloads page, (<who>) = third-party):

20040516:
 - xv-3.10a.JPEG-patch (*)
   (xv-3.10a.JPEG-patch.old differs only in ftp site listed in comments at top)
 - xv-3.10a.TIFF-patch (*)
 - xv-3.10a-png-1.2d.tar.gz (AL, AD) (*)
   (xvjpeg.diff and xvtiff.diff ignored; xcmap.diff included in fixes)
 - xvpng-1.2d-fix3.patch (GRR, SJT) (*)
 - pdf.patch (*)
 - windowid.patch + windowid.patch.readme (*)
 - bmp32.patch (*)
 - fixpix-20000610.tar.gz (GV)
   (identical to 19961127 version except for README updates and new Win32 file)
   [modified to be runtime-selectable via -/+fixpix option]
 - browse-remember.patch (JZ)
 - faster-smooth.patch (JZ)
 - PAM support (GRR)
 - PNG/GIF -ibg ("image background") transparency option (GRR)
   (does not yet support TIFF, XPM or TGA)
 - VersionInfo* in help screen (GRR)
 - minor grammar/spelling fixes (GRR)
 - floating-point support for -wait when USE_TICKS enabled (GRR)
 - wheelmouse.patch (SB)
 - freebsd-gravity-hints-patch (JR)
 - xv-zx.patch (JCE)
 - xv3.10a.wapbmp.patch (PSV)
 - xv-3.10a-pcd.patch.20010708 (DAC)
 - jp-ext-bzip2-1.1.patch
   (from ftp://ftp.freebsd.org/pub/FreeBSD/ports/local-distfiles/shige/xv/)
20050410:
 - boosted maximum number of files from 4096 to 32768 (GRR)
   (note that OS kernel limits may also apply; for example, in Linux see
   MAX_ARG_PAGES in linux-<version>/include/linux/binfmts.h)
 - xv-3.10a-bmp16.patch (KS)
 - final-image delay (e.g., "-wait 0.2,3" : pause 3 secs on final image) (GRR)
 - xv-numpad.patch (EK)
 - xv-delete-is-not-backspace.patch (EK)
 - made browser window (schnauzer) and icons configurable (AT, GRR)
20050501:
 - xv-3.10a-bmpfix.patch (WF)		[*SECURITY*]
 - xv310a-jp-extension-rev5.3.3.tar.gz (TI, IM, ..., WF)
   (adds support for MAG, MAKI, Pi, PIC, and PIC2 formats[!]; "magic suffix"
   detection/conversion; MacBinary prefixes; archives as virtual filesystems;
   multilingual text viewer [though not Unicode]; etc.)
 - xv-3.10a-yaos.dif (WF, TO)		[*SECURITY*]
   (fixes a number of format-string issues and system() calls)
 - xv-3.10a.dif (WF)			[*SECURITY*]
   (fixes more format-string issues, mktemp() and open() calls, and compilation
   warnings [mostly from jp-extension patch])
 - xv-3.10a-jumbo-jpd_startgrab-patch-20050420.txt (JPD)
 - PATCH.alwaysnever (LJ)
 - PATCH.bsd (LJ)
 - PATCH.linedraw (LJ)
 - PATCH.multipage (LJ)
 - PATCH.multipageGIF (LJ)
 - PATCH.random (LJ)
 - PATCH.stat (LJ)
 - PATCH.thumbs (LJ)
 - xv-startgrab-imake-hips.patch (JPD)
   ("hips" portion only; adds support for HIPS image format[!])
 - xv-3.10a-formatstr.patch (KS)
 - xv-3.10a-shortsleep.patch (KS)
 - xv-3.10a-locale-linux.patch (KS)
 - xv-3.10a-printkey.patch (KS)
 - xv-3.10a-sysconfdir.patch (KS)
 - added PREFIX and DESTDIR support to Makefile (KS, GRR)
 - xv-3.10a-xvexecpath.patch (but disabled pending fixes) (KS)
 - xv-3.10a-zeroquit.patch (KS, GRR)

[!] Note that all six of these formats may still suffer from exploitable heap
    overflows [*SECURITY*] when decoding images with large (possibly invalid)
    dimensions; as a result, they are DISABLED by default.  (Search for "GRR
    POSSIBLE OVERFLOW / FIXME" comments in xvmag.c, xvmaki.c, xvpi.c, xvpic.c,
    xvpic2.c, and xvhips.c, but keep in mind that these may not be exhaustive.)
    Users who choose to overlook these security issues can enable any or all
    of them by editing config.h.


not (yet?) included:

 - others from http://www.coara.or.jp/~sudakyo/XV_jp.html (some are duplicates):
	-rw-r--r--      4644 Mar 11  2004 xv-3.10a-directory.patch
	-rw-r--r--       462 Mar 11  2004 xv-3.10a-dirwkey.patch
	-rw-r--r--       688 Mar 11  2004 xv-3.10a-docdir.patch
	-rw-r--r--     11952 Mar 11  2004 xv-3.10a-download-test0.patch
	-rw-r--r--     41786 Mar 11  2004 xv-3.10a-download-test1.patch
	-rw-r--r--     42397 Mar 11  2004 xv-3.10a-download-test2.patch
	-rw-r--r--     47679 Mar 11  2004 xv-3.10a-download-test3.patch
	-rw-r--r--     52745 Mar 11  2004 xv-3.10a-download-test4.patch
	-rw-r--r--      3423 Apr 24  2004 xv-3.10a-keyzoom.patch
	-rw-r--r--     12387 Mar 15  2004 xv-3.10a-menubutton.patch
	-rw-r--r--      1178 Apr 24  2004 xv-3.10a-noblink.patch
	-rw-r--r--     57092 Jul  9  2004 xv-3.10a-resolution.patch
	-rw-r--r--      4645 Apr 24  2004 xv-3.10a-selall.patch
	-rw-r--r--       702 Apr 24  2004 xv-3.10a-showlongname.patch
	-rw-r--r--      1205 Apr 24  2004 xv-3.10a-staytoppdir.patch
	-rw-r--r--      4228 Apr 24  2004 xv-3.10a-wheelmouse.patch
	-rw-r--r--       744 Apr 24  2004 xv-3.10a-xvbutt_wait.patch
	-rw-r--r--      3757 Jul  9  2004 xv-3.10a-xvscrl_button2.patch
	-rw-r--r--      1494 Jul  9  2004 xv-3.10a-xvscrl_wait.patch
	-rw-r--r--     19352 Jul  9  2004 xv-3.10a-xvzoom.patch

 - xv-3.10a+jp-extension-rev5.3.3+FLmask.v2.1+png+misc.patch	["mask" support]

 - xv-psnewstyle.patch (TA)			[coming "soon"?]
 - xv-3.10a.patch.linux (PBJ)			[maybe use vdcomp.c changes?]
 - xvxpm-anthony-thyssen.c (AT)			["slate grey" bug already gone?]
 - xv-geoff-kuenning-iconsize-slideshow.patch	[var. icons; full-screen slides]
 - xv-scott-marovich-20070214-xvtiff.c.patch6.unified	[TIFF CMYK support]

 - stuff in xv/unsupt:
	-rw-r--r--     30527 Dec 22  1994 FITS.rite
	-rw-r--r--     49152 Dec 22  1994 FITS.tar
	-rw-r--r--      3753 Dec 22  1994 G3.patch1
	-rw-r--r--     24576 Dec 22  1994 G3.tar
	-rw-r--r--      1098 Dec 22  1994 INFO.cgm
	-rw-r--r--      1941 Dec 22  1994 README
	-rwxr-xr-x      1059 Dec 22  1994 getweather
	-rwxr-xr-x      2186 Dec 22  1994 getweather.ksh
	-rw-r--r--       856 Dec 22  1994 twm.fix
	-rw-r--r--       844 Dec 22  1994 vargs.c
	-rw-r--r--     47626 Dec 22  1994 vis
	-rw-r--r--     21097 Dec 22  1994 xscm



not finished (and/or even started ;-) ):

 - fix xvpng.c not to use direct struct access
 - (better) fix for never-ending pile of SLOW popups when viewing TIFFs with
   unknown tags (or truncated/corrupted images)
 - fix for minor .Z inefficiency in xv.c ("FIXME")
 - fix for filename entry-field mouse/cursor deficiencies
   (positioning fixed 20070104 by Ross Combs; would like select/cut/paste, too)
 - fix for .ppm.gz "disk leak" [can't reproduce...already fixed?]
   (maybe occurs only if filesystem is already nearly full?  bad .gz?)

 - transparency support for TIFF, XPM and TGA images
 - support for tiled background image (with transparent foreground image)
 - MNG/JNG support
 - SVG support


ChangeLog
---------

  20000220
    original pair of jumbo patches, comprising perhaps 16 fix-patches and a
    dozen enhancement-patches; never publicly released

  20040516
    first public release, incorporating 25 fix-patches and 21 enhancement-
    patches

  20040523
    minor fix to xvctrl.c to support registered versions (GRR warnings-patch
    was slightly overzealous); switched to tarball packaging

  20040531
    fixed undefined CLK_TCK with gcc -ansi (enh/USE_TICKS option); made
    libjpeg, libtiff, libpng and zlib sections of makefile more consistent
    (enh)

  20040606
    added freshmeat link, build instructions, and changelog to jumbo README
    (this file)

  20050213
    increased max number of files from 4096 to 32768 (enh)

  20050320-20050410
    fixed two very long-standing YCbCr bugs in TIFF decoder (fix);
    provisionally fixed bug in TIFF decoder for contiguous tiled TIFFs with
    bottom-* orientation (fix/USE_TILED_TIFF_BOTLEFT_FIX option); fixed new
    gcc 3.3 warnings (fix); fixed incorrect 16/24-bit display of xwd dumps
    (fix); fixed multiple input-validation bugs (potential heap overflows)
    and mktemp() dependencies (*SECURITY* fixes:  CAN-2004-1725, CAN-2004-
    1726, CAN-2005-0665, CERT VU#622622, and others); added support for 16-
    and 32-bit BMPs using bitfields "compression" (enh); fixed probable byte-
    sex bug in 24-bit FixPix display code (enh/USE_24BIT_ENDIAN_FIX option);
    fixed numerical-keypad NumLock behavior and delete-key behavior in file-
    load/save window (enh); made schnauzer window and icons configurable (enh)

  20050417
    incorporated "Japanese extension" patches, revision 5.3.3 (enh); fixed
    additional *SECURITY* issues (format-string vulnerabilities, system()
    and mktemp() calls, etc., but NOT heap overflows in new decoders) both
    in existing code and in jp-extension additions (enh)

  20050425
    added support for -startgrab option (enh); added support for a "Never"
    button to file-overwrite popups (enh); added NetBSD and BSDI to list of
    mkstemp()-supporting systems (enh); improved line-drawing code to set the
    correct pixels for lines of all slopes (enh); added "Page n of m" to Info
    window for multipage images (enh); added support for multipage (animated)
    GIFs (enh); fixed -random support so randomized file list can be traversed
    normally in forward or backward direction (enh); added typecasts to stat()
    printfs for portability (enh); fixed erroneous use of "creation" time and
    forced unlink prior to overwrite in schnauzer thumbnail code (enh); added
    HIPS support (enh/HAVE_HIPS option)

  20050501
    extended multipage keyboard support (PgUp/PgDn) to all windows except
    control ("console") and directory (enh); fixed minor (non-security)
    format-string issue in xv.c (enh); shortened delay on popup error windows
    from 3 seconds to 1 second (enh); tweaked text-viewer localization support
    (TV_L10N) for Linux (enh); added keyboard short cuts for Color and
    Grayscale buttons in print dialog (enh); added support for separate "magic
    suffix" (xv_mgcsfx) config dir (enh); added PREFIX and DESTDIR support to
    Makefile (enh); fixed handling of zero-length files and other text-viewer
    failures (enh)

  20050528
    conditionally added missing alloca.h to xvpcd.c (required if alloca() is
    a macro and alloca.h not included in stdlib.h, for example); fixed bogus
    __S_IWRITE introduced in 20050501 release; fixed Makefile "install" target
    (mkdir, chmod); fixed bug in MUST macro in xvwbmp.c; fixed prototype
    warnings in xvevent.c, xvpcd.c (JRK, GRR)
	- xv-3.10a-jimkirk-fixes.patch

  20050630
    fixed broken mkdir(.xvpics) introduced in 20050501 release (RJH, GRR);
    tweaked GUNZIP config for OpenBSD (GRR)
	- xv-3.10a-xvpics-mkdir-fix.patch

  20051014
    fixed longstanding xvevent.c typo (wasJpegUp -> wasPngUp) that caused build
    failure if no JPEG support (TAR)

  20051019
    fixed Darwin (Mac OS X) build error in xv.h and vdcomp.c due to lack of
    malloc.h (JDB)

  20070210
    fixed minor grammos (GRR); promoted PNG to first position, demoted GIF to
    third (GRR); changed internal type of default image to PNG (GRR); increased
    max files again, to 65536 (GRR)

  20070310
    incorporated JPEG-2000 patch (SBM, GRR); added manual fax options for
    unrecognized G3 images (SBM); relaxed 30-byte minimum file size (SBM)
	- http://www.ece.uvic.ca/~mdadams/jasper/software/xv-patches

  20070318
    incorporated 16bps raw (binary) PPM patch (define ASSUME_RAW_PPM_LSB_FIRST
    for old behavior) (RAC, GRR); updated format list, web sites in xv man page
    (GRR); fixed Makefile "install" target to create any necessary directories
    (RAC, GRR); fixed GIF decoder bug (sizes of global, local color tables
    different) (GRR)
	- xv-ross-combs-ppm-16bps-rawbits.patch

  20070325
    fixed invalid gamma assumption in PNG decoder (=> progressive color changes
    over load/save cycles) (GRR)

  20070328
    fixed animated-GIF /tmp/xvpgXXXXXX droppings (GRR)

  20070331
    fixed PNG duplicate-palette-entries bug (GRR)

  20070415
    incorporated EXIF-preserve patch (GHK); added missing JP2/JPC VS bits code
    (GRR); added extended-warning options to CCOPTS (RAC); added "const" to
    huge number of function args (RAC, GRR); made more effectively static
    functions officially static (RAC); added mouse-clickability (but not
    selectability) to text-entry fields (RAC); fixed window positioning (race
    conditions?) under some virtual window managers (e.g., tvtwm) (RAC);
    removed explicit paths for external (de)compressors (GRR, RAC)
	- xv-geoff-kuenning-jpeg-exif-preserve.patch
	- xv-ross-combs-20070104.diff

  20070422
    incorporated function-key-scripts patch (see contrib/fnkey-scripts) (AS);
    fixed man-page-section extensions ("1", not "l" or "1X") (FG); switched to
    more sensible install paths for docs (FG); added Fedora Core build script
    (see contrib/fedora) (JC); fixed VS to switch from move-mode to copy-mode
    if source dir is read-only (EAJ); extended VS incremental-search mode (EAJ)
	- xv-alexey-spiridonov-20070116-fnkey-scripts.tar.bz2
	- xv-fabian-greffrath-20070215-debian-04-manpages.dpatch
	- xv-fabian-greffrath-20070215-debian-03-makefiles.dpatch
	- xv-john-cooper-Build-FC5-script.sh
	- xv-erling-jacobsen-20060617-incr-search.patch

  20070428
    modified install to include README.jumbo in docs (GRR); incorporated PNG
    no-stdio patch (SBM); fixed XWD endianness support, improved performance
    (replaces SJT 16/24-bit fix) (SBM)
	- xv-scott-marovich-20070214-xvpng.diff
	- xv-scott-marovich-20070214-xvxwd.c.patch

  20070506
    added JPEG CMYK support (SBM); fixed TIFF (and others?) /tmp/xvpgXXXXXX
    droppings (GRR); added VS clipboard support (JG)
	- xv-scott-marovich-20070214-xvjpeg.c.patch
	- xv-jurgen-grahn-20051127-schnauzer-clip.patch

  20070512
    inverted handling of malloc.h header file to require NEED_MALLOC_H macro
    for those few systems that actually need it (GRR)

  20070513
    fixed GCC 4.1.x warnings (GRR); next round of const cleanup (GRR); fixed
    minor TIFF memleak (GRR)

  20070514
    fixed TIFF YCbCr reference black/white levels (SBM); added option to use
    libjpeg YCbCr-to-RGB conversion for TIFF images (SBM, GRR)
	- xv-scott-marovich-20070214-xvtiff.c.patch2.unified
	- xv-scott-marovich-20070214-xvtiff.c.patch3.unified

  20070519
    fixed handling of multi-page JPEG-compressed TIFFs (old or new) (SBM);
    added TIFF YCbCr separated-color-plane support (may require libtiff
    patch(es) to tif_ojpeg.c and/or tif_jpeg.c) (SBM)
	- xv-scott-marovich-20070214-xvtiff.c.patch4.unified
	- xv-scott-marovich-20070214-xvtiff.c.patch5.unified

  20070520
    updated README.jumbo

Copyright 1993-2001 David Clunie.

PCD patch for XV 3.10a Release Notes 2001/07/08.

See also the progress notes at the end of this file. Thanks to all those
contributors who have substantially improved this patch.

These patches allow xv to read Kodak photocd files and choose which of the
5 available resolutions one wants to view.

When a photocd file is loaded, a dialog box asks which resolution you
would like. The visual schnauzer builds thumbnails by reading the lowest
resolution image. The selected resolution can be selected from the
command line with the -pcd option:

	[-pcd 0|1|2|3|4]

where:

	0=192*128,	base/16 resolution
	1=384*256,	base/4 resolution
	2=768*512,	base resolution
	3=1536*1024,	4base resolution
	4=3072*2048	16base resolution.

Note that the Pro format is not supported.

The command line option allows loops without the dialog box popping up, eg.:

	xv -pcd 1 -wloop -wait 10 *.pcd

The code is pretty crude and was written quickly for a specific purpose and
has not really been cleaned up. It is poorly structured, full of debugging
codes and verbose comments, and there is very little attempt at optimizing
things. No profiling has been done.

There is not yet support for overview files, nor is there a facility to
use the higher resolution chroma planes from when viewing lower resolution
images.

It's only claim to fame is that it works and produces reasonable looking
images.

The outline of this is shamelessly derived from xvpbm.c to read the
file, and xvtiffwr.c to handle the popup window and X stuff (X never
has been my forte !), and the PhotoCD format information (though not
the code) was found in Hadmut Danisch's (danisch@ira.uka.de) hpcdtoppm
program in which he has reverse engineered the format by studying
hex dumps of PhotoCDs ! The color stuff and Huffman decding were
extensively revised by Matthew Francey.

Feel free to send me comments or improvements, or even better, more
information about the photo CD format ... hopefully someone who really
knows what they are doing will tidy it up or do a neater job.

david (dclunie@dclunie.com)

---------

The trace #define in xvpcd.c is now in the right place, and the ansi
prototype for the magnify function has been fixed. Colin made me switch to
xvbcopy() which seems like a good idea for System V victims.

---------

Date: Wed, 22 Dec 1993 16:09:52 --1000
From: colinc@fitmail.fit.qut.edu.au (Colin Canfield )

I have done some more work using your patch I thought you might be intested in.
The major change was adding a size parameter to the LoadPCD; either -1 to mean
the popup or else the size you desired. This allows batch mode processing,
specifically xv -pcd <size> <filename>, and the visual schnauzer can work in
quick mode (ie. you don't have to select each image size when it is building
the icons)

I have added an xbm file for the file type but haven't drawn an icon for it,
this is in bitmaps/br_pcd.xbm. I will just send you the new files.

---------

From: andrew@andrew.triumf.ca (Andrew Daviel)
Date: 16 Feb 1995 23:32:21 GMT

This is David Clunie's patch for xv-3.00 tuned a bit to work
on xv-3.10. The code's all the same except for replacing
"trace" with "fprintf" in xvpcd.c and adding an "unsigned" qualifier to
keep my compiler (gcc) happy. Oh yes, changed RFT_PCD to 20 as
John Bradley has now used 15 through 19.

---------

From: dclunie@flash.us.com (David A. Clunie)
Date: Thu Jun 15 14:43:46 GMT+0300 1995

Andrew's patch didn't include Colin's browser changes, so I redid the
xv-3.10 update from scratch ... it seems pretty much the same as
Andrew's changes. I also edited the Imakefile and Makefiles in order
to support the PCD changes, as well as make the install process a
little more flexible, with options to strip and set modes and so on.
Also made RFT_PCD 25 so as not to conflict with magpic patch from Japan
by Ikemoto Masahiro <ikeyan@airlab.cs.ritsumei.ac.jp>, and used his
bitmap icon for pcd files.

Now there are two versions of the patch, one which should be applied
to the xv-3.10 distribution.

The other should be applied to xv-3.10 AFTER Ikemoto Masahiro's
Patch.magpic2.PhotoCD.XV319a, in order to add the browser features to
the latter, as well as fixing a Makefile typo (was xcpcd.c not xvpcd.c)
and including unistd.h for the SEEK_xxx constants in the magicpic
stuff.

---------

Subject: Re: photo-cd patch for xv
From: Matthew Francey <mdf@angoss.com>
Date: Mon, 26 Mar 2001 15:37:55 +0000

Attached is a revised version of xvpcd.c;  the areas that I have
re-written or changed are in a different coding style so you can tell
what has changed.  The GNU 'indent' program can be run against the file
to enforce a consistent style ..

Here is what I've done though:

a) huffman table reader re-written, because it would fail on some
   photocd files with "unusual" huffman codes.

b) the huffman-coded corrections are now properly applied

c) the corrections can sometimes over or underflow;  clipping has been
   introduced and effectively fixes the problem, but I suspect that
   there is something deeper going on.

d) the "official" YCC->sRGB transform is done.  a "beyond 100% white"
   mapping table was snarfed from ImageMagick.  an option for using a
   flat linear LUT was added -- this can make somewhat over-exposed images
   look alot nicer.

e) there were strange problems where the code wouldn't be able to find
   the huffman tables and data for the 16base image (the bit-buffering
   code was starting mid-sector, instead of at a sector boundary).  Looking
   at a pcd file with a hex editor suggests to me that it is possible to
   just skip directly to these huffman tables -- no special "+12" and such
   constants necessary.  But I haven't tried this yet.

The results:  I've been able to read about 50 or 60 .pcd files [scattered
in age from 6 years old to scans done last week] with this code without
incident.  Image quality at the high resolution is excellent.  Even the
trivial amount of LUT control is useful when dealing with over-exposed
images.

If I get around to it:  finer LUT control to take advantage of the
slightly extended dynamic range of PhotoCD scans, especially in regards to
dark or somewhat underexposed scenes.