Here is a patch that updates the man page. It adds documentation of the --status option, the exit codes, and the --fast option. It also changes some wording.
This patch also adds a NOTE on how update-flashplugin-nonfree *currently* decides whether to download the i386 or amd64 Flash Player. If the changes in bug 741526 https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741526 are implemented, this language will need to be changed. Matt Roberds --- update-flashplugin-nonfree.8.orig 2015-07-16 23:36:06.000000000 -0500 +++ update-flashplugin-nonfree.8 2015-07-17 00:44:05.000000000 -0500 @@ -1,45 +1,70 @@ -.TH UPDATE-FLASHPLUGIN-NONFREE 8 "August 15, 2007" +.TH UPDATE-FLASHPLUGIN-NONFREE 8 2015-07-17 .SH NAME -update-flashplugin-nonfree \- program to get the newest Adobe Flash Player +update-flashplugin-nonfree \- obtain the newest Adobe Flash Player .SH SYNOPSIS -.B update-flashplugin-nonfree -.RI --install +.B update-flashplugin-nonfree --install +| +.B --uninstall +| +.B --status +[ +.B --fast +] [ +.B --verbose +] [ +.B --quiet +] .br -.B update-flashplugin-nonfree -.RI --uninstall .SH DESCRIPTION -The program .B update-flashplugin-nonfree -takes care of -downloading last minute information from Debian about suitable versions, -removing the installed Adobe Flash Plugin if it has been reported as insecure, -or, if a newer suitable version is available, -downloading a newer Adobe Flash Player and its installer from the Adobe download site, -run the downloaded installer to install the Adobe Flash Player on the local system, -and then move the installed files to where they fit on a Debian system. +installs the latest suitable version of the Adobe Flash Player. It +determines this version by downloading information from debian.org, +then downloads the appropriate version of the Flash Player from Adobe, +then unpacks the Flash Player files to their correct locations on a +Debian system. .PP -A copy of the downloaded .tar.gz is saved in /var/cache/flashplugin-nonfree for later reuse. +It can also uninstall the Adobe Flash Player from the system, or +report the version numbers of both the latest suitable version and +the version, if any, currently installed on the system. +.PP +Normally, only one of the +.B --install +, +.B --uninstall +, or +.B --status +options should be given. If more than one of these options is given, +the one specified last on the command line will be obeyed. .PP -The program .B update-flashplugin-nonfree is used in the .B postinst and .B prerm scripts of the Debian package, -but this program can also be run manually by root. +but it can also be run manually by root. .SH OPTIONS .TP .B \-\-install -To install, update or remove the Adobe Flash Player -depending on downloaded last minute information from Debian about suitable versions. +Install the latest suitable version of the Adobe Flash Player, if it is +not already installed on the system. .TP .B \-\-uninstall -To remove the Adobe Flash Player. +Remove the currently-installed version, if any, of the Adobe Flash Player. +.TP +.B \-\-status +Print the version numbers of the latest suitable version (obtained from +debian.org) and the currently-installed version, if any (obtained by +parsing libflashplayer.so). +.TP +.B \-\-fast +When downloading files, set a network timeout of 15 seconds, and retry +at most 3 times. Otherwise, the defaults for wget apply - normally +900 seconds and 20 retries. .TP .B \-\-verbose Produce detailed information about what's happening. @@ -47,6 +72,31 @@ Produce detailed information about what' .B \-\-quiet Produce no informational output. +.SH EXIT STATUS +.TP +.B 0 +success +.TP +.B 1 +fatal error (incorrect options given, not run as root, unable to create +temporary directory, download failed, gunzip failed, gpg check +failed, sha512sum failed, update-alternatives failed) + +.SH FILES +.TP +.B /var/cache/flashplugin-nonfree +Directory where downloaded files are stored. Also contains scripts +that +.B update-flashplugin-nonfree +generates. + +.SH NOTES +.B update-flashplugin-nonfree +will download and install either the i386 or amd64 version of the Adobe +Flash Player, depending on what +.B dpkg --print-architecture +outputs. + .SH SEE ALSO .TP .B http://wiki.debian.org/FlashPlayer -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
