developers-handbook: update shared libraries policy section

[kib]

Summary

Current text was written with a.out shared libraries system in mind, which is not adequate for ELF system. In fact it can be considered as mis-information causing to spread false rumors about FreeBSD environment.

Drop everything that comes from a.out world, and briefly describe common conventions related to ELF shared objects.

[pauamma_gundo.com]

Note: I don't know what the current policy and practice are, so I can't comment on how accurately the change reflects them.

documentation/content/en/books/developers-handbook/policies/_index.adoc

292–293

295

301

I'd change "argumentation" to either "arguments" or "reasons"

305

307–311

Also, 1 sentence per line? I think doc people settled on that.

[kib]

Some grammar.

[pauamma_gundo.com]

documentation/content/en/books/developers-handbook/policies/_index.adoc

308

309

310

311

[kib]

More grammar.

[emaste]

lgtm, a couple of minor items that you could consider

documentation/content/en/books/developers-handbook/policies/_index.adoc

300

I would write

• If this is impossible, or the library does not use symbol versioning, bump the library version

301

perhaps spell out Release Engineering, lowercase re looks like a fragment of a missing word

309

I might use libexample.so.x.y rather than libmy.so.x.y