PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Overview
  • Automatic documentation
  • Setting
  • What is included in the comments?
  • Note: deleting parameters
  • Assisted input
  • Assisted input on the procedures and class methods
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Overview
To simplify the maintenance or the use of existing code by other developers, WINDEV, WEBDEV and WINDEV Mobile propose an automatic documentation for the procedures (or class methods).
This automatic documentation corresponds to a set of comments. These comments are generated:
  • When creating a new procedure or method.
    Versions 21 and later
    You have the ability to generate the comments in the window that is displayed when creating a procedure or method ("Generate a header comment" option). The generated comments will comply with the setting of automatic documentation.
    New in version 21
    You have the ability to generate the comments in the window that is displayed when creating a procedure or method ("Generate a header comment" option). The generated comments will comply with the setting of automatic documentation.
    You have the ability to generate the comments in the window that is displayed when creating a procedure or method ("Generate a header comment" option). The generated comments will comply with the setting of automatic documentation.
  • Via Comments (found in the top right corner of code window of procedure). This icon is used to generate or to delete a set of comments for the current procedure.
You can also:
  • Automatically synchronize the generated comments according to the syntax of the procedures. Modifying the syntax automatically updates the associated comments (during the backup).
  • Use the assisted input when writing the call to the documented procedures or methods. See Assisted input for more details.
Automatic documentation

Setting

The automatic documentation is configured in the "Doc." tab of code edit options ("Display .. Code edit options").To configure the automatic documentation:
  1. On the "Home" pane, in the "Environment" group, expand "Options" and select "Options of the code editor".
  2. Display the "Doc." tab.
Edit options
Important: Each block of comments must comply with the format presented below. Especially, the description of each parameter as well as the description of return value must be done on a single line. Otherwise, offsets may appear.

What is included in the comments?

The comments of a function or procedure can contain the following elements:
  • Summary: the corresponding comment is as follows:
    Summary
  • Header for describing the procedure: the corresponding comment is as follows:
    Description header
  • Call syntax: the corresponding comment is as follows:
    Syntax
  • Details of parameters: the corresponding comment is as follows:
    Details of parameters
  • Automatic timer: the corresponding comment is used to describe the automatic timer defined for the function or for the procedure:
    Automatic timer
  • Automatic management of errors and exceptions: the corresponding comment is used to describe the management mode of errors and exceptions (defined via the "If Error" link in the header bar of procedure). For example:
    Errors and exceptions
  • Note: the corresponding comment is as follows:
    Note
  • Example: the corresponding comment is as follows:
    Example
  • Mark indicating that the procedure must be documented: the corresponding comment is as follows:
    Mark

Note: deleting parameters

If a parameter is specified in the procedure syntax then if it is deleted, the reference to the parameter is still visible in the "Details of parameters" section of comments.
The text typed by the developer regarding the parameter must be manually deleted by the developer (limits the risks of deletion by "mistake").
The option "Synchronize the comments with the syntaxes of the procedures" is used to keep updated comments regardless of the modifications performed.
Assisted input

Assisted input on the procedures and class methods

If the parameters of a procedure have been documented and if the assisted input is available in the code editor, when typing the call to the procedure, the syntax and the description of parameters are displayed in a tooltip. For example:
  1. Documentation of procedure
    Documentation of procedure
  2. Assisted input on the procedure
    Tooltip (assisted input)
The mechanism of assisted input for the procedures and methods is identical to the mechanism used for the WLanguage functions. See Assisted input for the WLanguage functions for more details.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment