-// © 2016 and later: Unicode, Inc. and others.
+// Copyright (C) 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
******************************************************************************
*
******************************************************************************
* file name: ubidi.h
-* encoding: UTF-8
+* encoding: US-ASCII
* tab size: 8 (not used)
* indentation:4
*
* A level overrides the directional property of its corresponding
* (same index) character if the level has the
* <code>#UBIDI_LEVEL_OVERRIDE</code> bit set.<br><br>
- * Aside from that bit, it must be
+ * Except for that bit, it must be
* <code>paraLevel<=embeddingLevels[]<=UBIDI_MAX_EXPLICIT_LEVEL</code>,
- * except that level 0 is always allowed.
- * Level 0 for a paragraph separator prevents reordering of paragraphs;
- * this only works reliably if <code>#UBIDI_LEVEL_OVERRIDE</code>
- * is also set for paragraph separators.
- * Level 0 for other characters is treated as a wildcard
- * and is lifted up to the resolved level of the surrounding paragraph.<br><br>
+ * with one exception: a level of zero may be specified for a paragraph
+ * separator even if <code>paraLevel>0</code> when multiple paragraphs
+ * are submitted in the same call to <code>ubidi_setPara()</code>.<br><br>
* <strong>Caution: </strong>A copy of this pointer, not of the levels,
* will be stored in the <code>UBiDi</code> object;
* the <code>embeddingLevels</code> array must not be