Changeset 7c3fb9b in mainline for uspace/lib/bithenge/include/bithenge/blob.h

Timestamp:

2018-05-17T08:29:01Z (6 years ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

6ff23ff

Parents:

fac0ac7

git-author:

Jiri Svoboda <jiri@…> (2018-05-16 17:28:17)

git-committer:

Jiri Svoboda <jiri@…> (2018-05-17 08:29:01)

Message:

Fix block comment formatting (ccheck).

File:

• uspace/lib/bithenge/include/bithenge/blob.h (modified) (10 diffs)

uspace/lib/bithenge/include/bithenge/blob.h

@@ -43 +43 @@
 
 /** A blob of raw binary data.
- * @implements bithenge_node_t */
+ * @implements bithenge_node_t
+ */
 typedef struct {
         /** @privatesection */
@@ -50 +51 @@
 
 /** Operations providing random access to binary data.
- * @todo Should these be thread-safe? */
+ * @todo Should these be thread-safe?
+ */
 typedef struct bithenge_random_access_blob_ops_t {
         /** @copydoc bithenge_blob_t::bithenge_blob_size */
@@ -61 +63 @@
             aoff64_t *size, bool little_endian);
         /** Destroy the blob.
-         * @param blob The blob. */
+         * @param blob The blob.
+         */
         void (*destroy)(bithenge_blob_t *self);
 } bithenge_random_access_blob_ops_t;
 
 /** A blob built from an object that supports only sequential reading.
- * @implements bithenge_blob_t */
+ * @implements bithenge_blob_t
+ */
 typedef struct {
         /** @privatesection */
@@ -82 +86 @@
 
 /** Operations providing sequential access to binary data.
- * @memberof bithenge_sequential_blob_t */
+ * @memberof bithenge_sequential_blob_t
+ */
 typedef struct bithenge_sequential_blob_ops_t {
 
@@ -112 +117 @@
 
         /** Destroy the blob.
-         * @param self The blob. */
+         * @param self The blob.
+         */
         void (*destroy)(bithenge_sequential_blob_t *self);
 } bithenge_sequential_blob_ops_t;
@@ -189 +195 @@
  * @param self The blob.
  * @param[out] out Holds whether the blob is empty.
- * @return EOK on success or an error code from errno.h. */
+ * @return EOK on success or an error code from errno.h.
+ */
 static inline errno_t bithenge_blob_empty(bithenge_blob_t *self, bool *out)
 {
@@ -203 +210 @@
  * @memberof bithenge_blob_t
  * @param blob The blob to cast.
- * @return The blob node as a generic node. */
+ * @return The blob node as a generic node.
+ */
 static inline bithenge_node_t *bithenge_blob_as_node(bithenge_blob_t *blob)
 {
@@ -212 +220 @@
  * @memberof bithenge_blob_t
  * @param node The node to cast, which must be a blob node.
- * @return The generic node as a blob node. */
+ * @return The generic node as a blob node.
+ */
 static inline bithenge_blob_t *bithenge_node_as_blob(bithenge_node_t *node)
 {
@@ -220 +229 @@
 
 /** Increment a blob's reference count.
- * @param blob The blob to reference. */
+ * @param blob The blob to reference.
+ */
 static inline void bithenge_blob_inc_ref(bithenge_blob_t *blob)
 {
@@ -227 +237 @@
 
 /** Decrement a blob's reference count.
- * @param blob The blob to dereference, or NULL. */
+ * @param blob The blob to dereference, or NULL.
+ */
 static inline void bithenge_blob_dec_ref(bithenge_blob_t *blob)
 {