.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "App::Pinto::Command::props 3pm" .TH App::Pinto::Command::props 3pm "2022-10-16" "perl v5.34.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" App::Pinto::Command::props \- show or set stack properties .SH "VERSION" .IX Header "VERSION" version 0.14 .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& pinto \-\-root=REPOSITORY_ROOT props [OPTIONS] [STACK] .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This command shows or sets stack configuration properties. If the \&\f(CW\*(C`\-\-properties\*(C'\fR option is given, then the properties will be set. If the \f(CW\*(C`\-\-properties\*(C'\fR option is not given, then properties will just be shown. .SH "COMMAND ARGUMENTS" .IX Header "COMMAND ARGUMENTS" If the \f(CW\*(C`STACK\*(C'\fR argument is given, then the properties for that stack will be set/shown. If the \f(CW\*(C`STACK\*(C'\fR argument is not given, then properties for the default stack will be set/shown. .SH "COMMAND OPTIONS" .IX Header "COMMAND OPTIONS" .IP "\-\-format=FORMAT_SPECIFICATION" 4 .IX Item "--format=FORMAT_SPECIFICATION" Format the output using \f(CW\*(C`printf\*(C'\fR\-style placeholders. This only matters when showing properties. Valid placeholders are: .Sp .Vb 4 \& Placeholder Meaning \& \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \& %p Property name \& %v Package value .Ve .IP "\-\-properties name=value" 4 .IX Item "--properties name=value" .PD 0 .IP "\-\-prop name=value" 4 .IX Item "--prop name=value" .IP "\-P name=value" 4 .IX Item "-P name=value" .PD 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. .Sp Properties starting with the prefix \f(CW\*(C`pinto\-\*(C'\fR are reserved for internal use, \s-1SO DO NOT CREATE OR CHANGE THEM.\s0 .SH "SUPPORTED PROPERTIES" .IX Header "SUPPORTED PROPERTIES" The following properties are supported for each stack: .IP "description" 4 .IX Item "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 \*(L"The \s-1STACK_NAME\s0 stack\*(R". For a copied stack, defaults to \&\*(L"Copy of stack \s-1STACK_NAME\*(R".\s0 .IP "target_perl_version" 4 .IX Item "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. .Sp 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: .Sp .Vb 1 \& cpanm \-L /opt/local/pinto/ Module::CoreList .Ve .SH "AUTHOR" .IX Header "AUTHOR" Jeffrey Ryan Thalhammer .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer. .PP This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.