File: readme.txt

package info (click to toggle)
lazarus 4.0%2Bdfsg-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 275,760 kB
  • sloc: pascal: 2,341,904; xml: 509,420; makefile: 348,726; cpp: 93,608; sh: 3,387; java: 609; perl: 297; sql: 222; ansic: 137
file content (33 lines) | stat: -rw-r--r-- 1,234 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
This directory is intended for storing examples of Pascal code included in the documentation.

You can include example code in the documentation as follows:

1. Place an example of the code inside this directory as a unit with name UnitName.FunctionName.pas or similar.
   Place the link in this example for the documentation <element> tag as follows:

   <element name="MyDangerousFunction">
    <example file="examples/UnitName.MyDangerousFunction.pas"/>
   </element>

   The file attribute of the <example> tag is used to specify the filename containing the example. The filename does not require an extension: if it is missing, .pp is assumed.

   If you use the fpdoc editor then use the example tab for that.
   https://www.freepascal.org/docs-html/current/fpdoc/fpdocsu70.html

2. Place the example code into the <descr><descr/> section inside <code></code> tags.
    Note that any text surrounding the code tags should be placed inside <p></p> tags.
    For example:

    <element name="MyDangerousFunction">
    <descr>
    <p>
        // Any description.
    </p>
    <code>
        // Place example code here.
    </code>
    </descr>
    </element>

    https://www.freepascal.org/docs-html/current/fpdoc/fpdocsu63.html