Commit cbf19350 authored by Pekka Pessi's avatar Pekka Pessi

msg/test_protos.h.in: fixed whitespace

darcs-hash:20081127232502-db55f-af9025c4e254305f41d6b5a4ae8f32e78eba221a.gz
parent 93058096
/**-*- c -*-
/**-*- c -*-
* @ingroup msg
* @internal @file test_protos.h.in
*
......@@ -31,15 +31,15 @@
#ifndef TEST_PROTOS_H
/** Defined when <test_protos.h> has been included. */
#define TEST_PROTOS_H
#define TEST_PROTOS_H
/**@ingroup test_msg
* @file test_protos.h
*
* Prototypes and macros for dummy testing protocol headers.
*
*
* #AUTO#
*
*
* @author Pekka Pessi <Pekka.Pessi@nokia.com>
*/
......@@ -85,8 +85,8 @@ extern tag_class_t tstmsgtag_class[1];
/**Tag list item for header string.
*
* The TSTTAG_HEADER_STR() macro is used to include a tag item containing a
* header string in the tag list, e.g.,
* @code
* header string in the tag list, e.g.,
* @code
* TSTTAG_HEADER_STR("Priority: urgent").
* @endcode
*
......@@ -134,7 +134,7 @@ extern tag_typedef_t tsttag_header_str_ref;
#if HAVE_INLINE
su_inline
tag_value_t tsttag_tst_v(msg_test_t const *v) { return (tag_value_t)v; }
su_inline
su_inline
tag_value_t tsttag_tst_vr(msg_test_t const **vp) { return (tag_value_t)vp; }
#else
#define tsttag_tst_v(v) (tag_value_t)(v)
......@@ -153,8 +153,8 @@ msg_print_f msg_#xxxxxx#_e;
/**Header class for #xxxxxxx_xxxxxxx#.
*
* The header class msg_#xxxxxx#_class defines how a
*
* The header class msg_#xxxxxx#_class defines how a
* #xxxxxxx_xxxxxxx# is parsed and printed. It also
* contains methods used by message parser and other functions
* to manipulate the msg_#xxxxxx#_t header structure.
......@@ -162,28 +162,28 @@ msg_print_f msg_#xxxxxx#_e;
extern msg_hclass_t msg_#xxxxxx#_class[];
/**Initializer for structure msg_#xxxxxx#_t.
*
*
* A static msg_#xxxxxx#_t structure must be initialized
* with the MSG_#XXXXXX#_INIT() macro. For instance,
* @code
*
* @code
*
* msg_#xxxxxx#_t msg_#xxxxxx# = MSG_#XXXXXX#_INIT;
*
*
* @endcode
* @HI
*/
#define MSG_#XXXXXX#_INIT() MSG_HDR_INIT(#xxxxxx#)
/**Initialize a structure msg_#xxxxxx#_t.
*
*
* An msg_#xxxxxx#_t structure can be initialized with the
* msg_#xxxxxx#_init() function/macro. For instance,
* @code
*
*
* msg_#xxxxxx#_t msg_#xxxxxx#;
*
*
* msg_#xxxxxx#_init(&msg_#xxxxxx#);
*
*
* @endcode
* @HI
*/
......@@ -198,13 +198,13 @@ su_inline msg_#xxxxxx#_t *msg_#xxxxxx#_init(msg_#xxxxxx#_t x[1])
#endif
/**Test if header object is instance of msg_#xxxxxx#_t.
*
*
* The function msg_is_#xxxxxx#() returns true (nonzero) if
* the header class is an instance of #xxxxxxx_xxxxxxx#
* object and false (zero) otherwise.
*
*
* @param header pointer to the header structure to be tested
*
*
* @return
* The function msg_is_x#xxxxxx#() returns true (nonzero) if
* the header object is an instance of header #xxxxxx# and
......@@ -222,27 +222,27 @@ int msg_is_#xxxxxx#(msg_header_t const *header);
#define msg_#xxxxxx#_p(h) msg_is_#xxxxxx#((h))
/**Duplicate (deep copy) @c msg_#xxxxxx#_t.
*
*
* The function msg_#xxxxxx#_dup() duplicates a header
* structure @a hdr. If the header structure @a hdr
* contains a reference (@c hdr->x_next) to a list of
* headers, all the headers in the list are duplicated, too.
*
*
* @param home memory home used to allocate new structure
* @param hdr header structure to be duplicated
*
*
* When duplicating, all parameter lists and non-constant
* strings attached to the header are copied, too. The
* function uses given memory @a home to allocate all the
* memory areas used to copy the header.
*
*
* @par Example
* @code
*
*
* #xxxxxx# = msg_#xxxxxx#_dup(home, tst->msg_#xxxxxx#);
*
*
* @endcode
*
*
* @return
* The function msg_#xxxxxx#_dup() returns a pointer to the
* newly duplicated msg_#xxxxxx#_t header structure, or NULL
......@@ -251,49 +251,49 @@ int msg_is_#xxxxxx#(msg_header_t const *header);
msg_#xxxxxx#_t *msg_#xxxxxx#_dup(su_home_t *home, msg_#xxxxxx#_t const *hdr);
/**Copy a msg_#xxxxxx#_t header structure.
*
*
* The function msg_#xxxxxx#_copy() copies a header structure @a
* hdr. If the header structure @a hdr contains a reference (@c
* hdr->h_next) to a list of headers, all the headers in that
* list are copied, too. The function uses given memory @a home
* to allocate all the memory areas used to copy the header
* structure @a hdr.
*
*
* @param home memory home used to allocate new structure
* @param hdr pointer to the header structure to be duplicated
*
*
* When copying, only the header structure and parameter lists
* attached to it are duplicated. The new header structure
* retains all the references to the strings within the old @a
* header, including the encoding of the old header, if present.
*
*
* @par Example
* @code
*
*
* #xxxxxx# = msg_#xxxxxx#_copy(home, tst->msg_#xxxxxx#);
*
*
* @endcode
*
*
* @return
* The function msg_#xxxxxx#_copy() returns a pointer to
* newly copied header structure, or NULL upon an error.
*/
msg_#xxxxxx#_t *msg_#xxxxxx#_copy(su_home_t *home,
msg_#xxxxxx#_t *msg_#xxxxxx#_copy(su_home_t *home,
msg_#xxxxxx#_t const *hdr);
/**Make a header structure msg_#xxxxxx#_t.
*
*
* The function msg_#xxxxxx#_make() makes a new
* msg_#xxxxxx#_t header structure. It allocates a new
* header structure, and decodes the string @a s as the
* value of the structure.
*
*
* @param home memory home used to allocate new header structure.
* @param s string to be decoded as value of the new header structure
*
*
* @note This function is usually implemented as a macro calling
* msg_header_make().
*
*
* @return
* The function msg_#xxxxxx#_make() returns a pointer to
* newly maked msg_#xxxxxx#_t header structure, or NULL upon
......@@ -309,25 +309,25 @@ msg_#xxxxxx#_t *msg_#xxxxxx#_make(su_home_t *home, char const *s);
#endif
/**Make a #xxxxxxx_xxxxxxx# from formatting result.
*
*
* The function msg_#xxxxxx#_format() makes a new
* #xxxxxxx_xxxxxxx# object using formatting result as its
* value. The function first prints the arguments according to
* the format @a fmt specified. Then it allocates a new header
* structure, and uses the formatting result as the header
* value.
*
*
* @param home memory home used to allocate new header structure.
* @param fmt string used as a printf()-style format
* @param ... argument list for format
*
*
* @note This function is usually implemented as a macro calling
* msg_header_format().
*
*
* @return
* The function msg_#xxxxxx#_format() returns a pointer to newly
* makes header structure, or NULL upon an error.
*
*
* @HIDE
*/
#if SU_HAVE_INLINE
......@@ -341,11 +341,11 @@ su_inline msg_#xxxxxx#_t *msg_#xxxxxx#_format(su_home_t *home, char const *fmt,
{
msg_header_t *h;
va_list ap;
va_start(ap, fmt);
h = msg_header_vformat(home, msg_#xxxxxx#_class, fmt, ap);
va_end(ap);
return (msg_#xxxxxx#_t *)h;
}
#endif
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment