OnWorks favicon

bidiv - Online in the Cloud

Run bidiv in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command bidiv that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



bidiv - bidirectional text filter


bidiv [ -plj ] [ -w width ] [file...]


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 encodings: 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.


-p Paragraph-based direction (default): When formatting a bidirectional output line,
bidiv needs to be aware of that line's base direction. 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

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 character) 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 previous 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

-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.


The following operand is supported:

file A path name of an input file. If no file is specified, the standard input is


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.


COLUMNS see -w option.


The following exit values are returned:

0 All input files were output successfully.

>0 An error occurred.

Use bidiv online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    A fast tunnel proxy that helps you
    bypass firewalls This is an application
    that can also be fetched from
    It ha...
    Download Shadowsocks
  • 2
    GLPI Themes
    GLPI Themes
    Download release at
    Color themes for GLPI 0.84 and 0.85 New
    Modifications for GLPI This is an
    application that c...
    Download GLPI Themes
  • 3
    SMPlayer is a free media player for
    Windows and Linux with built-in codecs
    that can also play YouTube videos. One
    of the most interesting features of
    Download SMPlayer
  • 4
    AAX to MP3
    AAX to MP3
    Usage: - Install the Audible Manager
    and open a file of your account. - Sign
    in into your audible account (in the
    application). Now the program can
    convert you...
    Download AAX to MP3
  • 5
    TestLink is a web based Test Management
    tool. The application provides Test
    specification, Test plans and execution,
    Reporting, Requirements specification
    and ...
    Download TestLink
  • 6
    XDXF - XML Dictionary Exchange Format
    XDXF - XML Dictionary Exchange Format
    XDXF is a project to unite all existing
    open dictionaries and provide both users
    and developers with universal XML-based
    format, convertible from and to other ...
    Download XDXF - XML Dictionary Exchange Format
  • 7
    Transmission Remote GUI
    Transmission Remote GUI
    Transmission Remote GUI is a feature
    rich cross platform front-end to
    remotely control a Transmission
    Bit-Torrent client daemon via its RPC
    protocol. Transmissi...
    Download Transmission Remote GUI
  • More »

Linux commands