NAME

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

VERSION

       version 0.14

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.   Remember  that  Pinto  is  often  installed as a stand-alone
           application, so you will need to update Pinto's copy of Module::CoreList - for example:

            cpanm -L /opt/local/pinto/ Module::CoreList

AUTHOR

       Jeffrey Ryan Thalhammer <jeff@stratopan.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2015 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.

perl v5.36.0                                       2022-10-16                    App::Pinto::Command::props(3pm)