[fpc-devel] FPDoc and Lazarus

[Hans-Peter Diettrich]

Michael Van Canneyt schrieb:

>> Have a look at the lcl grids "How to..." topic, and try to find out 
>> where a passage
>> #text var #text
>> might violate any fpdoc assumption.
> 
> For starters, you can't have a <ul> in a table cell.

That's allowed:
             <tr>
               <td>TitleStyle</td>
               <td>
                 <p>Changes the 3D look of fixed cells. There are 3
settings:</p>
       		      <ul>
                   <li><var>tsLazarus</var> The default look</li>
[...]

The problem here was the plain text between <td> and <ul>, which must be
wrapped into an paragraph <p>...</p> (see above). The same for the
DrawCell part.


> Thirdly
> 
>            <li>
>             As the drawing process is running, the visual state of each 
> cell is adjusted according to grid options and position within grid. The 
> visual state
>            <table>

Bingo! Here I was misleaded by the indentation of <table> :-(


> As a rule, never put mix #Text (text blocks) at the same level as 
> structural elements like <p> <ul> <dl> <ol> or <table>.

Right.


>> It would help a lot, when also the *next* tag were shown, which 
>> requires that the preceding text must be wrapped into an paragraph.
> 
> I suggest you start submitting patches for all the issues that bother you.

For now I only have feature requests or bug reports, no solutions.

> The programs seem to work well enough for me and other people. As 
> evidence, I refer to the many pages of existing documentation.

Following your logic, a compiler is good enough when it accepts only 
valid code, and stops with exceptions on errors?

There seem to exist other people with different experience and 
expectations as well :-(

DoDi