xmlgraphics-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From psan...@apache.org
Subject svn commit: r1417307 [3/14] - in /xmlgraphics/site/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:19:31 GMT
Modified: xmlgraphics/site/trunk/content/batik/using/parsers.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/parsers.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/parsers.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/parsers.mdtext Wed Dec  5 08:19:09 2012
@@ -7,7 +7,7 @@ SVG has a number of microsyntaxes that a
 
 ## Parsers, handlers and producers <a id="parsersHandlersAndProducers"></a>
 
-In the parser module, each microsyntax is supported by a pair of classes: a parser and a handler. The parser is a class that implements the [Parser](../javadoc/org/apache/batik/parser/Parser.html) interface, which has methods to parse values from a [Reader](http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html) or a [String](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html) . The handler is an interface specific to the microsyntax that will have its methods called whenever the corresponding element in the input is parsed. For those handler interfaces that have more than one method, adapter classes are provided (named `Default` *).
+In the parser module, each microsyntax is supported by a pair of classes: a parser and a handler. The parser is a class that implements the [Parser](../javadoc/org/apache/batik/parser/Parser.html) interface, which has methods to parse values from a [Reader](http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html) or a [String](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/String.html). The handler is an interface specific to the microsyntax that will have its methods called whenever the corresponding element in the input is parsed. For those handler interfaces that have more than one method, adapter classes are provided (named `Default` *).
 
 Parsers can also have an error handler associated with them, whose single method `error` will be called when there is a problem parsing the input. If an error handler is not associated with a parser, a [ParseException](../javadoc/org/apache/batik/parser/ParseException.html) will be thrown if an error occurs.
 
@@ -17,57 +17,57 @@ The microsyntaxes supported by the parse
 
 Angles
 :
-Implemented by [AngleParser](../javadoc/org/apache/batik/parser/AngleParser.html) , handled with [AngleHandler](../javadoc/org/apache/batik/parser/AngleHandler.html) . This parser is used for parsing angles formed by a floating point number followed by `deg` , `grad` or `rad` . It is not currently used by the rest of the Batik codebase.
+Implemented by [AngleParser](../javadoc/org/apache/batik/parser/AngleParser.html), handled with [AngleHandler](../javadoc/org/apache/batik/parser/AngleHandler.html). This parser is used for parsing angles formed by a floating point number followed by `deg`, `grad` or `rad`. It is not currently used by the rest of the Batik codebase.
 
 
 Clock values
 :
-Implemented by [ClockParser](../javadoc/org/apache/batik/parser/ClockParser.html) , handled with [ClockHandler](../javadoc/org/apache/batik/parser/ClockHandler.html) . This parser is used for parsing SMIL [clock values](http://www.w3.org/TR/smil-animation/#Timing-ClockValueSyntax) .
+Implemented by [ClockParser](../javadoc/org/apache/batik/parser/ClockParser.html), handled with [ClockHandler](../javadoc/org/apache/batik/parser/ClockHandler.html). This parser is used for parsing SMIL [clock values](http://www.w3.org/TR/smil-animation/#Timing-ClockValueSyntax).
 
 
 Fragment identifiers
 :
-Implemented by [FragmentIdentifierParser](../javadoc/org/apache/batik/parser/FragmentIdentifierParser.html) , handled with [FragmentIdentifierHandler](../javadoc/org/apache/batik/parser/FragmentIdentifierHandler.html) . This parser is used for parsing the various formats of [fragment identifier](http://www.w3.org/TR/SVG11/linking.html#SVGFragmentIdentifiers) that SVG allows.
+Implemented by [FragmentIdentifierParser](../javadoc/org/apache/batik/parser/FragmentIdentifierParser.html), handled with [FragmentIdentifierHandler](../javadoc/org/apache/batik/parser/FragmentIdentifierHandler.html). This parser is used for parsing the various formats of [fragment identifier](http://www.w3.org/TR/SVG11/linking.html#SVGFragmentIdentifiers) that SVG allows.
 
 
 Lengths
 :
-Implemented by [LengthParser](../javadoc/org/apache/batik/parser/LengthParser.html) , handled with [LengthHandler](../javadoc/org/apache/batik/parser/LengthHandler.html) . This parser is used for parsing SVG length values.
+Implemented by [LengthParser](../javadoc/org/apache/batik/parser/LengthParser.html), handled with [LengthHandler](../javadoc/org/apache/batik/parser/LengthHandler.html). This parser is used for parsing SVG length values.
 
 
 Length lists
 :
-Implemented by [LengthListParser](../javadoc/org/apache/batik/parser/LengthListParser.html) , handled with [LengthListHandler](../javadoc/org/apache/batik/parser/LengthListHandler.html) . This parser is used for parsing lists of comma or space separated SVG lengths.
+Implemented by [LengthListParser](../javadoc/org/apache/batik/parser/LengthListParser.html), handled with [LengthListHandler](../javadoc/org/apache/batik/parser/LengthListHandler.html). This parser is used for parsing lists of comma or space separated SVG lengths.
 
 
 Numbers
 :
-Implemented by [NumberListParser](../javadoc/org/apache/batik/parser/NumberListParser.html) , handled with [NumberListHandler](../javadoc/org/apache/batik/parser/NumberListHandler.html) . This parser is used for parsing SVG number values.
+Implemented by [NumberListParser](../javadoc/org/apache/batik/parser/NumberListParser.html), handled with [NumberListHandler](../javadoc/org/apache/batik/parser/NumberListHandler.html). This parser is used for parsing SVG number values.
 
 
 Number lists
 :
-Implemented by [NumberListParser](../javadoc/org/apache/batik/parser/NumberListParser.html) , handled with [NumberListHandler](../javadoc/org/apache/batik/parser/NumberListHandler.html) . This parser is used for parsing lists of comma or space separated SVG numbers.
+Implemented by [NumberListParser](../javadoc/org/apache/batik/parser/NumberListParser.html), handled with [NumberListHandler](../javadoc/org/apache/batik/parser/NumberListHandler.html). This parser is used for parsing lists of comma or space separated SVG numbers.
 
 
 Path data
 :
-Implemented by [PathParser](../javadoc/org/apache/batik/parser/PathParser.html) , handled with [PathHandler](../javadoc/org/apache/batik/parser/PathHandler.html) . This parser is used for parsing SVG path data, as found in `path` element `d` attributes.
+Implemented by [PathParser](../javadoc/org/apache/batik/parser/PathParser.html), handled with [PathHandler](../javadoc/org/apache/batik/parser/PathHandler.html). This parser is used for parsing SVG path data, as found in `path` element `d` attributes.
 
 
 Points
 :
-Implemented by [PointsParser](../javadoc/org/apache/batik/parser/PointsParser.html) , handled with [PointsHandler](../javadoc/org/apache/batik/parser/PointsHandler.html) . This parser is used for parsing point lists, as found in `polygon` element `points` attributes.
+Implemented by [PointsParser](../javadoc/org/apache/batik/parser/PointsParser.html), handled with [PointsHandler](../javadoc/org/apache/batik/parser/PointsHandler.html). This parser is used for parsing point lists, as found in `polygon` element `points` attributes.
 
 
 Preserve aspect ratio values
 :
-Implemented by [PreserveAspectRatioParser](../javadoc/org/apache/batik/parser/PreserveAspectRatioParser.html) , handled with [PreserveAspectRatioHandler](../javadoc/org/apache/batik/parser/PreserveAspectRatioHandler.html) . This parser is used for parsing the values found in the `preserveAspectRatio` attribute of `svg` elements.
+Implemented by [PreserveAspectRatioParser](../javadoc/org/apache/batik/parser/PreserveAspectRatioParser.html), handled with [PreserveAspectRatioHandler](../javadoc/org/apache/batik/parser/PreserveAspectRatioHandler.html). This parser is used for parsing the values found in the `preserveAspectRatio` attribute of `svg` elements.
 
 
 Transform lists
 :
-Implemented by [TransformListParser](../javadoc/org/apache/batik/parser/TransformListParser.html) , handled with [TransformListHandler](../javadoc/org/apache/batik/parser/TransformListHandler.html) . This parser is used for parsing transform lists, as found in the `transform` attribute of any transformable element.
+Implemented by [TransformListParser](../javadoc/org/apache/batik/parser/TransformListParser.html), handled with [TransformListHandler](../javadoc/org/apache/batik/parser/TransformListHandler.html). This parser is used for parsing transform lists, as found in the `transform` attribute of any transformable element.
 
 Some microsyntaxes also have a corresponding producer class, which is an implementation of the handler interface that generates an object while parsing.
 

Modified: xmlgraphics/site/trunk/content/batik/using/scripting/ecmascript.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/scripting/ecmascript.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/scripting/ecmascript.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/scripting/ecmascript.mdtext Wed Dec  5 08:19:09 2012
@@ -7,7 +7,7 @@ This page is a brief introduction to scr
 
 ## Scripting basics <a id="scriptingBasics"></a>
 
-As the ECMAScript language (the standardised version of JavaScript) is one of the most popular scripting languages, and as the SVG specification states that an SVG conforming implementation must support it, SVG documents processed by Batik support scripting with ECMAScript using Mozilla’s ECMAScript interpreter, [Rhino](http://www.mozilla.org/rhino/) .
+As the ECMAScript language (the standardised version of JavaScript) is one of the most popular scripting languages, and as the SVG specification states that an SVG conforming implementation must support it, SVG documents processed by Batik support scripting with ECMAScript using Mozilla’s ECMAScript interpreter, [Rhino](http://www.mozilla.org/rhino/).
 
 There are two places in an SVG file where you can put scripts.
 
@@ -37,9 +37,9 @@ Note that inside the event attribute scr
 For more information on using scripting in SVG you can have a look at:
 
 
-- the [scripting chapter of the SVG specification](http://www.w3.org/TR/SVG11/script.html) , for advanced information on scripting in SVG, and
+- the [scripting chapter of the SVG specification](http://www.w3.org/TR/SVG11/script.html), for advanced information on scripting in SVG, and
 
-- the [ECMAScript specification](http://www.ecma.ch/ecma1/stand/ecma-262.htm) , for advanced information on the ECMAScript language.
+- the [ECMAScript specification](http://www.ecma.ch/ecma1/stand/ecma-262.htm), for advanced information on the ECMAScript language.
 
 ## Using Rhino features <a id="rhinoFeatures"></a>
 
@@ -157,4 +157,4 @@ Then, you must build an [IntepreterPool]
 
 For example if you are using the Batik SVG browser application you should be able to use the previous piece of code on a subclass of the [JSVGCanvas](../../javadoc/org/apache/batik/swing/JSVGCanvas.html) class in the `createBridgeContext()` method.
 
-For further information on working with Rhino, consult the [Rhino website](http://www.mozilla.org/rhino/) .
+For further information on working with Rhino, consult the [Rhino website](http://www.mozilla.org/rhino/).

Modified: xmlgraphics/site/trunk/content/batik/using/scripting/java.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/scripting/java.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/scripting/java.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/scripting/java.mdtext Wed Dec  5 08:19:09 2012
@@ -163,7 +163,7 @@ where `mouseOverListener` implements the
 
 This is called whenever the event occurs with the element it is registered on. It is worth reviewing the DOM Events specification as there are many useful features to this interface that are not immediately obvious.
 
-It is also worth looking at the DOM interfaces defined by the SVG specification as they provide a large number of useful methods, in particular those of [SVGLocatable](../../javadoc/org/w3c/dom/svg/SVGLocatable.html) :
+It is also worth looking at the DOM interfaces defined by the SVG specification as they provide a large number of useful methods, in particular those of [SVGLocatable](../../javadoc/org/w3c/dom/svg/SVGLocatable.html):
 
     :::java
     // Returns Bounding box of SVG Element.
@@ -185,7 +185,7 @@ It is also worth looking at the DOM inte
 
 Batik implements the Java bindings for SVG, and thus allows Java code to be referenced from `script` elements. This feature is available to any application of Batik that uses the bridge module (for example the Swing component and the transcoders).
 
-In order to use this extension, the `type` attribute of a `script` element must be set to `application/java-archive` . In addition, the `xlink:href` attribute must be the URI of a jar file that contains the code to run.
+In order to use this extension, the `type` attribute of a `script` element must be set to `application/java-archive`. In addition, the `xlink:href` attribute must be the URI of a jar file that contains the code to run.
 
 The manifest of this jar file must contains an entry of the form:
 

Modified: xmlgraphics/site/trunk/content/batik/using/scripting/security.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/scripting/security.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/scripting/security.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/scripting/security.mdtext Wed Dec  5 08:19:09 2012
@@ -15,7 +15,7 @@ The concept of Java security is an appli
 
 ### Enforcing security in a Batik application <a id="enforcing"></a>
 
-Enforcing security in a Batik application is done by setting a [java.lang.SecurityManager](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/SecurityManager.html) . This security manager will apply the security settings of the Java platform (as defined by the *jre-dir*  `/lib/security/java.policy` and, optionally, by the policy file whose URL is defined in the `java.security.policy` system property).
+Enforcing security in a Batik application is done by setting a [java.lang.SecurityManager](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/SecurityManager.html). This security manager will apply the security settings of the Java platform (as defined by the *jre-dir*  `/lib/security/java.policy` and, optionally, by the policy file whose URL is defined in the `java.security.policy` system property).
 
 The [org.apache.batik.util.ApplicationSecurityEnforcer](../../javadoc/org/apache/batik/util/ApplicationSecurityEnforcer.html) helper class makes it easier for Batik application developers to add security support in their applications. That helper class is used by the sample Batik applications.
 
@@ -24,9 +24,9 @@ The [org.apache.batik.util.ApplicationSe
 The Squiggle browser lets the user decide whether or not scripts should be run securely (see the “Browser Options” in the preference dialog box). When scripts are run securely, Squiggle will enforce the security settings as follows:
 
 
-- The default policy is defined by the policy file found in the distribution: `org/apache/batik/apps/svgbrowser/svgbrowser.policy` . In the binary distribution, that file would be in the `batik-squiggle.jar` file. In the source distribution, that file would be in the `resources` directory. The default policy file gives appropriate permissions to the Batik code, the XML parser and the Rhino scripting engine and very limited permissions to scripts.
+- The default policy is defined by the policy file found in the distribution: `org/apache/batik/apps/svgbrowser/svgbrowser.policy`. In the binary distribution, that file would be in the `batik-squiggle.jar` file. In the source distribution, that file would be in the `resources` directory. The default policy file gives appropriate permissions to the Batik code, the XML parser and the Rhino scripting engine and very limited permissions to scripts.
 
-- At startup time, and whenever the preference settings are modified, Squiggle makes a copy of the default policy and appends any additional permissions granted to scripts by the user through the preference settings. This policy file can be found in the `[user.home]/.batik` directory, and is called `__svgbrowser.policy` . Note that this file is automatically generated and should not be modified manually (as any edits would be lost).
+- At startup time, and whenever the preference settings are modified, Squiggle makes a copy of the default policy and appends any additional permissions granted to scripts by the user through the preference settings. This policy file can be found in the `[user.home]/.batik` directory, and is called `__svgbrowser.policy`. Note that this file is automatically generated and should not be modified manually (as any edits would be lost).
 
 - The policy defined as described above is enforced unless the `java.security.policy` system property is defined. In that case, the policy defined by the system property takes precedence and the policy file generated from the Squiggle preferences is ignored.
 
@@ -44,7 +44,7 @@ Alternatively, you can write your own po
 
 ## Controlling access to external resources <a id="externalResources"></a>
 
-SVG makes a very powerful use of external resources in many elements such as `image` , `use` , `font` , `script` and `radialGradient` . There are over fifteen SVG elements that may reference external resources that way.
+SVG makes a very powerful use of external resources in many elements such as `image`, `use`, `font`, `script` and `radialGradient`. There are over fifteen SVG elements that may reference external resources that way.
 
 In some environments, and typically for security reasons, it is important to control the resources referenced by an SVG document and be able to accept or reject these resources.
 
@@ -53,9 +53,9 @@ In the Batik toolkit, this flexibility i
 The following `UserAgent` methods are provided for that purpose:
 
 
--  `getScriptSecurity(scriptType, scriptURL, docURL)` should return the [ScriptSecurity](../../javadoc/org/apache/batik/bridge/ScriptSecurity.html) strategy for a script of type `scriptType` (e.g., `text/ecmascript` ) coming from `scriptURL` , when referenced from the document whose URL is `docURL` .
+-  `getScriptSecurity(scriptType, scriptURL, docURL)` should return the [ScriptSecurity](../../javadoc/org/apache/batik/bridge/ScriptSecurity.html) strategy for a script of type `scriptType` (e.g., `text/ecmascript` ) coming from `scriptURL`, when referenced from the document whose URL is `docURL`.
 
--  `getExternalResourceSecurity(resourceURL, docURL)` should return the [ExternalResourceSecurity](../../javadoc/org/apache/batik/bridge/ExternalResourceSecurity.html) strategry for a resource coming from `resourceURL` referenced from the document at URL `docURL` .
+-  `getExternalResourceSecurity(resourceURL, docURL)` should return the [ExternalResourceSecurity](../../javadoc/org/apache/batik/bridge/ExternalResourceSecurity.html) strategry for a resource coming from `resourceURL` referenced from the document at URL `docURL`.
 
 The `ScriptSecurity` and `ExternalResourceSecurity` interfaces have methods ( `checkLoadScript` and `checkLoadExternalResource` respectively) which should throw a [SecurityException](http://java.sun.com/j2se/1.5.0/docs/api/java/lang/SecurityException.html) if accessing the script or resource is considered a security violation.
 The `UserAgent` interface has two additional methods ( `checkLoadScript` and `checkLoadExternalResource` which are meant to provide a short hand for getting a security strategy object and calling the `checkLoad` * method on that object. This is how the [org.apache.batik.bridge.UserAgentAdapter](../../javadoc/org/apache/batik/bridge/UserAgentAdapter.html) class implements this method.
@@ -64,22 +64,22 @@ Batik provides the following set of `Scr
 
 
 NoLoadScriptSecurity
-:    
+:
 The script resource should not be loaded.
 
 
 EmbededScriptSecurity
-:    
+:
 The script resource will only be loaded if it is embeded in the SVG document referencing it. This means that script attributes (such as `onclick` on a `rect` element), inline `script` elements and `script` elements using a `data:` URL as its `xlink:href` attribute value will be allowed. All other script resources should not be loaded.
 
 
 DefaultScriptSecurity
-:    
+:
 The script resource will only be loaded if it is embeded in the SVG document (see the description of `EmbededScriptSecurity` ) or if it is coming from the same location as the document referencing the script. If the document comes from a network server, then any script coming from that server will be allowed. If the document comes from the file system, then only scripts under the same directory root as the SVG document will be allowed.
 
 
 RelaxedScriptSecurity
-:    
+:
 Scripts from any location can be loaded.
 
 In addition, Batik provides the following set of `ExternalResourceSecurity` implementations:
@@ -87,20 +87,20 @@ In addition, Batik provides the followin
 
 
 NoLoadExternalResourceSecurity
-:    
+:
 No external references are allowed.
 
 
 EmbededExternalResourceSecurity
-:    
+:
 Only resources embeded into the file are allowed (i.e., references through the `data:` protocol).
 
 
 DefaultExternalResourceSecurity
-:    
+:
 Embeded external resources (see above) and resources coming from the same location as the document referencing them are allowed.
 
 
 RelaxedExternalResourceSecurity
-:    
+:
 Resources from any location can be loaded.

Modified: xmlgraphics/site/trunk/content/batik/using/svg-generator.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/svg-generator.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/svg-generator.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/svg-generator.mdtext Wed Dec  5 08:19:09 2012
@@ -3,11 +3,11 @@ Title: SVG Generator: SVGGraphics2D
 #SVG Generator: SVGGraphics2D
 
 <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>
-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 [SVGGraphics2D](../javadoc/org/apache/batik/svggen/SVGGraphics2D.html) , referred to as the SVG Generator, makes this possible.
+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 [SVGGraphics2D](../javadoc/org/apache/batik/svggen/SVGGraphics2D.html), referred to as the SVG Generator, makes this possible.
 
 ## The SVGGraphics2D class <a id="whatIsIt"></a>
 
-On the Java platform, all rendering goes through the [Graphics2D](http://java.sun.com/j2se/1.5.0/docs/api/java/awt/Graphics2D.html) abstract class, which offers methods such as `drawRect` , `fillRect` , and `drawString` . There are specialized implementations of this abstract class for each type of output, such as a screen or a printer. `SVGGraphics2D` is a new implementation of that interface that generates SVG content instead of drawing to a screen or a printer.
+On the Java platform, all rendering goes through the [Graphics2D](http://java.sun.com/j2se/1.5.0/docs/api/java/awt/Graphics2D.html) abstract class, which offers methods such as `drawRect`, `fillRect`, and `drawString`. There are specialized implementations of this abstract class for each type of output, such as a screen or a printer. `SVGGraphics2D` is a new implementation of that interface that generates SVG content instead of drawing to a screen or a printer.
 
  `SVGGraphics2D` has the following features:
 
@@ -19,9 +19,9 @@ On the Java platform, all rendering goes
 - it offers the user the ability to use the DOM API to manipulate the generated document.
 
 <div class="figure"> ![Diagram illustrating how the SVGGraphics2D inherits from Graphics2D, and uses Document to generate a DOM tree](images/svggenHighLevelArchi.jpg "") </div>
-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 [Document](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html) , [Element](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Element.html) , and [Attr](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Attr.html) , which model the Java programming language equivalent of XML documents, elements and attributes.
+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 [Document](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html), [Element](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Element.html), and [Attr](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Attr.html), which model the Java programming language equivalent of XML documents, elements and attributes.
 
-The generator manages a tree of DOM objects that represent the SVG content corresponding to the rendering calls made on the `SVGGraphics2D` instance. In other words, every time a program invokes a rendering method, such as `fillRect` , on a `SVGGraphics2D` instance, a new DOM object, representing the SVG equivalent, is appended to the DOM tree. For example, a `rect` element will be appended after the `fillRect` method has been invoked).
+The generator manages a tree of DOM objects that represent the SVG content corresponding to the rendering calls made on the `SVGGraphics2D` instance. In other words, every time a program invokes a rendering method, such as `fillRect`, on a `SVGGraphics2D` instance, a new DOM object, representing the SVG equivalent, is appended to the DOM tree. For example, a `rect` element will be appended after the `fillRect` method has been invoked).
 
 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.
 
@@ -102,7 +102,7 @@ We can see that generating SVG content f
     test.paint(svgGenerator);
 
 1.
-Stream out the SVG content. The SVG generator can stream its content into any `java.io.Writer` . In our example, we stream the content to the standard output stream:
+Stream out the SVG content. The SVG generator can stream its content into any `java.io.Writer`. In our example, we stream the content to the standard output stream:
 
     :::java
     // Finally, stream out SVG to the standard output using
@@ -111,7 +111,7 @@ Stream out the SVG content. The SVG gene
     Writer out = new OutputStreamWriter(System.out, "UTF-8");
     svgGenerator.stream(out, useCSS);
 
-SVG has [two ways to specify styling properties](http://www.w3.org/TR/SVG11/styling.html#AlternativesForStyling) , such as the fill color: presentation attributes (one XML attribute per property) or the CSS `style` attribute (any number of properties in one CSS inline stylesheet). The `useCss` parameter allows the user to control that option.
+SVG has [two ways to specify styling properties](http://www.w3.org/TR/SVG11/styling.html#AlternativesForStyling), such as the fill color: presentation attributes (one XML attribute per property) or the CSS `style` attribute (any number of properties in one CSS inline stylesheet). The `useCss` parameter allows the user to control that option.
 
 ## SVG Generator customization <a id="custom"></a>
 
@@ -151,7 +151,7 @@ In order to have a self-contained SVG fi
 
 Every time you call one of the `drawImage` methods provided by the `Graphics2D` 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.
 
-You can change the default behavior by explicitly providing the image handler to be used by the SVG generator. Once again, you use the `SVGGeneratorContext` for this. In the example below, all images are converted to PNG format and written to directory `res/images` .
+You can change the default behavior by explicitly providing the image handler to be used by the SVG generator. Once again, you use the `SVGGeneratorContext` for this. In the example below, all images are converted to PNG format and written to directory `res/images`.
 
     :::java
     DOMImplementation impl =
@@ -244,7 +244,7 @@ Your needs in matter of styling may be d
       }
     }
 
-Then you can create and use an `SVGGraphics2D` with a correctly configured `SVGGeneratorContext` .
+Then you can create and use an `SVGGraphics2D` with a correctly configured `SVGGeneratorContext`.
 
     :::java
     // Configure the SVGGraphics2D for a given Document myFactory.
@@ -269,9 +269,9 @@ Then you can create and use an `SVGGraph
 
 ## Extending Paint object to SVG element translation <a id="Extending+Paint+object+to+SVG+element+translation"></a>
 
-The `SVGGraphics2D` 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 [Paint](http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Paint.html) interface. In this case, you will need to write an [ExtensionHandler](../javadoc/org/apache/batik/svggen/ExtensionHandler.html) that you will set on your `SVGGeneratorContext` .
+The `SVGGraphics2D` 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 [Paint](http://java.sun.com/j2se/1.4.2/docs/api/java/awt/Paint.html) interface. In this case, you will need to write an [ExtensionHandler](../javadoc/org/apache/batik/svggen/ExtensionHandler.html) that you will set on your `SVGGeneratorContext`.
 
-In the following example we define the first draft of an `ExtensionHandler` allowing to translate a Batik implementation of the `Paint` interface named [LinearGradientPaint](../javadoc/org/apache/batik/ext/awt/LinearGradientPaint.html) .
+In the following example we define the first draft of an `ExtensionHandler` allowing to translate a Batik implementation of the `Paint` interface named [LinearGradientPaint](../javadoc/org/apache/batik/ext/awt/LinearGradientPaint.html).
 
     :::java
     class MyExtensionHandler extends DefaultExtensionHandler {

Modified: xmlgraphics/site/trunk/content/batik/using/swing.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/swing.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/swing.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/swing.mdtext Wed Dec  5 08:19:09 2012
@@ -7,7 +7,7 @@ The goal of the Batik Swing component mo
 
 ## Creating a JSVGCanvas <a id="creatingJSVGCanvas"></a>
 
-The following example illustrates how to create a `JSVGCanvas` , 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 [the Swing tutorial](http://java.sun.com/docs/books/tutorial/uiswing/overview/threads.html) . The `JSVGCanvas` is also a [JavaBean](http://java.sun.com/products/javabeans/) , so it can be used in visual application builders.
+The following example illustrates how to create a `JSVGCanvas`, 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 [the Swing tutorial](http://java.sun.com/docs/books/tutorial/uiswing/overview/threads.html). The `JSVGCanvas` is also a [JavaBean](http://java.sun.com/products/javabeans/), so it can be used in visual application builders.
 If you try this example, do not forget to set your `CLASSPATH` so that it contains the Batik classes and resources, as well as Xerces ( `lib/xerces_2_5_0.jar` ) and the XML APIs jars ( `lib/xml-apis.jar` and `lib/xml-apis-ext.jar` ).
 
     :::java
@@ -154,7 +154,7 @@ The [UpdateManagerListener](../javadoc/o
 
 This event is triggered only in dynamic documents.
 
-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— [SVGDocumentLoaderAdapter](../javadoc/org/apache/batik/swing/svg/SVGDocumentLoaderAdapter.html) , [GVTTreeBuilderListenerAdapter](../javadoc/org/apache/batik/swing/svg/GVTTreeBuilderListenerAdapter.html) , [SVGLoadEventDispatcherAdapter](../javadoc/org/apache/batik/swing/svg/SVGLoadEventDispatcherAdapter.html) , [GVTTreeRendererAdapter](../javadoc/org/apache/batik/swing/gvt/GVTTreeRendererAdapter.html) and [UpdateManagerAdapter](../javadoc/org/apache/batik/bridge/UpdateManagerAdapter.html) ,
+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— [SVGDocumentLoaderAdapter](../javadoc/org/apache/batik/swing/svg/SVGDocumentLoaderAdapter.html), [GVTTreeBuilderListenerAdapter](../javadoc/org/apache/batik/swing/svg/GVTTreeBuilderListenerAdapter.html), [SVGLoadEventDispatcherAdapter](../javadoc/org/apache/batik/swing/svg/SVGLoadEventDispatcherAdapter.html), [GVTTreeRendererAdapter](../javadoc/org/apache/batik/swing/gvt/GVTTreeRendererAdapter.html) and [UpdateManagerAdapter](../javadoc/org/apache/batik/bridge/UpdateManagerAdapter.html),
 
 For static documents, you can assume that the JSVGCanvas has completed its job (parsing, building and rendering) when the `gvtRenderingCompleted` method call is called, following a `setURI` or a `setSVGDocument` method call.
 
@@ -162,4 +162,4 @@ In the case of dynamic documents, the en
 
 ## Adding an Interactor <a id="interactor"></a>
 
-The `JSVGCanvas` 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 `JSVGCanvas` component and translate them into behaviour. If you want to add new behaviors to the `JSVGCanvas` , you can implement the [Interactor](../javadoc/org/apache/batik/swing/gvt/Interactor.html) interface. Then, you can register this new interactor to the component by adding an element to the `List` returned by the `getInteractors()` method of the canvas.
+The `JSVGCanvas` 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 `JSVGCanvas` component and translate them into behaviour. If you want to add new behaviors to the `JSVGCanvas`, you can implement the [Interactor](../javadoc/org/apache/batik/swing/gvt/Interactor.html) interface. Then, you can register this new interactor to the component by adding an element to the `List` returned by the `getInteractors()` method of the canvas.

Modified: xmlgraphics/site/trunk/content/batik/using/transcoder.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/batik/using/transcoder.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/batik/using/transcoder.mdtext (original)
+++ xmlgraphics/site/trunk/content/batik/using/transcoder.mdtext Wed Dec  5 08:19:09 2012
@@ -3,7 +3,7 @@ Title: Transcoder API
 #Transcoder API
 
 
-The goal of the transcoder API (package `org.apache.batik.transcoder` ) is to provide a generic API for transcoding an input to an output. First, this document explains the basic transcoder API that [Transcoder](../javadoc/org/apache/batik/transcoder/Transcoder.html) , [TranscoderInput](../javadoc/org/apache/batik/transcoder/TranscoderInput.html) and [TranscoderOutput](../javadoc/org/apache/batik/transcoder/TranscoderOutput.html) define, and thus all transcoders have in common. Next, it describes how to use the image transcoder API (package `org.apache.batik.transcoder.image` ), which lets you rasterize an SVG document fragment to a raster image such as JPEG, PNG or TIFF.
+The goal of the transcoder API (package `org.apache.batik.transcoder` ) is to provide a generic API for transcoding an input to an output. First, this document explains the basic transcoder API that [Transcoder](../javadoc/org/apache/batik/transcoder/Transcoder.html), [TranscoderInput](../javadoc/org/apache/batik/transcoder/TranscoderInput.html) and [TranscoderOutput](../javadoc/org/apache/batik/transcoder/TranscoderOutput.html) define, and thus all transcoders have in common. Next, it describes how to use the image transcoder API (package `org.apache.batik.transcoder.image` ), which lets you rasterize an SVG document fragment to a raster image such as JPEG, PNG or TIFF.
 
 ## The transcoder API <a id="transcoderAPI"></a>
 
@@ -13,17 +13,17 @@ The `org.apache.batik.transcoder` packag
 
 Transcoder
 :
-The [Transcoder](../javadoc/org/apache/batik/transcoder/Transcoder.html) interface defines the interface that all transcoders implement. You can transcode a specific input using a specific output by invoking the `transcode` 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 [Document](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html) , a [Reader](http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html) , an [InputStream](http://java.sun.com/j2se/1.5.0/docs/api/java/io/InputStream.html) , or a [URI](http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html) as an input but only supports a byte stream for the output.
+The [Transcoder](../javadoc/org/apache/batik/transcoder/Transcoder.html) interface defines the interface that all transcoders implement. You can transcode a specific input using a specific output by invoking the `transcode` 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 [Document](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html), a [Reader](http://java.sun.com/j2se/1.5.0/docs/api/java/io/Reader.html), an [InputStream](http://java.sun.com/j2se/1.5.0/docs/api/java/io/InputStream.html), or a [URI](http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html) as an input but only supports a byte stream for the output.
 
 
 TranscoderInput
 :
-The [TranscoderInput](../javadoc/org/apache/batik/transcoder/TranscoderInput.html) 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 `org.w3c.dom.Document` , a `Reader` , an `InputStream` , a `org.xml.sax.XMLReader` , or a `URI` .
+The [TranscoderInput](../javadoc/org/apache/batik/transcoder/TranscoderInput.html) 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 `org.w3c.dom.Document`, a `Reader`, an `InputStream`, a `org.xml.sax.XMLReader`, or a `URI`.
 
 
 TranscoderOutput
 :
-The [TranscoderOutput](../javadoc/org/apache/batik/transcoder/TranscoderOutput.html) 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 [Document](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html) , a [Writer](http://java.sun.com/j2se/1.5.0/docs/api/java/io/Writer.html) , an [OutputStream](http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html) , a [XMLFilter](http://java.sun.com/j2se/1.5.0/docs/api/org/xml/sax/XMLFilter.html) , or a [URI](http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html) .
+The [TranscoderOutput](../javadoc/org/apache/batik/transcoder/TranscoderOutput.html) 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 [Document](http://java.sun.com/j2se/1.5.0/docs/api/org/w3c/dom/Document.html), a [Writer](http://java.sun.com/j2se/1.5.0/docs/api/java/io/Writer.html), an [OutputStream](http://java.sun.com/j2se/1.5.0/docs/api/java/io/OutputStream.html), a [XMLFilter](http://java.sun.com/j2se/1.5.0/docs/api/org/xml/sax/XMLFilter.html), or a [URI](http://java.sun.com/j2se/1.5.0/docs/api/java/net/URI.html).
 
 
 TranscodingHints
@@ -41,7 +41,7 @@ The `org.apache.batik.transcoder.image` 
 
 ### Creating an image <a id="createImage"></a>
 
-The following example, using the `JPEGTranscoder` , shows how to transform an SVG document to a JPEG image.
+The following example, using the `JPEGTranscoder`, shows how to transform an SVG document to a JPEG image.
 
     :::java
     import java.io.*;
@@ -79,7 +79,7 @@ The following example, using the `JPEGTr
         }
     }
 
-The code creates a `JPEGTranscoder` 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 `out.jpg` . Finally, the `transcode` method is invoked and the byte stream is closed.
+The code creates a `JPEGTranscoder` 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 `out.jpg`. Finally, the `transcode` method is invoked and the byte stream is closed.
 
 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.
 
@@ -87,7 +87,7 @@ To try this program:
 
 
 1.
-Save the above program as `SaveAsJPEG.java` .
+Save the above program as `SaveAsJPEG.java`.
 
 
 1.
@@ -99,14 +99,14 @@ Choose an SVG file to transcode, and per
 java SaveAsJPEG filename.svg
 
 1.
-Inspect the output file `out.jpg` .
+Inspect the output file `out.jpg`.
 
 
 ### Defining the size of the image <a id="defineSizeOfImage"></a>
 
 By adding the following line of code to the previous example, you will specify the raster image size (in pixels). The transcoding hint `KEY_WIDTH` lets you specify the raster image width. If the raster image height is not provided (using the `KEY_HEIGHT` ), 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 `KEY_HEIGHT` without initializing the `KEY_WIDTH` . In all cases (even if both keys are provided), the transcoder will preserve the apsect ratio of the SVG document.
+The transcoder will have the same behavior if you specify the `KEY_HEIGHT` without initializing the `KEY_WIDTH`. In all cases (even if both keys are provided), the transcoder will preserve the apsect ratio of the SVG document.
 
 ### Selecting an area of interest <a id="selectAreaOfIntrest"></a>
 
@@ -167,13 +167,13 @@ The image transcoder lets you specify an
         }
     }
 
-This code splits the same document `anne.svg` 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 `KEY_AOI` 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 `KEY_WIDTH` and `KEY_HEIGHT` , that do not match the dimensions of the `KEY_AOI` 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.
+This code splits the same document `anne.svg` 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 `KEY_AOI` 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 `KEY_WIDTH` and `KEY_HEIGHT`, that do not match the dimensions of the `KEY_AOI` 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.
 
 To try this program:
 
 
 1.
-Save the above program as `SaveAsJPEGTiles.java` .
+Save the above program as `SaveAsJPEGTiles.java`.
 
 
 1.
@@ -189,7 +189,7 @@ Run the program by typing:
 java SaveAsJPEGTiles
 
 1.
-Inspect the output files `tileTopRight.jpg` , `tileTopRight.jpg` , `tileBottomRight.jpg` and `tileBottomLeft.jpg` .
+Inspect the output files `tileTopRight.jpg`, `tileTopRight.jpg`, `tileBottomRight.jpg` and `tileBottomLeft.jpg`.
 
 
 ### Other transcoding hints <a id="otherTransHints"></a>
@@ -200,7 +200,7 @@ The `ImageTranscoder` provides additiona
 
  `ImageTranscoder.KEY_MEDIA`
 :
-This hint lets you choose the CSS medium to use. The author of the SVG document to transcode can control CSS media using the [CSS media rule](http://www.w3.org/TR/REC-CSS2/media.html) . 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 [CSS media rule](http://www.w3.org/TR/REC-CSS2/media.html). For example:
 trans.addTranscodingHint(ImageTranscoder.KEY_MEDIA, "print");
 
  `ImageTranscoder.KEY_ALTERNATE_STYLESHEET`
@@ -318,13 +318,13 @@ Rasterizing the DOM
 :
 See the `save` method.
 
-Similar to the previous examples, you can transcode an SVG document to a raster image by creating a `TranscoderInput` , but passing to it the SVG Document this time.
+Similar to the previous examples, you can transcode an SVG document to a raster image by creating a `TranscoderInput`, but passing to it the SVG Document this time.
 
 To try this example:
 
 
 1.
-Save the code as `DOMRasterizer.java` .
+Save the code as `DOMRasterizer.java`.
 
 
 1.
@@ -336,5 +336,5 @@ Run it, by typingL
 java DOMRasterizer
 
 1.
-Inspect the output file `out.jpg` .
+Inspect the output file `out.jpg`.
 

Modified: xmlgraphics/site/trunk/content/commons/bugs.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/commons/bugs.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/commons/bugs.mdtext (original)
+++ xmlgraphics/site/trunk/content/commons/bugs.mdtext Wed Dec  5 08:19:09 2012
@@ -7,7 +7,7 @@ Information on this page applies to enha
 
 ## Reported Issues <a id="issues_existing"></a>
 
-A list of unresolved reported bugs can be found at [XML Graphics Commons Open Bugs (Bugzilla)](http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=XMLGraphicsCommons&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=) . If you have an interest in an issue already reported, please consider the following:
+A list of unresolved reported bugs can be found at [XML Graphics Commons Open Bugs (Bugzilla)](http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=XMLGraphicsCommons&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=). If you have an interest in an issue already reported, please consider the following:
 
 
 - If you have insight that may help developers solve an existing problem, please add comments and/or file attachments to the existing issue.
@@ -21,6 +21,6 @@ User reports of bugs and requests for en
 
 - Review the [Apache Bug Writing Guidelines](http://issues.apache.org/bugzilla/page.cgi?id=bug-writing.html) before submitting your report.
 
-- Enter a new issue report at the [XML Graphics Commons issue database (Bugzilla)](http://issues.apache.org/bugzilla/enter_bug.cgi?product=XMLGraphicsCommons) . 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.
+- Enter a new issue report at the [XML Graphics Commons issue database (Bugzilla)](http://issues.apache.org/bugzilla/enter_bug.cgi?product=XMLGraphicsCommons). 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.
 
-- After submission, a copy of your bug report will be automatically sent to the [XML Graphics General discussion list](http://xmlgraphics.apache.org/mail.html#xmlgraphics-general) .
+- After submission, a copy of your bug report will be automatically sent to the [XML Graphics General discussion list](http://xmlgraphics.apache.org/mail.html#xmlgraphics-general).

Modified: xmlgraphics/site/trunk/content/commons/changes.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/commons/changes.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/commons/changes.mdtext (original)
+++ xmlgraphics/site/trunk/content/commons/changes.mdtext Wed Dec  5 08:19:09 2012
@@ -2,28 +2,28 @@ Title: History of Changes
 
 #History of Changes
 
- [changes.rss](changes.rss) 
+ [changes.rss](changes.rss)
 
 ## Introduction and explanation of symbols <a id="introduction"></a>
 
-Changes are sorted by "type" and then chronologically with the most recent at the top. These symbols denote the various action types: ![add](/images/add.jpg)=add , ![fix](/images/fix.jpg)=fix, ![remove](/images/remove.jpg)=remove, ![update](/images/update.jpg)=update
+Changes are sorted by "type" and then chronologically with the most recent at the top. These symbols denote the various action types: ![add](/images/add.jpg)=add, ![fix](/images/fix.jpg)=fix, ![remove](/images/remove.jpg)=remove, ![update](/images/update.jpg)=update
 
 ## Version Trunk (n/a) <a id="version_Trunk"></a>
 
 ### Changes to the Code Base <a id="Code_Trunk"></a>
 
 
-- ![fix](/images/fix.jpg)Support rdf:resource attributes in XMP. Committed by GA. Thanks to Brian Carlson. See Issue [50497](http://issues.apache.org/bugzilla/show_bug.cgi?id=50497) .
+- ![fix](/images/fix.jpg)Support rdf:resource attributes in XMP. Committed by GA. Thanks to Brian Carlson. See Issue [50497](http://issues.apache.org/bugzilla/show_bug.cgi?id=50497).
 
-- ![fix](/images/fix.jpg)Should never use Error to report runtime errors. Committed by GA. Thanks to Sebastian Bazley. See Issue [47174](http://issues.apache.org/bugzilla/show_bug.cgi?id=47174) .
+- ![fix](/images/fix.jpg)Should never use Error to report runtime errors. Committed by GA. Thanks to Sebastian Bazley. See Issue [47174](http://issues.apache.org/bugzilla/show_bug.cgi?id=47174).
 
-- ![fix](/images/fix.jpg)Ensure that throwables have meaningful messages. Committed by GA. Thanks to Sebastian Bazley. See Issue [47175](http://issues.apache.org/bugzilla/show_bug.cgi?id=47175) .
+- ![fix](/images/fix.jpg)Ensure that throwables have meaningful messages. Committed by GA. Thanks to Sebastian Bazley. See Issue [47175](http://issues.apache.org/bugzilla/show_bug.cgi?id=47175).
 
-- ![fix](/images/fix.jpg)Support for T.4 Group 3 1D encoding. Committed by PH. Thanks to JM and Mehdi Houshmand. See Issue [51911](http://issues.apache.org/bugzilla/show_bug.cgi?id=51911) .
+- ![fix](/images/fix.jpg)Support for T.4 Group 3 1D encoding. Committed by PH. Thanks to JM and Mehdi Houshmand. See Issue [51911](http://issues.apache.org/bugzilla/show_bug.cgi?id=51911).
 
-- ![fix](/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 [51039](http://issues.apache.org/bugzilla/show_bug.cgi?id=51039) .
+- ![fix](/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 [51039](http://issues.apache.org/bugzilla/show_bug.cgi?id=51039).
 
-- ![fix](/images/fix.jpg)Allow to override priority when registering an ImageWriter on the ImageWriterRegistry. Committed by JM. Thanks to Joshua Marquart. See Issue [49696](http://issues.apache.org/bugzilla/show_bug.cgi?id=49696) .
+- ![fix](/images/fix.jpg)Allow to override priority when registering an ImageWriter on the ImageWriterRegistry. Committed by JM. Thanks to Joshua Marquart. See Issue [49696](http://issues.apache.org/bugzilla/show_bug.cgi?id=49696).
 
 - ![fix](/images/fix.jpg)Fix for TIFFs which report zero as their resolution. This resulted in an exception. Committed by JM.
 
@@ -33,7 +33,7 @@ Changes are sorted by "type" and then ch
 
 - ![update](/images/update.jpg)Minor build improvements to eliminate warning and parameterize junit formatting. Eliminate (5) deprecation warnings. Committed by GA.
 
-- ![update](/images/update.jpg)Various code style fixes Committed by JM. Thanks to Glenn Adams. See Issue [49703](http://issues.apache.org/bugzilla/show_bug.cgi?id=49703) .
+- ![update](/images/update.jpg)Various code style fixes Committed by JM. Thanks to Glenn Adams. See Issue [49703](http://issues.apache.org/bugzilla/show_bug.cgi?id=49703).
 
 ### Contributors to this release <a id="contributors_Trunk"></a>
 
@@ -48,33 +48,33 @@ This is a list of other contributors:<br
 ### Changes to the Code Base <a id="Code_1.4"></a>
 
 
-- ![add](/images/add.jpg)Added getter and setter for enabling/disabling comments in PSGenerator. Committed by JM. Thanks to Julien Aymé. See Issue [49250](http://issues.apache.org/bugzilla/show_bug.cgi?id=49250) .
+- ![add](/images/add.jpg)Added getter and setter for enabling/disabling comments in PSGenerator. Committed by JM. Thanks to Julien Aymé. See Issue [49250](http://issues.apache.org/bugzilla/show_bug.cgi?id=49250).
 
-- ![add](/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 [49056](http://issues.apache.org/bugzilla/show_bug.cgi?id=49056) .
+- ![add](/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 [49056](http://issues.apache.org/bugzilla/show_bug.cgi?id=49056).
 
-- ![add](/images/add.jpg)Added option to enable/disable the generation of compact vs. verbose PostScript code. Committed by JM. See Issue [48797](http://issues.apache.org/bugzilla/show_bug.cgi?id=48797) .
+- ![add](/images/add.jpg)Added option to enable/disable the generation of compact vs. verbose PostScript code. Committed by JM. See Issue [48797](http://issues.apache.org/bugzilla/show_bug.cgi?id=48797).
 
-- ![add](/images/add.jpg)Added shorthands for many PostScript commands to get more compact PostScript files. Committed by JM. Thanks to Calixte Denizet. See Issue [48797](http://issues.apache.org/bugzilla/show_bug.cgi?id=48797) .
+- ![add](/images/add.jpg)Added shorthands for many PostScript commands to get more compact PostScript files. Committed by JM. Thanks to Calixte Denizet. See Issue [48797](http://issues.apache.org/bugzilla/show_bug.cgi?id=48797).
 
-- ![add](/images/add.jpg)Added code for supporting the AdobeStandardCyrillic encoding. Committed by JM. Thanks to Andrey Koltunov. See Issue [48395](http://issues.apache.org/bugzilla/show_bug.cgi?id=48395) .
+- ![add](/images/add.jpg)Added code for supporting the AdobeStandardCyrillic encoding. Committed by JM. Thanks to Andrey Koltunov. See Issue [48395](http://issues.apache.org/bugzilla/show_bug.cgi?id=48395).
 
-- ![add](/images/add.jpg)Added interface for Color Conversions. Committed by CB. Thanks to Peter Hancock. See Issue [48237](http://issues.apache.org/bugzilla/show_bug.cgi?id=48237) .
+- ![add](/images/add.jpg)Added interface for Color Conversions. Committed by CB. Thanks to Peter Hancock. See Issue [48237](http://issues.apache.org/bugzilla/show_bug.cgi?id=48237).
 
 - ![add](/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.
 
-- ![add](/images/add.jpg)Enabled native encoding of CMYK images for PostScript output. Committed by JM. Thanks to Venkat Reddy. See Issue [48264](http://issues.apache.org/bugzilla/show_bug.cgi?id=48264) .
+- ![add](/images/add.jpg)Enabled native encoding of CMYK images for PostScript output. Committed by JM. Thanks to Venkat Reddy. See Issue [48264](http://issues.apache.org/bugzilla/show_bug.cgi?id=48264).
 
 - ![add](/images/add.jpg)Support loading of ICC Profiles from PNG and JPEG when used through ImageIO. Committed by MB.
 
 - ![add](/images/add.jpg)Added 60 seconds expiration for invalid URIs in the image cache to recover from temporarily unavailable images. Committed by JM.
 
-- ![add](/images/add.jpg)Added TexturePaint support for PSGraphics2D (PostScript tiling patterns). Committed by JM. Thanks to Jiří Kunhart. See Issue [46583](http://issues.apache.org/bugzilla/show_bug.cgi?id=46583) .
+- ![add](/images/add.jpg)Added TexturePaint support for PSGraphics2D (PostScript tiling patterns). Committed by JM. Thanks to Jiří Kunhart. See Issue [46583](http://issues.apache.org/bugzilla/show_bug.cgi?id=46583).
 
 - ![add](/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.
 
 - ![add](/images/add.jpg)Added RefinedImageFlavor to the image loading framework for better refinement of image flavors. Committed by JM.
 
-- ![fix](/images/fix.jpg)Two properties didn't get copied in copy constructor of PSState. Committed by JM. Thanks to Julien Aymé. See Issue [49364](http://issues.apache.org/bugzilla/show_bug.cgi?id=49364) .
+- ![fix](/images/fix.jpg)Two properties didn't get copied in copy constructor of PSState. Committed by JM. Thanks to Julien Aymé. See Issue [49364](http://issues.apache.org/bugzilla/show_bug.cgi?id=49364).
 
 - ![fix](/images/fix.jpg)Bugfix for detecting multi-strip CCITT-encoded TIFFs. Committed by JM.
 
@@ -92,19 +92,19 @@ This is a list of other contributors:<br
 
 - ![fix](/images/fix.jpg)Catching IllegalArgumentException in XMPSerializer when the Transformer implementation in use doesn't support the INDENT key. Committed by JM.
 
-- ![fix](/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 [46292](http://issues.apache.org/bugzilla/show_bug.cgi?id=46292) .
+- ![fix](/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 [46292](http://issues.apache.org/bugzilla/show_bug.cgi?id=46292).
 
-- ![fix](/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 [45789](http://issues.apache.org/bugzilla/show_bug.cgi?id=45789) .
+- ![fix](/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 [45789](http://issues.apache.org/bugzilla/show_bug.cgi?id=45789).
 
-- ![fix](/images/fix.jpg)JPEGPreloader: Fixed interpretation of JPEG resolution when "dots per centimeter" is specified. Committed by JM. See Issue [45835](http://issues.apache.org/bugzilla/show_bug.cgi?id=45835) .
+- ![fix](/images/fix.jpg)JPEGPreloader: Fixed interpretation of JPEG resolution when "dots per centimeter" is specified. Committed by JM. See Issue [45835](http://issues.apache.org/bugzilla/show_bug.cgi?id=45835).
 
 - ![fix](/images/fix.jpg)Bugfix: Added missing start/endPrefixMapping() calls when serializing XMP packets. Committed by JM.
 
-- ![update](/images/update.jpg)Optimization for PostScript state handling in (E)PSDocumentGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue [49339](http://issues.apache.org/bugzilla/show_bug.cgi?id=49339) .
+- ![update](/images/update.jpg)Optimization for PostScript state handling in (E)PSDocumentGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue [49339](http://issues.apache.org/bugzilla/show_bug.cgi?id=49339).
 
-- ![update](/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 [49338](http://issues.apache.org/bugzilla/show_bug.cgi?id=49338) .
+- ![update](/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 [49338](http://issues.apache.org/bugzilla/show_bug.cgi?id=49338).
 
-- ![update](/images/update.jpg)Moved method disableClipping from AbstractPSDocumentGraphics2D to PSGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue [49337](http://issues.apache.org/bugzilla/show_bug.cgi?id=49337) .
+- ![update](/images/update.jpg)Moved method disableClipping from AbstractPSDocumentGraphics2D to PSGraphics2D. Committed by JM. Thanks to Julien Aymé. See Issue [49337](http://issues.apache.org/bugzilla/show_bug.cgi?id=49337).
 
 ### Contributors to this release <a id="contributors_1.4"></a>
 
@@ -125,7 +125,7 @@ This is a list of other contributors:<br
 
 - ![add](/images/add.jpg)Added image processing hints to ignore an optionally embedded color profile in JPEG images. Committed by JM.
 
-- ![fix](/images/fix.jpg)Made file URLs with a host (as happens when using UNC paths) work when loading images. Committed by JM. See Issue [44902](http://issues.apache.org/bugzilla/show_bug.cgi?id=44902) .
+- ![fix](/images/fix.jpg)Made file URLs with a host (as happens when using UNC paths) work when loading images. Committed by JM. See Issue [44902](http://issues.apache.org/bugzilla/show_bug.cgi?id=44902).
 
 - ![fix](/images/fix.jpg)Bugfix for classpath resources: the code doesn't just check the system class loader anymore. Committed by MB.
 
@@ -154,7 +154,7 @@ This is a list of all people who partici
 ### Changes to the Code Base <a id="Code_1.3"></a>
 
 
-- ![add](/images/add.jpg)Image Loading: Support for passing in SAXSource instance. Committed by JM. Thanks to Adam Strzelecki. See Issue [44466](http://issues.apache.org/bugzilla/show_bug.cgi?id=44466) .
+- ![add](/images/add.jpg)Image Loading: Support for passing in SAXSource instance. Committed by JM. Thanks to Adam Strzelecki. See Issue [44466](http://issues.apache.org/bugzilla/show_bug.cgi?id=44466).
 
 - ![add](/images/add.jpg)The package org.apache.xmlgraphics.image.loader was added. It contains a general image loading framework for various image formats (bitmap & vector). Committed by JM.
 
@@ -162,9 +162,9 @@ This is a list of all people who partici
 
 - ![add](/images/add.jpg)PostScript: Added classes for "BoundingBox" DSC comments. Committed by JM.
 
-- ![add](/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 [42980](http://issues.apache.org/bugzilla/show_bug.cgi?id=42980) .
+- ![add](/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 [42980](http://issues.apache.org/bugzilla/show_bug.cgi?id=42980).
 
-- ![add](/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 [43069](http://issues.apache.org/bugzilla/show_bug.cgi?id=43069) .
+- ![add](/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 [43069](http://issues.apache.org/bugzilla/show_bug.cgi?id=43069).
 
 - ![fix](/images/fix.jpg)Bugfix for ISO 8601 date formatting with negative time zones in the XMP package. Committed by JM.
 
@@ -174,7 +174,7 @@ This is a list of all people who partici
 
 - ![fix](/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.
 
-- ![fix](/images/fix.jpg)Fixed a possible NPE in the TIFF codec (in the TIFFImage constructor). Committed by JM. Thanks to Sergey Orlov. See Issue [43120](http://issues.apache.org/bugzilla/show_bug.cgi?id=43120) .
+- ![fix](/images/fix.jpg)Fixed a possible NPE in the TIFF codec (in the TIFFImage constructor). Committed by JM. Thanks to Sergey Orlov. See Issue [43120](http://issues.apache.org/bugzilla/show_bug.cgi?id=43120).
 
 - ![update](/images/update.jpg)Support for Java 1.3 has been dropped. Java 1.4 or later is required now. Committed by JM.
 
@@ -193,7 +193,7 @@ This is a list of other contributors:<br
 ### Changes to the Code Base <a id="Code_1.2"></a>
 
 
-- ![add](/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 [42507](http://issues.apache.org/bugzilla/show_bug.cgi?id=42507) .
+- ![add](/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 [42507](http://issues.apache.org/bugzilla/show_bug.cgi?id=42507).
 
 - ![fix](/images/fix.jpg)Fixed literal text string escaping in PSGenerator. Some characters were not properly escaped. Committed by JM.
 

Modified: xmlgraphics/site/trunk/content/commons/download.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/commons/download.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/commons/download.mdtext (original)
+++ xmlgraphics/site/trunk/content/commons/download.mdtext Wed Dec  5 08:19:09 2012
@@ -5,7 +5,7 @@ Title: Download Apache&trade; XML Graphi
 
 ## Download a Release <a id="release"></a>
 
-Source ("-src") and binary ("-bin") distributions can be downloaded from a [Apache&trade; XML Graphics Commons Distribution Mirror](http://www.apache.org/dyn/closer.cgi/xmlgraphics/commons) .
+Source ("-src") and binary ("-bin") distributions can be downloaded from a [Apache&trade; XML Graphics Commons Distribution Mirror](http://www.apache.org/dyn/closer.cgi/xmlgraphics/commons).
 
 ## Download from Subversion <a id="svn"></a>
 

Modified: xmlgraphics/site/trunk/content/commons/image-loader.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/commons/image-loader.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/commons/image-loader.mdtext (original)
+++ xmlgraphics/site/trunk/content/commons/image-loader.mdtext Wed Dec  5 08:19:09 2012
@@ -5,7 +5,7 @@ Title: Apache(tm) XML Graphics Commons: 
 
 ## Overview <a id="overview"></a>
 
-Apache&trade; XML Graphics Commons contains a unified framework for loading and processing images (bitmap and vector). The package name is `org.apache.xmlgraphics.image.loader` . Key features:
+Apache&trade; XML Graphics Commons contains a unified framework for loading and processing images (bitmap and vector). The package name is `org.apache.xmlgraphics.image.loader`. Key features:
 
 
 - Unified basic API for all supported image types.
@@ -37,9 +37,9 @@ Apache&trade; XML Graphics Commons conta
 
 ### Setting up the manager <a id="manager-setup"></a>
 
-Before we can start to work with the package we need to set up the `ImageManager` . It provides convenience methods to load and convert images and holds the image cache.
+Before we can start to work with the package we need to set up the `ImageManager`. It provides convenience methods to load and convert images and holds the image cache.
 
-The `ImageManager` needs an `ImageContext` . This interface provides the `ImageManager` with important context and configuration data. Currently this is only the source resolution. The `ImageManager` and `ImageContext` are intended to be shared within an application.
+The `ImageManager` needs an `ImageContext`. This interface provides the `ImageManager` with important context and configuration data. Currently this is only the source resolution. The `ImageManager` and `ImageContext` are intended to be shared within an application.
 
     :::java
     import org.apache.xmlgraphics.image.loader.ImageContext;
@@ -55,7 +55,7 @@ The `ImageManager` needs an `ImageContex
 
 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 `ImageInfo` 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).
 
-Preloading is normally done through the `ImageManager` 's `getImageInfo()` method. For this operation an `ImageSessionContext` needs to be provided. It is responsible for supplying JAXP `Source` objects, URI resolution and providing other information needed for the image operations. In simple cases you can simply use `DefaultImageSessionContext` , but often you will want to write your own implementation of `ImageSessionContext` . In that case, it's recommended to subclass `AbstractImageSessionContext` which lets you avoid rewriting a lot of code for providing `Source` objects.
+Preloading is normally done through the `ImageManager` 's `getImageInfo()` method. For this operation an `ImageSessionContext` needs to be provided. It is responsible for supplying JAXP `Source` objects, URI resolution and providing other information needed for the image operations. In simple cases you can simply use `DefaultImageSessionContext`, but often you will want to write your own implementation of `ImageSessionContext`. In that case, it's recommended to subclass `AbstractImageSessionContext` which lets you avoid rewriting a lot of code for providing `Source` objects.
 
     :::java
     import org.apache.xmlgraphics.image.loader.ImageInfo;
@@ -70,7 +70,7 @@ Preloading is normally done through the 
 
 ## Loading an image <a id="loading"></a>
 
-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 `ImageFlavor` class. If you want the image as a bitmap image in memory, you could request an `ImageFlavor.RENDERED_IMAGE` . Again, the `ImageSessionContext` will be needed.
+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 `ImageFlavor` class. If you want the image as a bitmap image in memory, you could request an `ImageFlavor.RENDERED_IMAGE`. Again, the `ImageSessionContext` will be needed.
 
     :::java
     import org.apache.xmlgraphics.image.loader.Image;
@@ -84,11 +84,11 @@ Once the image is "preloaded", it can be
       RenderedImage ri = imageRend.getRenderedImage();
       //...and do anything with the RenderedImage
 
-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 `ImageSessionContext` .
+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 `ImageSessionContext`.
 
 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 `ImageConverter` implementation (see SPI section below). If the requested form of the image cannot be provided you will get an `ImageException` on which you'll have to react as needed.
 
-In [Apache FOP](http://xmlgraphics.apache.org/fop/) , 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:
+In [Apache FOP](http://xmlgraphics.apache.org/fop/), 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:
 
     :::java
     import org.apache.xmlgraphics.image.loader.Image;
@@ -112,22 +112,22 @@ In [Apache FOP](http://xmlgraphics.apach
         throw new IllegalStateException("Unexpected flavor");
     }
 
-  While each `BufferedImage` is also a `RenderedImage` , it can be more efficient to also specify `ImageFlavor.BUFFERED_IMAGE` in the flavor array.
+  While each `BufferedImage` is also a `RenderedImage`, it can be more efficient to also specify `ImageFlavor.BUFFERED_IMAGE` in the flavor array.
 # Tips & Tricks <a id="tipsntricks"></a>
 
 If you are loading bitmap images and you get an error like `"Cannot load image (no suitable loader/converter combination available) for
-        myimage.tif (image/tiff)` , you maybe be missing the necessary ImageIO codec to decode the image. A number of well-written codecs can be found in [JAI Image I/O Tools Project](https://jai-imageio.dev.java.net/) . 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.
+        myimage.tif (image/tiff)`, you maybe be missing the necessary ImageIO codec to decode the image. A number of well-written codecs can be found in [JAI Image I/O Tools Project](https://jai-imageio.dev.java.net/). 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.
 
 ## Service Provider Interface (SPI, Plug-ins) <a id="spi"></a>
 
 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:
 
 
--  `ImagePreloader` : detects the content type and preloads an image
+-  `ImagePreloader`: detects the content type and preloads an image
 
--  `ImageLoader` and `ImageLoaderFactory` : loads images
+-  `ImageLoader` and `ImageLoaderFactory`: loads images
 
--  `ImageConverter` : converts images from one representation into another
+-  `ImageConverter`: converts images from one representation into another
 
 If you plan to write an implementation of one of the above interfaces, please also take a look at the existing implementations for reference.
 
@@ -140,14 +140,14 @@ The first task is identifying whether th
 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 `ImagePreloader` implementations shall pass the loaded document to the respective `ImageLoader` through the custom objects that can be attached to the `ImageInfo` object. If the preloader loads the whole document, it shall close the given `Source` object (calling `ImageUtil.closeQuietly(Source)` ).
 
 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 `ImagePreloader` you will also need to implement the respective `ImageLoader/ImageLoaderFactory` , or vice versa.
+Normally, if you implement an `ImagePreloader` you will also need to implement the respective `ImageLoader/ImageLoaderFactory`, or vice versa.
 ## ImageLoader and ImageLoaderFactory <a id="ImageLoader"></a>
 
 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 `ImageLoader` 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.
 
 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.
 
-While the factory basically just provides information and creates new `ImageLoader` 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 `getTargetFlavor()` .
+While the factory basically just provides information and creates new `ImageLoader` 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 `getTargetFlavor()`.
 
 ### ImageConverter <a id="ImageConverter"></a>
 

Modified: xmlgraphics/site/trunk/content/commons/index.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/commons/index.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/commons/index.mdtext (original)
+++ xmlgraphics/site/trunk/content/commons/index.mdtext Wed Dec  5 08:19:09 2012
@@ -5,11 +5,11 @@ Title: Apache(tm) XML Graphics Commons
 
 ## Overview <a id="Overview"></a>
 
-Apache&trade; XML Graphics Commons is a library that consists of several reusable components used by [Apache Batik](http://xmlgraphics.apache.org/batik/) and [Apache FOP](http://xmlgraphics.apache.org/fop/) . 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 & PostScript files, and much more.
+Apache&trade; XML Graphics Commons is a library that consists of several reusable components used by [Apache Batik](http://xmlgraphics.apache.org/batik/) and [Apache FOP](http://xmlgraphics.apache.org/fop/). 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 & PostScript files, and much more.
 
 The Apache&trade; XML Graphics Commons project is part of the [Apache&trade;](http://www.apache.org) Software Foundation, which is a wider community of users and developers of open source projects.
 
-In the Wiki, we have a [Roadmap for Apache XML Graphics Commons](http://wiki.apache.org/xmlgraphics/XmlGraphicsCommonComponents) . This roadmap is the place to describe new ideas for the project.
+In the Wiki, we have a [Roadmap for Apache XML Graphics Commons](http://wiki.apache.org/xmlgraphics/XmlGraphicsCommonComponents). This roadmap is the place to describe new ideas for the project.
 
 ## Features <a id="features"></a>
 
@@ -29,7 +29,7 @@ Components which have been ported from [
 
 ## News <a id="News"></a>
 
-RSS Feed: [subproject-news-feed.rss](subproject-news-feed.rss) 
+RSS Feed: [subproject-news-feed.rss](subproject-news-feed.rss)
 
 ### 7 Jul 2010: Version 1.4 Released <a id="news-2010-07-07"></a>
 <item date="2010-07-07" title="Version 1.4 Released">

Modified: xmlgraphics/site/trunk/content/commons/postscript.mdtext
URL: http://svn.apache.org/viewvc/xmlgraphics/site/trunk/content/commons/postscript.mdtext?rev=1417307&r1=1417306&r2=1417307&view=diff
==============================================================================
--- xmlgraphics/site/trunk/content/commons/postscript.mdtext (original)
+++ xmlgraphics/site/trunk/content/commons/postscript.mdtext Wed Dec  5 08:19:09 2012
@@ -13,7 +13,7 @@ Apache&trade; XML Graphics Commons conta
 - Two Graphics2D implementations, one for plain PostScript and one for writing Encapsulated PostScript (EPS).
 
 - 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 [FOray project](http://foray.sourceforge.net) .
+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 [FOray project](http://foray.sourceforge.net).
 # The PostScript generator <a id="generator"></a>
 
 The "PSGenerator" class can help writing PostScript files. It deals with things like escaping, saving/tracking/restoring graphics state, writing DSC comments and tracking of DSC resources.
@@ -48,7 +48,7 @@ A complete example for generating an EPS
 
 ## DSC parser/processor <a id="dsc"></a>
 
-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 [Document Structuring Conventions](http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf) . 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.
+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 [Document Structuring Conventions](http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf). 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.
 
 The DSC support in Commons was primarily developed to implement resource optimization features in [Apache FOP](http://xmlgraphics.apache.org/fop/) '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.
 



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


Mime
View raw message