Index: ppapi/api/dev/ppb_font_dev.idl |
diff --git a/ppapi/api/dev/ppb_font_dev.idl b/ppapi/api/dev/ppb_font_dev.idl |
index f951d8d4cdc50f5b2b4dbf7571383afd2c50ab20..5d582d12493e27b32b7dd6e10f5390d15b736563 100644 |
--- a/ppapi/api/dev/ppb_font_dev.idl |
+++ b/ppapi/api/dev/ppb_font_dev.idl |
@@ -122,12 +122,28 @@ struct PP_TextRun_Dev { |
/** |
* Set to PP_TRUE if the text is right-to-left. |
+ * |
+ * When <code>override_direction</code> is false, the browser will perform |
+ * the Unicode Bidirectional Algorithm (http://unicode.org/reports/tr9/) on |
+ * the text. The value of the <code>rtl</code> flag specifies the |
+ * direcionality of the surrounding environment. This means that Hebrew |
+ * word will always display right to left, even if <code>rtl</code> is false. |
+ * |
+ * When <code>override_direction</code> is true, no autodetection will be done |
+ * and <code>rtl</code> specifies the direction of the text. |
+ * |
+ * TODO(brettw) note that autodetection with rtl = true is currently |
+ * unimplemented. |
*/ |
PP_Bool rtl; |
/** |
* Set to PP_TRUE to force the directionality of the text regardless of |
- * content |
+ * content. |
+ * |
+ * If this flag is set, the browser will skip autodetection of the content |
+ * and will display all text in the direction speficied by the |
+ * <code>rtl</code> flag. |
*/ |
PP_Bool override_direction; |
}; |