summaryrefslogtreecommitdiffstats
path: root/docs/progGuideDB/preface.xml
blob: d4a7022d1b18d031e3d3f92b90f33508b570f63f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
<preface>
  <title>Preface</title> 
  
  <para>
    This user's guide does three things. It
    <itemizedlist spacing="compact">
      <listitem>
	<para>introduces the AspectJ language</para>
      </listitem> 

      <listitem>
	<para>
	  defines each of AspectJ's constructs and their semantics, and</para>
      </listitem>

      <listitem>
	<para>
	  provides examples of their use.</para>
      </listitem>
    </itemizedlist>
    Appendices give a quick reference and a more formal definition of
    AspectJ.
  </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>

</preface>

<!-- Local variables: -->
<!-- sgml-local-ecat-files: progguide.ced -->
<!-- sgml-parent-document:("progguide.sgml" "book" "preface") -->
<!-- End: -->