Arch(3pm)

💖 Arch(3pm) — like, the whole vibe 💖

okay bestie, you're looking at Arch(3pm), which is a Perl manual page from the User Contributed Perl Documentation section. Yes, 3pm means it's a Perl module page. Sit down, hydrate, we're doing this. 🫶

---

✨ NAME ✨

Arch — the GNU Arch Perl library. that's it, that's the name, she's simple and she's iconic. 👑

---

🌸 SYNOPSIS 🌸

here's how you actually use her:

use Arch 0.5.2;

# perldoc Arch
# axp man Arch

# example: produce ChangeLog for the current project
use Arch::Tree;

foreach my $log (Arch::Tree->new->get_logs) {
    print "-" x 80, "\n";
    print $log->standard_date, "\n";
    print $log->summary, "\n\n";
    print $log->body;
}

so yeah, you use Arch 0.5.2; — note the version, 0.5.2, it's literally right there in the statement, don't skip it. 🍓

then there's # perldoc Arch and # axp man Arch — two lil ways to pull up this very page, she said "read me" and honestly? relatable.

and then the example: it's producing a ChangeLog for the current project. it pulls in Arch::Tree, and then loops over Arch::Tree->new->get_logs, and for every $log it prints 80 dashes ("-" x 80) plus a newline, then $log->standard_date, then $log->summary with a lil double newline after, then $log->body. beautiful. no notes. 💅

---

🦋 DESCRIPTION 🦋

The Arch-Perl library is here so Perl developers can build GNU Arch front-ends in an object oriented fashion. no cap. 🎀

GNU Arch itself is a decentralized, changeset-oriented revision control system. like, distributed before distributed was cool, iykyk.

currently — and this is the part where she's being real with you — a pragmatic high-level interface is built around tla or baz. those are the tools she's actually wrapping.

this functionality was initially developed for the ArchZoom project, and then was highly enhanced to serve the AXP and ArchWay projects as well. glow-up arc, honestly. 🌈✨

---

👑 AUTHORS 👑

• Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).
• Enno Cramer (uebergeek@web.de--2003/arch-perl--devel).

two legends, both credited with their full arch-style addresses, keep them exact please, they earned those. 💖

---

🔥 SEE ALSO 🔥

for more information, see tla, Arch::Backend, Arch::Changes, Arch::Changeset, Arch::DiffParser, Arch::FileHighlighter, Arch::Inventory, Arch::Library, Arch::LiteWeb, Arch::Log, Arch::Name, Arch::Registry, Arch::RevisionBunches, Arch::Run, Arch::RunLimit, Arch::Session, Arch::SharedCache, Arch::SharedIndex, Arch::Storage, Arch::Tarball, Arch::TempFiles, Arch::Test::Archive, Arch::Test::Cases, Arch::Test::Framework, Arch::Test::Tree. Arch::Tree, Arch::Util.

okay yes that's a LOT of modules and yes you have to read all of them, but that's the friend group, bestie — every single one is listed, none skipped, no cap. 📚💜

---

heads up: that's the complete list from the page, including the slightly chaotic punctuation around Arch::Tree and Arch::Util at the end. we don't "fix" the source, we respect the source. 🫡

---

and that's a wrap, gorgeous. this page was rendered by perl v5.20.2 and dated 2005-10-23 — yes, a lil vintage, an elder statesman of a manpage, and still serving. mwah. 😭💖🎀