[Lazarus] Help on FCL?

[Hans-Peter Diettrich]

Mattias Gaertner schrieb:

>>> Finally if the global fpdoc path is set, an unitname.xml is searched
>>> there.
>> What's the "global fpdoc path"?
> 
> I meant the IDE options.

You mean the explicitly given fpdoc editor paths?

>> [...]
>>> ToDo: implement something to use the docs of a newer Lazarus Version
>>> and newer package versions, where the units may have different owners
>>> and paths. Maybe a file with a list of some information like: 
>>> for the ideintf.lpk version 1.0.0 to 1.0.2, use fpdoc search path xyz,
>>> and a list of unit aliases.
>>> The IDE should be able to load several of these files, so that third
>>> party packages can use that feature too.
>> For units inside the Lazarus directory all package documentation could 
>> reside in subdirectories of docs/, by default. Projects and third-party 
>> packages could use a docs/ subdirectory of the directory containing the 
>> package/project file. IMO users would be happy with such a default 
>> search path, before they start to invent their own locations.
> 
> You lost me here. 
> How does that solve the renamed/moved unit problem?

I don't see the problem yet :-(

When the Lazarus LCL and LCLBase packages already are documented 
together, in the fpdoc "lcl" package, moving units should not be a 
problem? Renamed units deserve special actions, both in the repository 
and XML files, of course; this is up to the person which does the 
rename, isn't it?

When the XML files are under version control, every Lazarus version 
(release branch), package or project version will include the 
appropriate docs and paths. Only the server for the online docs should 
know about the package/product version, for which help is requested.


>> What about translations? I've asked this question already, some time 
>> ago, with no response. There seem to exist no activities to translate 
>> the Lazarus docs?
> 
> The wiki has some busy translators.

Here I can see a version problem, since the wiki isn't aware of 
versions, by himself - the contributors must be aware of! One of the 
reasons why I don't like the wiki :-(

> For the fpdoc files: AFAIK none.

One problem less ;-)

DoDi