<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type"/>
</head>
<body>
<p style="margin: 0pt;"> </p>
<p style="margin: 0px;" class="mceNewlinePreserve"> </p>
<div id="mcePresetContent" style="margin: 5px 0px;" class="mceHTML">
<br/>
Hans-Peter Diettrich <DrDiettrich1@aol.com> hat am 7. Februar 2012 um 07:36 geschrieben:
<br/>
<br/>
> Mattias Gaertner schrieb:
<br/>
> > On Sun, 05 Feb 2012 19:03:44 +0100
<br/>
> > Hans-Peter Diettrich <DrDiettrich1@aol.com> wrote:
<br/>
> >
<br/>
> >> In the meantime I added another feature to the FPDocManager, that shall
<br/>
> >> allow to add description directories to documentation packages. The GUI
<br/>
> >> is a bit rudimentary for now, deserves some improvements.
<br/>
> >>
<br/>
> >> This feature can e.g. be used to add the descriptions in
<br/>
> >> $Lazarus/docs/xml/fcl to the official FCL documentation. At least this
<br/>
> >> part works already :-)
<br/>
> >
<br/>
> > Why are docs for fcl units in the Lazarus sources?
<br/>
>
<br/>
> I'm not sure. They may be a relict from attempts to document a few
<br/>
> currently used units, using the FPDoc Editor. Since these docs don't
<br/>
> meet the high standards of the official FCL docs, I never supplied them
<br/>
> to FPC.
<br/>
>
<br/>
> Some time ago I agreed to delete the xml/fcl folder, but perhaps others
<br/>
> did contribute to them as well, and declined to remove it.
</div>
<p style="margin: 0px;"> </p>
<p style="margin: 0px;">Only dodi and kirkpatc contributed content to these files. </p>
<p style="margin: 0px;"> </p>
<p style="margin: 0px;"> </p>
<div id="mcePresetContent" style="margin: 5px 0px;" class="mceHTML">
>
<br/>
> There exists one problem with local adds to the documentation: LazDE
<br/>
> reformats the XML files in a way, that makes it almost impossible to
<br/>
> create patches, or to merge them with new revisions of the original
<br/>
> sources. Using the FPDoc Editor for updates (concurrently) can result in
<br/>
> the same problems :-(
</div>
<p style="margin: 0px;"> </p>
<p style="margin: 0px;">Yes, the xml writers reorder attributes. Some people already asked for changing this.</p>
<p style="margin: 0px;">I don't know if lazde cleans up or reorders more than that. I need a file created by lazde that shows all the things it reorders.</p>
<p style="margin: 0px;">Please create a bug report for fpdoc editor. </p>
<p style="margin: 0px;"> </p>
<p style="margin: 0px;"> </p>
<div id="mcePresetContent" style="margin: 5px 0px;" class="mceHTML">
>
<br/>
> Recently another problem arose, when a FCL package was added to Lazarus,
<br/>
> which does not reflect the FPC FCL.
</div>
<p style="margin: 0px;"> </p>
<p style="margin: 0px;">It contains near to no content yet, so it can be ignored for now. </p>
<p> </p>
<p style="margin: 0px;"> </p>
<div id="mcePresetContent" style="margin: 5px 0px;" class="mceHTML">
>
<br/>
>
<br/>
> After various attempts to fix errors and to extend the current
<br/>
> documentation, I think that there exist reasons for maintaining
<br/>
> additional documentation directories, which are *not* under version
<br/>
> control - that's why I agreed to remove the fcl folder from the Lazarus
<br/>
> repository. But it still should be possible to maintain local docs,
<br/>
> unaffected by SVN updates, until we find an way to prevent conflicts or
<br/>
> losses during SVN update.
</div>
<div> </div>
<div>Are there any other tools, that alters the xml files, beside lazde and fpdoc editor?</div>
<p> </p>
<div>Mattias</div>
<div> </div>
<p id="mceDummyTail" style="margin: 0px;"> </p>
</body>
</html>