[pypy-svn] r41435 - pypy/dist/pypy/doc

[afayolle at codespeak.net]

Author: afayolle
Date: Tue Mar 27 09:48:19 2007
New Revision: 41435

Modified:
   pypy/dist/pypy/doc/getting-started.txt
Log:
reword AOP warning in a less dramatic way

Modified: pypy/dist/pypy/doc/getting-started.txt
==============================================================================
--- pypy/dist/pypy/doc/getting-started.txt	(original)
+++ pypy/dist/pypy/doc/getting-started.txt	Tue Mar 27 09:48:19 2007
@@ -327,13 +327,19 @@
 Aspect Oriented Programming
 +++++++++++++++++++++++++++
 
-PyPy provides experimental `Aspect Oriented Programming` facilities
-(warning: using the 'aop' module may modify compiler state and 
-badly affect subsequent execution of compiled code and imports) 
+PyPy provides an experimental `Aspect Oriented Programming` facility
+in the 'aop' module. Be aware that this module works on the abstract
+syntax tree level, and will leave traces in the byte-compiled ('.pyc')
+files. Be sure to remove these files after playing with the module if
+you do not intend to really use the aspect oriented programming in
+your code. Even better, use the '--no-objspace-usepycfiles' command
+line option, so that the byte-compiled modules are not written to
+disk. 
+
 Here is an example::
 
  cd pypy
- python bin/py.py
+ python bin/py.py --no-objspace-usepycfiles
 
  >>>> from aop import Aspect, before, PointCut
  >>>> class DemoAspect: