On Thu, 17 Nov 2011, Graeme Geldenhuys wrote:
On 17 November 2011 11:06, <michael.vancanneyt@...> 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.
I'm not sure why you recommend leaving makeskel ?
I use it always for the initial file ? Given the proper parameters, it
creates a very usable initial file ?
Michael.
_______________________________________________
fpc-pascal maillist - fpc-pascal@lists.freepascal.org
http://lists.freepascal.org/mailman/listinfo/fpc-pascal
