summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authoracolyer <acolyer>2005-04-10 12:33:40 +0000
committeracolyer <acolyer>2005-04-10 12:33:40 +0000
commitd09f86f3551c500323606a765b74a0028aeaec60 (patch)
treea94c976c6f69e8a97c552a91a71dba54a51c27c5
parente5339af220a450bbeca7b72c6d9118c1ded56308 (diff)
downloadaspectj-d09f86f3551c500323606a765b74a0028aeaec60.tar.gz
aspectj-d09f86f3551c500323606a765b74a0028aeaec60.zip
add some style to our guides ;)
-rw-r--r--docs/adk15ProgGuideDB/annotations.xml209
-rw-r--r--docs/adk15ProgGuideDB/aspectj-docs.css83
-rw-r--r--docs/adk15ProgGuideDB/dd_arrow.gifbin0 -> 851 bytes
-rw-r--r--docs/adk15ProgGuideDB/reflection.xml13
-rw-r--r--docs/build.xml6
-rw-r--r--docs/devGuideDB/aspectj-docs.css83
-rw-r--r--docs/devGuideDB/dd_arrow.gifbin0 -> 851 bytes
-rw-r--r--docs/progGuideDB/aspectj-docs.css83
-rw-r--r--docs/progGuideDB/dd_arrow.gifbin0 -> 851 bytes
-rw-r--r--docs/progGuideDB/semantics.xml5
-rw-r--r--lib/docbook/docbook-xsl/html/param.xsl2
11 files changed, 394 insertions, 90 deletions
diff --git a/docs/adk15ProgGuideDB/annotations.xml b/docs/adk15ProgGuideDB/annotations.xml
index 83f3311d7..2cde28bef 100644
--- a/docs/adk15ProgGuideDB/annotations.xml
+++ b/docs/adk15ProgGuideDB/annotations.xml
@@ -341,47 +341,65 @@
<para>Some examples of annotation patterns follow:</para>
- <programlisting><![CDATA[
- @Immutable
- ]]></programlisting>
-
- <para>Matches any annotated element which has an annotation of
- type <literal>Immutable</literal>.</para>
-
- <programlisting><![CDATA[
- !@Persistent
- ]]></programlisting>
+ <variablelist>
- <para>Matches any annotated element which does not have an annotation of
- type <literal>Persistent</literal>.</para>
-
- <programlisting><![CDATA[
- @Foo @Goo
- ]]></programlisting>
-
- <para>Matches any annotated element which has both an annotation of type <literal>Foo</literal> and
- an annotation of type <literal>Goo</literal>.</para>
+ <varlistentry>
+ <term>@Immutable</term>
+ <listitem>
+ <para>
+ Matches any annotated element which has an annotation of
+ type <literal>Immutable</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
- <programlisting><![CDATA[
- @(Foo || Goo)
- ]]></programlisting>
+ <varlistentry>
+ <term>!@Persistent</term>
+ <listitem>
+ <para>
+ Matches any annotated element which does not have an annotation of
+ type <literal>Persistent</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
- <para>Matches any annotated element which has either an annotation of a type matching
- the type pattern <literal>(Foo || Goo)</literal>.
- In other words, an annotated element with either an
- annotation of type <literal>Foo</literal> or
- an annotation of type <literal>Goo</literal> (or both). (The parenthesis are required in this example).
- </para>
+ <varlistentry>
+ <term>@Foo @Goo</term>
+ <listitem>
+ <para>
+ Matches any annotated element which has both an annotation of type <literal>Foo</literal> and
+ an annotation of type <literal>Goo</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
- <programlisting><![CDATA[
- @(org.xyz..*)
- ]]></programlisting>
+ <varlistentry>
+ <term>@(Foo || Goo)</term>
+ <listitem>
+ <para>
+ Matches any annotated element which has either an annotation of a type matching
+ the type pattern <literal>(Foo || Goo)</literal>.
+ In other words, an annotated element with either an
+ annotation of type <literal>Foo</literal> or
+ an annotation of type <literal>Goo</literal> (or both). (The parenthesis are required in this example).
+ </para>
+ </listitem>
+ </varlistentry>
- <para>Matches any annotated element which has either an annotation of a type matching
- the type pattern <literal>(org.xyz..*)</literal>.
- In other words, an annotated element with an annotation that is declared in the
- org.xyz package or a sub-package. (The parenthesis are required in this example).</para>
+ <varlistentry>
+ <term>@(org.xyz..*)</term>
+ <listitem>
+ <para>
+ Matches any annotated element which has either an annotation of a type matching
+ the type pattern <literal>(org.xyz..*)</literal>.
+ In other words, an annotated element with an annotation that is declared in the
+ org.xyz package or a sub-package. (The parenthesis are required in this example).
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
</sect2>
<sect2>
@@ -425,64 +443,83 @@
patterns:
</para>
- <programlisting><![CDATA[
- (@Immutable *)
- ]]></programlisting>
+ <variablelist>
- <para>Matches any type with an <literal>@Immutable</literal> annotation.</para>
+ <varlistentry>
+ <term>(@Immutable *)</term>
+ <listitem>
+ <para>
+ Matches any type with an <literal>@Immutable</literal> annotation.
+ </para>
+ </listitem>
+ </varlistentry>
- <programlisting><![CDATA[
- (!@Immutable *)
- ]]></programlisting>
+ <varlistentry>
+ <term>(!@Immutable *)</term>
+ <listitem>
+ <para>
+ Matches any type which does not have an <literal>@Immutable</literal> annotation.
+ </para>
+ </listitem>
+ </varlistentry>
- <para>Matches any type which does not have an <literal>@Immutable</literal> annotation.</para>
+ <varlistentry>
+ <term> (@Immutable (org.xyz.* || org.abc.*))</term>
+ <listitem>
+ <para>
+ Matches any type in the <literal>org.xyz</literal> or <literal>org.abc</literal>
+ packages with the <literal>@Immutable</literal> annotation.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>((@Immutable Foo+) || Goo)</term>
+ <listitem>
+ <para>
+ Matches a type <literal>Foo</literal> or any of its subtypes, which have the <literal>@Immutable</literal>
+ annotation, or a type <literal>Goo</literal>.
+ </para>
+ </listitem>
+ </varlistentry>
- <programlisting><![CDATA[
- (@Immutable (org.xyz.* || org.abc.*))
- ]]></programlisting>
+ <varlistentry>
+ <term>((@(Immutable || NonPersistent) org.xyz..*)</term>
+ <listitem>
+ <para>
+ Matches any type in a package beginning with the prefix <literal>org.xyz</literal>,
+ which has either the <literal>@Immutable</literal> annotation or the
+ <literal>@NonPersistent</literal> annotation.
+ </para>
+ </listitem>
+ </varlistentry>
- <para>Matches any type in the <literal>org.xyz</literal> or <literal>org.abc</literal>
- packages with the <literal>@Immutable</literal> annotation.</para>
+ <varlistentry>
+ <term>(@Immutable @NonPersistent org.xyz..*)</term>
+ <listitem>
+ <para>
+ Matches any type in a package beginning with the prefix <literal>org.xyz</literal>,
+ which has both an <literal>@Immutable</literal> annotation and an
+ <literal>@NonPersistent</literal> annotation.
+ </para>
+ </listitem>
+ </varlistentry>
- <programlisting><![CDATA[
- ((@Immutable Foo+) || Goo)
- ]]></programlisting>
+ <varlistentry>
+ <term> (@(@Inherited *) org.xyz..*)</term>
+ <listitem>
+ <para>
+ Matches any type in a package beginning with the prefix <literal>org.xyz</literal>,
+ which has an inheritable annotation. The annotation pattern
+ <literal>@(@Inherited *)</literal> matches any annotation of a type matching the
+ type pattern <literal>@Inherited *</literal>, which in turn matches any type with the
+ <literal>@Inherited</literal> annotation.
+ </para>
+ </listitem>
+ </varlistentry>
- <para>Matches a type <literal>Foo</literal> or any of its subtypes, which have the <literal>@Immutable</literal>
- annotation, or a type <literal>Goo</literal>.</para>
-
- <programlisting><![CDATA[
- ((@(Immutable || NonPersistent) org.xyz..*)
- ]]></programlisting>
-
- <para>
- Matches any type in a package beginning with the prefix <literal>org.xyz</literal>,
- which has either the <literal>@Immutable</literal> annotation or the
- <literal>@NonPersistent</literal> annotation.
- </para>
-
- <programlisting><![CDATA[
- (@Immutable @NonPersistent org.xyz..*)
- ]]></programlisting>
-
- <para>
- Matches any type in a package beginning with the prefix <literal>org.xyz</literal>,
- which has both an <literal>@Immutable</literal> annotation and an
- <literal>@NonPersistent</literal> annotation.
- </para>
-
- <programlisting><![CDATA[
- (@(@Inherited *) org.xyz..*)
- ]]></programlisting>
-
- <para>
- Matches any type in a package beginning with the prefix <literal>org.xyz</literal>,
- which has an inheritable annotation. The annotation pattern
- <literal>@(@Inherited *)</literal> matches any annotation of a type matching the
- type pattern <literal>@Inherited *</literal>, which in turn matches any type with the
- <literal>@Inherited</literal> annotation.
- </para>
-
+ </variablelist>
+
</sect2>
<sect2 id="signaturePatterns" xreflabel="Signature Patterns">
diff --git a/docs/adk15ProgGuideDB/aspectj-docs.css b/docs/adk15ProgGuideDB/aspectj-docs.css
new file mode 100644
index 000000000..3f58ddb57
--- /dev/null
+++ b/docs/adk15ProgGuideDB/aspectj-docs.css
@@ -0,0 +1,83 @@
+body {
+ font-family: "Lucida Grande", "Trebuchet MS", sans-serif;
+ line-height: 1.1em;
+ }
+
+h2 {
+ font-size: 130%;
+ font-weight: bold ;
+ line-height: 16px;
+ color: #FFFFFF;
+ background-color: #0080C0;
+ padding: 5px;
+}
+
+h3 {
+ font-size: 110%;
+ font-weight: bold ;
+ line-height: 14px;
+ color: #FFFFFF;
+ background-color: orange;
+ padding: 5px;
+}
+
+tt {
+ font-size: 120%;
+ color: #0080C0;
+ }
+
+tt tt {
+ font-size: 100%;
+ }
+
+.programlisting {
+ padding-top: 5px;
+ border: 2px solid #ccc;
+ background: #eee;
+ font-size: 120%;
+ color: #111199;
+
+ }
+
+.term {
+ color: #111199;
+ }
+
+.variablelist dd {
+ margin-left: 18px;
+ padding-left: 20px;
+ background: url(dd_arrow.gif) no-repeat 0 2px;
+ }
+
+.toc dt {
+ font-size: 110%;
+ padding-bottom: 0px;
+ margin-bottom: 5px;
+ }
+
+.toc dl dd dt {
+ font-size: 100%;
+ }
+
+.toc dt {
+ font-size: 100%
+ margin-bottom: 0;
+ }
+
+.informaltable table {
+ margin-left: 5%;
+ }
+
+.informaltable th {
+ background-color: orange;
+ padding: 1px;
+ }
+
+ul li {
+ line-height: 1.2em;
+ }
+
+.keyword {
+ font-weight: bold;
+ color: purple;
+ } \ No newline at end of file
diff --git a/docs/adk15ProgGuideDB/dd_arrow.gif b/docs/adk15ProgGuideDB/dd_arrow.gif
new file mode 100644
index 000000000..a16b34c95
--- /dev/null
+++ b/docs/adk15ProgGuideDB/dd_arrow.gif
Binary files differ
diff --git a/docs/adk15ProgGuideDB/reflection.xml b/docs/adk15ProgGuideDB/reflection.xml
index a412ab86e..9afde22c4 100644
--- a/docs/adk15ProgGuideDB/reflection.xml
+++ b/docs/adk15ProgGuideDB/reflection.xml
@@ -2,5 +2,18 @@
<title>New Reflection Interfaces</title>
+ <para>
+ AspectJ 5 provides support for runtime reflection of aspect types. The class <literal>Aspect</literal> is
+ analogous to the Java class <literal>Class</literal> and provides access to the members of an aspect.
+ </para>
+
+ <sect1 id="reflection_api">
+ <title>The Aspect Class</title>
+ <para>
+
+ </para>
+
+ </sect1>
+
</chapter>
diff --git a/docs/build.xml b/docs/build.xml
index 814a7f6d0..9dff6c836 100644
--- a/docs/build.xml
+++ b/docs/build.xml
@@ -269,6 +269,8 @@
<antcall target="build-guide">
<param name="guide.dir" value="progGuideDB" />
<param name="guide.name" value="progguide" />
+ <param name="xml-html-copy"
+ value="dd_arrow.gif,aspects.gif,figureUML.gif,overview.gif,telecom.gif,aspectj-docs.css"/>
</antcall>
</target>
@@ -276,6 +278,8 @@
<antcall target="build-guide">
<param name="guide.dir" value="adk15ProgGuideDB" />
<param name="guide.name" value="adk15notebook" />
+ <param name="xml-html-copy"
+ value="dd_arrow.gif,aspectj-docs.css"/>
</antcall>
</target>
@@ -298,7 +302,7 @@
<antcall target="build-guide">
<param name="xml-html-copy"
- value="ajbrowser-building.gif,ajbrowser-options.gif,${include.devguide.icons}"
+ value="dd_arrow.gif,aspectj-docs.css,ajbrowser-building.gif,ajbrowser-options.gif,${include.devguide.icons}"
/>
<param name="guide.dir" value="devGuideDB" />
<param name="guide.name" value="devguide" />
diff --git a/docs/devGuideDB/aspectj-docs.css b/docs/devGuideDB/aspectj-docs.css
new file mode 100644
index 000000000..3f58ddb57
--- /dev/null
+++ b/docs/devGuideDB/aspectj-docs.css
@@ -0,0 +1,83 @@
+body {
+ font-family: "Lucida Grande", "Trebuchet MS", sans-serif;
+ line-height: 1.1em;
+ }
+
+h2 {
+ font-size: 130%;
+ font-weight: bold ;
+ line-height: 16px;
+ color: #FFFFFF;
+ background-color: #0080C0;
+ padding: 5px;
+}
+
+h3 {
+ font-size: 110%;
+ font-weight: bold ;
+ line-height: 14px;
+ color: #FFFFFF;
+ background-color: orange;
+ padding: 5px;
+}
+
+tt {
+ font-size: 120%;
+ color: #0080C0;
+ }
+
+tt tt {
+ font-size: 100%;
+ }
+
+.programlisting {
+ padding-top: 5px;
+ border: 2px solid #ccc;
+ background: #eee;
+ font-size: 120%;
+ color: #111199;
+
+ }
+
+.term {
+ color: #111199;
+ }
+
+.variablelist dd {
+ margin-left: 18px;
+ padding-left: 20px;
+ background: url(dd_arrow.gif) no-repeat 0 2px;
+ }
+
+.toc dt {
+ font-size: 110%;
+ padding-bottom: 0px;
+ margin-bottom: 5px;
+ }
+
+.toc dl dd dt {
+ font-size: 100%;
+ }
+
+.toc dt {
+ font-size: 100%
+ margin-bottom: 0;
+ }
+
+.informaltable table {
+ margin-left: 5%;
+ }
+
+.informaltable th {
+ background-color: orange;
+ padding: 1px;
+ }
+
+ul li {
+ line-height: 1.2em;
+ }
+
+.keyword {
+ font-weight: bold;
+ color: purple;
+ } \ No newline at end of file
diff --git a/docs/devGuideDB/dd_arrow.gif b/docs/devGuideDB/dd_arrow.gif
new file mode 100644
index 000000000..a16b34c95
--- /dev/null
+++ b/docs/devGuideDB/dd_arrow.gif
Binary files differ
diff --git a/docs/progGuideDB/aspectj-docs.css b/docs/progGuideDB/aspectj-docs.css
new file mode 100644
index 000000000..3f58ddb57
--- /dev/null
+++ b/docs/progGuideDB/aspectj-docs.css
@@ -0,0 +1,83 @@
+body {
+ font-family: "Lucida Grande", "Trebuchet MS", sans-serif;
+ line-height: 1.1em;
+ }
+
+h2 {
+ font-size: 130%;
+ font-weight: bold ;
+ line-height: 16px;
+ color: #FFFFFF;
+ background-color: #0080C0;
+ padding: 5px;
+}
+
+h3 {
+ font-size: 110%;
+ font-weight: bold ;
+ line-height: 14px;
+ color: #FFFFFF;
+ background-color: orange;
+ padding: 5px;
+}
+
+tt {
+ font-size: 120%;
+ color: #0080C0;
+ }
+
+tt tt {
+ font-size: 100%;
+ }
+
+.programlisting {
+ padding-top: 5px;
+ border: 2px solid #ccc;
+ background: #eee;
+ font-size: 120%;
+ color: #111199;
+
+ }
+
+.term {
+ color: #111199;
+ }
+
+.variablelist dd {
+ margin-left: 18px;
+ padding-left: 20px;
+ background: url(dd_arrow.gif) no-repeat 0 2px;
+ }
+
+.toc dt {
+ font-size: 110%;
+ padding-bottom: 0px;
+ margin-bottom: 5px;
+ }
+
+.toc dl dd dt {
+ font-size: 100%;
+ }
+
+.toc dt {
+ font-size: 100%
+ margin-bottom: 0;
+ }
+
+.informaltable table {
+ margin-left: 5%;
+ }
+
+.informaltable th {
+ background-color: orange;
+ padding: 1px;
+ }
+
+ul li {
+ line-height: 1.2em;
+ }
+
+.keyword {
+ font-weight: bold;
+ color: purple;
+ } \ No newline at end of file
diff --git a/docs/progGuideDB/dd_arrow.gif b/docs/progGuideDB/dd_arrow.gif
new file mode 100644
index 000000000..a16b34c95
--- /dev/null
+++ b/docs/progGuideDB/dd_arrow.gif
Binary files differ
diff --git a/docs/progGuideDB/semantics.xml b/docs/progGuideDB/semantics.xml
index b04f5a9aa..cf5740fde 100644
--- a/docs/progGuideDB/semantics.xml
+++ b/docs/progGuideDB/semantics.xml
@@ -209,14 +209,15 @@
<informaltable frame="1">
<tgroup cols="4" align="left">
- <tbody valign="top">
+ <thead valign="top">
<row>
<entry><emphasis role="bold">Join Point</emphasis></entry>
<entry><emphasis role="bold">Current Object</emphasis></entry>
<entry><emphasis role="bold">Target Object</emphasis></entry>
<entry><emphasis role="bold">Arguments</emphasis></entry>
</row>
-
+ </thead>
+ <tbody>
<row>
<entry>Method Call</entry>
<entry>executing object*</entry>
diff --git a/lib/docbook/docbook-xsl/html/param.xsl b/lib/docbook/docbook-xsl/html/param.xsl
index 4851478a7..9bffb4966 100644
--- a/lib/docbook/docbook-xsl/html/param.xsl
+++ b/lib/docbook/docbook-xsl/html/param.xsl
@@ -86,7 +86,7 @@ is suppressed.
</doc:param>
<!-- ==================================================================== -->
-<xsl:param name="html.stylesheet" select="''" doc:type='string'/>
+<xsl:param name="html.stylesheet" doc:type='string'>aspectj-docs.css</xsl:param>
<doc:param name="html.stylesheet" xmlns="">
<refpurpose>Name of the stylesheet to use in the generated HTML</refpurpose>