docs icon indicating copy to clipboard operation
docs copied to clipboard

[question] package_type documentation is not precise enough (Conan 2.0)

Open ZbigniewRA opened this issue 3 years ago • 0 comments

Conan 2.0 documentation for package_type is not precise enough to actually inform users of the bahaviour.

Things to improve:

  1. For each package_type describe precisely how those map to requirement traits. Otherwise users will not understand the behaviour.
    So for example:
    "Requiring a static-library will set headers=True, libs=True, run=False traits by default".
    "Requiring a shared-library will set headers=True, libs=True, run=True traits by default".
  2. Document the heuristics used by Conan to guess the package_type if it is not provided.
  3. Document the heuristics used by Conan to guess the actual library type when library package type is used.
  4. Document package_id_modes used for each package type.

ZbigniewRA avatar Jun 08 '22 08:06 ZbigniewRA