Update some website pages, and fix broken links.
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/imaging/trunk@1364723 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/site/site.xml b/src/site/site.xml
index 29c844d..efaec78 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -38,7 +38,6 @@
<item name="Sample Usage" href="/sampleusage.html"/>
<item name="Format Support" href="/formatsupport.html"/>
<item name="Status & History" href="/history.html"/>
- <item name="Justification" href="/justification.html"/>
<item name="References" href="/references.html"/>
<item name="Sample Images" href="/sampleimages.html"/>
<item name="To Do" href="/todo.html"/>
diff --git a/src/site/xdoc/index.xml b/src/site/xdoc/index.xml
index 6bc93b8..71059c8 100644
--- a/src/site/xdoc/index.xml
+++ b/src/site/xdoc/index.xml
@@ -40,7 +40,7 @@
more formats (and supports them more correctly). It also provides easy access to metadata.
</p>
<p>
- Although not yet version 1.0, sanselan is working and is used by a number of projects in production.
+ Imaging was working and was used by a number of projects in production even before version 1.0.
</p>
<p>
This project is Open Source; free as in freedom and free as in beer.
diff --git a/src/site/xdoc/justification.xml b/src/site/xdoc/justification.xml
deleted file mode 100644
index a095ca4..0000000
--- a/src/site/xdoc/justification.xml
+++ /dev/null
@@ -1,97 +0,0 @@
-<?xml version="1.0"?>
-<!--
-Licensed to the Apache Software Foundation (ASF) under one or more
-contributor license agreements. See the NOTICE file distributed with
-this work for additional information regarding copyright ownership.
-The ASF licenses this file to You under the Apache License, Version 2.0
-(the "License"); you may not use this file except in compliance with
-the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
--->
-<document>
- <properties>
- <title>Building</title>
- <author email="dev@commons.apache.org">Commons Documentation Team</author>
- </properties>
-<body>
-<!-- ================================================== -->
-<section name="Justification">
-
-<p>
- Why another image library? There are so many already.
-</p>
-
-<p>
- Apache Commons Imaging is Pure Java. Consequently it's slow, but perfectly portable.
-</p>
-
-<p>
- It is designed to be very easy to use. See the Sample Usage section.
-</p>
-
-<p>
- This library supports some variations and encodings missed by all or most other libaries.
-</p>
-
-<p>
- Most other libraries offer little or incomplete support for ICC Profiles.
- Commons Imaging can extract and (simply) parse embedded ICC Profiles.
- Moreover, it applies the ICC profile by default, coverting read images to sRGB.
- This means images are color-corrected by default.
- see: <a href="http://en.wikipedia.org/wiki/International_Color_Consortium">http://en.wikipedia.org/wiki/International_Color_Consortium</a>,
- <a href="http://en.wikipedia.org/wiki/SRGB">http://en.wikipedia.org/wiki/SRGB</a>
-</p>
-
-<p>
- Commons Imaging also lets you read in image info (ie. width, height or colorspace) and metadata without
- "reading" the entire image. It presents image info and metadata in a format-neutral manner.
- It also gives easy, structured access to format-specific info.
-</p>
-
-<p>
- This library was written with an eye to correctness and code clarity rather than efficiency.
- Hopefully it is easy to use, easy to extend and can be used to explore images + image formats,
- rather than just read images for display.
-</p>
-
-<p>
- This library is Free Software/Open Source. It is available under the
- <a href="../license.html">Apache Software License</a>.
-</p>
-
-<p>
- Ultimately, other libraries didn't quite fill my requirements, though there are many good ones out there.
- What could be interesting is to get a free, portable, feature complete library that ISN'T pure Java
- - ie. one that uses JNI, at least for JPEG, anyhow. The obvious solution would be a JNI wrapper
- around libtiff, libjpeg, libpng, libgif/libungif, etc. imageloader uses this approach, but
- is unfinished.
- see: <a href="http://www.libtiff.org/">http://www.libtiff.org/</a>,
- <a href="http://en.wikipedia.org/wiki/Libjpeg">http://en.wikipedia.org/wiki/Libjpeg</a>,
- <a href="http://www.libpng.org/">http://www.libpng.org/</a>,
- <a href="http://sourceforge.net/projects/libungif/">http://sourceforge.net/projects/libungif/</a>
-</p>
-
-<p>
- Commons Imaging also includes a number of useful functions such as guess an image's format by examining its "magic numbers" (header info).
-</p>
-
-<p>
- Commons Imaging aims to be transparent. There are no hidden buffers to dispose, no blocking calls, no native memory to free.
-</p>
-
-<p>
- The ColorConversions class offers methods to convert between the following color spaces: CIE-L*CH�, CIE-L*ab, CIE-L*uv,
- CMY, CMYK, HSL, HSV, Hunter-Lab, RGB, XYZ and Yxy (algorithms courtesy of EasyRGB's).
- see: <a href="http://www.easyrgb.com/">http://www.easyrgb.com/</a>
-</p>
-
-</section>
-</body>
-</document>
diff --git a/src/site/xdoc/whyimaging.xml b/src/site/xdoc/whyimaging.xml
new file mode 100644
index 0000000..f6ee35c
--- /dev/null
+++ b/src/site/xdoc/whyimaging.xml
@@ -0,0 +1,97 @@
+<?xml version="1.0"?>
+<!--
+Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<document>
+ <properties>
+ <title>Building</title>
+ <author email="dev@commons.apache.org">Commons Documentation Team</author>
+ </properties>
+<body>
+<!-- ================================================== -->
+<section name="Why use Commons Imaging?">
+
+<p>
+ Why another image library? There are so many already.
+</p>
+
+<p>
+ Apache Commons Imaging is written in 100% pure Java. It will run on any JVM, and any platform, without modification.
+</p>
+
+<p>
+ There are no dependencies. Commons Imaging only requires Java 1.5 or later.
+</p>
+
+<p>
+ It is designed to be very easy to use. It has a simple, clean interface. Most operations are a single Imaging method call. See the <a href="sampleusage.html">Sample Usage</a> section.
+</p>
+
+<p>
+ Commons Imaging aims to be transparent. There are no hidden buffers to dispose, no native memory to free, no background threads.
+</p>
+
+<p>
+ It reads and writes a wide variety of image formats, and supports some variations and encodings missed by all or most other libaries. See the <a href="formatsupport.html">Format Support</a> list.
+</p>
+
+<p>
+ Commons Imaging does more than read and write images. Reading image info (image size, colorspace, bit depth, etc.) and metadata is easy, and does not require reading the image pixels.
+ It presents image info and metadata in a format-neutral manner.
+ It also gives easy, structured access to format-specific info.
+</p>
+
+<p>
+ It supports reading and writing a variety of metadata in a structured way, including EXIF metadata.
+</p>
+
+<p>
+ Most other libraries offer little or incomplete support for ICC Profiles.
+ Commons Imaging can extract and (simply) parse embedded ICC Profiles.
+ Moreover, it applies the ICC profile by default, coverting read images to sRGB.
+ This means images are color-corrected by default.
+ see: <a href="http://en.wikipedia.org/wiki/International_Color_Consortium">http://en.wikipedia.org/wiki/International_Color_Consortium</a>,
+ <a href="http://en.wikipedia.org/wiki/sRGB">http://en.wikipedia.org/wiki/sRGB</a>
+</p>
+
+<p>
+ Was written with an eye to correctness and code clarity, but also good performance.
+ Hopefully it is easy to use, easy to extend and can be used to explore images + image formats,
+ rather than just read images for display.
+</p>
+
+<p>
+ It is Free Software/Open Source. It is available under the
+ <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License</a>.
+</p>
+
+<p>
+ Commons Imaging also includes a number of useful functions such as guess an image's format by examining its "magic numbers" (header info).
+</p>
+
+<p>
+ It is network-friendly. Commons Imaging will only read the data it needs, and caches what is read so that it isn't too heavy on the network.
+</p>
+
+<p>
+ The ColorConversions class offers methods to convert between the following color spaces: CIE-L*CH°, CIE-L*ab, CIE-L*uv,
+ CMY, CMYK, HSL, HSV, Hunter-Lab, RGB, XYZ and Yxy (algorithms courtesy of EasyRGB's).
+ see: <a href="http://www.easyrgb.com/">http://www.easyrgb.com/</a>
+</p>
+
+</section>
+</body>
+</document>