diff options
Diffstat (limited to 'docs/progGuideDB/preface.xml')
| -rw-r--r-- | docs/progGuideDB/preface.xml | 88 |
1 files changed, 51 insertions, 37 deletions
diff --git a/docs/progGuideDB/preface.xml b/docs/progGuideDB/preface.xml index d4a7022d1..1ad7b382b 100644 --- a/docs/progGuideDB/preface.xml +++ b/docs/progGuideDB/preface.xml @@ -1,52 +1,66 @@ -<preface> - <title>Preface</title> - +<preface id="preface"> + <title>Preface</title> + <para> - This user's guide does three things. It + This programming guide does three things. It + <itemizedlist spacing="compact"> <listitem> - <para>introduces the AspectJ language</para> - </listitem> + <para>introduces the AspectJ language</para> + </listitem> <listitem> - <para> - defines each of AspectJ's constructs and their semantics, and</para> + <para> + defines each of AspectJ's constructs and their semantics, and + </para> </listitem> <listitem> - <para> - provides examples of their use.</para> + <para> + provides examples of their use. + </para> </listitem> </itemizedlist> - Appendices give a quick reference and a more formal definition of - AspectJ. + + It includes appendices that give a reference to the syntax of AspectJ, + a more formal description of AspectJ's semantics, and a description of + limitations allowed by AspectJ implementations. </para> - <para>The first section, <xref linkend="gettingstarted" />, provides a gentle - overview of writing AspectJ programs. It also shows how one can introduce - AspectJ into an existing development effort in stages, reducing the - associated risk. You should read this section if this is your first - exposure to AspectJ and you want to get a sense of what AspectJ is all - about.</para> - - <para>The second section, <xref linkend="aspectjlanguage" />, covers the - features of the language in more detail, using code snippets as examples. - The entire language is covered, and after reading this section, you should - be able to use all the features of the language correctly.</para> - - <para>The next section, <xref linkend="examples" />, comprises a set of - complete programs that not only show the features being used, but also try - to illustrate recommended practice. You should read this section after you - are familiar with the elements of AspectJ.</para> - - <para>The back matter contains several appendices that cover AspectJ's - semantics, a quick reference to the language, a glossary of terms and the - index.</para> + <para> + The first section, <xref linkend="starting" />, provides a gentle + overview of writing AspectJ programs. It also shows how one can + introduce AspectJ into an existing development effort in stages, + reducing the associated risk. You should read this section if this is + your first exposure to AspectJ and you want to get a sense of what + AspectJ is all about. + </para> -</preface> + <para> + The second section, <xref linkend="language" />, covers the features of + the language in more detail, using code snippets as examples. All the + basics of the language is covered, and after reading this section, you + should be able to use the language correctly. + </para> -<!-- Local variables: --> -<!-- sgml-local-ecat-files: progguide.ced --> -<!-- sgml-parent-document:("progguide.sgml" "book" "preface") --> -<!-- End: --> + <para> + The next section, <xref linkend="examples" />, comprises a set of + complete programs that not only show the features being used, but also + try to illustrate recommended practice. You should read this section + after you are familiar with the elements of AspectJ. + </para> + + <para> + Finally, there are two short chapters, one on <xref linkend="idioms" /> + and one on <xref linkend="pitfalls" />. + </para> + <para> + The back matter contains several appendices that cover a <xref + linkend="quick">quick reference</xref> to the language's syntax, a more + in depth coverage of its <xref linkend="semantics">semantics</xref>, + and a description of the latitude enjoyed by its <xref + linkend="limitations">implementations</xref>. + </para> + +</preface> |