aniani/elinks
1
0
Fork 0
mirror of https://github.com/rkd77/elinks.git synced 2024-12-04 14:46:47 -05:00
Code

config/options: More Doxygen markup

Browse Source 
No changes in program logic or data layout.
(cherry picked from elinks-0.12 commit 972afa1c26)

Conflicts:
	src/config/options.c:
		0.13.GIT has a new function get_option_shadow, now
		doxygenized likewise.
This commit is contained in:
Kalle Olavi Niemitalo 2009-08-16 04:08:59 +03:00 committed by Kalle Olavi Niemitalo
parent 8b00e1ef70
commit 58d2fe8eeb
2 changed files with 199 additions and 78 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

77
src/config/options.c
View File

@ -134,6 +134,7 @@ check_description(unsigned char *desc)
#endif #endif
} }
/*! @relates option */
static void static void
debug_check_option_syntax(struct option *option) debug_check_option_syntax(struct option *option)
{ {
@ -165,7 +166,9 @@ static int no_autocreate = 0;
* work this way because the alias may have the ::OPT_ALIAS_NEGATE flag. * work this way because the alias may have the ::OPT_ALIAS_NEGATE flag.
* Instead, if the caller tries to read or set the value of the alias, * Instead, if the caller tries to read or set the value of the alias,
* the functions associated with ::OPT_ALIAS will forward the operation * the functions associated with ::OPT_ALIAS will forward the operation
* to the underlying option. However, see indirect_option(). */ * to the underlying option. However, see indirect_option().
*
* @relates option */
struct option * struct option *
get_opt_rec(struct option *tree, const unsigned char *name_) get_opt_rec(struct option *tree, const unsigned char *name_)
{ {
@ -235,9 +238,10 @@ get_opt_rec(struct option *tree, const unsigned char *name_)
return NULL; return NULL;
} }
/* Get record of option of given name, or NULL if there's no such option. But /** Get record of option of given name, or NULL if there's no such option. But
* do not create the option if it doesn't exist and there's autocreation * do not create the option if it doesn't exist and there's autocreation
* enabled. */ * enabled.
* @relates option */
struct option * struct option *
get_opt_rec_real(struct option *tree, const unsigned char *name) get_opt_rec_real(struct option *tree, const unsigned char *name)
{ {
@ -254,7 +258,9 @@ get_opt_rec_real(struct option *tree, const unsigned char *name)
* @warning Because the alias may have the ::OPT_ALIAS_NEGATE flag, * @warning Because the alias may have the ::OPT_ALIAS_NEGATE flag,
* the caller must not access the value of the returned option as if * the caller must not access the value of the returned option as if
* it were also the value of the alias. However, it is safe to access * it were also the value of the alias. However, it is safe to access
* flags such as ::OPT_MUST_SAVE and ::OPT_DELETED. */ * flags such as ::OPT_MUST_SAVE and ::OPT_DELETED.
*
* @relates option */
struct option * struct option *
indirect_option(struct option *alias) indirect_option(struct option *alias)
{ {
@ -270,8 +276,9 @@ indirect_option(struct option *alias)
return real; return real;
} }
/* Fetch pointer to value of certain option. It is guaranteed to never return /** Fetch pointer to value of certain option. It is guaranteed to never return
* NULL. Note that you are supposed to use wrapper get_opt(). */ * NULL. Note that you are supposed to use wrapper get_opt().
* @relates option */
union option_value * union option_value *
get_opt_( get_opt_(
#ifdef CONFIG_DEBUG #ifdef CONFIG_DEBUG
@ -346,6 +353,7 @@ get_opt_(
return &opt->value; return &opt->value;
} }
/*! @relates option */
static void static void
add_opt_sort(struct option *tree, struct option *option, int abi) add_opt_sort(struct option *tree, struct option *option, int abi)
{ {
@ -426,7 +434,8 @@ append:
} }
} }
/* Add option to tree. */ /** Add option to tree.
* @relates option */
static void static void
add_opt_rec(struct option *tree, unsigned char *path, struct option *option) add_opt_rec(struct option *tree, unsigned char *path, struct option *option)
{ {
@ -475,6 +484,7 @@ add_opt_rec(struct option *tree, unsigned char *path, struct option *option)
update_hierbox_browser(&option_browser); update_hierbox_browser(&option_browser);
} }
/*! @relates option */
static inline struct listbox_item * static inline struct listbox_item *
init_option_listbox_item(struct option *option) init_option_listbox_item(struct option *option)
{ {
@ -490,6 +500,7 @@ init_option_listbox_item(struct option *option)
return item; return item;
} }
/*! @relates option */
struct option * struct option *
add_opt(struct option *tree, unsigned char *path, unsigned char *capt, add_opt(struct option *tree, unsigned char *path, unsigned char *capt,
unsigned char *name, enum option_flags flags, enum option_type type, unsigned char *name, enum option_flags flags, enum option_type type,
@ -565,6 +576,7 @@ add_opt(struct option *tree, unsigned char *path, unsigned char *capt,
return option; return option;
} }
/*! @relates option */
static void static void
done_option(struct option *option) done_option(struct option *option)
{ {
@ -600,6 +612,7 @@ done_option(struct option *option)
* completely filled (struct option *) have long name and functions which take * completely filled (struct option *) have long name and functions which take
* only option specs have short name. */ * only option specs have short name. */
/*! @relates option */
static void static void
delete_option_do(struct option *option, int recursive) delete_option_do(struct option *option, int recursive)
{ {
@ -630,6 +643,7 @@ delete_option_do(struct option *option, int recursive)
done_option(option); done_option(option);
} }
/*! @relates option */
void void
mark_option_as_deleted(struct option *option) mark_option_as_deleted(struct option *option)
{ {
@ -647,12 +661,14 @@ mark_option_as_deleted(struct option *option)
option->flags |= (OPT_TOUCHED | OPT_DELETED); option->flags |= (OPT_TOUCHED | OPT_DELETED);
} }
/*! @relates option */
void void
delete_option(struct option *option) delete_option(struct option *option)
{ {
delete_option_do(option, 1); delete_option_do(option, 1);
} }
/*! @relates option */
struct option * struct option *
copy_option(struct option *template, int flags) copy_option(struct option *template, int flags)
{ {
@ -687,9 +703,10 @@ copy_option(struct option *template, int flags)
return option; return option;
} }
/* Return the shadow option in @shadow_tree of @option in @tree. If @option /** Return the shadow option in @a shadow_tree of @a option in @a tree.
* isn't yet shadowed in @shadow_tree, shadow it (i.e. create a copy * If @a option isn't yet shadowed in @a shadow_tree, shadow it
* in @shadow_tree) along with any ancestors that aren't shadowed. */ * (i.e. create a copy in @a shadow_tree) along with any ancestors
* that aren't shadowed. */
struct option * struct option *
get_option_shadow(struct option *option, struct option *tree, get_option_shadow(struct option *option, struct option *tree,
struct option *shadow_tree) struct option *shadow_tree)
@ -732,6 +749,7 @@ get_option_shadow(struct option *option, struct option *tree,
} }
/*! @relates option */
LIST_OF(struct option) * LIST_OF(struct option) *
init_options_tree(void) init_options_tree(void)
{ {
@ -741,7 +759,7 @@ init_options_tree(void)
return ptr; return ptr;
} }
/* Some default pre-autocreated options. Doh. */ /** Some default pre-autocreated options. Doh. */
static inline void static inline void
register_autocreated_options(void) register_autocreated_options(void)
{ {
@ -800,6 +818,7 @@ init_options(void)
register_change_hooks(change_hooks); register_change_hooks(change_hooks);
} }
/*! @relates option */
static void static void
free_options_tree(LIST_OF(struct option) *tree, int recursive) free_options_tree(LIST_OF(struct option) *tree, int recursive)
{ {
@ -817,6 +836,7 @@ done_options(void)
free_options_tree(&options_root_tree, 0); free_options_tree(&options_root_tree, 0);
} }
/*! @relates change_hook_info */
void void
register_change_hooks(const struct change_hook_info *change_hooks) register_change_hooks(const struct change_hook_info *change_hooks)
{ {
@ -831,6 +851,13 @@ register_change_hooks(const struct change_hook_info *change_hooks)
} }
} }
/** Set or clear the ::OPT_MUST_SAVE flag in all descendants of @a tree.
*
* @param set_all
* If true, set ::OPT_MUST_SAVE in all options of the tree.
* If false, set it only in touched or deleted options, and clear in others.
*
* @relates option */
void void
prepare_mustsave_flags(LIST_OF(struct option) *tree, int set_all) prepare_mustsave_flags(LIST_OF(struct option) *tree, int set_all)
{ {
@ -851,6 +878,8 @@ prepare_mustsave_flags(LIST_OF(struct option) *tree, int set_all)
} }
} }
/** Clear the ::OPT_TOUCHED flag in all descendants of @a tree.
* @relates option */
void void
untouch_options(LIST_OF(struct option) *tree) untouch_options(LIST_OF(struct option) *tree)
{ {
@ -864,6 +893,7 @@ untouch_options(LIST_OF(struct option) *tree)
} }
} }
/*! @relates option */
static int static int
check_nonempty_tree(LIST_OF(struct option) *options) check_nonempty_tree(LIST_OF(struct option) *options)
{ {
@ -881,6 +911,7 @@ check_nonempty_tree(LIST_OF(struct option) *options)
return 0; return 0;
} }
/*! @relates option */
void void
smart_config_string(struct string *str, int print_comment, int i18n, smart_config_string(struct string *str, int print_comment, int i18n,
LIST_OF(struct option) *options, LIST_OF(struct option) *options,
@ -1021,8 +1052,24 @@ change_hook_ui(struct session *ses, struct option *current, struct option *chang
return 0; return 0;
} }
/* Bit 2 of show means we should always set visibility, otherwise we set it /** Make option templates visible or invisible in the option manager.
* only on templates. */ * This is called once on startup, and then each time the value of the
* "config.show_template" option is changed.
*
* @param tree
* The option tree whose children should be affected.
*
* @param show
* A set of bits:
* - The 0x01 bit means templates should be made visible.
* If the bit is clear, templates become invisible instead.
* - The 0x02 bit means @a tree is itself part of a template,
* and so all of its children should be affected, regardless
* of whether they are templates of their own.
*
* Deleted options are never visible.
*
* @relates option */
static void static void
update_visibility(LIST_OF(struct option) *tree, int show) update_visibility(LIST_OF(struct option) *tree, int show)
{ {
@ -1125,6 +1172,7 @@ option_changed(struct session *ses, struct option *option)
call_change_hooks(ses, option, option); call_change_hooks(ses, option, option);
} }
/*! @relates option_resolver */
int int
commit_option_values(struct option_resolver *resolvers, commit_option_values(struct option_resolver *resolvers,
struct option *root, union option_value *values, int size) struct option *root, union option_value *values, int size)
@ -1163,6 +1211,7 @@ commit_option_values(struct option_resolver *resolvers,
return touched; return touched;
} }
/*! @relates option_resolver */
void void
checkout_option_values(struct option_resolver *resolvers, checkout_option_values(struct option_resolver *resolvers,
struct option *root, struct option *root,
@ -1187,6 +1236,7 @@ checkout_option_values(struct option_resolver *resolvers,
#include "config/options.inc" #include "config/options.inc"
/*! @relates option_info */
void void
register_options(union option_info info[], struct option *tree) register_options(union option_info info[], struct option *tree)
{ {
@ -1273,6 +1323,7 @@ register_options(union option_info info[], struct option *tree)
} }
} }
/*! @relates option_info */
void void
unregister_options(union option_info info[], struct option *tree) unregister_options(union option_info info[], struct option *tree)
{ {

196
src/config/options.h
View File

@ -14,55 +14,69 @@
#define option option_elinks #define option option_elinks
/** Flags used in the option.flags bitmask */
enum option_flags { enum option_flags {
/* bitmask */ /** The option is hidden - it serves for internal purposes, never is
/* The option is hidden - it serves for internal purposes, never is
* read, never is written, never is displayed, never is crawled through * read, never is written, never is displayed, never is crawled through
* etc. */ * etc. */
OPT_HIDDEN = 1, OPT_HIDDEN = 1,
/* For OPT_TREE, automatically create missing hiearchy piece just under
/** For ::OPT_TREE, automatically create missing hiearchy piece just under
* this category when adding an option. The 'template' for the added * this category when adding an option. The 'template' for the added
* hiearchy piece (category) is stored as "_template_" category. */ * hiearchy piece (category) is stored as "_template_" category. */
OPT_AUTOCREATE = 2, OPT_AUTOCREATE = 2,
/* The option has been modified in some way and must be saved
/** The option has been modified in some way and must be saved
* to elinks.conf. ELinks uses this flag only while it is * to elinks.conf. ELinks uses this flag only while it is
* saving the options. When the config.saving_style option * saving the options. When the "config.saving_style" option
* has value 3, saving works like this: * has value 3, saving works like this:
* - First, ELinks sets OPT_MUST_SAVE in the options that have * -# First, ELinks sets ::OPT_MUST_SAVE in the options that have
* OPT_TOUCHED or OPT_DELETED, and clears it in the rest. * ::OPT_TOUCHED or ::OPT_DELETED, and clears it in the rest.
* - ELinks then parses the old configuration file and any * -# ELinks then parses the old configuration file and any
* files named in "include" commands. * files named in "include" commands.
* - If the old configuration file contains a "set" or "unset" * - While parsing the old configuration file itself, ELinks
* command for this option, ELinks rewrites the command and * copies the commands and comments from it to the new
* clears OPT_MUST_SAVE. * configuration file (actually just a string variable
* - If an included file contains a "set" or "unset" command * in this phase). However, if the old configuration file
* for this option, ELinks compares the value of the option * contains a "set" or "unset" command for this option,
* to the value given in the command. ELinks clears * then instead of copying the command as is, ELinks
* OPT_MUST_SAVE if the values match, or sets it if they * rewrites it to match the current value of the option
* differ. * and clears ::OPT_MUST_SAVE.
* - After ELinks has rewritten the configuration file and * - While parsing included files, ELinks does not copy the
* commands anywhere. (It never automatically modifies
* included configuration files.) However, it still looks
* for "set" and "unset" commands for this option. If it
* finds any, it compares the value of the option to the
* value given in the command. ELinks clears ::OPT_MUST_SAVE
* if the values match, or sets it if they differ.
* -# After ELinks has rewritten the configuration file and
* parsed the included files, it appends the options that * parsed the included files, it appends the options that
* still have the OPT_MUST_SAVE flag. * still have the ::OPT_MUST_SAVE flag.
*
* Other saving styles are variants of this: * Other saving styles are variants of this:
* - 0: ELinks does not append any options to the * - 0: ELinks does not append any options to the
* configuration file. So OPT_MUST_SAVE has no effect. * configuration file. So ::OPT_MUST_SAVE has no effect.
* - 1: ELinks initially sets OPT_MUST_SAVE in all options, * - 1: ELinks initially sets ::OPT_MUST_SAVE in all options,
* regardless of OPT_TOUCHED and OPT_DELETED. * regardless of ::OPT_TOUCHED and ::OPT_DELETED.
* - 2: ELinks initially sets OPT_MUST_SAVE in all options, * - 2: ELinks initially sets ::OPT_MUST_SAVE in all options,
* and does not read any configuration files. */ * and does not read any configuration files. */
OPT_MUST_SAVE = 4, OPT_MUST_SAVE = 4,
/* This is used to mark options modified after the last save. That's
/** This is used to mark options modified after the last save. That's
* being useful if you want to save only the options whose value * being useful if you want to save only the options whose value
* changed. */ * changed. */
OPT_TOUCHED = 8, OPT_TOUCHED = 8,
/* If set on the tree argument to add_opt (not necessarily the direct
/** If set on the tree argument to add_opt (not necessarily the direct
* parent) or on the option itself, it will create the listbox (options * parent) or on the option itself, it will create the listbox (options
* manager) item for the option. */ * manager) item for the option. */
OPT_LISTBOX = 16, OPT_LISTBOX = 16,
/* This is used to mark that the option _and_ the option name is
/** This is used to mark that the option @b and the option name is
* allocated and should be freed when the option is released. */ * allocated and should be freed when the option is released. */
OPT_ALLOC = 32, OPT_ALLOC = 32,
/* For OPT_TREE, automatically sort the content of the tree
/** For ::OPT_TREE, automatically sort the content of the tree
* alphabetically (but all subtrees in front of ordinary options) when * alphabetically (but all subtrees in front of ordinary options) when
* adding new options. Note that this applies only to the one level * adding new options. Note that this applies only to the one level
* below - it will not apply to the sub-trees in this tree. Also, this * below - it will not apply to the sub-trees in this tree. Also, this
@ -72,9 +86,11 @@ enum option_flags {
* config_options root tree. Especially NOT RECOMMENDED to be used on * config_options root tree. Especially NOT RECOMMENDED to be used on
* the template trees. */ * the template trees. */
OPT_SORT = 64, OPT_SORT = 64,
/* This is used to mark option as deleted */
/** This is used to mark option as deleted */
OPT_DELETED = 128, OPT_DELETED = 128,
/* Specifies that values of boolean aliases should be inverted. */
/** Specifies that values of boolean aliases should be inverted. */
OPT_ALIAS_NEGATE = 256 OPT_ALIAS_NEGATE = 256
}; };
@ -99,45 +115,71 @@ struct listbox_item; /* bfu/listbox.h */
struct option; /* defined later in this file */ struct option; /* defined later in this file */
struct session; /* session/session.h */ struct session; /* session/session.h */
typedef unsigned char *option_command_fn_T(struct option *, /** Called when an ::OPT_COMMAND option is found in the command line.
unsigned char ***, int *); *
* @param option
* The option that was named in the command line, either directly
* or via an ::OPT_ALIAS. Its option.type is ::OPT_COMMAND,
* and its option_value.command points to this function.
*
* @param[in,out] argv
* The next arguments to be parsed from the command line.
* This function can consume some of those arguments by
* incremenenting *@a argv and decrementing *@a argc.
*
* @param[in,out] argc
* Number of arguments remaining in the command line.
*
* @return NULL if successful, or a localized error string that the
* caller will not free. */
typedef unsigned char *option_command_fn_T(struct option *option,
unsigned char ***argv, int *argc);
union option_value { union option_value {
/* XXX: Keep first to make @options_root initialization possible. */ /** The ::OPT_TREE list_head is allocated.
/* The OPT_TREE list_head is allocated. */ *
* XXX: Keep first to make ::options_root initialization possible. */
LIST_OF(struct option) *tree; LIST_OF(struct option) *tree;
/* Used by OPT_BOOL, OPT_INT, OPT_CODEPAGE and OPT_LANGUAGE */ /** Used by ::OPT_BOOL, ::OPT_INT, ::OPT_CODEPAGE and ::OPT_LANGUAGE */
int number; int number;
/* Used by OPT_LONG */ /** Used by ::OPT_LONG */
long big_number; long big_number;
/* The OPT_COLOR value */ /** The ::OPT_COLOR value */
color_T color; color_T color;
/* The OPT_COMMAND value */ /** The ::OPT_COMMAND value */
option_command_fn_T *command; option_command_fn_T *command;
/* The OPT_STRING string is allocated and has length MAX_STR_LEN. /** The ::OPT_STRING string is allocated and has length ::MAX_STR_LEN.
* The OPT_ALIAS string is NOT allocated, has variable length * The ::OPT_ALIAS string is NOT allocated, has variable length
* (opt->max) and should remain untouched! It contains the full path to * (option.max) and should remain untouched! It contains the full path to
* the "real" / aliased option. */ * the "real" / aliased option. */
unsigned char *string; unsigned char *string;
}; };
/* @session is the session via which the user changed the options, /** To be called when the option (or sub-option if it's a tree) is
* or NULL if not known. Because the options are currently not * changed.
* session-specific, it is best to ignore this parameter. In a future
* version of ELinks, this parameter might mean the session to which
* the changed options apply.
* *
* @current is the option whose change hook is being called. It is * @param session
* never NULL. * is the session via which the user changed the options, or NULL if
* not known. Because the options are currently not session-specific,
* it is best to ignore this parameter. In a future version of
* ELinks, this parameter might mean the session to which the changed
* options apply.
* *
* @changed is the option that was changed, or NULL if multiple * @param current
* descendants of @current may have been changed. */ * is the option whose change hook is being called. It is never NULL.
*
* @param changed
* is the option that was changed, or NULL if multiple descendants of
* @a current may have been changed.
*
* @return If it returns zero, we will continue descending the options
* tree checking for change handlers. */
typedef int (*change_hook_T)(struct session *session, struct option *current, typedef int (*change_hook_T)(struct session *session, struct option *current,
struct option *changed); struct option *changed);
@ -154,7 +196,7 @@ struct option {
struct option *root; struct option *root;
/* To be called when the option (or sub-option if it's a tree) is /** To be called when the option (or sub-option if it's a tree) is
* changed. If it returns zero, we will continue descending the options * changed. If it returns zero, we will continue descending the options
* tree checking for change handlers. */ * tree checking for change handlers. */
change_hook_T change_hook; change_hook_T change_hook;
@ -164,7 +206,8 @@ struct option {
/** An initializer for struct option. This is quite rare: /** An initializer for struct option. This is quite rare:
* most places should instead initialize struct option_init, * most places should instead initialize struct option_init,
* with ::INIT_OPT_INT or a similar macro. */ * with ::INIT_OPT_INT or a similar macro.
* @relates option */
#define INIT_OPTION(name, flags, type, min, max, value, desc, capt) \ #define INIT_OPTION(name, flags, type, min, max, value, desc, capt) \
{ NULL_LIST_HEAD, INIT_OBJECT("option"), name, flags, type, min, max, { (LIST_OF(struct option) *) (value) }, desc, capt } { NULL_LIST_HEAD, INIT_OBJECT("option"), name, flags, type, min, max, { (LIST_OF(struct option) *) (value) }, desc, capt }
@ -209,27 +252,29 @@ struct option *get_option_shadow(struct option *, struct option *,
extern void delete_option(struct option *); extern void delete_option(struct option *);
void mark_option_as_deleted(struct option *); void mark_option_as_deleted(struct option *);
/* Some minimal option cache */ /** Some minimal option cache */
struct option_resolver { struct option_resolver {
int id; int id;
unsigned char *name; unsigned char *name;
}; };
/* Update the visibility of the box item of each option /** Update the visibility of the box item of each option
* in config_options to honour the value of config.show_template. */ * in config_options to honour the value of config.show_template. */
void update_options_visibility(void); void update_options_visibility(void);
/* Toggle the value of the given option numeric, respecting option->min /** Toggle the value of the given option numeric, respecting option->min
* and option->max. */ * and option->max.
* @relates option */
void toggle_option(struct session *ses, struct option *option); void toggle_option(struct session *ses, struct option *option);
/* Call the change-hooks for the given option and recur on its parent. */ /** Call the change-hooks for the given option and recur on its parent.
* @relates option */
void call_change_hooks(struct session *ses, struct option *current, void call_change_hooks(struct session *ses, struct option *current,
struct option *option); struct option *option);
/* Do proper bookkeeping after an option has changed - call this every time /** Do proper bookkeeping after an option has changed - call this every time
* you change an option value. */ * you change an option value.
* @relates option */
void option_changed(struct session *ses, struct option *option); void option_changed(struct session *ses, struct option *option);
extern int commit_option_values(struct option_resolver *resolvers, extern int commit_option_values(struct option_resolver *resolvers,
@ -295,15 +340,19 @@ extern struct option *add_opt(struct option *, unsigned char *, unsigned char *,
#endif #endif
/*! @relates option */
#define add_opt_bool_tree(tree, path, capt, name, flags, def, desc) \ #define add_opt_bool_tree(tree, path, capt, name, flags, def, desc) \
add_opt(tree, path, capt, name, flags, OPT_BOOL, 0, 1, (longptr_T) def, DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_BOOL, 0, 1, (longptr_T) def, DESC(desc))
/*! @relates option */
#define add_opt_int_tree(tree, path, capt, name, flags, min, max, def, desc) \ #define add_opt_int_tree(tree, path, capt, name, flags, min, max, def, desc) \
add_opt(tree, path, capt, name, flags, OPT_INT, min, max, (longptr_T) def, DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_INT, min, max, (longptr_T) def, DESC(desc))
/*! @relates option */
#define add_opt_long_tree(tree, path, capt, name, flags, min, max, def, desc) \ #define add_opt_long_tree(tree, path, capt, name, flags, min, max, def, desc) \
add_opt(tree, path, capt, name, flags, OPT_LONG, min, max, (longptr_T) def, DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_LONG, min, max, (longptr_T) def, DESC(desc))
/*! @relates option */
#define add_opt_str_tree(tree, path, capt, name, flags, def, desc) \ #define add_opt_str_tree(tree, path, capt, name, flags, def, desc) \
do { \ do { \
unsigned char *ptr = mem_alloc(MAX_STR_LEN); \ unsigned char *ptr = mem_alloc(MAX_STR_LEN); \
@ -311,21 +360,27 @@ do { \
add_opt(tree, path, capt, name, flags, OPT_STRING, 0, MAX_STR_LEN, (longptr_T) ptr, DESC(desc)); \ add_opt(tree, path, capt, name, flags, OPT_STRING, 0, MAX_STR_LEN, (longptr_T) ptr, DESC(desc)); \
} while (0) } while (0)
/*! @relates option */
#define add_opt_codepage_tree(tree, path, capt, name, flags, def, desc) \ #define add_opt_codepage_tree(tree, path, capt, name, flags, def, desc) \
add_opt(tree, path, capt, name, flags, OPT_CODEPAGE, 0, 0, (longptr_T) get_cp_index(def), DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_CODEPAGE, 0, 0, (longptr_T) get_cp_index(def), DESC(desc))
/*! @relates option */
#define add_opt_lang_tree(tree, path, capt, name, flags, desc) \ #define add_opt_lang_tree(tree, path, capt, name, flags, desc) \
add_opt(tree, path, capt, name, flags, OPT_LANGUAGE, 0, 0, (longptr_T) 0, DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_LANGUAGE, 0, 0, (longptr_T) 0, DESC(desc))
/*! @relates option */
#define add_opt_color_tree(tree, path, capt, name, flags, def, desc) \ #define add_opt_color_tree(tree, path, capt, name, flags, def, desc) \
add_opt(tree, path, capt, name, flags, OPT_COLOR, 0, 0, (longptr_T) def, DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_COLOR, 0, 0, (longptr_T) def, DESC(desc))
/*! @relates option */
#define add_opt_command_tree(tree, path, capt, name, flags, cmd, desc) \ #define add_opt_command_tree(tree, path, capt, name, flags, cmd, desc) \
add_opt(tree, path, capt, name, flags, OPT_COMMAND, 0, 0, (longptr_T) cmd, DESC(desc)); add_opt(tree, path, capt, name, flags, OPT_COMMAND, 0, 0, (longptr_T) cmd, DESC(desc));
/*! @relates option */
#define add_opt_alias_tree(tree, path, capt, name, flags, def, desc) \ #define add_opt_alias_tree(tree, path, capt, name, flags, def, desc) \
add_opt(tree, path, capt, name, flags, OPT_ALIAS, 0, strlen(def), (longptr_T) def, DESC(desc)) add_opt(tree, path, capt, name, flags, OPT_ALIAS, 0, strlen(def), (longptr_T) def, DESC(desc))
/*! @relates option */
#define add_opt_tree_tree(tree, path, capt, name, flags, desc) \ #define add_opt_tree_tree(tree, path, capt, name, flags, desc) \
add_opt(tree, path, capt, name, flags, OPT_TREE, 0, 0, (longptr_T) init_options_tree(), DESC(desc)); add_opt(tree, path, capt, name, flags, OPT_TREE, 0, 0, (longptr_T) init_options_tree(), DESC(desc));
@ -359,12 +414,15 @@ struct option_init {
/** Type of the option. This goes to option.type. */ /** Type of the option. This goes to option.type. */
enum option_type type; enum option_type type;
/** Minimum and maximum value of the option. These go to /** Minimum value of the option. This goes to option.min. */
* option.min and option.max. For some option types, @c max long min;
* is the maximum length or fixed length instead. */
long min, max;
/** @name Default value of the option /** Maximum value of the option. This goes to option.max.
* For some option types, @c max is the maximum length or
* fixed length instead. */
long max;
/*! @name Default value of the option
* The value of an option can be an integer, a data pointer, * The value of an option can be an integer, a data pointer,
* or a function pointer. This structure has a separate * or a function pointer. This structure has a separate
* member for each of those types, to avoid compile-time casts * member for each of those types, to avoid compile-time casts
@ -409,50 +467,62 @@ union option_info {
extern void register_options(union option_info info[], struct option *tree); extern void register_options(union option_info info[], struct option *tree);
extern void unregister_options(union option_info info[], struct option *tree); extern void unregister_options(union option_info info[], struct option *tree);
/*! @relates option_info */
#define NULL_OPTION_INFO \ #define NULL_OPTION_INFO \
{{ NULL, NULL, NULL, NULL, 0, \ {{ NULL, NULL, NULL, NULL, 0, \
0, 0, 0, 0, NULL, NULL }} 0, 0, 0, 0, NULL, NULL }}
/*! @relates option_info */
#define INIT_OPT_BOOL(path, capt, name, flags, def, desc) \ #define INIT_OPT_BOOL(path, capt, name, flags, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_BOOL, 0, 1, def, NULL, NULL }} OPT_BOOL, 0, 1, def, NULL, NULL }}
/*! @relates option_info */
#define INIT_OPT_INT(path, capt, name, flags, min, max, def, desc) \ #define INIT_OPT_INT(path, capt, name, flags, min, max, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_INT, min, max, def, NULL, NULL }} OPT_INT, min, max, def, NULL, NULL }}
/*! @relates option_info */
#define INIT_OPT_LONG(path, capt, name, flags, min, max, def, desc) \ #define INIT_OPT_LONG(path, capt, name, flags, min, max, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_LONG, min, max, def, NULL, NULL }} OPT_LONG, min, max, def, NULL, NULL }}
/*! @relates option_info */
#define INIT_OPT_STRING(path, capt, name, flags, def, desc) \ #define INIT_OPT_STRING(path, capt, name, flags, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_STRING, 0, MAX_STR_LEN, 0, def, NULL }} OPT_STRING, 0, MAX_STR_LEN, 0, def, NULL }}
/*! @relates option_info */
#define INIT_OPT_CODEPAGE(path, capt, name, flags, def, desc) \ #define INIT_OPT_CODEPAGE(path, capt, name, flags, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_CODEPAGE, 0, 0, 0, def, NULL }} OPT_CODEPAGE, 0, 0, 0, def, NULL }}
/*! @relates option_info */
#define INIT_OPT_COLOR(path, capt, name, flags, def, desc) \ #define INIT_OPT_COLOR(path, capt, name, flags, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_COLOR, 0, 0, 0, def, NULL }} OPT_COLOR, 0, 0, 0, def, NULL }}
/*! @relates option_info */
#define INIT_OPT_LANGUAGE(path, capt, name, flags, desc) \ #define INIT_OPT_LANGUAGE(path, capt, name, flags, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_LANGUAGE, 0, 0, 0, NULL, NULL }} OPT_LANGUAGE, 0, 0, 0, NULL, NULL }}
/*! @relates option_info */
#define INIT_OPT_COMMAND(path, capt, name, flags, cmd, desc) \ #define INIT_OPT_COMMAND(path, capt, name, flags, cmd, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_COMMAND, 0, 0, 0, NULL, cmd }} OPT_COMMAND, 0, 0, 0, NULL, cmd }}
/*! @relates option_info */
#define INIT_OPT_CMDALIAS(path, capt, name, flags, def, desc) \ #define INIT_OPT_CMDALIAS(path, capt, name, flags, def, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_ALIAS, 0, sizeof(def) - 1, 0, def, NULL }} OPT_ALIAS, 0, sizeof(def) - 1, 0, def, NULL }}
/*! @relates option_info */
#define INIT_OPT_ALIAS(path, name, flags, def) \ #define INIT_OPT_ALIAS(path, name, flags, def) \
{{ path, name, NULL, NULL, flags, \ {{ path, name, NULL, NULL, flags, \
OPT_ALIAS, 0, sizeof(def) - 1, 0, def, NULL }} OPT_ALIAS, 0, sizeof(def) - 1, 0, def, NULL }}
/*! @relates option_info */
#define INIT_OPT_TREE(path, capt, name, flags, desc) \ #define INIT_OPT_TREE(path, capt, name, flags, desc) \
{{ path, name, capt, DESC(desc), flags, \ {{ path, name, capt, DESC(desc), flags, \
OPT_TREE, 0, 0, 0, NULL, NULL }} OPT_TREE, 0, 0, 0, NULL, NULL }}