From c717152c88113ddabed33c02f9e818dd0fb392a4 Mon Sep 17 00:00:00 2001
From: Vreixo Formoso <metalpain2002@yahoo.es>
Date: Fri, 1 Feb 2008 12:15:44 +0100
Subject: [PATCH] Added since tag to all functions.

---
 libisofs/libisofs.h | 365 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 363 insertions(+), 2 deletions(-)

diff --git a/libisofs/libisofs.h b/libisofs/libisofs.h
index b26f9dc..fe17469 100644
--- a/libisofs/libisofs.h
+++ b/libisofs/libisofs.h
@@ -16,6 +16,8 @@ struct burn_source;
 /**
  * Context for image creation. It holds the files that will be added to image,
  * and several options to control libisofs behavior.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Image IsoImage;
 
@@ -25,24 +27,32 @@ typedef struct Iso_Image IsoImage;
  * It can represent any kind of files. When needed, you can get the type with 
  * iso_node_get_type() and cast it to the appropiate subtype. Useful macros
  * are provided, see below.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Node IsoNode;
 
 /**
  * A directory in the iso tree. It is an special type of IsoNode and can be
  * casted to it in any case.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Dir IsoDir;
 
 /**
  * A symbolic link in the iso tree. It is an special type of IsoNode and can be
  * casted to it in any case.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Symlink IsoSymlink;
 
 /**
  * A regular file in the iso tree. It is an special type of IsoNode and can be
  * casted to it in any case.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_File IsoFile;
 
@@ -51,6 +61,8 @@ typedef struct Iso_File IsoFile;
  * other that regular files, directories or symlinks, i.e.: socket, block and
  * character devices, and fifos.
  * It is an special type of IsoNode and can be casted to it in any case.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Special IsoSpecial;
 
@@ -68,6 +80,8 @@ typedef struct Iso_Special IsoSpecial;
  *      IsoDir *dir = (IsoDir *)node;
  *      ...
  * }
+ *
+ * @since 0.6.1
  */
 enum IsoNodeType {
     LIBISO_DIR,
@@ -95,24 +109,31 @@ enum IsoNodeType {
 /**
  * Context for iterate on directory children.
  * @see iso_dir_get_children()
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Dir_Iter IsoDirIter;
 
 /**
  * It represents an El-Torito boot image.
+ *
+ * @since 0.6.1
  */
 typedef struct el_torito_boot_image ElToritoBootImage;
 
 /**
  * An special type of IsoNode that acts as a placeholder for an El-Torito
  * boot catalog. Once written, it will appear as a regular file.
+ *
+ * @since 0.6.1
  */
 typedef struct Iso_Boot IsoBoot;
 
 /**
  * Flag used to hide a file in the RR/ISO or Joliet tree.
  * 
- * \see iso_node_set_hidden
+ * @see iso_node_set_hidden
+ * @since 0.6.1
  */
 enum IsoHideNodeFlag {
     /** Hide the node in the ECMA-119 / RR tree */
@@ -125,6 +146,8 @@ enum IsoHideNodeFlag {
 
 /**
  * El-Torito bootable image type.
+ *
+ * @since 0.6.1
  */
 enum eltorito_boot_media_type {
     ELTORITO_FLOPPY_EMUL,
@@ -136,6 +159,8 @@ enum eltorito_boot_media_type {
  * Replace mode used when addding a node to a file.
  * This controls how libisofs will act when you tried to add to a dir a file
  * with the same name that an existing file.
+ *
+ * @since 0.6.1
  */
 enum iso_replace_mode {
     /**
@@ -169,12 +194,14 @@ enum iso_replace_mode {
 /**
  * Options for image written.
  * @see iso_write_opts_new()
+ * @since 0.6.1
  */
 typedef struct iso_write_opts IsoWriteOpts;
 
 /**
  * Options for image reading or import.
  * @see iso_read_opts_new()
+ * @since 0.6.1
  */
 typedef struct iso_read_opts IsoReadOpts;
 
@@ -182,6 +209,7 @@ typedef struct iso_read_opts IsoReadOpts;
  * Source for image reading.
  * 
  * @see struct iso_data_source
+ * @since 0.6.1
  */
 typedef struct iso_data_source IsoDataSource;
 
@@ -196,6 +224,8 @@ typedef struct iso_data_source IsoDataSource;
  * an IsoDataSource that uses POSIX I/O functions to access data. You can use 
  * it with regular .iso images, and also with block devices that represent a 
  * drive.
+ *
+ * @since 0.6.1
  */
 struct iso_data_source
 {
@@ -257,6 +287,8 @@ struct iso_data_source
  * Return information for image.
  * Both size, hasRR and hasJoliet will be filled by libisofs with suitable 
  * values.
+ *
+ * @since 0.6.1
  */
 struct iso_read_image_features
 {
@@ -286,6 +318,7 @@ struct iso_read_image_features
  * POSIX abstraction for source files.
  * 
  * @see struct iso_file_source
+ * @since 0.6.1
  */
 typedef struct iso_file_source IsoFileSource;
 
@@ -293,6 +326,7 @@ typedef struct iso_file_source IsoFileSource;
  * Abstract for source filesystems.
  * 
  * @see struct iso_filesystem
+ * @since 0.6.1
  */
 typedef struct iso_filesystem IsoFilesystem;
 
@@ -301,6 +335,7 @@ typedef struct iso_filesystem IsoFilesystem;
  * IsoFileSource.
  * 
  * @see struct IsoFileSource_Iface
+ * @since 0.6.1
  */
 typedef struct IsoFileSource_Iface IsoFileSourceIface;
 
@@ -308,11 +343,14 @@ typedef struct IsoFileSource_Iface IsoFileSourceIface;
  * IsoFilesystem implementation to deal with ISO images, and to offer a way to
  * access specific information of the image, such as several volume attributes, 
  * extensions being used, El-Torito artifacts...
+ *
+ * @since 0.6.1
  */
 typedef IsoFilesystem IsoImageFilesystem;
 
 /**
  * See IsoFilesystem->get_id() for info about this.
+ * @since 0.6.1
  */
 extern unsigned int iso_fs_global_id;
 
@@ -332,6 +370,8 @@ extern unsigned int iso_fs_global_id;
  * 
  * Each file inside an IsoFilesystem is represented as an IsoFileSource object,
  * that defines POSIX-like interface for accessing files.
+ *
+ * @since 0.6.1
  */
 struct iso_filesystem
 {
@@ -419,6 +459,8 @@ struct iso_filesystem
 /**
  * Interface definition for an IsoFileSource. Defines the POSIX-like function
  * to access files and abstract underlying source.
+ *
+ * @since 0.6.1
  */
 struct IsoFileSource_Iface
 {
@@ -609,6 +651,8 @@ struct IsoFileSource_Iface
 
 /**
  * An IsoFile Source is a POSIX abstraction of a file.
+ *
+ * @since 0.6.1
  */
 struct iso_file_source
 {
@@ -620,11 +664,15 @@ struct iso_file_source
 /**
  * Initialize libisofs. You must call this before any usage of the library.
  * @return 1 on success, < 0 on error 
+ *
+ * @since 0.6.1
  */
 int iso_init();
 
 /**
  * Finalize libisofs.
+ *
+ * @since 0.6.1
  */
 void iso_finish();
 
@@ -639,6 +687,8 @@ void iso_finish();
  *     Location where the image pointer will be stored.
  * @return
  *     1 sucess, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_image_new(const char *name, IsoImage **image);
 
@@ -649,6 +699,8 @@ int iso_image_new(const char *name, IsoImage **image);
  */
 /**
  * Get version of the libisofs library at runtime.
+ *
+ * @since 0.6.1
  */
 void iso_lib_version(int *major, int *minor, int *micro);
 
@@ -657,6 +709,8 @@ void iso_lib_version(int *major, int *minor, int *micro);
  * 
  * @return 
  *      1 lib is compatible, 0 is not.
+ *
+ * @since 0.6.1
  */
 int iso_lib_is_compatible(int major, int minor, int micro);
 
@@ -674,6 +728,8 @@ int iso_lib_is_compatible(int major, int minor, int micro);
  * 
  * Before usage of these macros on your code, please read the usage discussion 
  * below.
+ *
+ * @since 0.6.1
  */
 #define iso_lib_header_version_major  0
 #define iso_lib_header_version_minor  6
@@ -745,11 +801,15 @@ int iso_lib_is_compatible(int major, int minor, int micro);
  *        default values, and timestamps to the time of recording.
  * @return
  *      1 success, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_new(IsoWriteOpts **opts, int profile);
 
 /**
  * Free an IsoWriteOpts previously allocated with iso_write_opts_new().
+ *
+ * @since 0.6.1
  */
 void iso_write_opts_free(IsoWriteOpts *opts);
 
@@ -762,6 +822,8 @@ void iso_write_opts_free(IsoWriteOpts *opts);
  *      -> 2 to allow up to 31 filename characters.
  * @return
  *      1 success, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_iso_level(IsoWriteOpts *opts, int level);
 
@@ -780,6 +842,8 @@ int iso_write_opts_set_iso_level(IsoWriteOpts *opts, int level);
  *      1 to enable RR extension, 0 to not add them
  * @return
  *      1 success, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_rockridge(IsoWriteOpts *opts, int enable);
 
@@ -795,6 +859,8 @@ int iso_write_opts_set_rockridge(IsoWriteOpts *opts, int enable);
  *      1 to enable Joliet extension, 0 to not add them
  * @return
  *      1 success, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_joliet(IsoWriteOpts *opts, int enable);
 
@@ -804,6 +870,8 @@ int iso_write_opts_set_joliet(IsoWriteOpts *opts, int enable);
  * This is the second version of ISO-9660. It allows longer filenames and has
  * less restrictions than old ISO-9660. However, nobody is using it so there
  * are no much reasons to enable this. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_iso1999(IsoWriteOpts *opts, int enable);
 
@@ -811,18 +879,24 @@ int iso_write_opts_set_iso1999(IsoWriteOpts *opts, int enable);
  * Omit the version number (";1") at the end of the ISO-9660 identifiers.
  * This breaks ECMA-119 specification, but version numbers are usually not 
  * used, so it should work on most systems. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_omit_version_numbers(IsoWriteOpts *opts, int omit);
 
 /**
  * Allow ISO-9660 directory hierarchy to be deeper than 8 levels. 
  * This breaks ECMA-119 specification. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_allow_deep_paths(IsoWriteOpts *opts, int allow);
 
 /**
  * Allow path in the ISO-9660 tree to have more than 255 characters.
  * This breaks ECMA-119 specification. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_allow_longer_paths(IsoWriteOpts *opts, int allow);
 
@@ -833,6 +907,8 @@ int iso_write_opts_set_allow_longer_paths(IsoWriteOpts *opts, int allow);
  * omit_version_numbers.
  * This breaks ECMA-119 specification and could lead to buffer overflow
  * problems on old systems. Use with caution.
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_max_37_char_filenames(IsoWriteOpts *opts, int allow);
 
@@ -841,6 +917,8 @@ int iso_write_opts_set_max_37_char_filenames(IsoWriteOpts *opts, int allow);
  * extension. libisofs adds it if original filename doesn't has one. Set 
  * this to 1 to prevent this behavior.
  * This breaks ECMA-119 specification. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_no_force_dots(IsoWriteOpts *opts, int no);
 
@@ -848,6 +926,8 @@ int iso_write_opts_set_no_force_dots(IsoWriteOpts *opts, int no);
  * Allow lowercase characters in ISO-9660 filenames. By default, only 
  * uppercase characters, numbers and a few other characters are allowed. 
  * This breaks ECMA-119 specification. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_allow_lowercase(IsoWriteOpts *opts, int allow);
 
@@ -855,12 +935,16 @@ int iso_write_opts_set_allow_lowercase(IsoWriteOpts *opts, int allow);
  * Allow all ASCII characters to be appear on an ISO-9660 filename. Note
  * that "/" and "\0" characters are never allowed, even in RR names.
  * This breaks ECMA-119 specification. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_allow_full_ascii(IsoWriteOpts *opts, int allow);
 
 /**
  * Allow paths in the Joliet tree to have more than 240 characters.
  * This breaks Joliet specification. Use with caution. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_joliet_longer_paths(IsoWriteOpts *opts, int allow);
 
@@ -868,6 +952,7 @@ int iso_write_opts_set_joliet_longer_paths(IsoWriteOpts *opts, int allow);
  * Whether to sort files based on their weight.
  * 
  * @see iso_node_set_sort_weight
+ * @since 0.6.1
  */
 int iso_write_opts_set_sort_files(IsoWriteOpts *opts, int sort);
 
@@ -887,6 +972,7 @@ int iso_write_opts_set_sort_files(IsoWriteOpts *opts, int sort);
  * @see iso_write_opts_set_default_file_mode
  * @see iso_write_opts_set_default_uid
  * @see iso_write_opts_set_default_gid
+ * @since 0.6.1
  */
 int iso_write_opts_set_replace_mode(IsoWriteOpts *opts, int dir_mode,
                                     int file_mode, int uid, int gid);
@@ -895,6 +981,7 @@ int iso_write_opts_set_replace_mode(IsoWriteOpts *opts, int dir_mode,
  * Set the mode to use on dirs when you set the replace_mode of dirs to 2.
  * 
  * @see iso_write_opts_set_replace_mode
+ * @since 0.6.1
  */
 int iso_write_opts_set_default_dir_mode(IsoWriteOpts *opts, mode_t dir_mode);
 
@@ -902,6 +989,7 @@ int iso_write_opts_set_default_dir_mode(IsoWriteOpts *opts, mode_t dir_mode);
  * Set the mode to use on files when you set the replace_mode of files to 2.
  * 
  * @see iso_write_opts_set_replace_mode
+ * @since 0.6.1
  */
 int iso_write_opts_set_default_file_mode(IsoWriteOpts *opts, mode_t file_mode);
 
@@ -909,6 +997,7 @@ int iso_write_opts_set_default_file_mode(IsoWriteOpts *opts, mode_t file_mode);
  * Set the uid to use when you set the replace_uid to 2.
  * 
  * @see iso_write_opts_set_replace_mode
+ * @since 0.6.1
  */
 int iso_write_opts_set_default_uid(IsoWriteOpts *opts, uid_t uid);
 
@@ -916,6 +1005,7 @@ int iso_write_opts_set_default_uid(IsoWriteOpts *opts, uid_t uid);
  * Set the gid to use when you set the replace_gid to 2.
  * 
  * @see iso_write_opts_set_replace_mode
+ * @since 0.6.1
  */
 int iso_write_opts_set_default_gid(IsoWriteOpts *opts, gid_t gid);
 
@@ -925,6 +1015,7 @@ int iso_write_opts_set_default_gid(IsoWriteOpts *opts, gid_t gid);
  * are enabled.
  * 
  * @see iso_write_opts_set_default_timestamp
+ * @since 0.6.1
  */
 int iso_write_opts_set_replace_timestamps(IsoWriteOpts *opts, int replace);
 
@@ -932,6 +1023,7 @@ int iso_write_opts_set_replace_timestamps(IsoWriteOpts *opts, int replace);
  * Set the timestamp to use when you set the replace_timestamps to 2.
  * 
  * @see iso_write_opts_set_replace_timestamps
+ * @since 0.6.1
  */
 int iso_write_opts_set_default_timestamp(IsoWriteOpts *opts, time_t timestamp);
 
@@ -943,6 +1035,8 @@ int iso_write_opts_set_default_timestamp(IsoWriteOpts *opts, time_t timestamp);
  * your timezone, or you live in a timezone that can't be represented in
  * ECMA-119. These are timezones whose offset from GMT is greater than +13 
  * hours, lower than -12 hours, or not a multiple of 15 minutes. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_always_gmt(IsoWriteOpts *opts, int gmt);
 
@@ -952,6 +1046,8 @@ int iso_write_opts_set_always_gmt(IsoWriteOpts *opts, int gmt);
  * NULL to use default charset, that is the locale charset.
  * You can obtain the list of charsets supported on your system executing 
  * "iconv -l" in a shell.
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_output_charset(IsoWriteOpts *opts, const char *charset);
 
@@ -979,6 +1075,8 @@ int iso_write_opts_set_output_charset(IsoWriteOpts *opts, const char *charset);
  * 
  * @param appendable
  *      1 to create an appendable image, 0 for an stand-alone one.
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_appendable(IsoWriteOpts *opts, int appendable);
 
@@ -994,6 +1092,8 @@ int iso_write_opts_set_appendable(IsoWriteOpts *opts, int appendable);
  * provide a different ms_block if you don't plan to burn the image in the
  * first session on disc, such as in some CD-Extra disc whether the data
  * image is written in a new session after some audio tracks. 
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_ms_block(IsoWriteOpts *opts, uint32_t ms_block);
 
@@ -1022,6 +1122,8 @@ int iso_write_opts_set_ms_block(IsoWriteOpts *opts, uint32_t ms_block);
  * If you don't need this information, for example because you're creating a
  * new image from scratch of because you will create an image for a true
  * multisession media, just don't set this buffer or set it to NULL.
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_overwrite_buf(IsoWriteOpts *opts, uint8_t *overwrite);
 
@@ -1030,6 +1132,8 @@ int iso_write_opts_set_overwrite_buf(IsoWriteOpts *opts, uint8_t *overwrite);
  * writer thread and the burn_source. You have to provide at least a 32 
  * blocks buffer. Default value is set to 2MB, if that is ok for you, you
  * don't need to call this function.
+ *
+ * @since 0.6.1
  */
 int iso_write_opts_set_fifo_size(IsoWriteOpts *opts, size_t fifo_size);
 
@@ -1046,6 +1150,8 @@ int iso_write_opts_set_fifo_size(IsoWriteOpts *opts, size_t fifo_size);
  *     Location where the pointer to the burn_source will be stored
  * @return
  *     1 on success, < 0 on error 
+ *
+ * @since 0.6.1
  */
 int iso_image_create_burn_source(IsoImage *image, IsoWriteOpts *opts,
                                  struct burn_source **burn_src);
@@ -1069,17 +1175,23 @@ int iso_image_create_burn_source(IsoImage *image, IsoWriteOpts *opts,
  *         Joliet and RR extension are present, RR is used. 
  * @return
  *      1 success, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_new(IsoReadOpts **opts, int profile);
 
 /**
  * Free an IsoReadOpts previously allocated with iso_read_opts_new().
+ *
+ * @since 0.6.1
  */
 void iso_read_opts_free(IsoReadOpts *opts);
 
 /** 
  * Set the block where the image begins. It is usually 0, but may be different 
  * on a multisession disc.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_start_block(IsoReadOpts *opts, uint32_t block);
 
@@ -1087,16 +1199,22 @@ int iso_read_opts_set_start_block(IsoReadOpts *opts, uint32_t block);
  * Do not read Rock Ridge extensions. 
  * In most cases you don't want to use this. It could be useful if RR info
  * is damaged, or if you want to use the Joliet tree.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_no_rockridge(IsoReadOpts *opts, int norr);
 
 /**
  * Do not read Joliet extensions.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_no_joliet(IsoReadOpts *opts, int nojoliet);
 
 /**
  * Do not read ISO 9660:1999 enhanced tree
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_no_iso1999(IsoReadOpts *opts, int noiso1999);
 
@@ -1107,16 +1225,22 @@ int iso_read_opts_set_no_iso1999(IsoReadOpts *opts, int noiso1999);
  * note that this is not very recommended. This doesn't mean than RR 
  * extensions are not read: if no Joliet is present, libisofs will read
  * RR tree.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_preferjoliet(IsoReadOpts *opts, int preferjoliet);
 
 /**
  * Set default uid for files when RR extensions are not present.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_default_uid(IsoReadOpts *opts, uid_t uid);
 
 /**
  * Set default gid for files when RR extensions are not present.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_default_gid(IsoReadOpts *opts, gid_t gid);
 
@@ -1127,6 +1251,8 @@ int iso_read_opts_set_default_gid(IsoReadOpts *opts, gid_t gid);
  *      Permissions for files.
  * @param dir_perm
  *      Permissions for directories.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_default_permissions(IsoReadOpts *opts, mode_t file_perm,
                                           mode_t dir_perm);
@@ -1140,6 +1266,8 @@ int iso_read_opts_set_default_permissions(IsoReadOpts *opts, mode_t file_perm,
  * @param charset
  *      The charset to use as input charset.  You can obtain the list of
  *      charsets supported on your system executing "iconv -l" in a shell.
+ *
+ * @since 0.6.1
  */
 int iso_read_opts_set_input_charset(IsoReadOpts *opts, const char *charset);
 
@@ -1163,12 +1291,16 @@ int iso_read_opts_set_input_charset(IsoReadOpts *opts, const char *charset);
  *     no more needed. You can pass NULL if you're not interested on them.
  * @return
  *     1 on success, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_image_import(IsoImage *image, IsoDataSource *src, IsoReadOpts *opts,
                      struct iso_read_image_features **features);
 
 /**
  * Increments the reference counting of the given image.
+ *
+ * @since 0.6.1
  */
 void iso_image_ref(IsoImage *image);
 
@@ -1176,6 +1308,8 @@ void iso_image_ref(IsoImage *image);
  * Decrements the reference couting of the given image.
  * If it reaches 0, the image is free, together with its tree nodes (whether 
  * their refcount reach 0 too, of course).
+ *
+ * @since 0.6.1
  */
 void iso_image_unref(IsoImage *image);
 
@@ -1193,11 +1327,15 @@ void iso_image_unref(IsoImage *image);
  *      causes data to be free.
  * @return
  *      1 on succes, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_image_attach_data(IsoImage *image, void *data, void (*free)(void*));
 
 /**
  * The the data previously attached with iso_image_attach_data()
+ *
+ * @since 0.6.1
  */
 void *iso_image_get_attached_data(IsoImage *image);
 
@@ -1205,11 +1343,15 @@ void *iso_image_get_attached_data(IsoImage *image);
  * Get the root directory of the image.
  * No extra ref is added to it, so you musn't unref it. Use iso_node_ref()
  * if you want to get your own reference.
+ *
+ * @since 0.6.1
  */
 IsoDir *iso_image_get_root(const IsoImage *image);
 
 /**
  * Fill in the volset identifier for a image.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_volset_id(IsoImage *image, const char *volset_id);
 
@@ -1217,11 +1359,15 @@ void iso_image_set_volset_id(IsoImage *image, const char *volset_id);
  * Get the volset identifier. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_volset_id(const IsoImage *image);
 
 /**
  * Fill in the volume identifier for a image.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_volume_id(IsoImage *image, const char *volume_id);
 
@@ -1229,11 +1375,15 @@ void iso_image_set_volume_id(IsoImage *image, const char *volume_id);
  * Get the volume identifier. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_volume_id(const IsoImage *image);
 
 /**
  * Fill in the publisher for a image.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_publisher_id(IsoImage *image, const char *publisher_id);
 
@@ -1241,11 +1391,15 @@ void iso_image_set_publisher_id(IsoImage *image, const char *publisher_id);
  * Get the publisher of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_publisher_id(const IsoImage *image);
 
 /**
  * Fill in the data preparer for a image.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_data_preparer_id(IsoImage *image,
                                     const char *data_preparer_id);
@@ -1254,11 +1408,15 @@ void iso_image_set_data_preparer_id(IsoImage *image,
  * Get the data preparer of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_data_preparer_id(const IsoImage *image);
 
 /**
  * Fill in the system id for a image. Up to 32 characters.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_system_id(IsoImage *image, const char *system_id);
 
@@ -1266,11 +1424,15 @@ void iso_image_set_system_id(IsoImage *image, const char *system_id);
  * Get the system id of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_system_id(const IsoImage *image);
 
 /**
  * Fill in the application id for a image. Up to 128 chars.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_application_id(IsoImage *image, const char *application_id);
 
@@ -1278,12 +1440,16 @@ void iso_image_set_application_id(IsoImage *image, const char *application_id);
  * Get the application id of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_application_id(const IsoImage *image);
 
 /**
  * Fill copyright information for the image. Usually this refers
  * to a file on disc. Up to 37 characters.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_copyright_file_id(IsoImage *image,
                                      const char *copyright_file_id);
@@ -1292,12 +1458,16 @@ void iso_image_set_copyright_file_id(IsoImage *image,
  * Get the copyright information of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_copyright_file_id(const IsoImage *image);
 
 /**
  * Fill abstract information for the image. Usually this refers
  * to a file on disc. Up to 37 characters.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_abstract_file_id(IsoImage *image,
                                     const char *abstract_file_id);
@@ -1306,12 +1476,16 @@ void iso_image_set_abstract_file_id(IsoImage *image,
  * Get the abstract information of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_abstract_file_id(const IsoImage *image);
 
 /**
  * Fill biblio information for the image. Usually this refers
  * to a file on disc. Up to 37 characters.
+ *
+ * @since 0.6.1
  */
 void iso_image_set_biblio_file_id(IsoImage *image, const char *biblio_file_id);
 
@@ -1319,6 +1493,8 @@ void iso_image_set_biblio_file_id(IsoImage *image, const char *biblio_file_id);
  * Get the biblio information of a image. 
  * The returned string is owned by the image and should not be freed nor
  * changed.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_get_biblio_file_id(const IsoImage *image);
 
@@ -1357,6 +1533,8 @@ const char *iso_image_get_biblio_file_id(const IsoImage *image);
  *      reference to the boot image. 
  * @return 
  *      1 on success, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_image_set_boot_image(IsoImage *image, const char *image_path,
                              enum eltorito_boot_media_type type,
@@ -1397,6 +1575,8 @@ int iso_image_set_boot_image(IsoImage *image, const char *image_path,
  * @return
  *      1 on success, 0 is the image is not bootable (i.e., it has no El-Torito
  *      image), < 0 error.
+ *
+ * @since 0.6.1
  */
 int iso_image_get_boot_image(IsoImage *image, ElToritoBootImage **boot,
                              IsoFile **imgnode, IsoBoot **catnode);
@@ -1408,12 +1588,16 @@ int iso_image_get_boot_image(IsoImage *image, ElToritoBootImage **boot,
  * for the image tree, if there.
  * If the image is not bootable (don't have el-torito boot image) this function
  * just returns.
+ *
+ * @since 0.6.1
  */
 void iso_image_remove_boot_image(IsoImage *image);
 
 /**
  * Sets the load segment for the initial boot image. This is only for
  * no emulation boot images, and is a NOP for other image types.
+ *
+ * @since 0.6.1
  */
 void el_torito_set_load_seg(ElToritoBootImage *bootimg, short segment);
 
@@ -1421,11 +1605,15 @@ void el_torito_set_load_seg(ElToritoBootImage *bootimg, short segment);
  * Sets the number of sectors (512b) to be load at load segment during
  * the initial boot procedure. This is only for
  * no emulation boot images, and is a NOP for other image types.
+ *
+ * @since 0.6.1
  */
 void el_torito_set_load_size(ElToritoBootImage *bootimg, short sectors);
 
 /**
  * Marks the specified boot image as not bootable
+ *
+ * @since 0.6.1
  */
 void el_torito_set_no_bootable(ElToritoBootImage *bootimg);
 
@@ -1434,11 +1622,15 @@ void el_torito_set_no_bootable(ElToritoBootImage *bootimg);
  * of a 56 bytes boot information table at offset 8 of the boot image file.
  * The original boot image file won't be modified.
  * This is needed for isolinux boot images.
+ *
+ * @since 0.6.1
  */
 void el_torito_patch_isolinux_image(ElToritoBootImage *bootimg);
 
 /**
  * Increments the reference counting of the given node.
+ *
+ * @since 0.6.1
  */
 void iso_node_ref(IsoNode *node);
 
@@ -1446,11 +1638,15 @@ void iso_node_ref(IsoNode *node);
  * Decrements the reference couting of the given node.
  * If it reach 0, the node is free, and, if the node is a directory,
  * its children will be unref() too.
+ *
+ * @since 0.6.1
  */
 void iso_node_unref(IsoNode *node);
 
 /**
  * Get the type of an IsoNode.
+ *
+ * @since 0.6.1
  */
 enum IsoNodeType iso_node_get_type(IsoNode *node);
 
@@ -1467,6 +1663,8 @@ enum IsoNodeType iso_node_get_type(IsoNode *node);
  *      node name is not modified.
  * @return 
  *      1 on success, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_node_set_name(IsoNode *node, const char *name);
 
@@ -1474,6 +1672,8 @@ int iso_node_set_name(IsoNode *node, const char *name);
  * Get the name of a node.
  * The returned string belongs to the node and should not be modified nor
  * freed. Use strdup if you really need your own copy.
+ *
+ * @since 0.6.1
  */
 const char *iso_node_get_name(const IsoNode *node);
 
@@ -1485,69 +1685,95 @@ const char *iso_node_get_name(const IsoNode *node);
  *     bitmask with the permissions of the node, as specified in 'man 2 stat'.
  *     The file type bitfields will be ignored, only file permissions will be
  *     modified.
+ *
+ * @since 0.6.1
  */
 void iso_node_set_permissions(IsoNode *node, mode_t mode);
 
 /** 
  * Get the permissions for the node 
+ *
+ * @since 0.6.1
  */
 mode_t iso_node_get_permissions(const IsoNode *node);
 
 /** 
  * Get the mode of the node, both permissions and file type, as specified in
  * 'man 2 stat'.
+ *
+ * @since 0.6.1
  */
 mode_t iso_node_get_mode(const IsoNode *node);
 
 /**
  * Set the user id for the node. This attribute is only useful when 
  * Rock Ridge extensions are enabled.
+ *
+ * @since 0.6.1
  */
 void iso_node_set_uid(IsoNode *node, uid_t uid);
 
 /**
  * Get the user id of the node.
+ *
+ * @since 0.6.1
  */
 uid_t iso_node_get_uid(const IsoNode *node);
 
 /**
  * Set the group id for the node. This attribute is only useful when 
  * Rock Ridge extensions are enabled.
+ *
+ * @since 0.6.1
  */
 void iso_node_set_gid(IsoNode *node, gid_t gid);
 
 /**
  * Get the group id of the node.
+ *
+ * @since 0.6.1
  */
 gid_t iso_node_get_gid(const IsoNode *node);
 
 /** 
  * Set the time of last modification of the file
+ *
+ * @since 0.6.1
  */
 void iso_node_set_mtime(IsoNode *node, time_t time);
 
 /** 
  * Get the time of last modification of the file
+ *
+ * @since 0.6.1
  */
 time_t iso_node_get_mtime(const IsoNode *node);
 
 /** 
  * Set the time of last access to the file
+ *
+ * @since 0.6.1
  */
 void iso_node_set_atime(IsoNode *node, time_t time);
 
 /** 
  * Get the time of last access to the file 
+ *
+ * @since 0.6.1
  */
 time_t iso_node_get_atime(const IsoNode *node);
 
 /** 
  * Set the time of last status change of the file 
+ *
+ * @since 0.6.1
  */
 void iso_node_set_ctime(IsoNode *node, time_t time);
 
 /** 
  * Get the time of last status change of the file 
+ *
+ * @since 0.6.1
  */
 time_t iso_node_get_ctime(const IsoNode *node);
 
@@ -1567,6 +1793,8 @@ time_t iso_node_get_ctime(const IsoNode *node);
  *      The node that is to be hidden.
  * @param hide_attrs 
  *      IsoHideNodeFlag's to set the trees in which file will be hidden.
+ *
+ * @since 0.6.1
  */
 void iso_node_set_hidden(IsoNode *node, int hide_attrs);
 
@@ -1593,6 +1821,8 @@ void iso_node_set_hidden(IsoNode *node, int hide_attrs);
  *         ISO_NODE_ALREADY_ADDED, if child is already added to other dir 
  *         ISO_NODE_NAME_NOT_UNIQUE, a node with same name already exists
  *         ISO_WRONG_ARG_VALUE, if child == dir, or replace != (0,1)
+ *
+ * @since 0.6.1
  */
 int iso_dir_add_node(IsoDir *dir, IsoNode *child,
                      enum iso_replace_mode replace);
@@ -1615,6 +1845,8 @@ int iso_dir_add_node(IsoDir *dir, IsoNode *child,
  *     1 node found, 0 child has no such node, < 0 error
  *     Possible errors:
  *         ISO_NULL_POINTER, if dir or name are NULL
+ *
+ * @since 0.6.1
  */
 int iso_dir_get_node(IsoDir *dir, const char *name, IsoNode **node);
 
@@ -1625,6 +1857,8 @@ int iso_dir_get_node(IsoDir *dir, const char *name, IsoNode **node);
  *     >= 0 number of items, < 0 error
  *     Possible errors:
  *         ISO_NULL_POINTER, if dir is NULL
+ *
+ * @since 0.6.1
  */
 int iso_dir_get_nchildren(IsoDir *dir);
 
@@ -1639,6 +1873,8 @@ int iso_dir_get_nchildren(IsoDir *dir);
  *     Possible errors:
  *         ISO_NULL_POINTER, if node is NULL
  *         ISO_NODE_NOT_ADDED_TO_DIR, if node doesn't belong to a dir
+ *
+ * @since 0.6.1
  */
 int iso_node_take(IsoNode *node);
 
@@ -1650,6 +1886,8 @@ int iso_node_take(IsoNode *node);
  * 
  * @return 
  *     1 on success, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_node_remove(IsoNode *node);
 
@@ -1662,6 +1900,8 @@ int iso_node_remove(IsoNode *node);
  * 
  * This returns NULL if the node doesn't pertain to any tree 
  * (it was removed/take).
+ *
+ * @since 0.6.1
  */
 IsoDir *iso_node_get_parent(IsoNode *node);
 
@@ -1695,6 +1935,8 @@ IsoDir *iso_node_get_parent(IsoNode *node);
  *     Possible errors:
  *         ISO_NULL_POINTER, if dir or iter are NULL
  *         ISO_OUT_OF_MEM
+ *
+ * @since 0.6.1
  */
 int iso_dir_get_children(const IsoDir *dir, IsoDirIter **iter);
 
@@ -1710,6 +1952,8 @@ int iso_dir_get_children(const IsoDir *dir, IsoDirIter **iter);
  *         ISO_NULL_POINTER, if node or iter are NULL
  *         ISO_ERROR, on wrong iter usage, usual caused by modiying the
  *         dir during iteration
+ *
+ * @since 0.6.1
  */
 int iso_dir_iter_next(IsoDirIter *iter, IsoNode **node);
 
@@ -1720,11 +1964,15 @@ int iso_dir_iter_next(IsoDirIter *iter, IsoNode **node);
  *     1 dir has more elements, 0 no, < 0 error
  *     Possible errors:
  *         ISO_NULL_POINTER, if iter is NULL
+ *
+ * @since 0.6.1
  */
 int iso_dir_iter_has_next(IsoDirIter *iter);
 
 /** 
  * Free a dir iterator.
+ *
+ * @since 0.6.1
  */
 void iso_dir_iter_free(IsoDirIter *iter);
 
@@ -1742,6 +1990,8 @@ void iso_dir_iter_free(IsoDirIter *iter);
  *         ISO_NULL_POINTER, if iter is NULL
  *         ISO_ERROR, on wrong iter usage, for example by call this before
  *         iso_dir_iter_next.
+ *
+ * @since 0.6.1
  */
 int iso_dir_iter_take(IsoDirIter *iter);
 
@@ -1759,6 +2009,8 @@ int iso_dir_iter_take(IsoDirIter *iter);
  *         ISO_NULL_POINTER, if iter is NULL
  *         ISO_ERROR, on wrong iter usage, for example by call this before
  *         iso_dir_iter_next.
+ *
+ * @since 0.6.1
  */
 int iso_dir_iter_remove(IsoDirIter *iter);
 
@@ -1766,6 +2018,8 @@ int iso_dir_iter_remove(IsoDirIter *iter);
  * Get the destination of a node.
  * The returned string belongs to the node and should not be modified nor
  * freed. Use strdup if you really need your own copy.
+ *
+ * @since 0.6.1
  */
 const char *iso_symlink_get_dest(const IsoSymlink *link);
 
@@ -1777,6 +2031,8 @@ const char *iso_symlink_get_dest(const IsoSymlink *link);
  *     this function doesn't modify previous destination.
  * @return
  *     1 on success, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_symlink_set_dest(IsoSymlink *link, const char *dest);
 
@@ -1791,16 +2047,22 @@ int iso_symlink_set_dest(IsoSymlink *link, const char *dest);
  * @param w 
  *      The weight as a integer number, the greater this value is, the 
  *      closer from the begining of image the file will be written.
+ *
+ * @since 0.6.1
  */
 void iso_node_set_sort_weight(IsoNode *node, int w);
 
 /**
  * Get the sort weight of a file.
+ *
+ * @since 0.6.1
  */
 int iso_file_get_sort_weight(IsoFile *file);
 
 /** 
  * Get the size of the file, in bytes 
+ *
+ * @since 0.6.1
  */
 off_t iso_file_get_size(IsoFile *file);
 
@@ -1824,6 +2086,8 @@ off_t iso_file_get_size(IsoFile *file);
  *         ISO_NULL_POINTER, if parent or name are NULL
  *         ISO_NODE_NAME_NOT_UNIQUE, a node with same name already exists
  *         ISO_MEM_ERROR
+ *
+ * @since 0.6.1
  */
 int iso_tree_add_new_dir(IsoDir *parent, const char *name, IsoDir **dir);
 
@@ -1855,6 +2119,8 @@ int iso_tree_add_new_dir(IsoDir *parent, const char *name, IsoDir **dir);
  *         ISO_NULL_POINTER, if parent, name or dest are NULL
  *         ISO_NODE_NAME_NOT_UNIQUE, a node with same name already exists
  *         ISO_MEM_ERROR
+ *
+ * @since 0.6.1
  */
 int iso_tree_add_new_symlink(IsoDir *parent, const char *name,
                              const char *dest, IsoSymlink **link);
@@ -1896,6 +2162,8 @@ int iso_tree_add_new_symlink(IsoDir *parent, const char *name,
  *         ISO_NODE_NAME_NOT_UNIQUE, a node with same name already exists
  *         ISO_WRONG_ARG_VALUE if you select a incorrect mode
  *         ISO_MEM_ERROR
+ *
+ * @since 0.6.1
  */
 int iso_tree_add_new_special(IsoDir *parent, const char *name, mode_t mode,
                              dev_t dev, IsoSpecial **special);
@@ -1903,6 +2171,8 @@ int iso_tree_add_new_special(IsoDir *parent, const char *name, mode_t mode,
 /**
  * Set whether to follow or not symbolic links when added a file from a source
  * to IsoImage. Default behavior is to not follow symlinks.
+ *
+ * @since 0.6.1
  */
 void iso_tree_set_follow_symlinks(IsoImage *image, int follow);
 
@@ -1910,12 +2180,15 @@ void iso_tree_set_follow_symlinks(IsoImage *image, int follow);
  * Get current setting for follow_symlinks.
  * 
  * @see iso_tree_set_follow_symlinks
+ * @since 0.6.1
  */
 int iso_tree_get_follow_symlinks(IsoImage *image);
 
 /**
  * Set whether to skip or not hidden files when adding a directory recursibely.
  * Default behavior is to not ignore them, i.e., to add hidden files to image.
+ *
+ * @since 0.6.1
  */
 void iso_tree_set_ignore_hidden(IsoImage *image, int skip);
 
@@ -1923,6 +2196,7 @@ void iso_tree_set_ignore_hidden(IsoImage *image, int skip);
  * Get current setting for ignore_hidden.
  * 
  * @see iso_tree_set_ignore_hidden
+ * @since 0.6.1
  */
 int iso_tree_get_ignore_hidden(IsoImage *image);
 
@@ -1930,6 +2204,8 @@ int iso_tree_get_ignore_hidden(IsoImage *image);
  * Set the replace mode, that defines the behavior of libisofs when adding
  * a node whit the same name that an existent one, during a recursive 
  * directory addition.
+ *
+ * @since 0.6.1
  */
 void iso_tree_set_replace_mode(IsoImage *image, enum iso_replace_mode mode);
 
@@ -1937,6 +2213,7 @@ void iso_tree_set_replace_mode(IsoImage *image, enum iso_replace_mode mode);
  * Get current setting for replace_mode.
  * 
  * @see iso_tree_set_replace_mode
+ * @since 0.6.1
  */
 enum iso_replace_mode iso_tree_get_replace_mode(IsoImage *image);
 
@@ -1951,6 +2228,8 @@ enum iso_replace_mode iso_tree_get_replace_mode(IsoImage *image);
  *          bit1: ignore Sockets
  *          bit2: ignore char devices
  *          bit3: ignore block devices
+ *
+ * @since 0.6.1
  */
 void iso_tree_set_ignore_special(IsoImage *image, int skip);
 
@@ -1958,6 +2237,7 @@ void iso_tree_set_ignore_special(IsoImage *image, int skip);
  * Get current setting for ignore_special.
  * 
  * @see iso_tree_set_ignore_special
+ * @since 0.6.1
  */
 int iso_tree_get_ignore_special(IsoImage *image);
 
@@ -2008,6 +2288,8 @@ int iso_tree_get_ignore_special(IsoImage *image);
  * 
  * @return
  *      1 on success, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_tree_add_exclude(IsoImage *image, const char *path);
 
@@ -2017,6 +2299,8 @@ int iso_tree_add_exclude(IsoImage *image, const char *path);
  * @see iso_tree_add_exclude
  * @return
  *      1 on success, 0 exclude do not exists, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_tree_remove_exclude(IsoImage *image, const char *path);
 
@@ -2032,6 +2316,8 @@ int iso_tree_remove_exclude(IsoImage *image, const char *path);
  *      This function should return 1 to add the file, 0 to ignore it and 
  *      continue, < 0 to abort the process
  *      NULL is allowed if you don't want any callback.
+ *
+ * @since 0.6.1
  */
 void iso_tree_set_report_callback(IsoImage *image, 
                                   int (*report)(IsoImage*, IsoFileSource*));
@@ -2061,6 +2347,8 @@ void iso_tree_set_report_callback(IsoImage *image,
  *         ISO_NULL_POINTER, if image, parent or path are NULL
  *         ISO_NODE_NAME_NOT_UNIQUE, a node with same name already exists
  *         ISO_MEM_ERROR
+ *
+ * @since 0.6.1
  */
 int iso_tree_add_node(IsoImage *image, IsoDir *parent, const char *path,
                       IsoNode **node);
@@ -2082,6 +2370,8 @@ int iso_tree_add_node(IsoImage *image, IsoDir *parent, const char *path,
  *      Path to a dir in the filesystem
  * @return 
  *     number of nodes in parent if success, < 0 otherwise
+ *
+ * @since 0.6.1
  */
 int iso_tree_add_dir_rec(IsoImage *image, IsoDir *parent, const char *dir);
 
@@ -2097,17 +2387,23 @@ int iso_tree_add_dir_rec(IsoImage *image, IsoDir *parent, const char *dir);
  *     if a node with such path really exists.
  * @return
  *      1 found, 0 not found, < 0 error
+ *
+ * @since 0.6.1
  */
 int iso_tree_path_to_node(IsoImage *image, const char *path, IsoNode **node);
 
 /**
  * Increments the reference counting of the given IsoDataSource.
+ *
+ * @since 0.6.1
  */
 void iso_data_source_ref(IsoDataSource *src);
 
 /**
  * Decrements the reference counting of the given IsoDataSource, freeing it
  * if refcount reach 0.
+ *
+ * @since 0.6.1
  */
 void iso_data_source_unref(IsoDataSource *src);
 
@@ -2122,6 +2418,8 @@ void iso_data_source_unref(IsoDataSource *src);
  *     Will be filled with the pointer to the newly created data source.
  * @return
  *    1 on success, < 0 on error.
+ *
+ * @since 0.6.1
  */
 int iso_data_source_new_from_file(const char *path, IsoDataSource **src);
 
@@ -2143,6 +2441,8 @@ int iso_data_source_new_from_file(const char *path, IsoDataSource **src);
  *           5="abandoned" : consumption has ended prematurely
  *           6="ended"     : consumption has ended without input error
  *           7="aborted"   : consumption has ended after input error
+ *
+ * @since 0.6.1
  */
 int iso_ring_buffer_get_status(struct burn_source *b, size_t *size,
                                size_t *free_bytes);
@@ -2161,6 +2461,8 @@ int iso_ring_buffer_get_status(struct burn_source *b, size_t *size,
  *                       to stderr.
  * @param print_id       A text prefix to be printed before the message.
  * @return               >0 for success, <=0 for error
+ *
+ * @since 0.6.1
  */
 int iso_set_msgs_severities(char *queue_severity, char *print_severity,
                             char *print_id);
@@ -2185,6 +2487,8 @@ int iso_set_msgs_severities(char *queue_severity, char *print_severity,
  *     least 80 bytes.
  * @return 
  *     1 if a matching item was found, 0 if not, <0 for severe errors
+ *
+ * @since 0.6.1
  */
 int iso_obtain_msgs(char *minimum_severity, int *error_code, int *imgid,
                     char msg_text[], char severity[]);
@@ -2193,11 +2497,15 @@ int iso_obtain_msgs(char *minimum_severity, int *error_code, int *imgid,
  * Get the id of an IsoImage, used for message reporting. This message id,
  * retrieved with iso_obtain_msgs(), can be used to distinguish what
  * IsoImage has isssued a given message.
+ *
+ * @since 0.6.1
  */
 int iso_image_get_msg_id(IsoImage *image);
 
 /**
  * Get a textual description of a libisofs error.
+ *
+ * @since 0.6.1
  */
 const char *iso_error_to_msg(int errcode);
 
@@ -2211,6 +2519,8 @@ const char *iso_error_to_msg(int errcode);
  *      NOTE won't never cause function abort.
  * @return 
  *      Previous abort priority on success, < 0 on error. 
+ *
+ * @since 0.6.1
  */
 int iso_set_abort_severity(char *severity);
 
@@ -2221,17 +2531,23 @@ int iso_set_abort_severity(char *severity);
  * message queue. See also: libburn, API function burn_set_messenger().
  * 
  * @return the handle. Do only use with compatible
+ *
+ * @since 0.6.1
  */
 void *iso_get_messenger();
 
 /**
  * Take a ref to the given IsoFileSource.
+ *
+ * @since 0.6.1
  */
 void iso_file_source_ref(IsoFileSource *src);
 
 /**
  * Drop your ref to the given IsoFileSource, eventually freeing the associated
  * system resources.
+ *
+ * @since 0.6.1
  */
 void iso_file_source_unref(IsoFileSource *src);
 
@@ -2246,6 +2562,8 @@ void iso_file_source_unref(IsoFileSource *src);
  * @return
  *     the path of the FileSource inside the filesystem, it should be 
  *     freed when no more needed.
+ *
+ * @since 0.6.1
  */
 char* iso_file_source_get_path(IsoFileSource *src);
 
@@ -2254,6 +2572,8 @@ char* iso_file_source_get_path(IsoFileSource *src);
  * 
  * @return
  *     the name of the file, it should be freed when no more needed.
+ *
+ * @since 0.6.1
  */
 char* iso_file_source_get_name(IsoFileSource *src);
 
@@ -2268,6 +2588,8 @@ char* iso_file_source_get_name(IsoFileSource *src);
  *         ISO_MEM_ERROR
  *         ISO_FILE_ERROR
  *         ISO_NULL_POINTER
+ *
+ * @since 0.6.1
  */
 int iso_file_source_lstat(IsoFileSource *src, struct stat *info);
 
@@ -2288,6 +2610,8 @@ int iso_file_source_lstat(IsoFileSource *src, struct stat *info);
  *         ISO_MEM_ERROR
  *         ISO_FILE_ERROR
  *         ISO_NULL_POINTER
+ *
+ * @since 0.6.1
  */
 int iso_file_source_access(IsoFileSource *src);
 
@@ -2304,6 +2628,8 @@ int iso_file_source_access(IsoFileSource *src);
  *         ISO_MEM_ERROR
  *         ISO_FILE_ERROR
  *         ISO_NULL_POINTER
+ *
+ * @since 0.6.1
  */
 int iso_file_source_stat(IsoFileSource *src, struct stat *info);
 
@@ -2318,6 +2644,8 @@ int iso_file_source_stat(IsoFileSource *src, struct stat *info);
  *         ISO_MEM_ERROR
  *         ISO_FILE_ERROR
  *         ISO_NULL_POINTER
+ *
+ * @since 0.6.1
  */
 int iso_file_source_open(IsoFileSource *src);
 
@@ -2328,6 +2656,8 @@ int iso_file_source_open(IsoFileSource *src);
  *         ISO_FILE_ERROR
  *         ISO_NULL_POINTER
  *         ISO_FILE_NOT_OPENNED
+ *
+ * @since 0.6.1
  */
 int iso_file_source_close(IsoFileSource *src);
 
@@ -2356,6 +2686,8 @@ int iso_file_source_close(IsoFileSource *src);
  *         ISO_FILE_IS_DIR
  *         ISO_MEM_ERROR
  *         ISO_INTERRUPTED
+ *
+ * @since 0.6.1
  */
 int iso_file_source_read(IsoFileSource *src, void *buf, size_t count);
 
@@ -2380,6 +2712,8 @@ int iso_file_source_read(IsoFileSource *src, void *buf, size_t count);
  *         ISO_FILE_NOT_OPENNED
  *         ISO_FILE_IS_NOT_DIR
  *         ISO_MEM_ERROR
+ *
+ * @since 0.6.1
  */
 int iso_file_source_readdir(IsoFileSource *src, IsoFileSource **child);
 
@@ -2405,7 +2739,8 @@ int iso_file_source_readdir(IsoFileSource *src, IsoFileSource **child);
  *         ISO_MEM_ERROR
  *         ISO_FILE_BAD_PATH
  *         ISO_FILE_DOESNT_EXIST
- * 
+ *
+ * @since 0.6.1
  */
 int iso_file_source_readlink(IsoFileSource *src, char *buf, size_t bufsiz);
 
@@ -2415,17 +2750,23 @@ int iso_file_source_readlink(IsoFileSource *src, char *buf, size_t bufsiz);
  * 
  * @return
  *     The filesystem, NULL on error
+ *
+ * @since 0.6.1
  */
 IsoFilesystem* iso_file_source_get_filesystem(IsoFileSource *src);
 
 /**
  * Take a ref to the given IsoFilesystem
+ *
+ * @since 0.6.1
  */
 void iso_filesystem_ref(IsoFilesystem *fs);
 
 /**
  * Drop your ref to the given IsoFilesystem, evetually freeing associated 
  * resources.
+ *
+ * @since 0.6.1
  */
 void iso_filesystem_unref(IsoFilesystem *fs);
 
@@ -2446,6 +2787,8 @@ void iso_filesystem_unref(IsoFilesystem *fs);
  *      to access image contents.
  * @param
  *      1 on success, < 0 on error
+ *
+ * @since 0.6.1
  */
 int iso_image_filesystem_new(IsoDataSource *src, IsoReadOpts *opts, int msgid,
                              IsoImageFilesystem **fs);
@@ -2453,54 +2796,72 @@ int iso_image_filesystem_new(IsoDataSource *src, IsoReadOpts *opts, int msgid,
 /**
  * Get the volset identifier for an existent image. The returned string belong
  * to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_volset_id(IsoImageFilesystem *fs);
 
 /**
  * Get the volume identifier for an existent image. The returned string belong
  * to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_volume_id(IsoImageFilesystem *fs);
 
 /**
  * Get the publisher identifier for an existent image. The returned string 
  * belong to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_publisher_id(IsoImageFilesystem *fs);
 
 /**
  * Get the data preparer identifier for an existent image. The returned string 
  * belong to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_data_preparer_id(IsoImageFilesystem *fs);
 
 /**
  * Get the system identifier for an existent image. The returned string belong
  * to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_system_id(IsoImageFilesystem *fs);
 
 /**
  * Get the application identifier for an existent image. The returned string 
  * belong to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_application_id(IsoImageFilesystem *fs);
 
 /**
  * Get the copyright file identifier for an existent image. The returned string
  * belong to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_copyright_file_id(IsoImageFilesystem *fs);
 
 /**
  * Get the abstract file identifier for an existent image. The returned string
  * belong to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_abstract_file_id(IsoImageFilesystem *fs);
 
 /**
  * Get the biblio file identifier for an existent image. The returned string 
  * belong to the IsoImageFilesystem and shouldn't be free() nor modified.
+ *
+ * @since 0.6.1
  */
 const char *iso_image_fs_get_biblio_file_id(IsoImageFilesystem *fs);