Just like verbs are actions in a sentence and adverbs modifiy verbs, so in the newt tool, commands are actions and flags modify actions. A command can have subcommands. Arguments to commands and subcommands, with appropriate flags, dictate the execution and result of a command.
For instance, in the example below, the newt command has the subcommand
target set in which the argument 'my_target1' is the target whose attribute, app, is set to '@apache-mynewt-core/hw/bsp/nrf52dk'
newt target set my_target1 app=@apache-mynewt-core/hw/bsp/nrf52dk
Global flags work uniformly across newt commands. Consider the flag
-v, --verbose, It works both for command and subcommands, to generate verbose output. Likewise, the help flag
--help, to print helpful messsages.
A command may additionally take flags specific to it. For example, the
-n flag instructs
newt debug not to start GDB from command line.
newt debug <target-name> -n
In addition to the Newt Tool Manual in docs, command-line help is available for each command (and subcommand), through the
newt target --help Commands to create, delete, configure, and query targets Usage: newt target [flags] newt target [command] Available Commands: amend Add, change, or delete values for multi-value target variables config View or populate a target's system configuration copy Copy target create Create a target delete Delete target dep View target's dependency graph revdep View target's reverse-dependency graph set Set target configuration variable show View target configuration variables Global Flags: -h, --help Help for newt commands -j, --jobs int Number of concurrent build jobs (default 8) -l, --loglevel string Log level (default "WARN") -o, --outfile string Filename to tee output to -q, --quiet Be quiet; only display error output -s, --silent Be silent; don't output anything -v, --verbose Enable verbose output when executing commands Use "newt target [command] --help" for more information about a command.