You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by ac...@apache.org on 2016/05/17 09:21:13 UTC
[1/4] camel git commit: Added camel-pdf docs to Gitbook
Repository: camel
Updated Branches:
refs/heads/master 473714e7d -> 027352f86
Added camel-pdf docs to Gitbook
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/a21e37b8
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/a21e37b8
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/a21e37b8
Branch: refs/heads/master
Commit: a21e37b80bbd1774e1f95d54cc7d51256a71e542
Parents: 473714e
Author: Andrea Cosentino <an...@gmail.com>
Authored: Tue May 17 11:04:27 2016 +0200
Committer: Andrea Cosentino <an...@gmail.com>
Committed: Tue May 17 11:04:27 2016 +0200
----------------------------------------------------------------------
components/camel-pdf/src/main/docs/pdf.adoc | 103 +++++++++++++++++++++++
docs/user-manual/en/SUMMARY.md | 1 +
2 files changed, 104 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/a21e37b8/components/camel-pdf/src/main/docs/pdf.adoc
----------------------------------------------------------------------
diff --git a/components/camel-pdf/src/main/docs/pdf.adoc b/components/camel-pdf/src/main/docs/pdf.adoc
new file mode 100644
index 0000000..7d6dd66
--- /dev/null
+++ b/components/camel-pdf/src/main/docs/pdf.adoc
@@ -0,0 +1,103 @@
+[[PDF-PDF]]
+PDF
+~~~
+
+**Available as of Camel 2.16.0**
+
+The *PDF*: components provides the ability to create, modify or extract
+content from PDF documents. This component uses
+https://pdfbox.apache.org/[Apache PDFBox] as underlying library to work
+with PDF documents.
+
+In order to use the PDF component, Maven users will need to add the
+following dependency to their�`pom.xml`:
+
+*pom.xml*
+
+[source,xml]
+------------------------------------------------------------
+<dependency>
+ <groupId>org.apache.camel</groupId>
+ <artifactId>camel-pdf</artifactId>
+ <version>x.x.x</version>
+ <!-- use the same version as your Camel core version -->
+</dependency>
+------------------------------------------------------------
+
+[[PDF-URIformat]]
+URI format
+^^^^^^^^^^
+
+The PDF component only supports producer endpoints.
+
+[source,java]
+-----------------------
+pdf:operation[?options]
+-----------------------
+
+[[PDF-Options]]
+Options
+^^^^^^^
+
+// component options: START
+The PDF component has no options.
+// component options: END
+
+
+
+// endpoint options: START
+The PDF component supports 11 endpoint options which are listed below:
+
+{% raw %}
+[width="100%",cols="2s,1,1m,1m,5",options="header"]
+|=======================================================================
+| Name | Group | Default | Java Type | Description
+| operation | producer | | PdfOperation | *Required* Operation type
+| font | producer | Helvetica | PDFont | Font
+| fontSize | producer | 14 | float | Font size in pixels
+| marginBottom | producer | 20 | int | Margin bottom in pixels
+| marginLeft | producer | 20 | int | Margin left in pixels
+| marginRight | producer | 40 | int | Margin right in pixels
+| marginTop | producer | 20 | int | Margin top in pixels
+| pageSize | producer | PAGE_SIZE_A4 | PDRectangle | Page size
+| textProcessingFactory | producer | lineTermination | TextProcessingFactory | Text processing to use. autoFormatting: Text is getting sliced by words then max amount of words that fits in the line will be written into pdf document. With this strategy all words that doesn't fit in the line will be moved to the new line. lineTermination: Builds set of classes for line-termination writing strategy. Text getting sliced by line termination symbol and then it will be written regardless it fits in the line or not.
+| exchangePattern | advanced | InOnly | ExchangePattern | Sets the default exchange pattern when creating an exchange
+| synchronous | advanced | false | boolean | Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported).
+|=======================================================================
+{% endraw %}
+// endpoint options: END
+
+
+[[PDF-Headers]]
+Headers
+^^^^^^^
+[width="100%",cols="10%,90%",options="header",]
+|=======================================================================
+|Header |Description
+
+|`pdf-document` |*Mandatory* header for `append` operation and ignored in all other
+operations. Expected type is
+https://pdfbox.apache.org/docs/1.8.9/javadocs/org/apache/pdfbox/pdmodel/PDDocument.html[PDDocument].
+Stores PDF document which will be used for append operation.
+
+|`protection-policy` |Expected type
+ishttps://pdfbox.apache.org/docs/1.8.9/javadocs/org/apache/pdfbox/pdmodel/encryption/ProtectionPolicy.html[ProtectionPolicy].
+If specified then PDF document will be encrypted with it.
+
+|`decryption-material` |Expected type
+ishttps://pdfbox.apache.org/docs/1.8.9/javadocs/org/apache/pdfbox/pdmodel/encryption/DecryptionMaterial.html[DecryptionMaterial].
+*Mandatory* header if PDF document is encrypted.
+|=======================================================================
+
+[[PDF-SeeAlso]]
+See Also
+^^^^^^^^
+
+* link:configuring-camel.html[Configuring Camel]
+* link:component.html[Component]
+* link:endpoint.html[Endpoint]
+* link:getting-started.html[Getting Started]
+
+-
+�
+-
http://git-wip-us.apache.org/repos/asf/camel/blob/a21e37b8/docs/user-manual/en/SUMMARY.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 6670d3a..91b1b29 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -214,6 +214,7 @@
* [Optaplanner](optaplanner.adoc)
* [Paho](paho.adoc)
* [Paxlogging](paxlogging.adoc)
+ * [PDF](pdf.adoc)
* [Properties](properties.adoc)
* [Quickfix](quickfix.adoc)
* [Scp](scp.adoc)
[4/4] camel git commit: Added camel-protobuf docs to Gitbook
Posted by ac...@apache.org.
Added camel-protobuf docs to Gitbook
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/027352f8
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/027352f8
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/027352f8
Branch: refs/heads/master
Commit: 027352f86fb3d92895d7d33dcce5d10c45492565
Parents: e267008
Author: Andrea Cosentino <an...@gmail.com>
Authored: Tue May 17 11:20:11 2016 +0200
Committer: Andrea Cosentino <an...@gmail.com>
Committed: Tue May 17 11:20:11 2016 +0200
----------------------------------------------------------------------
.../camel-protobuf/src/main/docs/protobuf.adoc | 160 +++++++++++++++++++
docs/user-manual/en/SUMMARY.md | 1 +
2 files changed, 161 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/027352f8/components/camel-protobuf/src/main/docs/protobuf.adoc
----------------------------------------------------------------------
diff --git a/components/camel-protobuf/src/main/docs/protobuf.adoc b/components/camel-protobuf/src/main/docs/protobuf.adoc
new file mode 100644
index 0000000..ea8ec7a
--- /dev/null
+++ b/components/camel-protobuf/src/main/docs/protobuf.adoc
@@ -0,0 +1,160 @@
+[[Protobuf-Protobuf-ProtocolBuffers]]
+Protobuf - Protocol Buffers
+---------------------------
+
+"Protocol Buffers - Google's data interchange format"
+
+INFO: Available from Camel 2.2
+
+Camel provides a link:data-format.html[Data Format] to serialse between
+Java and the Protocol Buffer protocol. The project's site details why
+you may wish to
+http://code.google.com/apis/protocolbuffers/docs/overview.html[choose
+this format over xml]. Protocol Buffer is language-neutral and
+platform-neutral, so messages produced by your Camel routes may be
+consumed by other language implementations.
+
+http://code.google.com/apis/protocolbuffers/[API Site] +
+ http://code.google.com/p/protobuf/[Protobuf Implementation] +
+
+http://code.google.com/apis/protocolbuffers/docs/javatutorial.html[Protobuf
+Java Tutorial]
+
+[[Protobuf-Protobufoverview]]
+Protobuf overview
+~~~~~~~~~~~~~~~~~
+
+This quick overview of how to use Protobuf. For more detail see the
+http://code.google.com/apis/protocolbuffers/docs/javatutorial.html[complete
+tutorial]
+
+[[Protobuf-Definingtheprotoformat]]
+Defining the proto format
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The first step is to define the format for the body of your exchange.
+This is defined in a .proto file as so:
+
+*addressbook.proto*
+
+[source,java]
+------------------------------------------------------------
+
+package org.apache.camel.component.protobuf;
+
+option java_package = "org.apache.camel.component.protobuf";
+option java_outer_classname = "AddressBookProtos";
+
+message Person {
+ required string name = 1;
+ required int32 id = 2;
+ optional string email = 3;
+
+ enum PhoneType {
+ MOBILE = 0;
+ HOME = 1;
+ WORK = 2;
+ }
+
+ message PhoneNumber {
+ required string number = 1;
+ optional PhoneType type = 2 [default = HOME];
+ }
+
+ repeated PhoneNumber phone = 4;
+}
+
+message AddressBook {
+ repeated Person person = 1;
+}
+------------------------------------------------------------
+
+[[Protobuf-GeneratingJavaclasses]]
+Generating Java classes
+^^^^^^^^^^^^^^^^^^^^^^^
+
+The Protobuf SDK provides a compiler which will generate the Java
+classes for the format we defined in our .proto file. You can run the
+compiler for any additional supported languages you require.
+
+`protoc --java_out=. ./addressbook.proto`
+
+This will generate a single Java class named AddressBookProtos which
+contains inner classes for Person and AddressBook. Builders are also
+implemented for you. The generated classes implement
+com.google.protobuf.Message which is required by the serialisation
+mechanism. For this reason it important that only these classes are used
+in the body of your exchanges. Camel will throw an exception on route
+creation if you attempt to tell the link:data-format.html[Data Format]
+to use a class that does not implement com.google.protobuf.Message. Use
+the generated builders to translate the data from any of your existing
+domain classes.
+
+[[Protobuf-JavaDSL]]
+Java DSL
+~~~~~~~~
+
+You can use create the ProtobufDataFormat instance and pass it to Camel
+DataFormat marshal and unmarsha API like this.
+
+[source,java]
+-----------------------------------------------------------------------------------
+ ProtobufDataFormat format = new ProtobufDataFormat(Person.getDefaultInstance());
+
+ from("direct:in").marshal(format);
+ from("direct:back").unmarshal(format).to("mock:reverse");
+-----------------------------------------------------------------------------------
+
+Or use the DSL protobuf() passing the unmarshal default instance or
+default instance class name like this.
+
+[source,java]
+--------------------------------------------------------------------------------------------------
+ // You don't need to specify the default instance for protobuf marshaling
+ from("direct:marshal").marshal().protobuf();
+ from("direct:unmarshalA").unmarshal().
+ protobuf("org.apache.camel.dataformat.protobuf.generated.AddressBookProtos$Person").
+ to ("mock:reverse");
+
+ from("direct:unmarshalB").unmarshal().protobuf(Person.getDefaultInstance()).to("mock:reverse");
+--------------------------------------------------------------------------------------------------
+
+[[Protobuf-SpringDSL]]
+Spring DSL
+~~~~~~~~~~
+
+The following example shows how to use Castor to unmarshal using Spring
+configuring the protobuf data type
+
+[source,java]
+----------------------------------------------------------------------------------------------------------
+<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
+ <route>
+ <from uri="direct:start"/>
+ <unmarshal>
+ <protobuf instanceClass="org.apache.camel.dataformat.protobuf.generated.AddressBookProtos$Person" />
+ </unmarshal>
+ <to uri="mock:result"/>
+ </route>
+</camelContext>
+----------------------------------------------------------------------------------------------------------
+
+[[Protobuf-Dependencies]]
+Dependencies
+^^^^^^^^^^^^
+
+To use Protobuf in your camel routes you need to add the a dependency on
+*camel-protobuf* which implements this data format.
+
+If you use maven you could just add the following to your pom.xml,
+substituting the version number for the latest & greatest release (see
+link:download.html[the download page for the latest versions]).
+
+[source,java]
+-----------------------------------------
+<dependency>
+ <groupId>org.apache.camel</groupId>
+ <artifactId>camel-protobuf</artifactId>
+ <version>2.2.0</version>
+</dependency>
+-----------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/027352f8/docs/user-manual/en/SUMMARY.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 82d12f3..93fcdf0 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -244,6 +244,7 @@
* [Jaxb](jaxb.adoc)
* [Jibx](jibx.adoc)
* [Lzf](lzf.adoc)
+ * [Protobuf](protobuf.adoc)
* [XML JSON](xmljson.adoc)
* User Guide
[2/4] camel git commit: Added camel-pgevent docs to Gitbook
Posted by ac...@apache.org.
Added camel-pgevent docs to Gitbook
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/a7afc19e
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/a7afc19e
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/a7afc19e
Branch: refs/heads/master
Commit: a7afc19e501835f7ac116f4d1685b686e72b0a0d
Parents: a21e37b
Author: Andrea Cosentino <an...@gmail.com>
Authored: Tue May 17 11:11:13 2016 +0200
Committer: Andrea Cosentino <an...@gmail.com>
Committed: Tue May 17 11:11:13 2016 +0200
----------------------------------------------------------------------
.../camel-pgevent/src/main/docs/pgevent.adoc | 78 ++++++++++++++++++++
docs/user-manual/en/SUMMARY.md | 1 +
2 files changed, 79 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/a7afc19e/components/camel-pgevent/src/main/docs/pgevent.adoc
----------------------------------------------------------------------
diff --git a/components/camel-pgevent/src/main/docs/pgevent.adoc b/components/camel-pgevent/src/main/docs/pgevent.adoc
new file mode 100644
index 0000000..a0fa19d
--- /dev/null
+++ b/components/camel-pgevent/src/main/docs/pgevent.adoc
@@ -0,0 +1,78 @@
+[[PGEvent-PGEventComponentPostgresSQLEvent]]
+PGEvent Component (PostgresSQL Event)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+This is a component for Apache Camel which allows for
+Producing/Consuming PostgreSQL events related to the LISTEN/NOTIFY
+commands added since PostgreSQL 8.3.
+
+Maven users will need to add the following dependency to their `pom.xml`
+for this component:
+
+[source,xml]
+------------------------------------------------------------
+<dependency>
+ <groupId>org.apache.camel</groupId>
+ <artifactId>camel-pgevent</artifactId>
+ <version>x.x.x</version>
+ <!-- use the same version as your Camel core version -->
+</dependency>
+------------------------------------------------------------
+
+URI format
+
+The pgevent component uses the following two styles of endpoint URI
+notation:
+
+[source,java]
+-------------------------------------------------
+pgevent:datasource[?parameters]
+pgevent://host:port/database/channel[?parameters]
+-------------------------------------------------
+
+You can append query options to the URI in the following format,
+`?option=value&option=value&...`
+
+[[PGEvent-Options]]
+Options
+^^^^^^^
+
+
+// component options: START
+The PostgresSQL Event component has no options.
+// component options: END
+
+
+
+// endpoint options: START
+The PostgresSQL Event component supports 11 endpoint options which are listed below:
+
+{% raw %}
+[width="100%",cols="2s,1,1m,1m,5",options="header"]
+|=======================================================================
+| Name | Group | Default | Java Type | Description
+| host | common | localhost | String | To connect using hostname and port to the database.
+| port | common | 5432 | Integer | To connect using hostname and port to the database.
+| database | common | | String | *Required* The database name
+| channel | common | | String | *Required* The channel name
+| datasource | common | | DataSource | To connect using the given javax.sql.DataSource instead of using hostname and port.
+| pass | common | | String | Password for login
+| user | common | postgres | String | Username for login
+| bridgeErrorHandler | consumer | false | boolean | Allows for bridging the consumer to the Camel routing Error Handler which mean any exceptions occurred while the consumer is trying to pickup incoming messages or the likes will now be processed as a message and handled by the routing Error Handler. By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions that will be logged at WARN/ERROR level and ignored.
+| exceptionHandler | consumer (advanced) | | ExceptionHandler | To let the consumer use a custom ExceptionHandler. Notice if the option bridgeErrorHandler is enabled then this options is not in use. By default the consumer will deal with exceptions that will be logged at WARN/ERROR level and ignored.
+| exchangePattern | advanced | InOnly | ExchangePattern | Sets the default exchange pattern when creating an exchange
+| synchronous | advanced | false | boolean | Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported).
+|=======================================================================
+{% endraw %}
+// endpoint options: END
+
+
+[[PGEvent-SeeAlso]]
+See Also
+^^^^^^^^
+
+* link:configuring-camel.html[Configuring Camel]
+* link:component.html[Component]
+* link:endpoint.html[Endpoint]
+* link:getting-started.html[Getting Started]
+
http://git-wip-us.apache.org/repos/asf/camel/blob/a7afc19e/docs/user-manual/en/SUMMARY.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 91b1b29..2ee7085 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -215,6 +215,7 @@
* [Paho](paho.adoc)
* [Paxlogging](paxlogging.adoc)
* [PDF](pdf.adoc)
+ * [PGEvent](pgevent.adoc)
* [Properties](properties.adoc)
* [Quickfix](quickfix.adoc)
* [Scp](scp.adoc)
[3/4] camel git commit: Added camel-printer docs to Gitbook
Posted by ac...@apache.org.
Added camel-printer docs to Gitbook
Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/e267008a
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/e267008a
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/e267008a
Branch: refs/heads/master
Commit: e267008a5be0453cc50cc8a9015bcbce1b56434f
Parents: a7afc19
Author: Andrea Cosentino <an...@gmail.com>
Authored: Tue May 17 11:15:54 2016 +0200
Committer: Andrea Cosentino <an...@gmail.com>
Committed: Tue May 17 11:15:54 2016 +0200
----------------------------------------------------------------------
components/camel-printer/src/main/docs/lpr.adoc | 151 +++++++++++++++++++
docs/user-manual/en/SUMMARY.md | 1 +
2 files changed, 152 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/e267008a/components/camel-printer/src/main/docs/lpr.adoc
----------------------------------------------------------------------
diff --git a/components/camel-printer/src/main/docs/lpr.adoc b/components/camel-printer/src/main/docs/lpr.adoc
new file mode 100644
index 0000000..e7f3078
--- /dev/null
+++ b/components/camel-printer/src/main/docs/lpr.adoc
@@ -0,0 +1,151 @@
+[[Printer-PrinterComponent]]
+Printer Component
+~~~~~~~~~~~~~~~~~
+
+*Available as of Camel 2.1*
+
+The *printer* component provides a way to direct payloads on a route to
+a printer. Obviously the payload has to be a formatted piece of payload
+in order for the component to appropriately print it. The objective is
+to be able to direct specific payloads as jobs to a line printer in a
+camel flow.
+
+This component only supports a camel producer endpoint.
+
+The functionality allows for the payload to be printed on a default
+printer, named local, remote or wirelessly linked printer using the
+javax printing API under the covers.
+
+Maven users will need to add the following dependency to their `pom.xml`
+for this component:
+
+[source,xml]
+------------------------------------------------------------
+<dependency>
+ <groupId>org.apache.camel</groupId>
+ <artifactId>camel-printer</artifactId>
+ <version>x.x.x</version>
+ <!-- use the same version as your Camel core version -->
+</dependency>
+------------------------------------------------------------
+
+[[Printer-URIformat]]
+URI format
+^^^^^^^^^^
+
+Since the URI scheme for a printer has not been standardized (the
+nearest thing to a standard being the IETF print standard) and therefore
+not uniformly applied by vendors, we have chosen *"lpr"* as the scheme.
+
+[source,java]
+-----------------------------------------------
+lpr://localhost/default[?options]
+lpr://remotehost:port/path/to/printer[?options]
+-----------------------------------------------
+
+You can append query options to the URI in the following format,
+`?option=value&option=value&...`
+
+[[Printer-Options]]
+Options
+^^^^^^^
+
+
+// component options: START
+The Printer component has no options.
+// component options: END
+
+
+
+// endpoint options: START
+The Printer component supports 15 endpoint options which are listed below:
+
+{% raw %}
+[width="100%",cols="2s,1,1m,1m,5",options="header"]
+|=======================================================================
+| Name | Group | Default | Java Type | Description
+| hostname | producer | | String | *Required* Hostname of the printer
+| port | producer | | int | Port number of the printer
+| printername | producer | | String | Name of the printer
+| copies | producer | 1 | int | Number of copies to print
+| docFlavor | producer | | DocFlavor | Sets DocFlavor to use.
+| flavor | producer | | String | Sets DocFlavor to use.
+| mediaSize | producer | na-letter | String | Sets the stationary as defined by enumeration names in the javax.print.attribute.standard.MediaSizeName API. The default setting is to use North American Letter sized stationary. The value's case is ignored e.g. values of iso_a4 and ISO_A4 may be used.
+| mediaTray | producer | | String | Sets MediaTray supported by the javax.print.DocFlavor API for example uppermiddle etc.
+| mimeType | producer | | String | Sets mimeTypes supported by the javax.print.DocFlavor API
+| orientation | producer | portrait | String | Sets the page orientation.
+| printerPrefix | producer | | String | Sets the prefix name of the printer it is useful when the printer name does not start with //hostname/printer
+| sendToPrinter | producer | true | boolean | etting this option to false prevents sending of the print data to the printer
+| sides | producer | one-sided | String | Sets one sided or two sided printing based on the javax.print.attribute.standard.Sides API
+| exchangePattern | advanced | InOnly | ExchangePattern | Sets the default exchange pattern when creating an exchange
+| synchronous | advanced | false | boolean | Sets whether synchronous processing should be strictly used or Camel is allowed to use asynchronous processing (if supported).
+|=======================================================================
+{% endraw %}
+// endpoint options: END
+
+
+[[Printer-SendingMessagestoaPrinter]]
+Sending Messages to a Printer
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+[[Printer-PrinterProducer]]
+Printer Producer
+++++++++++++++++
+
+Sending data to the printer is very straightforward and involves
+creating a producer endpoint that can be sent message exchanges on in
+route.
+
+[[Printer-UsageSamples]]
+Usage Samples
+^^^^^^^^^^^^^
+
+[[Printer-Example1:PrintingtextbasedpayloadsonaDefaultprinterusingletterstationaryandone-sidedmode]]
+Example 1: Printing text based payloads on a Default printer using letter stationary and one-sided mode
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+[source,java]
+-----------------------------------------------
+RouteBuilder builder = new RouteBuilder() {
+ public void configure() {
+ from(file://inputdir/?delete=true)
+ .to("lpr://localhost/default?copies=2" +
+ "&flavor=DocFlavor.INPUT_STREAM&" +
+ "&mimeType=AUTOSENSE" +
+ "&mediaSize=NA_LETTER" +
+ "&sides=one-sided")
+ }};
+-----------------------------------------------
+
+[[Printer-Example2:PrintingGIFbasedpayloadsonaRemoteprinterusingA4stationaryandone-sidedmode]]
+Example 2: Printing GIF based payloads on a Remote printer using A4 stationary and one-sided mode
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+[source,java]
+--------------------------------------------------
+RouteBuilder builder = new RouteBuilder() {
+ public void configure() {
+ from(file://inputdir/?delete=true)
+ .to("lpr://remotehost/sales/salesprinter" +
+ "?copies=2&sides=one-sided" +
+ "&mimeType=GIF&mediaSize=ISO_A4" +
+ "&flavor=DocFlavor.INPUT_STREAM")
+ }};
+--------------------------------------------------
+
+[[Printer-Example3:PrintingJPEGbasedpayloadsonaRemoteprinterusingJapanesePostcardstationaryandone-sidedmode]]
+Example 3: Printing JPEG based payloads on a Remote printer using Japanese Postcard stationary and one-sided mode
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+[source,java]
+--------------------------------------------------
+RouteBuilder builder = new RouteBuilder() {
+ public void configure() {
+ from(file://inputdir/?delete=true)
+ .to("lpr://remotehost/sales/salesprinter" +
+ "?copies=2&sides=one-sided" +
+ "&mimeType=JPEG" +
+ "&mediaSize=JAPANESE_POSTCARD" +
+ "&flavor=DocFlavor.INPUT_STREAM")
+ }};
+--------------------------------------------------
http://git-wip-us.apache.org/repos/asf/camel/blob/e267008a/docs/user-manual/en/SUMMARY.md
----------------------------------------------------------------------
diff --git a/docs/user-manual/en/SUMMARY.md b/docs/user-manual/en/SUMMARY.md
index 2ee7085..82d12f3 100644
--- a/docs/user-manual/en/SUMMARY.md
+++ b/docs/user-manual/en/SUMMARY.md
@@ -216,6 +216,7 @@
* [Paxlogging](paxlogging.adoc)
* [PDF](pdf.adoc)
* [PGEvent](pgevent.adoc)
+ * [Printer](lpr.adoc)
* [Properties](properties.adoc)
* [Quickfix](quickfix.adoc)
* [Scp](scp.adoc)