APT linux command manual

XXX
XXX WARNING: old character encoding and/or character set
XXX
apt(1)								       apt(1)



NAME
       apt - annotation processing tool

SYNOPSIS
       apt [-classpath classpath] [-sourcepath sourcepath] [-d directory] [-s
       directory] [-factorypath path] [-factory class] [-print]	 [-nocompile]
       [-Akey[=val]...]	 [javacoption] sourcefiles [@files]

DESCRIPTION
       The  tool  apt,	annotation  processing	tool,  includes	 a set of new
       reflective APIs and supporting infrastructure to process program anno-
       tations.	 The  apt reflective APIs provide a build-time, source-based,
       read-only  view	of  program  structure.	 These	reflective  APIs  are
       designed	 to cleanly model the JavaTM programming language's type sys-
       tem after the addition of generics. First, apt runs annotation proces-
       sors  that  can produce new source code and other files. Next, apt can
       cause compilation of both original and generated source files,  easing
       development.  The reflective APIs and other APIs used to interact with
       the tool are subpackages of com.sun.mirror.

       A fuller discussion of how the tool operates as well  as	 instructions
       for   developing	  with	apt  are  in  Getting  Started	with  apt  at
       http://java.sun.com/j2se/1.5.0/docs/guide/apt/GettingStarted.html.

PARAMETERS
       Options may be in any order. For	 a  discussion	of  parameters	which
       apply to a specific option, see OPTIONS below.

       sourcefiles    Zero or more source files to be processed.

       @files	      One  or  more  files  that  list	source files or other
		      options.

OPTIONS
   apt specific options
       -s dir	      Specify the directory root under which processor-gener-
		      ated  source  files will be placed; files are placed in
		      subdirectories based on package namespace.

       -nocompile     Do not compile sources files to class files.

       -print	      Print out textual representation	of  specified  types;
		      perform no annotation processing or compilation.

       -A[key[=val]]  Options  to  pass to annotation processors -- these are
		      not interpreted by apt directly, but are made available
		      for use by individual processors

       -factorypath path
		      Specify  where  to find annotation processor factories;
		      if this option is used, the classpath is	not  searched
		      for factories.

       -factory classname
		      Name  of	annotation processor factory to use; bypasses
		      default discovery process

   Options shared with javac
       -d dir	      Specify where to place processor	and  javac  generated
		      class files

       -cp path or-classpath path
		      Specify  where  to find user class files and annotation
		      processor factories.  If	-factorypath  is  given,  the
		      classpath is not searched for factories.

       Consult the javac(1) man page for information on javac options.

NOTES
       The  apt	 tool and its associated APIs may be changed or superseded in
       future j2se releases.

SEE ALSO
       javac(1) java(1)



				 13 June 2004			       apt(1)