https://fedoraproject.org/wiki/Changes/Rename_libusb_packages_and_deprecated_old_api

== Summary ==

Rename `libusb` to `libusb-compat` and `libusbx` to `libusb1`. Do
'''not''' provide an automated update path for the old `libusb` build
dependency as packages should–and likely can–be updated to use
`libusb1`.

== Owner ==
* Name: [[User:benzea|Benjamin Berg]]
* Email: bb...@redhat.com


== Detailed Description ==
Currently we have two related packages:
* libusb: Containing a compatibility layer of the 0.1 API for libusb 1.0
* libusbx: Containing the libusb 1.0 API, where the name "libusbx"
derives from a fork that existed for a while

To make it clear that "libusb" should not be used anymore and as
"libusbx" does not exist anymore, it makes sense to rename the
packages as follows:
* libusb-compat
* libusb1

In order to ensure that no package is depending on the old `libusb`
(i.e. `libusb-compat`) without a good reason, the plan is to '''not'''
add the corresponding `Provides:` line for the `libusb-compat-devel`
rename.


== Benefit to Fedora ==

* We adhere more closely to the upstream naming scheme for libusb.
* We begin sunsetting `libusb-compat` (i.e. current `libusb`).


== Scope ==
* Proposal owners:
Create new `libusb-compat` and `libusb1` packages based on the current ones.

* Other developers:
Review any package that uses `BuildRequires: libusb-devel`. Many of
them will be able to switch to `libusb1-devel` but some may still
require the compatibility layer, i.e. `libusb-compat-devel`.

* Release engineering: N/A
* Policies and guidelines: N/A (not needed for this change)
* Trademark approval: N/A (not needed for this Change)
* Alignment with Objectives: N/A


== Upgrade/compatibility impact ==
No impact is expected.

== How To Test ==
No further testing is needed.

== User Experience ==
[not provided]

== Dependencies ==
[not provided]

== Contingency Plan ==

Add `Provides: libusb-devel` to `libusb-compat-devel` if too many
packages are not updated.

* Contingency mechanism: (What to do?  Who will do it?) N/A (not a
System Wide Change)
* Contingency deadline: N/A (not a System Wide Change)
* Blocks release? N/A (not a System Wide Change)

== Documentation ==
N/A (not a System Wide Change)


-- 
Ben Cotton
He / Him / His
Senior Program Manager, Fedora & CentOS Stream
Red Hat
TZ=America/Indiana/Indianapolis
_______________________________________________
devel mailing list -- devel@lists.fedoraproject.org
To unsubscribe send an email to devel-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org

Reply via email to