[pkg-ntp-maintainers] Bug#802768: Confusing NEWS.Debian entry

[Wouter Verhelst]

Package: ntp
Version: 1:4.2.8p4+dfsg-2
Severity: minor

Hi,

The NEWS.Debian entry for ntp 1:4.2.8p4+dfsg-2 reads as follows:

ntp (1:4.2.8p4+dfsg-2) unstable; urgency=medium

  You now need to use "rlimit memlock -1" to disable locking memory.  The
  behaviour for ""rlimit memlock 0" changed between 4.2.8p3 and 4.2.8p4 and
  it now tries to lock all the memory.  But for various people this still
  breaks things.

 -- Kurt Roeckx <kurt at roeckx.be>  Thu, 22 Oct 2015 18:58:56 +0200

It took me several times to understand what this meant, and that it
didn't apply to me. I would suggest rephrasing this so it is easier to
understand. Suggestion:

  The behaviour of the "rlimit memlock" statement in ntp.conf has
  changed. Previously, setting the value of that option to 0 would
  disable the locking of memory; its current behaviour is to lock all
  the memory. To revert to its previous behaviour, use "rlimit memlock
  -1". However, note that there are cases in which this may cause
  problems; for more information, see <reference>

This is under the assumption that rlimit memlock is, indeed, an
ntp.conf statement. I couldn't find any reference to that in the
documentation, so it could be wrong. If so, please clarify that, too.
Obviously that <reference> bit should be replaced by a link to a bug or
some bit of the documentation that explains the possible problems.

Thanks,

-- System Information:
Debian Release: stretch/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.2.0-1-amd64 (SMP w/8 CPU cores)
Locale: LANG=nl_BE.UTF-8, LC_CTYPE=nl_BE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages ntp depends on:
ii  adduser      3.113+nmu3
ii  dpkg         1.18.3
ii  libc6        2.19-22
ii  libcap2      1:2.24-12
ii  libedit2     3.1-20150325-1
ii  libopts25    1:5.18.6~pre3-3
ii  libssl1.0.0  1.0.2d-1
ii  lsb-base     9.20150917
ii  netbase      5.3

Versions of packages ntp recommends:
ii  perl  5.20.2-6

Versions of packages ntp suggests:
pn  ntp-doc  <none>

-- no debconf information