FRIBIDI(1)

💅 FRIBIDI(1) — the perl one, bestie, not the C one

User Contributed Perl Documentation ✨ like, the community wrote this one, we're all just vibing in the same man section

---

🦋 NAME

fribidi.pl — convert logical text to visual, via the unicode bidi algorithm 🪄

Translation for the girlies who just got here: you hand it text in logical order (the order a human types it), and it hands it back in visual order (the order your eyeballs actually read it off the screen). No cap. 🫶

---

🌸 VERSION

version 2.18 💖

---

✨ SYNOPSIS

# display bidi text given in logical order in foo.txt
fribidi.pl foo.txt
# same, but force Right-To-Left paragraph direction
fribidi.pl --rtl foo.txt
# same, but break lines on spaces
fribidi.pl --rtl --break -- foo.txt

okay so the third one is giving main character energy because of that -- — it's telling the program "bestie, everything after this is a file name, not a flag, I promise" 🎀

---

🌈 DESCRIPTION

This script is similar to the fribidi(1) program provided with libfribidi, and it performs a subset of its functions 👯‍♀️ so like, same vibe, fewer tricks.

The main point is to test Text::Bidi and provide a usage example 📝 — it's basically a demo that also happens to work. Lowkey iconic.

---

💜 OPTIONS

• --(no)ltr — force all paragraph directions to be Left-To-Right 🌞 the default is to deduce the paragraph direction via the bidi algorithm (i.e. let the algorithm read the room and decide for itself).
• --(no)rtl — force all paragraph directions to be Right-To-Left 🌙 and again, the default is to deduce the paragraph direction via the bidi algorithm.
• --width=n — set the width of the output lines to n 📏 the default is to use the terminal width, or 80 if that cannot be deduced.
• --break[=s] — break the line at the string s ✂️ if this is given, the width functions as an upper bound for the line length, and the line might be shorter. The default value for s is ' ' — but note that anything following the option will be interpreted as the argument, unless it is of the form "--..." 🙈 (so yeah, watch out, it's a lil greedy).
• --levels — also output the embedding levels of the characters 🔍 mostly for debugging, iykyk.
• --help, -? — give a short usage message and exit with status 1 ⚠️ yes bestie, status 1 even though it's help, that's just how it is, do not come for me.
• --version — print a line with the program name and exit with status 0 👑 clean exit, slay.

---

🎀 ARGUMENTS

Any argument is interpreted as a file name 📂 and the content of all the files, as well as the standard input, are concatenated together 🧵 (yes, all of them, plus stdin, one big soup, in that order).

---

🫶 SEE ALSO

Text::Bidi, Text::Bidi::Paragraph, fribidi(1) 💞

---

💖 AUTHOR

Moshe Kamensky <kamensky@cpan.org> 🌟

---

👑 COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Moshe Kamensky.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself 🐪 fr fr.

---

okay that's the whole page, you ate it, congrats. this was rendered for you by perl v5.42.0 and it's dated 2025-07-25 — shoutout to the version and the date, they never get thanked 🌸 and that's FRIBIDI(1) in the User Contributed Perl Documentation section, periodt 💅✨