Bug#674523: apt-get manpage: please document option --solver
Control: severity -1 important
Control: tags -1 + patch
Patch attached. I didn't update the .po files yet because I supposed there might be a way to automate the c+p of the English parts, which I'll defer to you guys.
Manuel A. Fernandez Montecelo:
> Control: severity -1 minor
>
> Hi,
>
> 2016-08-18 12:49 Ximin Luo:
>> Package: apt
>> Version: 1.3~rc1
>> Followup-For: Bug #674523
>> Control: severity -1 important
>>
>> Hi, I'm bumping the severity for this because it's many years old, and it is
>> hiding an important feature from users.
>
> I disagree.
>
> If anything, being present for many years is an indication that it's not
> that urgent/important, specially not when nobody felt that it was
> important enough to work on it or submit patches.
>
I disagree.
*I* think it's important. Probably nobody felt it was important, because they didn't know that the option exists, because it's undocumented.
On another point: Debian Developers should not be expected to act as a developer *for every single package*; that would be ridiculous, not scalable, implies no DD should ever file any bug. From the point of view of APT, I am an ordinary user.
A simple "please submit a patch, I don't have time to work on this myself" would have been sufficient, instead of convolutedly arguing "you shouldn't have touched this bug in the first place".
X
--
GPG: ed25519/56034877E1F87C35
GPG: rsa4096/1318EFAC5FBBDBCE
https://github.com/infinity0/pubkeys.git
diff -Nru -w apt-1.3~rc1/debian/changelog apt-1.3~rc1+nmu1/debian/changelog
--- apt-1.3~rc1/debian/changelog 2016-08-11 14:10:22.000000000 +0200
+++ apt-1.3~rc1+nmu1/debian/changelog 2016-08-18 21:24:19.000000000 +0200
@@ -1,3 +1,10 @@
+apt (1.3~rc1+nmu1) UNRELEASED; urgency=medium
+
+ * Non-maintainer upload.
+ * Document the --solver flag and fix some other details. (Closes: #674523)
+
+ -- Ximin Luo <infinity0@debian.org> Thu, 18 Aug 2016 21:24:19 +0200
+
apt (1.3~rc1) unstable; urgency=medium
* Summary: CMake branch merged, socks5h (and tor) support, and fancy
diff -Nru -w apt-1.3~rc1/doc/apt.ent apt-1.3~rc1+nmu1/doc/apt.ent
--- apt-1.3~rc1/doc/apt.ent 2016-08-11 14:10:22.000000000 +0200
+++ apt-1.3~rc1+nmu1/doc/apt.ent 2016-08-18 21:24:19.000000000 +0200
@@ -205,6 +205,9 @@
<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel -->
<!ENTITY synopsis-architecture "architecture">
+<!-- TRANSLATOR: used as in apt-get install --solver=solver pkg e.g. --solver=aspcud -->
+<!ENTITY synopsis-solver "solver">
+
<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome -->
<!ENTITY synopsis-pkg "pkg">
diff -Nru -w apt-1.3~rc1/doc/apt-get.8.xml apt-1.3~rc1+nmu1/doc/apt-get.8.xml
--- apt-1.3~rc1/doc/apt-get.8.xml 2016-08-11 14:10:22.000000000 +0200
+++ apt-1.3~rc1+nmu1/doc/apt-get.8.xml 2016-08-18 21:24:19.000000000 +0200
@@ -130,6 +130,13 @@
installed.
</para>
+ <para>An external solver may be specified with --solver=&synopsis-solver;
+ where &synopsis-solver; is a file listed in <filename>/usr/lib/apt/solvers</filename>
+ except that "dump" is not a valid value, and "apt" refers to the internal
+ solver. You may also be interested in the apt-cudf package which integrates
+ APT with some generic solver packages. See also <filename>doc/external-dependency-solver-protocol.txt</filename>
+ for the details of how APT interoperates with external solvers.</para>
+
<para>Finally, the &apt-preferences; mechanism allows you to
create an alternative installation policy for
individual packages.</para>
diff -Nru -w apt-1.3~rc1/doc/apt-verbatim.ent apt-1.3~rc1+nmu1/doc/apt-verbatim.ent
--- apt-1.3~rc1/doc/apt-verbatim.ent 2016-08-11 14:10:22.000000000 +0200
+++ apt-1.3~rc1+nmu1/doc/apt-verbatim.ent 2016-08-18 21:24:19.000000000 +0200
@@ -259,6 +259,7 @@
<!ENTITY synopsis-arg-config "<arg><option>-c=<filename><replaceable>&synopsis-config-file;</replaceable></filename></option></arg>">
<!ENTITY synopsis-arg-target-release "<arg><option>-t=<replaceable>&synopsis-target-release;</replaceable></option></arg>">
<!ENTITY synopsis-arg-architecture "<arg><option>-a=<replaceable>&synopsis-architecture;</replaceable></option></arg>">
+<!ENTITY synopsis-arg-solver "<arg><option>--solver=<replaceable>&synopsis-solver;</replaceable></option></arg>">
<!ENTITY synopsis-arg-pkgver "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable><arg><group choice='req'>
<arg choice='plain'>=<replaceable>&synopsis-pkg-ver-number;</replaceable></arg>
<arg choice='plain'>/<replaceable>&synopsis-target-release;</replaceable></arg>
@@ -299,7 +300,7 @@
<arg choice='plain'>upgrade</arg>
<arg choice='plain'>dselect-upgrade</arg>
<arg choice='plain'>dist-upgrade</arg>
- <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
+ <arg choice='plain'>install &synopsis-arg-solver; &synopsis-arg-pkgver;</arg>
<arg choice='plain'>remove &synopsis-arg-pkg;</arg>
<arg choice='plain'>purge &synopsis-arg-pkg;</arg>
<arg choice='plain'>source &synopsis-arg-pkgver;</arg>
diff -Nru -w apt-1.3~rc1/doc/external-dependency-solver-protocol.txt apt-1.3~rc1+nmu1/doc/external-dependency-solver-protocol.txt
--- apt-1.3~rc1/doc/external-dependency-solver-protocol.txt 2016-08-11 14:10:22.000000000 +0200
+++ apt-1.3~rc1+nmu1/doc/external-dependency-solver-protocol.txt 2016-08-18 21:24:16.000000000 +0200
@@ -46,7 +46,7 @@
No non-solver files must be installed under `/usr/lib/apt/solvers`, so
that an index of available external solvers can be obtained by listing
-the content of that directory.
+the content of that directory. There is one exception, the `dump` program.
## Configuration
Reply to: