SKILL Status

Lets you customize the status settings for the SKILL debugger, compiler, parser, printer, stack, and trace

Editor

Lets you customize the settings for the SKILL IDE editor.

Lint

Lets you set the Lint parameter values before running the Lint tool.

Profiler

Lets you define the type of data you want the Profiler to collect and display.

Color

Lets you customize the color settings for the SKILL IDE editor window.

Trace

This section provides options to specify the tracing options for the debugger.

traceArgs

Saves the evaluated arguments of function calls, which can then be displayed in the stacktrace

traceIndent

Sets the trace indentation format to numbers or '|'.

tracelength

Sets the length of the trace output

tracelevel

Sets the depth of the nested trace printing.

Inline Documentation

This section provides options to associate inline documentation strings with SKILL functions at compile time

save inline documentation strings

Saves the inline documentation strings in your source file. This option also preserves any existing newline characters '\n' in the inline documentation strings. This makes the documentation strings accessible through the fdoc API.

You can also set this option by setting the saveInlineDoc switch to t in the sstatus SKILL API.

Print

This section provides options to set the printing options for the output.

printinfix

Prints the arithmetic expressions and function calls in infix notation.

echoInput

Prints all input to a log file.

fullPrecision

Prints floating point numbers in full precision (usually 16 digits); otherwise, prints using 7 digits precision.

pprintresult

Prints lists with alignment and indentation (for example, print 5 elements per line).

printpretty

Calls printself method when printing standard objects.

printlength

Sets the number of elements that can be printed in a list.

printlevel

Sets the number of print levels.

Stack Trace

This section provides options to set stack trace.

errsetTrace

Prints the errors and stacktrace information that is normally suppressed by errset.

stacktraceDump

Prints the local variables when an error occurs.

stacktrace

Prints the stack frames every time an error occurs. You can specify the depth of the stack that needs to be printed when an error occurs.

stackTraceFormat

Sets one of the following options for the level of detail of the stack frame.

• fullStack: Prints the complete set of SKILL stack frames.
• onlyCalls: Suppresses the printing of non-function frames in the output.
• onlyTop: Suppresses the printing of non-function frames except for the top most function frame.

warningTrace

Prints the SKILL stack when a SKILL warning is issued.

warningBreak

Enables SKILL execution to break when a SKILL warning is issued.

Debug

This section provides options to set the SKILL debugger.

debugMode

Enables debug functions and allows you to redefine write-protected SKILL functions.

keepSrcInfo

Saves additional information for debugging. The source information (file/line information) is added to funobject during compilation.

autoReload

Debugger auto-reloads a file that is not loaded under debugMode when the user tries to single-step into the code defined by that file. It works only for Cadence context source files.

showStepResult

Displays expression evaluation results. If showStepResult is enabled, the step results are printed in the CIW every time you click Step or Next ..

debugMacro

Sets the lineNumber on the expanded macro code to the lineNumber of the original form.

verboseLoad

Displays the full path of the loaded file.

Parser

This section provides options to set the SKILL parser.

multilineString

Allows SKILL strings inside double quotes to be spanned on several lines.

keepNLInString

Saves the newline characters '\n' in strings.

classAuxAutoLoad

Allows class search in .aux files.

mergemode

Merges arithmetic expressions to minimize the number of function calls.

Compiler

This section provides options to set the SKILL compiler.

lazyComp

Disables compiling of top-level functions when they are defined. Instead, compiles them when they are called.

optimizeNestedLet

Instructs the SKILL compiler to parse the code for let constructions and expand/remove them by moving their local variables to the top-level function's local variables section. It reduces the multiple nested let declarations.

optimizeTailCall

Sets the tail call recursion on, which prevents runtime stack overflow when a function is called recursively. Meant only for Scheme functions.

writeProtect

Sets write-protection on. When functions being defined have write-protection enabled, they cannot be redefined.

Show Line Number

Displays line numbers to the left of the source code pane against each line of code.

Show Tooltips When Hover Over Name

Displays tooltips when you hover the mouse pointer over any object, such as a function, class, method, or variable. You can also press the F3 key to select or deselect this check box.

Highlight Matching Text:

Highlights all occurrences of a search string in cyan.

Enable Name Completion

Enables auto-completion of keywords or function names based on your keystrokes. You can also press the F4 key to select or deselect this check box.

Auto Indent:

Automatically indents each new line in the editor to the left or right by a predefined number of spaces.

Emulate Tabs

Uses spaces to emulate tabs, so that a fixed set of spaces (equal to the tab size) is inserted when the tab key is pressed.

Tab Size

Sets the number of spaces to be inserted for each tab character.

Font Size

Sets the font size of the code in the editor window.

Font Style

Sets the font style of the code in the editor window. The available options are Normal and Bold.

Package Prefixes

List of acceptable package prefixes for functions and global variables (for example, tr).

Environment variable: prefixes

Global Variables

Specifies a list of global variables in the code that SKILL Lint should check.

Environment variable: globals

Code Version

Lets you select the release version of the code you want SKILL Lint to check.

Environment variable: codeVersion

External Files

Output

Select one or both of the check boxes to specify where you want to direct the SKILL Lint output.

Print To Log

Lets SKILL Lint to send its output to the CDS.log file and the Command Interpreter Window (CIW).

Environment variable: printToLog

Report File

Lets SKILL Lint to display the output in a separate Lint output window.

Environment variable: reportFile

Report File Name

Specifies the name of the file to which you want to write the SKILL Lint output report. The Report File Name field is enabled only when you select the Report File check box.

Environment variable: reportFileName

Rules

Applies rules to the SKILL Lint report.

Preset

Applies system-defined rules to the SKILL Lint report.

Custom

Applies user-defined rules to the SKILL Lint report.

Errors

Enables error, error global, and fatal error message groups. If selected, SKILL Lint reports code that might result in any of these errors when the code is run.

Environment variable: error

Warnings

Enables warning and warning global message groups. If selected, SKILL Lint reports potential errors and areas where you might need to clean up your code.

Environment variable: warning

Information

Enables information message groups.

Environment variable: information

Undefined Functions

Enables message groups having undefined functions that cannot be run in the executable which started SKILL Lint.

Performance

Enables the hint and suggestion message group. When selected, SKILL Lint provides hints or suggestions to improve potential performance problems in your SKILL code.

Cadence Functions

Includes Cadence public functions or variables while checking prefixes. If you do not select this check box, SKILL Lint limits prefix checking to your custom functions and variables.

Cadence public functions should start with a lowercase character; your custom functions should start with an uppercase character.

The Cadence Functions check box turns the ALERT message group in the Custom section on or off. If turned on, SKILL Lint reports code that might result in an alert when the code is run.

Enable Memory Usage Mode

Specifies a list of acceptable package prefixes for functions and global variables (for example, tr).

Environment variable: prefixes

Run Time

Runs the profiler in time mode with the time being measured as CPU time.

Real Time

Runs the profiler in time mode with the time being measured as clock time.

Memory Usage

Runs the profiler in memory mode.

Include Function Call Counts

The number of times a function is called in the SKILL program.

Case Sensitive Search

Matches the case of the searched function in the profiler summary report.

Display

Applies rules to the SKILL Lint report.

Maximum Functions

Specifies the maximum number of functions to be seen. This field is disabled when you select the Tree View tab in the Profiler assistant pane.

Time Longer Than (seconds)

Specifies the minimum number of seconds that should be spent in a function for its information to appear in the summary. This field is displayed when you run the profiler in time mode.

Functions

Lets you select one of the following options:

• All to display all functions in the profiler window.
• In context to display only the functions in the given context.
• Match Expression to display only those functions that match the given regular expression.
• Match Prefix to display only those functions who prefix match the specified.
• User to display user functions, that is, functions that are neither binary nor write-protected.
• System to display non-user binary SKILL functions.

Set Color

Lets you change the color preferences for the following code elements:

• Foreground: Changes the foreground color of the text.
• Background: Changes the background color of the editor window.
• Selected Text: Changes the highlight color of the text selection.
• Matching Text: Changes the highlight color of the text matching the selected text.
• Matching Parenthesis: Changes the highlight color for the matching brackets.
• Mismatching Parenthesis: Changes the highlight color of the mismatched bracket.
• Error: Changes the highlight color for the errors in the editor window.
• Step: Changes the highlight color for Step and Next commands.
• Cross-Highlight: Changes the cross highlight color of code in the editor window.
• Keyword: Changes the color for SKILL language keywords.
• Comment: Changes the color of comments in the SKILL code.
• Number: Changes the color of numeric values in the SKILL code.
• String: Changes the color of strings in the SKILL code
• Highlight1, Highlight2, Highlight3, Highlight4, Highlight5: Changes the custom highlight colors.

Color Swatch

Lets you choose and change the color of the selected element.

Custom Colors

Displays custom colors that have been created.

Add to Custom Colors

Lets you save the new color as a custom color.