Frederic Fusier/France/IBM@IBMFR Sent by: eclipse-pmc-bounces@xxxxxxxxxxx
04/14/2008 07:08 PM
Please respond to
[eclipse-pmc] Add new API constants
- Add a new formatter flag to request comment formatting in one pass.
The current formatter does not include comments while formatting
a compilation unit. As a consequence, for clients using this
(like JDT/Text), the complete formatting of a compilation
code and comments currently involves multiple passes where
is called again for each individual block of comments.
This not only makes it hard for clients of this API to understand
expected behavior should be, but it is also completely inefficient
With the planned work, entire unit will be formatted in just
(code + comment). This feature will also be accessible to
formatter which up until now is unable to process comments.
- The flag API addition is intended to improve the backward compatibility
the enhanced formatter.
- If we did not add a new flag, then we would have to retrofit the new
formatting behavior in some existing formatting mode. Though feasible,
impact some clients in non trivial ways.
- The new feature and new API has a large number of regression tests:
-> we have added more than 200 tests on JDT/Core formatter tests
-> comparison with current formatter on JUnit 3.8.2 sources
-> format all units of a Ganymede M5 full source workspace (around
without any serious issues or loss of information
- Great performance improvements can be expected: to format a compilation
only a single (instead of two) pass will be necessary.
eclipse-pmc mailing list
Sauf indication contraire ci-dessus:/ Unless stated otherwise above:
Compagnie IBM France
Siège Social : Tour Descartes, 2, avenue Gambetta, La Défense 5, 92400
RCS Nanterre 552 118 465
Forme Sociale : S.A.S.
Capital Social : 542.737.118 €
SIREN/SIRET : 552 118 465 02430