repo: Document non-obvious way to list all commits

I was going to add an API for this and then realized the empty
string does it.
This commit is contained in:
Colin Walters 2022-06-09 18:34:25 -04:00
parent 10212626d2
commit a13d812368
1 changed files with 3 additions and 1 deletions

View File

@ -4999,7 +4999,7 @@ ostree_repo_list_objects (OstreeRepo *self,
/**
* ostree_repo_list_commit_objects_starting_with:
* @self: Repo
* @start: List commits starting with this checksum
* @start: List commits starting with this checksum (empty string for all)
* @out_commits: (out) (transfer container) (element-type GVariant GVariant):
* Map of serialized commit name to variant data
* @cancellable: Cancellable
@ -5008,6 +5008,8 @@ ostree_repo_list_objects (OstreeRepo *self,
* This function synchronously enumerates all commit objects starting
* with @start, returning data in @out_commits.
*
* To list all commit objects, provide the empty string `""` for @start.
*
* Returns: %TRUE on success, %FALSE on error, and @error will be set
*/
gboolean