fribidi(1) [linux man page]
FRIBIDI(1) User Commands FRIBIDI(1) NAME
fribidi - a command line interface for the fribidi library, converts a logical string to visual SYNOPSIS
fribidi [OPTION]... [FILE]... DESCRIPTION
A command line interface for the fribidi library, Converts a logical string to visual. -h, --help Display this information and exit -V, --version Display version information and exit -v, --verbose Verbose mode, same as --basedir --ltov --vtol --levels --changes -d, --debug Output debug information -t, --test Test fribidi, same as --clean --nobreak --showinput --reordernsm -c, --charset CS Specify character set, default is UTF-8 -C, --charsetdesc CS Show descriptions for character set CS and exit --caprtl Old style: set character set to CapRTL --showinput Output the input string too --nopad Do not right justify RTL lines --nobreak Do not break long lines -w, --width W Screen width for padding, default is 80, but if environment variable COLUMNS is defined, its value will be used, --width over- rides both of them. -B, --bol BOL Output string BOL before the visual string -E, --eol EOL Output string EOL after the visual string --rtl Force base direction to RTL --ltr Force base direction to LTR --wrtl Set base direction to RTL if no strong character found --wltr Set base direction to LTR if no strong character found (default) --nomirror Turn mirroring off, to do it later --reordernsm Reorder NSM sequences to follow their base character --clean Remove explicit format codes in visual string output, currently does not affect other outputs --basedir Output Base Direction --ltov Output Logical to Visual position map --vtol Output Visual to Logical position map --levels Output Embedding Levels --changes Output information about changes between logical and visual string (start, length) --novisual Do not output the visual string, to be used with --basedir, --ltov, --vtol, --levels, --changes All string indexes are zero based Output: For each line of input, output something like this: [input-str` => '][BOL][[padding space]visual-str][EOL] [ base-dir][ ltov-map][ vtol-map][ levels][ changes] Available character sets: * 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) X: Character set has descriptions, use --charsetdesc to see REPORTING BUGS
Report bugs online at <http://fribidi.sourceforge.net/bugs.php>. interface version 2 Unicode version 3.2.0 COPYRIGHT
Copyright (C) 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. fribidi 0.10.5 April 2003 FRIBIDI(1)
Check Out this Related Man Page
bidiv(1) Ivrix bidiv(1) NAME
bidiv - bidirectional text filter SYNOPSIS
bidiv [ -plj ] [ -w width ] [file...] DESCRIPTION
bidiv is a filter, or viewer, for birectional text stored in logical-order. It converts such text into visual-order text which can be viewed on terminals that do not handle bidirectionality. The output visual-order text is formatted assuming a fixed number of characters per line (automatically determined or given with the -w parameter). bidiv is oriented towards Hebrew, and assumes the input to be a Hebrew and ASCII text encoded in one of the two common logical-order encod- ings: ISO-8859-8-i or UTF-8. Actually, bidiv guesses the encoding of its input at a character by character basis, so the input might be a mix of ISO-8859-8-i and Hebrew UTF-8. bidiv's output is visual-order text, in either the ISO-8859-8 or UTF-8 encoding, depending on your locale setting. bidiv reads each file in sequence, converts it into visual order and writes it on the standard output. Thus: $ bidiv file prints file on your terminal (assuming it has the appropriate fonts, but no bidirectionality support), and: $ bidiv file1 file2 | less concatenates file1 and file2, and shows the results using the pager less. If no input file is given, bidiv reads from the standard input file. For more ideas on how to use bidiv, see the EXAMPLES section below. OPTIONS
-p Paragraph-based direction (default): When formatting a bidirectional output line, bidiv needs to be aware of that line's base direc- tion. A line whose base direction is RTL (right to left) gets right-justified and its first element appears on the right. Otherwise, the line is left-justified and its first element appears on the left. The -p option tells bidiv to choose a base direction per paragraph, where a paragraph is delimited by an empty line. This is bidiv's default behavior, and usually gives the expected results on most texts and emails. The direction of the entire paragraph is chosen according to the first strongly-directioned character (i.e., an alphabetic charac- ter) appearing in the paragraph. Currently, if the first output line of a paragraph has no directional characters (e.g., a line of minus signs before an email signature, or a line containing only numbers) that line is output with the same direction of the previ- ous paragraph, but it does not determine the direction of the rest of the paragraph. If the first line of the first paragraph does not have a direction, the RTL direction is arbitrarily chosen. -l Line-based direction: This option choose an alternative method of choosing each output line's base direction. When this option is enabled, the base direction of each output line is determined on its own (again, according to the first character on the line with a strong direction). This method may give wrong results in the case where a line starts with a word of the opposite direction. This case is rare, but does happen under random line-splitting circumstances, or when the text is defining words of a foreign language. -j Do not justify: By default, RTL lines are right-justified, i.e., they are padded with spaces on the left when shorter than the required line width (see the -w option). The -j option tells bidiv not to preform this justifications, and leave short lines unpadded. -w width bidiv formats its output for lines of the given width. Lines are split when longer than this width, and RTL lines are right-justfied to fill that width unless the -j option is given. When the -w option is not given, bidiv uses the value of the COLUMNS variable, which is usually automatically defined by the user's shell. When that both the -w option and the COLUMNS variable are missing, the default of 80 columns is used. OPERANDS
The following operand is supported: file A path name of an input file. If no file is specified, the standard input is used. EXAMPLES
1. bidiv README | less 2. man something | bidiv | less (or groff -man -Tlatin1 something.1 |sed 's/.^H(.)/1/g' |../bidiv -w 65) 3. set "bidiv" as a filter for your mail program (mutt, pine, etc.) for viewing mail with the ISO 8859-8-i character set, and Hebrew UTF-8 mail. ENVIRONMENT
COLUMNS see -w option. EXIT STATUS
The following exit values are returned: 0 All input files were output successfully. >0 An error occurred. AUTHOR
Written by Nadav Har'El, http://nadav.harel.org.il. Please send bug reports and comments to nyh@math.technion.ac.il. The latest version of this software can be found in ftp://ftp.ivrix.org.il/pub/ivrix/src/cmdline SEE ALSO
cat(1), fribidi(3) Bidiv 7 Jan 2006 bidiv(1)