[fpc-pascal] Makeskel & how to add Firebird connection documentation?

[Graeme Geldenhuys]

On 17 November 2011 11:06,  <michael.vancanneyt at ...> wrote:
>> Apart from that, is this the right command to start?
>
> You can drop the '--update', if it is the first time.
> and the output option should be
>  --output=ibconnection.xml, not
>  --output=ibconnection.pp


I would even go as far as to say.... Leave Makeskel completely - it
generates too much noise. Just write the documentation by hand using
your favourite editor. I use Lazarus IDE or MSEide. For each editor I
have created a bunch of Code Template shortcuts for use with fpdoc XML
files. You end up with much cleaner XML in the end - and something
that is easier to maintain.  I also wouldn't bother with indentation
in the XML - it's of no use to fpdoc - it rather just causes problems
with some of the fpdoc output targets.



-- 
Regards,
  - Graeme -


_______________________________________________
fpGUI - a cross-platform Free Pascal GUI toolkit
http://fpgui.sourceforge.net