-This function finds the bidi embedding levels of a single paragraph,
-as defined by the Unicode Bidirectional Algorithm available at
-http://www.unicode.org/reports/tr9/. This function implements rules P2 to
-I1 inclusive, and parts 1 to 3 of L1, except for rule X9 which is
-implemented in fribidi_remove_bidi_marks(). Part 4 of L1 is implemented
-in fribidi_reorder_line().
-
-There are a few macros defined in fribidi-bidi-types.h to work with this
-embedding levels.
-.SH "RETURNS"
-Maximum level found plus one, or zero if any error occured
-(memory allocation failure most probably).