From 145d2c0475464fc2c6ba0a0b7f630356880c2015 Mon Sep 17 00:00:00 2001 From: Benson Muite Date: Jun 05 2022 12:53:02 +0000 Subject: [PATCH 1/2] Header packaging Add information described at https://bugzilla.redhat.com/show_bug.cgi?id=2091282 --- diff --git a/guidelines/modules/ROOT/pages/C_and_C++.adoc b/guidelines/modules/ROOT/pages/C_and_C++.adoc index c9605a0..39c5328 100644 --- a/guidelines/modules/ROOT/pages/C_and_C++.adoc +++ b/guidelines/modules/ROOT/pages/C_and_C++.adoc @@ -75,6 +75,12 @@ Versioning allows the library to avoid changing the SONAME when the API changes and instead compatibility functions can be written to provide backwards compatibility for older applications. +If a library requires use of header files, a separate -devel subpackage +should be created and those header files included in that package. + == Applications +Header files used only internally in an application need not be +packaged. + No additional suggestions are provided for applications at this time. From 05d3a6d6a6d37ba04ff53bdf92a114910e403616 Mon Sep 17 00:00:00 2001 From: Benson Muite Date: Jun 05 2022 13:12:01 +0000 Subject: [PATCH 2/2] Update information on including header files in -devel Follows discussion at https://bugzilla.redhat.com/show_bug.cgi?id=2091282 --- diff --git a/guidelines/modules/ROOT/pages/index.adoc b/guidelines/modules/ROOT/pages/index.adoc index 40cbb35..426ad53 100644 --- a/guidelines/modules/ROOT/pages/index.adoc +++ b/guidelines/modules/ROOT/pages/index.adoc @@ -1431,6 +1431,10 @@ for a user to use or execute the functionality in the base package properly, or if it is only necessary for development. If it is only necessary for development, it must go into a -devel package. +Header files which are only used internally when compiling an executable +or library, but not used externally with a provided API or library need not +be packaged. + As with all Fedora Packaging Guidelines, it is recognized that there are unique situations that fall outside of the boundaries of this model.