diff options
author | Pavel Machek <pavel@ucw.cz> | 2000-06-07 16:16:11 +0200 |
---|---|---|
committer | Pavel Machek <pavel@ucw.cz> | 2000-06-07 16:16:11 +0200 |
commit | 8dcf2544996af34f3c3d71116844352427787324 (patch) | |
tree | 64df00d6894df7218ab148102ae903b38bc5535e /filter/filter.c | |
parent | 7aa99d22bcabb48cfc737055942715d8efd47f6b (diff) | |
download | bird-8dcf2544996af34f3c3d71116844352427787324.tar bird-8dcf2544996af34f3c3d71116844352427787324.zip |
Even better documentation of filters.
Diffstat (limited to 'filter/filter.c')
-rw-r--r-- | filter/filter.c | 21 |
1 files changed, 16 insertions, 5 deletions
diff --git a/filter/filter.c b/filter/filter.c index 540ce13..d580b55 100644 --- a/filter/filter.c +++ b/filter/filter.c @@ -25,7 +25,7 @@ * * Filters use structure &f_val for its variables. Each &f_val * contains type and value. Types are constants prefixed with %T_. Few - * of types are special; %T_RETURN can be or-ed with type to indicate + * of types are special; %T_RETURN can be or--ed with type to indicate * that return from function/from whole filter should be * forced. Important thing about &f_val s is that they may be copied * with simple =. That's fine for all currently defined types: strings @@ -71,8 +71,14 @@ pm_path_compare(struct f_path_mask *m1, struct f_path_mask *m2) } } -/* - * val_compare - compare two values, returns -1, 0, 1 on <, =, > and 999 on error +/** + * val_compare + * @v1: first value + * @v2: second value + * + * Compares two values and returns -1, 0, 1 on <, =, > or 999 on error. + * Tree module relies on this giving consistent results so that it can + * build balanced trees. */ int val_compare(struct f_val v1, struct f_val v2) @@ -140,8 +146,13 @@ val_simple_in_range(struct f_val v1, struct f_val v2) return CMP_ERROR; } -/* - * val_in_range - check if @v1 ~ @v2 +/** + * val_in_range + * @v1: element + * @v2: set + * + * Checks if @v1 is element (|~| operator) of @v2. Sets are internally represented as balanced trees, see + * tree.c module (this is not limited to sets, but for non-set cases, val_simple_in_range() is called early). */ int val_in_range(struct f_val v1, struct f_val v2) |