FRIBIDI(1)

πŸ“¦
version 1.0.16 Β· 4 versions
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing

πŸ’– FRIBIDI πŸ’–

okay so bestie, this is the manual for fribidi β€” the command line interface for the fribidi library. it converts a logical string to visual. that's the whole vibe. πŸ¦‹


✨ NAME ✨

fribidi β€” a command line interface for the fribidi library, converts a logical string to visual


🌸 SYNOPSIS 🌸

fribidi [OPTION]... [FILE]...

πŸ’… DESCRIPTION πŸ’…

okay so it's a command line interface for the fribidi library, and what it does is convert a logical string to visual. that's it, that's the job. let's get into the flags because there are so many and honestly each one is kind of iconic in its own way. πŸŽ€

  • -h, --help β€” shows you this info and then dips. exit stage left. ✨
  • -V, --version β€” spills the version info, then exits. πŸ‘‘
  • -v, --verbose β€” verbose mode, bestie. it's literally the same as running --basedir --ltov --vtol --levels --changes all at once. main character energy, it wants to show you EVERYTHING. πŸ’…
  • -d, --debug β€” outputs debug information. for when you need to see the messy behind-the-scenes. πŸ™ˆ
  • -t, --test β€” tests fribidi. it's the same as --clean --nobreak --showinput --reordernsm stacked together. vibe check mode fr fr. πŸ”₯
  • -c, --charset CS β€” pick your character set. the default is UTF-8. specify it with CS. ✨
  • -C, --charsetdesc CS β€” shows you the descriptions for character set CS, and then exits. it's giving "let me explain myself". πŸŽ€
  • --caprtl β€” old style: sets the character set to CapRTL. retro, nostalgic, we love a throwback. πŸ¦‹
  • --showinput β€” outputs the input string too, so you can see where it came from. πŸ’–
  • --nopad β€” do NOT right justify RTL lines. no padding, no fuss. 🫢
  • --nobreak β€” do not break long lines. let them be long, let them live. 😭
  • -w, --width W β€” screen width for padding. default is 80. BUT. if the environment variable COLUMNS is defined, its value will be used instead. and --width overrides both of them. so the hierarchy is: --width > COLUMNS > 80. periodt. πŸ‘‘
  • -B, --bol BOL β€” outputs the string BOL before the visual string. πŸ“
  • -E, --eol EOL β€” outputs the string EOL after the visual string. πŸ“
  • --rtl β€” force base direction to RTL. πŸ’œ
  • --ltr β€” force base direction to LTR. πŸ’œ
  • --wrtl β€” sets base direction to RTL if no strong character is found. 🧚
  • --wltr β€” sets base direction to LTR if no strong character is found. this one is the default, so it's the lowkey one that's always there for you. 🧚
  • --nomirror β€” turns mirroring off, so you can do it later. it's giving "i'll deal with it eventually". πŸ™ˆ
  • --reordernsm β€” reorders NSM sequences so they follow their base character. ✨
  • --clean β€” removes explicit format codes in the visual string output. heads up: currently it does not affect other outputs. 🌸
  • --basedir β€” outputs Base Direction. 🌈
  • --ltov β€” outputs the Logical to Visual position map. 🌈
  • --vtol β€” outputs the Visual to Logical position map. 🌈
  • --levels β€” outputs Embedding Levels. 🌈
  • --changes β€” outputs information about changes between the logical and visual string (start, length). 🌈
  • --novisual β€” does not output the visual string. this one is meant to be used with --basedir, --ltov, --vtol, --levels, --changes. it's a team player. πŸ’–
also important bestie: all string indexes are zero based. don't forget. i know you won't. πŸ’…

⭐ Output ⭐

for each line of input, the output looks something like this:

[input-str` => '][BOL][[padding space]visual-str][EOL] [\n base-dir][\n ltov-map][\n vtol-map][\n levels][\n changes]

πŸŽ€ Available character sets πŸŽ€

here's the whole roster, no skips:

  • UTF-8 : UTF-8 (Unicode)
  • CapRTL : CapRTL (Test) X
  • ISO8859-6 : ISO 8859-6 (Arabic)
  • ISO8859-8 : ISO 8859-8 (Hebrew)
  • CP1255 : CP1255 (Hebrew/Yiddish)
  • CP1256 : CP1256 (MS-Arabic)
  • ISIRI-3342: ISIRI 3342 (Persian)

and that little X up there? that means the character set has descriptions, so go use --charsetdesc to see them. iykyk. πŸ”₯


😭 REPORTING BUGS 😭

found a bug? report it online at <http://fribidi.sourceforge.net/bugs.php>. do it, bestie, they wanna know. πŸ’–

also for the record: interface version 2, Unicode version 3.2.0.


Copyright Β© 2002 FriBidi Project (http://fribidi.sf.net/).

⚠️ fribidi comes with NO WARRANTY, to the extent permitted by law.

you may redistribute copies of fribidi under the terms of the GNU Lesser General Public License. for more information about these matters, see the files named COPYING. πŸ“œ


okay that's the whole page bestie, you ate that πŸ’…βœ¨ β€” this was fribidi 0.10.5, dated April 2003, signing off like the icon it is. πŸŽ€πŸ¦‹πŸ’–