Configuring Port Map New Line

There is a rule which will check for new lines before the port keyword in port map aspects relative to what preceded it.

block_header ::=
    [ generic_clause [ generic_map_aspect ; ] ]
    [ port_clause [ port_map_aspect ; ] ]

component_instantiation_statement ::=
    instantiation_label :
        instantiated_unit
            [ generic_map_aspect ]
            [ port_map_aspect ]

There are separate rules for the structure of the constraint and the indenting. Both rules are required to ensure proper formatting of multiline constraints.

There are several options to the structure rules:

Option

Values

Default Value

Description

after_port_clause

add_new_line, remove_new_line

add_new_line

  • The setting add_new_line enforces a carriage return (alias “new line”) [and, consequently by indentation rules kicking in, also (indirectly) enforces the indentation of the new line]

  • The setting remove_new_line enforces the removal of any potential space and carriage return

after_instantiated_unit

after_generic_map_aspect

Example: after_port_clause set to remove_new_line

Setting the after_port_clause option to remove_new_line will result in the following formatting:

port (
); port map (
)

Example: after_port_clause set to add_new_line

Setting the after_port_clause option to add_new_line will result in the following formatting:

port (
);
port map (
)

Example: after_instantiated_unit set to remove_new_line

Setting the after_instantiated_unit option to remove_new_line will result in the following formatting:

U_FIFO : FIFO port map (
)

Example: after_instantiated_unit set to add_new_line

Setting the after_instantiated_unit option to add_new_line will result in the following formatting:

U_FIFO : FIFO
port map (
)

Example: after_generic_map_aspect set to remove_new_line

Setting the after_generic_map_aspect option to remove_new_line will result in the following formatting:

generic map (
) port map (
)

Example: after_generic_map_aspect set to add_new_line

Setting the after_generic_map_aspect option to add_new_line will result in the following formatting:

generic map (
)
port map (
)

Rules Enforcing This Configuration