-/**
- * It creates a new window.
- *
- * XXX If you are inside a "vout display", you must use
- * vout_display_New/DeleteWindow when possible to allow window recycling.
+/**
+ * Creates a new window.
+ *
+ * @param module plugin name (usually "$window")
+ * @note If you are inside a "vout display", you must use
+ / vout_display_NewWindow() and vout_display_DeleteWindow() instead.
+ * This enables recycling windows.