From 54789c07a901b84cfa17f8775e2e01caa31a340d Mon Sep 17 00:00:00 2001
From: Luca Toscano <elukey@apache.org>
Date: Tue, 13 Sep 2016 06:24:08 +0000
Subject: [PATCH] mod_proxy_html doc - Added a reference of ProxyHTMLLinks in
 the ProxyHTMLURLMap description and some examples.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1760479 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_proxy_html.xml | 33 +++++++++++++++++++++++++-----
 1 file changed, 28 insertions(+), 5 deletions(-)

diff --git a/docs/manual/mod/mod_proxy_html.xml b/docs/manual/mod/mod_proxy_html.xml
index eeed13e5f9..bc0ee6e49e 100644
--- a/docs/manual/mod/mod_proxy_html.xml
+++ b/docs/manual/mod/mod_proxy_html.xml
@@ -124,11 +124,14 @@ module for earlier 2.x versions.</compatibility>
 module for earlier 2.x versions.</compatibility>
 
 <usage>
-<p>This is the key directive for rewriting HTML links.  When parsing a document,
+<p>This is the key directive for rewriting HTML links. When parsing a document,
 whenever a link target matches <var>from-pattern</var>, the matching
 portion will be rewritten to <var>to-pattern</var>, as modified by any
-flags supplied and by the <directive>ProxyHTMLExtended</directive>
-directive.</p>
+flags supplied and by the 
+<directive module="mod_proxy_html">ProxyHTMLExtended</directive> directive.
+Only the elements specified using
+the <directive module="mod_proxy_html">ProxyHTMLLinks</directive> directive
+will be considered as HTML links.</p>
 
 <p>The optional third argument may define any of the following
 <strong>Flags</strong>.  Flags are case-sensitive.</p>
@@ -386,13 +389,33 @@ and defines the events in standard HTML 4 and XHTML 1.</p>
 for earlier 2.x versions</compatibility>
 <usage>
 <p>Specifies elements that have URL attributes that should be rewritten
-using standard <directive>ProxyHTMLURLMap</directive>s.  You will need one
-ProxyHTMLLinks directive per element, but it can have any number of attributes.</p>
+using standard <directive module="mod_proxy_html">ProxyHTMLURLMap</directive>s.
+You will need one ProxyHTMLLinks directive per element,
+but it can have any number of attributes.</p>
 <p>Normally you'll set this globally.  If you set ProxyHTMLLinks in more than
 one scope so that one overrides the other, you'll need to specify a complete
 set in each of those scopes.</p>
 <p>A default configuration is supplied in <var>proxy-html.conf</var>
 and defines the HTML links for standard HTML 4 and XHTML 1.</p>
+<example>
+<title>Examples from proxy-html.conf</title>
+<highlight language="config">
+ProxyHTMLLinks  a          href
+ProxyHTMLLinks  area       href
+ProxyHTMLLinks  link       href
+ProxyHTMLLinks  img        src longdesc usemap
+ProxyHTMLLinks  object     classid codebase data usemap
+ProxyHTMLLinks  q          cite
+ProxyHTMLLinks  blockquote cite
+ProxyHTMLLinks  ins        cite
+ProxyHTMLLinks  del        cite
+ProxyHTMLLinks  form       action
+ProxyHTMLLinks  input      src usemap
+ProxyHTMLLinks  head       profile
+ProxyHTMLLinks  base       href
+ProxyHTMLLinks  script     src for
+</highlight>
+</example>
 </usage>
 </directivesynopsis>
 
-- 
2.49.0