choose: Pick license and comment style for boilerplate
choose command selects a license notice and commenting style for the current working boilerplate. The most common execution of this command is:
$ licensing choose gpl c Selected.
This example selects the latest version of the GNU General Public License and the C commenting style. It is equivalent to:
$ licensing choose c Selected. $ licensing choose gplv3+ Selected.
To perform dual-licensing, more than one license can be selected. For example:
$ licensing choose gpl apache c Selected.
When more than one commenting style is given to the
choose command, the final commenting style is the one that is selected.
Tab completion will display the available commenting styles and licenses. Alternatively,
choose --help will suffice.
Although all of the available licenses are compatible with the GPL, some of them are not recommended. To select one of the unrecommended licenses, the
choose command must be called with the
choose is executed in the
lu-sh shell, the prompt changes to reflect the selected licenses and commenting style.
The --quiet option prevents the final ‘Selected.’ message from appearing.
choose command requires internet connectivity to download the licenses from the www.fsf.org or www.gnu.org.
Subsequent calls to the
choose command will override previous calls. After the current working boilerplate has been applied to some source files, it is often useful to
choose a different commenting style before applying it to another file (e.g. all other aspects of the current working boilerplate are left unchanged except for the commenting style).