[Apt-listbugs-commits] [apt-listbugs] 03/05: add a FILES section to the man page

[Francesco Poli]

This is an automated email from the git hooks/post-receive script.

frx-guest pushed a commit to branch master
in repository apt-listbugs.

commit aad429636459da927ec368b5236c6a917a548889
Author: Francesco Poli (wintermute) <invernomuto at paranoici.org>
Date:   Sun Sep 18 19:14:55 2016 +0200

    add a FILES section to the man page
---
 bin/apt-listbugs | 26 ++++++++++++++++++++++++++
 debian/changelog |  1 +
 2 files changed, 27 insertions(+)

diff --git a/bin/apt-listbugs b/bin/apt-listbugs
index 1e5af41..8ce72cd 100755
--- a/bin/apt-listbugs
+++ b/bin/apt-listbugs
@@ -303,6 +303,32 @@ e.g.:
 N.B.: When the program is invoked by APT, any non-zero exit status will
 cause the installation/upgrade to be aborted.
 
+= FILES
+
+: ((*/etc/apt/preferences.d/apt-listbugs*))
+
+  Version preferences file fragment for APT managed by (({apt-listbugs})):
+  this is where the package pins are added by the (({apt-listbugs})) program
+  and removed by its daily cron job. This file is managed automatically
+  and there's normally no need to modify it by hand.
+
+: ((*/var/lib/apt-listbugs/ignore_bugs*))
+
+  Automatic list of bug numbers to be ignored by (({apt-listbugs})): this is
+  where the program saves the bug numbers that the user decided to ignore.
+  This file is managed automatically and there's normally no need to modify
+  it by hand.
+
+: ((*/etc/apt/listbugs/ignore_bugs*))
+
+  User list of bug numbers and packages to be ignored by (({apt-listbugs})):
+  this is where the (root) user may manually add bug numbers or package names
+  that (({apt-listbugs})) will ignore. This file is only read by
+  (({apt-listbugs})), but never modified: the (root) user has to edit it by
+  hand. The format is: one bug number or package name per line; lines
+  whose first non-blank character is '#' are treated as comments and
+  skipped entirely.
+
 = AUTHORS
 
 2002 - 2004: (({apt-listbugs})) was originally written by Masato Taruishi
diff --git a/debian/changelog b/debian/changelog
index 4a7e1ce..b1c7bf4 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -8,6 +8,7 @@ apt-listbugs (0.1.19) UNRELEASED; urgency=medium
        bin/apt-listbugs(1)
      - reformatted the whole document, to better comply with man page
        usual conventions
+     - added a FILES section
   * moved a couple of options in the online help to reflect the new option
     ordering in the man page
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/apt-listbugs/apt-listbugs.git