SYNOPSIS

If executed without arguments, this script will simply list the known submodules.

This script provides a generic wrapper for commands (got or otherwise) to be executed as-is on each submodule, with all arguments passed along. This is effectively a wrapper for "git submodule foreach" that invokes the command depth-first, ending with the root level.

Usage is: "nuggit foreach [<opts>] -- <cmd> <args>".

NOTICE: Unlike "git submodule foreach", this script may NOT abort on first error, and WILL also be executed at the (nuggit) root level.

The following options are supported. Options must come before command and arguments. If arguments include '-' or '--' prefixed arguments, you must provide a "--" delimeter to mark the end of arguments to this script.

--help

Display an abbreviated help menu

--man

Display detailed documentation.

--recursive | --no-recursive

Defaults to recursively executing on all nested submodules.

--break-on-error | --no-break-on-error

By default, operations will abort on the first command that fails. If this option is disabled, the specified command will be executed against all submodules, regardless of success.

--log_level

Determine Nuggit logging level. If set to 0, then the executed command will not be logged. Default value is 1, with full log results viewab le with "ngt log".