From 3cd38503ba5334958faaaff556ce4ecd96ec02d8 Mon Sep 17 00:00:00 2001 From: Marek Blaha Date: Tue, 29 Jul 2025 14:37:49 +0200 Subject: [PATCH] Document SOLVER_FLAG_STRONG_RECOMMENDS flag --- doc/gen/libsolv-bindings.3 | 9 +++++++-- doc/libsolv-bindings.txt | 8 ++++++++ 2 files changed, 15 insertions(+), 2 deletions(-) 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 -.\" 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:\( 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 -- 2.47.2