1App::Pinto::Command::piUns(e3r)Contributed Perl DocumentAaptpi:o:nPinto::Command::pin(3)
2
3
4

NAME

6       App::Pinto::Command::pin - force a package to stay in a stack
7

VERSION

9       version 0.14
10

SYNOPSIS

12         pinto --root=REPOSITORY_ROOT pin [OPTIONS] TARGET ...
13

DESCRIPTION

15       This command pins a package so that it cannot be changed even if a
16       different version is added or pulled to the stack The pin is local to
17       the stack and does not affect any other stacks.
18
19       A package must be registered on the stack before you can pin it.  To
20       bring a package onto the stack, use the pull or register commands.  To
21       remove the pin from a package, see the unpin command.
22
23       When pinning, all its sister packages in that distribution also become
24       pinned.  Pinned packages also cannot be unregistered from the stack or
25       deleted from the repository without the "--force" option.
26

COMMAND ARGUMENTS

28       Arguments are the targets you wish to unpin.  Targets can be specified
29       as packages or distributions, such as:
30
31         Some::Package
32         Some::Other::Package
33
34         AUTHOR/Some-Dist-1.2.tar.gz
35         AUTHOR/Some-Other-Dist-1.3.zip
36
37       You can also pipe arguments to this command over STDIN.  In that case,
38       blank lines and lines that look like comments (i.e. starting with "#"
39       or ';') will be ignored.
40

COMMAND OPTIONS

42       --diff-style=STYLE
43           Controls the style of the diff reports.  STYLE must be either
44           "concise" or "detailed".  Concise reports show only one record for
45           each distribution added or deleted.  Detailed reports show one
46           record for every package added or deleted.
47
48           The default style is "concise".  However, the default style can
49           changed by setting the "PINTO_DIFF_STYLE" environment variable to
50           your preferred STYLE.  This variable affects the default style for
51           diff reports generated by all other commands too.
52
53       --dry-run
54           Go through all the motions, but do not actually commit any changes
55           to the repository.  Use this option to see how the command would
56           potentially impact the stack.
57
58       --message=TEXT
59       -m TEXT
60           Use TEXT as the revision history log message.  If you do not use
61           the "--message" option or the "--use-default-message" option, then
62           you will be prompted to enter the message via your text editor.
63           Use the "PINTO_EDITOR" or "EDITOR" or "VISUAL" environment
64           variables to control which editor is used.  A log message is not
65           required whenever the "--dry-run" option is set, or if the action
66           did not yield any changes to the repository.
67
68       --stack=NAME
69           Pins the package on the stack with the given NAME.  Defaults to the
70           name of whichever stack is currently marked as the default stack.
71           Use the stacks command to see the stacks in the repository.
72
73       --use-default-message
74       -M  Use the default value for the revision history log message.  Pinto
75           will generate a semi-informative log message just based on the
76           command and its arguments.  If you set an explicit message with
77           "--message", the "--use-default-message" option will be silently
78           ignored.
79

AUTHOR

81       Jeffrey Ryan Thalhammer <jeff@stratopan.com>
82
84       This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.
85
86       This is free software; you can redistribute it and/or modify it under
87       the same terms as the Perl 5 programming language system itself.
88
89
90
91perl v5.32.1                      2021-01-27       App::Pinto::Command::pin(3)
Impressum