Documentation for patch_amber.py

Usage:

Flags that control program behavior for different operating modes:  |
---------------------------------------------------------------------

--ignore-fails

Ignore errors arising from non-zero exit codes from patch (failed to apply HUNKs
due to bad patch or previously-applied patch).  This will NOT prevent any fatal
errors, including a patch file that doesn't seem to patch any files.


Flags that control print-out  |
-------------------------------

--loud

Print full patch descriptions (Author, Date created, Programs fixed, Files
affected, and the full Description listed in the patch)

--quiet  [Default]

Same as loud, but without the full Description

--dead-silent

Suppress all of the information, just give file names and patch numbers as
appropriate


Operating modes (all mutually exclusive):  |
--------------------------------------------

  Normal Options: (use these unless you KNOW what you're doing)
  -------------------------------------------------------------

--patch-level

Look at all of the patches that have been applied and return the one with the
largest suffix (bugfix.#) for each bugfix repository that is managed.

--check-updates

Go online (http://ambermd.org/) and look for any bugfix.# where # is higher than
the patch levels determined in the same process as for --patch-level, but do NOT
download any files. Print all of the descriptions according to the verbose flags

--update-tree

Goes online, downloads all of the patches that have NOT yet been applied 
according to the patches found via the process used during --check-updates and
applies them directly to the tree, storing those patches as applied.

  Advanced Options:
  -----------------

--download-patches

Same as --update-tree, but only downloads the patches, it does not apply them.

--apply-patch

Pick a specific bugfix and apply that using "patch -p0 -N". If it's in one of
the unapplied patch directories (if you put it there or you just apply a patch
obtained from --download-patches), it moves it into its corresponding applied
patch directory.

--reverse-patch

Pick a specific bugfix and apply that using "patch -p0 -R". If it's in one of 
the applied patch directories (if it's already been applied, for instance), then
it is moved into its corresponding unapplied patch directory.

--show-applied-patches

List all of the patches that have been applied and are in the applied patch
directories. It will not show any patches applied from --apply-patch that were
NOT moved into the applied patch directories. Print details pursuant to print
level flags set.

--show-unapplied-patches

List all of the patches that are in the unapplied patch directories (usually
just the patches that were reversed and moved into unapplied patch dirs and the
patches that were downloaded from --download-patches