ClarionDateTime

Created: 2014-05-19 19:44
Updated: 2018-06-26 00:08
License: mit

README.md

ClarionDateTime

Clarion Date Time Class

Code Conventions

Documentation

Use XML-style documentation for all methods, including both public and private methods. Every method must be described by a Summary, but all other tags should only be present when necessary. The following order should be observed:

!!!<summary></summary>
!!!<returns></returns>
!!!<param name="name"></param>
!!!<remarks>
!!! Put additional remarks here. Use <para>to create separate paragrahps.</para>
!!!</remarks>

  • Summary: Provide a summary of what the method does. Be brief but descriptive.
  • Returns: Summarize the meaning of the return value (if any). Do not include return types, Clarion will describe the method signature automatically.
  • Param: Summarize the meaning of the parameter, expected contents, and if the parameter is optional, describe when it is appropriate to use or omit the parameter. Give the name of the parameter, without the prefix, in the "name" property. Use one tag for each separate parameter in the method signature.
  • Remarks: If additional information about the method is desired, provide it here. If paragraphs are desired, enclose them in <para></para> tags.

Variables declared as part of a class or method should be documented inline, such as:

c_ClassVariable   LONG,PRIVATE  ! This is a class variable with inline documentation.

Variables

Naming conventions: * Concise, descriptive names should be used. * CamelCase patterns should be used: ThisIsAVariableName * Variables should use a prefix to signify the scope of the variable * Static variables should be ALL UPPERCASE.

Prefix conventions:

  • p_ signifies a method parameter. With the exception of reference parameters, the original parameter should not be modified in the method. Do not include the prefix in the "Name" property of the <param> tag of the method documentation.
  • c_ signifies a class variable.
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more