lib: add minimum version to various symbols based on libostree-released.sym

Closes: #1861
Approved by: cgwalters

src/libostree/ostree-core.c

@@ -485,6 +485,8 @@ _ostree_raw_file_to_archive_stream (GInputStream       *input,
  *
  * Convert from a "bare" file representation into an
  * OSTREE_OBJECT_TYPE_FILE stream suitable for ostree pull.
+ *
+ * Since: 2016.6
  */
 gboolean
 ostree_raw_file_to_archive_z2_stream (GInputStream       *input,
@@ -1472,6 +1474,8 @@ ostree_checksum_to_bytes_v (const char *checksum)
  * @checksum: An ASCII checksum
  *
  * Returns: (transfer full) (array fixed-size=32): Binary version of @checksum.
+ *
+ * Since: 2016.8
  */
 guchar *
 ostree_checksum_b64_to_bytes (const char *checksum)
@@ -1571,6 +1575,8 @@ ostree_checksum_from_bytes_v (GVariant *csum_v)
  *
  * The "modified" term refers to the fact that instead of '/', the '_'
  * character is used.
+ *
+ * Since: 2016.8
  */
 char *
 ostree_checksum_b64_from_bytes (const guchar *csum)
@@ -2395,6 +2401,8 @@ ostree_commit_get_timestamp (GVariant  *commit_variant)
  * root "dirmeta" checksum (both in binary form, not hexadecimal).
  *
  * Returns: (nullable): A SHA-256 hex string, or %NULL if @commit_variant is not well-formed
+ *
+ * Since: 2018.2
  */
 gchar *
 ostree_commit_get_content_checksum (GVariant *commit_variant)
@@ -2513,6 +2521,8 @@ _ostree_get_default_sysroot_path (void)
  * @required_release: Release version required
  *
  * Returns: %TRUE if current libostree has at least the requested version, %FALSE otherwise
+ *
+ * Since: 2017.4
  */
 gboolean
 ostree_check_version (guint required_year, guint required_release)

src/libostree/ostree-deployment.c

@@ -302,6 +302,11 @@ ostree_deployment_get_origin_relpath (OstreeDeployment *self)
                           ostree_deployment_get_deployserial (self));
 }
 
+/**
+ * ostree_deployment_unlocked_state_to_string:
+ *
+ * Since: 2016.4
+ */
 const char *
 ostree_deployment_unlocked_state_to_string (OstreeDeploymentUnlockedState state)
 {
@@ -317,6 +322,11 @@ ostree_deployment_unlocked_state_to_string (OstreeDeploymentUnlockedState state)
   g_assert_not_reached ();
 }
 
+/**
+ * ostree_deployment_get_unlocked:
+ *
+ * Since: 2016.4
+ */
 OstreeDeploymentUnlockedState
 ostree_deployment_get_unlocked (OstreeDeployment *self)
 {

src/libostree/ostree-diff.c

@@ -239,6 +239,8 @@ ostree_diff_dirs (OstreeDiffFlags flags,
  *
  * Compute the difference between directory @a and @b as 3 separate
  * sets of #OstreeDiffItem in @modified, @removed, and @added.
+ *
+ * Since: 2017.4
  */
 gboolean
 ostree_diff_dirs_with_options (OstreeDiffFlags        flags,

src/libostree/ostree-gpg-verify-result.c

@@ -695,6 +695,8 @@ ostree_gpg_verify_result_describe_variant (GVariant *variant,
  *
  * Returns: %TRUE if @result was not %NULL and had at least one
  * signature from trusted keyring, otherwise %FALSE
+ *
+ * Since: 2016.6
  */
 gboolean
 ostree_gpg_verify_result_require_valid_signature (OstreeGpgVerifyResult *result,

src/libostree/ostree-gpg-verify-result.h

@@ -161,6 +161,11 @@ typedef enum {
   OSTREE_GPG_ERROR_MISSING_KEY,
 } OstreeGpgError;
 
+/**
+ * ostree_gpg_error_quark:
+ *
+ * Since: 2017.10
+ */
 _OSTREE_PUBLIC
 GQuark ostree_gpg_error_quark (void);
 #define OSTREE_GPG_ERROR (ostree_gpg_error_quark ())

src/libostree/ostree-mutable-tree.c

@@ -331,6 +331,8 @@ ostree_mutable_tree_replace_file (OstreeMutableTree *self,
  * @error: a #GError
  *
  * Remove the file or subdirectory named @name from the mutable tree @self.
+ *
+ * Since: 2018.9
  */
 gboolean
 ostree_mutable_tree_remove (OstreeMutableTree *self,
@@ -494,6 +496,8 @@ const char empty_tree_csum[] = "6e340b9cffb37a989ca544e6bb780a2c78901d3fb3373876
  * This function enables optimisations when composing trees.  The provided
  * checksums are not loaded or checked when this function is called.  Instead
  * the contents will be loaded only when needed.
+ *
+ * Since: 2018.7
  */
 gboolean
 ostree_mutable_tree_fill_empty_from_dirtree (OstreeMutableTree *self,
@@ -654,6 +658,8 @@ ostree_mutable_tree_new (void)
  * and checksums.  The data will be loaded from the repo lazily as needed.
  *
  * Returns: (transfer full): A new tree
+ *
+ * Since: 2018.7
  */
 OstreeMutableTree *
 ostree_mutable_tree_new_from_checksum (OstreeRepo *repo,

src/libostree/ostree-repo-checkout.c

@@ -1321,6 +1321,8 @@ ostree_repo_checkout_tree_at (OstreeRepo                        *self,
  * Note in addition that unlike ostree_repo_checkout_tree(), the
  * default is not to use the repository-internal uncompressed objects
  * cache.
+ *
+ * Since: 2016.8
  */
 gboolean
 ostree_repo_checkout_at (OstreeRepo                        *self,
@@ -1391,6 +1393,8 @@ ostree_repo_checkout_at (OstreeRepo                        *self,
  *
  * Note that cache does *not* have its refcount incremented - the lifetime of
  * @cache must be equal to or greater than that of @opts.
+ *
+ * Since: 2017.13
  */
 void
 ostree_repo_checkout_at_options_set_devino (OstreeRepoCheckoutAtOptions *opts,

src/libostree/ostree-repo-commit.c

@@ -2065,6 +2065,8 @@ ostree_repo_set_ref_immediate (OstreeRepo *self,
  * @error: GError
  *
  * Like ostree_repo_set_ref_immediate(), but creates an alias.
+ *
+ * Since: 2017.10
  */
 gboolean
 ostree_repo_set_alias_ref_immediate (OstreeRepo *self,

src/libostree/ostree-repo-prune.c

@@ -473,6 +473,8 @@ ostree_repo_prune (OstreeRepo        *self,
  * statistics on objects that would be deleted, without actually deleting them.
  *
  * Locking: exclusive
+ *
+ * Since: 2017.1
  */
 gboolean
 ostree_repo_prune_from_reachable (OstreeRepo        *self,

src/libostree/ostree-repo-pull.c

@@ -6103,6 +6103,8 @@ ostree_repo_pull_from_remotes_finish (OstreeRepo    *self,
  *   means return errors without retrying
  *
  * Returns: %TRUE on success, %FALSE on failure
+ *
+ * Since: 2016.6
  */
 gboolean
 ostree_repo_remote_fetch_summary_with_options (OstreeRepo    *self,

src/libostree/ostree-repo-refs.c

@@ -482,6 +482,8 @@ ostree_repo_resolve_rev (OstreeRepo     *self,
  *
  * The flag %OSTREE_REPO_RESOLVE_REV_EXT_LOCAL_ONLY is implied so
  * using it has no effect.
+ *
+ * Since: 2016.7
  */
 gboolean
 ostree_repo_resolve_rev_ext (OstreeRepo                    *self,
@@ -856,6 +858,8 @@ ostree_repo_list_refs (OstreeRepo       *self,
  * @out_all_refs will be returned as a mapping from refspecs (including the
  * remote name) to checksums. Differently from ostree_repo_list_refs(), the
  * @refspec_prefix will not be removed from the refspecs in the hash table.
+ *
+ * Since: 2016.4
  */
 gboolean
 ostree_repo_list_refs_ext (OstreeRepo                 *self,

src/libostree/ostree-repo.c

@@ -786,6 +786,8 @@ _ostree_repo_remote_name_is_file (const char *remote_name)
  * option name.  If an error is returned, @out_value will be set to %NULL.
  *
  * Returns: %TRUE on success, otherwise %FALSE with @error set
+ *
+ * Since: 2016.5
  */
 gboolean
 ostree_repo_get_remote_option (OstreeRepo  *self,
@@ -864,6 +866,8 @@ ostree_repo_get_remote_option (OstreeRepo  *self,
  * to %NULL.
  *
  * Returns: %TRUE on success, otherwise %FALSE with @error set
+ *
+ * Since: 2016.5
  */
 gboolean
 ostree_repo_get_remote_list_option (OstreeRepo   *self,
@@ -939,6 +943,8 @@ ostree_repo_get_remote_list_option (OstreeRepo   *self,
  * error is returned, @out_value will be set to %FALSE.
  *
  * Returns: %TRUE on success, otherwise %FALSE with @error set
+ *
+ * Since: 2016.5
  */
 gboolean
 ostree_repo_get_remote_boolean_option (OstreeRepo  *self,
@@ -1255,6 +1261,8 @@ repo_open_at_take_fd (int *dfd,
  * already extant repository.  If you want to create one, use ostree_repo_create_at().
  *
  * Returns: (transfer full): An accessor object for an OSTree repository located at @dfd + @path
+ *
+ * Since: 2017.10
  */
 OstreeRepo*
 ostree_repo_open_at (int           dfd,
@@ -2570,6 +2578,8 @@ ostree_repo_create (OstreeRepo     *self,
  *   - collection-id: s: Set as collection ID in repo/config (Since 2017.9)
  *
  * Returns: (transfer full): A new OSTree repository reference
+ *
+ * Since: 2017.10
  */
 OstreeRepo *
 ostree_repo_create_at (int             dfd,
@@ -3149,6 +3159,8 @@ reload_sysroot_config (OstreeRepo          *self,
  *
  * By default, an #OstreeRepo will cache the remote configuration and its
  * own repo/config data.  This API can be used to reload it.
+ *
+ * Since: 2017.2
  */
 gboolean
 ostree_repo_reload_config (OstreeRepo          *self,
@@ -3313,6 +3325,8 @@ ostree_repo_set_disable_fsync (OstreeRepo    *self,
  * per-remote summary caches. Setting this manually is useful when
  * doing operations on a system repo as a user because you don't have
  * write permissions in the repo, where the cache is normally stored.
+ *
+ * Since: 2016.5
  */
 gboolean
 ostree_repo_set_cache_dir (OstreeRepo    *self,
@@ -3394,6 +3408,7 @@ ostree_repo_get_path (OstreeRepo  *self)
  * repository (to see whether a ref was written).
  *
  * Returns: File descriptor for repository root - owned by @self
+ * Since: 2016.4
  */
 int
 ostree_repo_get_dfd (OstreeRepo  *self)
@@ -4334,6 +4349,8 @@ ostree_repo_import_object_from (OstreeRepo           *self,
  * this will simply be a fast Unix hard link operation.
  *
  * Otherwise, a copy will be performed.
+ *
+ * Since: 2016.5
  */
 gboolean
 ostree_repo_import_object_from_with_trust (OstreeRepo           *self,
@@ -5431,6 +5448,8 @@ ostree_repo_verify_commit_ext (OstreeRepo    *self,
  * configured for @remote.
  *
  * Returns: (transfer full): an #OstreeGpgVerifyResult, or %NULL on error
+ *
+ * Since: 2016.14
  */
 OstreeGpgVerifyResult *
 ostree_repo_verify_commit_for_remote (OstreeRepo    *self,
@@ -5466,6 +5485,8 @@ ostree_repo_verify_commit_for_remote (OstreeRepo    *self,
  * the verifications using GPG keys in the keyrings of all remotes.
  *
  * Returns: (transfer full): an #OstreeGpgVerifyResult, or %NULL on error
+ *
+ * Since: 2016.6
  */
 OstreeGpgVerifyResult *
 ostree_repo_gpg_verify_data (OstreeRepo    *self,

src/libostree/ostree-sepolicy.c

@@ -430,6 +430,8 @@ ostree_sepolicy_new (GFile         *path,
  * @error: Error
  *
  * Returns: (transfer full): An accessor object for SELinux policy in root located at @rootfs_dfd
+ *
+ * Since: 2017.4
  */
 OstreeSePolicy*
 ostree_sepolicy_new_at (int         rootfs_dfd,
@@ -472,6 +474,8 @@ ostree_sepolicy_get_name (OstreeSePolicy *self)
  * @self:
  *
  * Returns: (transfer none): Checksum of current policy
+ *
+ * Since: 2016.5
  */
 const char *
 ostree_sepolicy_get_csum (OstreeSePolicy *self)

src/libostree/ostree-sysroot-deploy.c

@@ -2170,6 +2170,8 @@ write_deployments_finish (OstreeSysroot *self,
  * ostree_sysroot_cleanup() at some point after the transaction, or specify
  * `do_postclean` in @opts.  Skipping the post-transaction cleanup is useful
  * if for example you want to control pruning of the repository.
+ *
+ * Since: 2017.4
  */
 gboolean
 ostree_sysroot_write_deployments_with_options (OstreeSysroot     *self,
@@ -2756,6 +2758,8 @@ _ostree_sysroot_deserialize_deployment_from_variant (GVariant *v,
  *
  * Like ostree_sysroot_deploy_tree(), but "finalization" only occurs at OS
  * shutdown time.
+ *
+ * Since: 2018.5
  */
 gboolean
 ostree_sysroot_stage_tree (OstreeSysroot     *self,

src/libostree/ostree-sysroot.c

@@ -855,6 +855,11 @@ _ostree_sysroot_reload_staged (OstreeSysroot *self,
   return TRUE;
 }
 
+/**
+ * ostree_sysroot_load_if_changed:
+ *
+ * Since: 2016.4
+ */
 gboolean
 ostree_sysroot_load_if_changed (OstreeSysroot  *self,
                                 gboolean       *out_changed,
@@ -1033,6 +1038,8 @@ ostree_sysroot_get_booted_deployment (OstreeSysroot       *self)
  * @self: Sysroot
  *
  * Returns: (transfer none): The currently staged deployment, or %NULL if none
+ *
+ * Since: 2018.5
  */
 OstreeDeployment *
 ostree_sysroot_get_staged_deployment (OstreeSysroot       *self)
@@ -1144,6 +1151,8 @@ ostree_sysroot_get_repo (OstreeSysroot         *self,
  * has been invoked successfully.
  *
  * Returns: (transfer none): The OSTree repository in sysroot @self.
+ *
+ * Since: 2017.7
  */
 OstreeRepo *
 ostree_sysroot_repo (OstreeSysroot *self)
@@ -1475,6 +1484,8 @@ ostree_sysroot_lock_finish (OstreeSysroot         *self,
  * Initialize the directory structure for an "osname", which is a
  * group of operating system deployments, with a shared `/var`.  One
  * is required for generating a deployment.
+ *
+ * Since: 2016.4
  */
 gboolean
 ostree_sysroot_init_osname (OstreeSysroot       *self,
@@ -1729,6 +1740,8 @@ static gboolean mkdir_unmasked (int                   dfd,
  *
  * The `OSTREE_DEPLOYMENT_UNLOCKED_HOTFIX` state is persistent
  * across reboots.
+ *
+ * Since: 2016.4
  */
 gboolean
 ostree_sysroot_deployment_unlock (OstreeSysroot     *self,