From 91de75500ffc36aa01a7a5c9b27bc5e8f740468c Mon Sep 17 00:00:00 2001
From: Steven Watanabe <steven@providere-consulting.com>
Date: Thu, 5 Apr 2012 14:41:47 +0000
Subject: [PATCH] Add a synopsis to abstract-target

[SVN r77781]
---
 v2/doc/src/abstract-target.xml | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

diff --git a/v2/doc/src/abstract-target.xml b/v2/doc/src/abstract-target.xml
index 252253054..dad53380c 100644
--- a/v2/doc/src/abstract-target.xml
+++ b/v2/doc/src/abstract-target.xml
@@ -13,6 +13,17 @@
     Base class for all abstract targets.
   </para>
 
+<programlisting language="jam">
+class abstract-target {
+    rule <link linkend="bbv2.reference.class.abstract-target.__init__">__init__</link> ( name : project )
+    rule <link linkend="bbv2.reference.class.abstract-target.name">name</link> ( )
+    rule <link linkend="bbv2.reference.class.abstract-target.project">project</link> ( )
+    rule <link linkend="bbv2.reference.class.abstract-target.location">location</link> ( )
+    rule <link linkend="bbv2.reference.class.abstract-target.full-name">full-name</link> ( )
+    rule <link linkend="bbv2.reference.class.abstract-target.__init__">generate</link> ( property-set )
+}
+</programlisting>
+
   <para>
     Classes derived from <link linkend="bbv2.reference.class.abstract-target">abstract-target</link>:
     <itemizedlist>
@@ -31,19 +42,19 @@
   <orderedlist>
     
     <listitem id="bbv2.reference.class.abstract-target.__init__">
-      <code language="jam">rule __init__ ( name : project-target )</code>
+      <code language="jam">rule __init__ ( name : project )</code>
       <para>
         <variablelist>
           <varlistentry>
-            <literal>name</literal>
+            <term><literal>name</literal></term>
             <listitem>
-              <para>Name of the target in Jamfile.</para>
+              <para>The name of the target in the Jamfile.</para>
             </listitem>
-          </varlistentry>          
+          </varlistentry>
           <varlistentry>
-            <literal>project-target</literal>
+            <term><literal>project</literal></term>
             <listitem>
-              <para>The project target to which this one belongs.</para>
+              <para>The <link linkend="bbv2.reference.class.project-target">project</link> to which this target belongs.</para>
             </listitem>
           </varlistentry>
         </variablelist>
@@ -65,7 +76,7 @@
         <secondary>Abstract Target</secondary>
       </indexterm>
       <code language="jam">rule project ( )</code>
-      <para>Returns the project for this target.</para>
+      <para>Returns the <link linkend="bbv2.reference.class.project-target">project</link> for this target.</para>
     </listitem>
 
     <listitem id="bbv2.reference.class.abstract-target.location">
@@ -74,7 +85,7 @@
         <secondary>Abstract Target</secondary>
       </indexterm>
       <code language="jam">rule location ( )</code>
-      <para>Return the location where the target was declared.</para>
+      <para>Returns the location where the target was declared.</para>
     </listitem>
 
     <listitem id="bbv2.reference.class.abstract-target.full-name">