[Lazarus] FPDocManager now handles selectable FCL packages

[Hans-Peter Diettrich]

Michael Van Canneyt schrieb:

>> These are definitely bugs in the fcl-process sources, should I file an 
>> bug report?
> 
> No. Unit pipesipc only works on Unixes.
> 
> It's simply not supported on other platforms; if you try any of these 
> platforms, obviously it wil not work.
[...]

The "make" stuff is not normally helpful to me :-(

> This is one of the reasons why I think the 'include all files' option in 
> fpdoc is a bad idea. It just does not work for scenarios where not all 
> units will work on all platforms.

The RTL docs already include many units which are not usable under 
Windows. Such documentation may be useful when cross-compiling, not an 
argument for ommission from certain platform docs.

> If someone just happens to be on the 
> 'wrong' platform, and consequently runs into problems, he is guided into 
> thinking that there is an error in the sources.
> There is no error, the person is just trying to do something which is 
> not supported, and which is not meant to be supported. But because of 
> the 'automatisms' he runs into trouble...

A comment in such units could help: "This unit is usable on Linux only",
perhaps as a conditional error. This would help the documentation author 
in figuring out the right include directories, and other unit users will 
learn *why* the unit doesn't compile on their platform.

> I prefer to avoid this and force people to think about what they are doing.

I'm thinking much about what I'm doing, but my conclusions often differ 
from those of other people ;-)

DoDi