More documentation on library paths and names

[Kaiepi]

The problem

Library paths and names needed more documentation. See #1513

Solution provided

More was written

[Skarsnik]

This example is misleading. the function does what specify the ABI version to the native trait is supposed to do, and people SHOULD always specify an ABI version (very few execption like libmysqlclient ><)

[Kaiepi]

Updated

[Skarsnik]

No, I mean the content of the function itself. The example was correct previously, it's just we should not encourage users to do what the ABI version does already :)

[Kaiepi]

You mean like returning /usr/local/lib/ebar/bar?

[Skarsnik]

Just read the https://docs.perl6.org/language/nativecall#ABI/API_Version
If I write
is native('bar', 'v1) it should give you /usr/lib/libbar.so.1 on openbsd (/usr/lib/ will be the default system library path, (I think NC/moar query ld config).) If it's not the case it should be patched in NC or Moar to follow the proper OpenBSD intended behavior.

But what I mean is users should be encouraged to use the ABI version argument. Giving the user an example of the use of the Routine argument type witch does what the API feature does is probably a bad idea/misleading. Maybe a better example could be just a function that call pkg-config to get the path (or something similar)

[Skarsnik]

Thank :)