App::P...:unpin(3pm)

💖 App::Pinto::Command::unpin 💖

okay bestie, welcome to the manual page for App::Pinto::Command::unpin — that's the App::Pinto::Command::unpin(3pm) page, living its best life under User Contributed Perl Documentation. She's the one who frees your pinned packages. let's get into it 🫶

---

✨ NAME ✨

App::Pinto::Command::unpin — free packages that have been pinned 🌈

---

🌸 VERSION 🌸

version 0.14 — that's the one, no cap.

---

🦋 SYNOPSIS 🦋

pinto --root=REPOSITORY_ROOT unpin [OPTIONS] TARGET ...

---

👑 DESCRIPTION 👑

So here's the tea: this command unpins packages in the stack. why do you care? because once a package is unpinned, the stack can finally be merged into another stack that has newer packages, or the packages can be upgraded to a newer version right here inside this stack. it's giving glow-up. 💅

---

🎀 COMMAND ARGUMENTS 🎀

The arguments are the targets you wanna unpin. and like, targets can be packages or distributions, both are valid, we don't gatekeep:

Some::Package
Some::Other::Package

AUTHOR/Some-Dist-1.2.tar.gz
AUTHOR/Some-Other-Dist-1.3.zip

When you unpin a distribution, all the packages in that distribution become unpinned. and when you unpin a package, all its sister packages in the same distribution also become unpinned — because they're a package deal, literally, they ride together fr fr. 💀

You can also pipe arguments to this command over STDIN. in that case, blank lines and lines that look like comments (i.e. starting with # or ;) will be ignored. we simply do not perceive them. 🙈

---

💅 COMMAND OPTIONS 💅

• --diff-style=STYLE — controls the style of the diff reports. STYLE must be either "concise" or "detailed". concise reports show only one record for each distribution added or deleted. detailed reports show one record for every package added or deleted. the default style is "concise". however, that default can be changed by setting the PINTO_DIFF_STYLE environment variable to your preferred STYLE. heads up though — this variable affects the default style for diff reports generated by all the other commands too, so she's a global girlie. 🌍
• --dry-run — go through all the motions, but do not actually commit any changes to the repository. use this option to see how the command would potentially impact the stack. it's a vibe check before the real thing, no consequences, we love a rehearsal. ⭐
• --message=TEXT, -m TEXT — use TEXT as the revision history log message. if you don't use the --message option or the --use-default-message option, then you'll be prompted to enter the message via your text editor. use the PINTO_EDITOR or EDITOR or VISUAL environment variables to control which editor is used. also, a log message is not required whenever the --dry-run option is set, or if the action did not yield any changes to the repository. so like, if nothing happened, no essay needed bestie. 🍓
• --stack=NAME — unpins the package on the stack with the given NAME. defaults to the name of whichever stack is currently marked as the default stack. use the stacks command to see your stacks. 👀
• --use-default-message, -M — use the default value for the revision history log message. Pinto will generate a semi-informative log message just based on the command and its arguments. and if you set an explicit message with --message, the --use-default-message option will be silently ignored — she's not gonna fight about it, she'll just move on. 😭

pro tip from me to you: those flags are your whole toolkit, so keep them exactly as written. no renaming, no merging, no improvising. periodt. ✨

---

🌈 AUTHOR 🌈

Jeffrey Ryan Thalhammer <jeff@stratopan.com> — the icon, the moment, the main character. 👑

---

💜 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.

---

okay that's the whole page bestie, you're officially an unpin expert 🧚✨ this little gem comes to you from perl v5.40.1 and was dated 2025-04-21 — go forth and unpin responsibly, mwah 💖🎀🦋