From: Marek Blaha <mblaha@redhat.com>
Date: Tue, 29 Jul 2025 12:37:49 +0000 (+0200)
Subject: Document SOLVER_FLAG_STRONG_RECOMMENDS flag
X-Git-Tag: 0.7.35~3^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3cd38503ba5334958faaaff556ce4ecd96ec02d8;p=thirdparty%2Flibsolv.git

Document SOLVER_FLAG_STRONG_RECOMMENDS flag
---

diff --git a/doc/gen/libsolv-bindings.3 b/doc/gen/libsolv-bindings.3
index d5533d0d..ea935a80 100644
--- 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 ac22bd2f..d3bc4582 100644
--- 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