aboutsummaryrefslogtreecommitdiffstats
path: root/lv2/lv2plug.in/ns/ext/atom/util.h
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2014-07-31 20:39:26 +0000
committerDavid Robillard <d@drobilla.net>2014-07-31 20:39:26 +0000
commit1c67d8123580b5cf70b5530277ad8320e97174cd (patch)
tree7b2382e550b35c6d87362f8995198f640fd5fdad /lv2/lv2plug.in/ns/ext/atom/util.h
parent64e25ef4f27e9e82402ba1a361e8c443eefc93db (diff)
downloadlv2-1c67d8123580b5cf70b5530277ad8320e97174cd.tar.xz
Use Doxygen Markdown support for more human-readable doc comments.
Minor improvements to UI documentation.
Diffstat (limited to 'lv2/lv2plug.in/ns/ext/atom/util.h')
-rw-r--r--lv2/lv2plug.in/ns/ext/atom/util.h36
1 files changed, 18 insertions, 18 deletions
diff --git a/lv2/lv2plug.in/ns/ext/atom/util.h b/lv2/lv2plug.in/ns/ext/atom/util.h
index 9dc5d32..1340024 100644
--- a/lv2/lv2plug.in/ns/ext/atom/util.h
+++ b/lv2/lv2plug.in/ns/ext/atom/util.h
@@ -44,21 +44,21 @@ lv2_atom_pad_size(uint32_t size)
return (size + 7U) & (~7U);
}
-/** Return the total size of @p atom, including the header. */
+/** Return the total size of `atom`, including the header. */
static inline uint32_t
lv2_atom_total_size(const LV2_Atom* atom)
{
return (uint32_t)sizeof(LV2_Atom) + atom->size;
}
-/** Return true iff @p atom is null. */
+/** Return true iff `atom` is null. */
static inline bool
lv2_atom_is_null(const LV2_Atom* atom)
{
return !atom || (atom->type == 0 && atom->size == 0);
}
-/** Return true iff @p a is equal to @p b. */
+/** Return true iff `a` is equal to `b`. */
static inline bool
lv2_atom_equals(const LV2_Atom* a, const LV2_Atom* b)
{
@@ -86,7 +86,7 @@ lv2_atom_sequence_end(const LV2_Atom_Sequence_Body* body, uint32_t size)
return (LV2_Atom_Event*)((const uint8_t*)body + lv2_atom_pad_size(size));
}
-/** Return true iff @p i has reached the end of @p body. */
+/** Return true iff `i` has reached the end of `body`. */
static inline bool
lv2_atom_sequence_is_end(const LV2_Atom_Sequence_Body* body,
uint32_t size,
@@ -95,7 +95,7 @@ lv2_atom_sequence_is_end(const LV2_Atom_Sequence_Body* body,
return (const uint8_t*)i >= ((const uint8_t*)body + size);
}
-/** Return an iterator to the element following @p i. */
+/** Return an iterator to the element following `i`. */
static inline LV2_Atom_Event*
lv2_atom_sequence_next(const LV2_Atom_Event* i)
{
@@ -134,7 +134,7 @@ lv2_atom_sequence_next(const LV2_Atom_Event* i)
*/
/**
- Clear all events from @p sequence.
+ Clear all events from `sequence`.
This simply resets the size field, the other fields are left untouched.
*/
@@ -145,14 +145,14 @@ lv2_atom_sequence_clear(LV2_Atom_Sequence* seq)
}
/**
- Append an event at the end of @p sequence.
+ Append an event at the end of `sequence`.
@param seq Sequence to append to.
@param capacity Total capacity of the sequence atom
(e.g. as set by the host for sequence output ports).
@param event Event to write.
- @return A pointer to the newly written event in @p seq,
+ @return A pointer to the newly written event in `seq`,
or NULL on failure (insufficient space).
*/
static inline LV2_Atom_Event*
@@ -179,21 +179,21 @@ lv2_atom_sequence_append_event(LV2_Atom_Sequence* seq,
@{
*/
-/** Get an iterator pointing to the first element in @p tup. */
+/** Get an iterator pointing to the first element in `tup`. */
static inline LV2_Atom*
lv2_atom_tuple_begin(const LV2_Atom_Tuple* tup)
{
return (LV2_Atom*)(LV2_ATOM_BODY(tup));
}
-/** Return true iff @p i has reached the end of @p body. */
+/** Return true iff `i` has reached the end of `body`. */
static inline bool
lv2_atom_tuple_is_end(const void* body, uint32_t size, const LV2_Atom* i)
{
return (const uint8_t*)i >= ((const uint8_t*)body + size);
}
-/** Return an iterator to the element following @p i. */
+/** Return an iterator to the element following `i`. */
static inline LV2_Atom*
lv2_atom_tuple_next(const LV2_Atom* i)
{
@@ -230,14 +230,14 @@ lv2_atom_tuple_next(const LV2_Atom* i)
@{
*/
-/** Return a pointer to the first property in @p body. */
+/** Return a pointer to the first property in `body`. */
static inline LV2_Atom_Property_Body*
lv2_atom_object_begin(const LV2_Atom_Object_Body* body)
{
return (LV2_Atom_Property_Body*)(body + 1);
}
-/** Return true iff @p i has reached the end of @p obj. */
+/** Return true iff `i` has reached the end of `obj`. */
static inline bool
lv2_atom_object_is_end(const LV2_Atom_Object_Body* body,
uint32_t size,
@@ -246,7 +246,7 @@ lv2_atom_object_is_end(const LV2_Atom_Object_Body* body,
return (const uint8_t*)i >= ((const uint8_t*)body + size);
}
-/** Return an iterator to the property following @p i. */
+/** Return an iterator to the property following `i`. */
static inline LV2_Atom_Property_Body*
lv2_atom_object_next(const LV2_Atom_Property_Body* i)
{
@@ -297,10 +297,10 @@ static const LV2_Atom_Object_Query LV2_ATOM_OBJECT_QUERY_END = { 0, NULL };
/**
Get an object's values for various keys.
- The value pointer of each item in @p query will be set to the location of
- the corresponding value in @p object. Every value pointer in @p query MUST
- be initialised to NULL. This function reads @p object in a single linear
- sweep. By allocating @p query on the stack, objects can be "queried"
+ The value pointer of each item in `query` will be set to the location of
+ the corresponding value in `object`. Every value pointer in `query` MUST
+ be initialised to NULL. This function reads `object` in a single linear
+ sweep. By allocating `query` on the stack, objects can be "queried"
quickly without allocating any memory. This function is realtime safe.
This function can only do "flat" queries, it is not smart enough to match