Source Code Comments
Globalyzer supports a variety of comments that can be inserted into your source code; Ignore
comments that tell Globalyzer to skip source code during its next scan; ToDo comments that are
just used to help you in your internationalization process; String Externalization comments that
let you see the actual string that was externalized using Globalyzer. By inserting these comments into your source code, other team members will be able to benefit
from your internationalization work.
Select Scans=>Manage Scans, select a Scan and then click Modify and navigate to the Scanning and
String Externalization pages. You can customize most of the comments.
Scanning Comments
- Ignore String Comment: This comment type is not editable. It's available when you
select one or more rows in the Embedded Strings Scan Results table, right-click and choose
Fix Code=>Ignore This Issue. Globalyzer inserts a comment at end of the
line telling Globalyzer to ignore this string. Globalyzer will report other Embedded Strings,
General Patterns, Locale-Sensitive Methods, or Static File References found on this line.
Multiple strings on the same line can be ignored by selecting them individually from Scan Results
and ignoring. This will place several comments at the end of the line, where each comment
indicates the string that should be ignored.
- Ignore This Line Comment: This comment type is not editable. It's available when you
select one or more rows in the any Scan Results table, right-click and choose
Fix Code=>Ignore This Line. Choosing Ignore This Line inserts a comment at end of the
line that tells Globalyzer to ignore any issues found on the line. So Globalyzer will not report
any Embedded Strings, General Patterns, Locale-Sensitive Methods, or Static File References that
occur on the line.
- To Do Comment: Inserting a To Do Comment simply inserts a string that you or
others can later search for in your source code. It may be used for any purpose that you wish.
- Ignore Next Line Comment: Inserting an Ignore Next Line Comment in your source code
tells Globalyzer to ignore the next line following the comment. Issues found on the next line
will not be reported in Scan Results.
- Start Ignore Comment: Inserting a Start Ignore Comment in your source code starts a
block of code that will be ignored by Globalyzer when it next scans your source code.
Start Ignore Comment and the End Ignore Comment work together to ignore sequential lines of code.
If an End Ignore Comment is not found in the source code, all lines will be processed by Globalyzer.
- End Ignore Comment: Inserting an End Ignore Comment in your source code ends a block of
code that will be ignored by Globalyzer. Start Ignore Comment and the End Ignore Comment work together
to ignore sequential lines of code. If a preceding Start Ignore Comment is not found in the
source code, all lines will be processed by Globalyzer.
String Externalization Comments
- String Externalization Comment: In addition to extracting strings to Resource files,
Globalyzer gives you the option of inserting a comment right above the line of code where you
externalized the string. The comment will include this String Externalization Comment followed by
the text that you externalized. You can insert comments when you perform either single or batch
string externalization, by selecting Window=>Preferences=>Globalyzer and then checking
Automatically Insert Externalized String Comment.
|