1App::Pinto::Command::upUdsaetre(C3o)ntributed Perl DocumAepnpt:a:tPiionnto::Command::update(3)
2
3
4

NAME

6       App::Pinto::Command::update - update packages to latest versions
7

VERSION

9       version 0.14
10

SYNOPSIS

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

DESCRIPTION

15       !! THIS COMMAND IS EXPERIMENTAL !!!
16
17       This command updates packages in your repository to the newer versions
18       in an updstream repository.  By default, Pinto takes the first newer
19       version that it finds.  If the "--cascade" option is used, then Pinto
20       will take the newest version it finds among all the upstream
21       repositories.
22

COMMAND ARGUMENTS

24       Arguments are the names of the pakcages you want to install.  If using
25       the "--all" or "--roots" options then arguments are not allowed.
26
27       You can also pipe arguments to this command over STDIN.  In that case,
28       blank lines and lines that look like comments (i.e. starting with "#"
29       or ';') will be ignored.  If using the "--all" or "--roots" options,
30       then input will not be read from STDIN.
31

COMMAND OPTIONS

33       --all
34           Update all distributions in the stack.  We do not attempt to update
35           locally added distributions unless "--force" is used.  If this
36           option is used, then package names cannot be given as command
37           arguments.  See also the "--roots" option.
38
39       --cascade
40           !! THIS OPTION IS EXPERIMENTAL !!
41
42           When searching for a package (or one of its prerequisites), always
43           take the latest satisfactory version of the package found amongst
44           all the upstream repositories, rather than just taking the first
45           newer version that is found.  Remember that Pinto only searches the
46           upstream repositories when the local repository does not already
47           contain a satisfactory version of the package.
48
49       --diff-style=STYLE
50           Controls the style of the diff reports.  STYLE must be either
51           "concise" or "detailed".  Concise reports show only one record for
52           each distribution added or deleted.  Detailed reports show one
53           record for every package added or deleted.
54
55           The default style is "concise".  However, the default style can
56           changed by setting the "PINTO_DIFF_STYLE" environment variable to
57           your preferred STYLE.  This variable affects the default style for
58           diff reports generated by all other commands too.
59
60       --dry-run
61           Go through all the motions, but do not actually commit any changes
62           to the repository.  At the conclusion, a diff showing the changes
63           that would have been made will be displayed.  Use this option to
64           see how upgrades would potentially impact the stack.
65
66       --force
67           Forcibly unpin any packages that require updating.  The pins will
68           not be restored after a succesful update.
69
70       --no-fail
71           !! THIS OPTION IS EXPERIMENTAL !!
72
73           Normally, failure to pull a target (or its prerequisites) causes
74           the command to immediately abort and rollback the changes to the
75           repository. But if C <--no-fail> is set, then only the changes
76           caused by the failed target (and its prerequisites) will be rolled
77           back and the command will continue processing the remaining
78           targets.
79
80           This option is useful if you want to throw a list of targets into a
81           repository and see which ones are problematic.  Once you've fixed
82           the broken ones, you can throw the whole list at the repository
83           again.
84
85       --message=TEXT
86       -m TEXT
87           Use TEXT as the revision history log message.  If you do not use
88           the "--message" option or the "--use-default-message" option, then
89           you will be prompted to enter the message via your text editor.
90           Use the "PINTO_EDITOR" or "EDITOR" or "VISUAL" environment
91           variables to control which editor is used.  A log message is not
92           required whenever the "--dry-run" option is set, or if the action
93           did not yield any changes to the repository.
94
95       --pin
96           Pins the packages to the stack, so they cannot be changed until you
97           unpin them.  Only the packages in the requested targets will be
98           pinned -- packages in prerequisites will not be pinned.  However,
99           you may pin them separately with the pin command if you so desire.
100
101       --recurse
102       --no-recurse
103           Recursively pull any distributions required to satisfy
104           prerequisites for the targets.  The default value for this option
105           can be configured in the pinto.ini configuration file for the
106           repository (it is usually set to 1).  To disable recursion, use
107           "--no-recurse".
108
109       --roots
110           Updates the root distributions of the stack.  We do not attempt to
111           update locally added distributions unless "--force" is used.  If
112           this option is used, then package names cannot be given as command
113           arguments.  See also the "--all" option.
114
115       --skip-missing-prerequisite=PACKAGE
116       -k PACKAGE
117           !! THIS OPTION IS EXPERIMENTAL !!
118
119           Skip any prerequisite with name PACKAGE if a satisfactory version
120           cannot be found.  However, a warning will be given whenever this
121           occurrs.  This option only has effect when recursively fetching
122           prerequisites for the targets (See also the "--recurse" option).
123           This option can be repeated.
124
125       --skip-all-missing-prerequisites
126       -K  !! THIS OPTION IS EXPERIMENTAL !!
127
128           Skips all missing prerequisites if a satisfactory version cannot be
129           found.  However, a warning will be given whenever this occurrs.
130           This option will silently override the
131           "--skip-missing-prerequisite" option and only has effect when
132           recursively fetching prerequisites for the targets (See also the
133           "--recurse" option).
134
135       --stack=NAME
136       -s NAME
137           Puts all the packages onto the stack with the given NAME.  Defaults
138           to the name of whichever stack is currently marked as the default
139           stack.  Use the stacks command to see the stacks in the repository.
140
141       --use-default-message
142       -M  Use the default value for the revision history log message.  Pinto
143           will generate a semi-informative log message just based on the
144           command and its arguments.  If you set an explicit message with
145           "--message", the "--use- default-message" option will be silently
146           ignored.
147
148       --with-development-prerequisites
149       --wd
150           Also pull development prerequisites so you'll have everything you
151           need to work on those distributions, in the event that you need to
152           patch them in the future.  Be aware that most distributions do not
153           actually declare their development prerequisites.
154

AUTHOR

156       Jeffrey Ryan Thalhammer <jeff@stratopan.com>
157
159       This software is copyright (c) 2015 by Jeffrey Ryan Thalhammer.
160
161       This is free software; you can redistribute it and/or modify it under
162       the same terms as the Perl 5 programming language system itself.
163
164
165
166perl v5.36.0                      2023-01-20    App::Pinto::Command::update(3)
Impressum