xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r840806 [5/19] - in /websites/staging/xmlgraphics/trunk/content: ./ batik/ batik/dev/ batik/tools/ batik/using/ batik/using/scripting/ commons/ fop/ fop/0.95/ fop/1.0/ fop/1.1/ fop/dev/ fop/dev/design/ fop/trunk/
Date Wed, 05 Dec 2012 08:23:58 GMT
Modified: websites/staging/xmlgraphics/trunk/content/batik/using/svg-generator.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/batik/using/svg-generator.html (original)
+++ websites/staging/xmlgraphics/trunk/content/batik/using/svg-generator.html Wed Dec  5 08:23:47 2012
@@ -169,9 +169,9 @@ $(document).ready(function () {
       	<div class="section-content"><h1 id="svg-generator-svggraphics2d">SVG Generator: SVGGraphics2D</h1>
 <div class="figure"> ![Flow diagram illustrating that Java programs can have their graphics converted to SVG and then viewed in any SVG viewer](images/svggen.jpg "") </div>
 
-<p>As SVG is emerging as a promising graphics format for a wide range of domains and applications, bridging it with Java becomes important. This page explains how Batik’s <a href="../javadoc/org/apache/batik/svggen/SVGGraphics2D.html">SVGGraphics2D</a> , referred to as the SVG Generator, makes this possible.</p>
+<p>As SVG is emerging as a promising graphics format for a wide range of domains and applications, bridging it with Java becomes important. This page explains how Batik’s <a href="../javadoc/org/apache/batik/svggen/SVGGraphics2D.html">SVGGraphics2D</a>, referred to as the SVG Generator, makes this possible.</p>
 <h2 id="the-svggraphics2d-class-wzxhzdk14wzxhzdk15">The SVGGraphics2D class <a id="whatIsIt"></a></h2>
-<p>On the Java platform, all rendering goes through the <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/awt/Graphics2D.html">Graphics2D</a> abstract class, which offers methods such as <code>drawRect</code> , <code>fillRect</code> , and <code>drawString</code> . There are specialized implementations of this abstract class for each type of output, such as a screen or a printer. <code>SVGGraphics2D</code> is a new implementation of that interface that generates SVG content instead of drawing to a screen or a printer.</p>
+<p>On the Java platform, all rendering goes through the <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/awt/Graphics2D.html">Graphics2D</a> abstract class, which offers methods such as <code>drawRect</code>, <code>fillRect</code>, and <code>drawString</code>. There are specialized implementations of this abstract class for each type of output, such as a screen or a printer. <code>SVGGraphics2D</code> is a new implementation of that interface that generates SVG content instead of drawing to a screen or a printer.</p>
 <p><code>SVGGraphics2D</code> has the following features:</p>
 <ul>
 <li>
@@ -186,8 +186,8 @@ $(document).ready(function () {
 </ul>
 <div class="figure"> ![Diagram illustrating how the SVGGraphics2D inherits from Graphics2D, and uses Document to generate a DOM tree](images/svggenHighLevelArchi.jpg "") </div>
 
-<p>The above figure shows how the generator works with the DOM API. The W3C has defined an API for representing XML content with a Java object. That API allows programmers to manipulate, create, and/or modify XML content in memory. The DOM API contains interfaces such as <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html">Document</a> , <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Element.html">Element</a> , and <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Attr.html">Attr</a> , which model the Java programming language equivalent of XML documents, elements and attributes.</p>
-<p>The generator manages a tree of DOM objects that represent the SVG content corresponding to the rendering calls made on the <code>SVGGraphics2D</code> instance. In other words, every time a program invokes a rendering method, such as <code>fillRect</code> , on a <code>SVGGraphics2D</code> instance, a new DOM object, representing the SVG equivalent, is appended to the DOM tree. For example, a <code>rect</code> element will be appended after the <code>fillRect</code> method has been invoked).</p>
+<p>The above figure shows how the generator works with the DOM API. The W3C has defined an API for representing XML content with a Java object. That API allows programmers to manipulate, create, and/or modify XML content in memory. The DOM API contains interfaces such as <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html">Document</a>, <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Element.html">Element</a>, and <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Attr.html">Attr</a>, which model the Java programming language equivalent of XML documents, elements and attributes.</p>
+<p>The generator manages a tree of DOM objects that represent the SVG content corresponding to the rendering calls made on the <code>SVGGraphics2D</code> instance. In other words, every time a program invokes a rendering method, such as <code>fillRect</code>, on a <code>SVGGraphics2D</code> instance, a new DOM object, representing the SVG equivalent, is appended to the DOM tree. For example, a <code>rect</code> element will be appended after the <code>fillRect</code> method has been invoked).</p>
 <p>The programmer, using this generator, can then access the DOM tree to further manipulate it or can directly write the content to an output stream, as we see in the following section.</p>
 <h2 id="how-to-use-svggraphics2d-wzxhzdk16wzxhzdk17">How to use SVGGraphics2D <a id="howToUse"></a></h2>
 <p>From the figure in the previous section we can see that in order for an instance of <code>SVGGraphics2D</code> to build the SVG content (the DOM tree), an instance of a <code>Document</code> class is needed. The DOM tree is an in-memory representation of the SVG document, which can be further manipulated by the user using DOM API or be streamed out by a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/Writer.html">Writer</a> object.</p>
@@ -262,7 +262,7 @@ test.paint(svgGenerator);</p>
 </li>
 </ol>
 <p>1.
-Stream out the SVG content. The SVG generator can stream its content into any <code>java.io.Writer</code> . In our example, we stream the content to the standard output stream:</p>
+Stream out the SVG content. The SVG generator can stream its content into any <code>java.io.Writer</code>. In our example, we stream the content to the standard output stream:</p>
 <div class="codehilite"><pre><span class="c1">// Finally, stream out SVG to the standard output using</span>
 <span class="c1">// UTF-8 encoding.</span>
 <span class="kt">boolean</span> <span class="n">useCSS</span> <span class="o">=</span> <span class="kc">true</span><span class="o">;</span> <span class="c1">// we want to use CSS style attributes</span>
@@ -271,7 +271,7 @@ Stream out the SVG content. The SVG gene
 </pre></div>
 
 
-<p>SVG has <a href="http://www.w3.org/TR/SVG11/styling.html#AlternativesForStyling">two ways to specify styling properties</a> , such as the fill color: presentation attributes (one XML attribute per property) or the CSS <code>style</code> attribute (any number of properties in one CSS inline stylesheet). The <code>useCss</code> parameter allows the user to control that option.</p>
+<p>SVG has <a href="http://www.w3.org/TR/SVG11/styling.html#AlternativesForStyling">two ways to specify styling properties</a>, such as the fill color: presentation attributes (one XML attribute per property) or the CSS <code>style</code> attribute (any number of properties in one CSS inline stylesheet). The <code>useCss</code> parameter allows the user to control that option.</p>
 <h2 id="svg-generator-customization-wzxhzdk18wzxhzdk19">SVG Generator customization <a id="custom"></a></h2>
 <p>In the previous section, we have just seen that the SVG generation process can be customized to output SVG styling properties as presentation attributes or CSS inline stylesheets. In this section we will talk about some examples of more advanced customizations.</p>
 <p>Instead of creating the <code>SVGGraphics2D</code> just by using the <code>Document</code> that will be used as a factory for creating the SVG elements, we can use the constructor that uses an <a href="../javadoc/org/apache/batik/svggen/SVGGeneratorContext.html">SVGGeneratorContext</a> instance. By providing your own <code>SVGGeneratorContext</code> instance, you will be able to do advanced customization. You will find below several examples of possible customizations.</p>
@@ -303,7 +303,7 @@ Stream out the SVG content. The SVG gene
 
 <h2 id="customizing-the-way-images-are-stored-wzxhzdk24wzxhzdk25">Customizing the way images are stored <a id="Customizing+the+way+images+are+stored"></a></h2>
 <p>Every time you call one of the <code>drawImage</code> methods provided by the <code>Graphics2D</code> interface, a default representation of your image is created in a location and put in a default file. For instance, a base64 encoding is created and embedded in the SVG file by default. Alternatively, you can choose to have your images written to separate files in a predefined directory, in one of the two raster formats required by the SVG specification: JPEG or PNG.</p>
-<p>You can change the default behavior by explicitly providing the image handler to be used by the SVG generator. Once again, you use the <code>SVGGeneratorContext</code> for this. In the example below, all images are converted to PNG format and written to directory <code>res/images</code> .</p>
+<p>You can change the default behavior by explicitly providing the image handler to be used by the SVG generator. Once again, you use the <code>SVGGeneratorContext</code> for this. In the example below, all images are converted to PNG format and written to directory <code>res/images</code>.</p>
 <div class="codehilite"><pre><span class="n">DOMImplementation</span> <span class="n">impl</span> <span class="o">=</span>
     <span class="n">GenericDOMImplementation</span><span class="o">.</span><span class="na">getDOMImplementation</span><span class="o">();</span>
 <span class="n">String</span> <span class="n">svgNS</span> <span class="o">=</span> <span class="s">&quot;http://www.w3.org/2000/svg&quot;</span><span class="o">;</span>
@@ -395,7 +395,7 @@ Stream out the SVG content. The SVG gene
 </pre></div>
 
 
-<p>Then you can create and use an <code>SVGGraphics2D</code> with a correctly configured <code>SVGGeneratorContext</code> .</p>
+<p>Then you can create and use an <code>SVGGraphics2D</code> with a correctly configured <code>SVGGeneratorContext</code>.</p>
 <div class="codehilite"><pre><span class="c1">// Configure the SVGGraphics2D for a given Document myFactory.</span>
 <span class="n">SVGGeneratorContext</span> <span class="n">ctx</span> <span class="o">=</span> <span class="n">SVGGeneratorContext</span><span class="o">.</span><span class="na">createDefault</span><span class="o">(</span><span class="n">myFactory</span><span class="o">);</span>
 <span class="n">CDATASection</span> <span class="n">styleSheet</span> <span class="o">=</span> <span class="n">myFactory</span><span class="o">.</span><span class="na">createCDATASection</span><span class="o">(</span><span class="s">&quot;&quot;</span><span class="o">);</span>
@@ -419,8 +419,8 @@ Stream out the SVG content. The SVG gene
 
 
 <h2 id="extending-paint-object-to-svg-element-translation-wzxhzdk28wzxhzdk29">Extending Paint object to SVG element translation <a id="Extending+Paint+object+to+SVG+element+translation"></a></h2>
-<p>The <code>SVGGraphics2D</code> is able to generate SVG elements for generic Java 2D objects, but you sometimes have your own classes such as implementations of the Java 2D <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Paint.html">Paint</a> interface. In this case, you will need to write an <a href="../javadoc/org/apache/batik/svggen/ExtensionHandler.html">ExtensionHandler</a> that you will set on your <code>SVGGeneratorContext</code> .</p>
-<p>In the following example we define the first draft of an <code>ExtensionHandler</code> allowing to translate a Batik implementation of the <code>Paint</code> interface named <a href="../javadoc/org/apache/batik/ext/awt/LinearGradientPaint.html">LinearGradientPaint</a> .</p>
+<p>The <code>SVGGraphics2D</code> is able to generate SVG elements for generic Java 2D objects, but you sometimes have your own classes such as implementations of the Java 2D <a href="http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Paint.html">Paint</a> interface. In this case, you will need to write an <a href="../javadoc/org/apache/batik/svggen/ExtensionHandler.html">ExtensionHandler</a> that you will set on your <code>SVGGeneratorContext</code>.</p>
+<p>In the following example we define the first draft of an <code>ExtensionHandler</code> allowing to translate a Batik implementation of the <code>Paint</code> interface named <a href="../javadoc/org/apache/batik/ext/awt/LinearGradientPaint.html">LinearGradientPaint</a>.</p>
 <div class="codehilite"><pre><span class="kd">class</span> <span class="nc">MyExtensionHandler</span> <span class="kd">extends</span> <span class="n">DefaultExtensionHandler</span> <span class="o">{</span>
 
   <span class="kd">public</span> <span class="n">SVGPaintDescriptor</span> <span class="nf">handlePaint</span><span class="o">(</span><span class="n">Paint</span> <span class="n">paint</span><span class="o">,</span>

Modified: websites/staging/xmlgraphics/trunk/content/batik/using/swing.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/batik/using/swing.html (original)
+++ websites/staging/xmlgraphics/trunk/content/batik/using/swing.html Wed Dec  5 08:23:47 2012
@@ -169,7 +169,7 @@ $(document).ready(function () {
       	<div class="section-content"><h1 id="batik-swing-components">Batik Swing components</h1>
 <p>The goal of the Batik Swing component module is to provide a Swing component that can used to display SVG documents. With the <a href="../javadoc/org/apache/batik/swing/JSVGCanvas.html">JSVGCanvas</a> class, you can easily display an SVG document (from a URI or a DOM tree) and allow the user to manipulate it, such as rotating, zooming, panning, selecting text or activating hyperlinks. First this document explains how to create a <code>JSVGCanvas</code> and integrate it in to a Swing application. Then, it descibes some advanced features such as the listener mechanism used to track all events that occurred while displaying or manipulating an SVG document.</p>
 <h2 id="creating-a-jsvgcanvas-wzxhzdk2wzxhzdk3">Creating a JSVGCanvas <a id="creatingJSVGCanvas"></a></h2>
-<p>The following example illustrates how to create a <code>JSVGCanvas</code> , which is a Swing component that follows the Swing design rule. This means that the component is not thread safe and all operations on the component or the document it is displaying must be performed as described in <a href="http://java.sun.com/docs/books/tutorial/uiswing/overview/threads.html">the Swing tutorial</a> . The <code>JSVGCanvas</code> is also a <a href="http://java.sun.com/products/javabeans/">JavaBean</a> , so it can be used in visual application builders.
+<p>The following example illustrates how to create a <code>JSVGCanvas</code>, which is a Swing component that follows the Swing design rule. This means that the component is not thread safe and all operations on the component or the document it is displaying must be performed as described in <a href="http://java.sun.com/docs/books/tutorial/uiswing/overview/threads.html">the Swing tutorial</a>. The <code>JSVGCanvas</code> is also a <a href="http://java.sun.com/products/javabeans/">JavaBean</a>, so it can be used in visual application builders.
 If you try this example, do not forget to set your <code>CLASSPATH</code> so that it contains the Batik classes and resources, as well as Xerces ( <code>lib/xerces_2_5_0.jar</code> ) and the XML APIs jars ( <code>lib/xml-apis.jar</code> and <code>lib/xml-apis-ext.jar</code> ).</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">java.awt.*</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">java.awt.event.*</span><span class="o">;</span>
@@ -305,11 +305,11 @@ The <a href="../javadoc/org/apache/batik
 :
 The <a href="../javadoc/org/apache/batik/bridge/UpdateManagerListener">UpdateManagerListener</a> provides a set of methods that can be used to track <a href="../javadoc/org/apache/batik/bridge/UpdateManagerEvent">UpdateManagerEvent</a> events. It describes the running phase: the update manager is started and then it can be suspended, resumed or stopped, and graphics updates can be tracked.</p>
 <p>This event is triggered only in dynamic documents.</p>
-<p>These listeners give a complete description of the different steps of the five phases (including error states). Adapter classes are available to ease the creation of new listener implementation— <a href="../javadoc/org/apache/batik/swing/svg/SVGDocumentLoaderAdapter.html">SVGDocumentLoaderAdapter</a> , <a href="../javadoc/org/apache/batik/swing/svg/GVTTreeBuilderListenerAdapter.html">GVTTreeBuilderListenerAdapter</a> , <a href="../javadoc/org/apache/batik/swing/svg/SVGLoadEventDispatcherAdapter.html">SVGLoadEventDispatcherAdapter</a> , <a href="../javadoc/org/apache/batik/swing/gvt/GVTTreeRendererAdapter.html">GVTTreeRendererAdapter</a> and <a href="../javadoc/org/apache/batik/bridge/UpdateManagerAdapter.html">UpdateManagerAdapter</a> ,</p>
+<p>These listeners give a complete description of the different steps of the five phases (including error states). Adapter classes are available to ease the creation of new listener implementation— <a href="../javadoc/org/apache/batik/swing/svg/SVGDocumentLoaderAdapter.html">SVGDocumentLoaderAdapter</a>, <a href="../javadoc/org/apache/batik/swing/svg/GVTTreeBuilderListenerAdapter.html">GVTTreeBuilderListenerAdapter</a>, <a href="../javadoc/org/apache/batik/swing/svg/SVGLoadEventDispatcherAdapter.html">SVGLoadEventDispatcherAdapter</a>, <a href="../javadoc/org/apache/batik/swing/gvt/GVTTreeRendererAdapter.html">GVTTreeRendererAdapter</a> and <a href="../javadoc/org/apache/batik/bridge/UpdateManagerAdapter.html">UpdateManagerAdapter</a>,</p>
 <p>For static documents, you can assume that the JSVGCanvas has completed its job (parsing, building and rendering) when the <code>gvtRenderingCompleted</code> method call is called, following a <code>setURI</code> or a <code>setSVGDocument</code> method call.</p>
 <p>In the case of dynamic documents, the end of the computation (parsing, building, SVGLoad dispatch, initial rendering and updates) is marked by a call to the <code>updateManagerStopped</code> method.</p>
 <h2 id="adding-an-interactor-wzxhzdk6wzxhzdk7">Adding an Interactor <a id="interactor"></a></h2>
-<p>The <code>JSVGCanvas</code> provides a set of build-in interactors that let the users manipulate the displayed document, including ones for zooming, panning and rotating. Interactors catch user input to the <code>JSVGCanvas</code> component and translate them into behaviour. If you want to add new behaviors to the <code>JSVGCanvas</code> , you can implement the <a href="../javadoc/org/apache/batik/swing/gvt/Interactor.html">Interactor</a> interface. Then, you can register this new interactor to the component by adding an element to the <code>List</code> returned by the <code>getInteractors()</code> method of the canvas.</p></div>
+<p>The <code>JSVGCanvas</code> provides a set of build-in interactors that let the users manipulate the displayed document, including ones for zooming, panning and rotating. Interactors catch user input to the <code>JSVGCanvas</code> component and translate them into behaviour. If you want to add new behaviors to the <code>JSVGCanvas</code>, you can implement the <a href="../javadoc/org/apache/batik/swing/gvt/Interactor.html">Interactor</a> interface. Then, you can register this new interactor to the component by adding an element to the <code>List</code> returned by the <code>getInteractors()</code> method of the canvas.</p></div>
       </div>
       
       <div class="clear"></div>

Modified: websites/staging/xmlgraphics/trunk/content/batik/using/transcoder.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/batik/using/transcoder.html (original)
+++ websites/staging/xmlgraphics/trunk/content/batik/using/transcoder.html Wed Dec  5 08:23:47 2012
@@ -167,18 +167,18 @@ $(document).ready(function () {
         </div>
       	<!-- <div id="breadcrumb"><a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/batik/">Batik</a>&nbsp;&raquo&nbsp;<a href="/batik/using/">Using</a></div> -->
       	<div class="section-content"><h1 id="transcoder-api">Transcoder API</h1>
-<p>The goal of the transcoder API (package <code>org.apache.batik.transcoder</code> ) is to provide a generic API for transcoding an input to an output. First, this document explains the basic transcoder API that <a href="../javadoc/org/apache/batik/transcoder/Transcoder.html">Transcoder</a> , <a href="../javadoc/org/apache/batik/transcoder/TranscoderInput.html">TranscoderInput</a> and <a href="../javadoc/org/apache/batik/transcoder/TranscoderOutput.html">TranscoderOutput</a> define, and thus all transcoders have in common. Next, it describes how to use the image transcoder API (package <code>org.apache.batik.transcoder.image</code> ), which lets you rasterize an SVG document fragment to a raster image such as JPEG, PNG or TIFF.</p>
+<p>The goal of the transcoder API (package <code>org.apache.batik.transcoder</code> ) is to provide a generic API for transcoding an input to an output. First, this document explains the basic transcoder API that <a href="../javadoc/org/apache/batik/transcoder/Transcoder.html">Transcoder</a>, <a href="../javadoc/org/apache/batik/transcoder/TranscoderInput.html">TranscoderInput</a> and <a href="../javadoc/org/apache/batik/transcoder/TranscoderOutput.html">TranscoderOutput</a> define, and thus all transcoders have in common. Next, it describes how to use the image transcoder API (package <code>org.apache.batik.transcoder.image</code> ), which lets you rasterize an SVG document fragment to a raster image such as JPEG, PNG or TIFF.</p>
 <h2 id="the-transcoder-api-wzxhzdk3wzxhzdk4">The transcoder API <a id="transcoderAPI"></a></h2>
 <p>The <code>org.apache.batik.transcoder</code> package defines 5 major classes:</p>
 <p>Transcoder
 :
-The <a href="../javadoc/org/apache/batik/transcoder/Transcoder.html">Transcoder</a> interface defines the interface that all transcoders implement. You can transcode a specific input using a specific output by invoking the <code>transcode</code> method. Although there is no assumption on the input and output format, a specific transcoder may or may not support a particular type of input or output. For example, the image transcoders accept an SVG <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html">Document</a> , a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html">Reader</a> , an <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/InputStream.html">InputStream</a> , or a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html">URI</a> as an input but only supports a byte stream for the output.</p>
+The <a href="../javadoc/org/apache/batik/transcoder/Transcoder.html">Transcoder</a> interface defines the interface that all transcoders implement. You can transcode a specific input using a specific output by invoking the <code>transcode</code> method. Although there is no assumption on the input and output format, a specific transcoder may or may not support a particular type of input or output. For example, the image transcoders accept an SVG <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html">Document</a>, a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html">Reader</a>, an <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/InputStream.html">InputStream</a>, or a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html">URI</a> as an input but only supports a byte stream for the output.</p>
 <p>TranscoderInput
 :
-The <a href="../javadoc/org/apache/batik/transcoder/TranscoderInput.html">TranscoderInput</a> interface defines the input of a transcoder. There are various ways to create an input and the most common are already part of the API. The default implementation lets you create an input using a <code>org.w3c.dom.Document</code> , a <code>Reader</code> , an <code>InputStream</code> , a <code>org.xml.sax.XMLReader</code> , or a <code>URI</code> .</p>
+The <a href="../javadoc/org/apache/batik/transcoder/TranscoderInput.html">TranscoderInput</a> interface defines the input of a transcoder. There are various ways to create an input and the most common are already part of the API. The default implementation lets you create an input using a <code>org.w3c.dom.Document</code>, a <code>Reader</code>, an <code>InputStream</code>, a <code>org.xml.sax.XMLReader</code>, or a <code>URI</code>.</p>
 <p>TranscoderOutput
 :
-The <a href="../javadoc/org/apache/batik/transcoder/TranscoderOutput.html">TranscoderOutput</a> interface defines the output of a transcoder. There are various ways to create an output and the most commons are already part of the API. The default implementation lets you create an output using a <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html">Document</a> , a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/Writer.html">Writer</a> , an <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html">OutputStream</a> , a <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/xml/sax/XMLFilter.html">XMLFilter</a> , or a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html">URI</a> .</p>
+The <a href="../javadoc/org/apache/batik/transcoder/TranscoderOutput.html">TranscoderOutput</a> interface defines the output of a transcoder. There are various ways to create an output and the most commons are already part of the API. The default implementation lets you create an output using a <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html">Document</a>, a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/Writer.html">Writer</a>, an <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html">OutputStream</a>, a <a href="http://java.sun.com/j2se/1.5.0/docs/api/org/xml/sax/XMLFilter.html">XMLFilter</a>, or a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html">URI</a>.</p>
 <p>TranscodingHints
 :
 The <a href="../javadoc/org/apache/batik/transcoder/TranscodingHints.html">TranscodingHints</a> class contains different hints that can be used to control the various options or parameters of a transcoder. Each transcoder provides its own set of hints. A hint is specified by (key, value) pair. For example, the <a href="../javadoc/org/apache/batik/transcoder/image/JPEGTranscoder.html">JPEGTranscoder</a> provides a hint to control the encoding quality.</p>
@@ -188,7 +188,7 @@ The <a href="../javadoc/org/apache/batik
 <h2 id="how-to-use-the-image-transcoder-api-wzxhzdk5wzxhzdk6">How to use the image transcoder API <a id="howtousetranscoderAPI"></a></h2>
 <p>The <code>org.apache.batik.transcoder.image</code> package provides an easy way to transcode an SVG document to a raster image such as JPEG, PNG or TIFF. Additional raster image formats can be added by subclassing the <code>ImageTranscoder</code> class and implementing the <code>writeImage</code> method. Although, in next sections, the examples will use the JPEG transcoder, the PNG transcoder works the same way.</p>
 <h3 id="creating-an-image-wzxhzdk7wzxhzdk8">Creating an image <a id="createImage"></a></h3>
-<p>The following example, using the <code>JPEGTranscoder</code> , shows how to transform an SVG document to a JPEG image.</p>
+<p>The following example, using the <code>JPEGTranscoder</code>, shows how to transform an SVG document to a JPEG image.</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">java.io.*</span><span class="o">;</span>
 
 <span class="kn">import</span> <span class="nn">org.apache.batik.transcoder.image.JPEGTranscoder</span><span class="o">;</span>
@@ -226,22 +226,22 @@ The <a href="../javadoc/org/apache/batik
 </pre></div>
 
 
-<p>The code creates a <code>JPEGTranscoder</code> and sets a transcoding hint. The hint indicates the encoding quality. Then, an input and an output are created. The input is created using the first command line argument, which should be a URI. The output is a byte stream for a file called <code>out.jpg</code> . Finally, the <code>transcode</code> method is invoked and the byte stream is closed.</p>
+<p>The code creates a <code>JPEGTranscoder</code> and sets a transcoding hint. The hint indicates the encoding quality. Then, an input and an output are created. The input is created using the first command line argument, which should be a URI. The output is a byte stream for a file called <code>out.jpg</code>. Finally, the <code>transcode</code> method is invoked and the byte stream is closed.</p>
 <p>Although not shown above, the program might have specified additional hints to indicate a user stylesheet, the preferred language of the document or the background color.</p>
 <p>To try this program:</p>
 <p>1.
-Save the above program as <code>SaveAsJPEG.java</code> .</p>
+Save the above program as <code>SaveAsJPEG.java</code>.</p>
 <p>1.
 Compile the program.</p>
 <p>1.
 Choose an SVG file to transcode, and perform the transcoding by running:
 java SaveAsJPEG filename.svg</p>
 <p>1.
-Inspect the output file <code>out.jpg</code> .</p>
+Inspect the output file <code>out.jpg</code>.</p>
 <h3 id="defining-the-size-of-the-image-wzxhzdk9wzxhzdk10">Defining the size of the image <a id="defineSizeOfImage"></a></h3>
 <p>By adding the following line of code to the previous example, you will specify the raster image size (in pixels). The transcoding hint <code>KEY_WIDTH</code> lets you specify the raster image width. If the raster image height is not provided (using the <code>KEY_HEIGHT</code> ), the transcoder will compute the raster image height by keeping the aspect ratio of the SVG document.
 t.addTranscodingHint(JPEGTranscoder.KEY_WIDTH, new Float(100));
-The transcoder will have the same behavior if you specify the <code>KEY_HEIGHT</code> without initializing the <code>KEY_WIDTH</code> . In all cases (even if both keys are provided), the transcoder will preserve the apsect ratio of the SVG document.</p>
+The transcoder will have the same behavior if you specify the <code>KEY_HEIGHT</code> without initializing the <code>KEY_WIDTH</code>. In all cases (even if both keys are provided), the transcoder will preserve the apsect ratio of the SVG document.</p>
 <h3 id="selecting-an-area-of-interest-wzxhzdk11wzxhzdk12">Selecting an area of interest <a id="selectAreaOfIntrest"></a></h3>
 <p>The image transcoder lets you specify an area of interest (that is, a part of the SVG document). The key <code>KEY_AOI</code> allows you to select the region of the SVG document to render. The value of this key must be a <a href="http://java.sun.com/j2se/1.5.0/docs/api/java/awt/Rectangle.html">java.awt.Rectangle</a> specified in pixels, using the coordinate space of the SVG document. The following example shows how you can split an SVG document into 4 tiles.</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">java.io.*</span><span class="o">;</span>
@@ -300,10 +300,10 @@ The transcoder will have the same behavi
 </pre></div>
 
 
-<p>This code splits the same document <code>anne.svg</code> into four tiles of the same size. Considering the document and its original size, we can determine four regions. Then we rasterize each region using the <code>KEY_AOI</code> key. Note that we also specify the image width and height to be the same as the area of interest width and height (so we keep a 1:1 zoom factor). You can of course use different values for the <code>KEY_WIDTH</code> and <code>KEY_HEIGHT</code> , that do not match the dimensions of the <code>KEY_AOI</code> key. In that case, first the area of interest will determine which part of the SVG document has to be rendered, then that part could be zoomed in or out depending on the specified raster image size.</p>
+<p>This code splits the same document <code>anne.svg</code> into four tiles of the same size. Considering the document and its original size, we can determine four regions. Then we rasterize each region using the <code>KEY_AOI</code> key. Note that we also specify the image width and height to be the same as the area of interest width and height (so we keep a 1:1 zoom factor). You can of course use different values for the <code>KEY_WIDTH</code> and <code>KEY_HEIGHT</code>, that do not match the dimensions of the <code>KEY_AOI</code> key. In that case, first the area of interest will determine which part of the SVG document has to be rendered, then that part could be zoomed in or out depending on the specified raster image size.</p>
 <p>To try this program:</p>
 <p>1.
-Save the above program as <code>SaveAsJPEGTiles.java</code> .</p>
+Save the above program as <code>SaveAsJPEGTiles.java</code>.</p>
 <p>1.
 Compile the program.</p>
 <p>1.
@@ -312,12 +312,12 @@ Copy the <code>samples/anne.svg</code> d
 Run the program by typing:
 java SaveAsJPEGTiles</p>
 <p>1.
-Inspect the output files <code>tileTopRight.jpg</code> , <code>tileTopRight.jpg</code> , <code>tileBottomRight.jpg</code> and <code>tileBottomLeft.jpg</code> .</p>
+Inspect the output files <code>tileTopRight.jpg</code>, <code>tileTopRight.jpg</code>, <code>tileBottomRight.jpg</code> and <code>tileBottomLeft.jpg</code>.</p>
 <h3 id="other-transcoding-hints-wzxhzdk13wzxhzdk14">Other transcoding hints <a id="otherTransHints"></a></h3>
 <p>The <code>ImageTranscoder</code> provides additional <code>TranscodingHints</code> that let you customize the generated images.</p>
 <p><code>ImageTranscoder.KEY_MEDIA</code>
 :
-This hint lets you choose the CSS medium to use. The author of the SVG document to transcode can control CSS media using the <a href="http://www.w3.org/TR/REC-CSS2/media.html">CSS media rule</a> . For example:
+This hint lets you choose the CSS medium to use. The author of the SVG document to transcode can control CSS media using the <a href="http://www.w3.org/TR/REC-CSS2/media.html">CSS media rule</a>. For example:
 trans.addTranscodingHint(ImageTranscoder.KEY_MEDIA, "print");</p>
 <p><code>ImageTranscoder.KEY_ALTERNATE_STYLESHEET</code>
 :
@@ -423,17 +423,17 @@ See the <code>createDocument</code> meth
 <p>Rasterizing the DOM
 :
 See the <code>save</code> method.</p>
-<p>Similar to the previous examples, you can transcode an SVG document to a raster image by creating a <code>TranscoderInput</code> , but passing to it the SVG Document this time.</p>
+<p>Similar to the previous examples, you can transcode an SVG document to a raster image by creating a <code>TranscoderInput</code>, but passing to it the SVG Document this time.</p>
 <p>To try this example:</p>
 <p>1.
-Save the code as <code>DOMRasterizer.java</code> .</p>
+Save the code as <code>DOMRasterizer.java</code>.</p>
 <p>1.
 Compile the program.</p>
 <p>1.
 Run it, by typingL
 java DOMRasterizer</p>
 <p>1.
-Inspect the output file <code>out.jpg</code> .</p></div>
+Inspect the output file <code>out.jpg</code>.</p></div>
       </div>
       
       <div class="clear"></div>

Modified: websites/staging/xmlgraphics/trunk/content/commons/bugs.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/bugs.html (original)
+++ websites/staging/xmlgraphics/trunk/content/commons/bugs.html Wed Dec  5 08:23:47 2012
@@ -138,7 +138,7 @@ $(document).ready(function () {
       	<div class="section-content"><h1 id="apachewzxhzdk0-xml-graphics-commons-bugs-and-other-trackable-issues">Apache&trade; XML Graphics Commons: Bugs and Other Trackable Issues</h1>
 <p>Information on this page applies to enhancement requests and other trackable issues as well as bugs.</p>
 <h2 id="reported-issues-wzxhzdk1wzxhzdk2">Reported Issues <a id="issues_existing"></a></h2>
-<p>A list of unresolved reported bugs can be found at <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=XMLGraphicsCommons&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">XML Graphics Commons Open Bugs (Bugzilla)</a> . If you have an interest in an issue already reported, please consider the following:</p>
+<p>A list of unresolved reported bugs can be found at <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=XMLGraphicsCommons&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=">XML Graphics Commons Open Bugs (Bugzilla)</a>. If you have an interest in an issue already reported, please consider the following:</p>
 <ul>
 <li>
 <p>If you have insight that may help developers solve an existing problem, please add comments and/or file attachments to the existing issue.</p>
@@ -154,10 +154,10 @@ $(document).ready(function () {
 <p>Review the <a href="http://issues.apache.org/bugzilla/page.cgi?id=bug-writing.html">Apache Bug Writing Guidelines</a> before submitting your report.</p>
 </li>
 <li>
-<p>Enter a new issue report at the <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=XMLGraphicsCommons">XML Graphics Commons issue database (Bugzilla)</a> . You will be asked to login to an existing Bugzilla account or to create a new one. When entering the bug report, please make your description complete and concise. If appropriate, attach a minimal fo file to your report which demonstrates the problem.</p>
+<p>Enter a new issue report at the <a href="http://issues.apache.org/bugzilla/enter_bug.cgi?product=XMLGraphicsCommons">XML Graphics Commons issue database (Bugzilla)</a>. You will be asked to login to an existing Bugzilla account or to create a new one. When entering the bug report, please make your description complete and concise. If appropriate, attach a minimal fo file to your report which demonstrates the problem.</p>
 </li>
 <li>
-<p>After submission, a copy of your bug report will be automatically sent to the <a href="http://xmlgraphics.apache.org/mail.html#xmlgraphics-general">XML Graphics General discussion list</a> .</p>
+<p>After submission, a copy of your bug report will be automatically sent to the <a href="http://xmlgraphics.apache.org/mail.html#xmlgraphics-general">XML Graphics General discussion list</a>.</p>
 </li>
 </ul></div>
       </div>

Modified: websites/staging/xmlgraphics/trunk/content/commons/changes.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/changes.html (original)
+++ websites/staging/xmlgraphics/trunk/content/commons/changes.html Wed Dec  5 08:23:47 2012
@@ -136,29 +136,29 @@ $(document).ready(function () {
         </div>
       	<!-- <div id="breadcrumb"><a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/commons/">Commons</a></div> -->
       	<div class="section-content"><h1 id="history-of-changes">History of Changes</h1>
-<p><a href="changes.rss">changes.rss</a> </p>
+<p><a href="changes.rss">changes.rss</a></p>
 <h2 id="introduction-and-explanation-of-symbols-wzxhzdk0wzxhzdk1">Introduction and explanation of symbols <a id="introduction"></a></h2>
-<p>Changes are sorted by "type" and then chronologically with the most recent at the top. These symbols denote the various action types: <img alt="add" src="/images/add.jpg" />=add , <img alt="fix" src="/images/fix.jpg" />=fix, <img alt="remove" src="/images/remove.jpg" />=remove, <img alt="update" src="/images/update.jpg" />=update</p>
+<p>Changes are sorted by "type" and then chronologically with the most recent at the top. These symbols denote the various action types: <img alt="add" src="/images/add.jpg" />=add, <img alt="fix" src="/images/fix.jpg" />=fix, <img alt="remove" src="/images/remove.jpg" />=remove, <img alt="update" src="/images/update.jpg" />=update</p>
 <h2 id="version-trunk-na-wzxhzdk2wzxhzdk3">Version Trunk (n/a) <a id="version_Trunk"></a></h2>
 <h3 id="changes-to-the-code-base-wzxhzdk4wzxhzdk5">Changes to the Code Base <a id="Code_Trunk"></a></h3>
 <ul>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Support rdf:resource attributes in XMP. Committed by GA. Thanks to Brian Carlson. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=50497">50497</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Support rdf:resource attributes in XMP. Committed by GA. Thanks to Brian Carlson. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=50497">50497</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Should never use Error to report runtime errors. Committed by GA. Thanks to Sebastian Bazley. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=47174">47174</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Should never use Error to report runtime errors. Committed by GA. Thanks to Sebastian Bazley. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=47174">47174</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Ensure that throwables have meaningful messages. Committed by GA. Thanks to Sebastian Bazley. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=47175">47175</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Ensure that throwables have meaningful messages. Committed by GA. Thanks to Sebastian Bazley. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=47175">47175</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Support for T.4 Group 3 1D encoding. Committed by PH. Thanks to JM and Mehdi Houshmand. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=51911">51911</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Support for T.4 Group 3 1D encoding. Committed by PH. Thanks to JM and Mehdi Houshmand. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=51911">51911</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Fixed a bug formatting ISO 8601 dates with negative two-digit time zones. Committed by JM. Thanks to Florian Barbera Vila Bollain. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=51039">51039</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Fixed a bug formatting ISO 8601 dates with negative two-digit time zones. Committed by JM. Thanks to Florian Barbera Vila Bollain. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=51039">51039</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Allow to override priority when registering an ImageWriter on the ImageWriterRegistry. Committed by JM. Thanks to Joshua Marquart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49696">49696</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Allow to override priority when registering an ImageWriter on the ImageWriterRegistry. Committed by JM. Thanks to Joshua Marquart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49696">49696</a>.</p>
 </li>
 <li>
 <p><img alt="fix" src="/images/fix.jpg" />Fix for TIFFs which report zero as their resolution. This resulted in an exception. Committed by JM.</p>
@@ -173,7 +173,7 @@ $(document).ready(function () {
 <p><img alt="update" src="/images/update.jpg" />Minor build improvements to eliminate warning and parameterize junit formatting. Eliminate (5) deprecation warnings. Committed by GA.</p>
 </li>
 <li>
-<p><img alt="update" src="/images/update.jpg" />Various code style fixes Committed by JM. Thanks to Glenn Adams. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49703">49703</a> .</p>
+<p><img alt="update" src="/images/update.jpg" />Various code style fixes Committed by JM. Thanks to Glenn Adams. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49703">49703</a>.</p>
 </li>
 </ul>
 <h3 id="contributors-to-this-release-wzxhzdk6wzxhzdk7">Contributors to this release <a id="contributors_Trunk"></a></h3>
@@ -184,28 +184,28 @@ $(document).ready(function () {
 <h3 id="changes-to-the-code-base-wzxhzdk14wzxhzdk15">Changes to the Code Base <a id="Code_1.4"></a></h3>
 <ul>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added getter and setter for enabling/disabling comments in PSGenerator. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49250">49250</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added getter and setter for enabling/disabling comments in PSGenerator. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49250">49250</a>.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Small optimization which only generates code for a clipping area if an element is not fully inside the clipping area. Committed by JM. Thanks to Calixte Denizet. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49056">49056</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Small optimization which only generates code for a clipping area if an element is not fully inside the clipping area. Committed by JM. Thanks to Calixte Denizet. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49056">49056</a>.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added option to enable/disable the generation of compact vs. verbose PostScript code. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48797">48797</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added option to enable/disable the generation of compact vs. verbose PostScript code. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48797">48797</a>.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added shorthands for many PostScript commands to get more compact PostScript files. Committed by JM. Thanks to Calixte Denizet. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48797">48797</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added shorthands for many PostScript commands to get more compact PostScript files. Committed by JM. Thanks to Calixte Denizet. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48797">48797</a>.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added code for supporting the AdobeStandardCyrillic encoding. Committed by JM. Thanks to Andrey Koltunov. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48395">48395</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added code for supporting the AdobeStandardCyrillic encoding. Committed by JM. Thanks to Andrey Koltunov. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48395">48395</a>.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added interface for Color Conversions. Committed by CB. Thanks to Peter Hancock. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48237">48237</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added interface for Color Conversions. Committed by CB. Thanks to Peter Hancock. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48237">48237</a>.</p>
 </li>
 <li>
 <p><img alt="add" src="/images/add.jpg" />Added support for configurable additional penalties for preloader, loader and converter plug-ins in the ImageImplRegistry (in addition to the hard-coded penalties). Committed by JM.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Enabled native encoding of CMYK images for PostScript output. Committed by JM. Thanks to Venkat Reddy. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48264">48264</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Enabled native encoding of CMYK images for PostScript output. Committed by JM. Thanks to Venkat Reddy. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=48264">48264</a>.</p>
 </li>
 <li>
 <p><img alt="add" src="/images/add.jpg" />Support loading of ICC Profiles from PNG and JPEG when used through ImageIO. Committed by MB.</p>
@@ -214,7 +214,7 @@ $(document).ready(function () {
 <p><img alt="add" src="/images/add.jpg" />Added 60 seconds expiration for invalid URIs in the image cache to recover from temporarily unavailable images. Committed by JM.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added TexturePaint support for PSGraphics2D (PostScript tiling patterns). Committed by JM. Thanks to Jiří Kunhart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=46583">46583</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added TexturePaint support for PSGraphics2D (PostScript tiling patterns). Committed by JM. Thanks to Jiří Kunhart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=46583">46583</a>.</p>
 </li>
 <li>
 <p><img alt="add" src="/images/add.jpg" />XMP framework: Added support for the structure property shorthand form and for specifying simple property values as attributes on rdf:Description elements. Committed by JM.</p>
@@ -223,7 +223,7 @@ $(document).ready(function () {
 <p><img alt="add" src="/images/add.jpg" />Added RefinedImageFlavor to the image loading framework for better refinement of image flavors. Committed by JM.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Two properties didn't get copied in copy constructor of PSState. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49364">49364</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Two properties didn't get copied in copy constructor of PSState. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49364">49364</a>.</p>
 </li>
 <li>
 <p><img alt="fix" src="/images/fix.jpg" />Bugfix for detecting multi-strip CCITT-encoded TIFFs. Committed by JM.</p>
@@ -250,25 +250,25 @@ $(document).ready(function () {
 <p><img alt="fix" src="/images/fix.jpg" />Catching IllegalArgumentException in XMPSerializer when the Transformer implementation in use doesn't support the INDENT key. Committed by JM.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Added the ability to assign a string value for a key in a postscript dictionary. Committed by AC. Thanks to Jiří Kunhart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=46292">46292</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Added the ability to assign a string value for a key in a postscript dictionary. Committed by AC. Thanks to Jiří Kunhart. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=46292">46292</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Made loading images via Image I/O more robust: A PNG with a zero resolution should fall back to the default resolution. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=45789">45789</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Made loading images via Image I/O more robust: A PNG with a zero resolution should fall back to the default resolution. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=45789">45789</a>.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />JPEGPreloader: Fixed interpretation of JPEG resolution when "dots per centimeter" is specified. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=45835">45835</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />JPEGPreloader: Fixed interpretation of JPEG resolution when "dots per centimeter" is specified. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=45835">45835</a>.</p>
 </li>
 <li>
 <p><img alt="fix" src="/images/fix.jpg" />Bugfix: Added missing start/endPrefixMapping() calls when serializing XMP packets. Committed by JM.</p>
 </li>
 <li>
-<p><img alt="update" src="/images/update.jpg" />Optimization for PostScript state handling in (E)PSDocumentGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49339">49339</a> .</p>
+<p><img alt="update" src="/images/update.jpg" />Optimization for PostScript state handling in (E)PSDocumentGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49339">49339</a>.</p>
 </li>
 <li>
-<p><img alt="update" src="/images/update.jpg" />PS output: Using shorthand procedures for rectangles instead of the generic shape processor. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49338">49338</a> .</p>
+<p><img alt="update" src="/images/update.jpg" />PS output: Using shorthand procedures for rectangles instead of the generic shape processor. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49338">49338</a>.</p>
 </li>
 <li>
-<p><img alt="update" src="/images/update.jpg" />Moved method disableClipping from AbstractPSDocumentGraphics2D to PSGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49337">49337</a> .</p>
+<p><img alt="update" src="/images/update.jpg" />Moved method disableClipping from AbstractPSDocumentGraphics2D to PSGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=49337">49337</a>.</p>
 </li>
 </ul>
 <h3 id="contributors-to-this-release-wzxhzdk16wzxhzdk17">Contributors to this release <a id="contributors_1.4"></a></h3>
@@ -288,7 +288,7 @@ $(document).ready(function () {
 <p><img alt="add" src="/images/add.jpg" />Added image processing hints to ignore an optionally embedded color profile in JPEG images. Committed by JM.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Made file URLs with a host (as happens when using UNC paths) work when loading images. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=44902">44902</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Made file URLs with a host (as happens when using UNC paths) work when loading images. Committed by JM. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=44902">44902</a>.</p>
 </li>
 <li>
 <p><img alt="fix" src="/images/fix.jpg" />Bugfix for classpath resources: the code doesn't just check the system class loader anymore. Committed by MB.</p>
@@ -322,7 +322,7 @@ $(document).ready(function () {
 <h3 id="changes-to-the-code-base-wzxhzdk32wzxhzdk33">Changes to the Code Base <a id="Code_1.3"></a></h3>
 <ul>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Image Loading: Support for passing in SAXSource instance. Committed by JM. Thanks to Adam Strzelecki. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=44466">44466</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Image Loading: Support for passing in SAXSource instance. Committed by JM. Thanks to Adam Strzelecki. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=44466">44466</a>.</p>
 </li>
 <li>
 <p><img alt="add" src="/images/add.jpg" />The package org.apache.xmlgraphics.image.loader was added. It contains a general image loading framework for various image formats (bitmap &amp; vector). Committed by JM.</p>
@@ -334,10 +334,10 @@ $(document).ready(function () {
 <p><img alt="add" src="/images/add.jpg" />PostScript: Added classes for "BoundingBox" DSC comments. Committed by JM.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added support for classpath resources (find files in JAR files in the classpath using their MIME type) Committed by JM. Thanks to Max Berger. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=42980">42980</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added support for classpath resources (find files in JAR files in the classpath using their MIME type) Committed by JM. Thanks to Max Berger. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=42980">42980</a>.</p>
 </li>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Application of the patch in Bugzilla 43069: New Macro safe-set-page-device which guards against the possibility of invalid/unsupported postscript key/values being issued to the implementing postscript page device Committed by CB. Thanks to Adrian Cumiskey. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=43069">43069</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Application of the patch in Bugzilla 43069: New Macro safe-set-page-device which guards against the possibility of invalid/unsupported postscript key/values being issued to the implementing postscript page device Committed by CB. Thanks to Adrian Cumiskey. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=43069">43069</a>.</p>
 </li>
 <li>
 <p><img alt="fix" src="/images/fix.jpg" />Bugfix for ISO 8601 date formatting with negative time zones in the XMP package. Committed by JM.</p>
@@ -352,7 +352,7 @@ $(document).ready(function () {
 <p><img alt="fix" src="/images/fix.jpg" />PostScript: Improved robustness of DSC parsing (multi-line comments with no value on the first line don't cause crashes anymore, fallback for unparsable DSC comments). Committed by JM.</p>
 </li>
 <li>
-<p><img alt="fix" src="/images/fix.jpg" />Fixed a possible NPE in the TIFF codec (in the TIFFImage constructor). Committed by JM. Thanks to Sergey Orlov. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=43120">43120</a> .</p>
+<p><img alt="fix" src="/images/fix.jpg" />Fixed a possible NPE in the TIFF codec (in the TIFFImage constructor). Committed by JM. Thanks to Sergey Orlov. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=43120">43120</a>.</p>
 </li>
 <li>
 <p><img alt="update" src="/images/update.jpg" />Support for Java 1.3 has been dropped. Java 1.4 or later is required now. Committed by JM.</p>
@@ -369,7 +369,7 @@ $(document).ready(function () {
 <h3 id="changes-to-the-code-base-wzxhzdk42wzxhzdk43">Changes to the Code Base <a id="Code_1.2"></a></h3>
 <ul>
 <li>
-<p><img alt="add" src="/images/add.jpg" />Added support for CMYK and GRAY color spaces for PSGenerator (moved there from PSGraphics2D). Committed by JM. Thanks to Adrian Cumiskey. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=42507">42507</a> .</p>
+<p><img alt="add" src="/images/add.jpg" />Added support for CMYK and GRAY color spaces for PSGenerator (moved there from PSGraphics2D). Committed by JM. Thanks to Adrian Cumiskey. See Issue <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=42507">42507</a>.</p>
 </li>
 <li>
 <p><img alt="fix" src="/images/fix.jpg" />Fixed literal text string escaping in PSGenerator. Some characters were not properly escaped. Committed by JM.</p>

Modified: websites/staging/xmlgraphics/trunk/content/commons/download.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/download.html (original)
+++ websites/staging/xmlgraphics/trunk/content/commons/download.html Wed Dec  5 08:23:47 2012
@@ -137,7 +137,7 @@ $(document).ready(function () {
       	<!-- <div id="breadcrumb"><a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/commons/">Commons</a></div> -->
       	<div class="section-content"><h1 id="download-apachewzxhzdk1-xml-graphics-commons">Download Apache&trade; XML Graphics Commons</h1>
 <h2 id="download-a-release-wzxhzdk2wzxhzdk3">Download a Release <a id="release"></a></h2>
-<p>Source ("-src") and binary ("-bin") distributions can be downloaded from a <a href="http://www.apache.org/dyn/closer.cgi/xmlgraphics/commons">Apache&trade; XML Graphics Commons Distribution Mirror</a> .</p>
+<p>Source ("-src") and binary ("-bin") distributions can be downloaded from a <a href="http://www.apache.org/dyn/closer.cgi/xmlgraphics/commons">Apache&trade; XML Graphics Commons Distribution Mirror</a>.</p>
 <h2 id="download-from-subversion-wzxhzdk5wzxhzdk6">Download from Subversion <a id="svn"></a></h2>
 <p>The latest source code is available directly from the Subversion repository:</p>
 <table>

Modified: websites/staging/xmlgraphics/trunk/content/commons/image-loader.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/image-loader.html (original)
+++ websites/staging/xmlgraphics/trunk/content/commons/image-loader.html Wed Dec  5 08:23:47 2012
@@ -137,7 +137,7 @@ $(document).ready(function () {
       	<!-- <div id="breadcrumb"><a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/commons/">Commons</a></div> -->
       	<div class="section-content"><h1 id="apachewzxhzdk4-xml-graphics-commons-image-loader-framework">Apache&trade; XML Graphics Commons: Image Loader Framework</h1>
 <h2 id="overview-wzxhzdk5wzxhzdk6">Overview <a id="overview"></a></h2>
-<p>Apache&trade; XML Graphics Commons contains a unified framework for loading and processing images (bitmap and vector). The package name is <code>org.apache.xmlgraphics.image.loader</code> . Key features:</p>
+<p>Apache&trade; XML Graphics Commons contains a unified framework for loading and processing images (bitmap and vector). The package name is <code>org.apache.xmlgraphics.image.loader</code>. Key features:</p>
 <ul>
 <li>
 <p>Unified basic API for all supported image types.</p>
@@ -180,8 +180,8 @@ $(document).ready(function () {
 </ul>
 <h2 id="tutorial-wzxhzdk8wzxhzdk9">Tutorial <a id="tutorial"></a></h2>
 <h3 id="setting-up-the-manager-wzxhzdk10wzxhzdk11">Setting up the manager <a id="manager-setup"></a></h3>
-<p>Before we can start to work with the package we need to set up the <code>ImageManager</code> . It provides convenience methods to load and convert images and holds the image cache.</p>
-<p>The <code>ImageManager</code> needs an <code>ImageContext</code> . This interface provides the <code>ImageManager</code> with important context and configuration data. Currently this is only the source resolution. The <code>ImageManager</code> and <code>ImageContext</code> are intended to be shared within an application.</p>
+<p>Before we can start to work with the package we need to set up the <code>ImageManager</code>. It provides convenience methods to load and convert images and holds the image cache.</p>
+<p>The <code>ImageManager</code> needs an <code>ImageContext</code>. This interface provides the <code>ImageManager</code> with important context and configuration data. Currently this is only the source resolution. The <code>ImageManager</code> and <code>ImageContext</code> are intended to be shared within an application.</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.ImageContext</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.ImageManager</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.impl.DefaultImageContext</span><span class="o">;</span>
@@ -195,7 +195,7 @@ $(document).ready(function () {
 <p>In this example, <code>DefaultImageContext</code> is used. You may need to write your own implementation of <code>ImageContext</code> for your use case.</p>
 <h2 id="preloading-an-image-wzxhzdk12wzxhzdk13">Preloading an image <a id="preloading"></a></h2>
 <p>In order to load an image, it needs to be "preloaded" first, i.e. the image content type is detected and the intrinsic size of the image is determined. The result of this process is an <code>ImageInfo</code> instance which contains the URI, MIME type and intrinsic size. In most cases, this is done without loading the whole image (see SPI section below for information on exceptions to this rule).</p>
-<p>Preloading is normally done through the <code>ImageManager</code> 's <code>getImageInfo()</code> method. For this operation an <code>ImageSessionContext</code> needs to be provided. It is responsible for supplying JAXP <code>Source</code> objects, URI resolution and providing other information needed for the image operations. In simple cases you can simply use <code>DefaultImageSessionContext</code> , but often you will want to write your own implementation of <code>ImageSessionContext</code> . In that case, it's recommended to subclass <code>AbstractImageSessionContext</code> which lets you avoid rewriting a lot of code for providing <code>Source</code> objects.</p>
+<p>Preloading is normally done through the <code>ImageManager</code> 's <code>getImageInfo()</code> method. For this operation an <code>ImageSessionContext</code> needs to be provided. It is responsible for supplying JAXP <code>Source</code> objects, URI resolution and providing other information needed for the image operations. In simple cases you can simply use <code>DefaultImageSessionContext</code>, but often you will want to write your own implementation of <code>ImageSessionContext</code>. In that case, it's recommended to subclass <code>AbstractImageSessionContext</code> which lets you avoid rewriting a lot of code for providing <code>Source</code> objects.</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.ImageInfo</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.ImageSessionContext</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.impl.DefaultImageSessionContext</span><span class="o">;</span>
@@ -209,7 +209,7 @@ $(document).ready(function () {
 
 
 <h2 id="loading-an-image-wzxhzdk14wzxhzdk15">Loading an image <a id="loading"></a></h2>
-<p>Once the image is "preloaded", it can be fully loaded in the form/flavor that is needed by the consuming application. The required flavor is indicated through the <code>ImageFlavor</code> class. If you want the image as a bitmap image in memory, you could request an <code>ImageFlavor.RENDERED_IMAGE</code> . Again, the <code>ImageSessionContext</code> will be needed.</p>
+<p>Once the image is "preloaded", it can be fully loaded in the form/flavor that is needed by the consuming application. The required flavor is indicated through the <code>ImageFlavor</code> class. If you want the image as a bitmap image in memory, you could request an <code>ImageFlavor.RENDERED_IMAGE</code>. Again, the <code>ImageSessionContext</code> will be needed.</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.Image</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.ImageFlavor</span><span class="o">;</span>
 
@@ -223,9 +223,9 @@ $(document).ready(function () {
 </pre></div>
 
 
-<p>In this example above, we simply acquire the image as a RenderedImage instance. If the original image was a vector graphic image (SVG, WMF etc.), it's automatically converted to a bitmap image. Note: The resolution of the created image is controlled by the target resolution returned by the <code>ImageSessionContext</code> .</p>
+<p>In this example above, we simply acquire the image as a RenderedImage instance. If the original image was a vector graphic image (SVG, WMF etc.), it's automatically converted to a bitmap image. Note: The resolution of the created image is controlled by the target resolution returned by the <code>ImageSessionContext</code>.</p>
 <p>Of course, the framework can only provide images in the formats, it has image loaders or image converters for. An example: It is possible to load EPS images, but they can only be provided in raw form. In order to provide it as a bitmap image, a PostScript interpreter would be needed to interpret the PostScript code. This interpreter would be integrated using an <code>ImageConverter</code> implementation (see SPI section below). If the requested form of the image cannot be provided you will get an <code>ImageException</code> on which you'll have to react as needed.</p>
-<p>In <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> , each renderer supports a different set of image flavors that can be embedded in the target format. For example: The PDF renderer can deal with Java2D image, bitmaps, XML, native JPEG and CCITT images. The PCL renderer, however, can only consume bitmap images. So, if you can accept more than one flavor, the package allows you to specify all of them in an ordered list (the first in the list is the preferred format). The package will then try to return the best representation possible. Here's a code example:</p>
+<p>In <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a>, each renderer supports a different set of image flavors that can be embedded in the target format. For example: The PDF renderer can deal with Java2D image, bitmaps, XML, native JPEG and CCITT images. The PCL renderer, however, can only consume bitmap images. So, if you can accept more than one flavor, the package allows you to specify all of them in an ordered list (the first in the list is the preferred format). The package will then try to return the best representation possible. Here's a code example:</p>
 <div class="codehilite"><pre><span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.Image</span><span class="o">;</span>
 <span class="kn">import</span> <span class="nn">org.apache.xmlgraphics.image.loader.ImageFlavor</span><span class="o">;</span>
 
@@ -249,21 +249,21 @@ $(document).ready(function () {
 </pre></div>
 
 
-<p>While each <code>BufferedImage</code> is also a <code>RenderedImage</code> , it can be more efficient to also specify <code>ImageFlavor.BUFFERED_IMAGE</code> in the flavor array.</p>
+<p>While each <code>BufferedImage</code> is also a <code>RenderedImage</code>, it can be more efficient to also specify <code>ImageFlavor.BUFFERED_IMAGE</code> in the flavor array.</p>
 <h1 id="tips-tricks-wzxhzdk16wzxhzdk17">Tips &amp; Tricks <a id="tipsntricks"></a></h1>
 <p>If you are loading bitmap images and you get an error like <code>"Cannot load image (no suitable loader/converter combination available) for
-        myimage.tif (image/tiff)</code> , you maybe be missing the necessary ImageIO codec to decode the image. A number of well-written codecs can be found in <a href="https://jai-imageio.dev.java.net/">JAI Image I/O Tools Project</a> . Just download the distribution and add the JAR to the classpath. ImageIO will automatically pick up the new codecs and they will subsequently be available to the image framework.</p>
+        myimage.tif (image/tiff)</code>, you maybe be missing the necessary ImageIO codec to decode the image. A number of well-written codecs can be found in <a href="https://jai-imageio.dev.java.net/">JAI Image I/O Tools Project</a>. Just download the distribution and add the JAR to the classpath. ImageIO will automatically pick up the new codecs and they will subsequently be available to the image framework.</p>
 <h2 id="service-provider-interface-spi-plug-ins-wzxhzdk18wzxhzdk19">Service Provider Interface (SPI, Plug-ins) <a id="spi"></a></h2>
 <p>The whole image framework is designed to be highly extensible. There are various extension points where new functionality can be added. The three main SPI interfaces are:</p>
 <ul>
 <li>
-<p><code>ImagePreloader</code> : detects the content type and preloads an image</p>
+<p><code>ImagePreloader</code>: detects the content type and preloads an image</p>
 </li>
 <li>
-<p><code>ImageLoader</code> and <code>ImageLoaderFactory</code> : loads images</p>
+<p><code>ImageLoader</code> and <code>ImageLoaderFactory</code>: loads images</p>
 </li>
 <li>
-<p><code>ImageConverter</code> : converts images from one representation into another</p>
+<p><code>ImageConverter</code>: converts images from one representation into another</p>
 </li>
 </ul>
 <p>If you plan to write an implementation of one of the above interfaces, please also take a look at the existing implementations for reference.</p>
@@ -272,11 +272,11 @@ $(document).ready(function () {
 <p>The first task is identifying whether the implementation supports the given image. If the image is loaded using an ImageInputStream it is important to always reset the stream position to the beginning of the file at the end of the <code>preloadImage()</code> method, because all registered preloaders are check in turn until one implementation signals that it supports the format. In that case, it has to extract only the minimal information from the image necessary to identify the image's intrinsic size. For most formats, this is doable without loading the whole image into memory.</p>
 <p>However, for some formats (like MathML or WMF), loading the whole image at preloading time is hard to avoid since the image's size can only be determined that way. In such a case, the <code>ImagePreloader</code> implementations shall pass the loaded document to the respective <code>ImageLoader</code> through the custom objects that can be attached to the <code>ImageInfo</code> object. If the preloader loads the whole document, it shall close the given <code>Source</code> object (calling <code>ImageUtil.closeQuietly(Source)</code> ).</p>
 <p>The priority the implementation reports is used to sort all registered implementations. This is to fine-tune the inner workings and to optimize performance since some formats are usually used more frequently than others.
-Normally, if you implement an <code>ImagePreloader</code> you will also need to implement the respective <code>ImageLoader/ImageLoaderFactory</code> , or vice versa.</p>
+Normally, if you implement an <code>ImagePreloader</code> you will also need to implement the respective <code>ImageLoader/ImageLoaderFactory</code>, or vice versa.</p>
 <h2 id="imageloader-and-imageloaderfactory-wzxhzdk22wzxhzdk23">ImageLoader and ImageLoaderFactory <a id="ImageLoader"></a></h2>
 <p>The factory interface has been created to allow checking if some library that an implementation depends on is really in the classpath so it can report back that the <code>ImageLoader</code> is not funtional. The factory also reports what kind of image formats it supports and which image flavors it can return. There can be a complex relationship between the two. It is recommmended, however, to write smaller implementations rather than big, almighty ones.</p>
 <p>The usage penalty is used when constructing image conversion pipelines. There can be multiple ways to provide an image in one of the supported flavors and this value helps to make the best decision.</p>
-<p>While the factory basically just provides information and creates new <code>ImageLoader</code> instances, the image loaders are doing the actual leg work of decoding the images. The image flavor returned by the loader must match the flavor that is returned by <code>getTargetFlavor()</code> .</p>
+<p>While the factory basically just provides information and creates new <code>ImageLoader</code> instances, the image loaders are doing the actual leg work of decoding the images. The image flavor returned by the loader must match the flavor that is returned by <code>getTargetFlavor()</code>.</p>
 <h3 id="imageconverter-wzxhzdk24wzxhzdk25">ImageConverter <a id="ImageConverter"></a></h3>
 <p>The image converter is responsible to transform one image representation into another. Bundled implementations support these conversions: Java2D to bitmap, bitmap to Java2D and RenderedImage to "raw" PNG. Ideas for additional image converters could be: PDF to Java2D, EPS to Java2D or MathML to SVG or Java2D.</p>
 <p>Each ImageConverter comes with a usage penalty which is used when constructing conversion pipelines so the pipeline with the least penalty value can be chosen. This is necessary as the consuming application my support multiple image flavors and there can be multiple ways to convert an image in one of the requested image flavors. Internally, <a href="http://en.wikipedia.org/wiki/Dijkstra%27s_algorithm">Dijkstra's shortest path algorithm</a> is used to find the best path using the penalties as "way lengths".</p>

Modified: websites/staging/xmlgraphics/trunk/content/commons/index.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/index.html (original)
+++ websites/staging/xmlgraphics/trunk/content/commons/index.html Wed Dec  5 08:23:47 2012
@@ -137,9 +137,9 @@ $(document).ready(function () {
       	<!-- <div id="breadcrumb"><a href="/">Home</a>&nbsp;&raquo&nbsp;<a href="/commons/">Commons</a></div> -->
       	<div class="section-content"><h1 id="apachewzxhzdk0-xml-graphics-commons">Apache&trade; XML Graphics Commons</h1>
 <h2 id="overview-wzxhzdk1wzxhzdk2">Overview <a id="Overview"></a></h2>
-<p>Apache&trade; XML Graphics Commons is a library that consists of several reusable components used by <a href="http://xmlgraphics.apache.org/batik/">Apache Batik</a> and <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> . Many of these components can easily be used separately outside the domains of SVG and XSL-FO. You will find components such as a PDF library, an RTF library, Graphics2D implementations that let you generate PDF &amp; PostScript files, and much more.</p>
+<p>Apache&trade; XML Graphics Commons is a library that consists of several reusable components used by <a href="http://xmlgraphics.apache.org/batik/">Apache Batik</a> and <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a>. Many of these components can easily be used separately outside the domains of SVG and XSL-FO. You will find components such as a PDF library, an RTF library, Graphics2D implementations that let you generate PDF &amp; PostScript files, and much more.</p>
 <p>The Apache&trade; XML Graphics Commons project is part of the <a href="http://www.apache.org">Apache&trade;</a> Software Foundation, which is a wider community of users and developers of open source projects.</p>
-<p>In the Wiki, we have a <a href="http://wiki.apache.org/xmlgraphics/XmlGraphicsCommonComponents">Roadmap for Apache XML Graphics Commons</a> . This roadmap is the place to describe new ideas for the project.</p>
+<p>In the Wiki, we have a <a href="http://wiki.apache.org/xmlgraphics/XmlGraphicsCommonComponents">Roadmap for Apache XML Graphics Commons</a>. This roadmap is the place to describe new ideas for the project.</p>
 <h2 id="features-wzxhzdk6wzxhzdk7">Features <a id="features"></a></h2>
 <p>Components which have been ported from <a href="/batik/">Apache Batik</a> and <a href="/fop/">Apache FOP</a> include:</p>
 <table>
@@ -199,7 +199,7 @@ $(document).ready(function () {
 </tbody>
 </table>
 <h2 id="news-wzxhzdk8wzxhzdk9">News <a id="News"></a></h2>
-<p>RSS Feed: <a href="subproject-news-feed.rss">subproject-news-feed.rss</a> </p>
+<p>RSS Feed: <a href="subproject-news-feed.rss">subproject-news-feed.rss</a></p>
 <h3 id="7-jul-2010-version-14-released-wzxhzdk10wzxhzdk11">7 Jul 2010: Version 1.4 Released <a id="news-2010-07-07"></a></h3>
 <p><item date="2010-07-07" title="Version 1.4 Released">
 This release adds the option to generate smaller PostScript files, support for the AdobeStandardCyrillic encoding, RefinedImageFlavor, TexturePaint support for PSGraphics2D (PostScript tiling patterns), improvements to the XMP framework, optimization for PostScript state handling in (E)PSDocumentGraphics2D, and more. In addition it contains a number of bug fixes. For details, please see the <a href="changes.html#version_1.4">Changes</a> page.</p>

Modified: websites/staging/xmlgraphics/trunk/content/commons/postscript.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/commons/postscript.html (original)
+++ websites/staging/xmlgraphics/trunk/content/commons/postscript.html Wed Dec  5 08:23:47 2012
@@ -147,7 +147,7 @@ $(document).ready(function () {
 </li>
 <li>
 <p>A DSC-parser/processor: Parse, post-process and change DSC-compliant PostScript files.
-We don't currently include a PostScript interpreter though we would love to have one. A Java-based PostScript interpreter to keep an eye on is the one from the <a href="http://foray.sourceforge.net">FOray project</a> .</p>
+We don't currently include a PostScript interpreter though we would love to have one. A Java-based PostScript interpreter to keep an eye on is the one from the <a href="http://foray.sourceforge.net">FOray project</a>.</p>
 </li>
 </ul>
 <h1 id="the-postscript-generator-wzxhzdk4wzxhzdk5">The PostScript generator <a id="generator"></a></h1>
@@ -176,7 +176,7 @@ We don't currently include a PostScript 
 
 <p>A complete example for generating an EPS files can be found in the <a href="http://svn.apache.org/viewvc/xmlgraphics/commons/trunk/examples/java/java2d/ps/">"examples" directory</a> in the distribution.</p>
 <h2 id="dsc-parserprocessor-wzxhzdk10wzxhzdk11">DSC parser/processor <a id="dsc"></a></h2>
-<p>Many PostScript files use special comments to structure a document. This allows manipulation of PostScript files without interpreting them. These special comments are defined in the <a href="http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf">Document Structuring Conventions</a> . The code in Commons is designed to work with DSC 3.0. For details on how DSC is used, please take a look at the DSC specification.</p>
+<p>Many PostScript files use special comments to structure a document. This allows manipulation of PostScript files without interpreting them. These special comments are defined in the <a href="http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf">Document Structuring Conventions</a>. The code in Commons is designed to work with DSC 3.0. For details on how DSC is used, please take a look at the DSC specification.</p>
 <p>The DSC support in Commons was primarily developed to implement resource optimization features in <a href="http://xmlgraphics.apache.org/fop/">Apache FOP</a> 's PostScript output support. Resources like images which are used repeatedly in a document should not be written to the PostScript file each time it is used. Instead it is written once at the beginning of the file as a PostScript form. The form is then called whenever the image needs painting.</p>
 <p>But the DSC parser could potentially be used for other purposes. The most obvious is extracting a subset of pages from a DSC-compliant file. Assume you want to print only page 45 to 57 of a particular document. There's an example that demonstrates exactly this. Check out the "examples" directory in the distribution. Other potential use cases for the DSC parser are:</p>
 <ul>

Modified: websites/staging/xmlgraphics/trunk/content/fop/0.95/anttask.html
==============================================================================
--- websites/staging/xmlgraphics/trunk/content/fop/0.95/anttask.html (original)
+++ websites/staging/xmlgraphics/trunk/content/fop/0.95/anttask.html Wed Dec  5 08:23:47 2012
@@ -387,7 +387,7 @@ $(document).ready(function () {
 </tr>
 <tr>
 <td>format</td>
-<td>Possible output formats:<br></br> <code>application/X-fop-awt-preview</code> <br></br> <code>application/X-fop-print</code> <br></br> <code>application/X-fop-areatree</code> <br></br> <code>application/pdf</code> <br></br> <code>application/postscript</code> <br></br> <code>application/mif</code> <br></br> <code>application/rtf</code> , <code>text/richtext</code> , <code>text/rtf</code> <br></br> <code>application/x-pcl</code> , <code>application/vnd.hp-PCL</code> <br></br> <code>application/x-afp</code> , <code>application/vnd.ibm.modcap</code> <br></br> <code>text/plain</code> <br></br> <code>image/svg+xml</code> <br></br> <code>image/gif</code> <br></br> <code>image/png</code> <br></br> <code>image/tiff</code> <br></br></td>
+<td>Possible output formats:<br></br> <code>application/X-fop-awt-preview</code> <br></br> <code>application/X-fop-print</code> <br></br> <code>application/X-fop-areatree</code> <br></br> <code>application/pdf</code> <br></br> <code>application/postscript</code> <br></br> <code>application/mif</code> <br></br> <code>application/rtf</code>, <code>text/richtext</code>, <code>text/rtf</code> <br></br> <code>application/x-pcl</code>, <code>application/vnd.hp-PCL</code> <br></br> <code>application/x-afp</code>, <code>application/vnd.ibm.modcap</code> <br></br> <code>text/plain</code> <br></br> <code>image/svg+xml</code> <br></br> <code>image/gif</code> <br></br> <code>image/png</code> <br></br> <code>image/tiff</code> <br></br></td>
 <td>No, defaults to <code>application/pdf</code></td>
 </tr>
 <tr>
@@ -408,7 +408,7 @@ $(document).ready(function () {
 <tr>
 <td>relativebase</td>
 <td>For fileset usage only. A value of <code>true</code> specifies using the location of each .fo file as the base directory for resolving relative file references located within that .fo file. A value of <code>false</code> specifies using the value of basedir for all files within the fileset, or just the current working directory if basedir is not specified.</td>
-<td>No, default is <code>false</code> .</td>
+<td>No, default is <code>false</code>.</td>
 </tr>
 <tr>
 <td>userconfig</td>
@@ -417,7 +417,7 @@ $(document).ready(function () {
 </tr>
 <tr>
 <td>messagelevel</td>
-<td>Logging level<br></br>Possible values: <code>error</code> , <code>warn</code> , <code>info</code> , <code>verbose</code> , <code>debug</code> . <strong>Currently doesn't work in FOP Trunk!!!</strong></td>
+<td>Logging level<br></br>Possible values: <code>error</code>, <code>warn</code>, <code>info</code>, <code>verbose</code>, <code>debug</code>. <strong>Currently doesn't work in FOP Trunk!!!</strong></td>
 <td>No, defaults to <code>verbose</code></td>
 </tr>
 <tr>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: commits-help@xmlgraphics.apache.org


Mime
View raw message