how-can-i-help(1)
================
:doctype: manpage

NAME
----
how-can-i-help - show opportunities for contributing to Debian

SYNOPSIS
--------
*how-can-i-help* ['-ahq'] ['--help'] ['--all'] ['--quiet']

DESCRIPTION
-----------
*how-can-i-help* hooks into APT to list opportunities for contributions to
Debian (orphaned packages, bugs tagged 'gift') for packages installed
locally, after each APT invocation. It can also be invoked directly, and
then lists all opportunities for contribution (not just the new ones).

OPTIONS
-------
Options must come before the other command line arguments.

*-h*, *--help*::
  Show some help.

*-a*, *--all*::
  Show all opportunities for contribution.
*
*-q*, *--quiet*::
  Do not display header and footer.

PROXY SUPPORT
-------------
*how-can-i-help* uses the HTTP_PROXY (or http_proxy) environment variable as 
HTTP proxy configuration.

RUNNING ON REGULAR BASIS
------------------------
You can run *how-can-i-help* in a cron job as a normal user so that you
receive a mail when new things are reported. To receive only mails when new
contributions are reported, use the '-q' flag.

Crontab example:
-----
0 8 * * * how-can-i-help -q
-----

ADDITIONAL PACKAGES
-------------------
*how-can-i-help* can also monitor packages not installed locally. These are
listed in ~/.config/how-can-i-help/packages separated by whitespaces or
newlines.

For example one can monitor all package from a server as follow:

  # ssh myserver dpkg -l | tail -n+5 | awk '{ print $2 }' \
      >> ~/.config/how-can-i-help/packages

SEE ALSO
--------
https://wiki.debian.org/how-can-i-help

AUTHOR
------
Lucas Nussbaum (lucas@debian.org)

DATE
----
2013-10-30

// vim: set filetype=asciidoc:
