Document SOLVER_FLAG_STRONG_RECOMMENDS flag

diff --git a/doc/gen/libsolv-bindings.3 b/doc/gen/libsolv-bindings.3
index d5533d0d922d5c1bc40562f92b9b06bf78224688..ea935a80f06bfab3f0abca0ca7e18f8e60bfe5e0 100644 (file)
--- a/doc/gen/libsolv-bindings.3
+++ b/doc/gen/libsolv-bindings.3
@@ -2,12 +2,12 @@
 .\"     Title: Libsolv-Bindings
 .\"    Author: [see the "Author" section]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 07/09/2024
+.\"      Date: 07/29/2025
 .\"    Manual: LIBSOLV
 .\"    Source: libsolv
 .\"  Language: English
 .\"
-.TH "LIBSOLV\-BINDINGS" "3" "07/09/2024" "libsolv" "LIBSOLV"
+.TH "LIBSOLV\-BINDINGS" "3" "07/29/2025" "libsolv" "LIBSOLV"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -4061,6 +4061,11 @@ Make the solver aware of special provides of the form \(lq<packagename>:<path>\(
 Do not process optional (aka weak) dependencies\&.
 .RE
 .PP
+\fBSOLVER_FLAG_STRONG_RECOMMENDS\fR
+.RS 4
+Make the solver backtrack to satisfy Recommends dependencies (e\&.g\&., update packages, choose different alternatives, etc\&.)\&. With this flag, Recommends function like Requires, which can be broken\&. You can use this feature to allow the solver to install weak dependencies, even if it requires updating currently installed packages\&.
+.RE
+.PP
 \fBSOLVER_FLAG_ADD_ALREADY_RECOMMENDED\fR
 .RS 4
 Install recommended or supplemented packages even if they have no connection to the current transaction\&. You can use this feature to implement a simple way for the user to install new recommended packages that were not available in the past\&.

diff --git a/doc/libsolv-bindings.txt b/doc/libsolv-bindings.txt
index ac22bd2fac36c1e9479a0b682efa3d847532f59a..d3bc4582921c0b869543932de97b2ceeccb1f55d 100644 (file)
--- a/doc/libsolv-bindings.txt
+++ b/doc/libsolv-bindings.txt
@@ -2405,6 +2405,14 @@ splits.
 *SOLVER_FLAG_IGNORE_RECOMMENDED*::
 Do not process optional (aka weak) dependencies.
 
+*SOLVER_FLAG_STRONG_RECOMMENDS*::
+Make the solver backtrack to satisfy Recommends dependencies (e.g.,
+update packages, choose different alternatives, etc.). With this
+flag, Recommends function like Requires, which can be broken.
+You can use this feature to allow the solver to install weak
+dependencies, even if it requires updating currently installed
+packages.
+
 *SOLVER_FLAG_ADD_ALREADY_RECOMMENDED*::
 Install recommended or supplemented packages even if they have no
 connection to the current transaction. You can use this feature