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

Improve comments

This commit is contained in:
Jonas Fonseca 2005-12-21 13:46:28 +01:00 committed by Jonas Fonseca
parent edee14699e
commit 779a8a4553

View File

@ -35,12 +35,14 @@ struct dom_stack_context_info {
* objects for each state to be assigned to the state's @data member.
* Zero means no state data should be allocated. */
size_t object_size;
/* Callbacks to be called when pushing and popping nodes. */
dom_stack_callback_T push[DOM_NODES];
dom_stack_callback_T pop[DOM_NODES];
};
struct dom_stack_context {
/* Data specific to the parser and renderer. */
/* Data specific to the context. */
void *data;
/* This is one big array of context specific objects. */
@ -72,8 +74,8 @@ struct dom_stack {
struct dom_stack_context *contexts;
size_t contexts_size;
/* The current context. XXX: Only meaningful within
* dom_stack_callback_T functions. */
/* The current context. */
/* XXX: Only meaningful within dom_stack_callback_T functions. */
struct dom_stack_context *current;
};
@ -131,7 +133,9 @@ search_dom_stack(struct dom_stack *stack, enum dom_node_type type,
void init_dom_stack(struct dom_stack *stack, enum dom_stack_flag flags);
void done_dom_stack(struct dom_stack *stack);
/* Add a callback collection to the stack. */
/* Add a context to the stack. This is needed if either you want to have the
* stack allocated objects for created states and/or if you want to install
* callbacks for pushing or popping. . */
void add_dom_stack_context(struct dom_stack *stack, void *data,
struct dom_stack_context_info *context_info);