1
0
mirror of https://github.com/rkd77/elinks.git synced 2024-09-19 01:36:33 -04:00

Document the charset of form_state.value for FC_TEXTAREA.

This commit is contained in:
Kalle Olavi Niemitalo 2007-04-29 21:21:25 +03:00 committed by Witold Filipczyk
parent d66dc7341c
commit 53cd0dcc95

View File

@ -37,18 +37,19 @@ struct form_state {
int position; int position;
enum form_type type; enum form_type type;
/* For FC_TEXT, FC_PASSWORD, and FC_FILE, @value is the text /* For FC_TEXT, FC_PASSWORD, FC_FILE, and FC_TEXTAREA, @value
* string that the user can edit. The string is null-terminated; * is the text string that the user can edit. The string is
* its length is not stored separately. The size of the buffer * null-terminated; its length is not stored separately. The
* is not stored anywhere; extending the string always requires * size of the buffer is not stored anywhere; extending the
* calling realloc(). The string is not normally allowed to grow * string always requires calling realloc(). The string is
* past @form_control.maxlength bytes (not counting the null), * not normally allowed to grow past @form_control.maxlength
* but there may be ways to get longer strings. If CONFIG_UTF8 * bytes (not counting the null), but there may be ways to get
* is defined and UTF-8 I/O is enabled for the terminal, then * longer strings. If CONFIG_UTF8 is defined and UTF-8 I/O is
* @value is in UTF-8; otherwise, @value is in the charset of the * enabled for the terminal, then @value is in UTF-8;
* terminal, and the charset is assumed to be unibyte. (Thus, if * otherwise, @value is in the charset of the terminal, and
* you choose UTF-8 as the charset but disable UTF-8 I/O, you * the charset is assumed to be unibyte. (Thus, if you choose
* lose.) The charset of the document has no effect here. */ * 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; unsigned char *value;
/* For FC_TEXT, FC_PASSWORD, and FC_FILE, @state is the byte /* For FC_TEXT, FC_PASSWORD, and FC_FILE, @state is the byte
* position of the insertion point in @value. * position of the insertion point in @value.