You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by so...@apache.org on 2014/02/27 01:08:16 UTC

[18/58] [abbrv] Doc: Update po files

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/getting-started/a-simple-plugin.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/getting-started/a-simple-plugin.en.po b/doc/locale/ja/LC_MESSAGES/sdk/getting-started/a-simple-plugin.en.po
index 754f4ef..e71db54 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/getting-started/a-simple-plugin.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/getting-started/a-simple-plugin.en.po
@@ -93,11 +93,11 @@ msgid ""
 "file."
 msgstr ""
 
-#: ../../sdk/getting-started/a-simple-plugin.en.rst:81
+#: ../../sdk/getting-started/a-simple-plugin.en.rst:83
 msgid "Specify the Plugin's Location"
 msgstr ""
 
-#: ../../sdk/getting-started/a-simple-plugin.en.rst:83
+#: ../../sdk/getting-started/a-simple-plugin.en.rst:85
 msgid ""
 "All plugins must be located in the directory specified by the configuration "
 "variable ``proxy.config.plugin.plugin_dir``, which is located in the :file:"
@@ -105,7 +105,7 @@ msgid ""
 "relative path."
 msgstr ""
 
-#: ../../sdk/getting-started/a-simple-plugin.en.rst:88
+#: ../../sdk/getting-started/a-simple-plugin.en.rst:90
 msgid ""
 "If a relative path is used, then the starting directory will be the Traffic "
 "Server installation directory as specified in ``/etc/traffic_server``. The "
@@ -115,17 +115,17 @@ msgid ""
 "the directory you've configured."
 msgstr ""
 
-#: ../../sdk/getting-started/a-simple-plugin.en.rst:96
+#: ../../sdk/getting-started/a-simple-plugin.en.rst:98
 msgid "Restart Traffic Server"
 msgstr ""
 
-#: ../../sdk/getting-started/a-simple-plugin.en.rst:98
+#: ../../sdk/getting-started/a-simple-plugin.en.rst:100
 msgid ""
 "The last step is to start/restart Traffic Server. Shown below is the output "
 "displayed after you've created and loaded your ``hello-world`` plugin."
 msgstr ""
 
-#: ../../sdk/getting-started/a-simple-plugin.en.rst:114
+#: ../../sdk/getting-started/a-simple-plugin.en.rst:116
 msgid ""
 "**Note:** in the example above, Traffic Server notes are directed to the "
 "console by specifying ``E`` for ``proxy.config.diags.output.note`` in :file:"

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/getting-started/plugin-registration-and-version-checking.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/getting-started/plugin-registration-and-version-checking.en.po b/doc/locale/ja/LC_MESSAGES/sdk/getting-started/plugin-registration-and-version-checking.en.po
index 01b60e1..ee1de00 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/getting-started/plugin-registration-and-version-checking.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/getting-started/plugin-registration-and-version-checking.en.po
@@ -25,20 +25,20 @@ msgstr ""
 msgid "Use the following interfaces:"
 msgstr ""
 
-#: ../../sdk/getting-started/plugin-registration-and-version-checking.en.rst:26
+#: ../../sdk/getting-started/plugin-registration-and-version-checking.en.rst:29
 msgid ""
-"```TSPluginRegister`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
-"html#a6d7f514e70abaf097c4a3f1ba01f6df8>`__"
+"The following version of ``hello-world`` registers the plugin and ensures "
+"it's running with a compatible version of Traffic Server."
 msgstr ""
 
-#: ../../sdk/getting-started/plugin-registration-and-version-checking.en.rst:27
+#: ../../sdk/getting-started/plugin-registration-and-version-checking.en.rst:26
 msgid ""
-"```TSTrafficServerVersionGet`` <http://people.apache.org/~amc/ats/doc/html/"
-"InkAPI_8cc.html#a3ef91e01612ffdce6dd040f836db08e8>`__"
+"`TSPluginRegister <http://people.apache.org/~amc/ats/doc/html/ts_8h."
+"html#a6d7f514e70abaf097c4a3f1ba01f6df8>`_"
 msgstr ""
 
-#: ../../sdk/getting-started/plugin-registration-and-version-checking.en.rst:29
+#: ../../sdk/getting-started/plugin-registration-and-version-checking.en.rst:27
 msgid ""
-"The following version of ``hello-world`` registers the plugin and ensures "
-"it's running with a compatible version of Traffic Server."
+"`TSTrafficServerVersionGet <http://people.apache.org/~amc/ats/doc/html/"
+"InkAPI_8cc.html#a3ef91e01612ffdce6dd040f836db08e8>`_"
 msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/header-based-plugin-examples/blacklist-plugin.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/header-based-plugin-examples/blacklist-plugin.en.po b/doc/locale/ja/LC_MESSAGES/sdk/header-based-plugin-examples/blacklist-plugin.en.po
index 7e5bbb7..b168412 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/header-based-plugin-examples/blacklist-plugin.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/header-based-plugin-examples/blacklist-plugin.en.po
@@ -24,22 +24,11 @@ msgid ""
 "to the client."
 msgstr ""
 
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:27
-msgid ""
-"The flow of HTTP processing with the blacklist plugin is illustrated in the "
-"figure titled `\"Blacklist Plugin\" <../../how-to-create-trafficserver-"
-"plugins#BlacklistPlugin>`__. This example also contains a simple "
-"configuration management interface. It can read a list of blacklisted sites "
-"from a file (``blacklist.txt``) that can be updated by a Traffic Server "
-"administrator. When the configuration file is updated, Traffic Server sends "
-"an event to the plugin that wakes it up to do some work."
-msgstr ""
-
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:37
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:36
 msgid "Creating the Parent Continuation"
 msgstr ""
 
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:39
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:38
 msgid ""
 "You create the static parent continuation in the mandatory ``TSPluginInit`` "
 "function. This parent continuation effectively **is** the plugin: the "
@@ -49,7 +38,7 @@ msgid ""
 "create and specify their handler functions."
 msgstr ""
 
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:46
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:45
 msgid ""
 "You can specify an optional mutex lock when you create continuations. The "
 "mutex lock protects data shared by asynchronous processes. Because Traffic "
@@ -57,13 +46,7 @@ msgid ""
 "threads try to access the same continuation's data."
 msgstr ""
 
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:51
-msgid ""
-"Here is how the static parent continuation is created in :file:blacklist-1."
-"c`:"
-msgstr ""
-
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:66
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:65
 msgid ""
 "The handler function for the plugin is ``blacklist_plugin``, and the mutex "
 "is null. The continuation handler function's job is to handle the events "
@@ -72,13 +55,28 @@ msgid ""
 "it:"
 msgstr ""
 
-#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:92
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:27
+msgid ""
+"The flow of HTTP processing with the blacklist plugin is illustrated in the "
+"figure titled :ref:`BlackListPlugin`. This example also contains a simple "
+"configuration management interface. It can read a list of blacklisted sites "
+"from a file (``blacklist.txt``) that can be updated by a Traffic Server "
+"administrator. When the configuration file is updated, Traffic Server sends "
+"an event to the plugin that wakes it up to do some work."
+msgstr ""
+
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:50
+msgid ""
+"Here is how the static parent continuation is created in ``blacklist-1.c``:"
+msgstr ""
+
+#: ../../sdk/header-based-plugin-examples/blacklist-plugin.en.rst:91
 msgid ""
 "When you write handler functions, you have to anticipate any events that "
 "might be sent to the handler by hooks or by other functions. In the "
 "Blacklist plugin, ``TS_EVENT_OS_DNS`` is sent because of the global hook "
 "established in ``TSPluginInit``, ``TS_EVENT_HTTP_SEND_RESPONSE_HDR`` is "
-"sent because the plugin contains a transaction hook (see `Setting Up a "
-"Transaction Hook <setting-a-transaction-hook.html>`__). It is good practice "
-"to have a default case in your switch statements."
+"sent because the plugin contains a transaction hook (see :doc:`blacklist-"
+"plugin/setting-up-a-transaction-hook.en`). It is good practice to have a "
+"default case in your switch statements."
 msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins.en.po b/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins.en.po
index 1a330ca..5d3b555 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins.en.po
@@ -41,12 +41,6 @@ msgid ""
 "processing."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:42
-msgid ""
-"A `roadmap for writing plugins <roadmap-for-creating-plugins>`__, with an "
-"overview of the functionality provided by the Traffic Server API."
-msgstr ""
-
 #: ../../sdk/how-to-create-trafficserver-plugins.en.rst:47
 msgid "The Asynchronous Event Model"
 msgstr ""
@@ -89,30 +83,11 @@ msgid ""
 "continuations."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:74
-msgid ""
-"Continuation objects are used throughout Traffic Server. Some might live "
-"for the duration of the Traffic Server process, while others are created "
-"(perhaps by other continuations) for specific needs and then destroyed. "
-"`Traffic Server Internals <#TSInternals>`__ (below) shows how the major "
-"components of Traffic Server interact. Traffic Server has several "
-"**processors**, such as *cache processor* and *net processor*, that "
-"consolidate cache or network I/O tasks. Processors talk to the event system "
-"and schedule work on threads. An executing thread calls back a continuation "
-"by sending it an event. When a continuation receives an event, it wakes up, "
-"does some work, and either destroys itself or goes back to sleep & waits "
-"for the next event."
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:86
-msgid "**Traffic Server Internals** {#TSInternals}"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:91
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:93
 msgid "Traffic Server Internals"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:93
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:95
 msgid ""
 "Plugins are typically implemented as continuations. All of the sample code "
 "plugins (except ``hello-world``) are continuations that are created when "
@@ -120,15 +95,11 @@ msgid ""
 "activity."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:98
-msgid "**Traffic Server with Plugins** {#TSwithPlugins}"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:103
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:107
 msgid "Traffic Server with Plugins"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:105
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:109
 msgid ""
 "A plugin may consist of just one static continuation that is called "
 "whenever certain events happen. Examples of such plugins include "
@@ -145,7 +116,7 @@ msgid ""
 "each protocol transaction."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:119
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:123
 msgid ""
 "When you write plugins, there are several ways to send events to "
 "continuations. For HTTP plugins, there is a \"hook\" mechanism that enables "
@@ -156,37 +127,15 @@ msgid ""
 "few."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:128
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:132
 msgid "Traffic Server HTTP State Machine"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:130
-msgid ""
-"Traffic Server performs sophisticated HTTP caching and proxying. Important "
-"features include checking for alternates and document freshness, filtering, "
-"supporting cache hierarchies, and hosting. Traffic Server handles thousands "
-"of client requests at a time and each request is handled by an HTTP state "
-"machine. These machines follow a complex state diagram that includes all of "
-"the states required to support Traffic Server's features. The Traffic "
-"Server API provides hooks to a subset of these states, chosen for their "
-"relevance to plugins. You can view the API hooks and corresponding HTTP "
-"states in the `HTTP Transaction State Diagram <../http-hoooks-and-"
-"transactions#HHTTPTransactionStateDiagram>`__."
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:142
-msgid ""
-"The example in this section (below) explains how a plugin typically "
-"intervenes and extends Traffic Server's processing of an HTTP transaction. "
-"Complete details about hooking on to Traffic Server processes are provided "
-"in `HTTP Hooks and Transactions <HTTPHooksAndTransactions.html>`__."
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:149
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:151
 msgid "HTTP Transaction"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:151
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:153
 msgid ""
 "An HTTP transaction consists of a client request for a web document and "
 "Traffic Server's response. The response could be the requested web server "
@@ -196,15 +145,11 @@ msgid ""
 "specifically, the scenario wherein content is served from cache."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:159
-msgid "**Simplified HTTP Transaction** {#SimplifiedHTTPTransaction}"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:164
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:168
 msgid "Simplified HTTP Transaction"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:166
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:170
 msgid ""
 "In the diagram above, Traffic Server accepts the client connection, reads "
 "the request headers, looks up the origin server's IP address, and looks for "
@@ -214,47 +159,15 @@ msgid ""
 "\"), then Traffic Server checks it for freshness."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:173
-msgid ""
-"If the content is fresh, then Traffic Server sends a reply header to the "
-"client. If the content is stale, then Traffic Server opens a connection to "
-"the origin server and requests the content. The figure above, `Simplified "
-"HTTP Transaction <#SimplifiedHTTPTransaction>`__, does *not* show behavior "
-"in the event of an error. If there is an error at a any stage, then the "
-"HTTP state machine jumps to the \"send reply header\" state and sends a "
-"reply. If the reply is an error, then the transaction closes. If the reply "
-"is not an error, then Traffic Server first sends the response content "
-"before it closes the transaction."
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:183
-msgid "**API Hooks Corresponding to States** {#APIHooksCorrespondingtoStates}"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:188
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:194
 msgid "API Hooks Corresponding to States Listed in"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:190
-msgid ""
-"You use hooks as triggers to start your plugin. The name of a hook reflects "
-"the Traffic Server state that was *just completed*. For example, the \"OS "
-"DNS lookup\" hook wakes up a plugin right *after* the origin server DNS "
-"lookup. For a plugin that requires the IP address of the requested origin "
-"server, this hook is the right one to use. The Blacklist plugin works in "
-"this manner, as shown in the `Blacklist Plugin <#BlacklistPlugin>`__ "
-"diagram below."
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:198
-msgid "**Blacklist Plugin** {#BlacklistPlugin}"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:203
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:211
 msgid "Blacklist Plugin"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:205
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:213
 msgid ""
 "Traffic Server calls the Blacklist plugin right after the origin server DNS "
 "lookup. The plugin checks the requested host against a list of blacklisted "
@@ -265,25 +178,11 @@ msgid ""
 "that's sent to the client."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:214
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:222
 msgid "Types of Hooks"
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:216
-msgid ""
-"The Blacklist plugin's hook to the \"origin server DNS lookup\" state is a "
-"****global hook****, meaning that the plugin is called *every time* there's "
-"an HTTP transaction with a DNS lookup event. The plugin's hook to the "
-"\"send reply header\" state is a **tr**\\ ***ansaction hook***, meaning "
-"that this hook is only invoked for *specified transactions* (in the "
-"Blacklist example, it's only used for requests to blacklisted servers). "
-"Several examples of setting up hooks are provided in the code example "
-"chapters: `Header-Based Plugin Examples <../header-based-plugin-"
-"examples>`__ and `HTTP Transformation Plugins <../http-transformation-"
-"plugin>`__"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:227
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:234
 msgid ""
 "**Header manipulation plugins**, such as filtering, basic authorization, or "
 "redirects, usually have a global hook to the DNS lookup or the read request "
@@ -293,3 +192,101 @@ msgid ""
 "transactions for transformability followed by a **transform hook**, which "
 "is a type of transaction hook used specifically for transforms."
 msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:42
+msgid ""
+"A :doc:`roadmap for writing plugins <how-to-create-trafficserver-plugins/"
+"roadmap-for-creating-plugins.en>`, with an overview of the functionality "
+"provided by the Traffic Server API."
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:74
+msgid ""
+"Continuation objects are used throughout Traffic Server. Some might live "
+"for the duration of the Traffic Server process, while others are created "
+"(perhaps by other continuations) for specific needs and then destroyed. :"
+"ref:`TSInternals` (below) shows how the major components of Traffic Server "
+"interact. Traffic Server has several **processors**, such as *cache "
+"processor* and *net processor*, that consolidate cache or network I/O "
+"tasks. Processors talk to the event system and schedule work on threads. An "
+"executing thread calls back a continuation by sending it an event. When a "
+"continuation receives an event, it wakes up, does some work, and either "
+"destroys itself or goes back to sleep & waits for the next event."
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:86
+msgid "**Traffic Server Internals**"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:100
+msgid "**Traffic Server with Plugins**"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:134
+msgid ""
+"Traffic Server performs sophisticated HTTP caching and proxying. Important "
+"features include checking for alternates and document freshness, filtering, "
+"supporting cache hierarchies, and hosting. Traffic Server handles thousands "
+"of client requests at a time and each request is handled by an HTTP state "
+"machine. These machines follow a complex state diagram that includes all of "
+"the states required to support Traffic Server's features. The Traffic "
+"Server API provides hooks to a subset of these states, chosen for their "
+"relevance to plugins. You can view the API hooks and corresponding HTTP "
+"states in the :ref:`http-txn-state-diagram`."
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:145
+msgid ""
+"The example in this section (below) explains how a plugin typically "
+"intervenes and extends Traffic Server's processing of an HTTP transaction. "
+"Complete details about hooking on to Traffic Server processes are provided "
+"in :doc:`http-hooks-and-transactions.en`."
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:161
+msgid "**Simplified HTTP Transaction**"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:177
+msgid ""
+"If the content is fresh, then Traffic Server sends a reply header to the "
+"client. If the content is stale, then Traffic Server opens a connection to "
+"the origin server and requests the content. The figure above, :ref:"
+"`SimplifiedHTTPTransaction`, does *not* show behavior in the event of an "
+"error. If there is an error at a any stage, then the HTTP state machine "
+"jumps to the \"send reply header\" state and sends a reply. If the reply is "
+"an error, then the transaction closes. If the reply is not an error, then "
+"Traffic Server first sends the response content before it closes the "
+"transaction."
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:187
+msgid "**API Hooks Corresponding to States**"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:196
+msgid ""
+"You use hooks as triggers to start your plugin. The name of a hook reflects "
+"the Traffic Server state that was *just completed*. For example, the \"OS "
+"DNS lookup\" hook wakes up a plugin right *after* the origin server DNS "
+"lookup. For a plugin that requires the IP address of the requested origin "
+"server, this hook is the right one to use. The Blacklist plugin works in "
+"this manner, as shown in the :ref:`BlackListPlugin` diagram below."
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:204
+msgid "**Blacklist Plugin**"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins.en.rst:224
+msgid ""
+"The Blacklist plugin's hook to the \"origin server DNS lookup\" state is a "
+"****global hook****, meaning that the plugin is called *every time* there's "
+"an HTTP transaction with a DNS lookup event. The plugin's hook to the "
+"\"send reply header\" state is a **tr**\\ ***ansaction hook***, meaning "
+"that this hook is only invoked for *specified transactions* (in the "
+"Blacklist example, it's only used for requests to blacklisted servers). "
+"Several examples of setting up hooks are provided in the code example "
+"chapters: :doc:`header-based-plugin-examples.en` and :doc:`http-"
+"transformation-plugin.en`"
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.po b/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.po
index 8927152..49c9d04 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.po
@@ -89,22 +89,7 @@ msgid ""
 "discussed in the next three chapters."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:63
-msgid ""
-"Determine where your plugin needs to hook on to Traffic Server's HTTP "
-"processing (view the `HTTP Transaction State Diagram <../http-hoooks-and-"
-"transactions#HTTPTransactionStateDiagram>`__"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:67
-msgid ""
-"Read `Header-Based Plugin Examples <../header-based-plugin-examples>`_ to "
-"learn the basics of writing plugins: creating continuations and setting up "
-"hooks. If you want to write a plugin that transforms data, then read `HTTP "
-"Transformation Plugins <HTTPTransformationPlugins.html>`_."
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:73
+#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:71
 msgid ""
 "Figure out what parts of the Traffic Server API you need to use and then "
 "read about the details of those APIs in this manual's reference chapters."
@@ -112,21 +97,34 @@ msgstr ""
 
 #: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:77
 msgid ""
-"Compile and load your plugin (see `Getting Started <../getting-started>`_"
-msgstr ""
-
-#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:80
-msgid ""
 "Depending on your plugin's functionality, you might start testing it by "
 "issuing requests by hand and checking for the desired behavior in Traffic "
 "Server log files. See the ***Traffic Server Administrator's Guide*** for "
 "information about Traffic Server logs."
 msgstr ""
 
-#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:85
+#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:82
 msgid ""
 "You can test the performance of Traffic Server running with your plugin "
 "using SDKTest. You can also customize SDKTest to perform functional testing "
 "on your plugin; for more information see the ***Traffic Server SDKTest "
 "User's Guide***."
 msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:63
+msgid ""
+"Determine where your plugin needs to hook on to Traffic Server's HTTP "
+"processing (view the :ref:`http-txn-state-diagram`"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:66
+msgid ""
+"Read :doc:`../header-based-plugin-examples.en` to learn the basics of "
+"writing plugins: creating continuations and setting up hooks. If you want "
+"to write a plugin that transforms data, then read :doc:`../http-"
+"transformation-plugin.en`"
+msgstr ""
+
+#: ../../sdk/how-to-create-trafficserver-plugins/roadmap-for-creating-plugins.en.rst:75
+msgid "Compile and load your plugin (see :doc:`../getting-started.en`"
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/http-headers/http-headers.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/http-headers/http-headers.en.po b/doc/locale/ja/LC_MESSAGES/sdk/http-headers/http-headers.en.po
index 2b07a92..079a7ac 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/http-headers/http-headers.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/http-headers/http-headers.en.po
@@ -125,181 +125,181 @@ msgstr ""
 msgid "\"TRACE\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:80
+#: ../../sdk/http-headers/http-headers.en.rst:83
 msgid ""
 "Traffic Server also defines several common values that appear in HTTP "
 "headers."
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:84
+#: ../../sdk/http-headers/http-headers.en.rst:87
 msgid "``TS_HTTP_VALUE_BYTES``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:84
+#: ../../sdk/http-headers/http-headers.en.rst:87
 msgid "\"bytes\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:87
+#: ../../sdk/http-headers/http-headers.en.rst:90
 msgid "``TS_HTTP_VALUE_CHUNKED``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:87
+#: ../../sdk/http-headers/http-headers.en.rst:90
 msgid "\"chunked\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:90
+#: ../../sdk/http-headers/http-headers.en.rst:93
 msgid "``TS_HTTP_VALUE_CLOSE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:90
+#: ../../sdk/http-headers/http-headers.en.rst:93
 msgid "\"close\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:93
+#: ../../sdk/http-headers/http-headers.en.rst:96
 msgid "``TS_HTTP_VALUE_COMPRESS``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:93
+#: ../../sdk/http-headers/http-headers.en.rst:96
 msgid "\"compress\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:96
+#: ../../sdk/http-headers/http-headers.en.rst:99
 msgid "``TS_HTTP_VALUE_DEFLATE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:96
+#: ../../sdk/http-headers/http-headers.en.rst:99
 msgid "\"deflate\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:99
+#: ../../sdk/http-headers/http-headers.en.rst:102
 msgid "``TS_HTTP_VALUE_GZIP``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:99
+#: ../../sdk/http-headers/http-headers.en.rst:102
 msgid "\"gzip\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:102
+#: ../../sdk/http-headers/http-headers.en.rst:105
 msgid "``TS_HTTP_VALUE_IDENTITY``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:102
+#: ../../sdk/http-headers/http-headers.en.rst:105
 msgid "\"identity\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:105
+#: ../../sdk/http-headers/http-headers.en.rst:108
 msgid "``TS_HTTP_VALUE_KEEP_ALIVE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:105
+#: ../../sdk/http-headers/http-headers.en.rst:108
 msgid "\"keep-alive\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:108
+#: ../../sdk/http-headers/http-headers.en.rst:111
 msgid "``TS_HTTP_VALUE_MAX_AGE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:108
+#: ../../sdk/http-headers/http-headers.en.rst:111
 msgid "\"max-age\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:111
+#: ../../sdk/http-headers/http-headers.en.rst:114
 msgid "``TS_HTTP_VALUE_MAX_STALE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:111
+#: ../../sdk/http-headers/http-headers.en.rst:114
 msgid "\"max-stale\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:114
+#: ../../sdk/http-headers/http-headers.en.rst:117
 msgid "``TS_HTTP_VALUE_MIN_FRESH``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:114
+#: ../../sdk/http-headers/http-headers.en.rst:117
 msgid "\"min-fresh\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:117
+#: ../../sdk/http-headers/http-headers.en.rst:120
 msgid "``TS_HTTP_VALUE_MUST_REVALIDATE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:117
+#: ../../sdk/http-headers/http-headers.en.rst:120
 msgid "\"must-revalidate\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:120
+#: ../../sdk/http-headers/http-headers.en.rst:123
 msgid "``TS_HTTP_VALUE_NONE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:120
+#: ../../sdk/http-headers/http-headers.en.rst:123
 msgid "\"none\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:123
+#: ../../sdk/http-headers/http-headers.en.rst:126
 msgid "``TS_HTTP_VALUE_NO_CACHE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:123
+#: ../../sdk/http-headers/http-headers.en.rst:126
 msgid "\"no-cache\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:126
+#: ../../sdk/http-headers/http-headers.en.rst:129
 msgid "``TS_HTTP_VALUE_NO_STORE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:126
+#: ../../sdk/http-headers/http-headers.en.rst:129
 msgid "\"no-store\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:129
+#: ../../sdk/http-headers/http-headers.en.rst:132
 msgid "``TS_HTTP_VALUE_NO_TRANSFORM``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:129
+#: ../../sdk/http-headers/http-headers.en.rst:132
 msgid "\"no-transform\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:132
+#: ../../sdk/http-headers/http-headers.en.rst:135
 msgid "``TS_HTTP_VALUE_ONLY_IF_CACHED``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:132
+#: ../../sdk/http-headers/http-headers.en.rst:135
 msgid "\"only-if-cached\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:135
+#: ../../sdk/http-headers/http-headers.en.rst:138
 msgid "``TS_HTTP_VALUE_PRIVATE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:135
+#: ../../sdk/http-headers/http-headers.en.rst:138
 msgid "\"private\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:138
+#: ../../sdk/http-headers/http-headers.en.rst:141
 msgid "``TS_HTTP_VALUE_PROXY_REVALIDATE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:138
+#: ../../sdk/http-headers/http-headers.en.rst:141
 msgid "\"proxy-revalidate\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:141
+#: ../../sdk/http-headers/http-headers.en.rst:144
 msgid "``TS_HTTP_VALUE_PUBLIC``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:141
+#: ../../sdk/http-headers/http-headers.en.rst:144
 msgid "\"public\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:144
+#: ../../sdk/http-headers/http-headers.en.rst:147
 msgid "``TS_HTTP_VALUE_S_MAX_AGE``"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:144
+#: ../../sdk/http-headers/http-headers.en.rst:147
 msgid "\"s-maxage\""
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:146
+#: ../../sdk/http-headers/http-headers.en.rst:149
 msgid ""
 "The method names and header values above are defined in ``ts.h`` as ``const "
 "char*`` strings. When Traffic Server sets a method or a header value, it "
@@ -313,148 +313,156 @@ msgid ""
 "possibility of a spelling error."
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:157
+#: ../../sdk/http-headers/http-headers.en.rst:160
 msgid "The **HTTP Header Functions** are listed below:"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:159
+#: ../../sdk/http-headers/http-headers.en.rst:162
 msgid ""
 "```TSHttpHdrClone`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#abd410a18e8bc73298302c4ff3ee9b0c6>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:160
+#: ../../sdk/http-headers/http-headers.en.rst:163
 msgid ""
 "```TSHttpHdrCopy`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a5ff26f3836a74e885113423dfd4d9ed6>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:161
+#: ../../sdk/http-headers/http-headers.en.rst:164
 msgid ""
 "```TSHttpHdrCreate`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a8bbd8c2aaf70fb579af4520053fd5e10>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:162
+#: ../../sdk/http-headers/http-headers.en.rst:165
 msgid ""
 "```TSHttpHdrDestroy`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a500ac4aae8f369221cf3ac2e3ce0d2a0>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:163
+#: ../../sdk/http-headers/http-headers.en.rst:166
 msgid ""
 "```TSHttpHdrLengthGet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a3afc557e4e99565ab81bf6437b65181b>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:164
+#: ../../sdk/http-headers/http-headers.en.rst:167
 msgid ""
 "```TSHttpHdrMethodGet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a358627e05506baa5c8270891652ac4d2>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:165
+#: ../../sdk/http-headers/http-headers.en.rst:168
 msgid ""
 "```TSHttpHdrMethodSet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a32bbcacacbef997e89c04cc3898b0ca4>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:166
+#: ../../sdk/http-headers/http-headers.en.rst:169
 msgid ""
 "```TSHttpHdrPrint`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a7c88f30d6325a461fb038e6a117b3731>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:167
+#: ../../sdk/http-headers/http-headers.en.rst:170
 msgid ""
 "```TSHttpHdrReasonGet`` <http://people.apache.org/~amc/ats/doc/html/"
 "InkAPI_8cc.html#a8b1609e9c8a8a52ebe7762b6109d3bef>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:168
+#: ../../sdk/http-headers/http-headers.en.rst:171
 msgid ""
 "```TSHttpHdrReasonLookup`` <http://people.apache.org/~amc/ats/doc/html/"
 "ts_8h.html#ab49fded8874b8e3e17cf4395c9832378>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:169
+#: ../../sdk/http-headers/http-headers.en.rst:172
 msgid ""
 "```TSHttpHdrReasonSet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#ab86e5f5e7c0af2092c77327d2e0d3b23>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:170
+#: ../../sdk/http-headers/http-headers.en.rst:173
 msgid ""
 "```TSHttpHdrStatusGet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#ac29d5acc357a0c82c83874f42b1e487b>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:171
+#: ../../sdk/http-headers/http-headers.en.rst:174
 msgid ""
 "```TSHttpHdrStatusSet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#af34459170ed7f3b002ddd597ae38af12>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:172
+#: ../../sdk/http-headers/http-headers.en.rst:175
 msgid ""
 "```TSHttpHdrTypeGet`` <http://people.apache.org/~amc/ats/doc/html/"
 "InkAPI_8cc.html#afc1c6f0a3258c4bc6567805df1db1ca3>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:173
+#: ../../sdk/http-headers/http-headers.en.rst:176
 msgid ""
 "```TSHttpHdrTypeSet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a86058d8590a665dbf43a529714202d3f>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:174
+#: ../../sdk/http-headers/http-headers.en.rst:177
 msgid ""
 "```TSHttpHdrUrlGet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#af149d7b5c1b8902363afc0ad658c494e>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:175
+#: ../../sdk/http-headers/http-headers.en.rst:178
 msgid ""
 "```TSHttpHdrUrlSet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#ad935635a3918575fa6cca6843c474cfe>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:176
+#: ../../sdk/http-headers/http-headers.en.rst:179
 msgid ""
 "```TSHttpHdrVersionGet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a90cc8783f5d0bc159f226079aa0104e4>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:177
+#: ../../sdk/http-headers/http-headers.en.rst:180
 msgid ""
 "```TSHttpHdrVersionSet`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#aa2a2c03399cdc8dc39b8756f13e7f189>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:178
+#: ../../sdk/http-headers/http-headers.en.rst:181
 msgid ""
 "```TSHttpParserClear`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a7cb1b53b4464dc71287351616d6e7509>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:179
+#: ../../sdk/http-headers/http-headers.en.rst:182
 msgid ""
 "```TSHttpParserCreate`` <http://people.apache.org/~amc/ats/doc/html/"
 "InkAPI_8cc.html#a6075fb4e8fc41eb75d640f258722115b>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:180
+#: ../../sdk/http-headers/http-headers.en.rst:183
 msgid "`TSHttpParserDestroy <link/to/doxyge>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:181
+#: ../../sdk/http-headers/http-headers.en.rst:184
 msgid ""
 "```TSHttpHdrParseReq`` <http://people.apache.org/~amc/ats/doc/html/ts_8h."
 "html#a64193b3c9ddff8bc434c1cc9332004cc>`__"
 msgstr ""
 
-#: ../../sdk/http-headers/http-headers.en.rst:182
+#: ../../sdk/http-headers/http-headers.en.rst:185
 msgid ""
 "```TSHttpHdrParseResp`` <http://people.apache.org/~amc/ats/doc/html/"
 "InkAPI_8cc.html#a03c8a14b6ab2b7896ef0e4005222ecff>`__"
 msgstr ""
+
+#: ../../sdk/http-headers/http-headers.en.rst:81
+msgid "``TS_HTTP_METHOD_PUSH``"
+msgstr ""
+
+#: ../../sdk/http-headers/http-headers.en.rst:81
+msgid "\"PUSH\""
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/http-headers/marshal-buffers.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/http-headers/marshal-buffers.en.po b/doc/locale/ja/LC_MESSAGES/sdk/http-headers/marshal-buffers.en.po
index 5d4c669..71bdf0f 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/http-headers/marshal-buffers.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/http-headers/marshal-buffers.en.po
@@ -31,18 +31,6 @@ msgid ""
 "information. For example, see one of the following:"
 msgstr ""
 
-#: ../../sdk/http-headers/marshal-buffers.en.rst:31
-msgid "`HTTP Headers <http-headers>`__"
-msgstr ""
-
-#: ../../sdk/http-headers/marshal-buffers.en.rst:32
-msgid "`URLs <urls>`__"
-msgstr ""
-
-#: ../../sdk/http-headers/marshal-buffers.en.rst:33
-msgid "`MIME Headers <mime-headers>`__"
-msgstr ""
-
 #: ../../sdk/http-headers/marshal-buffers.en.rst:35
 msgid ""
 "The **marshal buffer functions** enable you to create and destroy Traffic "
@@ -98,3 +86,15 @@ msgid ""
 "`TSHttpTxnTransformRespGet <http://people.apache.org/~amc/ats/doc/html/"
 "InkAPI_8cc.html#a20367f5469e8b7e73621c1316091d578>`_"
 msgstr ""
+
+#: ../../sdk/http-headers/marshal-buffers.en.rst:31
+msgid ":doc:`http-headers.en`"
+msgstr ""
+
+#: ../../sdk/http-headers/marshal-buffers.en.rst:32
+msgid ":doc:`urls.en`"
+msgstr ""
+
+#: ../../sdk/http-headers/marshal-buffers.en.rst:33
+msgid ":doc:`mime-headers.en`"
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions.en.po b/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions.en.po
index a294a22..f1c97a7 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions.en.po
@@ -38,11 +38,7 @@ msgid ""
 "following terminology:"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions.en.rst:45
-msgid "***HTTP Transaction***"
-msgstr ""
-
-#: ../../sdk/http-hooks-and-transactions.en.rst:47
+#: ../../sdk/http-hooks-and-transactions.en.rst:48
 msgid ""
 "A **transaction** consists of a single HTTP request from a client and the "
 "response Traffic Server sends to that client. Thus, a transaction begins "
@@ -50,46 +46,44 @@ msgid ""
 "the response."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions.en.rst:52
+#: ../../sdk/http-hooks-and-transactions.en.rst:71
+msgid ""
+"A **session** consists of a single client connection to Traffic Server; it "
+"may consist of a single transaction or several transactions in succession. "
+"The session starts when the client connection opens and ends when the "
+"connection closes."
+msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions.en.rst:79
+msgid "HTTP Transaction State Diagram"
+msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions.en.rst:46
+msgid "HTTP Transaction"
+msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions.en.rst:53
 msgid ""
 "Traffic Server uses **HTTP state machines** to process transactions. The "
 "state machines follow a complex set of states involved in sophisticated "
 "caching and document retrieval (taking into account, for example, alternate "
 "selection, freshness criteria, and hierarchical caching). The Traffic "
 "Server API provides hooks to a subset of these states, as illustrated in "
-"the `HTTP Transaction State Diagram <#HHTTPTxStateDiag>`__ below."
+"the :ref:`http-txn-state-diagram` below."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions.en.rst:60
-msgid "***Transform hooks***"
+#: ../../sdk/http-hooks-and-transactions.en.rst:61
+msgid "Transform hooks"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions.en.rst:62
+#: ../../sdk/http-hooks-and-transactions.en.rst:63
 msgid ""
 "The two **transform hooks**, ``TS_HTTP_REQUEST_TRANSFORM_HOOK`` and "
 "``TS_HTTP_RESPONSE_TRANSFORM_HOOK``, are called in the course of an HTTP "
 "transform. To see where in the HTTP transaction they are called, look for "
-"the \"set up transform\" ovals in the `HTTP Transaction State Diagram "
-"<#HHTTPTxStateDiag>`__ below."
+"the \"set up transform\" ovals in the :ref:`http-txn-state-diagram` below."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions.en.rst:68
-msgid "***HTTP session***"
-msgstr ""
-
-#: ../../sdk/http-hooks-and-transactions.en.rst:70
-msgid ""
-"A **session** consists of a single client connection to Traffic Server; it "
-"may consist of a single transaction or several transactions in succession. "
-"The session starts when the client connection opens and ends when the "
-"connection closes."
-msgstr ""
-
-#: ../../sdk/http-hooks-and-transactions.en.rst:75
-msgid ""
-"**HTTP Transaction State Diagram (*not yet updated*)** {#HHTTPTxStateDiag}"
-msgstr ""
-
-#: ../../sdk/http-hooks-and-transactions.en.rst:81
-msgid "HTTP Transaction State Diagram"
+#: ../../sdk/http-hooks-and-transactions.en.rst:69
+msgid "HTTP session"
 msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions/adding-hooks.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions/adding-hooks.en.po b/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions/adding-hooks.en.po
index 8264b73..bcd4e5f 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions/adding-hooks.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/http-hooks-and-transactions/adding-hooks.en.po
@@ -114,11 +114,11 @@ msgid ""
 "``TS_EVENT_HTTP_OS_DNS``."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:87
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:96
 msgid "``TS_HTTP_READ_CACHE_HDR_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:84
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:93
 msgid ""
 "Called immediately after the request and response header of a previously-"
 "cached object is read from cache. This hook is only called if the document "
@@ -126,79 +126,68 @@ msgid ""
 "``TS_EVENT_HTTP_READ_CACHE_HDR``."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:92
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:101
 msgid "``TS_HTTP_READ_RESPONSE_HDR_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:90
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:99
 msgid ""
 "Called immediately after the response header is read from the origin server "
 "or parent proxy. Corresponds to the event "
 "``TS_EVENT_HTTP_READ_RESPONSE_HDR``."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:97
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:106
 msgid "``TS_HTTP_RESPONSE_TRANSFORM_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:95
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:109
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:104
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:113
 msgid ""
 "See \"`\"Transformations\" <../http-transformation-"
 "plugin#Transformations>`__ for information about transformation hooks."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:101
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:110
 msgid "``TS_HTTP_READ_REQUEST_HDR_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:100
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:109
 msgid ""
 "Called immediately after the request header is read from the client. "
 "Corresponds to the event ``TS_EVENT_HTTP_READ_REQUEST_HDR``."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:106
-msgid "``TS_HTTP_READ_REQUEST_PRE_REMAP_HOOK``"
-msgstr ""
-
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:104
-msgid ""
-"Called after the request header is read from the client, before any "
-"remapping of the headers occurs. Corresponds to the event "
-"``TS_EVENT_HTTP_READ_REQUEST_PRE_REMAP``."
-msgstr ""
-
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:111
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:115
 msgid "``TS_HTTP_REQUEST_TRANSFORM_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:115
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:119
 msgid "``TS_HTTP_SELECT_ALT_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:114
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:118
 msgid ""
 "See `\"HTTP Alternate Selection\" <http-alternate-selection>`__ for "
 "information about the alternate selection mechanism."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:121
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:125
 msgid "``TS_HTTP_SEND_RESPONSE_HDR_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:118
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:122
 msgid ""
 "Called immediately before the proxy's response header is written to the "
 "client; this hook is usually used for modifying the response header. "
 "Corresponds to the event ``TS_EVENT_HTTP_SEND_RESPONSE_HDR``."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:128
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:132
 msgid "``TS_HTTP_SEND_REQUEST_HDR_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:124
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:128
 msgid ""
 "Called immediately before the proxy's request header is sent to the origin "
 "server or the parent proxy. This hook is not called if the document is "
@@ -207,39 +196,39 @@ msgid ""
 "proxy."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:132
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:136
 msgid "``TS_HTTP_SSN_CLOSE_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:131
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:135
 msgid ""
 "Called when an HTTP session ends. A session ends when the client connection "
 "is closed. You can only add this hook as a global hook"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:137
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:141
 msgid "``TS_HTTP_SSN_START_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:135
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:139
 msgid ""
 "Called when an HTTP session is started. A session starts when a client "
 "connects to Traffic Server. You can only add this hook as a global hook."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:140
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:144
 msgid "``TS_HTTP_TXN_CLOSE_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:140
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:144
 msgid "Called when an HTTP transaction ends."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:146
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:150
 msgid "``TS_HTTP_TXN_START_HOOK``"
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:143
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:147
 msgid ""
 "Called when an HTTP transaction is started. A transaction starts when "
 "either a client connects to Traffic Server and data is available on the "
@@ -247,9 +236,30 @@ msgid ""
 "alive has new data available."
 msgstr ""
 
-#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:148
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:152
 msgid ""
 "The function you use to add a global HTTP hook is ```TSHttpHookAdd`` "
 "<http://people.apache.org/~amc/ats/doc/html/InkAPI_8cc."
 "html#a19a663edd3ec439f66256fbbb26cc1db>`__."
 msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:85
+msgid "``TS_HTTP_POST_REMAP_HOOK``"
+msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:84
+msgid ""
+"Called immediately after remapping occurs, before cache lookup. Corresponds "
+"to the event ``TS_EVENT_HTTP_POST_REMAP``."
+msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:90
+msgid "``TS_HTTP_PRE_REMAP_HOOK``"
+msgstr ""
+
+#: ../../sdk/http-hooks-and-transactions/adding-hooks.en.rst:88
+msgid ""
+"Called after the request header is read from the client, before any "
+"remapping of the headers occurs. Corresponds to the event "
+"``TS_EVENT_HTTP_PRE_REMAP``."
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.po b/doc/locale/ja/LC_MESSAGES/sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.po
index b46e391..9c5b75e 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.po
@@ -175,3 +175,17 @@ msgstr ""
 msgid ""
 "The ``handle_output`` function writes the buffer to the output vconnection:"
 msgstr ""
+
+#: ../../sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.rst:202
+msgid "The following diagram illustrates the write to the output vconnection:"
+msgstr ""
+
+#: ../../sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.rst:205
+msgid ""
+"**Writing the Buffered Data to the Output Vconnection** "
+"{#WritingBufferedtDataIntoVConnection}"
+msgstr ""
+
+#: ../../sdk/http-transformation-plugin/sample-buffered-null-transformation-plugin.en.rst:211
+msgid "Writing the Buffered Data to the Output Vconnection"
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/mutex-guide.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/mutex-guide.en.po b/doc/locale/ja/LC_MESSAGES/sdk/mutex-guide.en.po
index 19ba46d..2cd51e8 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/mutex-guide.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/mutex-guide.en.po
@@ -144,10 +144,6 @@ msgid ""
 "accessed by other continuations or processes. Here's how:"
 msgstr ""
 
-#: ../../sdk/mutex-guide.en.rst:119
-msgid "continuation's mutex. | For example:"
-msgstr ""
-
 #: ../../sdk/mutex-guide.en.rst:128
 msgid ""
 "If any other functions want to access ``contp``'s data, then it is up to "

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/new-protocol-plugins.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/new-protocol-plugins.en.po b/doc/locale/ja/LC_MESSAGES/sdk/new-protocol-plugins.en.po
index 0583edb..7229d82 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/new-protocol-plugins.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/new-protocol-plugins.en.po
@@ -24,18 +24,18 @@ msgid ""
 "protocol."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:33
+#: ../../sdk/new-protocol-plugins.en.rst:35
 msgid "About the Sample Protocol"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:35
+#: ../../sdk/new-protocol-plugins.en.rst:37
 msgid ""
 "The sample protocol enables a client to ask a server for a file. Clients "
 "send requests to a specific Traffic Server port (specified in :file:`plugin."
 "config`); each request has the following structure::"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:41
+#: ../../sdk/new-protocol-plugins.en.rst:43
 msgid ""
 "Using the Protocol plugin, Traffic Server can accept these requests, parse "
 "them, and act as a proxy cache (i.e., request the file from the origin "
@@ -47,61 +47,61 @@ msgid ""
 "protocol."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:50
+#: ../../sdk/new-protocol-plugins.en.rst:52
 msgid "In more specific terms, Traffic Server and the Protocol plugin must:"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:52
+#: ../../sdk/new-protocol-plugins.en.rst:54
 msgid ""
 "Listen for and accept client connections (on the accept port specified in :"
 "file:`plugin.config`)"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:55
+#: ../../sdk/new-protocol-plugins.en.rst:57
 msgid "Read incoming client requests"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:57
+#: ../../sdk/new-protocol-plugins.en.rst:59
 msgid "Look up the requested content in the Traffic Server cache"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:59
+#: ../../sdk/new-protocol-plugins.en.rst:61
 msgid ""
 "Serve content from cache if the request is a cache hit (this simple example "
 "does not do freshness checking)"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:62
+#: ../../sdk/new-protocol-plugins.en.rst:64
 msgid ""
 "Open a connection to the origin server if the request is a cache miss (on "
 "the server port specified in :file:`plugin.config`)"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:65
+#: ../../sdk/new-protocol-plugins.en.rst:67
 msgid "Forward the request to the origin server"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:67
+#: ../../sdk/new-protocol-plugins.en.rst:69
 msgid "Receive the origin server response"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:69
+#: ../../sdk/new-protocol-plugins.en.rst:71
 msgid "Cache the response and send it on to the client"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:71
+#: ../../sdk/new-protocol-plugins.en.rst:73
 msgid "**Sample Protocol State Diagram** {#SampleProtocolStDiag}"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:76
+#: ../../sdk/new-protocol-plugins.en.rst:78
 msgid "Sample Protocol State Diagram"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:79
+#: ../../sdk/new-protocol-plugins.en.rst:81
 msgid "Protocol Plugin Structure"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:81
+#: ../../sdk/new-protocol-plugins.en.rst:83
 msgid ""
 "To see how the Protocol plugin works, you need to understand some broader "
 "concepts. This section assumes you're familiar with the concepts of :term:"
@@ -112,11 +112,11 @@ msgid ""
 "to-create-trafficserver-plugins>`_"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:90
+#: ../../sdk/new-protocol-plugins.en.rst:92
 msgid "Continuations in the Protocol Plugin"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:92
+#: ../../sdk/new-protocol-plugins.en.rst:94
 msgid ""
 "The Protocol plugin creates a static continuation that is an **\"accept\" "
 "state machine** - that is, a state machine whose job is to accept client "
@@ -132,15 +132,15 @@ msgid ""
 "`Protocol Plugin Overview <#ProtocolPluginOverview>`__ diagram below."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:106
+#: ../../sdk/new-protocol-plugins.en.rst:108
 msgid "**Protocol Plugin Overview**"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:111
+#: ../../sdk/new-protocol-plugins.en.rst:113
 msgid "Protocol Plugin Overview"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:113
+#: ../../sdk/new-protocol-plugins.en.rst:115
 msgid ""
 "The first steps for writing the Protocol plugin are now clear: in "
 "``TSPluginInit``, you must create a continuation that listens for net "
@@ -148,12 +148,12 @@ msgid ""
 "continuation is the accept state machine)."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:118
+#: ../../sdk/new-protocol-plugins.en.rst:120
 msgid ""
 "Below is a summary of the continuations implemented for the Protocol plugin:"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:121
+#: ../../sdk/new-protocol-plugins.en.rst:123
 msgid ""
 "An **accept state machine** that listens for client connections, and then "
 "creates transaction state machines whenever Traffic Server accepts a new "
@@ -161,17 +161,17 @@ msgid ""
 "is running."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:126
+#: ../../sdk/new-protocol-plugins.en.rst:128
 msgid ""
 "**Transaction state machines** that read client requests, process them, and "
 "are then destroyed when the transaction is finished."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:130
+#: ../../sdk/new-protocol-plugins.en.rst:132
 msgid "Event Flow"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:132
+#: ../../sdk/new-protocol-plugins.en.rst:134
 msgid ""
 "Implementing the rest of the Protocol plugin requires that you understand "
 "the flow of events during the course of a transaction. Unlike HTTP "
@@ -184,7 +184,7 @@ msgid ""
 "must therefore be able to handle that event."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:143
+#: ../../sdk/new-protocol-plugins.en.rst:145
 msgid ""
 "The transaction state machines are activated when the client connection "
 "receives incoming request data. The **Net Processor** notifies the "
@@ -194,7 +194,7 @@ msgid ""
 "activated by the Traffic Server **Cache Processor**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:150
+#: ../../sdk/new-protocol-plugins.en.rst:152
 msgid ""
 "If the transaction state machine needs to open a connection to the origin "
 "server to fetch content (in the case of a cache miss), then the transaction "
@@ -205,15 +205,15 @@ msgid ""
 "waits for an event from the Net Processor."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:159
+#: ../../sdk/new-protocol-plugins.en.rst:161
 msgid "**Protocol Plugin Flow of Events**"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:164
+#: ../../sdk/new-protocol-plugins.en.rst:166
 msgid "Protocol Plugin Flow of Events"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:166
+#: ../../sdk/new-protocol-plugins.en.rst:168
 msgid ""
 "The flow of events is illustrated in the `Protocol Plugin Flow of Events "
 "<#ProtocolPluginFlow>`_ diagram above. The thin straight lines show Net "
@@ -221,7 +221,7 @@ msgid ""
 "flow, and the thick dashed lines show Cache event flow."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:171
+#: ../../sdk/new-protocol-plugins.en.rst:173
 msgid ""
 "Notice that this flow of events is independent of the Protocol plugin's "
 "design (i.e., whether you build **accept** or **transaction** state "
@@ -234,44 +234,44 @@ msgid ""
 "does DNS lookups receives events from the Host Database Processor."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:182
+#: ../../sdk/new-protocol-plugins.en.rst:186
 msgid "One Way to Implement a Transaction State Machine"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:184
+#: ../../sdk/new-protocol-plugins.en.rst:188
 msgid ""
 "**Transaction state machines** (**TSMs**) in the Protocol plugin must do "
 "the following:"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:187
+#: ../../sdk/new-protocol-plugins.en.rst:191
 msgid "Keep track of the state of the transaction"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:189
+#: ../../sdk/new-protocol-plugins.en.rst:193
 msgid ""
 "Handle events received (based on the state of the transaction and the event "
 "received)"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:192
+#: ../../sdk/new-protocol-plugins.en.rst:196
 msgid "Update the state of the transaction as it changes"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:194
+#: ../../sdk/new-protocol-plugins.en.rst:198
 msgid ""
 "Below is one way you can implement TSMs. Details about how the Protocol "
 "plugin does this are provided in the next section."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:197
+#: ../../sdk/new-protocol-plugins.en.rst:201
 msgid ""
 "Create a data structure for transactions that contains all of the state "
 "data you need to keep track of. In the Protocol plugin this is a struct, "
 "``Txn_SM``."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:201
+#: ../../sdk/new-protocol-plugins.en.rst:205
 msgid ""
 "When you create the TSM's continuation, initialize data of type ``Txn_SM``. "
 "Initialize the data to the initial state of a transaction (in this case, a "
@@ -279,13 +279,13 @@ msgid ""
 "continuation using ``TSContDataSet``."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:206
+#: ../../sdk/new-protocol-plugins.en.rst:210
 msgid ""
 "Write state handler functions that handle the expected events for each "
 "state."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:209
+#: ../../sdk/new-protocol-plugins.en.rst:213
 msgid ""
 "Write the handler for the TSM. Its job is to receive events, examine the "
 "current state, and execute the appropriate state handler function. In the "
@@ -293,26 +293,26 @@ msgid ""
 "the state handler functions to handle each state."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:215
+#: ../../sdk/new-protocol-plugins.en.rst:219
 msgid ""
 "The steps below describe the flow of execution illustrated in `\"How "
 "Transaction State Machines are Implemented in the Protocol Plugin\" "
 "<#ImplementTransStMachine>`__."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:219
+#: ../../sdk/new-protocol-plugins.en.rst:223
 msgid ""
 "The handler for the TSM, (called **``main_handler``** in the Protocol "
 "plugin) receives events from the TSM."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:222
+#: ../../sdk/new-protocol-plugins.en.rst:226
 msgid ""
 "**``main_handler``** examines the state of the transaction-in particular, "
 "it examines the current handler."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:225
+#: ../../sdk/new-protocol-plugins.en.rst:229
 msgid ""
 "**``main_handler``** calls the **``current_handler``** (which is one of the "
 "state handler functions), and then passes the current event to "
@@ -320,7 +320,7 @@ msgid ""
 "below, the current handler is called **``state2_handler``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:231
+#: ../../sdk/new-protocol-plugins.en.rst:235
 msgid ""
 "The **``current_handler``** handles the event and updates the data. In `the "
 "image below <#ImplementTransStMachine>`__ below, the state is changed from "
@@ -330,7 +330,7 @@ msgid ""
 "**``state3_handler``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:238
+#: ../../sdk/new-protocol-plugins.en.rst:242
 msgid ""
 "**``state2_handler``** arranges the next callback of the TSM. Typically, it "
 "gives Traffic Server additional work to do (such as writing a file to "
@@ -339,63 +339,63 @@ msgid ""
 "Server."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:244
+#: ../../sdk/new-protocol-plugins.en.rst:248
 msgid ""
 "**How Transaction State Machines are Implemented in the Protocol Plugin** "
 "{#ImplementTransStMachine}"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:250
+#: ../../sdk/new-protocol-plugins.en.rst:254
 msgid "How Transaction State Machines are Implemented in the Protocol Plugin"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:253
+#: ../../sdk/new-protocol-plugins.en.rst:257
 msgid "Processing a Typical Transaction"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:255
+#: ../../sdk/new-protocol-plugins.en.rst:259
 msgid "The code is contained in the following files:"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:257
+#: ../../sdk/new-protocol-plugins.en.rst:261
 msgid "``Protocol.c`` and ``Protocol.h``"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:259
+#: ../../sdk/new-protocol-plugins.en.rst:263
 msgid "``Accept.c`` and ``Accept.h``"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:261
+#: ../../sdk/new-protocol-plugins.en.rst:265
 msgid "``TxnSM.c`` and ``TxnSM.h``"
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:263
+#: ../../sdk/new-protocol-plugins.en.rst:267
 msgid ""
 "Below is a step-by-step walk-through of the code that processes a typical "
 "transaction."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:266
+#: ../../sdk/new-protocol-plugins.en.rst:270
 msgid ""
 "The ``TSPluginInit`` function is in the ``Protocol.c`` file. It checks the "
 "validity of the ``plugin.config`` entries (there must be two: a client "
 "accept port and a server port) and runs an initialization routine, ``init``."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:271
+#: ../../sdk/new-protocol-plugins.en.rst:275
 msgid ""
 "The **``init``** function (in ``Protocol.c``) creates the plugin's log file "
 "using **``TSTextLogObjectCreate``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:274
+#: ../../sdk/new-protocol-plugins.en.rst:278
 msgid ""
 "The **``init``** function creates the accept state machine using "
 "**``AcceptCreate``**. The code for **``AcceptCreate``** is in the ``Accept."
 "c`` file."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:278
+#: ../../sdk/new-protocol-plugins.en.rst:282
 msgid ""
 "The accept state machine, like the transaction state machine, keeps track "
 "of its state with a data structure. This data structure, **``Accept``**, is "
@@ -403,13 +403,13 @@ msgid ""
 "associated with the new accept state machine via **``TSContDataSet``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:284
+#: ../../sdk/new-protocol-plugins.en.rst:288
 msgid ""
 "The **``init``** function arranges the callback of the accept state machine "
 "when there is a network connection by using **``TSNetAccept``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:288
+#: ../../sdk/new-protocol-plugins.en.rst:292
 msgid ""
 "The handler for the accept state machine is **``accept_event``** in the "
 "``Accept.c`` file. When Traffic Server's Net Processor sends "
@@ -420,7 +420,7 @@ msgid ""
 "machine has its own mutex."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:296
+#: ../../sdk/new-protocol-plugins.en.rst:300
 msgid ""
 "The **``TxnSMCreate``** function is in the ``TxnSM.c`` file. The first "
 "thing it does is initialize the transaction's data, which is of type "
@@ -428,34 +428,34 @@ msgid ""
 "(**``q_current_handler``**) is set to **``state_start``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:302
+#: ../../sdk/new-protocol-plugins.en.rst:306
 msgid ""
 "**``TxnSMCreate``** then creates a transaction state machine using "
 "**``TSContCreate``**. The handler for the transaction state machine is "
 "**``main_handler``**, which is in the ``TxnSM.c`` file."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:306
+#: ../../sdk/new-protocol-plugins.en.rst:310
 msgid ""
 "When **``accept_event``** receives **``TS_EVENT_NET_ACCEPT``**, it calls "
 "the transaction state machine ( **``TSContCall (txn_sm, 0, NULL);``** ). "
 "The event passed to **``main_handler``** is ``0`` (**``TS_EVENT_NONE``**)."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:311
+#: ../../sdk/new-protocol-plugins.en.rst:315
 msgid ""
 "The first thing **``main_handler``** does is examine the current "
 "**``txn_sm``** state by calling **``TSContDataGet``**. The state is "
 "**``state_start``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:315
+#: ../../sdk/new-protocol-plugins.en.rst:319
 msgid ""
 "**``main_handler``** then invokes the handler for **``state_start``** by "
 "using the function pointer **``TxnSMHandler``** (as defined in ``TxnSM.h``)."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:319
+#: ../../sdk/new-protocol-plugins.en.rst:323
 msgid ""
 "The **``state_start``** handler function (in the ``TxnSM.c`` file) is "
 "handed an event (at this stage, the event is **``TS_EVENT_NET_ACCEPT``**) "
@@ -465,58 +465,58 @@ msgid ""
 "(**``state_start``** is handling the event it receives)."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:327
+#: ../../sdk/new-protocol-plugins.en.rst:331
 msgid ""
 "**``state_start``** changes the current handler to "
 "**``state_interface_with_client``** (that is, it updates the state of the "
 "transaction to the next state)."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:331
+#: ../../sdk/new-protocol-plugins.en.rst:335
 msgid ""
 "**``state_start``** initiates a read of the client vconnection (arranges "
 "for Traffic Server to send **``TS_EVENT_VCONN_READ_READY``** events to the "
 "TSM) by calling **``TSVConnRead``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:336
+#: ../../sdk/new-protocol-plugins.en.rst:340
 msgid ""
 "**``state_interface_with_client``** is activated by the next event from "
 "Traffic Server. It checks for errors and examines the read VIO for the read "
 "operation initiated by **``TSVConnRead``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:340
+#: ../../sdk/new-protocol-plugins.en.rst:344
 msgid ""
 "If the read VIO is the **``client_read_VIO``** (which we are expecting at "
 "this stage in the transaction), then **``state_interface_with_client``** "
 "updates the state to **``state_read_request_from_client``** ."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:345
+#: ../../sdk/new-protocol-plugins.en.rst:349
 msgid ""
 "**``state_read_request_from_client``** handles actual "
 "**``TS_EVENT_READ_READY``** events and reads the client request."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:348
+#: ../../sdk/new-protocol-plugins.en.rst:352
 msgid "**``state_read_request_from_client``** parses the client request."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:350
+#: ../../sdk/new-protocol-plugins.en.rst:354
 msgid ""
 "**``state_read_request_from_client``** updates the current state to the "
 "next state, **``state_handle_cache_lookup``** ."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:353
+#: ../../sdk/new-protocol-plugins.en.rst:357
 msgid ""
 "**``state_read_request_from_client``** arranges for Traffic Server to call "
 "back the TSM with the next set of events (initiating the cache lookup) by "
 "calling **``TSCacheRead``**."
 msgstr ""
 
-#: ../../sdk/new-protocol-plugins.en.rst:357
+#: ../../sdk/new-protocol-plugins.en.rst:361
 msgid ""
 "When the **``TSCacheRead``** sends the TSM either "
 "**``TS_EVENT_OPEN_READ``** (a cache hit) or "

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/preface.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/preface.en.po b/doc/locale/ja/LC_MESSAGES/sdk/preface.en.po
index 77fbecb..879acc6 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/preface.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/preface.en.po
@@ -15,21 +15,6 @@ msgstr ""
 msgid "Preface"
 msgstr ""
 
-#: ../../sdk/preface.en.rst:29
-msgid ""
-"The *Traffic Server Software Developer's Kit* is a reference for creating "
-"plugins. **Plugins** are programs that add services (such as filtering or "
-"content transformation) or entire features (such as new protocol support) "
-"to Traffic Server. If you are new to writing Traffic Server plugins, then "
-"read the first two chapters, :ref:`sdk-getting-started` and :ref:`how-to-"
-"create-to-create-trafficserver-plugins`, and use the remaining chapters as "
-"needed. :ref:`header-based-plugin-examples` provides details about plugins "
-"that work on HTTP headers, while :ref:`http-transformation-plugin` explains "
-"how to write a plugin that transforms or scans the body of an HTTP "
-"response. If you want to support your own protocol on Traffic Server, then "
-"reference :ref:`new-protocol-plugins`."
-msgstr ""
-
 #: ../../sdk/preface.en.rst:41
 msgid "Audience"
 msgstr ""
@@ -41,3 +26,18 @@ msgid ""
 "knowledge of the C programming language, Hyper-Text Transfer Protocol "
 "(HTTP), and Multipurpose Internet Mail Extensions (MIME)."
 msgstr ""
+
+#: ../../sdk/preface.en.rst:29
+msgid ""
+"The *Traffic Server Software Developer's Kit* is a reference for creating "
+"plugins. **Plugins** are programs that add services (such as filtering or "
+"content transformation) or entire features (such as new protocol support) "
+"to Traffic Server. If you are new to writing Traffic Server plugins, then "
+"read the first two chapters, :ref:`sdk-getting-started` and :ref:`how-to-"
+"create-trafficserver-plugins`, and use the remaining chapters as needed. :"
+"ref:`header-based-plugin-examples` provides details about plugins that work "
+"on HTTP headers, while :ref:`http-transformation-plugin` explains how to "
+"write a plugin that transforms or scans the body of an HTTP response. If "
+"you want to support your own protocol on Traffic Server, then reference :"
+"ref:`new-protocol-plugins`."
+msgstr ""

http://git-wip-us.apache.org/repos/asf/trafficserver/blob/285bd7d9/doc/locale/ja/LC_MESSAGES/sdk/preface/how-to-use-this-book.en.po
----------------------------------------------------------------------
diff --git a/doc/locale/ja/LC_MESSAGES/sdk/preface/how-to-use-this-book.en.po b/doc/locale/ja/LC_MESSAGES/sdk/preface/how-to-use-this-book.en.po
index 60abaab..1be4ce4 100644
--- a/doc/locale/ja/LC_MESSAGES/sdk/preface/how-to-use-this-book.en.po
+++ b/doc/locale/ja/LC_MESSAGES/sdk/preface/how-to-use-this-book.en.po
@@ -37,167 +37,167 @@ msgstr ""
 msgid "Reference material"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:32
-msgid ""
-"If you're new to writing Traffic Server plugins, then read `Getting Started "
-"<../getting-started>`_ and `Creating Traffic Server Plugins <../how-to-"
-"create-trafficserver-plugins>`_, and use the remaining chapters as needed. "
-"`Header-Based Plugin Examples <../header-based-plugin-examples>`_ provides "
-"details about plugins that work on HTTP headers, while `HTTP Transformation "
-"Plugins <../http-transformation-plugin>`_ explains how to write a plugin "
-"that transforms or scans the body of an HTTP response. `New Protocol "
-"Plugins <../new-protocol-plugins>`_ provides essential information if you "
-"want to support your own protocol on Traffic Server."
-msgstr ""
-
-#: ../../sdk/preface/how-to-use-this-book.en.rst:43
+#: ../../sdk/preface/how-to-use-this-book.en.rst:41
 msgid "You can look up information in the following reference sections:"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:45
+#: ../../sdk/preface/how-to-use-this-book.en.rst:43
 msgid "`Index <concept-index>`_: lists information by subject"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:46
+#: ../../sdk/preface/how-to-use-this-book.en.rst:44
 msgid ""
 "`Function Index <http://ci.apache.org/projects/trafficserver/trunk/doxygen/"
 ">`_: Doxygen reference"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:49
+#: ../../sdk/preface/how-to-use-this-book.en.rst:47
 msgid ""
 "`Type Index <http://ci.apache.org/projects/trafficserver/trunk/doxygen/"
 "classes.html>`_"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:51
-msgid "`Sample Source Code <../sample-source-code>`_"
-msgstr ""
-
-#: ../../sdk/preface/how-to-use-this-book.en.rst:52
+#: ../../sdk/preface/how-to-use-this-book.en.rst:50
 msgid ""
 "`Deprecated Functions <http://ci.apache.org/projects/trafficserver/trunk/"
 "doxygen/deprecated.html>`_"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:55
+#: ../../sdk/preface/how-to-use-this-book.en.rst:53
 msgid "Below is a section-by-section breakdown of this guide:"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:57
+#: ../../sdk/preface/how-to-use-this-book.en.rst:83
 msgid ""
-"`Getting Started <../getting-started>`_ How to compile and load plugins. "
-"Walks through a simple \"hello world\" example; explains how to initialize "
-"and register plugins."
+"The remaining sections comprise the API function reference and are "
+"organized by function type:"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:61
+#: ../../sdk/preface/how-to-use-this-book.en.rst:126
 msgid ""
-"`How to Create Traffic Server Plugins <../how-to-create-trafficserver-"
-"plugins>`_ Basic structures that all plugins use: events, continuations, "
-"and how to hook on to Traffic Server processes. Detailed explication of a "
-"sample blacklisting plugin."
+"`Function Index <http://ci.apache.org/projects/trafficserver/trunk/doxygen/"
+">`_ Doxygen generated Traffic Server API Documentation"
+msgstr ""
+
+#: ../../sdk/preface/how-to-use-this-book.en.rst:32
+msgid ""
+"If you're new to writing Traffic Server plugins, then read :doc:`../getting-"
+"started.en` and :doc:`../how-to-create-trafficserver-plugins.en`, and use "
+"the remaining chapters as needed. :doc:`../header-based-plugin-examples.en` "
+"provides details about plugins that work on HTTP headers, while :doc:`../"
+"http-transformation-plugin.en` explains how to write a plugin that "
+"transforms or scans the body of an HTTP response. :doc:`../new-protocol-"
+"plugins.en` provides essential information if you want to support your own "
+"protocol on Traffic Server."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:67
+#: ../../sdk/preface/how-to-use-this-book.en.rst:49
+msgid ":doc:`Sample Source Code <../sample-source-code.en>`"
+msgstr ""
+
+#: ../../sdk/preface/how-to-use-this-book.en.rst:55
 msgid ""
-"`Remap Plugin <../remap-plugin>`_ This chapter demonstrates on a practical "
-"example how you can exploit the Traffic Server remap API for your plugins."
+":doc:`Getting Started <../getting-started.en>` How to compile and load "
+"plugins. Walks through a simple \"hello world\" example; explains how to "
+"initialize and register plugins."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:71
+#: ../../sdk/preface/how-to-use-this-book.en.rst:59
 msgid ""
-"`Header-Based Plugin Examples <../header-based-plugin-examples>`_ Detailed "
-"explanation about writing plugins that work on HTTP headers; discusses "
-"sample blacklisting and basic authorization plugins."
+":doc:`How to Create Traffic Server Plugins <../how-to-create-trafficserver-"
+"plugins.en>` Basic structures that all plugins use: events, continuations, "
+"and how to hook on to Traffic Server processes. Detailed explication of a "
+"sample blacklisting plugin."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:76
+#: ../../sdk/preface/how-to-use-this-book.en.rst:65
 msgid ""
-"`HTTP Transformation Plugins <../http-transformation-plugin>`_ Detailed "
-"explanation of the null-transform example; also discusses ``VConnections``, "
-"``VIOs``, and IO buffers."
+":doc:`Remap Plugin <../remap-plugin.en>` This chapter demonstrates on a "
+"practical example how you can exploit the Traffic Server remap API for your "
+"plugins."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:80
+#: ../../sdk/preface/how-to-use-this-book.en.rst:69
 msgid ""
-"`New Protocol Plugins <../new-protocol-plugins>`_ Detailed explanation of a "
-"sample protocol plugin that supports a synthetic protocol. Discusses "
-"``VConnections`` and mutexes, as well as the new ``NetConnection``, DNS "
-"lookup, logging, and cache APIs."
+":doc:`Header-Based Plugin Examples <../header-based-plugin-examples.en>` "
+"Detailed explanation about writing plugins that work on HTTP headers; "
+"discusses sample blacklisting and basic authorization plugins."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:85
+#: ../../sdk/preface/how-to-use-this-book.en.rst:74
 msgid ""
-"The remaining sections comprise the API function reference and are "
-"organized by function type:"
+":doc:`HTTP Transformation Plugins <../http-transformation-plugin.en>` "
+"Detailed explanation of the null-transform example; also discusses "
+"``VConnections``, ``VIOs``, and IO buffers."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:88
+#: ../../sdk/preface/how-to-use-this-book.en.rst:78
 msgid ""
-"`Miscellaneous Interface Guide <../misc-interface-guide>`_ Details error-"
-"writing and tracing functions, thread functions, and Traffic Server API "
-"versions of the ``malloc`` and ``fopen`` families. The Traffic Server API "
-"versions overcome various C library limitations."
+":doc:`New Protocol Plugins <../new-protocol-plugins.en>` Detailed "
+"explanation of a sample protocol plugin that supports a synthetic protocol. "
+"Discusses ``VConnections`` and mutexes, as well as the new "
+"``NetConnection``, DNS lookup, logging, and cache APIs."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:94
+#: ../../sdk/preface/how-to-use-this-book.en.rst:86
 msgid ""
-"`HTTP Hooks and Transactions <../http-hoooks-and-transactions>`_ Functions "
-"in this chapter hook your plugin to Traffic Server HTTP processes."
+":doc:`Miscellaneous Interface Guide <../misc-interface-guide.en>` Details "
+"error-writing and tracing functions, thread functions, and Traffic Server "
+"API versions of the ``malloc`` and ``fopen`` families. The Traffic Server "
+"API versions overcome various C library limitations."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:98
+#: ../../sdk/preface/how-to-use-this-book.en.rst:92
 msgid ""
-"`HTTP Headers <../http-headers>`_ Contains instructions for implementing "
-"performance enhancements for all plugins that manipulate HTTP headers. "
-"These functions examine and modify HTTP headers, MIME headers, URLs, and "
-"the marshal buffers that contain header information. If you are working "
-"with headers, then be sure to read this chapter."
+":doc:`HTTP Hooks and Transactions <../http-hooks-and-transactions.en>` "
+"Functions in this chapter hook your plugin to Traffic Server HTTP processes."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:105
-msgid "`Mutex Guide <../mutex-guide>`_"
+#: ../../sdk/preface/how-to-use-this-book.en.rst:96
+msgid ""
+":doc:`HTTP Headers <../http-headers.en>` Contains instructions for "
+"implementing performance enhancements for all plugins that manipulate HTTP "
+"headers. These functions examine and modify HTTP headers, MIME headers, "
+"URLs, and the marshal buffers that contain header information. If you are "
+"working with headers, then be sure to read this chapter."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:107
+#: ../../sdk/preface/how-to-use-this-book.en.rst:103
+msgid ":doc:`Mutex Guide <../mutex-guide.en>`"
+msgstr ""
+
+#: ../../sdk/preface/how-to-use-this-book.en.rst:105
 msgid ""
-"`Continuations <../continuations>`_ Continuations provide the basic "
+":doc:`Continuations <../continuations.en>` Continuations provide the basic "
 "callback mechanism and data abstractions used in Traffic Server."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:111
-msgid "`Plugin Configurations <../plugin-configurations>`_"
+#: ../../sdk/preface/how-to-use-this-book.en.rst:109
+msgid ":doc:`Plugin Configurations <../plugin-configurations.en>`"
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:113
+#: ../../sdk/preface/how-to-use-this-book.en.rst:111
 msgid ""
-"`Actions Guide <../actions-guide>`_ Describes how to use ``TSActions`` and "
-"the ``TSDNSLookup`` API."
+":doc:`Actions Guide <../actions-guide.en>` Describes how to use "
+"``TSActions`` and the ``TSDNSLookup`` API."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:116
+#: ../../sdk/preface/how-to-use-this-book.en.rst:114
 msgid ""
-"`IO Guide <../io-guide>`_ Describes how to use the Traffic Server IO "
+":doc:`IO Guide <../io-guide.en>` Describes how to use the Traffic Server IO "
 "interfaces: ``TSVConnection``, ``TSVIO``, ``TSIOBuffer``, "
 "``TSNetVConnection``, the Cache API."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:121
+#: ../../sdk/preface/how-to-use-this-book.en.rst:119
 msgid ""
-"`Plugin Management <../plugin-management>`_ These functions enable you to "
-"set up a configuration interface for plugins, access installed plugin "
-"files, and set up plugin licensing."
+":doc:`Plugin Management <../plugin-management.en>` These functions enable "
+"you to set up a configuration interface for plugins, access installed "
+"plugin files, and set up plugin licensing."
 msgstr ""
 
-#: ../../sdk/preface/how-to-use-this-book.en.rst:125
+#: ../../sdk/preface/how-to-use-this-book.en.rst:123
 msgid ""
-"`Adding Statistics <../adding-statistics>`_ These functions add statistics "
-"to your plugin."
-msgstr ""
-
-#: ../../sdk/preface/how-to-use-this-book.en.rst:128
-msgid ""
-"`Function Index <http://ci.apache.org/projects/trafficserver/trunk/doxygen/"
-">`_ Doxygen generated Traffic Server API Documentation"
+":doc:`Adding Statistics <../adding-statistics.en>` These functions add "
+"statistics to your plugin."
 msgstr ""