docs icon indicating copy to clipboard operation
docs copied to clipboard

Not clear how to describe multiple licenses

Open bobham-ct opened this issue 8 months ago • 1 comments

Hi,

The documentation for the license attribute states that

This attribute can contain several, comma separated licenses. It is a text string, so it can contain any text, including hyperlinks to license files elsewhere.

However, it's not clear whether multiple licenses should be a single string containing comma-separated licenses like so:

    license = "MIT, GPL-3.0-or-later"

or a tuple of comma-separated strings:

    license = "MIT", "GPL-3.0-or-later"

I've been able to find one example and one comment from @ericriff where it's a tuple:

https://github.com/conan-io/conan-center-index/blob/bab95647f8588594a809d59af368ffd798f602da/recipes/restbed/all/conanfile.py#L20

https://github.com/conan-io/conan-center-index/issues/4333#issuecomment-765448974

Is this correct?

Regardless, could the documentation be updated to clarify which is the case? Or should it be both?

Thanks,

Bob Ham

bobham-ct avatar Aug 13 '25 14:08 bobham-ct

Hi @bobham-ct

Thanks for your feedback. I think this is really a matter of deciding first on the model side, that is, this ticket in Conan client repo: https://github.com/conan-io/conan/issues/17446, not just a docs issue, because it is not even very clear for us what would be the best approach.

I think this ticket might be closed as duplicated, and track https://github.com/conan-io/conan/issues/17446 instead (it hasn't got enough priority yet, but I hope that eventually we can follow up on it)

memsharded avatar Aug 13 '25 14:08 memsharded