DVT IDE for VS Code SystemVerilog User Guide
Rev. 22.1.23, 16 August 2022

23.1.2 Natural Docs

Comments written in Natural Docs will be formatted based on the following syntax:

  • Bold Font

Syntax:

// *This word* should be bolded
function bit my_function(bit argument);
endfunction

  • Bullet List

Syntax:

// Below is a list
// + This is the first element
// + This is the second element
// This is the continuation of 
// the second element
function bit my_function(bit argument);
endfunction

  • Definition List

Syntax:

// Below is a definition list
// First Item - This is the definition
// of the first Item
// Second Item - This is the deinition 
// of the second item
function bit my_function(bit argument);
endfunction

  • Heading

Syntax:

// Before
// 
// Title of the heading:
// Content of the heading
//
// After
function bit my_function(bit argument);
endfunction

  • Image

Syntax:

// Below you can see a section of a diagram
//
// (see diagram_section.png)
function bit my_function(bit argument);
endfunction

The path can be either absolute, relative to the current file or relative to additional image locations.

The path can be either absolute, relative to the current file or relative to additional image locations. To specify additional image locations use +dvt_natural_docs_image_locations directive.

  • Italic Font

Syntax:

// ~This word~ should be in italic font
function bit my_function(bit argument);
endfunction

  • Link

Syntax:

// Check this function out <my_other_function>
function bit my_function(bit argument);
endfunction

As links you can have: an object name, a file, a valid web URL. If you Ctrl + right click on a link that contains an object name, it should jump to its declaration.

  • Start Code

Syntax:

// Below is a code section
// (start code)
//   int a;
//   if ( a > 4 )
//      return 4;
//   return a;
// (end)
function bit my_function(bit argument);
endfunction

  • Topic Line

Syntax:

// Below you can see a topic line
//
// Function: my_first_function
function bit my_function(bit argument);
endfunction

  • Underline Font

Syntax:

// _This word_ should be underlined
function bit my_function(bit argument);
endfunction