diff options
author | Christophe Fergeau <teuf@gnome.org> | 2006-04-10 18:17:25 +0000 |
---|---|---|
committer | Christophe Fergeau <teuf@gnome.org> | 2006-04-10 18:17:25 +0000 |
commit | 8253fd6df9473f1e230733d57761652327397fff (patch) | |
tree | 5129c69fdbd110e8c536ce0fc4082b4b1a90dbe1 /docs | |
parent | 08de30de7733b07a17eed911ca1d4f02b030ad42 (diff) | |
download | libgpod-8253fd6df9473f1e230733d57761652327397fff.tar.gz libgpod-8253fd6df9473f1e230733d57761652327397fff.tar.xz libgpod-8253fd6df9473f1e230733d57761652327397fff.zip |
* docs/Makefile.am:
* docs/reference/Makefile.am:
* docs/reference/libgpod-docs.xml:
* docs/reference/libgpod-sections.txt:
* docs/reference/tmpl/Internal.sgml:
* docs/reference/tmpl/artwork.sgml:
* docs/reference/tmpl/device.sgml:
* docs/reference/tmpl/itunesdb-copying.sgml:
* docs/reference/tmpl/itunesdb-db.sgml:
* docs/reference/tmpl/itunesdb-lowlevel.sgml:
* docs/reference/tmpl/itunesdb-time.sgml:
* docs/reference/tmpl/libgpod-unused.sgml:
* docs/reference/tmpl/playlists.sgml:
* docs/reference/tmpl/smart-playlists.sgml:
* docs/reference/tmpl/track.sgml:
* docs/reference/version.xml.in: all the files below are new files
needed for gtk-doc support
* Makefile.am:
* configure.ac: add gtk-doc support to build system
* src/itdb_artwork.c:
* src/itdb_device.c:
* src/itdb_itunesdb.c:
* src/itdb_playlist.c:
* src/itdb_track.c: update inline comments in those files so that
gtk-doc can pick them up to build documentation
git-svn-id: https://gtkpod.svn.sf.net/svnroot/gtkpod/libgpod/trunk@1243 f01d2545-417e-4e96-918e-98f8d0dbbcb6
Diffstat (limited to 'docs')
-rw-r--r-- | docs/Makefile.am | 1 | ||||
-rw-r--r-- | docs/reference/Makefile.am | 78 | ||||
-rw-r--r-- | docs/reference/libgpod-docs.xml | 75 | ||||
-rw-r--r-- | docs/reference/libgpod-sections.txt | 266 | ||||
-rw-r--r-- | docs/reference/tmpl/Internal.sgml | 19 | ||||
-rw-r--r-- | docs/reference/tmpl/artwork.sgml | 160 | ||||
-rw-r--r-- | docs/reference/tmpl/device.sgml | 129 | ||||
-rw-r--r-- | docs/reference/tmpl/itunesdb-copying.sgml | 74 | ||||
-rw-r--r-- | docs/reference/tmpl/itunesdb-db.sgml | 133 | ||||
-rw-r--r-- | docs/reference/tmpl/itunesdb-lowlevel.sgml | 164 | ||||
-rw-r--r-- | docs/reference/tmpl/itunesdb-time.sgml | 45 | ||||
-rw-r--r-- | docs/reference/tmpl/libgpod-unused.sgml | 126 | ||||
-rw-r--r-- | docs/reference/tmpl/playlists.sgml | 287 | ||||
-rw-r--r-- | docs/reference/tmpl/smart-playlists.sgml | 269 | ||||
-rw-r--r-- | docs/reference/tmpl/track.sgml | 232 | ||||
-rw-r--r-- | docs/reference/version.xml.in | 4 |
16 files changed, 2062 insertions, 0 deletions
diff --git a/docs/Makefile.am b/docs/Makefile.am new file mode 100644 index 0000000..b68c774 --- /dev/null +++ b/docs/Makefile.am @@ -0,0 +1 @@ +SUBDIRS=reference diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am new file mode 100644 index 0000000..138d70a --- /dev/null +++ b/docs/reference/Makefile.am @@ -0,0 +1,78 @@ +## Process this file with automake to produce Makefile.in + +# We require automake 1.6 at least. +AUTOMAKE_OPTIONS = 1.6 + +# This is a blank Makefile.am for using gtk-doc. +# Copy this to your project's API docs directory and modify the variables to +# suit your project. See the GTK+ Makefiles in gtk+/docs/reference for examples +# of using the various options. + +# The name of the module, e.g. 'glib'. +DOC_MODULE=libgpod + +# The top-level SGML file. You can change this if you want to. +DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.xml + +# The directory containing the source code. Relative to $(srcdir). +# gtk-doc will search all .c & .h files beneath here for inline comments +# documenting the functions and macros. +# e.g. DOC_SOURCE_DIR=../../../gtk +DOC_SOURCE_DIR=../../src + +# Extra options to pass to gtkdoc-scangobj. Not normally needed. +SCANGOBJ_OPTIONS= + +# Extra options to supply to gtkdoc-scan. +# e.g. SCAN_OPTIONS=--deprecated-guards="GTK_DISABLE_DEPRECATED" +SCAN_OPTIONS= + +# Extra options to supply to gtkdoc-mkdb. +# e.g. MKDB_OPTIONS=--sgml-mode --output-format=xml +MKDB_OPTIONS=--sgml-mode --output-format=xml + +# Extra options to supply to gtkdoc-mktmpl +# e.g. MKTMPL_OPTIONS=--only-section-tmpl +MKTMPL_OPTIONS= + +# Extra options to supply to gtkdoc-fixref. Not normally needed. +# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html +FIXXREF_OPTIONS= + +# Used for dependencies. The docs will be rebuilt if any of these change. +# e.g. HFILE_GLOB=$(top_srcdir)/gtk/*.h +# e.g. CFILE_GLOB=$(top_srcdir)/gtk/*.c +HFILE_GLOB=$(top_srcdir)/src/*.h +CFILE_GLOB=$(top_srcdir)/src/*.c + +# Header files to ignore when scanning. +# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h +IGNORE_HFILES= + +# Images to copy into HTML directory. +# e.g. HTML_IMAGES=$(top_srcdir)/gtk/stock-icons/stock_about_24.png +HTML_IMAGES= + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE). +# e.g. content_files=running.sgml building.sgml changes-2.0.sgml +content_files= + +# SGML files where gtk-doc abbrevations (#GtkWidget) are expanded +# These files must be listed here *and* in content_files +# e.g. expand_content_files=running.sgml +expand_content_files= + +# CFLAGS and LDFLAGS for compiling gtkdoc-scangobj with your library. +# Only needed if you are using gtkdoc-scangobj to dynamically query widget +# signals and properties. +# e.g. INCLUDES=-I$(top_srcdir) -I$(top_builddir) $(GTK_DEBUG_FLAGS) +# e.g. GTKDOC_LIBS=$(top_builddir)/gtk/$(gtktargetlib) +INCLUDES= +GTKDOC_LIBS= + +# This includes the standard gtk-doc make rules, copied by gtkdocize. +include $(top_srcdir)/gtk-doc.make + +# Other files to distribute +# e.g. EXTRA_DIST += version.xml.in +EXTRA_DIST += diff --git a/docs/reference/libgpod-docs.xml b/docs/reference/libgpod-docs.xml new file mode 100644 index 0000000..facff7b --- /dev/null +++ b/docs/reference/libgpod-docs.xml @@ -0,0 +1,75 @@ +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude"> + <bookinfo> + <title>libgpod Reference Manual</title> + <releaseinfo>for libgpod <xi:include href="version.xml"/></releaseinfo> + <authorgroup> + <author> + <firstname>Jorg</firstname> + <surname>Schuler</surname> + <affiliation> + <address> + <email>jorg.schuler@gmx.de</email> + </address> + </affiliation> + </author> + <author> + <firstname>Christophe</firstname> + <surname>Fergeau</surname> + <affiliation> + <address> + <email>teuf@gnome.org</email> + </address> + </affiliation> + </author> + </authorgroup> + <copyright> + <year>2006</year> + <holder>Christophe Fergeau</holder> + </copyright> + + <legalnotice> + <para>Permission is granted to copy, distribute and/or modify + this document under the terms of the <citetitle>GNU Free + Documentation License</citetitle>, Version 1.1 or any later + version published by the Free Software Foundation with no + Invariant Sections, no Front-Cover Texts, and no Back-Cover + Texts. You may obtain a copy of the <citetitle>GNU Free + Documentation License</citetitle> from the Free Software + Foundation by visiting <ulink type="http" + url="http://www.fsf.org">their Web site</ulink> or by writing + to: Free Software Foundation, Inc., 59 Temple Place - Suite 330, + Boston, MA 02111-1307, USA.</para> + + <para>Many of the names used by companies to distinguish their + products and services are claimed as trademarks. Where those + names appear in any GNOME documentation, and those trademarks + are made aware to the members of the GNOME Documentation + Project, the names have been printed in caps or initial + caps.</para> + </legalnotice> + + <abstract> + <para>This manual documents the interfaces of the libgpod + library and has some short notes to help get you up to speed + with using the library.</para> + </abstract> + </bookinfo> + + <chapter> + <title>iPod database</title> + <xi:include href="xml/itunesdb-db.xml"/> + <xi:include href="xml/itunesdb-copying.xml"/> + <xi:include href="xml/itunesdb-time.xml"/> + <xi:include href="xml/itunesdb-lowlevel.xml"/> + </chapter> + <chapter> + <title>iPod database components</title> + <xi:include href="xml/track.xml"/> + <xi:include href="xml/playlists.xml"/> + <xi:include href="xml/artwork.xml"/> + <xi:include href="xml/device.xml"/> + </chapter> +</book> diff --git a/docs/reference/libgpod-sections.txt b/docs/reference/libgpod-sections.txt new file mode 100644 index 0000000..676f4d6 --- /dev/null +++ b/docs/reference/libgpod-sections.txt @@ -0,0 +1,266 @@ +<SECTION> +<FILE>itunesdb-db</FILE> +<TITLE>The Itdb_iTunesDB structure</TITLE> +Itdb_iTunesDB +ItdbUserDataDestroyFunc +ItdbUserDataDuplicateFunc + +itdb_new +itdb_free +itdb_parse +itdb_write +itdb_set_mountpoint +itdb_get_mountpoint + +itdb_tracks_number +itdb_tracks_number_nontransferred +itdb_playlists_number +</SECTION> + +<SECTION> +<FILE>itunesdb-copying</FILE> +<TITLE>File handling functions</TITLE> +itdb_cp_track_to_ipod +itdb_filename_fs2ipod +itdb_filename_ipod2fs +itdb_filename_on_ipod +itdb_musicdirs_number +itdb_rename_files +</SECTION> + +<SECTION> +<FILE>itunesdb-lowlevel</FILE> +<TITLE>Low-level functions</TITLE> +itdb_get_control_dir +itdb_get_itunes_dir +itdb_get_music_dir +itdb_get_artwork_dir +itdb_get_device_dir +itdb_get_itunesdb_path +itdb_get_artworkdb_path +itdb_get_path + +itdb_resolve_path +itdb_shuffle_write +itdb_shuffle_write_file +itdb_cp +itdb_parse_file +itdb_write_file +itdb_duplicate +</SECTION> + +<SECTION> +<FILE>itunesdb-time</FILE> +<TITLE>Time handling</TITLE> +itdb_time_get_mac_time +itdb_time_mac_to_host +itdb_time_host_to_mac +</SECTION> + +<SECTION> +<FILE>track</FILE> +<TITLE>Tracks</TITLE> +Itdb_Track +itdb_track_new +itdb_track_free +itdb_track_add +itdb_track_remove +itdb_track_unlink +itdb_track_duplicate +itdb_track_by_id +itdb_track_id_tree_create +itdb_track_id_tree_destroy +itdb_track_id_tree_by_id +itdb_track_set_thumbnails +itdb_track_remove_thumbnails +ITDB_RATING_STEP +</SECTION> + + +<SECTION> +<FILE>playlists</FILE> +<TITLE>Playlists</TITLE> +Itdb_Playlist +ItdbPlaylistSortOrder +itdb_playlist_new +itdb_playlist_free +itdb_playlist_duplicate +itdb_playlist_add +itdb_playlist_move +itdb_playlist_remove +itdb_playlist_unlink + +itdb_playlist_add_track +itdb_playlist_remove_track +itdb_playlist_contains_track +itdb_playlist_contain_track_number +itdb_playlist_tracks_number + +itdb_playlist_mpl +itdb_playlist_is_mpl +itdb_playlist_set_mpl +itdb_playlist_podcasts +itdb_playlist_is_podcasts +itdb_playlist_set_podcasts +itdb_playlist_exists +itdb_playlist_by_id +itdb_playlist_by_nr +itdb_playlist_by_name + +itdb_playlist_randomize +</SECTION> + +<SECTION> +<FILE>smart-playlists</FILE> +<TITLE>Smart Playlists</TITLE> +SPLPref +SPLRule +SPLRules +SPLAction +SPLFieldType +SPLActionType +SPLField +SPLDATE_IDENTIFIER +SPL_MAXSTRINGLENGTH +SPL_STRING_MAXLEN +itdb_splr_get_field_type +itdb_splr_get_action_type +itdb_splr_validate +itdb_splr_remove +itdb_splr_new +itdb_splr_add +itdb_splr_add_new +itdb_spl_copy_rules +itdb_splr_eval +itdb_spl_update +itdb_spl_update_all +itdb_spl_update_live +</SECTION> + +<SECTION> +<FILE>device</FILE> +<TITLE>Device</TITLE> +Itdb_Device +itdb_device_new +itdb_device_free +itdb_device_set_mountpoint +itdb_device_read_sysinfo +itdb_device_get_sysinfo +Itdb_IpodModel +Itdb_ArtworkFormat +Itdb_Generation +Itdb_ModelType +</SECTION> + +<SECTION> +<FILE>artwork</FILE> +<TITLE>Artwork</TITLE> +Itdb_Artwork +Itdb_Thumb +ItdbThumbType +itdb_artwork_new +itdb_artwork_duplicate +itdb_artwork_free +itdb_artwork_add_thumbnail +itdb_artwork_remove_thumbnail +itdb_artwork_remove_thumbnails +itdb_artwork_get_thumb_by_type +itdb_thumb_get_gdk_pixbuf +itdb_thumb_duplicate +itdb_thumb_free +itdb_thumb_new +itdb_thumb_get_filename +</SECTION> + + + + +<SECTION> +<FILE>Internal</FILE> +<SUBSECTION Private> +G_GNUC_INTERNAL +g_stat +g_mkdir +g_rename +g_printf +G_IS_DIR_SEPARATOR +dump_mhif +dump_mhia +dump_mhod_type_1 +dump_mhod_type_3 +dump_mhni +dump_mhod +dump_mhii +dump_mhl +dump_mhsd +dump_mhfd +dump_mhba +ITUNESDB_MAX_SIZE +MHeader +MhlHeader +MhbdHeader +ArtworkDB_MhsdHeader +MhltHeader +MhlpHeader +MhypHeader +MhipHeader +MhitHeader +ArtworkDB_MhodHeader +MhfdHeader +MhliHeader +MhiiHeader +MhniHeader +MhlaHeader +MhbaHeader +MhlfHeader +MhifHeader +MhiaHeader +MhitHeader471 +ArtworkDB_MhodHeaderArtworkType3 +MhodHeaderString +MhodHeaderArtworkType1 +MhodHeaderSmartPlaylistData +MhodHeaderSmartPlaylistRuleString +MhodHeaderSmartPlaylistRuleNonString +MhodHeaderSmartPlaylistRule +iTunesDB_MhsdHeader +MhodHeader +_MhodHeaderArtworkType1 +MhodHeaderArtworkType3 +playcount +NO_PLAYCOUNT +WCONTENTS_STEPSIZE +RED_BITS +RED_SHIFT +RED_MASK +GREEN_BITS +GREEN_SHIFT +GREEN_MASK +BLUE_BITS +BLUE_SHIFT +BLUE_MASK +DBParseContext +db_parse_context_get_m_header +iPodSong +DB_TO_CPU_GET +DB_TO_CPU_GET_DB +ItdbFileError +ITDB_FILE_ERROR +itdb_file_error_quark + +SPLACTION_LAST_HOURS_VALUE +SPLACTION_LAST_MINUTES_VALUE +SPLACTION_LAST_YEARS_VALUE +SPLACTION_LAST_LUNARCYCLE_VALUE +SPLACTION_LAST_SIDEREAL_DAY +SPLACTION_LAST_SWATCH_BEAT +SPLACTION_LAST_MOMENT +SPLACTION_LAST_OSTENT +SPLACTION_LAST_FORTNIGHT +SPLACTION_LAST_VINAL +SPLACTION_LAST_QUARTER +SPLACTION_LAST_SOLAR_YEAR +SPLACTION_LAST_SIDEREAL_YEAR + +</SECTION> + diff --git a/docs/reference/tmpl/Internal.sgml b/docs/reference/tmpl/Internal.sgml new file mode 100644 index 0000000..5bae25a --- /dev/null +++ b/docs/reference/tmpl/Internal.sgml @@ -0,0 +1,19 @@ +<!-- ##### SECTION Title ##### --> +Internal + +<!-- ##### SECTION Short_Description ##### --> +Symbols to be hidden ;) + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + diff --git a/docs/reference/tmpl/artwork.sgml b/docs/reference/tmpl/artwork.sgml new file mode 100644 index 0000000..a7ce2a5 --- /dev/null +++ b/docs/reference/tmpl/artwork.sgml @@ -0,0 +1,160 @@ +<!-- ##### SECTION Title ##### --> +Artwork + +<!-- ##### SECTION Short_Description ##### --> +Data structure to store iPod artwork (cover and photos) + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### STRUCT Itdb_Artwork ##### --> +<para> + +</para> + +@thumbnails: +@artwork_size: +@id: + +<!-- ##### STRUCT Itdb_Thumb ##### --> +<para> + +</para> + +@type: +@filename: +@offset: +@size: +@width: +@height: + +<!-- ##### ENUM ItdbThumbType ##### --> +<para> + +</para> + +@ITDB_THUMB_COVER_SMALL: +@ITDB_THUMB_COVER_LARGE: +@ITDB_THUMB_PHOTO_SMALL: +@ITDB_THUMB_PHOTO_LARGE: +@ITDB_THUMB_PHOTO_FULL_SCREEN: +@ITDB_THUMB_PHOTO_TV_SCREEN: + +<!-- ##### FUNCTION itdb_artwork_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_artwork_duplicate ##### --> +<para> + +</para> + +@artwork: +@Returns: + + +<!-- ##### FUNCTION itdb_artwork_free ##### --> +<para> + +</para> + +@artwork: + + +<!-- ##### FUNCTION itdb_artwork_add_thumbnail ##### --> +<para> + +</para> + +@artwork: +@type: +@filename: +@Returns: + + +<!-- ##### FUNCTION itdb_artwork_remove_thumbnail ##### --> +<para> + +</para> + +@artwork: +@thumb: + + +<!-- ##### FUNCTION itdb_artwork_remove_thumbnails ##### --> +<para> + +</para> + +@artwork: + + +<!-- ##### FUNCTION itdb_artwork_get_thumb_by_type ##### --> +<para> + +</para> + +@artwork: +@type: +@Returns: + + +<!-- ##### FUNCTION itdb_thumb_get_gdk_pixbuf ##### --> +<para> + +</para> + +@device: +@thumb: +@Returns: + + +<!-- ##### FUNCTION itdb_thumb_duplicate ##### --> +<para> + +</para> + +@thumb: +@Returns: + + +<!-- ##### FUNCTION itdb_thumb_free ##### --> +<para> + +</para> + +@thumb: + + +<!-- ##### FUNCTION itdb_thumb_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_thumb_get_filename ##### --> +<para> + +</para> + +@device: +@thumb: +@Returns: + + diff --git a/docs/reference/tmpl/device.sgml b/docs/reference/tmpl/device.sgml new file mode 100644 index 0000000..07090ed --- /dev/null +++ b/docs/reference/tmpl/device.sgml @@ -0,0 +1,129 @@ +<!-- ##### SECTION Title ##### --> +Device + +<!-- ##### SECTION Short_Description ##### --> +Data structure holding information about the iPod (model, mount point, ...) + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### STRUCT Itdb_Device ##### --> +<para> + +</para> + +@mountpoint: +@musicdirs: +@byte_order: +@endianess_reversed: + +<!-- ##### FUNCTION itdb_device_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_device_free ##### --> +<para> + +</para> + +@device: + + +<!-- ##### FUNCTION itdb_device_set_mountpoint ##### --> +<para> + +</para> + +@device: +@mp: + + +<!-- ##### FUNCTION itdb_device_read_sysinfo ##### --> +<para> + +</para> + +@device: +@Returns: + + +<!-- ##### FUNCTION itdb_device_get_sysinfo ##### --> +<para> + +</para> + +@device: +@field: +@Returns: + + +<!-- ##### STRUCT Itdb_IpodModel ##### --> +<para> + +</para> + +@model_number: +@capacity: +@model_type: +@generation: + +<!-- ##### STRUCT Itdb_ArtworkFormat ##### --> +<para> + +</para> + +@type: +@width: +@height: +@correlation_id: + +<!-- ##### ENUM Itdb_Generation ##### --> +<para> + +</para> + +@UNKNOWN_GENERATION: +@FIRST_GENERATION: +@SECOND_GENERATION: +@THIRD_GENERATION: +@FOURTH_GENERATION: +@FIFTH_GENERATION: +@MOBILE_GENERATION: + +<!-- ##### ENUM Itdb_ModelType ##### --> +<para> + +</para> + +@MODEL_TYPE_INVALID: +@MODEL_TYPE_UNKNOWN: +@MODEL_TYPE_COLOR: +@MODEL_TYPE_COLOR_U2: +@MODEL_TYPE_REGULAR: +@MODEL_TYPE_REGULAR_U2: +@MODEL_TYPE_MINI: +@MODEL_TYPE_MINI_BLUE: +@MODEL_TYPE_MINI_PINK: +@MODEL_TYPE_MINI_GREEN: +@MODEL_TYPE_MINI_GOLD: +@MODEL_TYPE_SHUFFLE: +@MODEL_TYPE_NANO_WHITE: +@MODEL_TYPE_NANO_BLACK: +@MODEL_TYPE_VIDEO_WHITE: +@MODEL_TYPE_VIDEO_BLACK: +@MODEL_TYPE_MOBILE_1: + diff --git a/docs/reference/tmpl/itunesdb-copying.sgml b/docs/reference/tmpl/itunesdb-copying.sgml new file mode 100644 index 0000000..82bfe94 --- /dev/null +++ b/docs/reference/tmpl/itunesdb-copying.sgml @@ -0,0 +1,74 @@ +<!-- ##### SECTION Title ##### --> +File handling functions + +<!-- ##### SECTION Short_Description ##### --> +Functions to copy new files to the iPod + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### FUNCTION itdb_cp_track_to_ipod ##### --> +<para> + +</para> + +@track: +@filename: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_filename_fs2ipod ##### --> +<para> + +</para> + +@filename: + + +<!-- ##### FUNCTION itdb_filename_ipod2fs ##### --> +<para> + +</para> + +@ipod_file: + + +<!-- ##### FUNCTION itdb_filename_on_ipod ##### --> +<para> + +</para> + +@track: +@Returns: + + +<!-- ##### FUNCTION itdb_musicdirs_number ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_rename_files ##### --> +<para> + +</para> + +@mp: +@error: +@Returns: + + diff --git a/docs/reference/tmpl/itunesdb-db.sgml b/docs/reference/tmpl/itunesdb-db.sgml new file mode 100644 index 0000000..37fc775 --- /dev/null +++ b/docs/reference/tmpl/itunesdb-db.sgml @@ -0,0 +1,133 @@ +<!-- ##### SECTION Title ##### --> +iPod database reading/writing + +<!-- ##### SECTION Short_Description ##### --> +Functions to create, read, write the iPod database + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### STRUCT Itdb_iTunesDB ##### --> +<para> + +</para> + +@tracks: +@playlists: +@filename: +@device: +@version: +@id: +@usertype: +@userdata: +@userdata_duplicate: +@userdata_destroy: + +<!-- ##### USER_FUNCTION ItdbUserDataDestroyFunc ##### --> +<para> + +</para> + +@userdata: + + +<!-- ##### USER_FUNCTION ItdbUserDataDuplicateFunc ##### --> +<para> + +</para> + +@userdata: +@Returns: + + +<!-- ##### FUNCTION itdb_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_free ##### --> +<para> + +</para> + +@itdb: + + +<!-- ##### FUNCTION itdb_parse ##### --> +<para> + +</para> + +@mp: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_write ##### --> +<para> + +</para> + +@itdb: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_set_mountpoint ##### --> +<para> + +</para> + +@itdb: +@mp: + + +<!-- ##### FUNCTION itdb_get_mountpoint ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_tracks_number ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_tracks_number_nontransferred ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_playlists_number ##### --> +<para> + +</para> + +@itdb: +@Returns: + + diff --git a/docs/reference/tmpl/itunesdb-lowlevel.sgml b/docs/reference/tmpl/itunesdb-lowlevel.sgml new file mode 100644 index 0000000..b91b65c --- /dev/null +++ b/docs/reference/tmpl/itunesdb-lowlevel.sgml @@ -0,0 +1,164 @@ +<!-- ##### SECTION Title ##### --> +Low-level functions + +<!-- ##### SECTION Short_Description ##### --> +Low-level functions which shouldn't be needed in normal situations + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### FUNCTION itdb_get_control_dir ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_itunes_dir ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_music_dir ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_artwork_dir ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_device_dir ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_itunesdb_path ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_artworkdb_path ##### --> +<para> + +</para> + +@mountpoint: +@Returns: + + +<!-- ##### FUNCTION itdb_get_path ##### --> +<para> + +</para> + +@dir: +@file: +@Returns: + + +<!-- ##### FUNCTION itdb_resolve_path ##### --> +<para> + +</para> + +@root: +@components: +@Returns: + + +<!-- ##### FUNCTION itdb_shuffle_write ##### --> +<para> + +</para> + +@itdb: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_shuffle_write_file ##### --> +<para> + +</para> + +@itdb: +@filename: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_cp ##### --> +<para> + +</para> + +@from_file: +@to_file: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_parse_file ##### --> +<para> + +</para> + +@filename: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_write_file ##### --> +<para> + +</para> + +@itdb: +@filename: +@error: +@Returns: + + +<!-- ##### FUNCTION itdb_duplicate ##### --> +<para> + +</para> + +@itdb: +@Returns: + + diff --git a/docs/reference/tmpl/itunesdb-time.sgml b/docs/reference/tmpl/itunesdb-time.sgml new file mode 100644 index 0000000..d06849e --- /dev/null +++ b/docs/reference/tmpl/itunesdb-time.sgml @@ -0,0 +1,45 @@ +<!-- ##### SECTION Title ##### --> +Time handling + +<!-- ##### SECTION Short_Description ##### --> +Helper functions to convert between Epoch time and Mac (iPod) time + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### FUNCTION itdb_time_get_mac_time ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_time_mac_to_host ##### --> +<para> + +</para> + +@mactime: +@Returns: + + +<!-- ##### FUNCTION itdb_time_host_to_mac ##### --> +<para> + +</para> + +@time: +@Returns: + + diff --git a/docs/reference/tmpl/libgpod-unused.sgml b/docs/reference/tmpl/libgpod-unused.sgml new file mode 100644 index 0000000..6fd94dc --- /dev/null +++ b/docs/reference/tmpl/libgpod-unused.sgml @@ -0,0 +1,126 @@ +<!-- ##### SECTION ./tmpl/itunesdb.sgml:Long_Description ##### --> +<para> + +</para> + + +<!-- ##### SECTION ./tmpl/itunesdb.sgml:See_Also ##### --> +<para> + +</para> + + +<!-- ##### SECTION ./tmpl/itunesdb.sgml:Short_Description ##### --> +Main data structure to manipulate an iPod content (songs, playlists, ...) + + +<!-- ##### SECTION ./tmpl/itunesdb.sgml:Stability_Level ##### --> + + + +<!-- ##### SECTION ./tmpl/itunesdb.sgml:Title ##### --> +iTunesDB + + +<!-- ##### MACRO ITDB_FILE_ERROR ##### --> +<para> + +</para> + + +<!-- ##### ENUM ItdbFileError ##### --> +<para> + +</para> + +@ITDB_FILE_ERROR_SEEK: +@ITDB_FILE_ERROR_CORRUPT: +@ITDB_FILE_ERROR_NOTFOUND: +@ITDB_FILE_ERROR_RENAME: +@ITDB_FILE_ERROR_ITDB_CORRUPT: + +<!-- ##### MACRO SPLACTION_LAST_FORTNIGHT ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_HOURS_VALUE ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_LUNARCYCLE_VALUE ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_MINUTES_VALUE ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_MOMENT ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_OSTENT ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_QUARTER ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_SIDEREAL_DAY ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_SIDEREAL_YEAR ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_SOLAR_YEAR ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_SWATCH_BEAT ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_VINAL ##### --> +<para> + +</para> + + +<!-- ##### MACRO SPLACTION_LAST_YEARS_VALUE ##### --> +<para> + +</para> + + +<!-- ##### FUNCTION itdb_file_error_quark ##### --> +<para> + +</para> + +@Returns: + diff --git a/docs/reference/tmpl/playlists.sgml b/docs/reference/tmpl/playlists.sgml new file mode 100644 index 0000000..70395be --- /dev/null +++ b/docs/reference/tmpl/playlists.sgml @@ -0,0 +1,287 @@ +<!-- ##### SECTION Title ##### --> +Playlists + +<!-- ##### SECTION Short_Description ##### --> +Data structure to represent an iPod playlist + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### STRUCT Itdb_Playlist ##### --> +<para> + +</para> + +@itdb: +@name: +@type: +@flag1: +@flag2: +@flag3: +@num: +@members: +@is_spl: +@timestamp: +@id: +@mhodcount: +@libmhodcount: +@sortorder: +@podcastflag: +@splpref: +@splrules: +@usertype: +@userdata: +@userdata_duplicate: +@userdata_destroy: + +<!-- ##### ENUM ItdbPlaylistSortOrder ##### --> +<para> + +</para> + +@ITDB_PSO_MANUAL: +@ITDB_PSO_TITLE: +@ITDB_PSO_ALBUM: +@ITDB_PSO_ARTIST: +@ITDB_PSO_BIRATE: +@ITDB_PSO_GENRE: +@ITDB_PSO_FILETYPE: +@ITDB_PSO_TIME_MODIFIED: +@ITDB_PSO_TRACK_NR: +@ITDB_PSO_SIZE: +@ITDB_PSO_TIME: +@ITDB_PSO_YEAR: +@ITDB_PSO_SAMPLERATE: +@ITDB_PSO_COMMENT: +@ITDB_PSO_TIME_ADDED: +@ITDB_PSO_EQUALIZER: +@ITDB_PSO_COMPOSER: +@ITDB_PSO_PLAYCOUNT: +@ITDB_PSO_TIME_PLAYED: +@ITDB_PSO_CD_NR: +@ITDB_PSO_RATING: +@ITDB_PSO_RELEASE_DATE: +@ITDB_PSO_BPM: +@ITDB_PSO_GROUPING: +@ITDB_PSO_CATEGORY: +@ITDB_PSO_DESCRIPTION: + +<!-- ##### FUNCTION itdb_playlist_new ##### --> +<para> + +</para> + +@title: +@spl: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_free ##### --> +<para> + +</para> + +@pl: + + +<!-- ##### FUNCTION itdb_playlist_duplicate ##### --> +<para> + +</para> + +@pl: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_add ##### --> +<para> + +</para> + +@itdb: +@pl: +@pos: + + +<!-- ##### FUNCTION itdb_playlist_move ##### --> +<para> + +</para> + +@pl: +@pos: + + +<!-- ##### FUNCTION itdb_playlist_remove ##### --> +<para> + +</para> + +@pl: + + +<!-- ##### FUNCTION itdb_playlist_unlink ##### --> +<para> + +</para> + +@pl: + + +<!-- ##### FUNCTION itdb_playlist_add_track ##### --> +<para> + +</para> + +@pl: +@track: +@pos: + + +<!-- ##### FUNCTION itdb_playlist_remove_track ##### --> +<para> + +</para> + +@pl: +@track: + + +<!-- ##### FUNCTION itdb_playlist_contains_track ##### --> +<para> + +</para> + +@pl: +@track: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_contain_track_number ##### --> +<para> + +</para> + +@tr: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_tracks_number ##### --> +<para> + +</para> + +@pl: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_mpl ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_is_mpl ##### --> +<para> + +</para> + +@pl: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_set_mpl ##### --> +<para> + +</para> + +@pl: + + +<!-- ##### FUNCTION itdb_playlist_podcasts ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_is_podcasts ##### --> +<para> + +</para> + +@pl: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_set_podcasts ##### --> +<para> + +</para> + +@pl: + + +<!-- ##### FUNCTION itdb_playlist_exists ##### --> +<para> + +</para> + +@itdb: +@pl: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_by_id ##### --> +<para> + +</para> + +@itdb: +@id: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_by_nr ##### --> +<para> + +</para> + +@itdb: +@num: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_by_name ##### --> +<para> + +</para> + +@itdb: +@name: +@Returns: + + +<!-- ##### FUNCTION itdb_playlist_randomize ##### --> +<para> + +</para> + +@pl: + + diff --git a/docs/reference/tmpl/smart-playlists.sgml b/docs/reference/tmpl/smart-playlists.sgml new file mode 100644 index 0000000..d910ccd --- /dev/null +++ b/docs/reference/tmpl/smart-playlists.sgml @@ -0,0 +1,269 @@ +<!-- ##### SECTION Title ##### --> +Smart Playlists + +<!-- ##### SECTION Short_Description ##### --> +Data structures used to manipulate iPod smart playlists + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### STRUCT SPLPref ##### --> +<para> + +</para> + +@liveupdate: +@checkrules: +@checklimits: +@limittype: +@limitsort: +@limitvalue: +@matchcheckedonly: + +<!-- ##### STRUCT SPLRule ##### --> +<para> + +</para> + +@field: +@action: +@string: +@fromvalue: +@fromdate: +@fromunits: +@tovalue: +@todate: +@tounits: +@unk052: +@unk056: +@unk060: +@unk064: +@unk068: + +<!-- ##### STRUCT SPLRules ##### --> +<para> + +</para> + +@unk004: +@match_operator: +@rules: + +<!-- ##### ENUM SPLAction ##### --> +<para> + +</para> + +@SPLACTION_IS_INT: +@SPLACTION_IS_GREATER_THAN: +@SPLACTION_IS_LESS_THAN: +@SPLACTION_IS_IN_THE_RANGE: +@SPLACTION_IS_IN_THE_LAST: +@SPLACTION_IS_STRING: +@SPLACTION_CONTAINS: +@SPLACTION_STARTS_WITH: +@SPLACTION_ENDS_WITH: +@SPLACTION_IS_NOT_INT: +@SPLACTION_IS_NOT_GREATER_THAN: +@SPLACTION_IS_NOT_LESS_THAN: +@SPLACTION_IS_NOT_IN_THE_RANGE: +@SPLACTION_IS_NOT_IN_THE_LAST: +@SPLACTION_IS_NOT: +@SPLACTION_DOES_NOT_CONTAIN: +@SPLACTION_DOES_NOT_START_WITH: +@SPLACTION_DOES_NOT_END_WITH: + +<!-- ##### ENUM SPLFieldType ##### --> +<para> + +</para> + +@splft_string: +@splft_int: +@splft_boolean: +@splft_date: +@splft_playlist: +@splft_unknown: + +<!-- ##### ENUM SPLActionType ##### --> +<para> + +</para> + +@splat_string: +@splat_int: +@splat_date: +@splat_range_int: +@splat_range_date: +@splat_inthelast: +@splat_playlist: +@splat_none: +@splat_invalid: +@splat_unknown: + +<!-- ##### ENUM SPLField ##### --> +<para> + +</para> + +@SPLFIELD_SONG_NAME: +@SPLFIELD_ALBUM: +@SPLFIELD_ARTIST: +@SPLFIELD_BITRATE: +@SPLFIELD_SAMPLE_RATE: +@SPLFIELD_YEAR: +@SPLFIELD_GENRE: +@SPLFIELD_KIND: +@SPLFIELD_DATE_MODIFIED: +@SPLFIELD_TRACKNUMBER: +@SPLFIELD_SIZE: +@SPLFIELD_TIME: +@SPLFIELD_COMMENT: +@SPLFIELD_DATE_ADDED: +@SPLFIELD_COMPOSER: +@SPLFIELD_PLAYCOUNT: +@SPLFIELD_LAST_PLAYED: +@SPLFIELD_DISC_NUMBER: +@SPLFIELD_RATING: +@SPLFIELD_COMPILATION: +@SPLFIELD_BPM: +@SPLFIELD_GROUPING: +@SPLFIELD_PLAYLIST: + +<!-- ##### MACRO SPLDATE_IDENTIFIER ##### --> +<para> + +</para> + + + +<!-- ##### MACRO SPL_MAXSTRINGLENGTH ##### --> +<para> + +</para> + + + +<!-- ##### MACRO SPL_STRING_MAXLEN ##### --> +<para> + +</para> + + + +<!-- ##### FUNCTION itdb_splr_get_field_type ##### --> +<para> + +</para> + +@splr: +@Returns: + + +<!-- ##### FUNCTION itdb_splr_get_action_type ##### --> +<para> + +</para> + +@splr: +@Returns: + + +<!-- ##### FUNCTION itdb_splr_validate ##### --> +<para> + +</para> + +@splr: + + +<!-- ##### FUNCTION itdb_splr_remove ##### --> +<para> + +</para> + +@pl: +@splr: + + +<!-- ##### FUNCTION itdb_splr_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_splr_add ##### --> +<para> + +</para> + +@pl: +@splr: +@pos: + + +<!-- ##### FUNCTION itdb_splr_add_new ##### --> +<para> + +</para> + +@pl: +@pos: +@Returns: + + +<!-- ##### FUNCTION itdb_spl_copy_rules ##### --> +<para> + +</para> + +@dest: +@src: + + +<!-- ##### FUNCTION itdb_splr_eval ##### --> +<para> + +</para> + +@splr: +@track: +@Returns: + + +<!-- ##### FUNCTION itdb_spl_update ##### --> +<para> + +</para> + +@spl: + + +<!-- ##### FUNCTION itdb_spl_update_all ##### --> +<para> + +</para> + +@itdb: + + +<!-- ##### FUNCTION itdb_spl_update_live ##### --> +<para> + +</para> + +@itdb: + + diff --git a/docs/reference/tmpl/track.sgml b/docs/reference/tmpl/track.sgml new file mode 100644 index 0000000..a96c52f --- /dev/null +++ b/docs/reference/tmpl/track.sgml @@ -0,0 +1,232 @@ +<!-- ##### SECTION Title ##### --> +Tracks + +<!-- ##### SECTION Short_Description ##### --> +Data structure to store metadata about an iPod track + +<!-- ##### SECTION Long_Description ##### --> +<para> + +</para> + +<!-- ##### SECTION See_Also ##### --> +<para> + +</para> + +<!-- ##### SECTION Stability_Level ##### --> + + +<!-- ##### STRUCT Itdb_Track ##### --> +<para> + +</para> + +@itdb: +@title: +@ipod_path: +@album: +@artist: +@genre: +@filetype: +@comment: +@category: +@composer: +@grouping: +@description: +@podcasturl: +@podcastrss: +@chapterdata: +@subtitle: +@id: +@size: +@tracklen: +@cd_nr: +@cds: +@track_nr: +@tracks: +@bitrate: +@samplerate: +@samplerate_low: +@year: +@volume: +@soundcheck: +@time_added: +@time_played: +@time_modified: +@bookmark_time: +@rating: +@playcount: +@playcount2: +@recent_playcount: +@transferred: +@BPM: +@app_rating: +@type1: +@type2: +@compilation: +@starttime: +@stoptime: +@checked: +@dbid: +@drm_userid: +@visible: +@filetype_marker: +@artwork_count: +@artwork_size: +@samplerate2: +@unk126: +@unk132: +@time_released: +@unk144: +@unk146: +@unk148: +@unk152: +@unk156: +@unk160: +@has_artwork: +@flag2: +@flag3: +@flag4: +@dbid2: +@lyrics_flag: +@movie_flag: +@mark_unplayed: +@unk179: +@unk180: +@unk184: +@samplecount: +@unk192: +@unk196: +@unk200: +@unk204: +@unk208: +@unk212: +@unk216: +@unk220: +@unk224: +@unk228: +@unk232: +@unk236: +@unk240: +@chapterdata_raw: +@chapterdata_raw_length: +@artwork: +@usertype: +@userdata: +@userdata_duplicate: +@userdata_destroy: + +<!-- ##### FUNCTION itdb_track_new ##### --> +<para> + +</para> + +@Returns: + + +<!-- ##### FUNCTION itdb_track_free ##### --> +<para> + +</para> + +@track: + + +<!-- ##### FUNCTION itdb_track_add ##### --> +<para> + +</para> + +@itdb: +@track: +@pos: + + +<!-- ##### FUNCTION itdb_track_remove ##### --> +<para> + +</para> + +@track: + + +<!-- ##### FUNCTION itdb_track_unlink ##### --> +<para> + +</para> + +@track: + + +<!-- ##### FUNCTION itdb_track_duplicate ##### --> +<para> + +</para> + +@tr: +@Returns: + + +<!-- ##### FUNCTION itdb_track_by_id ##### --> +<para> + +</para> + +@itdb: +@id: +@Returns: + + +<!-- ##### FUNCTION itdb_track_id_tree_create ##### --> +<para> + +</para> + +@itdb: +@Returns: + + +<!-- ##### FUNCTION itdb_track_id_tree_destroy ##### --> +<para> + +</para> + +@idtree: + + +<!-- ##### FUNCTION itdb_track_id_tree_by_id ##### --> +<para> + +</para> + +@idtree: +@id: +@Returns: + + +<!-- ##### FUNCTION itdb_track_set_thumbnails ##### --> +<para> + +</para> + +@track: +@filename: +@Returns: + + +<!-- ##### FUNCTION itdb_track_remove_thumbnails ##### --> +<para> + +</para> + +@track: + + +<!-- ##### MACRO ITDB_RATING_STEP ##### --> +<para> + +</para> + + + diff --git a/docs/reference/version.xml.in b/docs/reference/version.xml.in new file mode 100644 index 0000000..0426cae --- /dev/null +++ b/docs/reference/version.xml.in @@ -0,0 +1,4 @@ +<?xml version="1.0" standalone="no"?> +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"> +<phrase>@LIBGPOD_VERSION@</phrase> |