settings |
Define specific preferences for the corresponding root-folder.
There are two special assignments that can always be used:
- @default: Uses the value from V4P's default settings. The list below shows the default value for each setting.
- @inherit: Uses the value from the Master Config (if present), otherwise V4P's default.
V4p.Settings.Basics.TopLevelEntities
Values
|
String
|
Default
|
""
|
Remarks
|
Specifies the top-level entities of the design as comma-separated list. Can contain the corresponding library as prefix, e.g. "sim_top, design_lib.dut_top". Entities specified in the MasterConfig will be merged with local entities. If no library is specified, all entities with the given name(s) are considered as top-level
|
V4p.Settings.Basics.LogSeverity
Values
|
Detail Debug Note Info Warning Error Fatal
|
Default
|
Note
|
Remarks
|
Specifies minimum severity for log-messages. Messages below the given threshold are not written to the logfile.
|
V4p.Settings.Basics.LicenseFile
Values
|
String
|
Default
|
""
|
Remarks
|
Path to the license file (must include filename!). There are other ways as well to specify a license file, see Section License.
|
V4p.Settings.Formatting.Vhdl.AutoAlignSnippets
Values
|
Boolean
|
Default
|
True
|
Remarks
|
(Not yet supported) Automatically aligns the output of a snippet to the style of the previous line. Eg, the ':' and ':=' of signal declarations are aligned.
|
V4p.Settings.Formatting.Vhdl.StandardLibraryStyle
Values
|
AsDefined Lower Upper
|
Default
|
Lower
|
Remarks
|
Defines the capitalization style of standard-library elements for snippets and code-completion.
|
V4p.Settings.Formatting.Vhdl.KeywordStyle
Values
|
Lower Upper VbaStyle
|
Default
|
Lower
|
Remarks
|
Defines the capitalization style of keywords. If style VbaStyle is used, the first letter is converted to upper case, while the reset is lower case.
|
V4p.Settings.Formatting.Vhdl.EndIdentifiers.<*>
Values
|
Boolean
|
Default
|
False
|
Remarks
|
(Not yet supported) Defines whether the label/name of a block shall be repeated at the end of the block as well. For example: procedure proc (...) is begin end procedure proc; The * in the above definition can be replaced with any one of those values: Process Procedure Function Entity Architecture Context Package Component Block Generate Record Protected Case
|
V4p.Settings.Formatting.Newlines.<*>
Values
|
Boolean
|
Default
|
mixed
|
Remarks
|
(Not yet supported) Defines when V4P inserts newlines when formatting code. Allowed values for the * in the definition above are Vhdl.ProtectedKeyword Vhdl.RecordKeyword Vhdl.WhenStatements .
|
V4p.Settings.Formatting.Indentation.UseTabs
Values
|
Boolean
|
Default
|
False
|
Remarks
|
Defines whether to use tab-stops or whitespaces for indentation. This affecs code-completion, snippets and type-time (smart) indenation.
|
V4p.Settings.Formatting.Indentation.TabWidth
Values
|
Integer
|
Default
|
2
|
Remarks
|
Defines how many spaces to insert for each level of indentation. See also V4p.Settings.Formatting.Indentation.UseTabs
|
V4p.Settings.Formatting.Indentation.<*>
Values
|
Boolean
|
Default
|
True
|
Remarks
|
Specifies when V4P shall add indentation (relative to the previous line). Allowed values for the * in the definition above are Vhdl.IndentReportSeverity Vhdl.IndentWhenChoices Vhdl.IndentDeclarations Vhdl.IndentPortMaps Vhdl.IndentUseClauses Vhdl.IndentPortDeclarations .
|
V4p.Settings.Completion.ShowKeywords
Values
|
Boolean
|
Default
|
True
|
Remarks
|
Defines whether keywords shall be part of the code-completion list.
|
V4p.Settings.Completion.ShowUncommon
Values
|
Boolean
|
Default
|
False
|
Remarks
|
Defines whether uncommon elemments of the IEEE standard libs shall be part of the completion list. Uncommon elements are for example character-literals, ux01 to_ux01 , ...
|
V4p.Settings.Completion.ShowEnums
Values
|
Boolean
|
Default
|
True
|
Remarks
|
Defines whether enumeration values shall be part of the code-completion list.
|
V4p.Settings.Completion.ShowVendorSymbols
Values
|
Boolean
|
Default
|
False
|
Remarks
|
Defines whether symbols of Vendor Libraries (eg, unisim, altera_mf) shall be part of code completion suggestions. This might severely impact performance as Vendor Libraries tend to be huge. Currently the following files are recognized as Vendor Libraries (case insensitive):Filename | Library |
---|
retarget_VCOMP.vhd | unisim | unisim_retarget_VCOMP.vhd | unisim | unisim_VCOMP.vhd | unisim | unisim_VPKG.vhd | unisim | altera_mf.vhd | altera_mf | altera_mf_components.vhd | altera_mf |
|
V4p.Settings.Completion.ShowVendorSnippets
Values
|
Boolean
|
Default
|
False
|
Remarks
|
Defines whether component-snippets of Vendor Libraries (eg, unisim, altera_mf) shall be part of code completion suggestions. This might severely impact performance as Vendor Libraries tend to be huge. Currently the following files are recognized as Vendor Libraries (case insensitive):Filename | Library |
---|
retarget_VCOMP.vhd | unisim | unisim_retarget_VCOMP.vhd | unisim | unisim_VCOMP.vhd | unisim | unisim_VPKG.vhd | unisim | altera_mf.vhd | altera_mf | altera_mf_components.vhd | altera_mf |
|
V4p.Settings.HoverInfo.ShowLibraries
Values
|
Boolean
|
Default
|
False
|
Remarks
|
If true, the hoverinfo shows the library to which the current symbol belongs.
|
V4p.Settings.HoverInfo.ShowLocation
Values
|
Boolean
|
Default
|
False
|
Remarks
|
If true, the hoverinfo shows the file and location of the current symbol.
|
V4p.Settings.HoverInfo.ResolveStdTypes
Values
|
Boolean
|
Default
|
False
|
Remarks
|
If true, standard ieee types are further resolved into their primitive types (if any).
|
V4p.Settings.HoverInfo.ResolveTypes
Values
|
Boolean
|
Default
|
True
|
Remarks
|
If true, complex types (eg, arrays) will be further resolved to their primitive types.
|
V4p.Settings.HoverInfo.ShowAllOverloads
Values
|
Boolean
|
Default
|
False
|
Remarks
|
If true, the hoverinfo contains all overloads of the current subroutine. Notice that this might result in truncated output. If false, only a summary of the overloaded subroutines is displayed.
|
V4p.Settings.ParameterHelp.Instances
Values
|
Boolean
|
Default
|
True
|
Remarks
|
If true, parameter-help for instances is provided. As this might be quite annoying for large entities, it can be disabled.
|
V4p.Settings.StutterMode.Enabled
Values
|
Boolean
|
Default
|
True
|
Remarks
|
If true, stutter mode is enabled. See below for details.
|
V4p.Settings.StutterMode.HorizontalLineWidth
Values
|
Integer
|
Default
|
100
|
Remarks
|
Defines the number of dashes to insert for the "horizontal line (---)" stutter insertion
|
V4p.Settings.ErrorChecker.MissingAssociations.IgnoreInstanceOutputs
Values
|
Boolean
|
Default
|
True
|
Remarks
|
If true, missing associations in instances, which are of type output, are ignored. No warning is issued.
|
V4p.Settings.ErrorChecker.MissingAssociations.IgnoreInstanceInputsWithDefaultValues
Values
|
Boolean
|
Default
|
False
|
Remarks
|
If true, missing associations in instances, which are of type input and have a default value, are ignored. No warning is issued.
|
V4p.Settings.ErrorChecker.SymbolUnused.IgnoreLoopVariables
Values
|
Boolean
|
Default
|
True
|
Remarks
|
If true, for-loop (generate) variables are not checked whether their value is actually used somewhere.
|
V4p.Settings.ErrorChecker.SymbolUnused.AttributesReadValue
Values
|
String
|
Default
|
delayed, driving_value, transaction, quiet, stable
|
Remarks
|
Defines a comma-separated list of attributes that are treated as "read-access" to the respective symbol (e.g., mySignal'delayed(1 ns)). You can use @default and @inherit as part of the list to add something to default/inherited settings, e.g. "@default, event". You can use all to simply treat all calls to attributes as read-access for the respective symbol.
|
|