[Lazarus] Documentation update (CHM building, lazutils)

[Mattias Gaertner]

On Thu, 29 Dec 2011 20:06:42 +0100
Marco van de Voort <marcov at stack.nl> wrote:

> 
> As part of the 2.6.0 documentation effort, I regenerated the docs for FPC,
> and as usual I also try to build the LCL docs. I had to create some XMLs for
> non existing LCL units.
> 
> I also commited a clenaed up version of the script I use to generate lcl.chm
> as "docs/html/build_lcl_chm.sh".
> 
> I noticed that the LCL is now dependent on other package(s). At least a
> package "lazutils". There seems to be some documentation in
> docs/html/lazutils but they are only moved former LCL documentation.
> 
> What is the plan with this package? Is it a part of the LCL or really an
> optional component? The LCL docs refers to lazutf8 81 times. If it is just a
> matter of generating an extra CHM and set up the buildscripts for it, just
> say so and I'll do it.

Package LCL depends on LCLBase depends on LazUtils.
LazUtils contains basic stuff like UTF-8 functions and classes, which
might be useful for non LCL applications too.
LCLBase contains the platform independent units of the LCL. 
LCL contains the interface code to the widgetset(s).

All three should get their own docs. LCL+LCLBase can be
bundled.
 
> I also noticed some copies of the RTl docs in docs/xml/rtl but these don't
> seem to be diffs/additions but full copies (and now it is hard to find out
> what these actually change). Can these be removed?

DoDi?

 
> Below is the condensed error list:
> 
> Warning: Target ID of <link> in unit "LCLProc" is unknown: "#LazUtils.LazUTF8"
> <repeated 81 times in total>
> 
> Warning: Target ID of <link> in unit "InterfaceBase" is unknown: "#lcl.Controls.TCursor"
> Warning: Target ID of <link> in unit "InterfaceBase" is unknown: "#lcl.Controls.TCursor"
> 
> Warning: Target ID of <link> in unit "Graphics" is unknown: "#fcl.FPCanvas.TFPCanvasHelper.Changed"
>    .. and other fcl-image related bits. (50+ times)
> 
> Warning: Target ID of <link> in unit "Graphics" is unknown: "#rtl.Classes.TPersistent.DefineProperties"
> Warning: Target ID of <link> in unit "Graphics" is unknown: "#rtl.Classes.TPersistent.AssignTo"
> Warning: Target ID of <link> in unit "Graphics" is unknown: "#rtl.Classes.TPersistent.DefineProperties"
> Warning: Target ID of <link> in unit "Graphics" is unknown: "#rtl.Classes.TPersistent.AssignTo"
> Warning: Target ID of <link> in unit "Controls" is unknown: "#rtl.Classes.TComponent.DefineProperties"
> Warning: Target ID of <link> in unit "Controls" is unknown: "#rtl.Classes.TPersistent.DefineProperties"
> Warning: Target ID of <link> in unit "Controls" is unknown: "#rtl.Classes.TPersistent.AssignTo"
> Warning: Target ID of <link> in unit "Controls" is unknown: "#rtl.Classes.TComponent.Notification"
> Warning: Target ID of <link> in unit "Controls" is unknown: "#rtl.Classes.TComponent.Notification"
> Warning: Target ID of <link> in unit "Controls" is unknown: "#rtl.Classes.TComponent.GetChildren"
> Warning: Target ID of <link> in unit "Forms"    is unknown: "#rtl.Classes.TComponent.GetChildren"
> Warning: Target ID of <link> in unit "Forms"    is unknown: "#rtl.Classes.TComponent.Notification"
> Warning: Target ID of <link> in unit "Forms"    is unknown: "#rtl.Classes.TComponent.GetChildren"
> Warning: Target ID of <link> in unit "Forms"    is unknown: "#rtl.Classes.TComponent.Loaded"
> Warning: Target ID of <link> in unit "Forms"   is unknown: "#rtl.Classes.TComponent.Notification"
> Warning: Target ID of <link> in unit "StdCtrls" is unknown: "#rtl.Classes.TComponent.Loaded"
> Warning: Target ID of <link> in unit "StdCtrls" is unknown: "#rtl.Classes.TBasicActionLink.AssignClient"
> Warning: Target ID of <link> in unit "ExtCtrls" is unknown: "#rtl.Classes.TComponent.Loaded"
> Warning: Target ID of <link> in unit "ExtCtrls" is unknown: "#rtl.Classes.TComponent.DefineProperties"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TCollectionItem.GetDisplayName"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TCollectionItem.SetIndex"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TPersistent.GetOwner"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TStrings.Get"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TStrings.GetObject"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TStrings.Put"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TStrings.PutObject"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TStrings.SetUpdateState"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TPersistent.DefineProperties"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TCollectionItem.SetIndex"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TCollectionItem.GetDisplayName"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TCollection.Update"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TBasicActionLink.AssignClient"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TPersistent.AssignTo"
> Warning: Target ID of <link> in unit "ComCtrls" is unknown: "#rtl.Classes.TPersistent.GetOwner"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.RecordChanged"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.DataSetChanged"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.ActiveChanged"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.LayoutChanged"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.DataSetScrolled"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.EditingChanged"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#fcl.db.TDataLink.UpdateData"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#rtl.Classes.TCollectionItem.GetDisplayName"
> Warning: Target ID of <link> in unit "DBGrids" is unknown: "#rtl.Classes.TCollection.Update"
> Warning: Target ID of <link> in unit "LDockCtrl" is unknown: "#rtl.Classes.TComponent.Loaded"
> Warning: Target ID of <link> in unit "LDockCtrl" is unknown: "#rtl.Classes.TComponent.Notification"

Mattias