Package: debfoster Version: 2.7-1.1 Severity: minor Tags: patch Warnings from "GROFF_ENCODING=utf8 groff -b -ww -mandoc -z ..."
groff: debfoster.8: mdoc warning: Using a macro as first argument cancels effect of .Li (#136) groff: debfoster.8: /usr/share/groff/1.20.1/tmac/doc.tmac:144: backtrace: macro `print-and-reset' groff: debfoster.8: /usr/share/groff/1.20.1/tmac/doc.tmac:256: backtrace: macro `print-recursive' groff: debfoster.8: /usr/share/groff/1.20.1/tmac/doc.tmac:292: backtrace: macro `Li' <groff: debfoster.8>:394: warning [p 5, 2.9i]: cannot adjust line "Fl -XXX" changed to "Fl Fl XXX" (difference only visible in "groff"). "Fl ... -XXX" changed to "Fl ... Fl Fl XXX" (difference only visible in "groff"). "\p" removed and ".br" added as next line ("\p" expands line in "groff") Space removed from end of line Some minor formatting corrections # # Output from "nroff" should (usually) have only the left margin adjusted (".ad l"). Otherwise the space between words can be too long. Output for a manual should (usually) have the right margin ragged (".ad l"), as it is not (usually) intended for a book or other professional printing medium. # Each sentence should begin in a new line. a) The space between sentences is different between formatters. b) Changes in one line do then not affect others, and do therefore not appear as changed in the output of "diff". # Sometimes a small change in space between a roman and an italic character is needed (use ".RI" or ".IR" macros). # Remove spaces at end of lines. # Protect the last full stop (period) in abbreviations or ellipses (with \&) if it is not at the end of a sentence. # Protect the full stop (period) at the beginning of text (word) or ellipsis. # Protect a single quote (', apostrophe) (with \&) at the start of the quoted text. ## -- System Information: Debian Release: squeeze/sid APT prefers lucid-updates APT policy: (500, 'lucid-updates'), (500, 'lucid-security'), (500, 'lucid') Architecture: amd64 (x86_64) Kernel: Linux 2.6.35-25-generic (SMP w/4 CPU cores) Locale: LANG=is_IS.ISO-8859-1, LC_CTYPE=is_IS.ISO-8859-1 (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/dash Versions of packages debfoster depends on: ii libc6 2.11.1-0ubuntu7.11 Embedded GNU C Library: Shared lib ii libgc1c2 1:6.8-1.2ubuntu1.1 conservative garbage collector for Versions of packages debfoster recommends: ii apt 0.7.25.3ubuntu9.14 Advanced front-end for dpkg debfoster suggests no packages. -- no debconf information Patch: --- debfoster.8 2012-11-12 16:58:18.170606130 +0000 +++ debfoster.8.new 2012-11-12 19:13:37.802506900 +0000 @@ -7,25 +7,25 @@ .Sh SYNOPSIS .Nm .Op Fl acdefhiknopqrstvV -.Op Fl -verbose -.Op Fl -version -.Op Fl -help -.Op Fl -quiet -.Op Fl -force -.Op Fl -mark-only -.Op Fl -upgrade -.Op Fl -config Ar file -.Op Fl -keeperfile Ar file -.Op Fl -no-keeperfile -.Op Fl -ignore-default-rules -.Op Fl -show-keepers -.Op Fl -show-orphans -.Op Fl -show-depends Ar package -.Op Fl -show-dependents Ar package -.Op Fl -show-providers Ar package -.Op Fl -show-related Ar package -.Op Fl -use-tasks -.Op Fl -option Ar opt=val +.Op Fl Fl verbose +.Op Fl Fl version +.Op Fl Fl help +.Op Fl Fl quiet +.Op Fl Fl force +.Op Fl Fl mark-only +.Op Fl Fl upgrade +.Op Fl Fl config Ar file +.Op Fl Fl keeperfile Ar file +.Op Fl Fl no-keeperfile +.Op Fl Fl ignore-default-rules +.Op Fl Fl show-keepers +.Op Fl Fl show-orphans +.Op Fl Fl show-depends Ar package +.Op Fl Fl show-dependents Ar package +.Op Fl Fl show-providers Ar package +.Op Fl Fl show-related Ar package +.Op Fl Fl use-tasks +.Op Fl Fl option Ar opt=val .Op Ar package1 No ... .Op Ar package2- No ... .Sh DESCRIPTION @@ -40,7 +40,7 @@ .Nm to install and remove packages by specifying the packages on the command line. Packages suffixed with a -.Ar - +.Ar \- are removed while packages without a suffix are installed. .Pp If a new package is encountered or if @@ -92,17 +92,17 @@ .El .Ss Command line options .Bl -tag -width indent -.It Fl v, -verbose +.It Fl v, Fl Fl verbose .Nm will show which packages have disappeared, have become dependencies or (if .Pa Quiet is enabled) have become orphans. -.It Fl V, -version +.It Fl V, Fl Fl version Display version and copyright information. -.It Fl h, -help +.It Fl h, Fl Fl help Display a concise summary of the available options and argument syntax. -.It Fl f, -force +.It Fl f, Fl Fl force Don't ask anything and assume .Ql no as the answer to all questions. @@ -113,40 +113,41 @@ Can have .Ql interesting results if you're not careful. -.It Fl q, -quiet +.It Fl q, Fl Fl quiet Don't ask anything and assume .Ql yes as the answer to all questions. Useful to create an initial .Pa /var/lib/debfoster/keepers file or to recreate it after changing the configuration file. -.It Fl m, -mark-only +.It Fl m, Fl Fl mark-only Instructs debfoster to make changes to the keeper file but not to actually install or delete any packages. This can be used to .Ql edit a keeper file by invoking debfoster one or more times in a row. The changes can then be committed by invoking debfoster with the -.Fl -force +.Fl Fl force option, which will delete/install any necessary packages. This is mainly useful for scripts and frontends, but may be useful from the command line as well. -.It Fl u, -upgrade +.It Fl u, Fl Fl upgrade If used as -.Ql Nm Fl u Cm package +.\".Ql Nm Fl u Cm package +.Sq Nm Fl u Cm package it will install or upgrade the packages specified on the command line and try to upgrade all packages that it relies on. -.It Fl c, -config Ar file +.It Fl c, Fl Fl config Ar file Specify a different configuration file to use. -.It Fl k, -keeperfile Ar file +.It Fl k, Fl Fl keeperfile Ar file Specify a different .Nm database to use. -.It Fl n, -no-keeperfile +.It Fl n, Fl Fl no-keeperfile Don't read the .Nm database and start with an empty list. -.It Fl i, -ignore-default-rules +.It Fl i, Fl Fl ignore-default-rules This will instruct .Nm to ignore the @@ -159,35 +160,36 @@ different config files can cause some confusion. Properly used, .Fl i eliminates that uncertainty. -.It Fl a, -show-keepers +.It Fl a, Fl Fl show-keepers Lists the contents of the .Nm database. -.It Fl s, -show-orphans +.It Fl s, Fl Fl show-orphans List all orphaned packages that are not mentioned in the .Nm database. -.It Fl d, -show-depends Ar package +.It Fl d, Fl Fl show-depends Ar package List all packages that this package depends on. -.It Fl e, -show-dependents Ar package +.It Fl e, Fl Fl show-dependents Ar package List all packages in the .Nm database that depend on this package. -.It Fl p, -show-providers Ar package +.It Fl p, Fl Fl show-providers Ar package List all packages that provide the dependency target specified by .Ar package (e.g. .Qo Nm --p x-terminal-emulator +.Fl p +x-terminal-emulator .Qc ). -.It Fl r, -show-related Ar package +.It Fl r, Fl Fl show-related Ar package List all packages that are only installed because this package depends on them. -.It Fl t, -use-tasks +.It Fl t, Fl Fl use-tasks Make tasks visible as packages. This will make tasks that are selectable using tasksel(1) appear as packages named task-<label>. -.It Fl o, -option Ar opt=val +.It Fl o, Fl Fl option Ar opt=val Override any configuration option specified in the configuration file. .El @@ -202,7 +204,8 @@ .Bl -tag -width indent .It Va InstallCmd Default: -.Pa apt-get install\p +.Pa apt-get install +.br Command invoked with a number of packages on the command line. The command is not passed to .Pa /bin/sh @@ -211,39 +214,45 @@ with a number of packages as extra options. .It Va RemoveCmd Default: -.Pa apt-get --purge remove\p +.Pa apt-get --purge remove +.br Like .Va InstallCmd but for removing packages. .It Va InfoCmd Default: -.Pa dpkg -s\p +.Pa dpkg -s +.br Like .Va InstallCmd but called with a single package as an argument to display information on. .It Va KeeperFile Default: -.Pa /var/lib/debfoster/keepers\p +.Pa /var/lib/debfoster/keepers +.br The file where the list of orphans is stored. You can use this file for reference when installing a machine or even to make identical Debian installs. .It Va DpkgStatus Default: -.Pa /var/lib/dpkg/status\p +.Pa /var/lib/dpkg/status +.br The file where .Xr dpkg 8 stores its information about which packages are more or less installed. This value can usually be left untouched. .It Va DpkgAvailable Default: -.Pa /var/lib/dpkg/available\p +.Pa /var/lib/dpkg/available +.br The file where .Xr dpkg 8 stores its information about which packages are available. This value can usually be left untouched. .It Va MaxPriority Default: -.Pa standard\p +.Pa standard +.br Any packages with a priority greater than this value will be considered too basic to ask questions about. The default value means that questions will be asked about packages @@ -265,7 +274,8 @@ .Dl extra .It Va UseHold Default: -.Pa yes\p +.Pa yes +.br Use the .Pa hold attribute from the @@ -275,17 +285,19 @@ to assume that you want to keep it. .It Va UseEssential Default: -.Pa yes\p +.Pa yes +.br Use the .Pa Essential: line from -.Xr dpkg 8 's +.Xr dpkg 8 Ns 's status file. Most packages which are marked essential shouldn't be removed anyway, so if you don't want to be bothered with it, enable this option. .It Va UsePreDepends Default: -.Pa yes\p +.Pa yes +.br A package that pre-depends on another package requires the latter during installation. This option will make @@ -295,7 +307,8 @@ out for pre-depended packages that have become obsolete. .It Va UseRecommends Default: -.Pa yes\p +.Pa yes +.br Recommended packages would be installed together with the package that recommends them in all usual setups. This option will make @@ -305,7 +318,8 @@ were installed because another package recommended them. .It Va UseSuggests Default: -.Pa no\p +.Pa no +.br Packages suggested by another package usually enhance the function of the latter or have a related function which may be useful in combination with the package that suggested them. @@ -315,7 +329,8 @@ Using this option will result in even fewer questions being asked. .It Va UseTasks Default: -.Pa no\p +.Pa no +.br Make tasks visible as packages. This will make tasks that are selectable using tasksel(1) appear as packages named task-<label>. .Nm @@ -325,7 +340,8 @@ asking questions about it. .It Va KeepSections Default: -.Pa \p +.Pa +.br You may find that you are always interested in keeping (for example) documentation. With this option you can indicate that packages from a certain @@ -354,7 +370,8 @@ list. .It Va NegativeKeepers Default: -.Pa yes\p +.Pa yes +.br Remember explicit removals of packages. If a package is installed that has been explicitly removed before, remove it again without asking. @@ -363,7 +380,8 @@ if you want to be asked anyway. .It Va Verbose Default: -.Pa no\p +.Pa no +.br Using this option has the same result as having .Fl v on the command line. @@ -372,26 +390,30 @@ show which packages have disappeared or have become a dependency. .It Va Force Default: -.Pa no\p +.Pa no +.br This option has the same meaning as the .Fl f command line option. All orphaned packages are scheduled for removal without asking any question. .It Va Quiet Default: -.Pa no\p +.Pa no +.br Having this option (which has the same meaning as the .Fl q command line argument) in your configuration file more or less defeats the purpose of .Nm -although the +although the .Pa KeeperFile is still kept up-to-date. .El .Sh BUGS -Send reports to the Debian bug tracking system:\p -.Li http://bugs.debian.org/debfoster\p +Send reports to the Debian bug tracking system: +.br +.Li http://bugs.debian.org/debfoster +.br with as much information as you can gather (error messages, configuration files, versions of dpkg/apt, whatever might be relevant). @@ -400,5 +422,5 @@ .Xr apt-get 8 , .Xr apt-cache 8 , .Xr dpkg 8 , -.Xr deborphan 1 +.Xr deborphan 1 , .Xr tasksel 1 -- Bjarni I. Gislason -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org