Add new --needed option for -S.

During a pacman operation such as a group install, pacman can ask several
questions such as "local version is up to date. Upgrade anyway?". They are
usually all answered either by yes or by no:
* yes when you want to reinstall all the targets.
* no when you only want to install the missing ones (either because you are
installing a group, or because you are copying a pacman -S line from wiki or
whatever).

So instead of asking this question for each target, it is now now configured
with a flag.  Yes will be the default -S behavior, No will be achieved with
the --needed flag.

Signed-off-by: Chantry Xavier <shiningxc@gmail.com>
Signed-off-by: Dan McGee <dan@archlinux.org>

1 files changed, 3 insertions, 0 deletions

diff --git a/doc/pacman.8.txt b/doc/pacman.8.txt
index 887f9122..9e00d36e 100644
--- a/doc/pacman.8.txt
+++ b/doc/pacman.8.txt
@@ -261,6 +261,9 @@ Sync Options[[SO]]
 	'\--sysupgrade' or '-u'. Passing two '\--refresh' or '-y' flags will force
 	a refresh of all package lists even if they are thought to be up to date.
 
+*\--needed*::
+	Only install the targets that are not already installed and up-to-date.
+
 *\--ignore* <'package'>::
 	Directs pacman to ignore upgrades of package even if there is one
 	available. Multiple packages can be specified by separating them