libcddb: headers diff between 1.2.2 and 1.3.0 versions

	cddb.h	cddb.h
	/*	/*

	$Id: cddb.h,v 1.12 2005/05/29 08:06:11 airborne Exp $	$Id: cddb.h,v 1.13 2006/10/15 11:48:39 airborne Exp $

	Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>	Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>

	This library is free software; you can redistribute it and/or	This library is free software; you can redistribute it and/or
	modify it under the terms of the GNU Library General Public	modify it under the terms of the GNU Library General Public
	License as published by the Free Software Foundation; either	License as published by the Free Software Foundation; either
	version 2 of the License, or (at your option) any later version.	version 2 of the License, or (at your option) any later version.

	This library is distributed in the hope that it will be useful,	This library is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of	but WITHOUT ANY WARRANTY; without even the implied warranty of

	skipping to change at line 44	skipping to change at line 44
	#include <cddb/cddb_disc.h>	#include <cddb/cddb_disc.h>
	#include <cddb/cddb_site.h>	#include <cddb/cddb_site.h>
	#include <cddb/cddb_conn.h>	#include <cddb/cddb_conn.h>
	#include <cddb/cddb_cmd.h>	#include <cddb/cddb_cmd.h>
	#include <cddb/cddb_log.h>	#include <cddb/cddb_log.h>

	/**	/**
	* \mainpage libCDDB, a C API for CDDB server access	* \mainpage libCDDB, a C API for CDDB server access
	*/	*/


		#define BIT(n) (1 << n)

		/**
		* An enumeration of flags that influence the behaviour of the
		* library. You can set (enable) or reset (disable) these flags using
		* the #libcddb_set_flags and #libcddb_reset_flags fucntions.
		*/
		typedef enum {
		CDDB_F_EMPTY_STR = BIT(0), /**< never return NULL pointer strings
		(default), return an empty string
		instead */
		CDDB_F_NO_TRACK_ARTIST = BIT(1), /**< do not return the disc artist as
		the
		track artist (default), return NULL
		instead */
		} cddb_flag_t;

	/**	/**
	* Initializes the library. This is used to setup any globally used	* Initializes the library. This is used to setup any globally used
	* variables. The first time you create a new CDDB connection structure	* variables. The first time you create a new CDDB connection structure
	* the library will automatically initialize itself. So, there is no	* the library will automatically initialize itself. So, there is no
	* need to explicitly call this function.	* need to explicitly call this function.
	*/	*/
	void libcddb_init(void);	void libcddb_init(void);

	/**	/**
	* Frees up any global (cross connection) resources. You should call	* Frees up any global (cross connection) resources. You should call
	* this function before terminating your program. Using any library	* this function before terminating your program. Using any library
	* calls after shutting down are bound to give problems.	* calls after shutting down are bound to give problems.
	*/	*/
	void libcddb_shutdown(void);	void libcddb_shutdown(void);


		/**
		* Set one or more flags that influence the library behvaiour
		*
		* @param flag A bitwise ORed set of values from #cddb_flag_t.
		*/
		void libcddb_set_flags(unsigned int flags);

		/**
		* Reset one or more flags that influence the library behvaiour
		*
		* @param flag A bitwise ORed set of values from #cddb_flag_t.
		*/
		void libcddb_reset_flags(unsigned int flags);

	#ifdef __cplusplus	#ifdef __cplusplus
	}	}
	#endif	#endif

	#endif /* CDDB_H */	#endif /* CDDB_H */

End of changes. 3 change blocks.
	1 lines changed or deleted	32 lines changed or added

	cddb_cmd.h	cddb_cmd.h
	/*	/*

	$Id: cddb_cmd.h,v 1.16 2005/07/17 09:46:33 airborne Exp $	$Id: cddb_cmd.h,v 1.17 2006/10/15 08:58:51 airborne Exp $

	Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>	Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>

	This library is free software; you can redistribute it and/or	This library is free software; you can redistribute it and/or
	modify it under the terms of the GNU Library General Public	modify it under the terms of the GNU Library General Public
	License as published by the Free Software Foundation; either	License as published by the Free Software Foundation; either
	version 2 of the License, or (at your option) any later version.	version 2 of the License, or (at your option) any later version.

	This library is distributed in the hope that it will be useful,	This library is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of	but WITHOUT ANY WARRANTY; without even the implied warranty of

	skipping to change at line 133	skipping to change at line 133
	/**	/**
	* Returns the next match in a CDDB search result set. This function	* Returns the next match in a CDDB search result set. This function
	* should be used in conjunction with #cddb_search.	* should be used in conjunction with #cddb_search.
	*	*
	* @param c The CDDB connection structure.	* @param c The CDDB connection structure.
	* @param disc A non-null CDDB disc structure.	* @param disc A non-null CDDB disc structure.
	*/	*/
	int cddb_search_next(cddb_conn_t c, cddb_disc_t disc);	int cddb_search_next(cddb_conn_t c, cddb_disc_t disc);

	/**	/**

		* Perform a text search in the CDDB database. It uses the album
		* command implemented on the freedb2.org servers. Either the album
		* title or artist's name should be filled in, in the disc structure.
		*
		* If there are multiple matches then only the first one will be
		* returned by this function. For other matches you will have to use
		* the #cddb_album_next function.
		*
		* @param c The CDDB connection structure.
		* @param disc A non-null CDDB disc structure.
		*
		* @return The number of matches found or -1 on error.
		*/
		int cddb_album(cddb_conn_t c, cddb_disc_t disc);

		/**
		* Returns the next match in a CDDB album result set. This function
		* should be used in conjunction with #cddb_album.
		*
		* @param c The CDDB connection structure.
		* @param disc A non-null CDDB disc structure.
		*/
		int cddb_album_next(cddb_conn_t c, cddb_disc_t disc);

		/**
	* Submit a new or updated disc to the CDDB database. This function	* Submit a new or updated disc to the CDDB database. This function
	* requires that the disc ID, length, category, artist and title of	* requires that the disc ID, length, category, artist and title of
	* the provided disc structure are valid. The disc should also	* the provided disc structure are valid. The disc should also
	* contain a number of tracks and for each track its frame offset on	* contain a number of tracks and for each track its frame offset on
	* the CD and title should be valid.	* the CD and title should be valid.
	*	*
	* @param c The CDDB connection structure.	* @param c The CDDB connection structure.
	* @param disc A non-null CDDB disc structure.	* @param disc A non-null CDDB disc structure.
	*/	*/
	int cddb_write(cddb_conn_t c, cddb_disc_t disc);	int cddb_write(cddb_conn_t c, cddb_disc_t disc);

End of changes. 2 change blocks.
	1 lines changed or deleted	26 lines changed or added

	version.h	version.h
	/* $Id: version.h.in,v 1.1 2005/04/08 01:49:35 rockyb Exp $ */	/* $Id: version.h.in,v 1.1 2005/04/08 01:49:35 rockyb Exp $ */
	/** \file version.h	/** \file version.h
	*	*
	* \brief A file containing the libcdio package version	* \brief A file containing the libcdio package version

	* number (122) and OS build name.	* number (130) and OS build name.
	*/	*/

	/! CDDB_VERSION can as a string in programs to show what version is used. /	/! CDDB_VERSION can as a string in programs to show what version is used. /

	#define CDDB_VERSION "1.2.2 i686-pc-linux-gnu"	#define CDDB_VERSION "1.3.0 i686-pc-linux-gnu"

	/! LIBCDDB_VERSION_NUM can be used for testing in the C preprocessor /	/! LIBCDDB_VERSION_NUM can be used for testing in the C preprocessor /

	#define LIBCDDB_VERSION_NUM 122	#define LIBCDDB_VERSION_NUM 130

End of changes. 3 change blocks.
	2 lines changed or deleted	2 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/

	cddb_track.h	cddb_track.h
	/*	/*

	$Id: cddb_track.h,v 1.19 2005/07/09 08:31:32 airborne Exp $	$Id: cddb_track.h,v 1.20 2006/10/15 06:51:11 airborne Exp $

	Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>	Copyright (C) 2003, 2004, 2005 Kris Verbeeck <airborne@advalvas.be>

	This library is free software; you can redistribute it and/or	This library is free software; you can redistribute it and/or
	modify it under the terms of the GNU Library General Public	modify it under the terms of the GNU Library General Public
	License as published by the Free Software Foundation; either	License as published by the Free Software Foundation; either
	version 2 of the License, or (at your option) any later version.	version 2 of the License, or (at your option) any later version.

	This library is distributed in the hope that it will be useful,	This library is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of	but WITHOUT ANY WARRANTY; without even the implied warranty of

	skipping to change at line 183	skipping to change at line 183
	*/	*/
	void cddb_track_append_artist(cddb_track_t track, const char artist);	void cddb_track_append_artist(cddb_track_t track, const char artist);

	/**	/**
	* Get the extended track data. If no extended data is set for this	* Get the extended track data. If no extended data is set for this
	* track then NULL will be returned.	* track then NULL will be returned.
	*	*
	* @param track The CDDB track structure.	* @param track The CDDB track structure.
	* @return The extended data.	* @return The extended data.
	*/	*/

	const char cddb_track_get_ext_data(cddb_track_t track);	const char cddb_track_get_ext_data(cddb_track_t track);

	/**	/**
	* Set the extended data for the track. If the track already had	* Set the extended data for the track. If the track already had
	* extended data, then the memory for that string will be freed. The	* extended data, then the memory for that string will be freed. The
	* new extended data will be copied into a new chunk of memory. If	* new extended data will be copied into a new chunk of memory. If
	* the given extended data is NULL, then the existing data will be	* the given extended data is NULL, then the existing data will be
	* deleted.	* deleted.
	*	*
	* @param track The CDDB track structure.	* @param track The CDDB track structure.
	* @param ext_data The new extended data.	* @param ext_data The new extended data.

End of changes. 2 change blocks.
	2 lines changed or deleted	2 lines changed or added