diff -ur globus_rsl-7.3.orig/globus_rsl.c globus_rsl-7.3/globus_rsl.c --- globus_rsl-7.3.orig/globus_rsl.c 2010-01-20 19:18:42.000000000 +0100 +++ globus_rsl-7.3/globus_rsl.c 2011-06-04 21:03:49.876935264 +0200 @@ -125,7 +125,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_relation() function tests whether the + * The globus_rsl_is_relation() function tests whether the * the RSL pointed to by the @a ast parameter is a relation. The * RSL syntax supports the following relation operations: * <dl> @@ -161,7 +161,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_relation() function returns GLOBUS_TRUE if + * The globus_rsl_is_relation() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is a relation; otherwise, * it returns GLOBUS_FALSE. */ @@ -181,7 +181,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_boolean() function tests whether the + * The globus_rsl_is_boolean() function tests whether the * the RSL pointed to by the @a ast parameter is a boolean composition * of other RSL parse trees. The syntactically understood boolean * compositions are "&" (conjunction), "|" (disjunction), and "+" @@ -197,7 +197,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_boolean() function returns GLOBUS_TRUE if + * The globus_rsl_is_boolean() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is a boolean composition; * otherwise, it returns GLOBUS_FALSE. */ @@ -217,7 +217,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_relation_eq() function tests whether the + * The globus_rsl_is_relation_eq() function tests whether the * the RSL pointed to by the @a ast parameter is an equality relation. * An example of an equality relation is * @code @@ -228,7 +228,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_relation_eq() function returns GLOBUS_TRUE if + * The globus_rsl_is_relation_eq() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is an equality relation; * otherwise, it returns GLOBUS_FALSE. */ @@ -248,7 +248,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_relation_lessthan() function tests whether the + * The globus_rsl_is_relation_lessthan() function tests whether the * the RSL pointed to by the @a ast parameter is a less-than relation. * An example of a less-than relation is * @code @@ -259,7 +259,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_relation_lessthan() function returns GLOBUS_TRUE if + * The globus_rsl_is_relation_lessthan() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is a less-than relation; * otherwise, it returns GLOBUS_FALSE. */ @@ -279,7 +279,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_relation_attribute_equal() function tests whether + * The globus_rsl_is_relation_attribute_equal() function tests whether * the the RSL pointed to by the @a ast parameter is a relation with * the attribute name which matches the string pointed to by the * @a attribute parameter. This attribute name comparision is @@ -291,7 +291,7 @@ * Name of the attribute to test * * @return - * The @a globus_rsl_is_relation_attribute_equal() function returns + * The globus_rsl_is_relation_attribute_equal() function returns * GLOBUS_TRUE if the RSL parse tree pointed to by @a ast is a relation * and its attribute name matches the @a attribute parameter; * otherwise, it returns GLOBUS_FALSE. @@ -312,7 +312,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_boolean_and() function tests whether the + * The globus_rsl_is_boolean_and() function tests whether the * the RSL pointed to by the @a ast parameter is a boolean "and" * composition of RSL trees. * An example of a boolean and relation is @@ -324,7 +324,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_boolean_and() function returns GLOBUS_TRUE if + * The globus_rsl_is_boolean_and() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is a boolean and of RSL * parse trees; otherwise, it returns GLOBUS_FALSE. */ @@ -344,7 +344,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_boolean_or() function tests whether the + * The globus_rsl_is_boolean_or() function tests whether the * the RSL pointed to by the @a ast parameter is a boolean "or" composition * of RSL trees. * An example of a boolean or relation is @@ -356,7 +356,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_boolean_or() function returns GLOBUS_TRUE if + * The globus_rsl_is_boolean_or() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is a boolean and of RSL * parse trees; otherwise, it returns GLOBUS_FALSE. */ @@ -376,7 +376,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_is_boolean_multi() function tests whether the + * The globus_rsl_is_boolean_multi() function tests whether the * the RSL pointed to by the @a ast parameter is a boolean "multi-request" * composition of RSL trees. * An example of a boolean multie-request relation is @@ -389,7 +389,7 @@ * Pointer to an RSL parse tree structure. * * @return - * The @a globus_rsl_is_boolean_multi() function returns GLOBUS_TRUE if + * The globus_rsl_is_boolean_multi() function returns GLOBUS_TRUE if * the RSL parse tree pointed to by @a ast is a boolean multi-request of * RSL parse trees; otherwise, it returns GLOBUS_FALSE. */ @@ -409,7 +409,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_value_is_literal() function tests whether the + * The globus_rsl_value_is_literal() function tests whether the * the RSL value pointed to by the @a ast parameter is a literal string * value. * An example of a literal string is @@ -421,7 +421,7 @@ * Pointer to an RSL value structure. * * @return - * The @a globus_rsl_value_is_literal() function returns GLOBUS_TRUE if + * The globus_rsl_value_is_literal() function returns GLOBUS_TRUE if * the RSL value pointed to by @a ast is a literal string value; * otherwise, it returns GLOBUS_FALSE. */ @@ -441,7 +441,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_value_is_sequence() function tests whether the + * The globus_rsl_value_is_sequence() function tests whether the * the RSL value pointed to by the @a ast parameter is a sequence of * RSL values. An example of a sequence of values is * @code @@ -452,7 +452,7 @@ * Pointer to an RSL value structure. * * @return - * The @a globus_rsl_value_is_sequence() function returns GLOBUS_TRUE if + * The globus_rsl_value_is_sequence() function returns GLOBUS_TRUE if * the RSL value pointed to by @a ast is a value sequnce; * otherwise, it returns GLOBUS_FALSE. */ @@ -472,7 +472,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_value_is_variable() function tests whether the + * The globus_rsl_value_is_variable() function tests whether the * the RSL value pointed to by the @a ast parameter is a variable reference. * RSL values. An example of a variable reference is * @code @@ -483,7 +483,7 @@ * Pointer to an RSL value structure. * * @return - * The @a globus_rsl_value_is_sequence() function returns GLOBUS_TRUE if + * The globus_rsl_value_is_sequence() function returns GLOBUS_TRUE if * the RSL value pointed to by @a ast is a value sequnce; * otherwise, it returns GLOBUS_FALSE. */ @@ -503,7 +503,7 @@ * @ingroup globus_rsl_predicates * * @details - * The @a globus_rsl_value_is_concatenation() function tests whether the + * The globus_rsl_value_is_concatenation() function tests whether the * the RSL value pointed to by the @a ast parameter is a concatenation of * RSL values. An example of an RSL value concatenation is * @code @@ -514,7 +514,7 @@ * Pointer to an RSL value structure. * * @return - * The @a globus_rsl_value_is_concatenation() function returns GLOBUS_TRUE + * The globus_rsl_value_is_concatenation() function returns GLOBUS_TRUE * if the RSL value pointed to by @a ast is a value concatenation; * otherwise, it returns GLOBUS_FALSE. */ @@ -538,7 +538,7 @@ * @ingroup globus_rsl_constructors * * @details - * The @a globus_rsl_make_boolean() function creates a boolean composition + * The globus_rsl_make_boolean() function creates a boolean composition * of the RSL nodes in the list pointed to by @a children. The new * RSL node which is returned contains a reference to the list, not a copy. * @@ -552,11 +552,11 @@ * operation described by the @a operator parameter. * * @return - * The @a globus_rsl_make_boolean() function returns a new + * The globus_rsl_make_boolean() function returns a new * RSL parse tree node that contains a shallow reference to the * list of values pointed to by the @a children parameter joined by * the operator value in the @a operator parameter. If an error occurs, - * @a globus_rsl_make_boolean() returns NULL. + * globus_rsl_make_boolean() returns NULL. */ globus_rsl_t * globus_rsl_make_boolean (int operator, @@ -580,7 +580,7 @@ * @ingroup globus_rsl_constructors * * @details - * The @a globus_rsl_make_relation() function creates a relation between + * The globus_rsl_make_relation() function creates a relation between * the attribute named by the @a attributename parameter and the values * pointed to by the @a value_sequence list. The new RSL relation * node which is returned contains a reference to the @a attributename @@ -598,11 +598,11 @@ * Pointer to a sequence of RSL values to use in the new RSL relation. * * @return - * The @a globus_rsl_make_relation() function returns a new + * The globus_rsl_make_relation() function returns a new * RSL parse tree node that contains a shallow reference to the * attribute name pointed to by the @a attributename parameter and the * RSL value sequence pointed to by the @a value_sequence parameter. - * If an error occurs, @a globus_rsl_make_relation() returns NULL. + * If an error occurs, globus_rsl_make_relation() returns NULL. */ globus_rsl_t * globus_rsl_make_relation (int operator, @@ -628,7 +628,7 @@ * @ingroup globus_rsl_constructors * * @details - * The @a globus_rsl_value_make_literal() function creates a string literal + * The globus_rsl_value_make_literal() function creates a string literal * RSL value node containing the value pointed to by the @a string * parameter. The new RSL value * node which is returned contains a reference to the @a string @@ -638,10 +638,10 @@ * The literal string to be used in the new value. * * @return - * The @a globus_rsl_value_make_literal() function returns a new + * The globus_rsl_value_make_literal() function returns a new * RSL value node that contains a shallow reference to the * string pointed to by the @a string parameter. - * If an error occurs, @a globus_rsl_value_make_literal() returns NULL. + * If an error occurs, globus_rsl_value_make_literal() returns NULL. */ globus_rsl_value_t * globus_rsl_value_make_literal (char *string) @@ -664,7 +664,7 @@ * @ingroup globus_rsl_constructors * * @details - * The @a globus_rsl_value_make_sequence() function creates a value + * The globus_rsl_value_make_sequence() function creates a value * sequence RSL node referring to the values pointed to by the * @a value_list parameter. The new node returned by this function * contains a reference to the @a value_list parameter, not a copy. @@ -673,10 +673,10 @@ * A pointer to a list of globus_rsl_value_t pointers. * * @return - * The @a globus_rsl_value_make_sequence() function returns a new + * The globus_rsl_value_make_sequence() function returns a new * RSL value node that contains a shallow reference to the * list pointed to by the @a value_list parameter. - * If an error occurs, @a globus_rsl_value_make_sequence() returns NULL. + * If an error occurs, globus_rsl_value_make_sequence() returns NULL. */ globus_rsl_value_t * globus_rsl_value_make_sequence (globus_list_t * value_list) @@ -699,7 +699,7 @@ * @ingroup globus_rsl_constructors * * @details - * The @a globus_rsl_value_make_variable() function creates a variable + * The globus_rsl_value_make_variable() function creates a variable * reference RSL node referring to the variable name contained in the * value pointed to by @a sequence parameter. The new node returned by * this function contains a reference to the @a sequence parameter, not a @@ -709,10 +709,10 @@ * A pointer to a RSL value sequnce. * * @return - * The @a globus_rsl_value_make_variable() function returns a new + * The globus_rsl_value_make_variable() function returns a new * RSL value node that contains a shallow reference to the * value sequence pointed to by the @a sequence parameter. - * If an error occurs, @a globus_rsl_value_make_variable() returns NULL. + * If an error occurs, globus_rsl_value_make_variable() returns NULL. */ globus_rsl_value_t * globus_rsl_value_make_variable (globus_rsl_value_t * sequence) @@ -735,7 +735,7 @@ * @ingroup globus_rsl_constructors * * @details - * The @a globus_rsl_value_make_concatenation() function creates a + * The globus_rsl_value_make_concatenation() function creates a * concatenation of the values pointed to by the @a left_value and * @a right_value parameters. The new node returned by * this function contains a reference to these parameters' values, not a @@ -749,10 +749,10 @@ * This must be a string literal or variable reference. * * @return - * The @a globus_rsl_value_make_concatenation() function returns a new + * The globus_rsl_value_make_concatenation() function returns a new * RSL value node that contains a shallow reference to the * values pointed to by the @a left_value and @a right_value parameters. - * If an error occurs, @a globus_rsl_value_make_concatenation() returns + * If an error occurs, globus_rsl_value_make_concatenation() returns * NULL. */ globus_rsl_value_t * @@ -782,7 +782,7 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_copy_recursive() function performs a deep copy + * The globus_rsl_copy_recursive() function performs a deep copy * of the RSL syntax tree pointed to by the @a ast_node parameter. All * RSL nodes, value nodes, variable names, attributes, and literals * will be copied to the return value. @@ -791,10 +791,10 @@ * An RSL syntax tree to copy. * * @return - * The @a globus_rsl_copy_recursive() function returns a copy of its + * The globus_rsl_copy_recursive() function returns a copy of its * input parameter that that can be used after * the @a ast_node and its values have been freed. - * If an error occurs, @a globus_rsl_copy_recursive() returns + * If an error occurs, globus_rsl_copy_recursive() returns * NULL. */ globus_rsl_t * @@ -883,7 +883,7 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_value_copy_recursive() function performs a deep copy + * The globus_rsl_value_copy_recursive() function performs a deep copy * of the RSL value pointed to by the @a globus_rsl_value_ptr parameter. * All variable names, attributes, literals, and value lists will be copied * to the return value. @@ -892,10 +892,10 @@ * A pointer to an RSL value to copy. * * @return - * The @a globus_rsl_value_copy_recursive() function returns a copy of its + * The globus_rsl_value_copy_recursive() function returns a copy of its * input parameter that that can be used after * the @a globus_rsl_value_ptr and its values have been freed. - * If an error occurs, @a globus_rsl_value_copy_recursive() returns + * If an error occurs, globus_rsl_value_copy_recursive() returns * NULL. */ globus_rsl_value_t * @@ -1000,16 +1000,16 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_boolean_get_operator() function returns + * The globus_rsl_boolean_get_operator() function returns * the operator that is used by the boolean RSL composition. * * @param ast_node * The RSL syntax tree to inspect. * * @return - * Upon success, @a globus_rsl_boolean_get_operator() returns one + * Upon success, globus_rsl_boolean_get_operator() returns one * of GLOBUS_RSL_AND, GLOBUS_RSL_OR, GLOBUS_RSL_MULTIREQ. If an error - * occurs, @a globus_rsl_boolean_get_operator() returns -1. + * occurs, globus_rsl_boolean_get_operator() returns -1. */ int globus_rsl_boolean_get_operator (globus_rsl_t *ast_node) @@ -1025,7 +1025,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_boolean_get_operand_list() function returns + * The globus_rsl_boolean_get_operand_list() function returns * the list of RSL syntax tree nodes that is joined by a boolean * composition. * @@ -1033,10 +1033,10 @@ * The RSL syntax tree to inspect. * * @return - * Upon success, @a globus_rsl_boolean_get_operand_list() returns a + * Upon success, globus_rsl_boolean_get_operand_list() returns a * pointer to a list of RSL syntax tree nodes that are the operand of * a boolean composition operation. If an error - * occurs, @a globus_rsl_boolean_get_operand_list() returns NULL. + * occurs, globus_rsl_boolean_get_operand_list() returns NULL. */ globus_list_t * globus_rsl_boolean_get_operand_list (globus_rsl_t *ast_node) @@ -1052,7 +1052,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_boolean_get_operand_list_ref() function returns + * The globus_rsl_boolean_get_operand_list_ref() function returns * a pointer to the list of RSL syntax tree nodes that is joined by a * boolean composition. If this list is modified, then the value of boolean * syntax tree is modified. @@ -1061,10 +1061,10 @@ * The RSL syntax tree to inspect. * * @return - * Upon success, @a globus_rsl_boolean_get_operand_list_ref() returns a + * Upon success, globus_rsl_boolean_get_operand_list_ref() returns a * pointer to the list pointer in the RSL syntax tree data structure. This * list can be modified to change the oprands of the boolean operation. - * If an error occurs, @a globus_rsl_boolean_get_operand_list_ref() returns + * If an error occurs, globus_rsl_boolean_get_operand_list_ref() returns * NULL. */ globus_list_t ** @@ -1084,7 +1084,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_relation_get_attribute() function returns + * The globus_rsl_relation_get_attribute() function returns * a pointer to the name of the attribute in an RSL relation. This * return value is a shallow reference to the attribute name. * @@ -1092,9 +1092,9 @@ * The RSL relation node to inspect. * * @return - * Upon success, @a globus_rsl_relation_get_attribute() returns a + * Upon success, globus_rsl_relation_get_attribute() returns a * pointer to the name of the attribute of the relation. - * If an error occurs, @a globus_rsl_relation_get_attribute() returns + * If an error occurs, globus_rsl_relation_get_attribute() returns * NULL. */ char * @@ -1111,7 +1111,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_relation_get_operator() function returns + * The globus_rsl_relation_get_operator() function returns * the operation type represented by the RSL relation node pointed to by * the @a ast_node parameter. * @@ -1119,10 +1119,10 @@ * The RSL relation node to inspect. * * @return - * Upon success, @a globus_rsl_relation_get_operator() returns one + * Upon success, globus_rsl_relation_get_operator() returns one * of GLOBUS_RSL_EQ, GLOBUS_RSL_NEQ, GLOBUS_RSL_GT, GLOBUS_RSL_GTEQ, * GLOBUS_RSL_LT, or GLOBUS_RSL_LTEQ. - * If an error occurs, @a globus_rsl_relation_get_operator() returns + * If an error occurs, globus_rsl_relation_get_operator() returns * -1. */ int @@ -1139,7 +1139,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_relation_get_value_sequence() function returns + * The globus_rsl_relation_get_value_sequence() function returns * the value of an RSL relation node pointed to by * the @a ast_node parameter. * @@ -1147,10 +1147,10 @@ * The RSL relation node to inspect. * * @return - * Upon success, @a globus_rsl_relation_get_value_sequence() returns + * Upon success, globus_rsl_relation_get_value_sequence() returns * the value sequence pointer in the RSL relation pointed to by the * @a ast_node parameter. - * If an error occurs, @a globus_rsl_relation_get_value_sequence() returns + * If an error occurs, globus_rsl_relation_get_value_sequence() returns * NULL. */ globus_rsl_value_t * @@ -1168,7 +1168,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_relation_get_single_value() function returns + * The globus_rsl_relation_get_single_value() function returns * the value of an RSL relation node pointed to by * the @a ast_node parameter if the value is a sequence of one value. * @@ -1176,11 +1176,11 @@ * The RSL relation node to inspect. * * @return - * Upon success, @a globus_rsl_relation_get_single_value() returns + * Upon success, globus_rsl_relation_get_single_value() returns * the value pointer at the head of the RSL relation pointed to by the * @a ast_node parameter. If the value sequence has more than one value * or the @a ast_node points to an RSL syntax tree that is not a relation, - * @a globus_rsl_relation_get_value_sequence() returns + * globus_rsl_relation_get_value_sequence() returns * NULL. */ globus_rsl_value_t * @@ -1210,7 +1210,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_literal_get_string() function returns + * The globus_rsl_value_literal_get_string() function returns * the string value of an RSL literal node pointed to by * the @a literal_node parameter. * @@ -1218,10 +1218,10 @@ * The RSL literal node to inspect. * * @return - * Upon success, @a globus_rsl_value_literal_get_string() returns + * Upon success, globus_rsl_value_literal_get_string() returns * a pointer to the string value of the literal pointed to by the * @a literal_node parameter. If the value is not a literal, - * @a globus_rsl_value_literal_get_string() returns + * globus_rsl_value_literal_get_string() returns * NULL. */ char * @@ -1238,7 +1238,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_sequence_get_value_list() function returns + * The globus_rsl_value_sequence_get_value_list() function returns * the list of globus_rsl_value_t pointer values associated with * the RSL value sequence pointed to by the @a sequence_node parameter. * @@ -1246,10 +1246,10 @@ * The RSL sequence node to inspect. * * @return - * Upon success, @a globus_rsl_value_sequence_get_value_list() returns + * Upon success, globus_rsl_value_sequence_get_value_list() returns * a pointer to the list of values pointed to by the * @a sequence_node parameter. If the value is not a sequence, - * @a globus_rsl_value_literal_get_string() returns + * globus_rsl_value_literal_get_string() returns * NULL. */ globus_list_t * @@ -1266,7 +1266,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_variable_get_sequence() function returns + * The globus_rsl_value_variable_get_sequence() function returns * the sequence value associated with the RSL variable reference pointed to * by the @a variable_node parameter. * @@ -1274,10 +1274,10 @@ * The RSL variable node to inspect. * * @return - * Upon success, @a globus_rsl_value_variable_get_sequence() returns + * Upon success, globus_rsl_value_variable_get_sequence() returns * a pointer to the rsl value sequence pointed to by the * @a variable_node parameter. If the value is not a variable reference, - * @a globus_rsl_value_variable_get_sequence() returns + * globus_rsl_value_variable_get_sequence() returns * NULL. */ globus_rsl_value_t * @@ -1294,7 +1294,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_variable_get_name() function returns + * The globus_rsl_value_variable_get_name() function returns * a pointer to the name of the RSL variable name pointed to by the * @a variable_node parameter. * @@ -1302,10 +1302,10 @@ * The RSL variable node to inspect. * * @return - * Upon success, @a globus_rsl_value_variable_get_name() returns + * Upon success, globus_rsl_value_variable_get_name() returns * a pointer to the string containing the name of the variable referenced * by the @a variable_node parameter. If the node is not a variable - * reference, @a globus_rsl_value_variable_get_sequence() returns + * reference, globus_rsl_value_variable_get_sequence() returns * NULL. */ char * @@ -1332,7 +1332,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_variable_get_default() function returns + * The globus_rsl_value_variable_get_default() function returns * a pointer to the default value of the RSL variable pointed to by the * @a variable_node parameter to use if the * variable's name is not bound in the current evaluation context. @@ -1341,11 +1341,11 @@ * The RSL variable node to inspect. * * @return - * Upon success, @a globus_rsl_value_variable_get_default() returns + * Upon success, globus_rsl_value_variable_get_default() returns * a pointer to the string containing the default value of the variable * referenced by the @a variable_node parameter. If the node is not a * variable reference or no default value exists in the RSL node, - * @a globus_rsl_value_variable_get_default() returns + * globus_rsl_value_variable_get_default() returns * NULL. */ char * @@ -1373,7 +1373,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_variable_get_size() function returns + * The globus_rsl_value_variable_get_size() function returns * the number of nodes in the RSL variable reference node pointed to by the * @a variable_node parameter. * @@ -1381,7 +1381,7 @@ * The RSL variable node to inspect. * * @return - * Upon success, @a globus_rsl_value_variable_get_size() returns + * Upon success, globus_rsl_value_variable_get_size() returns * the list of values within a RSL variable reference, or -1 if the * node pointed to by @a variable_node is not a variable reference. If the * return value is 1, then the variable has no default value included @@ -1403,7 +1403,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_concatenation_get_left() function returns + * The globus_rsl_value_concatenation_get_left() function returns * the left side of an RSL value concatenation pointed to by the * @a concatenation_node parameter. * @@ -1411,10 +1411,10 @@ * The RSL concatenation node to inspect. * * @return - * Upon success, @a globus_rsl_value_concatenation_get_left() returns + * Upon success, globus_rsl_value_concatenation_get_left() returns * a pointer to the left value of the concatenation values pointed to by * the @a concatenation_node parameter. If an error occurs, - * @a globus_rsl_value_concatenation_get_left() returns NULL. + * globus_rsl_value_concatenation_get_left() returns NULL. */ globus_rsl_value_t * globus_rsl_value_concatenation_get_left (globus_rsl_value_t *concatenation_node) @@ -1430,7 +1430,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_concatenation_get_right() function returns + * The globus_rsl_value_concatenation_get_right() function returns * the right side of an RSL value concatenation pointed to by the * @a concatenation_node parameter. * @@ -1438,10 +1438,10 @@ * The RSL concatenation node to inspect. * * @return - * Upon success, @a globus_rsl_value_concatenation_get_right() returns + * Upon success, globus_rsl_value_concatenation_get_right() returns * a pointer to the right value of the concatenation values pointed to by * the @a concatenation_node parameter. If an error occurs, - * @a globus_rsl_value_concatenation_get_right() returns NULL. + * globus_rsl_value_concatenation_get_right() returns NULL. */ globus_rsl_value_t * globus_rsl_value_concatenation_get_right (globus_rsl_value_t *concatenation_node) @@ -1457,7 +1457,7 @@ * @ingroup globus_rsl_accessor * * @details - * The @a globus_rsl_value_sequence_get_list_ref() function returns + * The globus_rsl_value_sequence_get_list_ref() function returns * a reference to the list of values in a value sequence. Any changes to * the elements of this list will affect the @a sequence_node * parameter. @@ -1466,10 +1466,10 @@ * The RSL sequence node to inspect. * * @return - * Upon success, @a globus_rsl_value_sequence_get_list_ref() returns + * Upon success, globus_rsl_value_sequence_get_list_ref() returns * a pointer to the list of the globus_rsl_value_t pointer values contained * in the @a sequence_node parameter. If an error occurs, - * @a globus_rsl_value_sequence_get_list_ref() returns NULL. + * globus_rsl_value_sequence_get_list_ref() returns NULL. */ globus_list_t ** globus_rsl_value_sequence_get_list_ref (globus_rsl_value_t *sequence_node) @@ -1486,7 +1486,7 @@ * @ingroup globus_rsl_param * * @details - * The @a globus_rsl_value_concatenation_set_left() sets the left hand side + * The globus_rsl_value_concatenation_set_left() sets the left hand side * of a concatenation pointed to by @a concatenation_node to the value * pointed to by @a new_left_node. If there was any * previous value to the left hand side of the concatenation, it is @@ -1498,11 +1498,11 @@ * A pointer to the new left hand side of the concatenation. * * @return - * Upon success, @a globus_rsl_value_concatenation_set_left() returns + * Upon success, globus_rsl_value_concatenation_set_left() returns * @a GLOBUS_SUCCESS and modifies the value pointed to by the * @a concatenation_node parameter to use the value pointed to by the * @a new_left_node parameter as its left hand side value. If an error - * occurs, @a globus_rsl_value_concatenation_set_left() returns -1. + * occurs, globus_rsl_value_concatenation_set_left() returns -1. */ int globus_rsl_value_concatenation_set_left (globus_rsl_value_t *concatenation_node, @@ -1522,7 +1522,7 @@ * @ingroup globus_rsl_param * * @details - * The @a globus_rsl_value_concatenation_set_right() sets the right-hand + * The globus_rsl_value_concatenation_set_right() sets the right-hand * side of a concatenation pointed to by @a concatenation_node to the value * pointed to by @a new_right_node. If there was any * previous value to the right-hand side of the concatenation, it is @@ -1534,11 +1534,11 @@ * A pointer to the new right hand side of the concatenation. * * @return - * Upon success, @a globus_rsl_value_concatenation_set_right() returns + * Upon success, globus_rsl_value_concatenation_set_right() returns * @a GLOBUS_SUCCESS and modifies the value pointed to by the * @a concatenation_node parameter to use the value pointed to by the * @a new_right_node parameter as its right hand side value. If an error - * occurs, @a globus_rsl_value_concatenation_set_right() returns -1. + * occurs, globus_rsl_value_concatenation_set_right() returns -1. */ int globus_rsl_value_concatenation_set_right (globus_rsl_value_t *concatenation_node, @@ -1562,7 +1562,7 @@ * @ingroup globus_list * * @details - * The @a globus_list_copy_reverse() function creates and returns a copy of + * The globus_list_copy_reverse() function creates and returns a copy of * its input parameter, with the order of the list elements reversed. This * copy is a shallow copy of list nodes, so both the list pointed to by * @a orig and the returned list point to the same list element data. @@ -1571,9 +1571,9 @@ * A pointer to the list to copy. * * @return - * Upon success, @a globus_list_copy_reverse() returns a new list + * Upon success, globus_list_copy_reverse() returns a new list * containing the same elements as the list pointed to by @a orig in - * reverse order. If an error occurs, @a globus_list_copy_reverse() returns + * reverse order. If an error occurs, globus_list_copy_reverse() returns * NULL. */ globus_list_t * @@ -1597,7 +1597,7 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_value_free() function frees the RSL value pointed to + * The globus_rsl_value_free() function frees the RSL value pointed to * by the @a val parameter. This only frees the RSL value node itself, and * not any sequence or string values associated with that node. * @@ -1605,7 +1605,7 @@ * The RSL value node to free. * * @return - * The @a globus_rsl_value_free() function always returns GLOBUS_SUCCESS. + * The globus_rsl_value_free() function always returns GLOBUS_SUCCESS. */ int globus_rsl_value_free (globus_rsl_value_t *val) @@ -1619,7 +1619,7 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_free() function frees the RSL syntax tree node pointed + * The globus_rsl_free() function frees the RSL syntax tree node pointed * to by the @a ast_node parameter. This only frees the RSL syntax tree * node itself, and not any boolean operands, relation names, or values * associated with the node. @@ -1628,7 +1628,7 @@ * The RSL syntax tree node to free. * * @return - * The @a globus_rsl_value_free() function always returns GLOBUS_SUCCESS. + * The globus_rsl_value_free() function always returns GLOBUS_SUCCESS. */ int globus_rsl_free (globus_rsl_t *ast_node) @@ -1642,17 +1642,17 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_free_recursive() function frees the RSL value + * The globus_rsl_free_recursive() function frees the RSL value * node pointed to by the @a globus_rsl_value_ptr, including all * literal strings, variable names, and value sequences. * Any pointers to these are no longer valid after - * @a globus_rsl_value_free_recursive() returns. + * globus_rsl_value_free_recursive() returns. * * @param globus_rsl_value_ptr * An RSL value node to free. * * @return - * The @a globus_rsl_value_free_recursive() function always returns + * The globus_rsl_value_free_recursive() function always returns * GLOBUS_SUCCESS. */ int @@ -1713,17 +1713,17 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_free_recursive() function frees the RSL syntax tree + * The globus_rsl_free_recursive() function frees the RSL syntax tree * pointed to by the @a ast_node parameter, including all * boolean operands, attribute names, and values. * Any pointers to these are no longer valid after - * @a globus_rsl_free_recursive() returns. + * globus_rsl_free_recursive() returns. * * @param ast_node * An RSL parse tree to free. * * @return - * The @a globus_rsl_value_free_recursive() function always returns + * The globus_rsl_value_free_recursive() function always returns * GLOBUS_SUCCESS. */ int @@ -1776,7 +1776,7 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_value_list_literal_replace() function replaces + * The globus_rsl_value_list_literal_replace() function replaces * the first value in the list pointed to by the @a value_list parameter * with a new value node that is a literal string node pointing to the * value of the @a string_value parameter, freeing the old value. @@ -1788,11 +1788,11 @@ * list pointed to by the @a value_list parameter. * * @return - * Upon success, @a globus_rsl_value_list_literal_replace() returns + * Upon success, globus_rsl_value_list_literal_replace() returns * @a GLOBUS_SUCCESS, frees the current first value of @a value_list and * replaces it with a new literal string node pointing to the value of the * @a string_value parameter. If an error occurs, - * @a globus_rsl_value_list_literal_replace() returns 1. + * globus_rsl_value_list_literal_replace() returns 1. */ int globus_rsl_value_list_literal_replace(globus_list_t * value_list, @@ -1815,13 +1815,13 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_value_eval() function modifies the value pointed to + * The globus_rsl_value_eval() function modifies the value pointed to * by its @a ast_node parameter by replacing all RSL substitution * variable reference nodes with the literal values those variables * evaluate to based on the current scope of the symbol table pointed to * by the @a symbol_table parameter. It also combines string * concatenations into literal string values. Any nodes which are replaced - * by this function are freed using @a globus_rsl_value_free_recursive(). + * by this function are freed using globus_rsl_value_free_recursive(). * * @param ast_node * A pointer to the RSL value node to evaluate. @@ -1838,12 +1838,12 @@ * parameter defines RSL substition variables. * * @return - * Upon success, @a globus_rsl_value_eval() returns + * Upon success, globus_rsl_value_eval() returns * @a GLOBUS_SUCCESS, and replaces any RSL substitution values in the * node pointed to by the @a ast_node parameter. If the node evaluates * to a single literal, the @a string_value parameter is modified to * point to the value of that literal. If an error occurs, - * @a globus_rsl_value_eval() returns a non-zero value. + * globus_rsl_value_eval() returns a non-zero value. */ int globus_rsl_value_eval(globus_rsl_value_t * ast_node, @@ -2075,13 +2075,13 @@ * @ingroup globus_rsl_memory * * @details - * The @a globus_rsl_eval() function modifies the RSL parse tree pointed + * The globus_rsl_eval() function modifies the RSL parse tree pointed * to by its @a ast_node parameter by replacing all RSL substitution * variable reference nodes with the literal values those variables * evaluate to based on the current scope of the symbol table pointed to * by the @a symbol_table parameter. It also combines string * concatenations into literal string values. Any nodes which are replaced - * by this function are freed using @a globus_rsl_value_free_recursive(). + * by this function are freed using globus_rsl_value_free_recursive(). * * @param ast_node * A pointer to the RSL syntax tree to evaluate. @@ -2090,11 +2090,11 @@ * which can occur in this evaluation scope. * * @return - * Upon success, @a globus_rsl_eval() returns + * Upon success, globus_rsl_eval() returns * @a GLOBUS_SUCCESS, and replaces all RSL substitution values and * concatenations in @a ast_node or its child nodes with the evaluated * forms described above. If an error occurs, - * @a globus_rsl_eval() returns a non-zero value. + * globus_rsl_eval() returns a non-zero value. */ int globus_rsl_eval (globus_rsl_t *ast_node, @@ -2194,7 +2194,7 @@ * @ingroup globus_rsl_param * * @details - * The @a globus_rsl_value_list_param_get() function copies pointers to + * The globus_rsl_value_list_param_get() function copies pointers to * literal string values or string pairs associated with the list of * globus_rsl_value_t pointers pointed to by the @a ast_node_list parameter * to the output array pointed to by the @a value parameter. It modifies @@ -2217,10 +2217,10 @@ * for each string copied into the @a value array. * * @return - * Upon success, the @a globus_rsl_value_list_param_get() function returns + * Upon success, the globus_rsl_value_list_param_get() function returns * GLOBUS_SUCCESS and modifies the values pointed to by the @a value and * @a value_ctr prameters as described above. If an error occurs, - * @a globus_rsl_value_list_param_get() returns a non-zero value. + * globus_rsl_value_list_param_get() returns a non-zero value. */ int globus_rsl_value_list_param_get(globus_list_t * ast_node_list, @@ -2281,7 +2281,7 @@ * @ingroup globus_rsl_param * * @details - * The @a globus_rsl_param_get_values() function searches the RSL parse + * The globus_rsl_param_get_values() function searches the RSL parse * tree pointed to by the @a ast_node parameter and returns the value list * that is bound to the attribute named by the @a param parameter. * @@ -2294,10 +2294,10 @@ * by the @a ast_node parameter. * * @return - * Upon success, the @a globus_rsl_param_get_values() function returns + * Upon success, the globus_rsl_param_get_values() function returns * a pointer to the list of values associated with the attribute named * by @a param in the RSL parse tree pointed to by @a ast_node. - * If an error occurs, @a globus_rsl_param_get_values() returns NULL. + * If an error occurs, globus_rsl_param_get_values() returns NULL. */ globus_list_t * globus_rsl_param_get_values( @@ -2352,7 +2352,7 @@ * @ingroup globus_rsl_param * * @details - * The @a globus_rsl_param_get() function searches the RSL parse + * The globus_rsl_param_get() function searches the RSL parse * tree pointed to by the @a ast_node parameter and returns an array of * pointers to the strings bound to the attribute named by the @a param * parameter. @@ -2374,9 +2374,9 @@ * responsible for freeing this array, but not the strings in the array. * * @return - * Upon success, the @a globus_rsl_param_get() function returns + * Upon success, the globus_rsl_param_get() function returns * @a GLOBUS_SUCCESS and modifies the @a values parameter as described - * above. If an error occurs, @a globus_rsl_param_get() returns a non-zero + * above. If an error occurs, globus_rsl_param_get() returns a non-zero * value. */ int @@ -2498,7 +2498,7 @@ * @ingroup globus_rsl_print * * @details - * The @a globus_rsl_value_print_recursive() function prints a string + * The globus_rsl_value_print_recursive() function prints a string * representation of the RSL value node pointed to by the * @a globus_rsl_value_ptr parameter to standard output. This function * is not reentrant. @@ -2507,7 +2507,7 @@ * A pointer to the RSL value to display. * * @return - * The @a globus_rsl_value_print_recursive() function always returns + * The globus_rsl_value_print_recursive() function always returns * @a GLOBUS_SUCCESS. */ int @@ -2585,16 +2585,16 @@ * @ingroup globus_rsl_print * * @details - * The @a globus_rsl_get_operator() function returns a pointer to a + * The globus_rsl_get_operator() function returns a pointer to a * static string that represents the RSL operator passed in via the * @a my_op parameter. If the operator is not value, then - * @a globus_rsl_get_operator() returns a pointer to the string "??" + * globus_rsl_get_operator() returns a pointer to the string "??" * * @param my_op * The RSL operator to return. * * @return - * The @a globus_rsl_get_operator() function returns a pointer to the + * The globus_rsl_get_operator() function returns a pointer to the * string representation of the @a my_op parameter, or "??" if that value * is not a value RSL operator. */ @@ -2620,7 +2620,7 @@ * @ingroup globus_rsl_print * * @details - * The @a globus_rsl_print_recursive() function prints a string + * The globus_rsl_print_recursive() function prints a string * representation of the RSL syntax tree pointed to by the * @a ast_node parameter to standard output. This function * is not reentrant. @@ -2629,7 +2629,7 @@ * A pointer to the RSL syntax tree to display. * * @return - * The @a globus_rsl_print_recursive() function always returns + * The globus_rsl_print_recursive() function always returns * @a GLOBUS_SUCCESS. */ int @@ -2676,7 +2676,7 @@ * @ingroup globus_rsl_print * * @details - * The @a globus_rsl_unparse() function returns a new string which + * The globus_rsl_unparse() function returns a new string which * can be parsed into the RSL syntax tree passed as the @a rsl_spec * parameter. The caller is responsible for freeing this string. * @@ -2684,9 +2684,9 @@ * A pointer to the RSL syntax tree to unparse. * * @return - * Upon success, the @a globus_rsl_unparse() function returns a new + * Upon success, the globus_rsl_unparse() function returns a new * string which represents the RSL parse tree passed as the @a rsl_spec - * parameter. If an error occurs, @a globus_rsl_unparse() returns NULL. + * parameter. If an error occurs, globus_rsl_unparse() returns NULL. */ char * globus_rsl_unparse (globus_rsl_t *rsl_spec) @@ -2726,7 +2726,7 @@ * @ingroup globus_rsl_print * * @details - * The @a globus_rsl_value_unparse() function returns a new string which + * The globus_rsl_value_unparse() function returns a new string which * can be parsed into the value of an RSL relation that has the same * syntactic meaning as the @a rsl_value parameter. * The caller is responsible for freeing this string. @@ -2735,9 +2735,9 @@ * A pointer to the RSL value node to unparse. * * @return - * Upon success, the @a globus_rsl_value_unparse() function returns a new + * Upon success, the globus_rsl_value_unparse() function returns a new * string which represents the RSL value ndoe passed as the @a rsl_value - * parameter. If an error occurs, @a globus_rsl_value_unparse() returns + * parameter. If an error occurs, globus_rsl_value_unparse() returns * NULL. */ char * diff -ur globus_rsl-7.3.orig/globus_rsl_parser.c globus_rsl-7.3/globus_rsl_parser.c --- globus_rsl-7.3.orig/globus_rsl_parser.c 2009-11-23 19:48:01.000000000 +0100 +++ globus_rsl-7.3/globus_rsl_parser.c 2011-06-04 21:04:13.221627641 +0200 @@ -1097,18 +1097,18 @@ * @ingroup globus_rsl_parse * * @details - * The @a globus_rsl_parse() function parses the string pointed to by + * The globus_rsl_parse() function parses the string pointed to by * the @a buf parameter into an RSL syntax tree. The caller is responsible - * for freeing that tree by calling @a globus_rsl_free_recursive(). + * for freeing that tree by calling globus_rsl_free_recursive(). * * @param buf * A NULL-terminated string that contains an RSL relation or boolean * composition. * * @return - * Upon success, the @a globus_rsl_parse() function returns the parse + * Upon success, the globus_rsl_parse() function returns the parse * tree generated by processing its input. If an error occurs, - * @a globus_rsl_parse() returns NULL. + * globus_rsl_parse() returns NULL. */ globus_rsl_t *globus_rsl_parse(char *buf) { diff -ur globus_rsl-7.3.orig/globus_rsl_parser.y globus_rsl-7.3/globus_rsl_parser.y --- globus_rsl-7.3.orig/globus_rsl_parser.y 2009-11-23 19:48:01.000000000 +0100 +++ globus_rsl-7.3/globus_rsl_parser.y 2011-06-04 21:04:10.521663221 +0200 @@ -236,18 +236,18 @@ * @ingroup globus_rsl_parse * * @details - * The @a globus_rsl_parse() function parses the string pointed to by + * The globus_rsl_parse() function parses the string pointed to by * the @a buf parameter into an RSL syntax tree. The caller is responsible - * for freeing that tree by calling @a globus_rsl_free_recursive(). + * for freeing that tree by calling globus_rsl_free_recursive(). * * @param buf * A NULL-terminated string that contains an RSL relation or boolean * composition. * * @return - * Upon success, the @a globus_rsl_parse() function returns the parse + * Upon success, the globus_rsl_parse() function returns the parse * tree generated by processing its input. If an error occurs, - * @a globus_rsl_parse() returns NULL. + * globus_rsl_parse() returns NULL. */ globus_rsl_t *globus_rsl_parse(char *buf) {