From b571bdc0e2cc31e7bdc7fef4ea9648f9b33329b5 Mon Sep 17 00:00:00 2001
From: Trustin Lee <trustin@gmail.com>
Date: Fri, 19 Sep 2008 07:28:48 +0000
Subject: [PATCH] * Updated to the latest version of jdocbook plugin and
 jbossorg styles * Writing the getting started chapter...

---
 pom.xml                      |  9 ++---
 src/docbook/module/start.xml | 78 +++++++++++++++++++++++++++++++++++-
 2 files changed, 81 insertions(+), 6 deletions(-)

diff --git a/pom.xml b/pom.xml
index 9d5a7855ce..bed385e660 100644
--- a/pom.xml
+++ b/pom.xml
@@ -316,7 +316,6 @@
       <plugin>
         <groupId>org.jboss.maven.plugins</groupId>
         <artifactId>maven-jdocbook-plugin</artifactId>
-        <version>2.0.0</version>
         <executions>
           <execution>
             <id>generate-docbook</id>
@@ -331,12 +330,12 @@
           <dependency>
             <groupId>org.jboss</groupId>
             <artifactId>jbossorg-docbook-xslt</artifactId>
-            <version>1.0.0</version>
+            <version>1.1.0</version>
           </dependency>
           <dependency>
             <groupId>org.jboss</groupId>
             <artifactId>jbossorg-jdocbook-style</artifactId>
-            <version>1.0.0</version>
+            <version>1.1.0</version>
             <type>jdocbook-style</type>
           </dependency>
         </dependencies>
@@ -352,12 +351,12 @@
           <formats>
             <format>
               <formatName>html</formatName>
-              <stylesheetResource>classpath:/xslt/org/jboss/main-html.xsl</stylesheetResource>
+              <stylesheetResource>classpath:/xslt/org/jboss/xhtml.xsl</stylesheetResource>
               <finalName>index.html</finalName>
             </format>
             <format>
               <formatName>html_single</formatName>
-              <stylesheetResource>classpath:/xslt/org/jboss/nochunk-html.xsl</stylesheetResource>
+              <stylesheetResource>classpath:/xslt/org/jboss/xhtml-single.xsl</stylesheetResource>
               <finalName>index.html</finalName>
             </format>
           </formats>
diff --git a/src/docbook/module/start.xml b/src/docbook/module/start.xml
index eff7b6cda6..3ab60a7700 100644
--- a/src/docbook/module/start.xml
+++ b/src/docbook/module/start.xml
@@ -2,5 +2,81 @@
 <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd">
 <chapter id="start">
   <title>Getting Started</title>
-  <para>To be written...</para>
+  <para>
+    This chapter tours around the core constructs of Netty with simple
+    examples to let you get started with Netty easily.  You should be able to
+    write a network application on top of Netty right away when you are at the
+    end of this chapter.
+  </para>
+  <para>
+    If you prefer the top-down approach in learning something, you might want
+    to start from <xref linkend="architecture"/> and get back here.
+  </para>
+  
+  <section>
+    <title>Minimum Requirement</title>
+    <para>
+      The minimum requirements to run the examples which are introduced in
+      this chapter are just two; the latest version of Netty release and JDK
+      1.5 or above.  The latest version of Netty is available in
+      <ulink url="http://www.jboss.org/netty/downloads.html">the project
+      download page</ulink>.  To get the right version of JDK, please refer to
+      your preferred JDK vendor's web site.  
+    </para>
+    <para>
+      Is that all?  To tell the truth, you should find these two are just
+      enough to implement almost any type of protocols.  Otherwise, please
+      feel free to
+      <ulink url="http://www.jboss.org/netty/community.html">contact the Netty
+      project team </ulink> and let us know what's missing.
+    </para>
+  </section>
+  
+  <section>
+    <title>Writing a Discard Server</title>
+    <para>
+      The most simplistic protocol in the world is not 'Hello, World!' but 
+      <ulink url="http://tools.ietf.org/html/rfc863">DISCARD</ulink>.  It's
+      a protocol which discards any received data without any response.
+    </para>
+    <para>
+      What you are supposed to do to implement the DISCARD protocol is to log
+      the received data, and that's all.  Let's start straight from the handler
+      implementation, which handles I/O events generated by Netty.
+    </para>
+    <programlistingco>
+      <areaspec>
+        <area id="example.discard.c1" coords="1" />
+      </areaspec>
+      <programlisting>package org.jboss.netty.example.discard;
+
+import org.jboss.netty.channel.ChannelHandlerContext;
+import org.jboss.netty.channel.ChannelPipelineCoverage;
+import org.jboss.netty.channel.ExceptionEvent;
+import org.jboss.netty.channel.MessageEvent;
+import org.jboss.netty.channel.SimpleChannelHandler;
+
+@ChannelPipelineCoverage("all")
+public class DiscardServerHandler extends SimpleChannelHandler {
+
+    @Override
+    public void messageReceived(ChannelHandlerContext ctx, MessageEvent e) {
+    }
+
+    @Override
+    public void exceptionCaught(ChannelHandlerContext ctx, ExceptionEvent e) {
+        e.getCause().printStackTrace();
+        e.getChannel().close();
+    }
+}</programlisting>
+      <calloutlist>
+        <callout arearefs="example.discard.c1">
+          <para>
+            TEST! 
+          </para>
+        </callout>
+      </calloutlist>
+    </programlistingco>
+  </section>
+    
 </chapter>