Groups > linux.debian.bugs.dist > #1049303

Bug#981253: actually, make that: document minimum and maximum values of all options

From	Martin-Éric Racine <martin-eric.racine@iki.fi>
Newsgroups	linux.debian.bugs.dist
Subject	Bug#981253: actually, make that: document minimum and maximum values of all options
Date	2021-02-22 07:50 +0100
Message-ID	<BLdcB-Pc-1@gated-at.bofh.it> (permalink)
References	<BCfGG-27t-5@gated-at.bofh.it> <BCg01-2ei-1@gated-at.bofh.it> <BL6ut-5dT-1@gated-at.bofh.it> <BCfGG-27t-5@gated-at.bofh.it> <BL6ut-5dT-1@gated-at.bofh.it>
Organization	linux.* mail to news gateway

Show all headers | View raw

ma 22. helmik. 2021 klo 1.33 Santiago Garcia Mantinan
(manty@debian.org) kirjoitti:
>
> > Document the minimum and maximum values of all options, and tell which
> > value is the strongest for each.
>
> This will take a lot of time, and I don't know if this is worth the effort.
[...]
> I'll try to gather info for all this, but looks like it will be time
> consuming and that the kernel guys may change it again :-(

One way to do this would be to revise the man page exactly once at
every Debian release, at the start of the soft freeze i.e. once the
kernel version is decided, and to have a section where it says
something like:

----------
BUGS

The above options, values and meanings are correct as of Linux kernel
5.10, and may have changed since the previous major Linux kernel
release. This might indeed mean that changes in the way the Linux
kernel handles bridges have altered the way existing options are
interpreted. Whenever in doubt, consult older versions of this manual
page and compare their contents.
----------

This way, the manual page would at least be correct for the Debian
release it comes with.

Martin-Éric

Back to linux.debian.bugs.dist | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Bug#981253: bridge-utils: please document bridge_portprio values Martin-Éric Racine <martin-eric.racine@iki.fi> - 2021-01-28 14:40 +0100
  Bug#981253: actually, make that: document minimum and maximum values of all options Martin-Éric Racine <martin-eric.racine@iki.fi> - 2021-01-28 15:00 +0100
    Bug#981253: actually, make that: document minimum and maximum values of all options Santiago Garcia Mantinan <manty@debian.org> - 2021-02-22 00:40 +0100
      Bug#981253: actually, make that: document minimum and maximum values of all options Martin-Éric Racine <martin-eric.racine@iki.fi> - 2021-02-22 07:50 +0100

csiph-web