The data for procdures and methods will be extracted from comment lines in procdures and methods.
There is also a external source available. Data for properties, objects, classes and files will be defined in the source file.
See description.
This plug in enables the use of "tag" style documention for methods and procedures. The "prefix" style documentation will be kept. Both styles may be mixed. There is a flag to stop the use of "prefix" style.
The plug in will transform non HTML signs into the HTML. Transformations can be done per PDM project.
A external file need to be provided. This need to be a CSV file with a followeinf format:
"sign","HTML"
example:
"©","©"
"ü","ü"
Please note, do not enter signs & and ", they will be transformed by internal code.
It is not suggested to use comments with "prefix" stiele, this may give unexpected results.
</span>It's not recommend to use prefixed lines within a tag and vice versa.
Element | Default | Remarks | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Doc section | <!--PDM_COMMENT-->DOC_START DOC_EN |
This is not part of the plug in.
It is used in methods and procedures to marke the parts to use with PDM plug ins.
Data defined in the sourcetable will not need this! This is the "frame" for all other sections. On the prefix version this section will start with DOC_START and end with DOC_END. There is no tag version available. |
||||||||||||
description | descr | Short description, will be enclosed in CSS class "_AB_PDM_Descr" | ||||||||||||
Remarks | remarks |
Extended remarks. Text will be displayed in "*_PDM_AB_Body" CSS Class within "*_PDM_AB_Remarks" CSS class. |
||||||||||||
Changes | change |
Display of comment of changes. tag Syntax:
The use of this section is controled by an option of the plug in. A special feature is the ability to merge meta data from sourcecode with meta data from source table. |
||||||||||||
Example | example |
Formatable example to the procedure / method. The text will be in the "diamp_pdm_ab_body" CSS class within the "_PDM_AB_Example" CSS class. |
||||||||||||
See also | seealso |
Formatable list of links to procedure / method / classe or files. Syntax: There will be one link for each tag / Prefix. Syntax: [File]:[Class[.Object]n]:[Member] or [File]::Procedure, followed by one Space and the text to display. for each See tag a link will be created. Each See also tag creates a new block. Anything else in See also tag will be ignored. |
||||||||||||
Copyright | copyright |
Formatable coyright text. The text will be in the "_PDM_AB_Body" CSS class within the "_PDM_AB_CopyRight" CSS class. |
||||||||||||
Usage of links | appliesto |
Creates a list of all seealso and see tags that point to this method.
Not available in "prefix" version. tag Syntax:
Only the first occurence will be used. |
||||||||||||
Link | pdmlink |
A different record of the source table should be used.
Usefull on repeated methodes. Not available in "prefix" version. tag Syntax:
Note that links may be chained. There is no check for cycling yet. Links need a source file to work with. |
||||||||||||
The elements below this line may be used within the the elements beyond this line. |
||||||||||||||
Code | code | This tag enables a block of text that is formated as VFP source code. | ||||||||||||
Expression | expr |
This tag enables an inline text that is formated as VFP source code. Attention, those text will be in a <pre> tag. All leading spaces and tabs will be displayed! |
||||||||||||
Not formated | plain |
This is a block of text that will be displayed as text. All non HTML signs will be transformed, line breaks will be kept. |
||||||||||||
xhtml | xhtml |
This tag enables a block that hold html code that will be passed in the page created. The tag will be ignored if the "Just-XHTML" flag is on. |
||||||||||||
See | see |
This tag enables a inline link to a other member like class / procedure etc.
|
||||||||||||
Auto date | autodate | This tag will be replaced with the date of the timestamp tTimeStamp of the source file or if there is no record, no such field or the field is empty with current date. | ||||||||||||
Note | note |
Creates a block "Note".
This block may display a leading picture and special format.
The blocks may be defined via a CSV file. tag Syntax:
This is a CSV file using following format: "ID","CSS Class","Picture" Example: "E","_PDM_AB_nExclamation","_diamp\res\excla.gif" "I","_PDM_AB_nInformation","_diamp\res\info.gif" Picture are relative to the location of the plug i |
Every text that is not part of a prefixed line or a within the tags described above will be displayed on procedures end using "_PDM_AB_Other" CSS class.
*!* DOC_START *!* DESCR This function emulates VFP <expr>STREXTRACT</expr> for versions below VFP 7.0 *!* DESCR The function will be disabled in Version 7 and beyond using #IF *!* Example <code> *!* Example TEXT lcText NOSHOW *!* Example <short>Specify the type of controls <i>placed<i> on the search.</short> *!* Example ENDTEXT *!* Example lcExmaple = STREXTRACT(lcText,"<i>","</i>") &&returns placed *!* Example </code> *!* PARAMS tcSearchExpression ByVal IN Character Specifies the string to search. *!* DOC_END |
*!* DOC_START *!* <descr> *!* This function emulates VFP <expr>STREXTRACT</expr> for versions below VFP 7.0 *!* The function will be disabled in Version 7 and beyond using #IF *!* </descr> *!* <example><code> *!* TEXT lcText NOSHOW *!* <short>Specify the type of controls <i>placed<i> on the search.</short> *!* ENDTEXT *!* lcExmaple = STREXTRACT(lcText,"<i>","</i>") &&returns placed *!* </code> *!* </example> *!* <params name="tcSearchExpression" direction="IN" type="Character"> *!* <short>Specifies the string to search.</short> *!* </params> *!* DOC_END |
*!* DOC_START *!* <descr> *!* This function emulates VFP <expr>STREXTRACT</expr> for versions below VFP 7.0</descr> *!* DESCR The function will be disabled in Version 7 and beyond using #IF *!* <example><code> *!* TEXT lcText NOSHOW *!* <short>Specify the type of controls <i>placed<i> on the search.</short> *!* ENDTEXT *!* lcExmaple = STREXTRACT(lcText,"<i>","</i>") &&returns placed *!* </code></example> *!* PARAMS tcSearchExpression ByVal IN Character Specifies the string to search. *!* DOC_END |