Get docs/man page up to date

[hololeap]

There are several new command-line options and modes available that have not been documented in the README or in the man page:

• --mode=reinstall-atoms, a.k.a. --reinstall-atoms or -R

  • Uses the relatively unknown --resintall-atoms option for emerge to mark broken packages as "not installed". This helps portage more intelligently handle the depgraph, and allows for adding things like --update to skip masked packages and @world to pull in the larger context.
  • (I would say this is no longer experimental [as I have tested it extensively on my systems], so that language should be removed from the help text)
  • Added in c4d003b

• --target=world, a.k.a --world or -W

  • Adds @world as a target for emerge (as well as for the looping logic of haskell-updater)
  • Added in c4d003b

• Custom targets a.k.a. --target=... or -T ...

  • Added in f70e076
  • Changed in 6e250fe to allow mixing/matching with other targets as long as it's using --mode=reinstall-atoms

• --world-full

  • the same as --target=world but also adds --newuse --with-bdeps=y to the emerge invocation (for convenience)
  • Added in 3a4c515

• --preserved-rebuild mode

  • similar to the default behavior but adds a @preserved-rebuild target and uses different looping logic
  • Also added in 3a4c515

---

Todo:

• Update README
• Update man page
• Clean up the --help output a bit (remove the "experimental" part about --mode=reinstall-atoms and give a succinct explanation of why it's useful)