ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage syntax / WLanguage procedures
  • Overview
  • Automatic documentation
  • Settings
  • What is included in the comments?
  • Remark: deleting parameters
  • Assisted input
  • Assisted input on the procedures and class methods
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
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.
    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 automatic documentation parameters.
  • Via Comments (found in the upper-right corner of the 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. For more details, see Assisted input.
Automatic documentation

Settings

To configure the automatic documentation:
  1. On the "Home" tab, 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
  • Remark: 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

Remark: 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 the procedure
    Documentation of the 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. For more details on the assisted input parameters in WINDEV, WEBDEV or WINDEV Mobile, see Assisted input for the WLanguage functions.
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 07/03/2023

Send a report | Local help