NAME

       App::Pinto::Command::props - show or set stack properties

VERSION

       version 0.097

SYNOPSIS

         pinto --root=REPOSITORY_ROOT props [OPTIONS] [STACK]

DESCRIPTION

       This command shows or sets stack configuration properties.  If the "--properties" option is given, then
       the properties will be set.  If the "--properties" option is not given, then properties will just be
       shown.

COMMAND ARGUMENTS

       If the "STACK" argument is given, then the properties for that stack will be set/shown.  If the "STACK"
       argument is not given, then properties for the default stack will be set/shown.

COMMAND OPTIONS

       --format=FORMAT_SPECIFICATION
           Format the output using "printf"-style placeholders.  This only matters when showing properties.
           Valid placeholders are:

             Placeholder    Meaning
             -----------------------------------------------------------------------------
             %p             Property name
             %v             Package value

       --properties name=value
       --prop name=value
       -P name=value
           Specifies property names and values.  You can repeat this option to set multiple properties.  If the
           property with that name does not already exist, it will be created.  Property names must be
           alphanumeric plus hyphens and underscores, and will be forced to lower case.  Setting a property to
           an empty string will cause it to be deleted.

           Properties starting with the prefix "pinto-" are reserved for internal use, SO DO NOT CREATE OR
           CHANGE THEM.

SUPPORTED PROPERTIES

       The following properties are supported for each stack:

       description
           A description of the stack, usually to inform users of the application and/or environment that the
           stack is intended for.  For a new stack, defaults to "The STACK_NAME stack".  For a copied stack,
           defaults to "Copy of stack STACK_NAME".

       target_perl_version
           The version of perl that this stack is targeted at.  This is used to determine whether a particular
           package is satisfied by the perl core and therefore does not need to be added to the stack.

           It must be a version string or number for an existing perl release, and cannot be later than the
           latest version specified in your Module::CoreList.  To target even newer perls, just install the
           latest version of Module::CoreList.

AUTHOR

       Jeffrey Ryan Thalhammer <jeff@stratopan.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2013 by Jeffrey Ryan Thalhammer.

       This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5
       programming language system itself.