The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

SYNOPSIS

Display submodule-aware status of project.

   nuggit status
--help

Display an abbreviated help menu

--man

Display detailed documentation. -- =item --uno | -u

Ignore untracked files

--ignored

Show ignored files

--json

Show raw status structure in JSON format.

--conflicts | -c

Filter status output to show submodule summaries and conflicted files only.

Output Details

Submodule State

If a submodule's checked out commit does not match the committed reference, the status will show as "Delta-Commits". If the "--details" or "-d" flag is specified, then details will be shown on both the currently checked out commit in this submodule, and the commit that the parent repository references.

If a submodule's checked out commit is out of sync with the upstream branch, it will show as "Upstream-Delta( +x -y )" where x is the number of commits that the local copy is ahead of the remote, and y is the number of commits the upstream branch is ahead of the local version. Note: Users should run "ngt fetch" prior to status to ensure an accurate reflection of the current Upstream state.