[Laszlo-dev] For Review: Change 20080627-dda-7 Summary: Resolve references to as2/as3/js1 in doc to their aliases.

[Donald Anderson]

[Committed in advance to allow doc review]

Change 20080627-dda-7 by dda at lester.local on 2008-06-27 16:09:59 EDT
     in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc
     for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: Resolve references to as2/as3/js1 in doc to their aliases.

New Features:

Bugs Fixed: LPP-6101 (Remove "as2" terminology and replace with  
swf7/8/9)

Technical Reviewer: ptw (pending)
QA Reviewer: (pending)
Doc Reviewer: liorio (pending)

Documentation:

Release Notes:

Details:
     When a method/class is marked as2, as3, or js1, we need to map  
those
     to the known aliases (swf8, swf9, dhtml).

     This is an expedient fix that covers our current basic situations.
     Left a TODO in the code to resolve the issue in a better way.
     The current fix relies on textual substitutions after the
     string runtimes is generated rather than being involved with
     generation of the runtimes string.  I went with this approach
     for now since it seems safer - we are only modifying text,
     not potential output file names.

     Removed swf7 from the list of runtimes.

     Changed some 'hand-generated' js2doc entries to remove as2 from
     the output, again avoiding and filename changes.

Tests:
     Added a testTranslateRuntime() function,
     and enabled it temporarily (not in this change set) to test.

     Rebuilt doc and grepped for as2.

     Compared list of generated files in docs/reference
     before and after this fix to make sure that no filenames had been  
changed.

Files:
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/Main.java
M      WEB-INF/lps/server/src/org/openlaszlo/js2doc/ 
ReprocessComments.java
M      docs/src/reference/langref.xml

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20080627-dda-7.tar



--

Don Anderson
Java/C/C++, Berkeley DB, systems consultant

voice: 617-547-7881
email: dda at ddanderson.com
www: http://www.ddanderson.com



-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.openlaszlo.org/pipermail/laszlo-dev/attachments/20080627/b96732fc/attachment.html