Change 20080518-dda-6 by [EMAIL PROTECTED] on 2008-05-18 16:02:23 EDT
    in /Users/dda/laszlo/src/svn/openlaszlo/trunk-c
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: Script compiler line number rework

New Features:

Bugs Fixed: LPP-5784

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

Documentation:

Release Notes:

Details:
    General:
A fair amount of rework of the line numbers. We needed an integrated approach so that internally at least, /* file: name#xx.yy */ wasn't treated separately from /* file: #xx */. More line information needed to be preserved to capture all the various line transitions. These
       had various ripple effects, one being that versions of the LFC
(compiled with nameFunctions) needed to have trackLines turned off, otherwise heap space blew up. This may be fixable in the future if it is important. LFC still has /* -*- file: .... */ comments for the
       top of functions.

Also observed during testing is the necessity of not breaking output lines to insert /* -*- file: .... */ comments. This breaks lzunit
       test/lztest/lztest-node-options.js in a strange manner:

[exec] js: "test/lztest/lztest-node-options.js", line 108: uncaught JavaScript runtime exception: TypeError: [EMAIL PROTECTED] is not a function, it is org.mozilla.javascript.Undefined.

A working lztest-node-options.js differed from the broken one only in
       the comments produced.  This remains a mystery, but without much
       loss of line number accuracy, we now should not break lines.

    lfc/build.xml
Turn off -tracklines when building the LFC, it can overflow heap space
       due to enormous strings generated internally.

    ScriptCompiler.java, Compiler.java:
       Eliminate needless call to Compiler.setProperties(),
       and eliminate that method.  Compiler.defaultOptions() is
       now only called once.

    Compiler.java:
       Support disableTrackLines option.

    Compiler.java, CommonGenerator.java:
Fragments generated with fake filenames are now issued with [filename]

    SWF9ParseTreePrinter.java:
       More thorough checking of class 'type'

    ParseTreePrinter.java
- Added extra debugging output for line numbers (DEBUG_LINE_NUMBER)

       - Integrate file/line numbering to a common approach.
There are still two annotations, but they both contain file/ line
         numbers and they are processed the same.  One is marked as a
         'forced' line number so that a line number will sure to be
         emitted at the beginning of a function.

       - allow more internal line annotations to be created -
         don't automatically elim an annotation just because it is
         followed by another annotation.  The intelligence about
         what to finally produce happens at the end.

       - added capability to extract a single annotation.

       - encapsulate current and last line number info in
         a LineNumberState struct to make comparison and updating
         easier and clearer.

       - when outputting the line numbers, fine tune the conditions for
         when we need a new source location.  Some of the factors in
         the decision are:
           -- is it the same as can be predicted?
           -- does the current/previous filename have a name?
              and is the name internal (used for compiling a fragment)?
              and the line number >0?
           -- are we at the beginning of a line (the preferred spot,
              but there are exceptions)?
           -- is this the beginning of a function?
           -- is trackLines on?
         this is all managed in shouldShowSourceLocation().

       - there are now three variants of line number (source locations
         using the nexb terminology) emitted:
             /* -*- file: -*- */
                     There is no file attached to the following code
                     Don't expect to see line numbers updated.
             /* -*- file: FILENAME#NN.YY -*- */
The filename has changed. The following output line relates to line NN (and column YY) of FILENAME as the input file. Subsequent output lines numbers can be
                     determined by simple incrementing.
             /* -*- file: #NN */-*- */
The following output line relates to line NN of the
                     previously mentioned FILENAME as the input file.
                     Subsequent output lines numbers can be
                     determined by simple incrementing.
          At the beginning of output, there is no file attached
          until the first source location is seen.  That is there is
          an implicit  /* -*- file: -*- */ at the beginning of output.

Tests:
   Functionality:
       Test cases from nexb #449 and #443 work by examining output JS.
In particular output not relating to particular input source lines
       are indicated with /* -*- file: -*- */
          https://nexb.laszlosystems.com/trac/main/ticket/443
          https://nexb.laszlosystems.com/trac/main/ticket/449
      Compiled for example:
         lzc -DnameFunctions --runtime=dhtml -S nexb443.lzx

   Regression:
      ant lzunit
      swf9 hello
      (smokecheck,weather,lzunit) x (swf8,dhtml)

Files:
M      WEB-INF/lps/lfc/build.xml
M      WEB-INF/lps/server/src/org/openlaszlo/sc/ScriptCompiler.java
M      WEB-INF/lps/server/src/org/openlaszlo/sc/CommonGenerator.java
M WEB-INF/lps/server/src/org/openlaszlo/sc/ SWF9ParseTreePrinter.java
M      WEB-INF/lps/server/src/org/openlaszlo/sc/Compiler.java
M      WEB-INF/lps/server/src/org/openlaszlo/sc/ParseTreePrinter.java

Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20080518-dda-6.tar



--

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

voice: 617-547-7881
email: [EMAIL PROTECTED]
www: http://www.ddanderson.com




Reply via email to