mirror of
https://github.com/rkd77/elinks.git
synced 2024-11-04 08:17:17 -05:00
Document the charset of form_state.value for FC_TEXTAREA.
This commit is contained in:
parent
d66dc7341c
commit
53cd0dcc95
@ -37,18 +37,19 @@ struct form_state {
|
||||
int position;
|
||||
enum form_type type;
|
||||
|
||||
/* For FC_TEXT, FC_PASSWORD, and FC_FILE, @value is the text
|
||||
* string that the user can edit. The string is null-terminated;
|
||||
* its length is not stored separately. The size of the buffer
|
||||
* is not stored anywhere; extending the string always requires
|
||||
* calling realloc(). The string is not normally allowed to grow
|
||||
* past @form_control.maxlength bytes (not counting the null),
|
||||
* but there may be ways to get longer strings. If CONFIG_UTF8
|
||||
* is defined and UTF-8 I/O is enabled for the terminal, then
|
||||
* @value is in UTF-8; otherwise, @value is in the charset of the
|
||||
* terminal, and the charset is assumed to be unibyte. (Thus, if
|
||||
* you choose UTF-8 as the charset but disable UTF-8 I/O, you
|
||||
* lose.) The charset of the document has no effect here. */
|
||||
/* For FC_TEXT, FC_PASSWORD, FC_FILE, and FC_TEXTAREA, @value
|
||||
* is the text string that the user can edit. The string is
|
||||
* null-terminated; its length is not stored separately. The
|
||||
* size of the buffer is not stored anywhere; extending the
|
||||
* string always requires calling realloc(). The string is
|
||||
* not normally allowed to grow past @form_control.maxlength
|
||||
* bytes (not counting the null), but there may be ways to get
|
||||
* longer strings. If CONFIG_UTF8 is defined and UTF-8 I/O is
|
||||
* enabled for the terminal, then @value is in UTF-8;
|
||||
* otherwise, @value is in the charset of the terminal, and
|
||||
* the charset is assumed to be unibyte. (Thus, if you choose
|
||||
* UTF-8 as the charset but disable UTF-8 I/O, you lose.)
|
||||
* The charset of the document has no effect here. */
|
||||
unsigned char *value;
|
||||
/* For FC_TEXT, FC_PASSWORD, and FC_FILE, @state is the byte
|
||||
* position of the insertion point in @value.
|
||||
|
Loading…
Reference in New Issue
Block a user