[brasero] API documentation
- From: Philippe Rouquier <philippr src gnome org>
- To: svn-commits-list gnome org
- Cc:
- Subject: [brasero] API documentation
- Date: Sun, 2 Aug 2009 16:38:25 +0000 (UTC)
commit 6457459c56bb059c669309db7f9c8af5da232177
Author: Philippe Rouquier <bonfire-app wanadoo fr>
Date: Sun Aug 2 16:10:13 2009 +0200
API documentation
Create two different directories instead of only one
Document BraseroTrack and BraseroTrackData API
configure.in | 5 +-
docs/reference/Makefile.am | 168 +-----
docs/reference/libbrasero-burn/Makefile.am | 136 ++++
.../libbrasero-burn-docs.sgml} | 23 +-
.../libbrasero-burn-sections.txt} | 730 +++++++-------------
.../reference/{ => libbrasero-burn}/version.xml.in | 0
docs/reference/libbrasero-media/Makefile.am | 133 ++++
.../libbrasero-media/libbrasero-media-docs.sgml | 37 +
.../libbrasero-media/libbrasero-media-sections.txt | 209 ++++++
.../{ => libbrasero-media}/version.xml.in | 0
libbrasero-burn/brasero-track-data.c | 166 +++++-
libbrasero-burn/brasero-track-data.h | 2 +-
libbrasero-burn/brasero-track.c | 171 +++++-
libbrasero-media/brasero-drive.c | 3 +-
14 files changed, 1122 insertions(+), 661 deletions(-)
---
diff --git a/configure.in b/configure.in
index 603fdf0..bba38c6 100644
--- a/configure.in
+++ b/configure.in
@@ -437,7 +437,10 @@ libbrasero-media.pc
libbrasero-burn.pc
docs/Makefile
docs/reference/Makefile
-docs/reference/version.xml
+docs/reference/libbrasero-media/Makefile
+docs/reference/libbrasero-burn/Makefile
+docs/reference/libbrasero-media/version.xml
+docs/reference/libbrasero-burn/version.xml
data/Makefile
data/brasero.desktop.in
data/brasero-copy-medium.desktop.in
diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am
index ef20dab..e14d886 100644
--- a/docs/reference/Makefile.am
+++ b/docs/reference/Makefile.am
@@ -1,171 +1,7 @@
## 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=brasero
-
-# The top-level SGML file. You can change this if you want to.
-DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
-
-# 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=../../libbrasero-media
-
-# 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=--source-dir=../../libbrasero-burn
-
-# 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)/libbrasero-media/*.h #$(top_srcdir)/libbrasero-burn/*.h
-CFILE_GLOB=$(top_srcdir)/libbrasero-media/*.c #$(top_srcdir)/libbrasero-burn/*.c
-
-# Header files to ignore when scanning.
-# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
-IGNORE_HFILES= libbrasero-marshal.h \
- brasero-gio-operation.h \
- burn-volume-source.h \
- scsi-base.h \
- scsi-error.h \
- scsi-mmc1.h \
- scsi-opcodes.h \
- scsi-read-disc-info.h \
- scsi-read-track-information.h \
- scsi-status-page.h \
- scsi-command.h \
- scsi-get-configuration.h \
- scsi-mmc2.h \
- scsi-q-subchannel.h \
- scsi-read-disc-structure.h \
- scsi-sbc.h \
- scsi-utils.h \
- scsi-device.h \
- scsi-get-performance.h \
- scsi-mmc3.h \
- scsi-read-capacity.h \
- scsi-read-format-capacities.h \
- scsi-sense-data.h \
- scsi-write-page.h \
- scsi-dvd-structures.h \
- scsi-mech-status.h \
- scsi-mode-pages.h \
- scsi-read-cd.h \
- scsi-read-toc-pma-atip.h \
- scsi-spc1.h \
- burn-iso-field.h \
- burn-iso9660.h \
- burn-volume.h \
- brasero-media-private.h \
- brasero-medium-selection-priv.h \
- burn-susp.h \
- brasero-caps-burn.h \
- brasero-cover.h \
- brasero-data-project.h \
- brasero-data-session.h \
- brasero-data-tree-model.h \
- brasero-data-vfs.h \
- brasero-dest-selection.h \
- brasero-drive-properties.h \
- brasero-file-monitor.h \
- brasero-file-node.h \
- brasero-filtered-uri.h \
- brasero-image-properties.h \
- brasero-image-type-chooser.h \
- brasero-medium-properties.h \
- brasero-plugin.h \
- brasero-plugin-information.h \
- brasero-plugin-registration.h \
- brasero-progress.h \
- brasero-session-helper.h \
- brasero-src-image.h \
- brasero-src-selection.h \
- brasero-status-dialog.h \
- brasero-tool-dialog-private.h \
- brasero-track-type-private.h \
- brasero-tray.h \
- brasero-video-options.h \
- brasero-xfer.h \
- burn-basics.h \
- burn-caps.h \
- burn-dbus.h \
- burn-debug.h \
- burn-image-format.h \
- burn-job.h \
- burn-mkisofs-base.h \
- burn-plugin-manager.h \
- burn-process.h \
- burn-task-ctx.h \
- burn-task.h \
- burn-task-item.h
-
-
-# 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=version.xml
-
-# 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= \
- -I$(top_srcdir) \
- -I$(top_builddir) \
- $(BRASERO_GLIB_CFLAGS) \
- $(BRASERO_IO_CFLAGS) \
- $(BRASERO_GTK_CFLAGS)
-
-GTKDOC_LIBS=$(top_builddir)/libbrasero-media/libbrasero-media.la $(top_builddir)/libbrasero-burn/libbrasero-burn.la
-
-# 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 += version.xml.in
-
-# Files not to distribute
-# for --rebuild-types in $(SCAN_OPTIONS), e.g. $(DOC_MODULE).types
-# for --rebuild-sections in $(SCAN_OPTIONS) e.g. $(DOC_MODULE)-sections.txt
-#DISTCLEANFILES +=
-
-# Comment this out if you want your docs-status tested during 'make check'
-#TESTS = $(GTKDOC_CHECK)
-
+SUBDIRS = libbrasero-media libbrasero-burn
+GITIGNOREFILES = */*.1
-include $(top_srcdir)/git.mk
diff --git a/docs/reference/libbrasero-burn/Makefile.am b/docs/reference/libbrasero-burn/Makefile.am
new file mode 100644
index 0000000..0d74a4b
--- /dev/null
+++ b/docs/reference/libbrasero-burn/Makefile.am
@@ -0,0 +1,136 @@
+## 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=libbrasero-burn
+
+# The top-level SGML file. You can change this if you want to.
+DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
+
+# 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=$(top_srcdir)/libbrasero-burn
+
+# 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=--extra-dir=../libbrasero-media/html
+
+# 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)/libbrasero-burn/*.h
+CFILE_GLOB=$(top_srcdir)/libbrasero-burn/*.c
+
+# Header files to ignore when scanning.
+# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
+IGNORE_HFILES= libbrasero-marshal.h \
+ brasero-caps-burn.h \
+ brasero-cover.h \
+ brasero-data-project.h \
+ brasero-data-session.h \
+ brasero-data-tree-model.h \
+ brasero-data-vfs.h \
+ brasero-dest-selection.h \
+ brasero-drive-properties.h \
+ brasero-file-monitor.h \
+ brasero-file-node.h \
+ brasero-filtered-uri.h \
+ brasero-image-properties.h \
+ brasero-image-type-chooser.h \
+ brasero-medium-properties.h \
+ brasero-plugin.h \
+ brasero-plugin-information.h \
+ brasero-plugin-registration.h \
+ brasero-progress.h \
+ brasero-session-helper.h \
+ brasero-src-image.h \
+ brasero-src-selection.h \
+ brasero-status-dialog.h \
+ brasero-tool-dialog-private.h \
+ brasero-track-type-private.h \
+ brasero-tray.h \
+ brasero-video-options.h \
+ brasero-xfer.h \
+ burn-basics.h \
+ burn-caps.h \
+ burn-dbus.h \
+ burn-debug.h \
+ burn-image-format.h \
+ burn-job.h \
+ burn-mkisofs-base.h \
+ burn-plugin-manager.h \
+ burn-process.h \
+ burn-task-ctx.h \
+ burn-task.h \
+ burn-task-item.h
+
+
+# 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=version.xml
+
+# 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= \
+ -I$(top_srcdir) \
+ -I$(top_builddir) \
+ $(BRASERO_GLIB_CFLAGS) \
+ $(BRASERO_IO_CFLAGS) \
+ $(BRASERO_GTK_CFLAGS)
+
+GTKDOC_LIBS=$(top_builddir)/libbrasero-media/libbrasero-media.la $(top_builddir)/libbrasero-burn/libbrasero-burn.la
+
+# 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 += version.xml.in
+
+# Files not to distribute
+# for --rebuild-types in $(SCAN_OPTIONS), e.g. $(DOC_MODULE).types
+# for --rebuild-sections in $(SCAN_OPTIONS) e.g. $(DOC_MODULE)-sections.txt
+#DISTCLEANFILES +=
+
+# Comment this out if you want your docs-status tested during 'make check'
+#TESTS = $(GTKDOC_CHECK)
+
+
+
+-include $(top_srcdir)/git.mk
diff --git a/docs/reference/brasero-docs.sgml b/docs/reference/libbrasero-burn/libbrasero-burn-docs.sgml
similarity index 73%
rename from docs/reference/brasero-docs.sgml
rename to docs/reference/libbrasero-burn/libbrasero-burn-docs.sgml
index 291b22e..612491f 100644
--- a/docs/reference/brasero-docs.sgml
+++ b/docs/reference/libbrasero-burn/libbrasero-burn-docs.sgml
@@ -2,36 +2,23 @@
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd";
[
- <!ENTITY version SYSTEM "version.xml">
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
]>
-
-<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude";>
+<book id="index">
<bookinfo>
- <title>Brasero Libraries Reference Manual</title>
+ <title>Libbrasero-burn Reference Manual</title>
<releaseinfo>
- for Libbrasero &version;
+ for Libbrasero-burn [VERSION]
</releaseinfo>
</bookinfo>
<chapter>
- <title>API Reference for Libbrasero-media</title>
- <xi:include href="xml/brasero-media.xml"/>
- <xi:include href="xml/brasero-units.xml"/>
- <xi:include href="xml/brasero-medium-monitor.xml"/>
- <xi:include href="xml/brasero-drive.xml"/>
- <xi:include href="xml/brasero-medium.xml"/>
- <xi:include href="xml/brasero-volume.xml"/>
- <xi:include href="xml/brasero-medium-selection.xml"/>
- <xi:include href="xml/brasero-drive-selection.xml"/>
- </chapter>
-.
- <chapter>
<title>API Reference for Libbrasero-burn</title>
<xi:include href="xml/brasero-burn-lib.xml"/>
<xi:include href="xml/brasero-error.xml"/>
<xi:include href="xml/brasero-tags.xml"/>
<xi:include href="xml/brasero-status.xml"/>
+ <xi:include href="xml/brasero-enums.xml"/>
<xi:include href="xml/brasero-track-type.xml"/>
<xi:include href="xml/brasero-track.xml"/>
<xi:include href="xml/brasero-track-disc.xml"/>
@@ -51,8 +38,8 @@
<xi:include href="xml/brasero-sum-dialog.xml"/>
<xi:include href="xml/brasero-blank-dialog.xml"/>
+
</chapter>
-
<chapter id="object-tree">
<title>Object Hierarchy</title>
<xi:include href="xml/tree_index.sgml"/>
diff --git a/docs/reference/brasero-sections.txt b/docs/reference/libbrasero-burn/libbrasero-burn-sections.txt
similarity index 70%
rename from docs/reference/brasero-sections.txt
rename to docs/reference/libbrasero-burn/libbrasero-burn-sections.txt
index 8c2a273..ae0b86b 100644
--- a/docs/reference/brasero-sections.txt
+++ b/docs/reference/libbrasero-burn/libbrasero-burn-sections.txt
@@ -1,202 +1,83 @@
<SECTION>
-<FILE>brasero-medium</FILE>
-<TITLE>BraseroMedium</TITLE>
-BraseroMedium
-brasero_medium_get_status
-brasero_medium_get_max_write_speed
-brasero_medium_get_write_speeds
-brasero_medium_get_free_space
-brasero_medium_get_capacity
-brasero_medium_get_data_size
-brasero_medium_get_next_writable_address
-brasero_medium_can_be_rewritten
-brasero_medium_can_be_written
-brasero_medium_get_CD_TEXT_title
-brasero_medium_get_type_string
-brasero_medium_get_tooltip
-brasero_medium_get_drive
-brasero_medium_get_track_num
-brasero_medium_get_last_data_track_space
-brasero_medium_get_last_data_track_address
-brasero_medium_get_track_space
-brasero_medium_get_track_address
-brasero_medium_can_use_dummy_for_sao
-brasero_medium_can_use_dummy_for_tao
-brasero_medium_can_use_burnfree
-<SUBSECTION Standard>
-BRASERO_MEDIUM
-BRASERO_IS_MEDIUM
-BRASERO_TYPE_MEDIUM
-brasero_medium_get_type
-BRASERO_MEDIUM_CLASS
-BRASERO_IS_MEDIUM_CLASS
-BRASERO_MEDIUM_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-volume</FILE>
-<TITLE>BraseroVolume</TITLE>
-BraseroVolume
-brasero_volume_get_name
-brasero_volume_get_icon
-brasero_volume_get_gvolume
-brasero_volume_is_mounted
-brasero_volume_get_mount_point
-brasero_volume_umount
-brasero_volume_mount
-brasero_volume_cancel_current_operation
-<SUBSECTION Standard>
-BRASERO_VOLUME
-BRASERO_IS_VOLUME
-BRASERO_TYPE_VOLUME
-brasero_volume_get_type
-BRASERO_VOLUME_CLASS
-BRASERO_IS_VOLUME_CLASS
-BRASERO_VOLUME_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-medium-monitor</FILE>
-<TITLE>BraseroMediumMonitor</TITLE>
-BraseroMediumMonitor
-brasero_medium_monitor_get_default
-BraseroMediaType
-BraseroDriveType
-brasero_medium_monitor_get_media
-brasero_medium_monitor_get_drives
-brasero_medium_monitor_get_drive
-brasero_medium_monitor_is_probing
-<SUBSECTION Standard>
-BRASERO_MEDIUM_MONITOR
-BRASERO_IS_MEDIUM_MONITOR
-BRASERO_TYPE_MEDIUM_MONITOR
-brasero_medium_monitor_get_type
-BRASERO_MEDIUM_MONITOR_CLASS
-BRASERO_IS_MEDIUM_MONITOR_CLASS
-BRASERO_MEDIUM_MONITOR_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-medium-selection</FILE>
-<TITLE>BraseroMediumSelection</TITLE>
-BraseroMediumSelection
-brasero_medium_selection_new
-brasero_medium_selection_get_active
-brasero_medium_selection_set_active
-brasero_medium_selection_show_media_type
-<SUBSECTION Standard>
-BRASERO_MEDIUM_SELECTION
-BRASERO_IS_MEDIUM_SELECTION
-BRASERO_TYPE_MEDIUM_SELECTION
-brasero_medium_selection_get_type
-BRASERO_MEDIUM_SELECTION_CLASS
-BRASERO_IS_MEDIUM_SELECTION_CLASS
-BRASERO_MEDIUM_SELECTION_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-drive-selection</FILE>
-<TITLE>BraseroDriveSelection</TITLE>
-BraseroDriveSelection
-brasero_drive_selection_new
-brasero_drive_selection_get_active
-brasero_drive_selection_set_active
-brasero_drive_selection_show_type
-<SUBSECTION Standard>
-BRASERO_DRIVE_SELECTION
-BRASERO_IS_DRIVE_SELECTION
-BRASERO_TYPE_DRIVE_SELECTION
-brasero_drive_selection_get_type
-BRASERO_DRIVE_SELECTION_CLASS
-BRASERO_IS_DRIVE_SELECTION_CLASS
-BRASERO_DRIVE_SELECTION_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-drive</FILE>
-BraseroDriveCaps
-<TITLE>BraseroDrive</TITLE>
-BraseroDrive
-brasero_drive_reprobe
-brasero_drive_get_medium
-brasero_drive_get_gdrive
-brasero_drive_get_udi
-brasero_drive_is_fake
-brasero_drive_get_display_name
-brasero_drive_get_device
-brasero_drive_get_block_device
-brasero_drive_get_bus_target_lun_string
-brasero_drive_get_caps
-brasero_drive_can_write
-brasero_drive_can_eject
-brasero_drive_eject
-brasero_drive_cancel_current_operation
-brasero_drive_is_door_open
-brasero_drive_can_use_exclusively
-brasero_drive_lock
-brasero_drive_unlock
+<FILE>brasero-track-image</FILE>
+<TITLE>BraseroTrackImage</TITLE>
+BraseroTrackImage
+brasero_track_image_new
+brasero_track_image_set_source
+brasero_track_image_set_block_num
+brasero_track_image_get_source
+brasero_track_image_get_toc_source
+brasero_track_image_get_format
<SUBSECTION Standard>
-BRASERO_DRIVE
-BRASERO_IS_DRIVE
-BRASERO_TYPE_DRIVE
-brasero_drive_get_type
-BRASERO_DRIVE_CLASS
-BRASERO_IS_DRIVE_CLASS
-BRASERO_DRIVE_GET_CLASS
+BRASERO_TRACK_IMAGE
+BRASERO_IS_TRACK_IMAGE
+BRASERO_TYPE_TRACK_IMAGE
+brasero_track_image_get_type
+BRASERO_TRACK_IMAGE_CLASS
+BRASERO_IS_TRACK_IMAGE_CLASS
+BRASERO_TRACK_IMAGE_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-track-stream</FILE>
-<TITLE>BraseroTrackStream</TITLE>
-BraseroTrackStream
-brasero_track_stream_new
-brasero_track_stream_set_source
-brasero_track_stream_set_format
-brasero_track_stream_set_boundaries
-brasero_track_stream_get_source
-brasero_track_stream_get_length
-brasero_track_stream_get_start
-brasero_track_stream_get_end
-brasero_track_stream_get_gap
-brasero_track_stream_get_format
+<FILE>brasero-session-cfg</FILE>
+<TITLE>BraseroSessionCfg</TITLE>
+BraseroSessionCfg
+BRASERO_DRIVE_PROPERTIES_FLAGS
+BraseroSessionError
+BRASERO_SESSION_IS_VALID
+brasero_session_cfg_new
+brasero_session_cfg_get_error
+brasero_session_cfg_add_flags
+brasero_session_cfg_remove_flags
+brasero_session_cfg_is_supported
+brasero_session_cfg_is_compulsory
+brasero_session_cfg_has_default_output_path
+brasero_session_cfg_enable
+brasero_session_cfg_disable
<SUBSECTION Standard>
-BRASERO_TRACK_STREAM
-BRASERO_IS_TRACK_STREAM
-BRASERO_TYPE_TRACK_STREAM
-brasero_track_stream_get_type
-BRASERO_TRACK_STREAM_CLASS
-BRASERO_IS_TRACK_STREAM_CLASS
-BRASERO_TRACK_STREAM_GET_CLASS
+BRASERO_SESSION_CFG
+BRASERO_IS_SESSION_CFG
+BRASERO_TYPE_SESSION_CFG
+brasero_session_cfg_get_type
+BRASERO_SESSION_CFG_CLASS
+BRASERO_IS_SESSION_CFG_CLASS
+BRASERO_SESSION_CFG_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-track-stream-cfg</FILE>
-<TITLE>BraseroTrackStreamCfg</TITLE>
-BraseroTrackStreamCfg
-brasero_track_stream_cfg_new
+<FILE>brasero-burn</FILE>
+<TITLE>BraseroBurn</TITLE>
+BraseroBurn
+brasero_burn_new
+brasero_burn_record
+brasero_burn_check
+brasero_burn_blank
+brasero_burn_cancel
+brasero_burn_status
+brasero_burn_get_action_string
<SUBSECTION Standard>
-BRASERO_TRACK_STREAM_CFG
-BRASERO_IS_TRACK_STREAM_CFG
-BRASERO_TYPE_TRACK_STREAM_CFG
-brasero_track_stream_cfg_get_type
-BRASERO_TRACK_STREAM_CFG_CLASS
-BRASERO_IS_TRACK_STREAM_CFG_CLASS
-BRASERO_TRACK_STREAM_CFG_GET_CLASS
+BRASERO_BURN
+BRASERO_IS_BURN
+BRASERO_TYPE_BURN
+brasero_burn_get_type
+BRASERO_BURN_CLASS
+BRASERO_IS_BURN_CLASS
+BRASERO_BURN_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-blank-dialog</FILE>
-<TITLE>BraseroBlankDialog</TITLE>
-BraseroBlankDialog
-brasero_blank_dialog_new
+<FILE>brasero-sum-dialog</FILE>
+<TITLE>BraseroSumDialog</TITLE>
+BraseroSumDialog
+brasero_sum_dialog_new
<SUBSECTION Standard>
-BRASERO_BLANK_DIALOG
-BRASERO_IS_BLANK_DIALOG
-BRASERO_TYPE_BLANK_DIALOG
-brasero_blank_dialog_get_type
-BRASERO_BLANK_DIALOG_CLASS
-BRASERO_IS_BLANK_DIALOG_CLASS
-BRASERO_BLANK_DIALOG_GET_CLASS
+BRASERO_SUM_DIALOG
+BRASERO_IS_SUM_DIALOG
+BRASERO_TYPE_SUM_DIALOG
+brasero_sum_dialog_get_type
+BRASERO_SUM_DIALOG_CLASS
+BRASERO_IS_SUM_DIALOG_CLASS
+BRASERO_SUM_DIALOG_GET_CLASS
</SECTION>
<SECTION>
@@ -259,66 +140,89 @@ BRASERO_BURN_SESSION_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-session-cfg</FILE>
-<TITLE>BraseroSessionCfg</TITLE>
-BraseroSessionCfg
-BRASERO_DRIVE_PROPERTIES_FLAGS
-BraseroSessionError
-BRASERO_SESSION_IS_VALID
-brasero_session_cfg_new
-brasero_session_cfg_get_error
-brasero_session_cfg_add_flags
-brasero_session_cfg_remove_flags
-brasero_session_cfg_is_supported
-brasero_session_cfg_is_compulsory
-brasero_session_cfg_has_default_output_path
-brasero_session_cfg_disable
+<FILE>brasero-track-image-cfg</FILE>
+<TITLE>BraseroTrackImageCfg</TITLE>
+BraseroTrackImageCfg
+brasero_track_image_cfg_new
+brasero_track_image_cfg_set_source
+brasero_track_image_cfg_force_format
+brasero_track_image_cfg_get_forced_format
<SUBSECTION Standard>
-BRASERO_SESSION_CFG
-BRASERO_IS_SESSION_CFG
-BRASERO_TYPE_SESSION_CFG
-brasero_session_cfg_get_type
-BRASERO_SESSION_CFG_CLASS
-BRASERO_IS_SESSION_CFG_CLASS
-BRASERO_SESSION_CFG_GET_CLASS
+BRASERO_TRACK_IMAGE_CFG
+BRASERO_IS_TRACK_IMAGE_CFG
+BRASERO_TYPE_TRACK_IMAGE_CFG
+brasero_track_image_cfg_get_type
+BRASERO_TRACK_IMAGE_CFG_CLASS
+BRASERO_IS_TRACK_IMAGE_CFG_CLASS
+BRASERO_TRACK_IMAGE_CFG_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-burn-options</FILE>
-<TITLE>BraseroBurnOptions</TITLE>
-BraseroBurnOptions
-brasero_burn_options_new
-brasero_burn_options_get_session
-brasero_burn_options_add_options
+<FILE>brasero-tool-dialog</FILE>
+<TITLE>BraseroToolDialog</TITLE>
+BraseroToolDialog
+brasero_tool_dialog_cancel
+brasero_tool_dialog_set_medium
<SUBSECTION Standard>
-BRASERO_BURN_OPTIONS
-BRASERO_IS_BURN_OPTIONS
-BRASERO_TYPE_BURN_OPTIONS
-brasero_burn_options_get_type
-BRASERO_BURN_OPTIONS_CLASS
-BRASERO_IS_BURN_OPTIONS_CLASS
-BRASERO_BURN_OPTIONS_GET_CLASS
+BRASERO_TOOL_DIALOG
+BRASERO_IS_TOOL_DIALOG
+BRASERO_TYPE_TOOL_DIALOG
+brasero_tool_dialog_get_type
+BRASERO_TOOL_DIALOG_CLASS
+BRASERO_IS_TOOL_DIALOG_CLASS
+BRASERO_TOOL_DIALOG_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-burn</FILE>
-<TITLE>BraseroBurn</TITLE>
-BraseroBurn
-brasero_burn_new
-brasero_burn_record
-brasero_burn_check
-brasero_burn_blank
-brasero_burn_cancel
-brasero_burn_status
-brasero_burn_get_action_string
+<FILE>brasero-track-data-cfg</FILE>
+BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST
+BraseroTrackDataCfgColumn
+<TITLE>BraseroTrackDataCfg</TITLE>
+BraseroTrackDataCfg
+brasero_track_data_cfg_new
+brasero_track_data_cfg_add
+brasero_track_data_cfg_add_empty_directory
+brasero_track_data_cfg_remove
+brasero_track_data_cfg_rename
+brasero_track_data_cfg_reset
+brasero_track_data_cfg_load_medium
+brasero_track_data_cfg_unload_current_medium
+brasero_track_data_cfg_get_current_medium
+brasero_track_data_cfg_get_available_media
+brasero_track_data_cfg_dont_filter_uri
+brasero_track_data_cfg_get_restored_list
+brasero_track_data_cfg_restore
+brasero_track_data_cfg_get_filtered_model
+brasero_track_data_cfg_span
+brasero_track_data_cfg_span_again
+brasero_track_data_cfg_span_possible
+brasero_track_data_cfg_span_stop
+brasero_track_data_cfg_get_icon
+brasero_track_data_cfg_get_icon_path
+brasero_track_data_cfg_set_icon
<SUBSECTION Standard>
-BRASERO_BURN
-BRASERO_IS_BURN
-BRASERO_TYPE_BURN
-brasero_burn_get_type
-BRASERO_BURN_CLASS
-BRASERO_IS_BURN_CLASS
-BRASERO_BURN_GET_CLASS
+BRASERO_TRACK_DATA_CFG
+BRASERO_IS_TRACK_DATA_CFG
+BRASERO_TYPE_TRACK_DATA_CFG
+brasero_track_data_cfg_get_type
+BRASERO_TRACK_DATA_CFG_CLASS
+BRASERO_IS_TRACK_DATA_CFG_CLASS
+BRASERO_TRACK_DATA_CFG_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-track-stream-cfg</FILE>
+<TITLE>BraseroTrackStreamCfg</TITLE>
+BraseroTrackStreamCfg
+brasero_track_stream_cfg_new
+<SUBSECTION Standard>
+BRASERO_TRACK_STREAM_CFG
+BRASERO_IS_TRACK_STREAM_CFG
+BRASERO_TYPE_TRACK_STREAM_CFG
+brasero_track_stream_cfg_get_type
+BRASERO_TRACK_STREAM_CFG_CLASS
+BRASERO_IS_TRACK_STREAM_CFG_CLASS
+BRASERO_TRACK_STREAM_CFG_GET_CLASS
</SECTION>
<SECTION>
@@ -339,21 +243,6 @@ BRASERO_BURN_DIALOG_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-sum-dialog</FILE>
-<TITLE>BraseroSumDialog</TITLE>
-BraseroSumDialog
-brasero_sum_dialog_new
-<SUBSECTION Standard>
-BRASERO_SUM_DIALOG
-BRASERO_IS_SUM_DIALOG
-BRASERO_TYPE_SUM_DIALOG
-brasero_sum_dialog_get_type
-BRASERO_SUM_DIALOG_CLASS
-BRASERO_IS_SUM_DIALOG_CLASS
-BRASERO_SUM_DIALOG_GET_CLASS
-</SECTION>
-
-<SECTION>
<FILE>brasero-track-data</FILE>
BraseroGraftPt
brasero_graft_point_free
@@ -382,57 +271,32 @@ BRASERO_TRACK_DATA_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-tool-dialog</FILE>
-<TITLE>BraseroToolDialog</TITLE>
-BraseroToolDialog
-brasero_tool_dialog_cancel
-brasero_tool_dialog_set_medium
-<SUBSECTION Standard>
-BRASERO_TOOL_DIALOG
-BRASERO_IS_TOOL_DIALOG
-BRASERO_TYPE_TOOL_DIALOG
-brasero_tool_dialog_get_type
-BRASERO_TOOL_DIALOG_CLASS
-BRASERO_IS_TOOL_DIALOG_CLASS
-BRASERO_TOOL_DIALOG_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-track-image</FILE>
-<TITLE>BraseroTrackImage</TITLE>
-BraseroTrackImage
-brasero_track_image_new
-brasero_track_image_set_source
-brasero_track_image_set_block_num
-brasero_track_image_get_source
-brasero_track_image_get_toc_source
-brasero_track_image_get_format
-<SUBSECTION Standard>
-BRASERO_TRACK_IMAGE
-BRASERO_IS_TRACK_IMAGE
-BRASERO_TYPE_TRACK_IMAGE
-brasero_track_image_get_type
-BRASERO_TRACK_IMAGE_CLASS
-BRASERO_IS_TRACK_IMAGE_CLASS
-BRASERO_TRACK_IMAGE_GET_CLASS
-</SECTION>
-
-<SECTION>
-<FILE>brasero-track-image-cfg</FILE>
-<TITLE>BraseroTrackImageCfg</TITLE>
-BraseroTrackImageCfg
-brasero_track_image_cfg_new
-brasero_track_image_cfg_set_source
-brasero_track_image_cfg_force_format
-brasero_track_image_cfg_get_forced_format
+<FILE>brasero-track</FILE>
+<TITLE>BraseroTrack</TITLE>
+BraseroTrack
+brasero_track_changed
+brasero_track_get_size
+brasero_track_get_track_type
+brasero_track_get_status
+BraseroChecksumType
+brasero_track_set_checksum
+brasero_track_get_checksum
+brasero_track_get_checksum_type
+brasero_track_tag_add
+brasero_track_tag_lookup
+brasero_track_tag_copy_missing
+brasero_track_tag_add_string
+brasero_track_tag_lookup_string
+brasero_track_tag_add_int
+brasero_track_tag_lookup_int
<SUBSECTION Standard>
-BRASERO_TRACK_IMAGE_CFG
-BRASERO_IS_TRACK_IMAGE_CFG
-BRASERO_TYPE_TRACK_IMAGE_CFG
-brasero_track_image_cfg_get_type
-BRASERO_TRACK_IMAGE_CFG_CLASS
-BRASERO_IS_TRACK_IMAGE_CFG_CLASS
-BRASERO_TRACK_IMAGE_CFG_GET_CLASS
+BRASERO_TRACK
+BRASERO_IS_TRACK
+BRASERO_TYPE_TRACK
+brasero_track_get_type
+BRASERO_TRACK_CLASS
+BRASERO_IS_TRACK_CLASS
+BRASERO_TRACK_GET_CLASS
</SECTION>
<SECTION>
@@ -476,131 +340,109 @@ BRASERO_TRACK_DISC_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-track-data-cfg</FILE>
-BRASERO_DND_TARGET_DATA_TRACK_REFERENCE_LIST
-BraseroTrackDataCfgColumn
-<TITLE>BraseroTrackDataCfg</TITLE>
-BraseroTrackDataCfg
-brasero_track_data_cfg_new
-brasero_track_data_cfg_get_contents
-brasero_track_data_cfg_add
-brasero_track_data_cfg_add_empty_directory
-brasero_track_data_cfg_remove
-brasero_track_data_cfg_rename
-brasero_track_data_cfg_reset
-brasero_track_data_cfg_load_medium
-brasero_track_data_cfg_unload_current_medium
-brasero_track_data_cfg_get_current_medium
-brasero_track_data_cfg_get_available_media
-brasero_track_data_cfg_dont_filter_uri
-brasero_track_data_cfg_get_restored_list
-brasero_track_data_cfg_restore
-brasero_track_data_cfg_get_filtered_model
-brasero_track_data_cfg_span
-brasero_track_data_cfg_span_again
-brasero_track_data_cfg_span_possible
-brasero_track_data_cfg_span_stop
-brasero_track_data_cfg_get_icon_path
-brasero_track_data_cfg_set_icon
+<FILE>brasero-burn-options</FILE>
+<TITLE>BraseroBurnOptions</TITLE>
+BraseroBurnOptions
+brasero_burn_options_new
+brasero_burn_options_get_session
+brasero_burn_options_add_options
<SUBSECTION Standard>
-BRASERO_TRACK_DATA_CFG
-BRASERO_IS_TRACK_DATA_CFG
-BRASERO_TYPE_TRACK_DATA_CFG
-brasero_track_data_cfg_get_type
-BRASERO_TRACK_DATA_CFG_CLASS
-BRASERO_IS_TRACK_DATA_CFG_CLASS
-BRASERO_TRACK_DATA_CFG_GET_CLASS
+BRASERO_BURN_OPTIONS
+BRASERO_IS_BURN_OPTIONS
+BRASERO_TYPE_BURN_OPTIONS
+brasero_burn_options_get_type
+BRASERO_BURN_OPTIONS_CLASS
+BRASERO_IS_BURN_OPTIONS_CLASS
+BRASERO_BURN_OPTIONS_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-track</FILE>
-<TITLE>BraseroTrack</TITLE>
-BraseroTrack
-brasero_track_changed
-brasero_track_get_size
-brasero_track_get_track_type
-brasero_track_get_status
-BraseroChecksumType
-brasero_track_set_checksum
-brasero_track_get_checksum
-brasero_track_get_checksum_type
-brasero_track_tag_add
-brasero_track_tag_lookup
-brasero_track_tag_copy_missing
-brasero_track_tag_add_string
-brasero_track_tag_lookup_string
-brasero_track_tag_add_int
-brasero_track_tag_lookup_int
+<FILE>brasero-blank-dialog</FILE>
+<TITLE>BraseroBlankDialog</TITLE>
+BraseroBlankDialog
+brasero_blank_dialog_new
<SUBSECTION Standard>
-BRASERO_TRACK
-BRASERO_IS_TRACK
-BRASERO_TYPE_TRACK
-brasero_track_get_type
-BRASERO_TRACK_CLASS
-BRASERO_IS_TRACK_CLASS
-BRASERO_TRACK_GET_CLASS
+BRASERO_BLANK_DIALOG
+BRASERO_IS_BLANK_DIALOG
+BRASERO_TYPE_BLANK_DIALOG
+brasero_blank_dialog_get_type
+BRASERO_BLANK_DIALOG_CLASS
+BRASERO_IS_BLANK_DIALOG_CLASS
+BRASERO_BLANK_DIALOG_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-units</FILE>
-CD_RATE
-DVD_RATE
-BD_RATE
-BRASERO_SPEED_TO_RATE_CD
-BRASERO_SPEED_TO_RATE_DVD
-BRASERO_SPEED_TO_RATE_BD
-BRASERO_RATE_TO_SPEED_CD
-BRASERO_RATE_TO_SPEED_DVD
-BRASERO_RATE_TO_SPEED_BD
-BRASERO_DURATION_TO_BYTES
-BRASERO_DURATION_TO_SECTORS
-BRASERO_BYTES_TO_SECTORS
-BRASERO_BYTES_TO_DURATION
-brasero_units_get_time_string
-brasero_units_get_time_string_from_size
+<FILE>brasero-track-stream</FILE>
+<TITLE>BraseroTrackStream</TITLE>
+BraseroTrackStream
+brasero_track_stream_new
+brasero_track_stream_set_source
+brasero_track_stream_set_format
+brasero_track_stream_set_boundaries
+brasero_track_stream_get_source
+brasero_track_stream_get_length
+brasero_track_stream_get_start
+brasero_track_stream_get_end
+brasero_track_stream_get_gap
+brasero_track_stream_get_format
+<SUBSECTION Standard>
+BRASERO_TRACK_STREAM
+BRASERO_IS_TRACK_STREAM
+BRASERO_TYPE_TRACK_STREAM
+brasero_track_stream_get_type
+BRASERO_TRACK_STREAM_CLASS
+BRASERO_IS_TRACK_STREAM_CLASS
+BRASERO_TRACK_STREAM_GET_CLASS
</SECTION>
<SECTION>
-<FILE>brasero-media</FILE>
-LIBBRASERO_MEDIA_VERSION_MAJOR
-LIBBRASERO_MEDIA_VERSION_MINOR
-LIBBRASERO_MEDIA_VERSION_MICRO
-LIBBRASERO_MEDIA_AGE
-LIBBRASERO_MEDIA_INSTALL
-brasero_media_library_start
-brasero_media_library_stop
-brasero_media_get_option_group
-brasero_media_quark
-BRASERO_MEDIA_ERROR
-BraseroMediaError
-BraseroMedia
-BRASERO_MEDIUM_CDROM
-BRASERO_MEDIUM_CDR
-BRASERO_MEDIUM_CDRW
-BRASERO_MEDIUM_DVD_ROM
-BRASERO_MEDIUM_DVDR
-BRASERO_MEDIUM_DVDRW
-BRASERO_MEDIUM_DVDRW_RESTRICTED
-BRASERO_MEDIUM_DVDR_DL
-BRASERO_MEDIUM_DVDR_JUMP_DL
-BRASERO_MEDIUM_DVDR_PLUS
-BRASERO_MEDIUM_DVDRW_PLUS
-BRASERO_MEDIUM_DVDR_PLUS_DL
-BRASERO_MEDIUM_DVDRW_PLUS_DL
-BRASERO_MEDIUM_DVD_RAM
-BRASERO_MEDIUM_BD_ROM
-BRASERO_MEDIUM_BDR_SRM
-BRASERO_MEDIUM_BDR_SRM_POW
-BRASERO_MEDIUM_BDR_RANDOM
-BRASERO_MEDIUM_BDRE
-BRASERO_MEDIUM_VALID
-BRASERO_MEDIUM_TYPE
-BRASERO_MEDIUM_ATTR
-BRASERO_MEDIUM_STATUS
-BRASERO_MEDIUM_SUBTYPE
-BRASERO_MEDIUM_INFO
-BRASERO_MEDIUM_IS
-BRASERO_MEDIUM_RANDOM_WRITABLE
+<FILE>brasero-enums</FILE>
+BraseroBurnResult
+BraseroBurnFlag
+BraseroBurnAction
+BraseroImageFS
+BraseroStreamFormat
+BRASERO_STREAM_FORMAT_AUDIO
+BRASERO_STREAM_FORMAT_VIDEO
+BRASERO_MIN_STREAM_LENGTH
+BRASERO_STREAM_LENGTH
+BRASERO_STREAM_FORMAT_HAS_VIDEO
+BraseroImageFormat
+</SECTION>
+
+<SECTION>
+<FILE>brasero-burn-lib</FILE>
+LIBBRASERO_BURN_VERSION_MAJOR
+LIBBRASERO_BURN_VERSION_MINOR
+LIBBRASERO_BURN_VERSION_MICRO
+LIBBRASERO_BURN_AGE
+brasero_burn_library_start
+brasero_burn_library_stop
+brasero_burn_library_get_option_group
+brasero_burn_library_get_plugins_list
+brasero_burn_library_can_checksum
+brasero_burn_library_input_supported
+brasero_burn_library_get_media_capabilities
+</SECTION>
+
+<SECTION>
+<FILE>brasero-tags</FILE>
+BRASERO_TRACK_MEDIUM_ADDRESS_START_TAG
+BRASERO_TRACK_MEDIUM_ADDRESS_END_TAG
+BRASERO_TRACK_MEDIUM_WRONG_CHECKSUM_TAG
+BRASERO_TRACK_STREAM_TITLE_TAG
+BRASERO_TRACK_STREAM_COMPOSER_TAG
+BRASERO_TRACK_STREAM_ARTIST_TAG
+BRASERO_TRACK_STREAM_THUMBNAIL_TAG
+BRASERO_TRACK_STREAM_MIME_TAG
+BRASERO_TRACK_STREAM_ISRC_TAG
+BRASERO_DATA_TRACK_SIZE_TAG
+BRASERO_STREAM_TRACK_SIZE_TAG
+BRASERO_COVER_URI
+BRASERO_DVD_STREAM_FORMAT
+BRASERO_VCD_TYPE
+BRASERO_VIDEO_OUTPUT_FRAMERATE
+BRASERO_VIDEO_OUTPUT_ASPECT
</SECTION>
<SECTION>
@@ -630,33 +472,10 @@ brasero_track_type_equal
</SECTION>
<SECTION>
-<FILE>brasero-burn-lib</FILE>
-LIBBRASERO_BURN_VERSION_MAJOR
-LIBBRASERO_BURN_VERSION_MINOR
-LIBBRASERO_BURN_VERSION_MICRO
-LIBBRASERO_BURN_AGE
-brasero_burn_library_start
-brasero_burn_library_stop
-brasero_burn_library_get_option_group
-brasero_burn_library_get_plugins_list
-brasero_burn_library_can_checksum
-brasero_burn_library_input_supported
-brasero_burn_library_get_media_capabilities
-</SECTION>
-
-<SECTION>
-<FILE>brasero-enums</FILE>
-BraseroBurnResult
-BraseroBurnFlag
-BraseroBurnAction
-BraseroImageFS
-BraseroStreamFormat
-BRASERO_STREAM_FORMAT_AUDIO
-BRASERO_STREAM_FORMAT_VIDEO
-BRASERO_MIN_STREAM_LENGTH
-BRASERO_STREAM_LENGTH
-BRASERO_STREAM_FORMAT_HAS_VIDEO
-BraseroImageFormat
+<FILE>brasero-error</FILE>
+BraseroBurnError
+brasero_burn_quark
+BRASERO_BURN_ERROR
</SECTION>
<SECTION>
@@ -674,30 +493,3 @@ brasero_status_set_not_ready
brasero_status_set_error
</SECTION>
-<SECTION>
-<FILE>brasero-error</FILE>
-BraseroBurnError
-brasero_burn_quark
-BRASERO_BURN_ERROR
-</SECTION>
-
-<SECTION>
-<FILE>brasero-tags</FILE>
-BRASERO_TRACK_MEDIUM_ADDRESS_START_TAG
-BRASERO_TRACK_MEDIUM_ADDRESS_END_TAG
-BRASERO_TRACK_MEDIUM_WRONG_CHECKSUM_TAG
-BRASERO_TRACK_STREAM_TITLE_TAG
-BRASERO_TRACK_STREAM_COMPOSER_TAG
-BRASERO_TRACK_STREAM_ARTIST_TAG
-BRASERO_TRACK_STREAM_THUMBNAIL_TAG
-BRASERO_TRACK_STREAM_MIME_TAG
-BRASERO_TRACK_STREAM_ISRC_TAG
-BRASERO_DATA_TRACK_SIZE_TAG
-BRASERO_STREAM_TRACK_SIZE_TAG
-BRASERO_COVER_URI
-BRASERO_DVD_STREAM_FORMAT
-BRASERO_VCD_TYPE
-BRASERO_VIDEO_OUTPUT_FRAMERATE
-BRASERO_VIDEO_OUTPUT_ASPECT
-</SECTION>
-
diff --git a/docs/reference/version.xml.in b/docs/reference/libbrasero-burn/version.xml.in
similarity index 100%
copy from docs/reference/version.xml.in
copy to docs/reference/libbrasero-burn/version.xml.in
diff --git a/docs/reference/libbrasero-media/Makefile.am b/docs/reference/libbrasero-media/Makefile.am
new file mode 100644
index 0000000..d40d1a8
--- /dev/null
+++ b/docs/reference/libbrasero-media/Makefile.am
@@ -0,0 +1,133 @@
+## 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=libbrasero-media
+
+# The top-level SGML file. You can change this if you want to.
+DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
+
+# 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=$(top_srcdir)/libbrasero-media
+
+# 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)/libbrasero-media/*.h
+CFILE_GLOB=$(top_srcdir)/libbrasero-media/*.c
+
+# Header files to ignore when scanning.
+# e.g. IGNORE_HFILES=gtkdebug.h gtkintl.h
+IGNORE_HFILES= libbrasero-marshal.h \
+ brasero-gio-operation.h \
+ burn-volume-source.h \
+ scsi-base.h \
+ scsi-error.h \
+ scsi-mmc1.h \
+ scsi-opcodes.h \
+ scsi-read-disc-info.h \
+ scsi-read-track-information.h \
+ scsi-status-page.h \
+ scsi-command.h \
+ scsi-get-configuration.h \
+ scsi-mmc2.h \
+ scsi-q-subchannel.h \
+ scsi-read-disc-structure.h \
+ scsi-sbc.h \
+ scsi-utils.h \
+ scsi-device.h \
+ scsi-get-performance.h \
+ scsi-mmc3.h \
+ scsi-read-capacity.h \
+ scsi-read-format-capacities.h \
+ scsi-sense-data.h \
+ scsi-write-page.h \
+ scsi-dvd-structures.h \
+ scsi-mech-status.h \
+ scsi-mode-pages.h \
+ scsi-read-cd.h \
+ scsi-read-toc-pma-atip.h \
+ scsi-spc1.h \
+ burn-iso-field.h \
+ burn-iso9660.h \
+ burn-volume.h \
+ brasero-media-private.h \
+ brasero-medium-selection-priv.h \
+ burn-susp.h \
+ scsi-inquiry.h
+
+
+# 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=version.xml
+
+# 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= \
+ -I$(top_srcdir) \
+ -I$(top_builddir) \
+ $(BRASERO_GLIB_CFLAGS) \
+ $(BRASERO_IO_CFLAGS) \
+ $(BRASERO_GTK_CFLAGS)
+
+GTKDOC_LIBS=$(top_builddir)/libbrasero-media/libbrasero-media.la
+
+# 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 += version.xml.in
+
+# Files not to distribute
+# for --rebuild-types in $(SCAN_OPTIONS), e.g. $(DOC_MODULE).types
+# for --rebuild-sections in $(SCAN_OPTIONS) e.g. $(DOC_MODULE)-sections.txt
+#DISTCLEANFILES +=
+
+# Comment this out if you want your docs-status tested during 'make check'
+#TESTS = $(GTKDOC_CHECK)
+
+
+
+-include $(top_srcdir)/git.mk
diff --git a/docs/reference/libbrasero-media/libbrasero-media-docs.sgml b/docs/reference/libbrasero-media/libbrasero-media-docs.sgml
new file mode 100644
index 0000000..c7ec48c
--- /dev/null
+++ b/docs/reference/libbrasero-media/libbrasero-media-docs.sgml
@@ -0,0 +1,37 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
+ "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd";
+[
+ <!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
+]>
+<book id="index">
+ <bookinfo>
+ <title>Libbrasero-media Reference Manual</title>
+ <releaseinfo>
+ for Libbrasero-media [VERSION]
+ </releaseinfo>
+ </bookinfo>
+
+ <chapter>
+ <title>API Reference for Libbrasero-media</title>
+ <xi:include href="xml/brasero-media.xml"/>
+ <xi:include href="xml/brasero-units.xml"/>
+ <xi:include href="xml/brasero-medium-monitor.xml"/>
+ <xi:include href="xml/brasero-drive.xml"/>
+ <xi:include href="xml/brasero-medium.xml"/>
+ <xi:include href="xml/brasero-volume.xml"/>
+ <xi:include href="xml/brasero-medium-selection.xml"/>
+ <xi:include href="xml/brasero-drive-selection.xml"/>
+
+ </chapter>
+ <chapter id="object-tree">
+ <title>Object Hierarchy</title>
+ <xi:include href="xml/tree_index.sgml"/>
+ </chapter>
+ <index id="api-index-full">
+ <title>API Index</title>
+ <xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
+ </index>
+
+ <xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
+</book>
diff --git a/docs/reference/libbrasero-media/libbrasero-media-sections.txt b/docs/reference/libbrasero-media/libbrasero-media-sections.txt
new file mode 100644
index 0000000..b44162c
--- /dev/null
+++ b/docs/reference/libbrasero-media/libbrasero-media-sections.txt
@@ -0,0 +1,209 @@
+<SECTION>
+<FILE>brasero-volume</FILE>
+<TITLE>BraseroVolume</TITLE>
+BraseroVolume
+brasero_volume_get_name
+brasero_volume_get_icon
+brasero_volume_get_gvolume
+brasero_volume_is_mounted
+brasero_volume_get_mount_point
+brasero_volume_umount
+brasero_volume_mount
+brasero_volume_cancel_current_operation
+<SUBSECTION Standard>
+BRASERO_VOLUME
+BRASERO_IS_VOLUME
+BRASERO_TYPE_VOLUME
+brasero_volume_get_type
+BRASERO_VOLUME_CLASS
+BRASERO_IS_VOLUME_CLASS
+BRASERO_VOLUME_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-medium-selection</FILE>
+<TITLE>BraseroMediumSelection</TITLE>
+BraseroMediumSelection
+brasero_medium_selection_new
+brasero_medium_selection_get_active
+brasero_medium_selection_set_active
+brasero_medium_selection_show_media_type
+<SUBSECTION Standard>
+BRASERO_MEDIUM_SELECTION
+BRASERO_IS_MEDIUM_SELECTION
+BRASERO_TYPE_MEDIUM_SELECTION
+brasero_medium_selection_get_type
+BRASERO_MEDIUM_SELECTION_CLASS
+BRASERO_IS_MEDIUM_SELECTION_CLASS
+BRASERO_MEDIUM_SELECTION_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-medium-monitor</FILE>
+<TITLE>BraseroMediumMonitor</TITLE>
+BraseroMediumMonitor
+brasero_medium_monitor_get_default
+BraseroMediaType
+BraseroDriveType
+brasero_medium_monitor_get_media
+brasero_medium_monitor_get_drives
+brasero_medium_monitor_get_drive
+brasero_medium_monitor_is_probing
+<SUBSECTION Standard>
+BRASERO_MEDIUM_MONITOR
+BRASERO_IS_MEDIUM_MONITOR
+BRASERO_TYPE_MEDIUM_MONITOR
+brasero_medium_monitor_get_type
+BRASERO_MEDIUM_MONITOR_CLASS
+BRASERO_IS_MEDIUM_MONITOR_CLASS
+BRASERO_MEDIUM_MONITOR_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-drive</FILE>
+BraseroDriveCaps
+<TITLE>BraseroDrive</TITLE>
+BraseroDrive
+brasero_drive_reprobe
+brasero_drive_get_medium
+brasero_drive_get_gdrive
+brasero_drive_get_udi
+brasero_drive_is_fake
+brasero_drive_get_display_name
+brasero_drive_get_device
+brasero_drive_get_block_device
+brasero_drive_get_bus_target_lun_string
+brasero_drive_get_caps
+brasero_drive_can_write
+brasero_drive_can_eject
+brasero_drive_eject
+brasero_drive_cancel_current_operation
+brasero_drive_is_door_open
+brasero_drive_can_use_exclusively
+brasero_drive_lock
+brasero_drive_unlock
+<SUBSECTION Standard>
+BRASERO_DRIVE
+BRASERO_IS_DRIVE
+BRASERO_TYPE_DRIVE
+brasero_drive_get_type
+BRASERO_DRIVE_CLASS
+BRASERO_IS_DRIVE_CLASS
+BRASERO_DRIVE_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-drive-selection</FILE>
+<TITLE>BraseroDriveSelection</TITLE>
+BraseroDriveSelection
+brasero_drive_selection_new
+brasero_drive_selection_get_active
+brasero_drive_selection_set_active
+brasero_drive_selection_show_type
+<SUBSECTION Standard>
+BRASERO_DRIVE_SELECTION
+BRASERO_IS_DRIVE_SELECTION
+BRASERO_TYPE_DRIVE_SELECTION
+brasero_drive_selection_get_type
+BRASERO_DRIVE_SELECTION_CLASS
+BRASERO_IS_DRIVE_SELECTION_CLASS
+BRASERO_DRIVE_SELECTION_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-medium</FILE>
+<TITLE>BraseroMedium</TITLE>
+BraseroMedium
+brasero_medium_get_status
+brasero_medium_get_max_write_speed
+brasero_medium_get_write_speeds
+brasero_medium_get_free_space
+brasero_medium_get_capacity
+brasero_medium_get_data_size
+brasero_medium_get_next_writable_address
+brasero_medium_can_be_rewritten
+brasero_medium_can_be_written
+brasero_medium_get_CD_TEXT_title
+brasero_medium_get_type_string
+brasero_medium_get_tooltip
+brasero_medium_get_drive
+brasero_medium_get_track_num
+brasero_medium_get_last_data_track_space
+brasero_medium_get_last_data_track_address
+brasero_medium_get_track_space
+brasero_medium_get_track_address
+brasero_medium_can_use_dummy_for_sao
+brasero_medium_can_use_dummy_for_tao
+brasero_medium_can_use_burnfree
+<SUBSECTION Standard>
+BRASERO_MEDIUM
+BRASERO_IS_MEDIUM
+BRASERO_TYPE_MEDIUM
+brasero_medium_get_type
+BRASERO_MEDIUM_CLASS
+BRASERO_IS_MEDIUM_CLASS
+BRASERO_MEDIUM_GET_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>brasero-units</FILE>
+CD_RATE
+DVD_RATE
+BD_RATE
+BRASERO_SPEED_TO_RATE_CD
+BRASERO_SPEED_TO_RATE_DVD
+BRASERO_SPEED_TO_RATE_BD
+BRASERO_RATE_TO_SPEED_CD
+BRASERO_RATE_TO_SPEED_DVD
+BRASERO_RATE_TO_SPEED_BD
+BRASERO_DURATION_TO_BYTES
+BRASERO_DURATION_TO_SECTORS
+BRASERO_BYTES_TO_SECTORS
+BRASERO_BYTES_TO_DURATION
+brasero_units_get_time_string
+brasero_units_get_time_string_from_size
+</SECTION>
+
+<SECTION>
+<FILE>brasero-media</FILE>
+LIBBRASERO_MEDIA_VERSION_MAJOR
+LIBBRASERO_MEDIA_VERSION_MINOR
+LIBBRASERO_MEDIA_VERSION_MICRO
+LIBBRASERO_MEDIA_AGE
+LIBBRASERO_MEDIA_INSTALL
+brasero_media_library_start
+brasero_media_library_stop
+brasero_media_get_option_group
+brasero_media_quark
+BRASERO_MEDIA_ERROR
+BraseroMediaError
+BraseroMedia
+BRASERO_MEDIUM_CDROM
+BRASERO_MEDIUM_CDR
+BRASERO_MEDIUM_CDRW
+BRASERO_MEDIUM_DVD_ROM
+BRASERO_MEDIUM_DVDR
+BRASERO_MEDIUM_DVDRW
+BRASERO_MEDIUM_DVDRW_RESTRICTED
+BRASERO_MEDIUM_DVDR_DL
+BRASERO_MEDIUM_DVDR_JUMP_DL
+BRASERO_MEDIUM_DVDR_PLUS
+BRASERO_MEDIUM_DVDRW_PLUS
+BRASERO_MEDIUM_DVDR_PLUS_DL
+BRASERO_MEDIUM_DVDRW_PLUS_DL
+BRASERO_MEDIUM_DVD_RAM
+BRASERO_MEDIUM_BD_ROM
+BRASERO_MEDIUM_BDR_SRM
+BRASERO_MEDIUM_BDR_SRM_POW
+BRASERO_MEDIUM_BDR_RANDOM
+BRASERO_MEDIUM_BDRE
+BRASERO_MEDIUM_VALID
+BRASERO_MEDIUM_TYPE
+BRASERO_MEDIUM_ATTR
+BRASERO_MEDIUM_STATUS
+BRASERO_MEDIUM_SUBTYPE
+BRASERO_MEDIUM_INFO
+BRASERO_MEDIUM_IS
+BRASERO_MEDIUM_RANDOM_WRITABLE
+</SECTION>
+
diff --git a/docs/reference/version.xml.in b/docs/reference/libbrasero-media/version.xml.in
similarity index 100%
rename from docs/reference/version.xml.in
rename to docs/reference/libbrasero-media/version.xml.in
diff --git a/libbrasero-burn/brasero-track-data.c b/libbrasero-burn/brasero-track-data.c
index 2e4ccf0..f47561f 100644
--- a/libbrasero-burn/brasero-track-data.c
+++ b/libbrasero-burn/brasero-track-data.c
@@ -54,6 +54,13 @@ struct _BraseroTrackDataPrivate
G_DEFINE_TYPE (BraseroTrackData, brasero_track_data, BRASERO_TYPE_TRACK);
+/**
+ * brasero_graft_point_free:
+ * @graft: a #BraseroGraftPt
+ *
+ * Frees @graft. Do not use @grafts afterwards.
+ *
+ **/
void
brasero_graft_point_free (BraseroGraftPt *graft)
@@ -65,6 +72,15 @@ brasero_graft_point_free (BraseroGraftPt *graft)
g_free (graft);
}
+/**
+ * brasero_graft_point_copy:
+ * @graft: a #BraseroGraftPt
+ *
+ * Copies @graft.
+ *
+ * Return value: a #BraseroGraftPt.
+ **/
+
BraseroGraftPt *
brasero_graft_point_copy (BraseroGraftPt *graft)
{
@@ -80,7 +96,7 @@ brasero_graft_point_copy (BraseroGraftPt *graft)
return newgraft;
}
-BraseroBurnResult
+static BraseroBurnResult
brasero_track_data_set_source_real (BraseroTrackData *track,
GSList *grafts,
GSList *unreadable)
@@ -108,6 +124,23 @@ brasero_track_data_set_source_real (BraseroTrackData *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_data_set_source:
+ * @track: a #BraseroTrackData
+ * @grafts: a #GSList of #BraseroGraftPt
+ * @unreadable: a #GSList of URIS as strings
+ *
+ * Sets the lists of grafts points (@grafts) and excluded
+ * URIs (@unreadable) to be used to create an image.
+ *
+ * Be careful @track takes ownership of @grafts and
+ * @unreadable which must not be freed afterwards.
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_data_set_source (BraseroTrackData *track,
GSList *grafts,
@@ -132,6 +165,19 @@ brasero_track_data_add_fs_real (BraseroTrackData *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_data_add_fs:
+ * @track: a #BraseroTrackData
+ * @fstype: a #BraseroImageFS
+ *
+ * Adds one or more parameters determining the file system type
+ * and various other options to create an image.
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_data_add_fs (BraseroTrackData *track,
BraseroImageFS fstype)
@@ -168,6 +214,19 @@ brasero_track_data_rm_fs_real (BraseroTrackData *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_data_rm_fs:
+ * @track: a #BraseroTrackData
+ * @fstype: a #BraseroImageFS
+ *
+ * Removes one or more parameters determining the file system type
+ * and various other options to create an image.
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_data_rm_fs (BraseroTrackData *track,
BraseroImageFS fstype)
@@ -193,6 +252,18 @@ brasero_track_data_rm_fs (BraseroTrackData *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_data_set_data_blocks:
+ * @track: a #BraseroTrackData
+ * @blocks: a #goffset
+ *
+ * Sets the size of the image to be created (in sectors of 2048 bytes).
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_data_set_data_blocks (BraseroTrackData *track,
goffset blocks)
@@ -207,6 +278,18 @@ brasero_track_data_set_data_blocks (BraseroTrackData *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_data_set_file_num:
+ * @track: a #BraseroTrackData
+ * @number: a #guint64
+ *
+ * Sets the number of files (not directories) in @track.
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_data_set_file_num (BraseroTrackData *track,
guint64 number)
@@ -221,6 +304,16 @@ brasero_track_data_set_file_num (BraseroTrackData *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_data_get_fs:
+ * @track: a #BraseroTrackData
+ *
+ * Returns the parameters determining the file system type
+ * and various other options to create an image.
+ *
+ * Return value: a #BraseroImageFS.
+ **/
+
BraseroImageFS
brasero_track_data_get_fs (BraseroTrackData *track)
{
@@ -232,7 +325,7 @@ brasero_track_data_get_fs (BraseroTrackData *track)
return klass->get_fs (track);
}
-BraseroImageFS
+static BraseroImageFS
brasero_track_data_get_fs_real (BraseroTrackData *track)
{
BraseroTrackDataPrivate *priv;
@@ -241,6 +334,17 @@ brasero_track_data_get_fs_real (BraseroTrackData *track)
return priv->fs_type;
}
+/**
+ * brasero_track_data_get_fs:
+ * @track: a #BraseroTrackData
+ *
+ * Returns a list of #BraseroGraftPt.
+ *
+ * Do not free after usage as @track retains ownership.
+ *
+ * Return value: a #GSList of #BraseroGraftPt or NULL if empty.
+ **/
+
GSList *
brasero_track_data_get_grafts (BraseroTrackData *track)
{
@@ -261,6 +365,21 @@ brasero_track_data_get_grafts_real (BraseroTrackData *track)
return priv->grafts;
}
+/**
+ * brasero_track_data_get_excluded:
+ * @track: a #BraseroTrackData
+ * @copy: a #gboolean
+ *
+ * Returns a list of URIs which must not be included in
+ * the image to be created.
+ * If @copy is TRUE then the @list is a copy and must
+ * be freed once it is not needed anymore. If FALSE,
+ * do not free after usage as @track retains ownership.
+ *
+ * Return value: a #GSList of #gchar * or NULL if no
+ * URI should be excluded.
+ **/
+
GSList *
brasero_track_data_get_excluded (BraseroTrackData *track,
gboolean copy)
@@ -296,6 +415,30 @@ brasero_track_data_get_excluded_real (BraseroTrackData *track)
return priv->excluded;
}
+/**
+ * brasero_track_data_get_paths:
+ * @track: a #BraseroTrackData
+ * @use_joliet: a #gboolean
+ * @grafts_path: a #gchar
+ * @excluded_path: a #gchar
+ * @emptydir: a #gchar
+ * @videodir: a #gchar
+ * @error: a #GError
+ *
+ * Write in @grafts_path (a path to a file) the graft points,
+ * in @excluded_path (a path to a file) the list of paths to
+ * be excluded, @emptydir (a path to a file) an empty
+ * directory to be used for created directories, @videodir
+ * (a path to a file) for a directory to be used to build the
+ * the video image.
+ *
+ * This is mostly for internal use by mkisofs and similar.
+ *
+ * This function takes care of mangling.
+ *
+ * Return value: a #BraseroBurnResult.
+ **/
+
BraseroBurnResult
brasero_track_data_get_paths (BraseroTrackData *track,
gboolean use_joliet,
@@ -327,6 +470,17 @@ brasero_track_data_get_paths (BraseroTrackData *track,
return result;
}
+/**
+ * brasero_track_data_get_file_num:
+ * @track: a #BraseroTrackData
+ * @file_num: a #guint64
+ *
+ * Sets the number of files (not directories) in @file_num.
+ *
+ * Return value: a #BraseroBurnResult. TRUE if @file_num
+ * was set, FALSE otherwise.
+ **/
+
BraseroBurnResult
brasero_track_data_get_file_num (BraseroTrackData *track,
guint64 *file_num)
@@ -456,6 +610,14 @@ brasero_track_data_class_init (BraseroTrackDataClass *klass)
track_data_class->get_file_num = brasero_track_data_get_file_num_real;
}
+/**
+ * brasero_track_data_new:
+ *
+ * Creates a new #BraseroTrackData.
+ *
+ * Return value: a #BraseroTrackData
+ **/
+
BraseroTrackData *
brasero_track_data_new (void)
{
diff --git a/libbrasero-burn/brasero-track-data.h b/libbrasero-burn/brasero-track-data.h
index a418239..6c90a21 100644
--- a/libbrasero-burn/brasero-track-data.h
+++ b/libbrasero-burn/brasero-track-data.h
@@ -129,7 +129,7 @@ brasero_track_data_get_paths (BraseroTrackData *track,
BraseroBurnResult
brasero_track_data_get_file_num (BraseroTrackData *track,
- guint64 *num_files);
+ guint64 *file_num);
BraseroImageFS
brasero_track_data_get_fs (BraseroTrackData *track);
diff --git a/libbrasero-burn/brasero-track.c b/libbrasero-burn/brasero-track.c
index e9a0842..f1bb4e4 100644
--- a/libbrasero-burn/brasero-track.c
+++ b/libbrasero-burn/brasero-track.c
@@ -62,6 +62,16 @@ static guint track_signals[LAST_SIGNAL] = { 0 };
G_DEFINE_TYPE (BraseroTrack, brasero_track, G_TYPE_OBJECT);
+/**
+ * brasero_track_get_track_type:
+ * @track: a #BraseroTrack
+ * @type: a #BraseroTrackType or NULL
+ *
+ * Sets @type to reflect the type of data contained in @track
+ *
+ * Return value: the#BraseroTrackDataType of the track
+ **/
+
BraseroTrackDataType
brasero_track_get_track_type (BraseroTrack *track,
BraseroTrackType *type)
@@ -77,6 +87,20 @@ brasero_track_get_track_type (BraseroTrack *track,
return klass->get_type (track, type);
}
+/**
+ * brasero_track_get_size:
+ * @track: a #BraseroTrack
+ * @blocks: a #goffset or NULL
+ * @bytes: a #goffset or NULL
+ *
+ * Returns the size of the data contained by @track in bytes or in sectors
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful
+ * BRASERO_BURN_NOT_READY if @track needs more time for processing the size
+ * BRASERO_BURN_ERR if something is wrong or if it is empty
+ **/
+
BraseroBurnResult
brasero_track_get_size (BraseroTrack *track,
goffset *blocks,
@@ -106,6 +130,19 @@ brasero_track_get_size (BraseroTrack *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_get_status:
+ * @track: a #BraseroTrack
+ * @status: a #BraseroTrackStatus
+ *
+ * Sets @status to reflect whether @track is ready to be used
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful
+ * BRASERO_BURN_NOT_READY if @track needs more time for processing
+ * BRASERO_BURN_ERR if something is wrong or if it is empty
+ **/
+
BraseroBurnResult
brasero_track_get_status (BraseroTrack *track,
BraseroStatus *status)
@@ -131,8 +168,17 @@ brasero_track_get_status (BraseroTrack *track,
}
/**
+ * brasero_track_set_checksum:
+ * @track: a #BraseroTrack
+ * @type: a #BraseroChecksumType
+ * @checksum: a #gchar * holding the checksum
*
- */
+ * Sets a checksum for the track
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if the checksum was previously empty or matches the new one
+ * BRASERO_BURN_ERR otherwise
+ **/
BraseroBurnResult
brasero_track_set_checksum (BraseroTrack *track,
@@ -162,6 +208,15 @@ brasero_track_set_checksum (BraseroTrack *track,
return result;
}
+/**
+ * brasero_track_get_checksum:
+ * @track: a #BraseroTrack
+ *
+ * Get the current checksum (as a string) for the track
+ *
+ * Return value: a #gchar * (not to be freed) or NULL
+ **/
+
const gchar *
brasero_track_get_checksum (BraseroTrack *track)
{
@@ -170,9 +225,18 @@ brasero_track_get_checksum (BraseroTrack *track)
g_return_val_if_fail (BRASERO_IS_TRACK (track), NULL);
priv = BRASERO_TRACK_PRIVATE (track);
- return priv->checksum ? priv->checksum : "";
+ return priv->checksum ? priv->checksum : NULL;
}
+/**
+ * brasero_track_get_checksum_type:
+ * @track: a #BraseroTrack
+ *
+ * Get the current checksum type for the track if any.
+ *
+ * Return value: a #BraseroChecksumType
+ **/
+
BraseroChecksumType
brasero_track_get_checksum_type (BraseroTrack *track)
{
@@ -196,6 +260,22 @@ brasero_track_tag_value_free (gpointer user_data)
g_free (value);
}
+/**
+ * brasero_track_tag_add:
+ * @track: a #BraseroTrack
+ * @tag: a #gchar *
+ * @value: a #GValue
+ *
+ * Associates a new @tag with a track. This can be used
+ * to pass arbitrary information for plugin, like parameters
+ * for video discs, ...
+ * See brasero-tags.h for a list of knowns tags.
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_tag_add (BraseroTrack *track,
const gchar *tag,
@@ -219,6 +299,21 @@ brasero_track_tag_add (BraseroTrack *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_tag_add_int:
+ * @track: a #BraseroTrack
+ * @tag: a #gchar *
+ * @value: a #int
+ *
+ * A wrapper around brasero_track_tag_add () to associate
+ * a int value with @track
+ * See also brasero_track_tag_add ()
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_tag_add_int (BraseroTrack *track,
const gchar *tag,
@@ -233,6 +328,21 @@ brasero_track_tag_add_int (BraseroTrack *track,
return brasero_track_tag_add (track, tag, value);
}
+/**
+ * brasero_track_tag_add_string:
+ * @track: a #BraseroTrack
+ * @tag: a #gchar *
+ * @string: a #gchar *
+ *
+ * A wrapper around brasero_track_tag_add () to associate
+ * a string with @track
+ * See also brasero_track_tag_add ()
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if it was successful,
+ * BRASERO_BURN_ERR otherwise.
+ **/
+
BraseroBurnResult
brasero_track_tag_add_string (BraseroTrack *track,
const gchar *tag,
@@ -247,6 +357,21 @@ brasero_track_tag_add_string (BraseroTrack *track,
return brasero_track_tag_add (track, tag, value);
}
+/**
+ * brasero_track_tag_lookup:
+ * @track: a #BraseroTrack
+ * @tag: a #gchar *
+ * @value: a #GValue **
+ *
+ * Retrieves a value associated with @track through
+ * brasero_track_tag_add () and stores it in @value. Do
+ * not destroy @value afterwards as it is not a copy
+ *
+ * Return value: a #BraseroBurnResult.
+ * BRASERO_BURN_OK if the retrieval was successful
+ * BRASERO_BURN_ERR otherwise
+ **/
+
BraseroBurnResult
brasero_track_tag_lookup (BraseroTrack *track,
const gchar *tag,
@@ -272,6 +397,17 @@ brasero_track_tag_lookup (BraseroTrack *track,
return BRASERO_BURN_OK;
}
+/**
+ * brasero_track_tag_lookup_int:
+ * @track: a #BraseroTrack
+ * @tag: a #gchar *
+ *
+ * Retrieves a int value associated with @track. This
+ * is a wrapper around brasero_track_tag_lookup ().
+ *
+ * Return value: a #int; the value or 0 otherwise
+ **/
+
int
brasero_track_tag_lookup_int (BraseroTrack *track,
const gchar *tag)
@@ -292,6 +428,18 @@ brasero_track_tag_lookup_int (BraseroTrack *track,
return g_value_get_int (value);
}
+/**
+ * brasero_track_tag_lookup_string:
+ * @track: a #BraseroTrack
+ * @tag: a #gchar *
+ *
+ * Retrieves a string value associated with @track. This
+ * is a wrapper around brasero_track_tag_lookup ().
+ *
+ * Return value: a #gchar *. The value or NULL otherwise.
+ * Do not free the string as it is not a copy.
+ **/
+
const gchar *
brasero_track_tag_lookup_string (BraseroTrack *track,
const gchar *tag)
@@ -312,6 +460,16 @@ brasero_track_tag_lookup_string (BraseroTrack *track,
return g_value_get_string (value);
}
+/**
+ * brasero_track_tag_copy_missing:
+ * @dest: a #BraseroTrack
+ * @src: a #BraseroTrack
+ *
+ * Adds all tags of @dest to @src provided they do not
+ * already exists.
+ *
+ **/
+
void
brasero_track_tag_copy_missing (BraseroTrack *dest,
BraseroTrack *src)
@@ -355,6 +513,15 @@ brasero_track_tag_copy_missing (BraseroTrack *dest,
}
}
+/**
+ * brasero_track_changed:
+ * @track: a #BraseroTrack
+ *
+ * Used internally in #BraseroTrack implementations to
+ * signal a #BraseroTrack object has changed.
+ *
+ **/
+
void
brasero_track_changed (BraseroTrack *track)
{
diff --git a/libbrasero-media/brasero-drive.c b/libbrasero-media/brasero-drive.c
index da2165f..db32e8b 100644
--- a/libbrasero-media/brasero-drive.c
+++ b/libbrasero-media/brasero-drive.c
@@ -266,7 +266,6 @@ brasero_drive_cancel_current_operation (BraseroDrive *drive)
*
* Return value: a string or NULL. The string must be freed when not needed
*
- * Deprecated since 2.27.3
**/
gchar *
brasero_drive_get_bus_target_lun_string (BraseroDrive *drive)
@@ -1297,7 +1296,7 @@ brasero_drive_class_init (BraseroDriveClass *klass)
g_object_class_install_property (object_class,
PROP_UDI,
g_param_spec_string("udi",
- "Deprecated",
+ "udi",
"HAL udi as a string (Deprecated)",
NULL,
G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY));
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
