FINGERW(1p)

📦 version 0.105, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 FINGERW(1p) — the perl-y manual, but make it cute 💖

okay bestie, so this is fingerw, part of the 1p section of the manual (that's the "user contributed perl documentation" corner of the docs, iykyk), and it's the command-line tool that ships with WWW::Finger. yes. we're doing the whole finger thing but through a command line glow-up. 🫶

✨ NAME ✨

fingerw — the WWW::Finger command-line tool, literally the CLI era of finger 💅

🌸 SYNOPSIS 🌸

so here's the vibe, the whole shape of it:

fingerw [options] identifier

  Options:
    --help, -h         this help message
    --format=F, -f F   output format
    --verbose, -v      increase verbosity

and the identifier you hand it? it should be an e-mail-like URI. that's the moment. that's the assignment. 📧✨

🎀 OPTIONS 🎀

  • --help — prints you a lil brief help message and then dips. that's it, that's the whole job. exits immediately, no notes. 👑
  • --format — sets the output format, aka how you want your data served. rn the supported ones are:
    • 'text' — human readable plain text output, and yes it's the default, the main character, the one you get if you don't ask for anything else 🥰
    • 'vcard' — vCard 3.0, for when you want it fancy
    • 'xml' — RDF/XML, very structured, very demure
    • 'nt' — N-Triples, the raw triple energy
⚠️ real talk though: the amount and type of data returned may vary depending on which format you pick. so like, don't be shocked when different formats give you different stuff. it's giving "expected behaviour", not a bug. 💀
  • --verbose — shows debugging messages. turn it on when you need to see the receipts of what's happening under the hood 🔍

also there's a shorthand version of each: -h for help, -f F for format (where F is your format value), and -v for verbose. the synopsis said it, so we're saying it. periodt. 🩷

🌈 AUTHOR 🌈

Toby Inkster, <tobyink@cpan.org> — shoutout to the icon who made this happen 🫡💜

Copyright (C) 2009-2011 by Toby Inkster

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. so like, it's free free. go off. 🎀

🦋 DISCLAIMER OF WARRANTIES 🦋

okay so this part is in all caps in the original and honestly? it's giving legal drama so we're keeping the drama:

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

translation bestie: no promises, no guarantees, use it at your own risk, the author is not your safety net. fr fr. 😭

and that's the whole page!! this beauty is perl v5.32.1, dated 2021-09-11, filed under FINGERW(1p) 💖 mwah, go finger some URIs responsibly, ily bye 🧚✨

📦 where this page comes from