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


--
_______________________________________________
Lazarus mailing list
[email protected]
http://lists.lazarus.freepascal.org/mailman/listinfo/lazarus

Reply via email to