vhdl-style-guide/docs/context_reference_rules.rst

204 lines
2.8 KiB
ReStructuredText

Context Reference Rules
-----------------------
context_ref_001
###############
This rule checks the indent of the **context** keyword.
**Violation**
.. code-block:: vhdl
library ieee;
context c1;
**Fix**
.. code-block:: vhdl
library ieee;
context c1;
context_ref_002
###############
This rule checks for a single space between the **context** keyword and the context selected name.
**Violation**
.. code-block:: vhdl
context c1;
**Fix**
.. code-block:: vhdl
context c1;
context_ref_003
###############
This rule checks the **context** keyword has proper case.
Refer to the section `Configuring Uppercase and Lowercase Rules <configuring_case.html>`_ for information on changing the default case.
**Violation**
.. code-block:: vhdl
CONTEXT c1;
**Fix**
.. code-block:: vhdl
context c1;
context_ref_004
###############
This rule checks the context selected names have proper case in the context reference.
Refer to the section `Configuring Uppercase and Lowercase Rules <configuring_case.html>`_ for information on changing the default case.
**Violation**
.. code-block:: vhdl
context C1;
context CON1, Con2;
**Fix**
.. code-block:: vhdl
context c1;
context con1, con2;
context_ref_005
###############
This rule checks the **context** keyword is on it's own line.
**Violation**
.. code-block:: vhdl
context c1 is library ieee; context con1; end context c1;
library ieee; context con2;
**Fix**
.. code-block:: vhdl
context c1 is library ieee;
context con1; end context c1;
library ieee;
context con2;
context_ref_006 (Proposed)
##########################
This rule checks the semicolon is on the same line as the context selected name.
**Violation**
.. code-block:: vhdl
context c1
;
context
c1
;
**Fix**
.. code-block:: vhdl
context c1;
context
c1;
context_ref_007 (Proposed)
##########################
This rule checks for code after the semicolon.
**Violation**
.. code-block:: vhdl
context c1; -- Comments are allowed
context c1; library ieee; -- This is not allowed
**Fix**
.. code-block:: vhdl
context c1; -- Comments are allowed
context c1;
library ieee; -- This is not allowed
context_ref_008 (Proposed)
##########################
This rule checks the context selected name is on the same line as the **context** keyword.
**Violation**
.. code-block:: vhdl
context
c1
;
**Fix**
.. code-block:: vhdl
context c1
;
context_ref_009 (Proposed)
##########################
This rule checks for multiple selected names in a single reference.
**Violation**
.. code-block:: vhdl
context c1, c2, c3; -- Comment 1
context c1,
c2,
c3;
.. code-block:: vhdl
context c1;
context c2;
context c3;
context c1;
context c2;
context c3;