TL;DR: I propose move man pages out of a multi-arch: same package into a
arch all package. Asking for any downsides and usrmerge review.
My proposal is to move the man pages into libpam-doc.
I'm not actually convinced that normal Debian users need man pages for
all the pam modules on all Debian systems, and a suggests relationship
should be sufficient.
If people really want to maintain the current level of man page
presence, we could move the manpages into libpam-modules-bin which is
M-A: foreign.
"Marvin" == Marvin Renich <mrvn@renich.org> writes:
My proposal is to move the man pages into libpam-doc. I'm not actually convinced that normal Debian users need man pages for all the pam
modules on all Debian systems, and a suggests relationship should be sufficient. If people really want to maintain the current level of man
page presence, we could move the manpages into libpam-modules-bin which
is M-A: foreign.
"G" == G Branden Robinson <g.branden.robinson@gmail.com> writes:
For a while we just built the man pages but if any of the docbook tools changed between one arch build and another, we'd end up with m-a uninstallable packages.
On 1/16/25 01:43, Sam Hartman wrote:
For a while we just built the man pages but if any of the docbook tools
changed between one arch build and another, we'd end up with m-a
uninstallable packages.
Can this be fixed by removing the "Generator:" comment in the generated manpage, and possibly clamping the included date to SOURCE_DATE_EPOCH?
There are various things one can do to try to make the output of a man
page generator like that more consistent, but they don't fix the problem, just reduce its frequency, unless Debian sets up to do a fully
reproducible build with pinned versions of everything (which I don't think
we want to do).
My proposal is to move the man pages into libpam-doc.
I'm not actually convinced that normal Debian users need man pages for
all the pam modules on all Debian systems, and a suggests relationship
should be sufficient.
From a package building pov, I'd appreciate if you could also move thetools for building the manual pages to Build-Depends-Indep while you
I think there are no usrmerge implications. While libpam-modules did
move files from /lib/multiarch_tripple/security to /usr/lib/multiarch_tripple/security, the man pages have always been in /usr/share/man, which lives on /usr.
Hi,
On 1/16/25 13:22, Russ Allbery wrote:
There are various things one can do to try to make the output of a manthink
page generator like that more consistent, but they don't fix the problem, just reduce its frequency, unless Debian sets up to do a fully
reproducible build with pinned versions of everything (which I don't
we want to do).
Agreed, it's not a complete fix, but I'd expect the frequency of changes
in the output besides the version number to be low enough for this to be
the least-effort solution.
If it means we need to trigger a rebuild of a few packages every few
years, then this thread has already used more time.
Simon
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;padding-left:1ex;border-left-color:rgb(204,204,204)">Hi,<br>
My proposal is to move the man pages into libpam-doc.
I'm not actually convinced that normal Debian users need man pages for
all the pam modules on all Debian systems, and a suggests relationship
should be sufficient.
If people really want to maintain the current level of man page
presence, we could move the manpages into libpam-modules-bin which is
M-A: foreign.
Do you actually have a system on which you want these man pages and on
which the extra space of libpam-doc would be a problem?
Unless there's a compelling need, my answer is that I don't understand
why manpages should be separated from other documentation in this instance.
I'm not actually convinced that normal Debian users need man pages for
all the pam modules on all Debian systems, and a suggests relationship
should be sufficient.
"Guillem" == Guillem Jover <guillem@debian.org> writes:
(We'd also need to do something about libpam0g-dev man pages).
On 2025. Jan 16., Thu at 8:17, Simon Richter <sjr@debian.org> wrote:
Agreed, it's not a complete fix, but I'd expect the frequency of
changes in the output besides the version number to be low enough for
this to be the least-effort solution.
If it means we need to trigger a rebuild of a few packages every few
years, then this thread has already used more time.
I agree. It is very easy to detect file differences between multiarch packages and scheduling binNMUs.
Since the described problem potentially affects all packages shipping
man pages with the binaries - which is the best practice - splitting man pages from a single package to solve that particular problem sounds misdirected effort.
"Simon" == Simon Richter <sjr@debian.org> writes:
"Simon" == Simon McVittie <smcv@debian.org> writes:
With the exception of Simon Richter, we appear to be agreed that
avoiding man pages in m-a: same packages is good.
basically we'd have to give every -dev package containing
manual pages a -doc package
Many libraries have their API reference as HTML or even PDF, generated
via something like Doxygen, gtk-doc or Pandoc,
| Sysop: | Keyop |
|---|---|
| Location: | Huddersfield, West Yorkshire, UK |
| Users: | 546 |
| Nodes: | 16 (2 / 14) |
| Uptime: | 151:31:35 |
| Calls: | 10,383 |
| Files: | 14,054 |
| Messages: | 6,417,807 |