diff options
author | Colin Walters <walters@verbum.org> | 2013-08-15 07:04:29 -0400 |
---|---|---|
committer | Colin Walters <walters@verbum.org> | 2013-08-15 07:04:29 -0400 |
commit | 1f35655ac18bf878ae131b7e0b18abe527a40636 (patch) | |
tree | 25ab2f05c113ab515f5f9bb0161726f1a4073dde | |
parent | 3989e0d397aa7e4fb23dd4615e38f16358857e9c (diff) | |
download | ostree-1f35655ac18bf878ae131b7e0b18abe527a40636.tar.gz |
core: Add some gtk-doc
Just documenting a few functions to get in the habit of things.
-rw-r--r-- | src/libostree/ostree-core.c | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/src/libostree/ostree-core.c b/src/libostree/ostree-core.c index f746b337..2aa269dc 100644 --- a/src/libostree/ostree-core.c +++ b/src/libostree/ostree-core.c @@ -35,6 +35,12 @@ #define ALIGN_VALUE(this, boundary) \ (( ((unsigned long)(this)) + (((unsigned long)(boundary)) -1)) & (~(((unsigned long)(boundary))-1))) +/** + * ostree_metadata_variant_type: + * @objtype: an object type + * + * Given a metadata object, return the signature of its #GVariant. + */ const GVariantType * ostree_metadata_variant_type (OstreeObjectType objtype) { @@ -51,6 +57,15 @@ ostree_metadata_variant_type (OstreeObjectType objtype) } } +/** + * ostree_validate_checksum_string: + * @sha256: SHA256 hex string + * @error: + * + * Use this function to see if input strings are checksums. + * + * Returns: %TRUE if @sha256 is a valid checksum string, %FALSE otherwise + */ gboolean ostree_validate_checksum_string (const char *sha256, GError **error) @@ -61,6 +76,19 @@ ostree_validate_checksum_string (const char *sha256, #define OSTREE_REF_FRAGMENT_REGEXP "[-._\\w\\d]+" #define OSTREE_REF_REGEXP "(?:" OSTREE_REF_FRAGMENT_REGEXP "/)*" OSTREE_REF_FRAGMENT_REGEXP +/** + * ostree_parse_refspec: + * @refspec: A "refspec" string + * @out_remote: (out) (allow-none): The remote name, or %NULL if the refspec refs to a local ref + * @out_ref: (out) (allow-none): Name of ref + * @error: + * + * Split a refspec like "gnome-ostree:gnome-ostree/buildmaster" into + * two parts; @out_remote will be set to "gnome-ostree", and @out_ref + * will be "gnome-ostree/buildmaster". + * + * If @refspec refers to a local ref, @out_remote will be %NULL. + */ gboolean ostree_parse_refspec (const char *refspec, char **out_remote, @@ -215,6 +243,19 @@ read_xattr_name_array (const char *path, return ret; } +/** + * ostree_get_xattrs_for_file: + * @f: a #GFile + * @out_xattrs: (out): A new #GVariant containing the extended attributes + * @cancellable: + * @error: + * + * Read all extended attributes of @f in a canonical sorted order, and + * set @out_xattrs with the result. + * + * If the filesystem does not support extended attributes, @out_xattrs + * will have 0 elements, and this function will return successfully. + */ gboolean ostree_get_xattrs_for_file (GFile *f, GVariant **out_xattrs, |