2.10.7

svn path=/branches/gtk-2-10/; revision=17086

.cvsignore

@@ -19,14 +19,17 @@ stamp-h.in
 gtk+.spec
 gtk+-2.0.pc
 gtk+-2.0-uninstalled.pc
+gtk+-unix-print-2.0.pc
 gtk+-linux-fb-2.0.pc
 gtk+-nanox-2.0.pc
 gtk+-x11-2.0.pc
+gtk+-quartz-2.0.pc
 gdk-2.0.pc
 gdk-2.0-uninstalled.pc
 gdk-linux-fb-2.0.pc
 gdk-nanox-2.0.pc
 gdk-x11-2.0.pc
+gdk-quartz-2.0.pc
 gdk-pixbuf-2.0.pc
 gdk-pixbuf-2.0-uninstalled.pc
 gtk-zip.sh

ChangeLog.gtk-async-file-chooser

@@ -0,0 +1,514 @@
+2006-04-30  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystem.[ch] (gtk_file_info_render_icon): remove the
+	caching code,
+	(gtk_file_info_get_icon_name): new function,
+	(gtk_file_system_volume_get_icon_name): new function,
+	(gtk_file_system_volume_render_icon): refactor to use
+	get_icon_name() and render the icon on the fly.
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_volume_render_icon),
+	(gtk_file_system_unix_volume_get_icon_name): reflect updates in
+	file system interface,
+	(get_fallback_icon): remove, along with icon caching code.
+
+	* gtk/gtk.symbols: updated.
+
+2006-04-30  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystemmodel.c (got_root_folder_cb), (ref_path_cb),
+	(get_children_get_folder_cb): don't leak the handle,
+	(got_root_folder_cb), (get_children_get_folder_cb): emit
+	row-inserted for the newly added nodes.
+
+2006-04-30  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (file_list_drag_data_select_uris),
+	(file_list_drag_data_received_get_info_cb),
+	(file_list_drag_data_received_cb): refactor code for selecting
+	multiple uris into file_list_drag_data_select_uris().
+
+2006-04-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserbutton.c (dnd_select_folder_get_info_cb): don't
+	leak handle,
+	(change_icon_theme_get_info_cb), (set_info_get_info_cb),
+	(model_add_special_get_info_cb), (update_label_get_info_cb): ditto.
+
+	* gtk/gtkfilechooserdefault.c (shortcuts_reload_icons_get_info_cb):
+	don't leak the handle,
+	(get_file_info_finished), (edited_idle_create_folder_cb),
+	(file_list_drag_data_received_get_info_cb),
+	(show_and_select_paths_get_folder_cb),
+	(update_current_folder_get_info_cb), (add_shortcut_get_info_cb),
+	(confirmation_confirm_get_info_cb), (action_create_folder_cb),
+	(save_entry_get_info_cb), (shortcuts_activate_volume_mount_cb),
+	(shortcuts_activate_get_info_cb), (update_from_entry_get_info_cb):
+	ditto.
+
+	* gtk/gtkfilechooserentry.c (load_directory_get_folder_callback):
+	don't leak the handle.
+
+	* gtk/gtkpathbar.c (set_button_image_get_info_cb),
+	(gtk_path_bar_get_info_callback): don't leak the handle.
+
+2006-04-23  Kristian Rietveld  <kris@imendio.com>
+
+	Review.
+
+	* gtk/gtkfilechooserdefault.c (shortcuts_reload_icons_get_info_cb):
+	don't forget to unref data->impl at the end.
+
+2006-04-23  Kristian Rietveld  <kris@imendio.com>
+
+	Review, continued.
+
+	* gtk/gtkfilechooserdialog.c (response_cb): set response_requested
+	to FALSE after stopping emission of the response signal.
+
+2006-03-16  Kristian Rietveld  <kris@imendio.com>
+
+	More review work.
+
+	* gtk/gtkfilechooserprivate.h: remove idle_finished_loading_source
+	from GtkFileSystemModel.
+
+	* gtk/gtkfilesystemmodel.c (gtk_file_system_model_finalize): remove
+	idle_finished_loading_source,
+	(idle_finished_loading_cb), (queue_finished_loading): removed,
+	(got_root_folder_cb): save a list walk, immediately emit
+	finished-loading and don't queue it, since we are already in an
+	idle here, always list_children() so the children the folder already
+	has are returned, 
+	(_gtk_file_system_model_new): handle the case where NULL is
+	returned by _get_folder(),
+	(_gtk_file_system_model_path_do): remove comment, and append the
+	new handle to the list, don't try to remove,
+	(get_children_get_folder_cb): save a list walk, remove the dummy
+	child if the _get_folder() call fails or is cancelled.
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	More suggestions from Federico.
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_create_folder):
+	remove check for filename_is_root(), since we never hit that code
+	and else mkdir will fail anyway,
+	(gtk_file_system_unix_create_folder): fixup parent folder refresh
+	code.
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystemunix.c (read_hidden_file), (fill_in_hidden),
+	(get_is_hidden_for_file): factor out g_file_get_contents() code
+	in read_hidden_file().  (Federico Mena Quintero).
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	Icon name code suggestions by Federico Mena Quintero.
+
+	* gtk/gtkfilesystemunix.c: add GTK_FILE_INFO_ICON to
+	STAT_NEEDED_MASK,
+	(get_fallback_icon_name), (get_fallback_icon),
+	(get_icon_name_for_directory), (get_special_icon_name): get rid
+	of strdups,
+	(get_icon_type_from_path): add a statbuf argument and use the
+	statbuf when folder_unix is NULL,
+	(create_file_info): adapt to work with above changes.
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_get_info): path
+	is NULL is an error here (gtk_file_system_get_info() already guards
+	path = NULL),
+	(gtk_file_system_unix_get_info): move basename creation to just
+	before create_file_info().  (Federico Mena Quintero).
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystemunix.c (struct _GtkFileFolderUnix): add
+	load_folder_id field,
+	(load_folder): add thread enter/leave construct, set load_folder_id
+	to zero since we have the idle removed when we return,
+	(gtk_file_system_unix_get_folder): initialize load_folder_id to 0
+	and store the source id of the load_folder idle,
+	(gtk_file_folder_unix_finalize): remove the load_folder idle
+	if necessary.  (Federico Mena Quintero).
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooser.c (gtk_file_chooser_get_current_folder): return
+	NULL if there is no current folder path.
+
+	* gtk/gtkfilechooserdefault.c (gtk_file_chooser_default_map): we
+	reload the current folder if there is one, else we continue the
+	still pending load.
+
+2006-03-14  Kristian Rietveld  <kris@imendio.com>
+
+	Couple of fixes from Markku Vire.
+
+	* gtk/gtkfilesystem.c (gtk_file_info_copy): also strdup icon_name
+	and display_key.
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_create_folder):
+	initialize error to NULL,
+	(gtk_file_folder_unix_list_children): return an empty list for now if
+	we couldn't read the directory.
+
+2005-12-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (update_current_folder_get_info_cb),
+	(gtk_file_chooser_default_update_current_folder): set and unset
+	busy cursor while checking whether the given path is a folder.
+
+2005-12-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystem.h: change the GtkFileInfo argument of the
+	GetInfoCallback to be const.
+
+	* gtk/gtkfilechooserbutton.c, gtk/gtkfilechooserdefault.c,
+	gtk/gtkpathbar.c: changes functions to reflect the above change.
+
+2005-12-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c, gtk/gtkfilechooserprivate.h: keep track
+	of handles, cancel all pending operations on dispose.
+
+2005-12-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserprivate.h (struct _GtkFileSystemModel): add
+	pending_handles field,
+	(struct _FileModelNode): add load_pending flag.
+
+	* gtk/gtkfilesystemmodel.c (gtk_file_system_model_dispose): introduce, 
+	cancel all pending operations here,
+	(got_root_folder_cb), (_gtk_file_system_model_new), (ref_path_cb),
+	(_gtk_file_system_model_path_do): keep track of all pending
+	operations, handle cancelled operations.
+
+2005-12-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_finalize),
+	(gtk_file_chooser_button_destroy): move all handle cancellations
+	and object unrefs to destroy.
+
+	* gtk/gtkpathbar.c (gtk_path_bar_finalize), (gtk_path_bar_dispose):
+	likewise.
+
+	* gtk/gtkfilechooserentry.c (gtk_file_chooser_entry_class_init): 
+	add dispose,
+	(gtk_file_chooser_entry_dispose): cancel handles and unrefs
+	objects here instead of finalize.
+
+2005-12-23  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystem.c (get_cached_icon): check if "name" is an
+	absolute path, if so load the icon from that file.
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_get_folder): fix
+	the build.
+
+2005-12-21  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_get_folder): remove
+	the FIXME since it doesn't make sense, when we return a cached
+	folder we won't emit finished-loading either,
+	(gtk_file_system_unix_create_folder): remove unused variable,
+	(gtk_file_folder_unix_list_children): remove unused code,
+	(get_is_hidden_for_file): new function,
+	(create_file_info): also handle getting is_hidden when called
+	without a folder unix (from _system_get_info() for example).
+
+2005-12-20  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (check_is_folder): fully removed!
+	woo!,
+	(check_save_entry): add is_folder argument,
+	(gtk_file_chooser_default_get_paths): update check_save_entry() call,
+	(get_display_name_for_folder): removed,
+	(confirmation_confirm_get_info_cb): new function which will
+	handle the confirmation dialog now we have all information for it,
+	(should_respond_after_confirm_overwrite): replace the call to
+	get_display_name_for_folder() with an asynchronous solution,
+	(action_create_folder_cb): request dialog response on successfull
+	folder creation,
+	(gtk_file_chooser_default_should_respond): update call to
+	check_save_entry(); replace the check is folder call for "path"
+	by just using the is_folder return value from check_save_entry();
+	replaced the check is folder call for "parent_path" with an
+	asynchronous setup, remainder of that work is now done in
+	save_entry_get_info_cb(),
+	(save_entry_get_info_cb): new function.
+
+	* gtk/gtkfilechoosermebed.[ch]: add response-requested signal.
+
+	* gtk/gtkfilechooserdialog.c, gtk/gtkfilechooserprivate.h: handle
+	response_requested signal.
+
+	* gtk/gtkfilechooserentry.[ch]
+	(_gtk_file_chooser_entry_get_is_folder): new function.
+
+2005-12-20  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (ref_path_cb): when called with
+	!folder, check if node is the node we are looking for (can be
+	triggered when we call ref_path_cb ourselves after a find_child_node),
+	(_gtk_file_system_model_path_do): introduce parent_node field;
+	after finding a child node in a loaded parent node, don't forget
+	to call ref_path_cb,
+	(get_children_get_folder_cb): don't forget to set data->node->folder
+	to the newly acquired folder.
+
+2005-12-20  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (show_and_select_paths_get_folder_cb):
+	handle case where the folder we get already finished loading.
+
+	* gtk/gtkfilesystemmodel.c (ref_path_cb),
+	(_gtk_file_system_model_path_do): make this work.
+
+2005-12-19  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (shortcuts_update_count): modify
+	in such a way that it can also negatively update the count on
+	failures,
+	(get_file_info_finished): handle failures, update save folder
+	combo box on success,
+	(shortcuts_insert_path): change the boolean return value into a
+	void one, also refilter the model and update the save folder combo
+	box for the non-asynchronous case,
+	(shortcuts_append_home), (shortcuts_append_desktop),
+	(shortcuts_add_volumes), (shortcuts_add_current_folder),
+	(add_shortcuts_get_info_cb): adapt to shortcuts_insert_path() updates.
+
+2005-12-19  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkpathbar.[ch]: add handle fields to ButtonData and
+	GtkPathBar; do correct handle bookkeeping.
+
+	* gtk/gtkfilesystemunix.c (load_folder),
+	(gtk_file_system_unix_get_folder),
+	(gtk_file_folder_unix_is_finished_loading): add is_finished_loading
+	field to GtkFileFolderUnix, which is set to true once we are
+	really finished with loading (previous assumption that we are
+	always finshed loading is not true anymore).
+
+	* gtk/gtkfilesystemmodel.c (got_root_folder_cb): if the folder is
+	finished loading, list the children and update the root level.
+
+	* gtk/gtkfilechooserdefault.c (update_current_folder_get_info_cb):
+	handle cancellation.
+
+2005-12-16  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystemunix.c: always call the callback, even when
+	cancelled; ref handles passed to the callback queue functions;
+	don't set cancelled to TRUE in _cancel_operation(), since operations
+	in this backend are always completed,
+	(get_special_icon_name): don't strdup the value of
+	get_icon_name_for_directory() again.
+
+	* gtk/gtkfilechooserbutton.c: adapt to new cancellation policy;
+	reference all objects which are passed as callback arguments; in the
+	callback check if the handles match.
+
+	* gtk/gtkfilechooserentry.c: likewise.
+
+	* gtk/gtkfilechooserdefault.c: likewise.  Also changed the shortcut
+	loading code to be more like the code in GtkFileChooserButton, where
+	we store all handles in the model and have model_row_free_data
+	cancel any pending operations,
+	(shortcuts_model_create): copy the error.
+
+	* gtk/gtkfilechooserprivate.h (struct _GtkFileChooserDefault): remove
+	loading_volumes and loading_bookmarks fields.
+
+	* gtk/gtkfilesystem.c (gtk_file_info_free): free icon_name here...
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (edited_idle_create_folder_cb): fix
+	thinko.
+
+	* gtk/gtkfilesystemunix.c (dispatch_create_folder_callback),
+	(queue_create_folder_callback): need to copy/free the path,
+	(gtk_file_system_unix_create_folder): put the "reget folder" hack
+	back in, though it's working different now.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_finalize),
+	(dnd_select_folder_get_info_cb), (gtk_file_chooser_drag_data_received),
+	(change_icon_theme_get_info_cb), (change_icon_theme),
+	(model_add_special_get_info_cb), (model_add_special),
+	(update_label_get_info_cb), (update_label_and_image): cancel existing
+	operations, if any; added apprioriate fields to
+	GtkFileChooserButtonPrivate.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserentry.c (gtk_file_chooser_entry_finalize): if
+	there's a folder loading, cancel the operation,
+	(load_directory_get_folder_callback): set the loading folder handle
+	to NULL,
+	(load_directory_callback): cancel any currently loading folders
+	before starting a new get folder operation.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (shortcuts_insert_path): don't overwrite
+	data if it's already set (for example by the "is volume" case).
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserbutton.c (set_info_get_info_cb),
+	(set_info_for_path_at_iter): store a row reference in the temporary
+	data structure and not an iter,
+	(model_add_special), (model_update_current_folder),
+	(gtk_file_chooser_button_add_shorcut_folder): remove unused pixbuf
+	variable.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (get_file_info_finished),
+	(shortcuts_insert_path): replace gtk_file_system_render_icon() call
+	with gtk_file_system_get_file_info(),
+	(gtk_file_chooser_default_add_shortcut_folder),
+	(gtk_file_chooser_default_remove_shortcut_folder): handle shortcuts
+	which are still loading.
+
+	* gtk/gtkfilechooserprivate.h: add shortcuts_loading field to
+	struct _GtkFileChooserDefault.
+
+	* gtk/gtkfilechooserbutton.c (set_info_get_info_cb),
+	(set_info_for_path_at_iter), (model_free_row_data): keep handle
+	and path together; now supports adding/removing shortcuts
+	which are still loading.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystem.c: make the cancelled field an GObject property.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystem.h: make the GError argument in the callbacks
+	const.
+
+	* gtk/gtkfilechooserbutton.c: update callbacks,
+	* gtk/gtkfilechooserentry.c: likewise,
+	* gtk/gtkfilechooserdefault.c: likewise,
+	* gtk/gtkfilesystemmodel.c: likewise,
+	* gtk/gtkpathbar.c: likewise.
+
+	* gtk/gtkfilechooserdefault.c (edited_idle_create_folder_cb): copy
+	the error which will be passed to error_creating_folder_dialog(),
+	(action_create_folder_cb): likewise,
+	(file_list_drag_data_received_get_info_cb): add forgotten GError
+	declaration.
+
+2005-12-13  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkpathbar.c (get_button_image), (set_button_image),
+	(set_button_image_get_info_cb),
+	(gtk_path_bar_update_button_appearance): update to new icon
+	rendering call.
+
+2005-12-09  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (file_list_drag_data_received),
+	(gtk_file_chooser_default_add_shortcut_folder),
+	(shortcuts_activate_get_info_cb): replace synchronous check_is_folder
+	calls with an async gtk_file_system_get_info() solution.
+
+2005-12-09  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilesystem.c (icon_cache_element_free), (icon_theme_changed),
+	(get_cached_icon), (gtk_file_info_render_icon): implement pixbuf
+	caching as found in the file system backends.
+
+2005-12-09  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtk.symbols: updated.
+
+	* gtk/gtkfilesystem.[ch] (struct GtkFileInfo): added icon_name field,
+	(enum GtkFileInfoType): added GTK_FILE_INFO_ICON,
+	(gtk_file_info_set_icon_name): new function,
+	(gtk_file_info_render_icon): new function,
+	(gtk_file_system_render_icon): removed.
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_render_icon): removed,
+	(create_file_info): fill icon_name field if required,
+	(get_*_icon): modified to suit create_file_info() better.
+
+	* gtk/gtkfilechooserbutton.c: modified to use
+	gtk_file_info_render_icon() instead of gtk_file_system_render_icon().
+
+	* gtk/gtkfilechooserdefault.c: likewise.
+
+2005-12-06  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (get_file_info_finished),
+	(update_current_folder_get_info_cb): fix mem leaks.
+
+	* gtk/gtkfilesystemunix.c (gtk_file_system_unix_get_info): ditto.
+
+	* gtk/gtkpathbar.c (gtk_path_bar_set_path_finish): ditto.
+
+2005-12-06  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserbutton.c (dnd_select_folder_get_info_cb),
+	(gtk_file_chooser_button_drag_data_received): make asynchronous,
+	(update_label_and_image): remove unused variable.
+
+	* gtk/gtkfilechooserdefault.c
+	(gtk_file_chooser_default_update_current_folder): split in two
+	functions, so we can have the is_folder check back.
+	* gtk/gtkfilechooserprivate.h: add update_current_folder_handle
+	field.
+
+2005-12-06  Kristian Rietveld  <kris@imendio.com>
+
+	* gtk/gtkfilechooserdefault.c (show_and_select_paths): fixed a typo.
+
+2005-12-05  Federico Mena Quintero  <federico@ximian.com>
+
+	(merge from HEAD)
+
+	* gtk/gtkfilechooserdefault.c (trap_activate_cb): "event->state &
+	modifiers", not "event->state && modifiers".  Patch by Sadrul
+	Habib Chowdhury <imadil@gmail.com>.  Fixes bug #323073.
+
+2005-12-06  Kristian Rietveld  <kris@imendio.com>
+
+	Beginnings of an asynchronous file chooser.
+
+	* gtk/gtkfilechooserbutton.c: display name and the is folder property
+	are now asynchronously set using set_info_for_at_path_iter(), the
+	is folder property is now also stored in the tree model.
+
+	* gtk/gtkfilechooserdefault.c: lots of changes to the shortcuts
+	model code to make it operate asynchronously, check_is_folder() has
+	been "disabled" for now, all other synchronous calls were
+	replaced with asychronous ones.
+
+	* gtk/gtkfilechooserentry.c: update call to 
+	gtk_file_system_get_folder().
+
+	* gtk/gtkfilechooserprivate.h: added two fields.
+
+	* gtk/gtkfilesystem.[ch]: for about 85% changed to the changes
+	outlined in the proposal discussed on gtk-devel-list.
+
+	* gtk/gtkfilesystemmodel.[ch]: updated all asynchronous calls,
+	_gtk_file_system_model_path_do() basically had to be rewritten
+	(and I still need to finish that).
+
+	* gtk/gtkfilesystemunix.c: changed to be compatible with the new
+	GtkFileSystem interface.
+
+	* gtk/gtkpathbar.c (button_clicked_cb): block/unblock the
+	button_clicked_cb callback around the call to
+	gtk_toggle_button_set_active(), avoids button_clicked_cb getting
+	called twice.
+	(_gtk_path_bar_set_path): refactored to be asynchronous.

ChangeLog.gtk-printing

@@ -0,0 +1,500 @@
+2006-04-17  Matthias Clasen  <mclasen@redhat.com>
+
+	* docs/tools/widgets.c (get_all_widgets): Add print dialog
+	and page setup dialog.
+
+2006-04-11  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtkpapersize.c (gtk_paper_size_get_display_name):
+	Call gettext on the standard paper names. 
+
+2006-04-11  Alexander Larsson  <alexl@redhat.com>
+
+	* gdk/gdk.symbols:
+	* gdk/win32/gdkevents-win32.c:
+	* gdk/win32/gdkwin32.h:
+	Add gdk_win32_set_modal_dialog_libgtk_only that we
+	need for handling the mainloop in the print dialogs.
+
+	* gtk/gtkprintoperation-win32.c:
+	Pump the gtk+ mainloop when needed in the print dialogs.
+	This means gtk+ windows will redraw while the print dialogs
+	are up.
+
+2006-04-10  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintoperation-win32.c: 
+	Better size handling.
+	Save win32-specific settings in additions to the generic ones
+	if the generic one is lossy.
+
+2006-04-10  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintoperation-win32.c:
+	Finish implementing run_page_setup_dialog.
+
+	* gtk/gtkpagesetup.h:
+	* gtk/gtkpapersize.h:
+	* gtk/gtkprint-win32.h:
+	* gtk/gtkprintcontext.h:
+	* gtk/gtkprinter-private.h:
+	* gtk/gtkprintoperation-private.h:
+	* gtk/gtkprintoperation-unix.c:
+	* gtk/gtkprintoperation.h:
+	* gtk/gtkprintsettings.h:
+	s/EGG/GTK/
+
+2006-04-09  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk+-unix-print-2.0.pc.in: Fix a typo  (#337698)
+
+2006-04-07  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/paper_names_offsets.c: 
+	* gtk/gen-paper-names.c: Correct the suffix/duplicate optimizations.
+
+2006-04-07  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintoperation-win32.c:
+	Initial work on gtk_print_run_page_setup_dialog.
+	Not reading margins yet.
+
+2006-04-07  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/Makefile.am:
+	Link to winspool
+	
+	* gtk/gtk.symbols:
+	* gtk/gtkprintoperation-private.h:
+	* gtk/gtkprintoperation-unix.c:
+	* gtk/gtkprintoperation.[ch]: 
+	Add gtk_print_operation_get_status_string() and status
+	string to _gtk_print_operation_set_status.
+	Rename GTK_PRINT_STATUS_PROCESSING to GTK_PRINT_STATUS_PRINTING.
+	
+	* gtk/gtkprintoperation-win32.c:
+	Poll for status updates
+	
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	Rename GTK_PRINT_STATUS_PROCESSING to GTK_PRINT_STATUS_PRINTING.
+	
+	* tests/print-editor.c:
+	Show print status string
+
+2006-04-06  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/paper_names_offsets.c: 
+	* gtk/gtkpapersize.c: Save 4K of .data by converting
+	the array of paper names to offsets. 
+
+	* gtk/gen-paper-names.c: Utility used to create
+	paper_names_offsets.c from paper_names.c.
+
+	* gtk/Makefile.am: Necessary glue.
+
+2006-04-06  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintoperation-win32.c: 
+	Use glib base64 code.
+	Set up manual_* vars fully.
+
+2006-04-06  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/Makefile.am:
+	Add -lcomdlg32 on win32
+	
+	* gtk/gtkprint-win32.h:
+	Move WINVER define to .c files
+	
+	* gtk/gtk.symbols:
+	* gtk/gtkprintoperation-win32.c:
+	Add empty gtk_print_run_page_setup win implementation
+	Move WINVER define to this file
+	
+	* modules/Makefile.am:
+	Only build print backends on unix
+
+2006-04-05  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtkprintunixdialog.c:
+	* gtk/gtkprintoperation-unix.c: Use GTK_RESPONSE_CANCEL/OK
+	instead of GTK_RESPONSE_REJECT/ACCEPT, to make Esc close
+	the dialog, and to not use values which are documented
+	as reserved for apps.
+
+2006-04-05  Alexander Larsson  <alexl@redhat.com>
+
+	* modules/printbackends/lpr/gtkprintbackendlpr.c:
+	Don't hardcode lpr command, expose full commandline.
+
+2006-04-05  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	* gtk/gtkprintunixdialog.c:
+	Don't check for printer changes after dialog is dead.
+	
+	* gtk/gtkprintbackend.c: (gtk_print_backend_load_modules):
+	Strip whitespace from backend strings
+	
+	* gtk/gtkprintbackend.h:
+	Add private printer functions
+	
+	* gtk/gtkprinter-private.h:
+	Move GtkPrinterPrivate into gtkprinter.c
+	
+	* gtk/gtkprinter.[ch]:
+	Move GtkPrinterPrivate into gtkprinter.c
+	Add new construct properties.
+	Add setter functions.
+	
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	* modules/printbackends/cups/gtkprintercups.[ch]:
+	Update to new APIs.
+	
+	* modules/printbackends/lpr/Makefile.am:
+	* modules/printbackends/lpr/gtkprintbackendlpr.c:
+	* modules/printbackends/lpr/gtkprinterlpr.[ch]
+	Update to new APIs.
+	Remove GtkPrinterLPR.
+	Read/Save command line option in settings
+	
+	* modules/printbackends/pdf/Makefile.am:
+	* modules/printbackends/pdf/gtkprintbackendpdf.c:
+	* modules/printbackends/pdf/gtkprinterpdf.[ch]:
+	Update to new APIs.
+	Remove GtkPrinterPDF.
+
+2006-04-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtkprintoperation.h: Add missing standard
+	GObject macros.  (#337277, Yevgen Muntyan)
+
+2006-04-04  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprinteroption.[ch]:
+	Add gtk_printer_option_has_choice.
+	
+	* gtk/gtkprintunixdialog.c:
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	Add support for "print at time".
+
+2006-04-04  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpapersize.c:
+	Handle ppd names with ".Transverse" suffix
+	Don't force width < height
+	
+	* gtk/gtkprinteroption.c:
+	Make sure that value is never NULL.
+	
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	Add some HP whitelist names
+	Remove spew from ignored options.
+
+2006-04-03  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	Fix warnings
+	
+	* gtk/gtkprinter-private.h:
+	* gtk/gtkprinter.[ch]:
+	Add gtk_printer_is_default.
+	
+	* gtk/gtkprintunixdialog.c:
+	Use gtk_printer_is_default.
+	
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	Get default printer info
+	
+	* modules/printbackends/pdf/gtkprintbackendpdf.c:
+	Fix warning.
+
+2006-04-03  Alexander Larsson  <alexl@redhat.com>
+
+	* modules/printbackends/pdf/gtkprintbackendpdf.c:
+	* modules/printbackends/pdf/gtkprinterpdf.[ch]:
+	Correctly read/write/use the output filename setting.
+
+2006-04-03  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	Disable margin from printers if there are no printers.
+	
+	* gtk/gtkpapersize.c:
+	Fix build.
+
+2006-04-01  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk.symbols: protect unix-only symbols by 
+	G_OS_UNIX (#336819, Yevgen Muntyan)
+
+	* gtk/gtkpapersize.c: Win32 fixes.  (#336806, Yevgen Muntyan)
+
+2006-03-30  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtk.symbols:
+	Update
+	
+	* gtk/gtkprintbackend.[ch]:
+	Add dnotify to gtk_print_backend_print_stream
+	
+	* gtk/gtkprinter-private.h:
+	Declare gtk_print_job_set_status
+	
+	* gtk/gtkprinter.[ch]:
+	Remove gtk_printer_prepare_job.
+	
+	* gtk/gtkprintjob.[ch]:
+	Now you create print job directly with gtk_print_job_new() and
+	they'll be prepared automatically.
+	Add status_changed signal and get_status.
+	Add gtk_print_job_set_source_file to allow sending a file.
+	
+	* gtk/gtkprintoperation-private.h:
+	Add destroy notify for platform_data.
+	Declare _gtk_print_operation_set_status.
+	
+	* gtk/gtkprintoperation-unix.c:
+	Hook up status change handling.
+	Use the new way to get a print job.
+
+	* gtk/gtkprintoperation.[ch]:
+	Add status_changed signal and get_status/is_finished.
+
+	
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	* modules/printbackends/lpr/gtkprintbackendlpr.c:
+	* modules/printbackends/pdf/gtkprintbackendpdf.c:
+	Update to use new APIs and set status on the job.
+	Cups polls for the status.
+	
+	* tests/print-editor.c:
+	Track the print operations in the status bar.
+
+2006-03-30  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/Makefile.am:
+	* gtk/gtkprintbackend.c:
+	Default to "pdf,cups" if we found cups, and
+	"pdf,lpr" otherwise.
+
+2006-03-29  Matthias Clasen  <mclasen@redhat.com>
+
+	* modules/printbackends/Makefile.am: 
+	* configure.in: Don't build the cups backend 
+	if cups is not there.
+
+2006-03-29  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtk.symbols:
+	gtk_printer_prep_job -> gtk_printer_prepare_job
+	gtk_print_job_prep -> gtk_print_job_prepare
+	
+	* gtk/gtkprintbackend.h:
+	* gtk/gtkprinter-private.h:
+	* gtk/gtkprinter.[ch]:
+	Add print_job argument to printer_prepare_for_print
+	gtk_printer_prep_job -> gtk_printer_prepare_job
+	
+	* gtk/gtkprintjob.[ch]:
+	Add manual rendering settings to GtkPrintJob.
+	gtk_print_job_prep -> gtk_print_job_prepare
+	
+	* gtk/gtkprintoperation-private.h:
+	* gtk/gtkprintoperation-unix.c:
+	* gtk/gtkprintoperation.c:
+	Get more manual_* settings working.
+	Run mainloop after each printed page.
+
+	* gtk/gtkprintunixdialog.c:
+	Save page ranges.
+	
+	* modules/printbackends/cups/gtkprintbackendcups.c:
+	* modules/printbackends/lpr/gtkprintbackendlpr.c:
+	* modules/printbackends/pdf/gtkprintbackendpdf.c:
+	Now put the manual_* settings inside the PrintJob in
+	prepare_for_print.
+
+2006-03-29  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintunixdialog.c:
+	Make sure we remember the format-for printer.
+	Also, use it as the default if set.
+
+2006-03-28  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintunixdialog.c:
+	Remove unnecessary padding under list.
+	
+2006-03-28  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	* gtk/gtkprintunixdialog.c:
+	More HIGy layout.
+
+2006-03-28  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	HIG conformance of spacing and titles.
+	
+	* gtk/gtkprintunixdialog.c:
+	Use standard constructor form print button too.
+
+2006-03-27  Matthias Clasen  <mclasen@redhat.com>
+
+	* modules/printbackends/*/Makefile.am: Fix 
+	a problem with builddir != srcdir builds.
+	(#335915, Yevgen Muntyan)
+
+2006-03-27  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtkprintbackend.c: Simply the syntax
+	of the setting to "cups,pdf", and get rid
+	of the GScanner used to parse it.
+
+2006-03-27  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkprintunixdialog.c:
+	Reorder print list so status is at the end.
+	Ellipsize the status column.
+
+2006-03-27  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	Handle removed printers and status-changed.
+	Handle NULL printer location.
+
+2006-03-27  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/Makefile.am:
+	* gtk/stock-icons/24/gtk-orientation-landscape.png:
+	* gtk/stock-icons/24/gtk-orientation-portrait.png:
+	* gtk/stock-icons/24/gtk-orientation-reverse-landscape.png:
+	* gtk/gtkiconfactory.c: (get_default_icons):
+	* gtk/gtkstock.h:
+	Add orientation stock icons.
+	
+	* gtk/gtkpagesetupunixdialog.c:
+	Use the orientation icons.
+
+2006-03-27  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtkpagesetupunixdialog.c:
+	* gtk/gtkprintjob.c:
+	* gtk/gtkprintoperation-unix.c:
+	* gtk/gtkprintunixdialog.c:
+	s/impl/dialog/
+	Don't prefix static functions with _
+
+2006-03-26  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtkprintunixdialog.c: Don't use _(""). (#335898,
+	Christian Persch)
+
+	* modules/printbackends/*: Don't use G_DEFINE_TYPE
+	in modules.
+
+	* gtk/gtkprintbackend.c: Remove an unused static function.
+
+2006-03-25  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk.symbols: Add printing symbols
+
+	* gtk/gtkpapersize.[hc]: 
+	* gtk/gtkpage*.[hc]: 
+	* gtk/gtkprint*.[hc]: Add aliasing, #include cleanups.
+
+	* gtk/gtkprintcontext.h:
+	* gtk/gtkprintoperation.h:
+	* gtk/gtkprintsettings.h: Make get_type function const.
+
+	* modules/printbackends/pdf/gtkprintbackendpdf.c: Remove
+	C99ism.
+
+	* modules/printbackends/cups/gtkcupsutils.c: Use unsigned
+	integers for bitfields.
+
+2006-03-24  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtknotebook.c: Fix docs
+
+	* gtk/Makefile.am (EXTRA_DIST): Add the stock icons here.
+
+	* gdk/directfb/Makefile.am (EXTRA_DIST): Remove ChangeLog,
+	to make make dist happier.
+
+2006-03-24  Alexander Larsson  <alexl@redhat.com>
+
+	* configure.in:
+	* gtk/gtkprintbackend.c:
+	* modules/printbackends/Makefile.am:
+	* modules/printbackends/cups/Makefile.am:
+	* modules/printbackends/lpr/Makefile.am:
+	* modules/printbackends/lpr/gtkprintbackendlpr.[ch]:
+	* modules/printbackends/lpr/gtkprinterlpr.[ch]:
+	* modules/printbackends/pdf/Makefile.am:
+	* modules/printbackends/pdf/gtkprintbackendpdf.[ch]:
+	* modules/printbackends/pdf/gtkprinterpdf.[ch]:
+	Import pdf and lpr backend
+
+2006-03-24  Alexander Larsson  <alexl@redhat.com>
+
+        Import print-operation into gtk+
+	
+	* .cvsignore:
+	* Makefile.am:
+	* gtk+-unix-print-2.0.pc.in:
+	Add gtk+-unix-print-2.0.pc
+	
+	* configure.in:
+	Look for cups
+	Look for various _NL_* extensions
+	Output new makefiles and .pc.in
+	
+	* gtk/Makefile.am:
+	Add new files
+	
+	* gtk/gtk.h:
+	Include gtkprintoperation.h
+	
+	* gtk/gtkenums.h:
+	Add printing enums
+	
+	* gtk/gtkmarshalers.list:
+	Add required new marshallers
+	
+	* gtk/gtkpagesetup.[ch]:
+	* gtk/gtkpagesetupunixdialog.[ch]:
+	* gtk/gtkpagesetupunixdialog.h:
+	* gtk/gtkpapersize.[ch]:
+	* gtk/gtkprint-win32.[ch]:
+	* gtk/gtkprintbackend.[ch]:
+	* gtk/gtkprintcontext.[ch]:
+	* gtk/gtkprinter-private.h:
+	* gtk/gtkprinter.[ch]:
+	* gtk/gtkprinteroption.[ch]:
+	* gtk/gtkprinteroptionset.[ch]:
+	* gtk/gtkprinteroptionwidget.[ch]:
+	* gtk/gtkprintjob.[ch]:
+	* gtk/gtkprintoperation-private.h:
+	* gtk/gtkprintoperation-unix.c:
+	* gtk/gtkprintoperation-win32.c:
+	* gtk/gtkprintoperation.[ch]:
+	* gtk/gtkprintsettings.[ch]:
+	* gtk/gtkprintunixdialog.[ch]:
+	* gtk/paper_names.c:
+	Generic printing support
+	
+	* modules/Makefile.am:
+	* modules/printbackends/Makefile.am:
+	* modules/printbackends/cups/Makefile.am:
+	* modules/printbackends/cups/gtkcupsutils.[ch]:
+	* modules/printbackends/cups/gtkprintbackendcups.[ch]:
+	* modules/printbackends/cups/gtkprintercups.[ch]:
+	Cups backend
+	
+	* tests/.cvsignore:
+	* tests/Makefile.am:
+	* tests/print-editor.c:
+	Add printing test app
+

INSTALL

@@ -3,9 +3,9 @@ Prerequisites
 
 GTK+ requires the following packages:
 
- - The GLib, Pango, and Atk libraries, available at the same location as GTK+
-   (Either Pango-1.0 or Pango-1.2 can be used with GTK+-2.2; 
-   Pango-1.2 is recommended.)
+ - The GLib, Pango, ATK and cairo libraries, available at the same 
+   location as GTK+. GTK+ 2.10.7 requires at least GLib 2.12, 
+   Pango 1.13, ATK 1.9 and cairo 1.2.
 
  - The TIFF, PNG, and JPEG image loading libraries. You most
    likely have these installed on your system already. If not
@@ -18,12 +18,12 @@ GTK+ requires the following packages:
 Simple install procedure
 ========================
 
-  % gzip -cd gtk+-2.8.2.tar.gz | tar xvf - # unpack the sources
-  % cd gtk+-2.8.2			   # change to the toplevel directory
+  % gzip -cd gtk+-2.10.7.tar.gz | tar xvf - # unpack the sources
+  % cd gtk+-2.10.7			   # change to the toplevel directory
   % ./configure				   # run the `configure' script
-  % make				   # build GTK
+  % make				   # build GTK+
   [ Become root if necessary ]
-  % make install			   # install GTK
+  % make install			   # install GTK+
 
 The Details
 ===========

INSTALL.in

@@ -3,9 +3,9 @@ Prerequisites
 
 GTK+ requires the following packages:
 
- - The GLib, Pango, and Atk libraries, available at the same location as GTK+
-   (Either Pango-1.0 or Pango-1.2 can be used with GTK+-2.2; 
-   Pango-1.2 is recommended.)
+ - The GLib, Pango, ATK and cairo libraries, available at the same 
+   location as GTK+. GTK+ @GTK_VERSION@ requires at least GLib 2.12, 
+   Pango 1.13, ATK 1.9 and cairo 1.2.
 
  - The TIFF, PNG, and JPEG image loading libraries. You most
    likely have these installed on your system already. If not
@@ -21,9 +21,9 @@ Simple install procedure
   % gzip -cd gtk+-@GTK_VERSION@.tar.gz | tar xvf - # unpack the sources
   % cd gtk+-@GTK_VERSION@			   # change to the toplevel directory
   % ./configure				   # run the `configure' script
-  % make				   # build GTK
+  % make				   # build GTK+
   [ Become root if necessary ]
-  % make install			   # install GTK
+  % make install			   # install GTK+
 
 The Details
 ===========

Makefile.am

@@ -17,6 +17,8 @@ EXTRA_DIST =			\
 	ChangeLog.pre-2-4	\
 	ChangeLog.pre-2-6	\
 	ChangeLog.pre-2-8	\
+	ChangeLog.gtk-async-file-chooser	\
+	ChangeLog.gtk-printing	\
 	README.cvs-commits	\
 	README.win32		\
 	config.h.win32		\
@@ -132,9 +134,10 @@ gdk-$(GDKTARGET)-2.0-uninstalled.pc: gdk-2.0-uninstalled.pc
 	cp gdk-2.0-uninstalled.pc gdk-$(GDKTARGET)-2.0-uninstalled.pc
 
 pkgconfigdir = $(libdir)/pkgconfig
-pkgconfig_DATA= gdk-pixbuf-2.0.pc gdk-$(GDKTARGET)-2.0.pc gtk+-$(GDKTARGET)-2.0.pc
+pkgconfig_DATA= gdk-pixbuf-2.0.pc gdk-$(GDKTARGET)-2.0.pc gtk+-$(GDKTARGET)-2.0.pc gtk+-unix-print-2.0.pc
 
 DISTCLEANFILES =				\
+	gtk+-unix-print-2.0.pc			\
 	gtk+-$(GDKTARGET)-2.0.pc		\
 	gdk-$(GDKTARGET)-2.0.pc			\
 	gtk+-$(GDKTARGET)-2.0-uninstalled.pc	\
@@ -188,5 +191,4 @@ sanity:
 snapshot:
 	$(MAKE) dist distdir=$(PACKAGE)-snap`date +"%Y%m%d"`
 
-
-DISTCHECK_CONFIGURE_FLAGS = --enable-gtk-doc
+DISTCHECK_CONFIGURE_FLAGS = --enable-gtk-doc --enable-man --disable-rebuilds

NEWS

@@ -1,3 +1,862 @@
+Overview of Changes from GTK+ 2.10.6 to 2.10.7
+==============================================
+
+* GtkNotebook 
+ - Tab reordering is a less intrusive
+ - Rendering fixes on win32
+
+* GtkTreeView
+  - Column resizing works correctly in right-to-left languages
+  - Many scrolling bugs have been fixed
+
+* GtkTextView:
+  - Improved scrolling during DND.
+
+* GtkRecentManager is more robust against bad URIs
+
+* Print support:
+ - The cups backend works with 'BrowseShortNames Off' 
+   in the cups configuration
+ - Multi-valued options are properly passed to cups
+ - Fix build with cups 1.3
+ - A few IPP compliance issues have been fixed
+ - Make the lpr backend work on BSD
+
+* Input methods:
+ - GtkEntryCompletion works with input methods
+ - The Thai input method has been replace by a functional
+   Thai and Lao input method based on libthai
+
+* Accessibility support:
+ - GtkMessageDialog sets accessible name role explicitly
+
+* Theme support:
+ - The semantics of the gtk-color-scheme setting has been
+   slightly changed. Values from rc files are still merged
+   together, but the X setting just overrides the prior table.
+
+* GdkPixbuf:
+ - gdk_pixbuf_loader_write() now closes the loader when 
+   returning FALSE, as documented
+ - The BMP loader supports more BMP variants, including 
+   transparency and 10-bit channels.
+
+* Bugs fixed:
+ 122688 modal dialog popup + drag in progress = mouse freeze
+ 315732	gnome-session crash on login
+ 335622	Click Description field causes Evolution to crash.
+ 357050	Crash replacing \n\n with \n or undoing after paste
+ 359537	printing custom page
+ 373466	crash in Text Editor:
+ 388041	crash in Open Folder: nada
+ 390873	crash in Text Editor: I had just opened it up ...
+ 367529	gtk_combo_box_set_model(combo, NULL) generates warning wh...
+ 381499	xdgmime requires getc_unlocked, darwin 6 lacks
+ 349119	GtkUIManager crashes on wrong action names in an XML file
+ 363437	gnome-panel crash to gtkrecentmanager code
+ 366782	GtkTreeView "expand_all" can crash if a node's children a...
+ 374378	Crash as GTK tries to blink cursor in defocused spinbutto...
+ 381236	apps crash when using a mouse cursor theme as icon theme
+ 320465 gtk_window_parse_geometry is almost completely broken
+ 355350 Page Setup, Range and Copy information ignored
+ 387170 Fairly large leak in gtk+
+ 390159 printing with BSD lpr does not work properly
+  64998 GtkEntry - gtk_entry_set_text emits "changed" twice
+  92387 unfriendly drag-n-drop in textview - scrolls too fast
+ 172188	io-bmp.c should sanity check the size given by the OffBit...
+ 304482	GtkComboBoxEntry editable entry should be centered vertic...
+ 315440	Problem with gtkpaned inside gtknotebook(mouse wheel over...
+ 317064	GtkTextBuffer signals documentation
+ 317080	Incorrect gtk.immodules might make GTK+ lose its translation
+ 330683	Changing selection by up/down does not move to top/bottom.
+ 335473	gtk_file_chooser_button_new_with_dialog() is too strict
+ 337261	about dialogue initial focus
+ 339752	Please use LOCALE_IFIRSTDAYOFWEEK for GtkCalendar on Windows
+ 339756	LANG and LC_* environment variables should affect the C r...
+ 349638	Cannot Compose (multi_key) polish l (or L) with stroke, "ł"
+ 350342	Alt+Left/Right reorders tabs if not swallowed by Gecko
+ 351678	Notebooks not with PositionType.Top drawn incorrectly
+ 351679	Notebooks drawn with extra line below tab in MS-Windows t...
+ 352276	Location of G_GNUC_INTERNAL breaks Solaris build
+ 352435 GtkProgressBar text rendering errors
+ 352738	gtk_tree_view_column_set_sort_indicator() fails to show a...
+ 352795	configure.in: Bug in "checking Whether to write dependenc...
+ 353438	Add tiny extra docs to gdk_beep
+ 353709	GtkEntry shift-click inside selected text can behave funny
+ 354495	Compose key doesn't work on location entry
+ 357578	No grid lines are drawn
+ 357974	Crashes (failed assertatin)
+ 359231	validate_visible_area() sometimes passes mismatches (tree...
+ 359542	scale capability for Unix print dialog box can not be set...
+ 359581	GtkCellView clobbers parent's GdkWindow on style-set
+ 360350	leak in gtk_radio_button_focus
+ 362439	gtkicontheme::pixbuf_supports_svg leaks GList
+ 362614	gtk_widget_show does not check for NULL arg
+ 363191	gtk_tree_view_set_cursor() does not make row fully visible
+ 364514	gtk leaks GDI objects on the win32 classic look and feel
+ 364866	CUPS http_t type is becoming opaque
+ 364868	GDI resource leak in GtkStatusIcon on win32
+ 365031	gedit crashes with .recently-used.xbel file
+ 365047	GTK_PAGE_ORIENTATION_REVERSE_PORTRAIT is never used in Gt...
+ 365388	gdk-pixbuf/Makefile.am: pixbufloader_pcx.def is not distr...
+ 366548	Clicking removed Focus frame
+ 370395	leak in gtk_rc_parse_icon_source
+ 374420	symbolic colors not reset correctly
+ 376094	Add gtk-doc on GtkCellRendererText::edited
+ 376535	crashes in gtk_drag_source_info_destroy()
+ 377349	gtk_status_icon_position_menu is not implemented for Win32
+ 378852	Fixes for notebook tab detaching
+ 379503	possible crash in gtk_default_draw_flat_box
+ 379803	Bad g_return_if_fail in gdkinput-xfree.c
+ 380421	Enabling extension events stops GDK_2BUTTON_PRESS
+ 382314	gtkpagesetup leaks when setting new paper size
+ 382369	some builtin papers have wrong display names
+ 383373	child properties getter returns not-NULL array, but no sp...
+ 383407	gtk_entry_set_text does not check for completion->priv->c...
+ 383435	expose improvements to GtkNotebook
+ 384168	gdk x11 backend doesn't build on Darwin
+ 386694	set_active_iter is called on rows with children
+ 388123	_gtk_file_chooser_embed_set_delegate() docs typo.
+ 389183	Typo in API docs (s/expansive/expensive)
+ 389194	mem leaks in gtkpagesetupunixdialog
+ 390468	Unbreak GtkNotebook keybindings
+ 390872	Scroll timeout isn't removed when widget destroyed
+ 391229	gtkprintoperation-win32.c: windows.h with WIN32_LEAN_AND_...
+ 172584	32 bpp windows bitmap files with 10-11-10 RGB masks are d...
+ 323146	gtk_button_grab_notify clears button->in_button (shouldn't)
+ 340135	page switching with keynav 'stuck'
+ 341158	Gdk-pixbuf programs need glib, but are not linked with it
+ 343330	gdk_pixbuf_new has redundant size checks
+ 343956	drawing problem in gtkassistant
+ 345094	gtk_notebook_insert_page can return wrong position
+ 353962	Tabs are all the same height
+ 360112	Wrong documentation for gtk_file_chooser_set_select_multiple
+ 365364	gtksettings doesn't list printpreview settings
+ 371756	GtkTreeView cursor not easily moved when set to GTK_SELEC...
+ 378462	En Dash Compose Keystrokes Yield an Em Dash Character
+ 389581	The interactive search window disappears during typing
+ 358864	Shows "xterm" cursor when insensitive
+ 385672	calendars draw arrows pointing to the right sligthly misp...
+ 391523	IPP glitches in GtkPrint
+ 391725	gtkicontheme::load_themes attempts to open dir after ENOENT
+  58389 Add some method of cancellation to GtkRange?
+  81031 immodules for Thai
+ 152620	Small icon (hIconSm member)
+ 159764	handles of GtkHandleBox are always drawn vertically
+ 348108	Refleaks in gtk-demo
+ 392227	GtkEntry::recompute_idle_func operates on widget->window=...
+ 164494	Create folder text entry widget creates the folder when i...
+ 332604	GtkLabel cannot have an alignment and be ellipsized in 2....
+ 362406	Breakage from process_all_updates() in gtkwindow.c
+ 392191	GtkFileChooser outputs assertions when create folder butt...
+ 392315	gdk_drawable_get_size() call in unrealized GtkEntry
+ 392457	GtkAssistant sometimes forgets to reset current_page whil...
+ 392532	valgrindify use of XSendEvent
+ 332266	gdk_draw_layout fails for coordinates >= 2^21
+ 346616 Selected item not visible in the popup in list mode
+ 392646	Fix cross-compilation
+ 393124	misdrawing of tabs
+ 393166	background box of the "bin_window" not placed correctly
+
+* Updated translations (ar,as,bn_IN,ca,en_CA,en_GB,
+    es,et,fi,fr,gu,he,hi,hy,hu,ka,mk,ml,mr,nb,nl,
+    or,pl,pt,si,sq,sv,ta,th)
+
+
+Overview of Changes from GTK+ 2.10.5 to 2.10.6
+==============================================
+
+* Bugs fixed:
+ 358931 2.10.5 build issue due to a typo
+ 357280 Compile crashes 
+ 359053 Reduce relocations
+ 359052 gtk_print_settings_get_duplex() return wrong 
+        value for one of vertical setting
+ 
+
+Overview of Changes from GTK+ 2.10.4 to 2.10.5
+==============================================
+
+* Bugs fixed:
+ 358405 gtk_file_chooser_button_new
+ 353736 crash in Document Viewer: I had just viewed the pr...
+ 354849 Unable to build gtk+ under Solaris 9
+ 357280 Compile crashes
+ 357454 leak in _gtk_menu_is_empty()
+ 357566 [x11] Invalid unref for input windows
+ 357791 gtk_tree_selection_get_selected_rows does not always fill model
+ 358351 expander with multi-line label doesn't properly respond to mouse
+
+* Updated translations (dz,et,gl,ka)
+
+
+Overview of Changes from GTK+ 2.10.3 to 2.10.4
+==============================================
+
+* GtkFileChooser works better with remote bookmarks
+
+* Windows theme engine improvements
+
+* Bugs fixed:
+ 116626 Use keyboard map contents to detect RTL groups
+ 353772 Add doc blurb for GtkWidget::parent-set
+ 353803 GtkEntry unneccesarily resets im context at commit
+ 353914 Leak of to_reset list from _gtk_settings_reset_rc_values
+ 354043 Renew the typeahead search timeout when using scrollwheel
+ 354687 PLT-reduction stuff not quite working
+ 354887 GtkFileChooserButton displays unnecessary authentication 
+        dialogs
+ 355308 gtk_tree_view_set_grid_lines notifies wrong property
+ 355732 Combobox leaks treeview in list mode
+ 355134 Type in string
+ 355961 Typo in documentation for GtkPrintContext
+ 340201 Enhancement of Wimp theme engine.
+ 357132 Setting an RGBA colormap using gtk_widget_set_colormap() 
+        on any widget at application start (before other widgets 
+        are used) causes the running app to revert to the stock 
+        icon theme
+
+* Updated translations (bg,bn,bn_IN,de,dz,el,
+  en_GB,et,fi,gu,hi,id,ka,lt,lv,mk,nb,nl,nn,or,
+  ru,sl,sv,ta,th)
+
+
+Overview of Changes from GTK+ 2.10.2 to 2.10.3
+==============================================
+
+* GtkFileChooser:
+ - Fix several Win32-specific problems
+ - Add automated tests for GtkFileSystem
+ - Make overwrite confirmation work again
+
+* Printing support:
+ - Fix confusion between names and values in combo boxes
+ - Poll for printer list updates in the cups backend
+
+* Add an automatic scrolling example to gtk-demo
+
+* Bugs fixed:
+ 354004 Use of g_warning("%s", NULL) after failing to 
+        open a display
+ 346751 symbolic colors can't be use in properties
+ 352264 gtk_status_icon_set_from_pixbuf leaks the old 
+        pixbuf
+ 352391 small link button leak
+ 353449 A break is missing in 
+        gtk_recent_chooser_menu_set_current_uri
+ 329604 do not scroll on copy to clipboard
+ 354035 Typo in the GtkWidget::drag-drop doc blurb
+
+* Translation updates (ang,bn_IN,ca,de,dz,el,eu,fi,
+  fr,hi,hu,it,ja,lt,ml,mr,nn,or,pl,pt_BR,ro,ru,sl,
+  sr,sr@Latn,sv,ta,th,tr,vi,zh_CN,zh_HK,zh_TW)
+
+
+Overview of Changes from GTK+ 2.10.1 to 2.10.2
+==============================================
+
+* Many fixes and improvements for the OS X backends
+
+* Revert to using gtk modules with global binding,
+  since the local binding that was introduced in 
+  2.10 breaks the accessibility support of current 
+  OpenOffice.org releases.
+
+* GtkRecenManager 
+ - Poll for changes to the XBEL file
+ - Fix initial bad placement of recent files menu
+ - Show nonexisting resources by default, and do 
+   not mark them as insensitive
+ - Allow adding a filter to GtkRecentChooserMenu
+
+* GtkFileChooser
+ - Improve the fallbacks for icons
+ - Make  / and ~ activate the location entry again
+
+* Bugs fixed:
+ 348828	Segmentation Fault in gtk_combo_box_menu_setup 
+        when removing combobox child
+ 349552	problem with parsing (enum) style properties
+ 351581	API Documentation issues with 2.15 release
+ 348652	reorder() from ComboBoxEntry produces Gtk+ assert 
+        error
+ 349128	Fix docs about GtkTreeModel::row-deleted
+ 350605	Crash caused by the recent menu
+ 348096	GtkStyle leaks GtkRcContext
+ 348145	Background images not working with Quartz backend
+ 329752	Problem with has_selection notification when 
+        deleting the selection
+ 347856	gtk_recent_chooser_add_filter not implemented 
+        for GtkRecentChooserMenu
+ 348245	Disabling pdf printing doesn't hide option
+ 348278	textview doesn't update on hinting setting change
+ 348289	Filechooser is blocked by higher priority idle
+ 348478	entry completions needs to reset the IM context 
+        before emitting action-activate signal
+ 348538	Remove old email addreses from the tutorial
+ 348626	drag-to-child should not work
+ 348634	IconView does not update background
+ 348706	don't allow dnd onto arrows
+ 348740	configure script does not honour PKG_CONFIG variable
+ 348787	Segfault in gtk_font_button_update_font_info()
+ 348824	test attached calendar-sane-timer patch in head
+ 348971	gtk_status_icon_get_geometry returns bogus data
+ 349382	valgrind uninitialized memory warnings setting 
+        partly uninitialized X properties
+ 349570	notebook arrow PRELIGHT drawing doesn't work
+ 349834	Memleak from gtk_tree_view_set_enable_tree_lines
+ 349858	Leak of ShmPixmapInfo from get_shm_pixmap_for_image
+ 349859	gtk_paint_tab doesn't work when widget is now 
+        option menu
+ 349997	Indirect leak from XkbGetMap
+ 350039	GtkFileChooserEntry leaks sources
+ 350050	GdkGC leak from GtkRuler
+ 350139	Should use evince preview mode
+ 350258	Memory leak in gtk_entry_drag_data_received()
+ 350329	The CUPS printer backend in GTK+-2.10.1 fails 
+        with CUPS 1.1.
+ 350517	reset_style_idle() interferes with application 
+        idles
+ 350860	Balloon messages sent to tray do not have the 
+        correct window in XEvent
+ 350938	TreeViewColumn rendering off when "spacing" 
+        property set
+ 351112	gtk_notebook_set_current_page fails when the 
+        notebook has not yet been shown
+ 351519	Directfb backend fails to build
+ 165714	GtkEntryCompletion doesn't complete on paste
+ 168737	Different button sizes in About dialogs
+ 345666	The icons of file, directory and device at 
+        GtkFileChooser
+ 349429	spin button does not use correct value for 
+        inner_border
+ 349501	fix in the documentation of function 
+        gtk_list_store_insert_with_values()
+ 350072	stdout output from colorselection
+ 351759	Wrong range value in documentation of 
+        gtk_color_selection_set_current_alpha
+ 349277	Wrong message for problems with serializing 
+        texts
+ 346800	Rework sort/filter models to use indices to 
+        parents instead of pointers
+ 349120	Small error in doc
+ 350911 gdk_pixbuf_new_from_file_at_scale() should 
+        skip when there's enough image data 
+ 348728	GtkTable Row and Column Spacing
+ 351241	swapped argument description
+ 350023	"Running GTK+ Applications" chapter does not 
+        document new GTK_DEBUG possibilities
+ 351812 file print backend filename encoding issue
+
+* New and updated translations (bg,bn_IN,de,dz,el,es,
+  et,eu,fi,gu,hu,ko,ku,ja,lt,mk,ml,nb,ne,nl,or,pl,po,
+  sv,th,tr,tt,uk,zh_HK,zh_TW)
+
+
+Overview of Changes from GTK+ 2.10.0 to 2.10.1
+==============================================
+
+* Drop Pango requirement 1.12.0
+
+* Many fixes and improvements for the OS X 
+  and directfb backends
+
+* The printing framework now supports a subset
+  of the Cups 1.2 custom PPD option spec
+
+* Bug fixes:
+ 348134 box gaps on left and right can be drawn wrong
+ 348014	crash on Epiphany Web Browser
+ 348063	_gtk_icon_cache_get_icon crashes when no 
+        cache available
+ 348096	GtkStyle leaks GtkRcContext
+ 157439	The "adding to panel" is buggy when switching 
+        to an rtl environment
+ 346751	symbolic colors can't be use in properties
+ 347976	Context menus appear in strange locations
+ 348001	xid / fid X11 font id's are used intermixed
+ 348049	Tabs "magically" re-order
+ 348094	Adjustment leak from gtkiconview
+ 348115 improve notebook visuals when dragging
+ 348120	gtkentrycompletion leaks action_view
+ 348227	gtkimcontextsimple doesn't terminate a string 
+        with null
+ 348424	mem leak in GtkPrintSettings
+ 348089	Missing chaining up in gtk_recent_chooser_menu_finalize
+ 348090	Reference leak in gtk_text_layout_set_contexts
+ 348095	gtk_menu_stop_scrolling does work even if we 
+        were not scrolling...
+ 142582	Add animation xsetting
+ 346427	xbm loader returns false, fails to set error
+ 346733	GList of visuals is always empty and causes 
+        crashes in gdk_rgb_choose_visual()
+ 347048	crash on using GtkAssistant
+ 164884	GtkTreeView row drag is sometimes started 
+        spuriously
+ 302127	GtkTreeView gets angry when items deleted 
+        from a test_expand_row handler
+ 346092 gtk_tooltip_set_delay documentation wrong
+ 346428	Be robust against broken loaders failing to 
+        set error on failure
+ 346467	gtkwindow state assignments bug
+ 346598	modeline takes too much memory
+ 346603	Context menus only work once
+ 346639	treeview memleak
+ 346668	symbolic colors are broken when specifying 
+        engine
+ 346713 quartz backend is missing functions that 
+        pygtk needs
+ 346721	XBM reading in quartz backend is broken
+ 346836	Tabs jump around when opening menus
+ 347018 missing GDK_QUARTZ_ALLOC/RELEASE_POOL calls
+ 347277	gtk_drag_get_ipc_widget() and window groups
+ 347315	SYNC extension check failing
+ 347902	GtkRange doesn't reliably update stepper 
+        sensitivity
+ 335012 gtkcellrenderertext - gtkeditable: bad 
+        interaction when ypad is set to hi value
+ 337910	gdk_pango_layout_get_clip_region is inefficient
+ 346605	Modifier-key events are not sent
+ 346970	gtkfilechooserbutton leaks an empty list
+ 347032	documentation of gtk_print_context_get_height() 
+        has typo
+ 347037	GObject info missing for GtkRecentManager and 
+        GtkRecentChooser* in gtk-doc API reference
+ 347041 documentation of gtk_paper_size_is_equal() 
+        has a typo
+ 347043	Reference leaks in GtkFileChooserButton
+ 347066	gimp 2.3.9/2.2.12 GTK+ assertion fails on 
+        open file dialog
+ 347211 documentation of gtk_print_job_send() has a 
+        typo
+ 347710	new GtkCellRendererSpin misses a lot of API 
+        documentation
+ 347711	slight glitches in GtkAssistant API documentation
+ 347065	Fix in-line doc typos
+ 311399	relative to the window string can be better 
+
+* Updated translations (bg,bn_IN,cs,de,dz,es,et,
+  eu,fi,fr,gu,he,ko,or,th)
+
+Overview of Changes from GTK+ 2.9.4 to 2.10.0
+=============================================
+
+* Printing:
+  - A PREVIEW capability has been added to allow hiding the
+    preview button
+
+* Bug fixes:
+ 321393	Incorrect size request after changing the font
+ 327164	(GtkRBNode *)node becomes NULL inside GtkTreeView
+ 344074	Feature request: get printer list, and get default print
+ 344876	refcount leak when using ComboBox.set_cell_data_func
+ 345644	gtk+-2.9.4 requires CUPS-1.2.x
+ 345663	gtkaction(group)?.c: using functions without prototype declaration
+ 346079	gtk receives all sorts of events from the X server
+ 343841	Misguided iter assertion in gtk_list_store_insert_with_values()
+ 346113 unix print dialogue always has preview button
+ 346237 Possible leak in gtkprintunixdialog.c
+ 346027 cancelling printer enumeration
+ 346312 gtk 2.9.4 tarball lacks the files gtkwin32embedwidget.h 
+        and gtkprint-win32.h
+ 346341 Memory leak in gtk_tree_model_sort_finalize: User data not freed
+
+* Updated translations (cs,cy,dz,es,gu,hi,ko,mk,nb,nl,ru,th,ur)
+
+Overview of Changes from GTK+ 2.9.3 to 2.9.4
+============================================
+
+* GtkPrintOperation:
+ - UI improvements in the print dialog
+ - Make printing work without a display connection
+ - Replace "Print to PDF" by "Print to file" that
+   can generate PDF or PostScript
+ - Add a function to the low-level API to 
+   enumerate all printers
+
+* GtkNotebook tab DND has been improved
+
+* GtkProgressbar supports text in activity mode 
+
+* GtkLabel allows to set the wrap mode
+
+* GtkStatusIcon supports transparency
+
+* Bugs fixed:
+ 344850 Dragging a GtkTreeViewColumn segfaults when 
+        using certain GtkTreeViewColumnDropFunc
+ 342458 Stock menu items without icons are broken in 
+        recent GTK+ releases.
+ 335873 notebook DND + popup windows
+ 337882 gtk_progress_bar_set_text() does nothing in 
+        activity mode
+ 339456 unix print dialogue help button bug
+ 339702 Make sure printing works without a display
+ 341571 tabs too easily reordered
+ 344074 New Feature: get printer list, and get default print
+ 344743 gtk_targets_include_text() should initialize atoms
+ 344838 Allow func to be NULL in 
+        gtk_tree_view_set_search_position_func
+ 344891 GtkPrintOperationPreview signal defs correction
+ 345008 Need updated cairo req
+ 345093 print preview temp file issues
+ 345107 Memory leak in gtk_entry_completion_finalize: 
+        User data not freed
+ 345194 gdk_window_set_functions() docs need to be updated
+ 345456 grid-lines property is wrongly registered and 
+        get/set.
+ 314278 strings in gtk-update-icon-cache are not marked 
+        for translation
+ 344707 size group with widgets in hidden container
+ 344897 Entry completion model NULL handling should be 
+        documented
+ 345038 gtk_print_job_set_status' status
+ 345106 dialog button box spacings
+ 345176 GtkIconView doc about drag and drop
+ 345275 doc imporovements for gtk_window_move
+ 345320 Two very similiar strings should be made equal
+ 345321 Add meaning of "shortcut" as translator comment
+ 320034 transparency gtkstatusicon
+ 339592 Add print-to-postscript
+ 344867 custom paper file could use keyfile
+
+* Updated translations (cs,de,es,fr,gl,gu,hi,ko,ta,th)
+
+Overview of Changes from GTK+ 2.9.2 to 2.9.3
+============================================  
+
+* GtkPrintOperation: 
+ - Introduce an allow-async property 
+ - Introduce a GtkPrintOperationAction enumeration
+ - Rename pdf_target to export_filename
+ - Allow to hide "Print to PDF" in the low-level API
+
+* GtkNotebook:
+ - Add a destroy notify to 
+   gtk_notebook_set_window_creation_hook.
+
+* GtkTreeView:
+ - Support grid lines
+
+* GtkRange:
+ - Add a number of new stle properties which allow more
+   fexible stepper theming
+
+* Bugs fixed:
+ 153212 Have the Paste kbd shortcut jump to the location in 
+        the buffer
+ 337491 _gdk_win32_drawable_release_dc: DeleteDC() called on 
+        a GetDC() handle
+ 339739 gtk/gtkprintoperation-win32.c: 3 compile error
+ 342339 GtkRange::stepper-spacing style property not 
+        implemented correctly
+ 343945 Buttons of a GtkAssistant are not accessible
+ 344148 Wrong reqs for ATK
+ 344209 gtk_notebook_set_window_creation_hook() has no destroy 
+        func.
+ 344232 GtkEntry's "Delete" context menu item is sensitive on a 
+        non-editable GtkEntry
+ 344244 Window resizing not working when keeping the aspect 
+        fixed
+ 344288 gtk_print_operation_preview_is_selected must return 
+        a value
+ 344386 gdk-2.0-uninstalled.pc.in and gdkconfig.h
+ 344496 CRLF converting via Clipboard
+ 344504 GtkPrintCapabilities not in gtktypebuiltins.h
+ 344505 Wrong signal registration for create_custom_widget
+ 344512 cvs build issue
+ 344513 pdf print module's print_stream not calling destroy 
+        notify
+ 344518 NULL unref in page setup dialogue
+ 344543 gtk_progress_bar_pulse calls gtk_progress_bar_paint 
+        directly
+ 344560 gtk_print_settings_[sg]et_scale shouldn't be in percent
+ 344607 memory leaks in gtkrecentchooserdefault.c and 
+        gtkrecentchoosermenu.c
+ 344624 Memory leak in gtk_tree_model_filter_finalize: User 
+        data not freed
+ 337603 Possible off-by-one in 
+        gdk_pango_layout_line_get_clip_region
+ 344239 Wrong filename for gtk-find stock item.
+ 344528 comma at end of GtkPrintOperationAction enum causes 
+        mozilla compilation error
+ 344290 horizontal-padding not take into account when placing 
+        submenus
+ 344558 document print dialogue response codes
+ 339592 Add print-to-postscript
+ 342249 Allow to draw upper and lower sides of GtkRange's 
+        trough differently
+ 344530 gtk_recent_chooser_widget_new_for_manager and 
+        gtk_recent_chooser_menu_new_for_manager should 
+        allow NULL manager arg
+
+* Updated translations (es,fi,gu,ko,th,wa)
+
+
+Overview of Changes from GTK+ 2.9.1 to 2.9.2
+============================================
+
+* GtkPrintOperation
+ - Support asynchronous pagination with the ::paginate signal
+ - Add gtk_print_operation_cancel
+ - Support application-specific widgets
+ - Allow disabling features based on application capabilities
+ - Optionally show progress
+ - Change some function names in GtkPrintContext to be longer 
+   and better
+ - Support preview, the default implementation spawns evince,
+   but the api allows for an internal preview implementation
+
+* GtkCellView
+ - Add a model property
+
+* GtkStatusIcon
+ - Allow to obtain screen geometry 
+
+* GtkTreeView
+ - Many bug fixes, in particular for RTL handling
+ - Separate sensitive and selectable properties of rows
+ - Optionally allow rubberband selection
+
+* GtkButton
+ - Add image-spacing style property
+ - Add image-position property 
+
+* GtkToolButton
+ - Add icon-spacing style property
+
+* Make GTK+ work as an untrused X client
+
+* Bugs fixed:
+ 343838 gtkprintoperationpreview.h guards
+ 305530 Crashes while creating source code w/GtkFontSelection
+ 341327 Memory corruption inside glib
+ 341734 cursor blocked to dnd mode after using shift and 
+        dnd on a GtkCalendar
+ 343453 G_DEFINE_TYPE messes up internal typenames of 
+        GdkWindow and GdkPixmap
+ 136571 Problems running as untrusted client
+ 168105 the right edge tab does not appear when switching tab
+ 172535 Add support for UI builders in gtk+
+ 302556 GtkTreeView widget signals are badly documented
+ 324480 Selecting first item with keyboard is difficult
+ 340428 small cleanup
+ 340444 don't run the custom page size dialogue
+ 340839 Critical warnings in GtkTreeModelFilter
+ 341898 gtk_tree_view_insert_column_with_attributes doesn't 
+        work with fixed_height_mode
+ 342003 DnD: Conditional jump or move depends on uninitialised value
+ 342072 Wrong drop location in GtkEntry
+ 342096 GtkImage animation CRITICALS on switching themes
+ 342513 widget class style property with type module
+ 342529 gdk should set resolution on PangoCairoFontmap, 
+        not PangoCairoContext
+ 342535 Add documentation for new GtkWidget style properties 
+        (including Since tags)
+ 342543 can't compile gtk+ on opensolaris using sun cc
+ 342569 Typo in decl of gdk_color_parse
+ 342752 Need a way to specify custom tab label for custom page 
+        in Print dialog
+ 342754 print-editor: font button dialog doesn't get focus if 
+        main window has a window group
+ 342781 GtkPrintUnixDialog: Collate should be insensitive unless 
+        Copies is > 1
+ 342783 GtkPrintUnixDialog: Range textinput area should be 
+        insensitive unless range radiobutton is selected
+ 342894 Use after free inside gtk_text_view_set_buffer
+ 342930 GtkButton should offer a way to position the image 
+        relative to the text
+ 343088 Some typos in the PO file
+ 343425 "grab-notify"-signal is not correctly propagated for 
+        internal children
+ 343438 gtk_color_button_set_color() doesn't emit "color-set" 
+        signal
+ 343475 page setup unix dialog confusion
+ 343625 allow to get only some info from gtk_status_icon_get_geometry
+ 343677 GtkWindow chains key-release to key-press
+ 320431 Text too close when using East/West in a GtkToolButton
+ 321523 GtkTreeView's test_expand_row signal emitting impractical 
+        on row expand all
+ 342007 Warning in gtk_paned_compute_position
+ 343233 gdk_rectangle_intersect doc
+ 333284 expander animation not working in RTL mode
+ 343444 change color of gtk-demo source-buffer comment color 
+        from red to DodgerBlue
+ 343630 Small inconsistence in migration documentation
+  80127 Rubberbanding for GtkTreeView
+ 341450 status icon + libnotify
+ 341679 Allow absolute filenames in the options entries
+
+* Updated translations (bg,cy,de,el,es,et,eu,gl,gu,it,ja,
+                        nb,nl,pt_BR,th,vi)
+
+
+Overview of Changes from GTK+ 2.9.0 to 2.9.1
+============================================
+
+* GtkPrintOperation
+ - Many user interface improvements in the unix dialogs
+ - gtk-demo has a printing demo
+ - Don't unload print backends for now, since that has
+   deadlock issues
+ - Asynchronous page rendering is done in an idle
+
+* GtkImage has an image property 
+
+* GtkTextBuffer has a cursor-position property
+
+* Arrow sizes in scrolled menus and notebooks are themable
+
+* GDK keysyms have be synched with Xorg 7.1
+
+* Bugs fixed:
+ 340676 print backend type modules not correctly reregistering 
+        their types
+ 340870 gdk_window_get_toplevels docstring error
+ 323956 Unwanted accelerate key in the action-based toolbar
+ 340527 Tooltips not shown for toolbar buttons created with 
+        uimanager/actions
+ 340516 status icon property getter assertions
+ 341091 a couple of spelling errors in gtk+
+ 335707 notebook DND with event boxes in tab labels
+ 337306 Add a GtkMessageDialog::image property
+ 139628 GtkLayout In GtkScrolledWindow does not receive the 
+        scroll_event
+ 334412 Add cursor-position property for getting notified 
+        about cursor movement
+ 341217 langinfo.h #include'd unconditionally stops build
+ 333632 use GtkMenu::scroll-arrow-height instead of 
+        MENU_SCROLL_ARROW_HEIGHT
+ 325282 Add GtkNotebook::tab-overlap style property
+ 341247 possible crash with tab_label = NULL
+ 321896 Synch gdkkeysyms.h/gtkimcontextsimple.c with X.org 6.9/7.0
+ 341416 Save FileChooserDialog doesn't response
+ 336774 gtk_recent_manager_add_full
+ 340401 critical warnings when using window groups
+ 341661 misplaced g_assert in gtk_text_view_allocate_children
+ 341692 Semicolons after G_DEFINE_TYPE
+ 341665 several misplaced g_assert
+ 341578 reverse page order issues
+ 341332 Unset background in more places
+ 341896 gtktreeview has RTL problems with toggle buttons if using 
+        gtktreestore as a model
+ 341028 crash in new async code
+ 341035 file chooser crash
+ 340722 GtkToolbar::max-child-expand style property
+ 339589 Tooltips on orientation icons in page setup dialog
+ 340951 faq: How do I internationalize a GTK+ program? doesn't 
+        mention glib-I18N
+ 341855 Little typo in the Tree and List Widget Overview
+ 153212 Have the Paste kbd shortcut jump to the location 
+        in the buffer
+ 335729 Invisible rows and 
+        gtk_tree_model_filter_convert_child_*_to_*
+ 106406 GtkTreeView Grid Lines?
+ 339592 Add print-to-postscript
+
+* Updated translations (de,es,gl,gu,nl)
+
+
+Overview of Changes from GTK+ 2.8.x to 2.9.0
+============================================
+
+* GtkStatusIcon, a cross-platform "tray icon" API
+
+* GtkAssistant, a widget for creating multi-step wizards
+
+* GtkLinkButton, a widget that displays a clickable hyperlink
+
+* GtkRecentChooser, widgets to display and select recently used files
+
+* GtkPrintOperation, cross-platform printing support
+
+* A framework for rich text copy and paste and DND
+
+* GtkCellRendererAccel, a cell renderer for key combinations
+
+* GtkCellRendererSpin, a cell renderer which edits numeric values 
+  using a spin button
+
+* GtkAction works with named icons in addition to stock icons
+
+* GtkNotebook supports DND, allowing to reorder tabs, move tabs
+  between notebooks and drop tabs on the desktop to open a new window
+
+* GtkTreeView:
+  - Enhanced customizability (e.g. grouping) with the
+    show-expanders and level-indentation properties
+  - Allow to embed the search popup
+  - Better search popup positioning
+
+* GtkFileChooser:
+  - Communication with backends is now asynchronous to avoid
+    blocking on filesystem operations. Due to the required interface
+    changes, the GTK+ ABI version has been bumped to 2.10.0. Third-party
+    filesystem backends have to be ported to the new interface, other
+    modules, such as theme engines, input method modules or pixbuf loaders 
+    have to be rebuilt so that they are installed in the right place
+    for GTK+ to find them.
+  - The location entry (popped up by C-L) has been integrated in the
+    main dialog.
+    
+* Reworked hex Unicode input now requires Ctrl-Shift-U
+
+* Animations can now be globally controlled by settings
+
+* The gtk-touchscreen-mode setting controls a number of changes
+  that make GTK+ work better on touchscreens
+
+* Password entries can optionally show the last entered character
+  for a short while, controlled by the password-hint-timeout setting
+
+* GTK+ can now consult an additional fallback icon theme before
+  falling back to hicolor
+
+* Improved themability:
+  - GTK+ supports symbolic colors, which can be set system-wide
+    using a setting, and can be modified and used in rc files
+    and theme engines
+  - GTK+ sets window type hints on override-redirect windows to 
+    help compositing managers apply proper bling
+  - Paths in rc files can now refer to all subclasses of a class 
+  - GtkRange steppers will appear insensitive when the slider
+    is at the end; applications which need to handle this case
+    (e.g. to extend the range) can opt out of this.
+  - GtkRange::activate-slider style property allows themes
+    to draw sliders differently while they are being dragged
+  - GtkNotebook::tab-overlap and GtkNotebook::curvature style
+    properties allow more flexible notebook theming
+  - The spacing of buttons around children can be themed with
+    the GtkButton::inner-border style property. Apps can override
+    this per-widget using the corresponding inner-border property 
+  - GtkMenu has aquired a horizontal-padding style property 
+  - There are style properties for the color of hyperlinks,
+    GtkWidget::link-color and GtkWidget::visited-link-color
+  - GtkTreeview row hinting now takes the selection into account
+  - Scrolling menus can be forced to always display both arrows,
+    using the GtkMenu::double-arrows style property
+  - Separators can be themed using the wide-separators, separator-width
+    and separator-height style properties
+  - GtkTreeView allows more flexible theming with the row-ending-details
+    property
+  - The pixbuf theme engines supports customized drawing of expanders
+    and resize grips
+
+* GDK changes:  
+  - OS X backend
+  - DirectFB backend 
+  - Closing displays works
+  - gdk_screen_is_composited to check for running compositing manager
+  - Support for Super, Hyper and Meta modifiers
+
+* gdk-pixbuf changes: 
+  - Supports saving tiff 
+  - Supports loading 16-bit pnm
+  - Doesn't load entire gif animation to get first frame
+
+* Bug fixes
+  - Too many to list them here
+
 Overview of Changes from GTK+ 2.8.1 to GTK+ 2.8.2
 =================================================
 * Fix a crash with custom icon themes, which affected

README

@@ -1,7 +1,7 @@
 General Information
 ===================
 
-This is GTK+ version 2.8.2. GTK+ is a multi-platform toolkit for
+This is GTK+ version 2.10.7. GTK+ is a multi-platform toolkit for
 creating graphical user interfaces. Offering a complete set of widgets,
 GTK+ is suitable for projects ranging from small one-off projects to
 complete application suites.
@@ -20,13 +20,111 @@ The official web site is:
 Information about mailing lists can be found at
   http://www.gtk.org/mailinglists.html
 
+
 Installation
 ============
 
 See the file 'INSTALL'
 
-Release notes
-=============
+
+Release notes for 2.10
+======================
+
+* The hexadecimal Unicode input feature has been reworked. It no longer
+  blocks the use of the sixteen Ctrl-Shift-<hex digit> key sequences. Now
+  it only uses Ctrl-Shift-u.
+
+* A memory leak in GtkStyle handling has been fixed. This may expose bugs
+  in third-party widgets which forget to call gtk_style_attach() in their
+  realize functions.
+
+* Range widgets like GtkScrollbar now render their arrows insensitive
+  when the slider is at the end. Applications which react to arrow
+  clicks even if the slider is at the end may want to use the new
+  gtk_range_set_[upper/lower]_stepper_sensitivity() functions to
+  prevent the arrows from being rendered insensitive.
+
+* GtkObject now uses the "floating reference" support in GObject. 
+  GTK_OBJECT_IS_FLOATING() will still work, but direct checking
+  of the GTK_FLOATING flag will no longer detect the floating 
+  reference. Details about floating references can be found in the docs:
+  http://developer.gnome.org/doc/API/2.0/gobject/gobject-The-Base-Object-Type.html#floating-ref
+
+* Accelerators like (_F) are now stripped from labels when they are 
+  displayed in toolbars. If this is not wanted, the feature can be 
+  suppressed by inserting a Unicode control character, e.g ZWNJ.
+
+* The pixbuf theme engine can now customize expanders (in GtkTreeView
+  and GtkExpander) and resize grips, using the new EXPANDER and
+  RESIZE_GRIP function values.
+
+* Dialogs created by gtk_about_dialog_new() no longer hide automatically
+  when the user clicks close. It is the applications responsibility to
+  hide or destroy the dialog.
+
+* Several new signals have been added to GtkNotebook. Care has been taken
+  to choose signal names which do not collide with signals added by well-known
+  derived classes. The names which can no longer be used for signals in 
+  objects derived from GtkNotebook are page-reordered, page-removed and
+  page-added.
+
+* Due to the interface changes in the file chooser backend interface, 
+  the GTK+ ABI version has been bumped to 2.10.0. Third-party filesystem 
+  backends have to be ported to the new interface, other modules, such as 
+  theme engines, input method modules or pixbuf loaders have to be rebuilt 
+  so that they are installed in the right place for GTK+ to find them.
+
+
+Release notes for 2.8
+=====================
+
+* GTK+ 2.8 and Pango 1.10 require the cairo library.
+
+* The default theme has been renamed to "Raleigh". Existing configurations
+  specifying the "Default" theme name should still work.
+
+* The GtkTreeView::enable-search property has been changed to control
+  only typeahead search, not the C-f keybinding to start an interactive
+  search. To turn off interactive searching completely, you have to
+  set GtkTreeView::search-column to -1.
+
+* The restriction on using the same cell renderer in multiple columns
+  of a GtkTreeView is now more strictly enforced.
+
+* In GTK+ 2.8, GtkCalendar uses nl_langinfo() (if available) to determine
+  the first day of the week. Thus, it is possible to select the first day
+  of the week independently from the language, by setting LC_TIME.
+
+* In GTK+ 2.8, the gtk-update-icon-cache utility includes image data
+  in the icon caches, which will make the icon cache files larger than
+  the one produced by GTK+ 2.6. This change will reduce the memory
+  overhead of icon themes at runtime, since all GTK+ applications can
+  share the image data in memory.
+
+* In 2.8, GDK emits GdkEventGrabBroken events when a keyboard or pointer
+  grab is broken. On X11, this can happen if the same application grabs
+  again, or if the window used for the grab becomes unviewable. It happens
+  more often on Win32. Applications which use grabs should pay attention
+  to these events and do the necessary cleanups when the grab is lost.
+* The GIOChannel code for sockets on win32 has been rewritten.
+  Applications who make non-trivial use of GIOChannels on win32 should
+  be watched for possible problems.
+
+* GLib 2.8 uses atomic operations to implement reference counting, thus
+  g_object_ref/unref, g_closure_ref/sink/unref and g_iochannel_ref/unref
+  can be used without locking in multithreaded applications. Note that
+  other modifications, like concurrent setting of properties still require
+  locking.
+
+* g_convert() and related character set conversion functions have been
+  fixed to emit pending shift states and to not cache iconv descriptors
+  across multiple calls, since that is problematic for some encodings.
+  Note that these functions are not suitable for streaming conversions;
+  use g_iconv() to do streaming conversion.
+
+
+Release notes for 2.6
+=====================
 
 * GTK+ 2.6 supports clipboard persistency. To make use of this feature,
   a clipboard manager following the specification at
@@ -108,6 +206,7 @@ Release notes
   consideration, and use the gstdio wrappers to access files whose 
   names have been constructed from strings returned from GTK+ or GLib.
 
+
 How to report bugs
 ==================
 
@@ -141,6 +240,7 @@ In the bug report please include:
   it will be more useful if the stacktrace is produced running the test
   program with the --sync command line option.
 
+
 Patches
 =======
 

README.in

@@ -20,11 +20,13 @@ The official web site is:
 Information about mailing lists can be found at
   http://www.gtk.org/mailinglists.html
 
+
 Installation
 ============
 
 See the file 'INSTALL'
 
+
 Release notes for 2.10
 ======================
 
@@ -48,15 +50,15 @@ Release notes for 2.10
   reference. Details about floating references can be found in the docs:
   http://developer.gnome.org/doc/API/2.0/gobject/gobject-The-Base-Object-Type.html#floating-ref
 
-* Suffixes like (_F) are now stripped from labels when they are displayed
-  in toolbars. If this is not wanted, the feature can be suppressed by 
-  inserting a Unicode control character, e.g ZWNJ.
+* Accelerators like (_F) are now stripped from labels when they are 
+  displayed in toolbars. If this is not wanted, the feature can be 
+  suppressed by inserting a Unicode control character, e.g ZWNJ.
 
 * The pixbuf theme engine can now customize expanders (in GtkTreeView
   and GtkExpander) and resize grips, using the new EXPANDER and
   RESIZE_GRIP function values.
 
-* Dialogs created by gtk_about_dialog_new no longer hide automatically
+* Dialogs created by gtk_about_dialog_new() no longer hide automatically
   when the user clicks close. It is the applications responsibility to
   hide or destroy the dialog.
 
@@ -66,8 +68,63 @@ Release notes for 2.10
   objects derived from GtkNotebook are page-reordered, page-removed and
   page-added.
 
-Release notes
-=============
+* Due to the interface changes in the file chooser backend interface, 
+  the GTK+ ABI version has been bumped to 2.10.0. Third-party filesystem 
+  backends have to be ported to the new interface, other modules, such as 
+  theme engines, input method modules or pixbuf loaders have to be rebuilt 
+  so that they are installed in the right place for GTK+ to find them.
+
+
+Release notes for 2.8
+=====================
+
+* GTK+ 2.8 and Pango 1.10 require the cairo library.
+
+* The default theme has been renamed to "Raleigh". Existing configurations
+  specifying the "Default" theme name should still work.
+
+* The GtkTreeView::enable-search property has been changed to control
+  only typeahead search, not the C-f keybinding to start an interactive
+  search. To turn off interactive searching completely, you have to
+  set GtkTreeView::search-column to -1.
+
+* The restriction on using the same cell renderer in multiple columns
+  of a GtkTreeView is now more strictly enforced.
+
+* In GTK+ 2.8, GtkCalendar uses nl_langinfo() (if available) to determine
+  the first day of the week. Thus, it is possible to select the first day
+  of the week independently from the language, by setting LC_TIME.
+
+* In GTK+ 2.8, the gtk-update-icon-cache utility includes image data
+  in the icon caches, which will make the icon cache files larger than
+  the one produced by GTK+ 2.6. This change will reduce the memory
+  overhead of icon themes at runtime, since all GTK+ applications can
+  share the image data in memory.
+
+* In 2.8, GDK emits GdkEventGrabBroken events when a keyboard or pointer
+  grab is broken. On X11, this can happen if the same application grabs
+  again, or if the window used for the grab becomes unviewable. It happens
+  more often on Win32. Applications which use grabs should pay attention
+  to these events and do the necessary cleanups when the grab is lost.
+* The GIOChannel code for sockets on win32 has been rewritten.
+  Applications who make non-trivial use of GIOChannels on win32 should
+  be watched for possible problems.
+
+* GLib 2.8 uses atomic operations to implement reference counting, thus
+  g_object_ref/unref, g_closure_ref/sink/unref and g_iochannel_ref/unref
+  can be used without locking in multithreaded applications. Note that
+  other modifications, like concurrent setting of properties still require
+  locking.
+
+* g_convert() and related character set conversion functions have been
+  fixed to emit pending shift states and to not cache iconv descriptors
+  across multiple calls, since that is problematic for some encodings.
+  Note that these functions are not suitable for streaming conversions;
+  use g_iconv() to do streaming conversion.
+
+
+Release notes for 2.6
+=====================
 
 * GTK+ 2.6 supports clipboard persistency. To make use of this feature,
   a clipboard manager following the specification at
@@ -149,6 +206,7 @@ Release notes
   consideration, and use the gstdio wrappers to access files whose 
   names have been constructed from strings returned from GTK+ or GLib.
 
+
 How to report bugs
 ==================
 
@@ -182,6 +240,7 @@ In the bug report please include:
   it will be more useful if the stacktrace is produced running the test
   program with the --sync command line option.
 
+
 Patches
 =======
 

acconfig.h

@@ -68,6 +68,8 @@
 
 #undef GETTEXT_PACKAGE
 
+#undef HAVE_CUPS_API_1_2
+
 /* #undef PACKAGE */
 /* #undef VERSION */
 

configure.in

@@ -11,11 +11,11 @@ AC_PREREQ(2.54)
 # set GTK_BINARY_AGE and GTK_INTERFACE_AGE to 0.
 
 m4_define([gtk_major_version], [2])
-m4_define([gtk_minor_version], [9])
-m4_define([gtk_micro_version], [0])
+m4_define([gtk_minor_version], [10])
+m4_define([gtk_micro_version], [7])
 m4_define([gtk_version],
           [gtk_major_version.gtk_minor_version.gtk_micro_version])
-m4_define([gtk_interface_age], [0])
+m4_define([gtk_interface_age], [7])
 m4_define([gtk_binary_age],
           [m4_eval(100 * gtk_minor_version + gtk_micro_version)])
 # This is the X.Y used in -lgtk-FOO-X.Y
@@ -28,13 +28,13 @@ m4_define([gtk_api_version], [2.0])
 # for GTK+.
 #
 #GTK_BINARY_VERSION=$GTK_MAJOR_VERSION.$GTK_MINOR_VERSION.$LT_CURRENT
-m4_define([gtk_binary_version], [2.4.0])
+m4_define([gtk_binary_version], [2.10.0])
 
 # required versions of other packages
-m4_define([glib_required_version], [2.10.1])
-m4_define([pango_required_version], [1.9.0])
-m4_define([atk_required_version], [1.0.1])
-m4_define([cairo_required_version], [0.9.2])
+m4_define([glib_required_version], [2.12.0])
+m4_define([pango_required_version], [1.12.0])
+m4_define([atk_required_version], [1.9.0])
+m4_define([cairo_required_version], [1.2.0])
 
 
 AC_INIT([gtk+], [gtk_version],
@@ -370,7 +370,8 @@ AC_ARG_ENABLE(explicit-deps,
 AC_MSG_CHECKING([Whether to write dependencies into .pc files])
 case $enable_explicit_deps in
   auto)
-    deplibs_check_method=`(./libtool --config; echo eval echo \\$deplibs_check_method) | sh`
+    export SED
+    deplibs_check_method=`(./libtool --config; echo 'eval echo $deplibs_check_method') | sh`
     if test "x$deplibs_check_method" '!=' xpass_all || test "x$enable_static" = xyes ; then
       enable_explicit_deps=yes  
     else
@@ -402,7 +403,7 @@ if test "x$enable_rebuilds" = "xyes" && \
 fi
 AC_SUBST(REBUILD)
 
-AC_CHECK_FUNCS(lstat mkstemp flockfile)
+AC_CHECK_FUNCS(lstat mkstemp flockfile getc_unlocked)
 
 # _NL_TIME_FIRST_WEEKDAY is an enum and not a define
 AC_MSG_CHECKING([for _NL_TIME_FIRST_WEEKDAY])
@@ -416,6 +417,42 @@ if test "$gtk_ok" = "yes"; then
 	    [Define if _NL_TIME_FIRST_WEEKDAY is available])
 fi
 
+# _NL_MEASUREMENT_MEASUREMENT is an enum and not a define
+AC_MSG_CHECKING([for _NL_MEASUREMENT_MEASUREMENT])
+AC_TRY_LINK([#include <langinfo.h>], [
+char c;
+c = *((unsigned char *)  nl_langinfo(_NL_MEASUREMENT_MEASUREMENT));
+], gtk_ok=yes, gtk_ok=no)
+AC_MSG_RESULT($gtk_ok)
+if test "$gtk_ok" = "yes"; then
+  AC_DEFINE([HAVE__NL_MEASUREMENT_MEASUREMENT], [1],
+	    [Define if _NL_MEASUREMENT_MEASUREMENT is available])
+fi
+
+# _NL_PAPER_HEIGHT is an enum and not a define
+AC_MSG_CHECKING([for _NL_PAPER_HEIGHT])
+AC_TRY_LINK([#include <langinfo.h>], [
+char c;
+c = *((unsigned char *)  nl_langinfo(_NL_PAPER_HEIGHT));
+], gtk_ok=yes, gtk_ok=no)
+AC_MSG_RESULT($gtk_ok)
+if test "$gtk_ok" = "yes"; then
+  AC_DEFINE([HAVE__NL_PAPER_HEIGHT], [1],
+	    [Define if _NL_PAPER_HEIGHT is available])
+fi
+
+# _NL_PAPER_WIDTH is an enum and not a define
+AC_MSG_CHECKING([for _NL_PAPER_WIDTH])
+AC_TRY_LINK([#include <langinfo.h>], [
+char c;
+c = *((unsigned char *)  nl_langinfo(_NL_PAPER_WIDTH));
+], gtk_ok=yes, gtk_ok=no)
+AC_MSG_RESULT($gtk_ok)
+if test "$gtk_ok" = "yes"; then
+  AC_DEFINE([HAVE__NL_PAPER_WIDTH], [1],
+	    [Define if _NL_PAPER_WIDTH is available])
+fi
+	
 # sigsetjmp is a macro on some platforms, so AC_CHECK_FUNCS is not reliable
 AC_MSG_CHECKING(for sigsetjmp)
 AC_TRY_LINK([#include <setjmp.h>], [
@@ -433,7 +470,7 @@ fi
 # sure that both po/ and po-properties/ have .po files that correspond
 # to your language.  If you only add one to po/, the build will break
 # in po-properties/.
-ALL_LINGUAS="af am ar az az_IR be bg bn br bs ca cs cy da de el en_CA en_GB es et eu fa fi fr ga gl gu he hi hr hu hy ia id is it ja ko ku li lt lv mi mk ml mn mr ms nb ne nl nn no nso pa pl pt pt_BR ro ru rw sk sl sq sr sr@Latn sr@ije sv ta te th tk tr tt uk uz uz@Latn vi wa xh yi zh_CN zh_HK zh_TW"
+ALL_LINGUAS="af am ang ar as az az_IR be bg bn bn_IN br bs ca cs cy da de dz el en_CA en_GB es et eu fa fi fr ga gl gu he hi hr hu hy ia id is it ja ka ko ku li lt lv mi mk ml mn mr ms nb ne nl nn nso or pa pl pt pt_BR ro ru rw si sk sl sq sr sr@Latn sr@ije sv ta te th tk tr tt uk ur uz uz@Latn vi wa xh yi zh_CN zh_HK zh_TW"
 AM_GLIB_GNU_GETTEXT
 LIBS="$LIBS $INTLLIBS"
 AC_OUTPUT_COMMANDS([case "$CONFIG_FILES" in *po-properties/Makefile.in*)
@@ -692,6 +729,10 @@ fi
 AC_MSG_RESULT($gtk_uxtheme_h)
 
 
+# Checks for gdkspawn
+AC_CHECK_HEADERS(crt_externs.h)
+AC_CHECK_FUNCS(_NSGetEnviron)
+
 ##################################################
 # Checks for gdk-pixbuf
 ##################################################
@@ -996,7 +1037,8 @@ AM_CONDITIONAL(CROSS_COMPILING, test $cross_compiling = yes)
 
 if test $cross_compiling = yes; then
   AC_PATH_PROG(GDK_PIXBUF_CSOURCE, gdk-pixbuf-csource, no)
-  if test x$GDK_PIXBUF_CSOURCE = xno; then
+  AC_PATH_PROG(GTK_UPDATE_ICON_CACHE, gtk-update-icon-cache, no)
+  if test x$GTK_UPDATE_ICON_CACHE = xno; then
     REBUILD_PNGS=#
   fi
 fi
@@ -1006,7 +1048,7 @@ if test ! -f $srcdir/gtk/gtkbuiltincache.h &&
      AC_MSG_ERROR([
 *** gtkbuiltincache.h is not in the tree, and cannot be built
 *** because you don't have libpng, or (when cross-compiling) you 
-*** don't have a prebuilt gdk-pixbuf-csource on the host system.])
+*** don't have a prebuilt gtk-update-icon-cache on the build system.])
 fi
 
 AC_SUBST(REBUILD_PNGS)
@@ -1056,8 +1098,8 @@ if test "x$gdktarget" = "xx11"; then
   if $PKG_CONFIG --exists x11 xext xrender; then
     have_base_x_pc=true
     X_PACKAGES="$X_PACKAGES x11 xext xrender"
-    x_libs="`pkg-config --libs x11 xext xrender`"
-    X_CFLAGS="`pkg-config --cflags x11 xext xrender`"
+    x_libs="`$PKG_CONFIG --libs x11 xext xrender`"
+    X_CFLAGS="`$PKG_CONFIG --cflags x11 xext xrender`"
     
     # Strip out any .la files that pkg-config might give us (this happens
     # with -uninstalled.pc files)
@@ -1156,12 +1198,16 @@ if test "x$gdktarget" = "xx11"; then
       AC_DEFINE(HAVE_SHAPE_EXT))
 
   # X SYNC check
+  gtk_save_CFLAGS="$CFLAGS"
+  CFLAGS="$CFLAGS $x_cflags"
   
   AC_CHECK_FUNC(XSyncQueryExtension,
       [AC_CHECK_HEADER(X11/extensions/sync.h,
 	  AC_DEFINE(HAVE_XSYNC, 1, Have the SYNC extension library),
 	  :, [#include <X11/Xlib.h>])])
 
+  CFLAGS="$gtk_save_CFLAGS"
+
   # Xshm checks
 
   if test "x$enable_shm" = "xyes"; then
@@ -1370,17 +1416,18 @@ else
 fi
 
 if test "x$gdktarget" = "xdirectfb"; then
-  DIRECTFB_REQUIRED_VERSION=0.9.21
+  DIRECTFB_REQUIRED_VERSION=0.9.24
   AC_MSG_CHECKING(for DirectFB)
 
-  if $PKG_CONFIG --atleast-version $DIRECTFB_REQUIRED_VERSION directfb ; then
+  if $PKG_CONFIG --atleast-version $DIRECTFB_REQUIRED_VERSION directfb -a $PKG_CONFIG --exists cairo-directfb ; then
       AC_MSG_RESULT(found)
-      GDK_EXTRA_CFLAGS="`$PKG_CONFIG --cflags directfb` $GDK_EXTRA_CFLAGS"
-      GDK_EXTRA_LIBS="`$PKG_CONFIG --libs directfb` $GDK_EXTRA_LIBS"
+      GDK_EXTRA_CFLAGS="`$PKG_CONFIG --cflags cairo-directfb` $GDK_EXTRA_CFLAGS"
+      GDK_EXTRA_LIBS="`$PKG_CONFIG --libs cairo-directfb` $GDK_EXTRA_LIBS"
   else
       AC_MSG_ERROR([
-*** DirectFB $DIRECTFB_REQUIRED_VERSION or newer is required. The latest
-*** version of DirectFB is always available from http://www.directfb.org/.
+*** DirectFB $DIRECTFB_REQUIRED_VERSION or newer and the cairo backend 
+*** are required. The latest version of DirectFB is always available 
+*** from http://www.directfb.org/.
   ])
   fi
 
@@ -1499,6 +1546,47 @@ AC_SUBST(GTK_DEP_CFLAGS)
 AC_SUBST(GTK_DEBUG_FLAGS)
 AC_SUBST(GTK_XIM_FLAGS)
 
+################################################################
+# Printing system checks
+################################################################
+
+AC_PATH_PROG(CUPS_CONFIG, cups-config, no)
+if test "x$CUPS_CONFIG" != "xno"; then
+  CUPS_CFLAGS=`cups-config --cflags | sed 's/-O[0-9]*//' | sed 's/-m[^\t]*//g'`
+  CUPS_LIBS=`cups-config --libs`
+
+  CUPS_API_VERSION=`cups-config --api-version`
+  CUPS_API_MAJOR=`echo -n $CUPS_API_VERSION | awk -F. '{print $1}'`
+  CUPS_API_MINOR=`echo -n $CUPS_API_VERSION | awk -F. '{print $2}'`
+
+  if test $CUPS_API_MAJOR -gt 1 -o \
+          $CUPS_API_MAJOR -eq 1 -a $CUPS_API_MINOR -ge 2; then
+    AC_DEFINE(HAVE_CUPS_API_1_2)
+  fi
+
+  AC_SUBST(CUPS_API_MAJOR)
+  AC_SUBST(CUPS_API_MINOR)
+  AC_SUBST(CUPS_CFLAGS)
+  AC_SUBST(CUPS_LIBS)
+fi
+AM_CONDITIONAL(HAVE_CUPS, test "x$CUPS_CONFIG" != "xno")
+
+gtk_save_cppflags="$CPPFLAGS"
+CPPFLAGS="$CPPFLAGS $GTK_DEP_CFLAGS"
+			  
+AC_CHECK_HEADER(cairo-pdf.h,,AC_MSG_ERROR([
+*** Can't find cairo-pdf.h. You must build Cairo with the pdf
+*** backend enabled.]))
+
+if test "$os_win32" != "yes"; then
+  AC_CHECK_HEADER(cairo-ps.h,,AC_MSG_ERROR([
+*** Can't find cairo-ps.h. You must build Cairo with the 
+*** postscript backend enabled.]))
+fi   
+
+CPPFLAGS="$gtk_save_cppflags"
+     
+			  	
 ################################################################
 # Strip -export-dynamic from the link lines of various libraries
 ################################################################
@@ -1512,6 +1600,7 @@ AC_SUBST(GTK_XIM_FLAGS)
 #
 # We are using gmodule-no-export now, but I'm leaving the stripping
 # code in place for now, since pango and atk still require gmodule.
+export SED
 export_dynamic=`(./libtool --config; echo eval echo \\$export_dynamic_flag_spec) | sh`
 if test -n "$export_dynamic"; then
   GDK_PIXBUF_DEP_LIBS=`echo $GDK_PIXBUF_DEP_LIBS | sed -e "s/$export_dynamic//"`
@@ -1638,6 +1727,7 @@ Makefile
 gdk-pixbuf-2.0.pc
 gdk-2.0.pc
 gtk+-2.0.pc
+gtk+-unix-print-2.0.pc
 gdk-pixbuf-2.0-uninstalled.pc
 gdk-2.0-uninstalled.pc
 gtk+-2.0-uninstalled.pc
@@ -1684,6 +1774,10 @@ modules/engines/pixbuf/Makefile
 modules/engines/ms-windows/Makefile
 modules/engines/ms-windows/Theme/Makefile
 modules/engines/ms-windows/Theme/gtk-2.0/Makefile
+modules/printbackends/Makefile
+modules/printbackends/cups/Makefile
+modules/printbackends/lpr/Makefile
+modules/printbackends/file/Makefile
 perf/Makefile
 contrib/Makefile
 contrib/gdk-pixbuf-xlib/Makefile

contrib/gdk-pixbuf-xlib/ChangeLog

@@ -1,3 +1,55 @@
+2007-01-05  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.7 ===
+
+2006-10-03  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.6 ===
+
+2006-10-02  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.5 ===
+
+2006-09-22  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.4 ===
+
+2006-09-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.3 ===
+
+2006-08-17  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.2 ===
+
+2006-07-23  Matthias Clasen  <mclasen@redhat.com>
+	
+	* === Released 2.10.1 ===
+
+2006-07-02  Matthias Clasen  <mclasen@redhat.com>
+	
+	* === Released 2.10.0 ===
+
+2006-06-21  Matthias Clasen  <mclasen@redhat.com>
+	
+	* === Released 2.9.4 ===
+
+2006-06-12  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.3 ===
+
+2006-06-05  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.2 ===
+
+2006-05-16  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.1 ====
+
+2006-05-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.0 ===
+
 2005-11-17  Matthias Clasen  <mclasen@redhat.com>
 
 	* gdk-pixbuf-xlib-drawable.c: 

contrib/gdk-pixbuf-xlib/Makefile.am

@@ -1,3 +1,7 @@
+if PLATFORM_WIN32
+no_undefined = -no-undefined
+endif
+
 lib_LTLIBRARIES=libgdk_pixbuf_xlib-2.0.la
 
 INCLUDES = \
@@ -9,6 +13,7 @@ INCLUDES = \
 
 libgdk_pixbuf_xlib_2_0_la_LDFLAGS =         \
 	-export-dynamic						\
+	$(no_undefined)						\
 	-version-info $(LT_VERSION_INFO)
 
 libgdk_pixbuf_xlib_2_0_la_LIBADD = \

demos/gtk-demo/Makefile.am

@@ -26,10 +26,12 @@ demos =						\
 	panes.c					\
 	pickers.c				\
 	pixbufs.c				\
+	printing.c				\
 	rotated_text.c				\
 	sizegroup.c				\
 	stock_browser.c				\
 	textview.c				\
+	textscroll.c				\
 	tree_store.c				\
 	ui_manager.c
 

demos/gtk-demo/appwindow.c

@@ -467,6 +467,7 @@ do_appwindow (GtkWidget *do_widget)
 				  "stock-id", GTK_STOCK_OPEN,
 				  NULL);
       gtk_action_group_add_action (action_group, open_action);
+      g_object_unref (open_action);
       gtk_action_group_add_actions (action_group, 
 				    entries, n_entries, 
 				    window);

demos/gtk-demo/changedisplay.c

@@ -300,6 +300,8 @@ display_changed_cb (GtkTreeSelection  *selection,
   GtkTreeModel *model;
   GtkTreeIter iter;
 
+  if (info->current_display)
+    g_object_unref (info->current_display);
   if (gtk_tree_selection_get_selected (selection, &model, &iter))
     gtk_tree_model_get (model, &iter,
 			DISPLAY_COLUMN_DISPLAY, &info->current_display,
@@ -320,6 +322,8 @@ screen_changed_cb (GtkTreeSelection  *selection,
   GtkTreeModel *model;
   GtkTreeIter iter;
 
+  if (info->current_screen)
+    g_object_unref (info->current_screen);
   if (gtk_tree_selection_get_selected (selection, &model, &iter))
     gtk_tree_model_get (model, &iter,
 			SCREEN_COLUMN_SCREEN, &info->current_screen,
@@ -562,6 +566,14 @@ destroy_info (ChangeDisplayInfo *info)
   g_slist_free (tmp_list);
 
   g_object_unref (info->size_group);
+  g_object_unref (info->display_model);
+  g_object_unref (info->screen_model);
+
+  if (info->current_display)
+    g_object_unref (info->current_display);
+  if (info->current_screen)
+    g_object_unref (info->current_screen);
+
   g_free (info);
 }
 

demos/gtk-demo/colorsel.c

@@ -15,7 +15,9 @@ static GtkWidget *frame;
 /* Expose callback for the drawing area
  */
 static gboolean
-expose_event_callback (GtkWidget *widget, GdkEventExpose *event, gpointer data)
+expose_event_callback (GtkWidget      *widget, 
+                       GdkEventExpose *event, 
+                       gpointer        data)
 {
   if (widget->window)
     {

demos/gtk-demo/combobox.c

@@ -74,6 +74,7 @@ create_stock_icon_store (void)
 			      PIXBUF_COL, pixbuf,
 			      TEXT_COL, label,
 			      -1);
+	  g_object_unref (pixbuf);
 	  g_free (label);
 	}
       else

demos/gtk-demo/drawingarea.c

@@ -218,6 +218,16 @@ checkerboard_expose (GtkWidget	    *da,
   return TRUE;
 }
 
+static void
+close_window (void)
+{
+  window = NULL;
+
+  if (pixmap)
+    g_object_unref (pixmap);
+  pixmap = NULL;
+}
+
 GtkWidget *
 do_drawingarea (GtkWidget *do_widget)
 {
@@ -233,7 +243,7 @@ do_drawingarea (GtkWidget *do_widget)
 			     gtk_widget_get_screen (do_widget));
       gtk_window_set_title (GTK_WINDOW (window), "Drawing Area");
 
-      g_signal_connect (window, "destroy", G_CALLBACK (gtk_widget_destroyed), &window);
+      g_signal_connect (window, "destroy", G_CALLBACK (close_window), NULL);
 
       gtk_container_set_border_width (GTK_CONTAINER (window), 8);
 
@@ -309,14 +319,9 @@ do_drawingarea (GtkWidget *do_widget)
     }
 
   if (!GTK_WIDGET_VISIBLE (window))
-    {
       gtk_widget_show_all (window);
-    }
   else
-    {
       gtk_widget_destroy (window);
-      window = NULL;
-    }
 
   return window;
 }

demos/gtk-demo/editable_cells.c

@@ -121,7 +121,10 @@ create_numbers_model (void)
   /* add numbers */
   for (i = 0; i < N_NUMBERS; i++)
     {
-      char str[2] = { '0' + i, '\0' };
+      char str[2];
+
+      str[0] = '0' + i;
+      str[1] = '\0';
 
       gtk_list_store_append (model, &iter);
 

demos/gtk-demo/iconview.c

@@ -243,6 +243,18 @@ home_clicked (GtkToolItem *item,
 			    TRUE);
 }
 
+static void close_window(void)
+{
+  gtk_widget_destroy (window);
+  window = NULL;
+
+  g_object_unref (file_pixbuf);
+  file_pixbuf = NULL;
+
+  g_object_unref (folder_pixbuf);
+  folder_pixbuf = NULL;
+}
+
 GtkWidget *
 do_iconview (GtkWidget *do_widget)
 {
@@ -258,7 +270,7 @@ do_iconview (GtkWidget *do_widget)
       gtk_window_set_title (GTK_WINDOW (window), "GtkIconView demo");
 
       g_signal_connect (window, "destroy",
-			G_CALLBACK (gtk_widget_destroyed), &window);
+			G_CALLBACK (close_window), NULL);
 
       error = NULL;
       if (!load_pixbufs (&error))

demos/gtk-demo/main.c

@@ -19,7 +19,7 @@ enum {
   TITLE_COLUMN,
   FILENAME_COLUMN,
   FUNC_COLUMN,
-  ITALIC_COLUMN,
+  STYLE_COLUMN,
   NUM_COLUMNS
 };
 
@@ -94,15 +94,15 @@ window_closed_cb (GtkWidget *window, gpointer data)
 {
   CallbackData *cbdata = data;
   GtkTreeIter iter;
-  gboolean italic;
+  PangoStyle style;
 
   gtk_tree_model_get_iter (cbdata->model, &iter, cbdata->path);
   gtk_tree_model_get (GTK_TREE_MODEL (cbdata->model), &iter,
-		      ITALIC_COLUMN, &italic,
+		      STYLE_COLUMN, &style,
 		      -1);
-  if (italic)
+  if (style == PANGO_STYLE_ITALIC)
     gtk_tree_store_set (GTK_TREE_STORE (cbdata->model), &iter,
-			ITALIC_COLUMN, !italic,
+			STYLE_COLUMN, PANGO_STYLE_NORMAL,
 			-1);
 
   gtk_tree_path_free (cbdata->path);
@@ -586,7 +586,7 @@ row_activated_cb (GtkTreeView       *tree_view,
 		  GtkTreeViewColumn *column)
 {
   GtkTreeIter iter;
-  gboolean italic;
+  PangoStyle style;
   GDoDemoFunc func;
   GtkWidget *window;
   GtkTreeModel *model;
@@ -597,14 +597,14 @@ row_activated_cb (GtkTreeView       *tree_view,
   gtk_tree_model_get (GTK_TREE_MODEL (model),
 		      &iter,
 		      FUNC_COLUMN, &func,
-		      ITALIC_COLUMN, &italic,
+		      STYLE_COLUMN, &style,
 		      -1);
 
   if (func)
     {
       gtk_tree_store_set (GTK_TREE_STORE (model),
 			  &iter,
-			  ITALIC_COLUMN, !italic,
+			  STYLE_COLUMN, (style == PANGO_STYLE_ITALIC ? PANGO_STYLE_NORMAL : PANGO_STYLE_ITALIC),
 			  -1);
       window = (func) (gtk_widget_get_toplevel (GTK_WIDGET (tree_view)));
       
@@ -700,7 +700,7 @@ create_tree (void)
 
   Demo *d = testgtk_demos;
 
-  model = gtk_tree_store_new (NUM_COLUMNS, G_TYPE_STRING, G_TYPE_STRING, G_TYPE_POINTER, G_TYPE_BOOLEAN);
+  model = gtk_tree_store_new (NUM_COLUMNS, G_TYPE_STRING, G_TYPE_STRING, G_TYPE_POINTER, G_TYPE_INT);
   tree_view = gtk_tree_view_new ();
   gtk_tree_view_set_model (GTK_TREE_VIEW (tree_view), GTK_TREE_MODEL (model));
   selection = gtk_tree_view_get_selection (GTK_TREE_VIEW (tree_view));
@@ -723,7 +723,7 @@ create_tree (void)
 			  TITLE_COLUMN, d->title,
 			  FILENAME_COLUMN, d->filename,
 			  FUNC_COLUMN, d->func,
-			  ITALIC_COLUMN, FALSE,
+			  STYLE_COLUMN, PANGO_STYLE_NORMAL,
 			  -1);
 
       d++;
@@ -742,7 +742,7 @@ create_tree (void)
 			      TITLE_COLUMN, children->title,
 			      FILENAME_COLUMN, children->filename,
 			      FUNC_COLUMN, children->func,
-			      ITALIC_COLUMN, FALSE,
+			      STYLE_COLUMN, PANGO_STYLE_NORMAL,
 			      -1);
 	  
 	  children++;
@@ -751,14 +751,10 @@ create_tree (void)
 
   cell = gtk_cell_renderer_text_new ();
 
-  g_object_set (cell,
-                "style", PANGO_STYLE_ITALIC,
-                NULL);
-  
   column = gtk_tree_view_column_new_with_attributes ("Widget (double click for demo)",
 						     cell,
 						     "text", TITLE_COLUMN,
-						     "style_set", ITALIC_COLUMN,
+						     "style", STYLE_COLUMN,
 						     NULL);
   
   gtk_tree_view_append_column (GTK_TREE_VIEW (tree_view),
@@ -786,6 +782,8 @@ create_tree (void)
 
   gtk_widget_grab_focus (tree_view);
 
+   g_object_unref (model);
+
   return box;
 }
 
@@ -869,7 +867,7 @@ main (int argc, char **argv)
   
   window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
   gtk_window_set_title (GTK_WINDOW (window), "GTK+ Code Demos");
-  g_signal_connect (window, "destroy",
+  g_signal_connect_after (window, "destroy",
 		    G_CALLBACK (gtk_main_quit), NULL);
 
   hbox = gtk_hbox_new (FALSE, 0);
@@ -885,16 +883,18 @@ main (int argc, char **argv)
 			    create_text (&info_buffer, FALSE),
 			    gtk_label_new_with_mnemonic ("_Info"));
 
+  tag = gtk_text_buffer_create_tag (info_buffer, "title",
+                                    "font", "Sans 18",
+                                    NULL);
+   g_object_unref (info_buffer);
+
   gtk_notebook_append_page (GTK_NOTEBOOK (notebook),
 			    create_text (&source_buffer, TRUE),
 			    gtk_label_new_with_mnemonic ("_Source"));
 
-  tag = gtk_text_buffer_create_tag (info_buffer, "title",
-                                    "font", "Sans 18",
-                                    NULL);
 
   tag = gtk_text_buffer_create_tag (source_buffer, "comment",
-				    "foreground", "red",
+				    "foreground", "DodgerBlue",
                                     NULL);
   tag = gtk_text_buffer_create_tag (source_buffer, "type",
 				    "foreground", "ForestGreen",
@@ -914,6 +914,7 @@ main (int argc, char **argv)
 				    "weight", PANGO_WEIGHT_BOLD,
  				    "foreground", "DarkGoldenrod4",
                                     NULL);
+   g_object_unref (source_buffer);
   
   gtk_window_set_default_size (GTK_WINDOW (window), 600, 400);
   gtk_widget_show_all (window);

demos/gtk-demo/printing.c

@@ -0,0 +1,182 @@
+/* Printing
+ *
+ * GtkPrintOperation offers a simple API to support printing
+ * in a cross-platform way.
+ *
+ */
+
+#include <math.h>
+#include <gtk/gtk.h>
+#include "demo-common.h"
+
+/* In points */
+#define HEADER_HEIGHT (10*72/25.4)
+#define HEADER_GAP (3*72/25.4)
+
+typedef struct 
+{
+  gchar *filename;
+  gdouble font_size;
+
+  gint lines_per_page;  
+  gchar **lines;
+  gint num_lines;
+  gint num_pages;
+} PrintData;
+
+static void
+begin_print (GtkPrintOperation *operation, 
+	     GtkPrintContext   *context,
+	     gpointer           user_data)
+{
+  PrintData *data = (PrintData *)user_data;
+  char *contents;
+  int i;
+  double height;
+
+  height = gtk_print_context_get_height (context) - HEADER_HEIGHT - HEADER_GAP;
+  
+  data->lines_per_page = floor (height / data->font_size);
+  
+  g_file_get_contents (data->filename, &contents, NULL, NULL);
+
+  data->lines = g_strsplit (contents, "\n", 0);
+  g_free (contents);
+
+  i = 0;
+  while (data->lines[i] != NULL)
+    i++;
+  
+  data->num_lines = i;
+  data->num_pages = (data->num_lines - 1) / data->lines_per_page + 1;
+  gtk_print_operation_set_n_pages (operation, data->num_pages);
+}
+
+static void
+draw_page (GtkPrintOperation *operation,
+	   GtkPrintContext   *context,
+	   gint               page_nr,
+	   gpointer           user_data)
+{
+  PrintData *data = (PrintData *)user_data;
+  cairo_t *cr;
+  PangoLayout *layout;
+  gdouble width, text_height;
+  gint line, i, layout_height;
+  PangoFontDescription *desc;
+  gchar *page_str;
+
+  cr = gtk_print_context_get_cairo_context (context);
+  width = gtk_print_context_get_width (context);
+
+  cairo_rectangle (cr, 0, 0, width, HEADER_HEIGHT);
+  
+  cairo_set_source_rgb (cr, 0.8, 0.8, 0.8);
+  cairo_fill_preserve (cr);
+  
+  cairo_set_source_rgb (cr, 0, 0, 0);
+  cairo_set_line_width (cr, 1);
+  cairo_stroke (cr);
+
+  layout = gtk_print_context_create_pango_layout (context);
+
+  desc = pango_font_description_from_string ("sans 14");
+  pango_layout_set_font_description (layout, desc);
+  pango_font_description_free (desc);
+
+  pango_layout_set_text (layout, data->filename, -1);
+  pango_layout_set_width (layout, width);
+  pango_layout_set_alignment (layout, PANGO_ALIGN_CENTER);
+			      
+  pango_layout_get_size (layout, NULL, &layout_height);
+  text_height = (gdouble)layout_height / PANGO_SCALE;
+
+  cairo_move_to (cr, width / 2,  (HEADER_HEIGHT - text_height) / 2);
+  pango_cairo_show_layout (cr, layout);
+
+  page_str = g_strdup_printf ("%d/%d", page_nr + 1, data->num_pages);
+  pango_layout_set_text (layout, page_str, -1);
+  g_free (page_str);
+  pango_layout_set_alignment (layout, PANGO_ALIGN_RIGHT);
+			      
+  cairo_move_to (cr, width - 2, (HEADER_HEIGHT - text_height) / 2);
+  pango_cairo_show_layout (cr, layout);
+  
+  g_object_unref (layout);
+  
+  layout = gtk_print_context_create_pango_layout (context);
+  
+  desc = pango_font_description_from_string ("mono");
+  pango_font_description_set_size (desc, data->font_size * PANGO_SCALE);
+  pango_layout_set_font_description (layout, desc);
+  pango_font_description_free (desc);
+  
+  cairo_move_to (cr, 0, HEADER_HEIGHT + HEADER_GAP);
+  line = page_nr * data->lines_per_page;
+  for (i = 0; i < data->lines_per_page && line < data->num_lines; i++) 
+    {
+      pango_layout_set_text (layout, data->lines[line], -1);
+      pango_cairo_show_layout (cr, layout);
+      cairo_rel_move_to (cr, 0, data->font_size);
+      line++;
+    }
+
+  g_object_unref (layout);
+}
+
+static void
+end_print (GtkPrintOperation *operation, 
+	   GtkPrintContext   *context,
+	   gpointer           user_data)
+{
+  PrintData *data = (PrintData *)user_data;
+
+  g_free (data->filename);
+  g_strfreev (data->lines);
+  g_free (data);
+}
+
+
+GtkWidget *
+do_printing (GtkWidget *do_widget)
+{
+  GtkPrintOperation *operation;
+  PrintData *data;
+  GError *error = NULL;
+
+  operation = gtk_print_operation_new ();
+  data = g_new0 (PrintData, 1);
+  data->filename = demo_find_file ("printing.c", NULL);
+  data->font_size = 12.0;
+
+  g_signal_connect (G_OBJECT (operation), "begin-print", 
+		    G_CALLBACK (begin_print), data);
+  g_signal_connect (G_OBJECT (operation), "draw-page", 
+		    G_CALLBACK (draw_page), data);
+  g_signal_connect (G_OBJECT (operation), "end-print", 
+		    G_CALLBACK (end_print), data);
+
+  gtk_print_operation_run (operation, GTK_PRINT_OPERATION_ACTION_PRINT_DIALOG, GTK_WINDOW (do_widget), &error);
+
+  g_object_unref (operation);
+
+  if (error)
+    {
+      GtkWidget *dialog;
+      
+      dialog = gtk_message_dialog_new (GTK_WINDOW (do_widget),
+				       GTK_DIALOG_DESTROY_WITH_PARENT,
+				       GTK_MESSAGE_ERROR,
+				       GTK_BUTTONS_CLOSE,
+				       "%s", error->message);
+      g_error_free (error);
+      
+      g_signal_connect (dialog, "response",
+			G_CALLBACK (gtk_widget_destroy), NULL);
+      
+      gtk_widget_show (dialog);      
+    }
+  
+
+  return NULL;
+}

demos/gtk-demo/textscroll.c

@@ -0,0 +1,200 @@
+/* Text Widget/Automatic scrolling
+ *
+ * This example demonstrates how to use the gravity of 
+ * GtkTextMarks to keep a text view scrolled to the bottom
+ * while appending text.
+ */
+
+#include <gtk/gtk.h>
+#include "demo-common.h"
+
+/* Scroll to the end of the buffer.
+ */
+static gboolean
+scroll_to_end (GtkTextView *textview)
+{
+  GtkTextBuffer *buffer;
+  GtkTextIter iter;
+  GtkTextMark *mark;
+  char *spaces;
+  static int count;
+
+  buffer = gtk_text_view_get_buffer (textview);
+  
+  /* Get "end" mark. It's located at the end of buffer because 
+   * of right gravity
+   */
+  mark = gtk_text_buffer_get_mark (buffer, "end");
+  gtk_text_buffer_get_iter_at_mark (buffer, &iter, mark);
+
+  /* and insert some text at its position, the iter will be 
+   * revalidated after insertion to point to the end of inserted text
+   */
+  spaces = g_strnfill (count++, ' ');
+  gtk_text_buffer_insert (buffer, &iter, "\n", -1);
+  gtk_text_buffer_insert (buffer, &iter, spaces, -1);
+  gtk_text_buffer_insert (buffer, &iter,
+                          "Scroll to end scroll to end scroll "
+                          "to end scroll to end ",
+                          -1);
+  g_free (spaces);
+
+  /* Now scroll the end mark onscreen.
+   */
+  gtk_text_view_scroll_mark_onscreen (textview, mark);
+
+  /* Emulate typewriter behavior, shift to the left if we 
+   * are far enough to the right.
+   */
+  if (count > 150)
+    count = 0;
+
+  return TRUE;
+}
+
+/* Scroll to the bottom of the buffer.
+ */
+static gboolean
+scroll_to_bottom (GtkTextView *textview)
+{
+  GtkTextBuffer *buffer;
+  GtkTextIter iter;
+  GtkTextMark *mark;
+  char *spaces;
+  static int count;
+
+  buffer = gtk_text_view_get_buffer (textview);
+  
+  /* Get end iterator */
+  gtk_text_buffer_get_end_iter (buffer, &iter);
+
+  /* and insert some text at it, the iter will be revalidated
+   * after insertion to point to the end of inserted text
+   */
+  spaces = g_strnfill (count++, ' ');
+  gtk_text_buffer_insert (buffer, &iter, "\n", -1);
+  gtk_text_buffer_insert (buffer, &iter, spaces, -1);
+  gtk_text_buffer_insert (buffer, &iter,
+                          "Scroll to bottom scroll to bottom scroll "
+                          "to bottom scroll to bottom",
+                          -1);
+  g_free (spaces);
+
+  /* Move the iterator to the beginning of line, so we don't scroll 
+   * in horizontal direction 
+   */
+  gtk_text_iter_set_line_offset (&iter, 0);
+  
+  /* and place the mark at iter. the mark will stay there after we
+   * insert some text at the end because it has right gravity.
+   */
+  mark = gtk_text_buffer_get_mark (buffer, "scroll");
+  gtk_text_buffer_move_mark (buffer, mark, &iter);
+  
+  /* Scroll the mark onscreen.
+   */
+  gtk_text_view_scroll_mark_onscreen (textview, mark);
+
+  /* Shift text back if we got enough to the right.
+   */
+  if (count > 40)
+    count = 0;
+
+  return TRUE;
+}
+
+static guint
+setup_scroll (GtkTextView *textview,
+              gboolean     to_end)
+{
+  GtkTextBuffer *buffer;
+  GtkTextIter iter;
+
+  buffer = gtk_text_view_get_buffer (textview);
+  gtk_text_buffer_get_end_iter (buffer, &iter);
+
+  if (to_end)
+  {
+    /* If we want to scroll to the end, including horizontal scrolling,
+     * then we just create a mark with right gravity at the end of the 
+     * buffer. It will stay at the end unless explicitely moved with 
+     * gtk_text_buffer_move_mark.
+     */
+    gtk_text_buffer_create_mark (buffer, "end", &iter, FALSE);
+    
+    /* Add scrolling timeout. */
+    return g_timeout_add (50, (GSourceFunc) scroll_to_end, textview);
+  }
+  else
+  {
+    /* If we want to scroll to the bottom, but not scroll horizontally, 
+     * then an end mark won't do the job. Just create a mark so we can 
+     * use it with gtk_text_view_scroll_mark_onscreen, we'll position it
+     * explicitely when needed. Use left gravity so the mark stays where 
+     * we put it after inserting new text.
+     */
+    gtk_text_buffer_create_mark (buffer, "scroll", &iter, TRUE);
+    
+    /* Add scrolling timeout. */
+    return g_timeout_add (100, (GSourceFunc) scroll_to_bottom, textview);
+  }
+}
+
+static void
+remove_timeout (GtkWidget *window,
+                gpointer   timeout)
+{
+  g_source_remove (GPOINTER_TO_UINT (timeout));
+}
+
+static void
+create_text_view (GtkWidget *hbox,
+                  gboolean   to_end)
+{
+  GtkWidget *swindow;
+  GtkWidget *textview;
+  guint timeout;
+
+  swindow = gtk_scrolled_window_new (NULL, NULL);
+  gtk_box_pack_start_defaults (GTK_BOX (hbox), swindow);
+  textview = gtk_text_view_new ();
+  gtk_container_add (GTK_CONTAINER (swindow), textview);
+
+  timeout = setup_scroll (GTK_TEXT_VIEW (textview), to_end);
+
+  /* Remove the timeout in destroy handler, so we don't try to
+   * scroll destroyed widget. 
+   */
+  g_signal_connect (textview, "destroy",
+                    G_CALLBACK (remove_timeout),
+                    GUINT_TO_POINTER (timeout));
+}
+
+GtkWidget *
+do_textscroll (GtkWidget *do_widget)
+{
+  static GtkWidget *window = NULL;
+
+  if (!window)
+    {
+      GtkWidget *hbox;
+
+      window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
+      g_signal_connect (window, "destroy",
+			G_CALLBACK (gtk_widget_destroyed), &window);
+      gtk_window_set_default_size (GTK_WINDOW (window), 600, 400);
+      
+      hbox = gtk_hbox_new (TRUE, 6);
+      gtk_container_add (GTK_CONTAINER (window), hbox);
+
+      create_text_view (hbox, TRUE);
+      create_text_view (hbox, FALSE);
+    }
+
+  if (!GTK_WIDGET_VISIBLE (window))
+      gtk_widget_show_all (window);
+  else
+      gtk_widget_destroy (window);
+
+  return window;
+}

demos/gtk-demo/ui_manager.c

@@ -183,10 +183,12 @@ do_ui_manager (GtkWidget *do_widget)
 
       ui = gtk_ui_manager_new ();
       gtk_ui_manager_insert_action_group (ui, actions, 0);
+      g_object_unref (actions);
       gtk_window_add_accel_group (GTK_WINDOW (window), 
 				  gtk_ui_manager_get_accel_group (ui));
       gtk_window_set_title (GTK_WINDOW (window), "UI Manager");
       gtk_container_set_border_width (GTK_CONTAINER (window), 0);
+
       
       if (!gtk_ui_manager_add_ui_from_string (ui, ui_info, -1, &error))
 	{
@@ -223,6 +225,7 @@ do_ui_manager (GtkWidget *do_widget)
       gtk_widget_grab_default (button);
 
       gtk_widget_show_all (window);
+      g_object_unref (ui);
     }
   else
     {

docs/reference/ChangeLog

@@ -1,3 +1,341 @@
+2007-01-05  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.7 ===
+
+2006-10-03  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.6 ===
+
+2006-10-02  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.5 ===
+
+2006-09-22  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.4 ===
+
+2006-09-22  Matthias Clasen  <mclasen@redhat.com>
+	
+	* gtk/tmpl/gtkprintcontext.sgml:
+	* gtk/tmpl/gtkpagesetup.sgml: Apply a patch
+	to fix some typos.  (#355961, Claudio Saavedra)
+
+2006-09-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.3 ===
+
+2006-08-25  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/question_index.sgml: Rewrite the answer for
+	automatic scrolling.
+
+2006-08-17  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.10.2 ===
+
+2006-08-15  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtktable.sgml: Fix docs for gtk_table_set_row/col_spacing.
+	(#348728)
+
+	* gtk/running.sgml: Document new GTK_DEBUG values.  (#350023,
+	Mart Raudsepp)
+
+2006-08-14  Emmanuele Bassi  <ebassi@gnome.org>
+
+	* gtk/tmpl/gtkrecentchoosermenu.sgml: Add a warning about
+	the semantics of gtk_recent_chooser_add_filter() and of
+	gtk_recent_chooser_remove_filter() when applied to a
+	GtkRecentChooserMenu.
+
+2006-08-14  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkruler.sgml: Fix a swapped argument 
+	description.  (#351241, Étienne Bersac)
+
+2006-08-06  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkcelllayout.sgml: Add an explanation
+	of attributes.  (#349367, Don Anderson)
+
+	* gtk/tmpl/gtkrecentmanager.sgml: Fix a typo.  (#349120, Vincent Untz) 
+
+2006-07-23  Matthias Clasen  <mclasen@redhat.com>
+	
+	* === Released 2.10.1 ===
+
+2006-07-16  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk.types: Add  gtk_cell_renderer_spin_get_type  (#347710,
+	Guillaume Cottenceau)
+
+2006-07-10  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk.types: Add missing types  (#347037, Josh Green)
+
+2006-07-06  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtktooltips.sgml: Fix a FIXME (#346092,
+	Claudio Saavedra, Priit Laes)
+
+2006-07-02  Matthias Clasen  <mclasen@redhat.com>
+	
+	* === Released 2.10.0 ===
+
+2006-06-30 Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkprintsettings.sgml: Document print-to-file specific
+	settings.  (#346241, Carolyn MacLeod)
+
+2006-06-28  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkprintjob.sgml: Document GtkPrintJobCompleteFunc
+
+	* gtk/tmpl/gtkrange.sgml: Document GtkSensitivityType
+
+	* gtk/gtk-sections.txt: Remove gtk_print_operation_set_show_dialog
+
+	* gtk/tmpl/gtkcontainer.sgml: Updates.
+
+	* gtk/tmpl/gtkenums.sgml: Document GTK_ARROW_NONE.
+	* gtk/tmpl/gtkarrow.sgml: Cleanups
+	* gtk/gtk-sections.txt: Add some private things
+
+2006-06-21  Matthias Clasen  <mclasen@redhat.com>
+	
+	* === Released 2.9.4 ===
+
+2006-06-21  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Some additions
+
+	* gtk/tmpl/gtkprintunixdialog.sgml: Document some of the
+	print capabilities
+
+	* gtk/question_index.sgml: Add some questions.
+
+2006-06-20  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Remove unused print-to-file setting
+
+2006-06-19  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkprinter.sgml: Document GtkPrinterFunc
+
+	* gtk/gtk-sections.txt: Add gtk_enumerate_printers
+
+2006-06-19  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/gtk-sections.txt:
+	Add gtk_label_set_line_wrap_mode and gtk_label_get_line_wrap_mode
+
+2006-06-12  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.3 ===
+
+2006-06-11  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkprintunixdialog.sgml: Document resonses used
+	by GtkPrintUnixDialog.  (#344558, Christian Persch)
+
+2006-06-08  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkprintoperation.sgml: Updates
+
+	* gtk/gtk-sections.txt: Replace pdf_target by export_filename
+
+	* gtk/tmpl/gtkprintoperation.sgml: Remove GTK_PRINT_OPERATION_RESULT_PREVIEW.
+
+	* gtk/tmpl/gtkstock.sgml: Correct a filename (#344239,
+	John Darrington)
+
+2006-06-07  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkprintoperation.sgml:
+	* gtk/gtk-sections.txt: Additions
+
+2006-06-05  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.2 ===
+
+2006-06-02  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/migrating-checklist.sgml: Fix a small
+	inconsistency.  (#343630, Claudio Saavedra)
+
+2006-05-31  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkstock.sgml: Updates
+
+	* gtk/gtk-sections.txt: Updates
+
+	* gtk/Makefile.am (IGNORE_HFILES): Add some private
+	headers
+
+	* gtk/tmpl/gtkcellrendererspin.sgml: Fix a typo
+
+	* gtk/gtk-sections.txt: Update 
+
+2006-05-30  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Add image-position api
+
+2006-05-25  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Updates
+
+2006-05-23  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Additions
+
+2006-05-19  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Additions
+
+2006-05-18  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkenums.sgml: Updates
+
+2006-05-16  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.1 ====
+
+2006-05-16  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkstock.sgml: 
+	* gtk/Makefile.am: Add fourth stock orientation. 
+
+2006-05-15  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tree_widget.sgml: Fix up example rendering. (#341855, Guillaume
+	Desmottes)
+
+2006-05-11  Emmanuele Bassi  <ebassi@cvs.gnome.org>
+
+	* gtk/tmpl/gtkrecentmanager.sgml: Update the error enum and the
+	gtk_recent_manager_add and gtk_recent_manager_add_full parameters.
+
+	* gtk/migrating-GtkRecentChooser.sgml: Mention
+	gtk_recent_manager_get_default() and update the code examples.
+
+2006-05-09  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Add gtk_message_dialog_set_image.
+
+2006-05-08  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/question_index.sgml (reference): Update the internationalization
+	answer.  (#340951, Kristof Versant)
+
+2006-05-04  Matthias Clasen  <mclasen@redhat.com>
+
+	* === Released 2.9.0 ===
+
+2006-04-29  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Add gtk_status_icon_position_menu
+
+2006-04-25  Matthias Clasen  <mclasen@redhat.com>
+
+	* gdk/gdk-sections.txt: Add gdk_screen_is_composited
+
+2006-04-24  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/Makefile.am: fix a typo.
+
+	* gtk/tmpl/gtkentry.sgml: Remove a duplicate entry.
+
+	* gtk/gtk-sections.txt: Fix a typo.
+
+	* gdk-pixbuf/gdk-pixbuf.sgml: No new symbols in 2.10.
+
+	* gdk/Makefile.am (IGNORE_HFILES): Add  directfb
+
+	* gtk/tmpl/gtkpapersize.sgml: Additions.
+
+	* gtk/gtk-sections.txt: Add new api.
+
+	* gtk/Makefile.am (HTML_IMAGES): Add new stock icons.
+
+	* gtk/tmpl/gtkstock.sgml: Document new stock icons
+
+	* gtk/gtk-docs.sgml: 
+	* gtk/gtk-sections.txt: Add a rich text section
+
+	* gtk/Makefile.am (IGNORE_HFILES): Add some more private headers.
+
+	* gtk/tmpl/gtkpreview.sgml: 
+	* gtk/tmpl/gtkrecentmanager.sgml: 
+	* gtk/tmpl/gtkprintoperation.sgml: 
+	* gtk/tmpl/gtkrecentchooser.sgml: 
+	* gtk/tmpl/gtkicontheme.sgml: Additions
+
+	* gtk/gtk-sections.txt: Remove GtkRecentChooserDefault
+
+2006-04-22  Emmanuele Bassi  <ebassi@cvs.gnome.org>
+
+	* gtk/tmpl/gtkrecentchoosermenu.sgml:
+	* gtk/tmpl/gtkrecentchooserwidget.sgml: Fix unclosed para tags.
+
+2006-04-21  Alexander Larsson  <alexl@redhat.com>
+
+	* gtk/Makefile.am:
+	* gtk/gtk-docs.sgml:
+	* gtk/gtk-sections.txt:
+	* gtk/gtk.types:
+	* gtk/images/pagesetupdialog.png:
+	* gtk/images/printdialog.png:
+	* gtk/tmpl/gtkpagesetup.sgml:
+	* gtk/tmpl/gtkpagesetupunixdialog.sgml:
+	* gtk/tmpl/gtkpapersize.sgml:
+	* gtk/tmpl/gtkprintcontext.sgml:
+	* gtk/tmpl/gtkprinter.sgml:
+	* gtk/tmpl/gtkprintjob.sgml:
+	* gtk/tmpl/gtkprintoperation.sgml:
+	* gtk/tmpl/gtkprintsettings.sgml:
+	* gtk/tmpl/gtkprintunixdialog.sgml:
+	* gtk/visual_index.xml:
+	Add docs for the printing support
+
+2006-04-17  Emmanuele Bassi  <ebassi@cvs.gnome.org>
+
+	* gtk/tmp/gtkicontheme.sgml: Fix the code of the look up example.
+
+2006-04-17  Emmanuele Bassi  <ebassi@cvs.gnome.org>
+
+	* gtk/tmpl/gtkrecent*.sgml: Add long descriptions.
+
+2006-04-16  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/tmpl/gtkrecent*.sgml: Add short descriptions
+
+	* gtk/migrating-GtkRecentChooser.sgml: Cosmetic fixes to 
+	examples.
+
+2006-04-04  Tor Lillqvist  <tml@novell.com>
+
+	* gdk/tmpl/threads.sgml: Mention that the Win32 backend should not
+	be used from multiple threads.
+
+2006-03-31  Matthias Clasen  <mclasen@redhat.com>
+
+	* gtk/gtk-sections.txt: Updates
+
+	* gtk/Makefile.am (IGNORE_HFILES): Updates
+
+	* gtk/images/recentchooserdialog.png: Shrink it.
+
+2006-03-30  Matthias Clasen  <mclasen@redhat.com>
+
+	* gdk/gdk-sections.txt: Additions
+
+	* gtk/Makefile.am (HTML_IMAGES): add
+	recentchooserdialog.png
+	
+	* gtk/visual_index.xml: add GtkRecentChooserDialog
+	* gtk/images/recentchooserdialog.png: New image
+	* gtk/images/filechooser.png: Updated
+	
 2006-03-23  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/tmpl/gtkrc.sgml: Document <classname> in paths.

docs/reference/gdk-pixbuf/gdk-pixbuf.sgml

@@ -148,9 +148,6 @@
   <index role="2.8">
     <title>Index of new symbols in 2.8</title>
   </index>  
-  <index role="2.10">
-    <title>Index of new symbols in 2.10</title>
-  </index>  
 
   &Porting-From-Imlib;
 

docs/reference/gdk-pixbuf/tmpl/creating.sgml

@@ -95,9 +95,6 @@ Creating a pixbuf from image data that is already in memory.
 @copy_pixels: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@inline_pixbuf: 
-@length: 
 
 
 <!-- ##### FUNCTION gdk_pixbuf_new_subpixbuf ##### -->

docs/reference/gdk-pixbuf/tmpl/file-loading.sgml

@@ -66,8 +66,6 @@ End:
 @preserve_aspect_ratio: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@keep_aspect_ratio: 
 
 
 <!-- ##### FUNCTION gdk_pixbuf_get_file_info ##### -->

docs/reference/gdk/Makefile.am

@@ -32,6 +32,7 @@ IGNORE_HFILES=			\
 	linux-fb 		\
 	nanox 			\
 	win32 			\
+	directfb		\
 	x11			\
 	quartz
 

docs/reference/gdk/gdk-sections.txt

@@ -201,6 +201,7 @@ gdk_screen_get_rgb_colormap
 gdk_screen_get_rgb_visual
 gdk_screen_get_rgba_colormap
 gdk_screen_get_rgba_visual
+gdk_screen_is_composited
 gdk_screen_get_root_window
 gdk_screen_get_display
 gdk_screen_get_number
@@ -882,10 +883,10 @@ GdkPangoRendererPrivate
 <TITLE>Cairo Interaction</TITLE>
 <FILE>cairo_interaction</FILE>
 gdk_cairo_create
-gdk_cairo_set_source_colorg
+gdk_cairo_set_source_color
 gdk_cairo_set_source_pixbuf
 gdk_cairo_set_source_pixmap
-dk_cairo_rectangle
+gdk_cairo_rectangle
 gdk_cairo_region
 </SECTION>
 
@@ -1254,6 +1255,7 @@ gdkx_visual_get
 gdkx_colormap_get
 gdk_pixmap_foreign_new
 gdk_pixmap_foreign_new_for_display
+gdk_pixmap_foreign_new_for_screen
 gdk_window_foreign_new
 gdk_window_foreign_new_for_display
 gdk_xid_table_lookup

docs/reference/gdk/tmpl/cairo_interaction.sgml

@@ -56,6 +56,17 @@ Cairo paths and to use pixbufs as sources for drawing operations.
 @pixbuf_y: 
 
 
+<!-- ##### FUNCTION gdk_cairo_set_source_pixmap ##### -->
+<para>
+
+</para>
+
+@cr: 
+@pixmap: 
+@pixmap_x: 
+@pixmap_y: 
+
+
 <!-- ##### FUNCTION gdk_cairo_rectangle ##### -->
 <para>
 

docs/reference/gdk/tmpl/events.sgml

@@ -295,8 +295,6 @@ gdk_event_handler_set().
 @event: 
 @winid: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@xid: 
 
 
 <!-- ##### FUNCTION gdk_event_send_client_message_for_display ##### -->
@@ -308,8 +306,6 @@ gdk_event_handler_set().
 @event: 
 @winid: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@xid: 
 
 
 <!-- ##### FUNCTION gdk_event_send_clientmessage_toall ##### -->

docs/reference/gdk/tmpl/gdkdisplay.sgml

@@ -378,3 +378,21 @@ Applications should never have any reason to use this facility
 @n_targets: 
 
 
+<!-- ##### FUNCTION gdk_display_supports_shapes ##### -->
+<para>
+
+</para>
+
+@display: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_display_supports_input_shapes ##### -->
+<para>
+
+</para>
+
+@display: 
+@Returns: 
+
+

docs/reference/gdk/tmpl/gdkscreen.sgml

@@ -34,6 +34,13 @@ when GDK gets multihead support.
 
 @Since: 2.2
 
+<!-- ##### SIGNAL GdkScreen::composited-changed ##### -->
+<para>
+
+</para>
+
+@gdkscreen: the object which received the signal.
+
 <!-- ##### SIGNAL GdkScreen::size-changed ##### -->
 <para>
 
@@ -131,6 +138,15 @@ when GDK gets multihead support.
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_screen_is_composited ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_screen_get_root_window ##### -->
 <para>
 
@@ -238,8 +254,6 @@ when GDK gets multihead support.
 @screen: 
 @monitor_num: 
 @dest: 
-<!-- # Unused Parameters # -->
-@Returns: 
 
 
 <!-- ##### FUNCTION gdk_screen_get_monitor_at_point ##### -->
@@ -261,8 +275,6 @@ when GDK gets multihead support.
 @screen: 
 @window: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@anid: 
 
 
 <!-- ##### FUNCTION gdk_screen_broadcast_client_message ##### -->
@@ -321,6 +333,24 @@ when GDK gets multihead support.
 @dpi: 
 
 
+<!-- ##### FUNCTION gdk_screen_get_active_window ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gdk_screen_get_window_stack ##### -->
+<para>
+
+</para>
+
+@screen: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_spawn_on_screen ##### -->
 <para>
 

docs/reference/gdk/tmpl/keys.sgml

@@ -167,8 +167,6 @@ be mapped to a keyval.
 @level: 
 @consumed_modifiers: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@unused_modifiers: 
 
 
 <!-- ##### FUNCTION gdk_keymap_get_entries_for_keyval ##### -->

docs/reference/gdk/tmpl/regions.sgml

@@ -70,9 +70,9 @@ Defines the position and size of a rectangle.
 
 </para>
 
-@src1:
-@src2:
-@dest:
+@src1: 
+@src2: 
+@dest: 
 
 
 <!-- ##### STRUCT GdkRegion ##### -->
@@ -97,6 +97,7 @@ A GdkRegion represents a set of pixels on the screen.
 @points: 
 @npoints: 
 @fill_rule: 
+@Returns: 
 
 
 <!-- ##### ENUM GdkFillRule ##### -->
@@ -141,8 +142,8 @@ included in the region, while areas overlapped an even number of times are not.
 
 </para>
 
-@region:
-@rectangle:
+@region: 
+@rectangle: 
 
 
 <!-- ##### FUNCTION gdk_region_get_rectangles ##### -->
@@ -161,6 +162,7 @@ included in the region, while areas overlapped an even number of times are not.
 </para>
 
 @region: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gdk_region_equal ##### -->
@@ -170,6 +172,7 @@ included in the region, while areas overlapped an even number of times are not.
 
 @region1: 
 @region2: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gdk_region_point_in ##### -->
@@ -177,9 +180,10 @@ included in the region, while areas overlapped an even number of times are not.
 
 </para>
 
-@region:
+@region: 
 @x: 
 @y: 
+@Returns: 
 
 
 <!-- ##### FUNCTION gdk_region_rect_in ##### -->
@@ -189,6 +193,7 @@ included in the region, while areas overlapped an even number of times are not.
 
 @region: 
 @rectangle: 
+@Returns: 
 
 
 <!-- ##### ENUM GdkOverlapType ##### -->
@@ -288,10 +293,10 @@ gdk_region_spans_intersect_foreach().
 </para>
 
 @region: 
-@spans:
-@n_spans:
+@spans: 
+@n_spans: 
 @sorted: 
-@function:
+@function: 
 @data: 
 
 

docs/reference/gdk/tmpl/threads.sgml

@@ -22,6 +22,11 @@ which protects all use of GTK+. That is, only one thread can use GTK+
 at any given time.
 </para>
 <para>
+Unfortunately the above holds with the X11 backend only. With the
+Win32 backend, GDK calls should not be attempted from multiple threads
+at all.
+</para>
+<para>
 You must call g_thread_init() and gdk_threads_init() before executing
 any other GTK+ or GDK functions in a threaded GTK+ program.
 </para>
@@ -293,9 +298,6 @@ The #GMutex used to implement the critical region for
 gdk_threads_enter()/gdk_threads_leave(). 
 </para>
 
-@Deprecated: 2.4: This variable should not be used directly 
-  &mdash; consider it private.
-
 
 <!-- ##### FUNCTION gdk_threads_set_lock_functions ##### -->
 <para>

docs/reference/gdk/tmpl/windows.sgml

@@ -211,6 +211,12 @@ window types.
 @GDK_WINDOW_TYPE_HINT_DOCK: Used for creating dock or panel windows.
 @GDK_WINDOW_TYPE_HINT_DESKTOP: Used for creating the desktop background 
 window.
+@GDK_WINDOW_TYPE_HINT_DROPDOWN_MENU: 
+@GDK_WINDOW_TYPE_HINT_POPUP_MENU: 
+@GDK_WINDOW_TYPE_HINT_TOOLTIP: 
+@GDK_WINDOW_TYPE_HINT_NOTIFICATION: 
+@GDK_WINDOW_TYPE_HINT_COMBO: 
+@GDK_WINDOW_TYPE_HINT_DND: 
 
 <!-- ##### STRUCT GdkWindowAttr ##### -->
 <para>
@@ -896,6 +902,44 @@ backend, <type>MSG</type>s for Win32).
 @window: 
 
 
+<!-- ##### FUNCTION gdk_window_input_shape_combine_mask ##### -->
+<para>
+
+</para>
+
+@window: 
+@mask: 
+@x: 
+@y: 
+
+
+<!-- ##### FUNCTION gdk_window_input_shape_combine_region ##### -->
+<para>
+
+</para>
+
+@window: 
+@shape_region: 
+@offset_x: 
+@offset_y: 
+
+
+<!-- ##### FUNCTION gdk_window_set_child_input_shapes ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
+<!-- ##### FUNCTION gdk_window_merge_child_input_shapes ##### -->
+<para>
+
+</para>
+
+@window: 
+
+
 <!-- ##### FUNCTION gdk_window_set_static_gravities ##### -->
 <para>
 

docs/reference/gdk/tmpl/x_interaction.sgml

@@ -280,6 +280,19 @@ Another name for GDK_DRAWABLE_XID().
 @Returns: 
 
 
+<!-- ##### FUNCTION gdk_pixmap_foreign_new_for_screen ##### -->
+<para>
+
+</para>
+
+@screen: 
+@anid: 
+@width: 
+@height: 
+@depth: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gdk_window_foreign_new ##### -->
 <para>
 

docs/reference/gtk/Makefile.am

@@ -33,6 +33,7 @@ IGNORE_HFILES=				\
 	gtkfilechooserembed.h		\
 	gtkfilechooserentry.h		\
 	gtkfilechooserprivate.h		\
+	gtkfilechoosersettings.h	\
 	gtkfilechooserutils.h		\
 	gtkfilesystem.h			\
 	gtkfilesystemmodel.h		\
@@ -48,8 +49,19 @@ IGNORE_HFILES=				\
 	gtkmnemonichash.h		\
 	gtkpathbar.h			\
 	gtkplugprivate.h		\
+	gtkprintbackend.h		\
+	gtkprinteroption.h		\
+	gtkprinteroptionset.h		\
+	gtkprinteroptionwidget.h	\
+	gtkprinter-private.h		\
+	gtkprint-win32.h		\
+	gtkprintutils.h			\
+	gtkprintoperation-private.h	\
 	gtkprivate.h			\
 	gtkrbtree.h			\
+	gtkrecentchooserdefault.h	\
+	gtkrecentchooserutils.h		\
+	gtkrecentchooserprivate.h	\
 	gtksequence.h			\
 	gtksocketprivate.h		\
 	gtktreedatalist.h		\
@@ -64,9 +76,11 @@ IGNORE_HFILES=				\
 	gtktexttypes.h			\
 	gtktextutil.h			\
 	gtktoggleactionprivate.h	\
+	gtktrayicon.h			\
 	gtktypebuiltins.h		\
 	gtkxembed.h			\
 	gtkwin32embed.h			\
+	gtkwin32embedwidget.h		\
 	xdgmime				\
 	xembed.h
 
@@ -108,6 +122,8 @@ content_files =					\
 	migrating-GtkAboutDialog.sgml		\
 	migrating-GtkColorButton.sgml		\
 	migrating-GtkAssistant.sgml		\
+	migrating-GtkRecentChooser.sgml 	\
+	migrating-GtkLinkButton.sgml		\
 	objects_grouped.sgml			\
 	osx.sgml				\
 	question_index.sgml			\
@@ -130,6 +146,8 @@ expand_content_files = 				\
 	migrating-GtkAboutDialog.sgml		\
 	migrating-GtkColorButton.sgml		\
 	migrating-GtkAssistant.sgml		\
+	migrating-GtkRecentChooser.sgml 	\
+	migrating-GtkLinkButton.sgml		\
 	tree_widget.sgml			\
 	text_widget.sgml			\
 	question_index.sgml
@@ -196,6 +214,10 @@ HTML_IMAGES = \
 	$(top_srcdir)/gtk/stock-icons/20/gtk-no.png			\
 	$(top_srcdir)/gtk/stock-icons/20/gtk-ok.png			\
 	$(top_srcdir)/gtk/stock-icons/24/gtk-open.png			\
+	$(top_srcdir)/gtk/stock-icons/24/gtk-orientation-landscape.png	\
+	$(top_srcdir)/gtk/stock-icons/24/gtk-orientation-portrait.png	\
+	$(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-landscape.png \
+	$(top_srcdir)/gtk/stock-icons/24/gtk-orientation-reverse-portrait.png \
 	$(top_srcdir)/gtk/stock-icons/24/gtk-paste.png			\
 	$(top_srcdir)/gtk/stock-icons/24/gtk-preferences.png		\
 	$(top_srcdir)/gtk/stock-icons/24/gtk-print.png			\
@@ -270,8 +292,11 @@ HTML_IMAGES = \
 	$(srcdir)/images/multiline-text.png				\
 	$(srcdir)/images/notebook.png					\
 	$(srcdir)/images/panes.png					\
+	$(srcdir)/images/pagesetupdialog.png				\
+	$(srcdir)/images/printdialog.png				\
 	$(srcdir)/images/progressbar.png				\
 	$(srcdir)/images/radio-group.png				\
+	$(srcdir)/images/recentchooserdialog.png			\
 	$(srcdir)/images/scales.png					\
 	$(srcdir)/images/scrolledwindow.png				\
 	$(srcdir)/images/separator.png					\

docs/reference/gtk/directfb.sgml

@@ -35,6 +35,8 @@ Beyond the usual GTK+ build requirements, the DirectFB backend (obviously) needs
 the DirectFB libraries (at least 0.9.21) and Cairo compiled with DirectFB support.
 </para>
 
+</refsect2>
+
 <!--
   FIXME: it seems most of the options listed in _gdk_windowing_args
   are ignored, and they need to be described by somebody who knows 
@@ -48,49 +50,49 @@ command line arguments.
 </para>
 
 <formalpara>
-  <title><systemitem>--dfb-help</systemitem></title>
+  <title><systemitem>dfb-help</systemitem></title>
   <para>
     Display help for DirectFB-specific commandline options.
   </para>
 </formalpara>
 
 <formalpara>
-  <title><systemitem>--dfb=<replaceable>value</replaceable></systemitem></title>
+  <title><systemitem>dfb=<replaceable>value</replaceable></systemitem></title>
   <para>
     Possible values: sdl, system. 
   </para>
 </formalpara>
 
 <formalpara>
-  <title><systemitem>--disable-aa-fonts=<replaceable>number</replaceable></systemitem></title>
+  <title><systemitem>disable-aa-fonts=<replaceable>number</replaceable></systemitem></title>
   <para>
     If <replaceable>number</replaceable> is 1, disable antialising for fonts.
   </para>
 </formalpara>
 
 <formalpara>
-  <title><systemitem>--argb-font=<replaceable>number</replaceable></systemitem></title>
+  <title><systemitem>argb-font=<replaceable>number</replaceable></systemitem></title>
   <para>
     If <replaceable>number</replaceable> is 1, enable ARGB fonts.
   </para>
 </formalpara>
 
 <formalpara>
-  <title><systemitem>--transparent-unfocused=<replaceable>number</replaceable></systemitem></title>
+  <title><systemitem>transparent-unfocused=<replaceable>number</replaceable></systemitem></title>
   <para>
     If <replaceable>number</replaceable> is 1, make unfocused windows transparent.
   </para>
 </formalpara>
 
 <formalpara>
-  <title><systemitem>--glyph-surface-cache=<replaceable>number</replaceable></systemitem></title>
+  <title><systemitem>glyph-surface-cache=<replaceable>number</replaceable></systemitem></title>
   <para>
     Set the size of the glyph surface cache. The default value is 8.
   </para>
 </formalpara>
 
 <formalpara>
-  <title><systemitem>--enable-color-keyring=<replaceable>number</replaceable></systemitem></title>
+  <title><systemitem>enable-color-keyring=<replaceable>number</replaceable></systemitem></title>
   <para>
     If <replaceable>number</replaceable> is 1, turn on the color keyring.
   </para>

docs/reference/gtk/gtk-docs.sgml

@@ -84,6 +84,15 @@
 <!ENTITY GtkPixmap SYSTEM "xml/gtkpixmap.xml">
 <!ENTITY GtkPlug SYSTEM "xml/gtkplug.xml">
 <!ENTITY GtkPreview SYSTEM "xml/gtkpreview.xml">
+<!ENTITY GtkPrintOperation SYSTEM "xml/gtkprintoperation.xml">
+<!ENTITY GtkPrintContext SYSTEM "xml/gtkprintcontext.xml">
+<!ENTITY GtkPrintSettings SYSTEM "xml/gtkprintsettings.xml">
+<!ENTITY GtkPageSetup SYSTEM "xml/gtkpagesetup.xml">
+<!ENTITY GtkPaperSize SYSTEM "xml/gtkpapersize.xml">
+<!ENTITY GtkPrinter SYSTEM "xml/gtkprinter.xml">
+<!ENTITY GtkPrintJob SYSTEM "xml/gtkprintjob.xml">
+<!ENTITY GtkPrintUnixDialog SYSTEM "xml/gtkprintunixdialog.xml">
+<!ENTITY GtkPageSetupUnixDialog SYSTEM "xml/gtkpagesetupunixdialog.xml">
 <!ENTITY GtkProgress SYSTEM "xml/gtkprogress.xml">
 <!ENTITY GtkProgressBar SYSTEM "xml/gtkprogressbar.xml">
 <!ENTITY GtkRadioAction SYSTEM "xml/gtkradioaction.xml">
@@ -91,6 +100,12 @@
 <!ENTITY GtkRadioMenuItem SYSTEM "xml/gtkradiomenuitem.xml">
 <!ENTITY GtkRadioToolButton SYSTEM "xml/gtkradiotoolbutton.xml">
 <!ENTITY GtkRange SYSTEM "xml/gtkrange.xml">
+<!ENTITY GtkRecentChooser SYSTEM "xml/gtkrecentchooser.xml">
+<!ENTITY GtkRecentChooserDialog SYSTEM "xml/gtkrecentchooserdialog.xml">
+<!ENTITY GtkRecentChooserMenu SYSTEM "xml/gtkrecentchoosermenu.xml">
+<!ENTITY GtkRecentChooserWidget SYSTEM "xml/gtkrecentchooserwidget.xml">
+<!ENTITY GtkRecentFilter SYSTEM "xml/gtkrecentfilter.xml">
+<!ENTITY GtkRecentManager SYSTEM "xml/gtkrecentmanager.xml">
 <!ENTITY GtkRuler SYSTEM "xml/gtkruler.xml">
 <!ENTITY GtkScale SYSTEM "xml/gtkscale.xml">
 <!ENTITY GtkScrollbar SYSTEM "xml/gtkscrollbar.xml">
@@ -203,6 +218,8 @@
 <!ENTITY gtk-migrating-GtkAboutDialog SYSTEM "xml/migrating-GtkAboutDialog.sgml">
 <!ENTITY gtk-migrating-GtkColorButton SYSTEM "xml/migrating-GtkColorButton.sgml">
 <!ENTITY gtk-migrating-GtkAssistant SYSTEM "xml/migrating-GtkAssistant.sgml">
+<!ENTITY gtk-migrating-GtkRecentChooser SYSTEM "xml/migrating-GtkRecentChooser.sgml">
+<!ENTITY gtk-migrating-GtkLinkButton SYSTEM "xml/migrating-GtkLinkButton.sgml">
 <!ENTITY version SYSTEM "version.xml">
 <!ENTITY gtk-query-immodules SYSTEM "gtk-query-immodules-2.0.xml">
 <!ENTITY gtk-update-icon-cache SYSTEM "gtk-update-icon-cache.xml">
@@ -505,6 +522,19 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
         &GtkScrolledWindow;
     </chapter>
 
+    <chapter id="Printing">
+      <title>Printing</title>
+      &GtkPrintOperation;
+      &GtkPrintContext;
+      &GtkPrintSettings;
+      &GtkPageSetup;
+      &GtkPaperSize;
+      &GtkPrinter;
+      &GtkPrintJob; 
+      &GtkPrintUnixDialog;
+      &GtkPageSetupUnixDialog;
+    </chapter>
+
     <chapter id="MiscObjects">
       <title>Miscellaneous</title>
         &GtkAdjustment;
@@ -554,6 +584,16 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
         &GtkVRuler;
     </chapter>
 
+    <chapter id="RecentDocuments">
+      <title>Recently Used Documents</title>
+      &GtkRecentManager;
+      &GtkRecentChooser;
+      &GtkRecentChooserDialog;
+      &GtkRecentChooserMenu;
+      &GtkRecentChooserWidget;
+      &GtkRecentFilter;
+    </chapter>
+
     <chapter id="DeprecatedObjects">
       <title>Deprecated</title>
         &GtkCList;      
@@ -597,6 +637,8 @@ that is, GUI components such as <link linkend="GtkButton">GtkButton</link> or
     &gtk-migrating-GtkAboutDialog;
     &gtk-migrating-GtkColorButton;
     &gtk-migrating-GtkAssistant;
+    &gtk-migrating-GtkRecentChooser;
+    &gtk-migrating-GtkLinkButton;
   </part>
 
   <part>

docs/reference/gtk/gtk-sections.txt

@@ -321,6 +321,7 @@ GTK_IS_ASSISTANT
 GTK_IS_ASSISTANT_CLASS
 GTK_ASSISTANT_GET_CLASS
 <SUBSECTION Private>
+GtkAssistantPrivate
 gtk_assistant_get_type
 </SECTION>
 
@@ -454,6 +455,8 @@ gtk_button_set_alignment
 gtk_button_get_alignment
 gtk_button_set_image
 gtk_button_get_image
+gtk_button_set_image_position
+gtk_button_get_image_position
 
 <SUBSECTION Standard>
 GTK_BUTTON
@@ -1243,7 +1246,6 @@ GtkFileChooserAction
 GtkFileChooserConfirmation
 GTK_FILE_CHOOSER_ERROR
 GtkFileChooserError
-gtk_file_chooser_error_quark
 gtk_file_chooser_set_action
 gtk_file_chooser_get_action
 gtk_file_chooser_set_local_only
@@ -1297,6 +1299,7 @@ GTK_FILE_CHOOSER
 GTK_IS_FILE_CHOOSER
 GTK_TYPE_FILE_CHOOSER
 <SUBSECTION Private>
+gtk_file_chooser_error_quark
 gtk_file_chooser_get_type
 </SECTION>
 
@@ -2005,6 +2008,7 @@ gtk_label_set_max_width_chars
 gtk_label_get
 gtk_label_parse_uline
 gtk_label_set_line_wrap
+gtk_label_set_line_wrap_mode
 gtk_label_set
 gtk_label_get_layout_offsets
 gtk_label_get_mnemonic_keyval
@@ -2023,6 +2027,7 @@ gtk_label_get_max_width_chars
 gtk_label_get_label
 gtk_label_get_layout
 gtk_label_get_line_wrap
+gtk_label_get_line_wrap_mode
 gtk_label_get_mnemonic_widget
 gtk_label_get_selection_bounds
 gtk_label_get_use_markup
@@ -2080,6 +2085,7 @@ gtk_link_button_new
 gtk_link_button_new_with_label
 gtk_link_button_get_uri
 gtk_link_button_set_uri
+GtkLinkButtonUriFunc
 gtk_link_button_set_uri_hook
 
 <SUBSECTION Standard>
@@ -2091,6 +2097,7 @@ GTK_IS_LINK_BUTTON_CLASS
 GTK_LINK_BUTTON_GET_CLASS
 GtkLinkButtonClass
 <SUBSECTION Private>
+GtkLinkButtonPrivate
 gtk_link_button_get_type
 </SECTION>
 
@@ -2320,6 +2327,7 @@ GtkButtonsType
 gtk_message_dialog_new
 gtk_message_dialog_new_with_markup
 gtk_message_dialog_set_markup
+gtk_message_dialog_set_image
 gtk_message_dialog_format_secondary_text
 gtk_message_dialog_format_secondary_markup
 <SUBSECTION Standard>
@@ -2733,6 +2741,11 @@ gtk_range_get_value
 gtk_range_set_increments
 gtk_range_set_range
 gtk_range_set_value
+GtkSensitivityType
+gtk_range_set_lower_stepper_sensitivity
+gtk_range_get_lower_stepper_sensitivity
+gtk_range_set_upper_stepper_sensitivity
+gtk_range_get_upper_stepper_sensitivity
 <SUBSECTION Standard>
 GTK_RANGE
 GTK_IS_RANGE
@@ -2746,6 +2759,207 @@ GtkRangeLayout
 GtkRangeStepTimer
 </SECTION>
 
+<SECTION>
+<FILE>gtkrecentchooser</FILE>
+<TITLE>GtkRecentChooser</TITLE>
+GtkRecentChooser
+GtkRecentChooserIface
+GTK_RECENT_CHOOSER_ERROR
+GtkRecentChooserError
+gtk_recent_chooser_set_show_private
+gtk_recent_chooser_get_show_private
+gtk_recent_chooser_set_show_not_found
+gtk_recent_chooser_get_show_not_found
+gtk_recent_chooser_set_show_icons
+gtk_recent_chooser_get_show_icons
+gtk_recent_chooser_set_select_multiple
+gtk_recent_chooser_get_select_multiple
+gtk_recent_chooser_set_local_only
+gtk_recent_chooser_get_local_only
+gtk_recent_chooser_set_limit
+gtk_recent_chooser_get_limit
+gtk_recent_chooser_set_show_tips
+gtk_recent_chooser_get_show_tips
+gtk_recent_chooser_set_show_numbers
+gtk_recent_chooser_get_show_numbers
+GtkRecentSortType
+gtk_recent_chooser_set_sort_type
+gtk_recent_chooser_get_sort_type
+GtkRecentSortFunc
+gtk_recent_chooser_set_sort_func
+gtk_recent_chooser_set_current_uri
+gtk_recent_chooser_get_current_uri
+gtk_recent_chooser_get_current_item
+gtk_recent_chooser_select_uri
+gtk_recent_chooser_unselect_uri
+gtk_recent_chooser_select_all
+gtk_recent_chooser_unselect_all
+gtk_recent_chooser_get_items
+gtk_recent_chooser_get_uris
+gtk_recent_chooser_add_filter
+gtk_recent_chooser_remove_filter
+gtk_recent_chooser_list_filters
+gtk_recent_chooser_set_filter
+gtk_recent_chooser_get_filter
+<SUBSECTION Standard>
+GTK_RECENT_CHOOSER
+GTK_IS_RECENT_CHOOSER
+GTK_TYPE_RECENT_CHOOSER
+GTK_RECENT_CHOOSER_GET_IFACE
+<SUBSECTION Private>
+gtk_recent_chooser_get_type
+gtk_recent_chooser_error_quark
+</SECTION>
+
+<SECTION>
+<FILE>gtkrecentchooserdialog</FILE>
+<TITLE>GtkRecentChooserDialog</TITLE>
+GtkRecentChooserDialog
+gtk_recent_chooser_dialog_new
+gtk_recent_chooser_dialog_new_for_manager
+<SUBSECTION Standard>
+GTK_RECENT_CHOOSER_DIALOG
+GTK_IS_RECENT_CHOOSER_DIALOG
+GTK_TYPE_RECENT_CHOOSER_DIALOG
+GTK_RECENT_CHOOSER_DIALOG_CLASS
+GTK_IS_RECENT_CHOOSER_DIALOG_CLASS
+GTK_RECENT_CHOOSER_DIALOG_GET_CLASS
+
+<SUBSECTION Private>
+gtk_recent_chooser_dialog_get_type
+GtkRecentChooserDialogPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gtkrecentchoosermenu</FILE>
+<TITLE>GtkRecentChooserMenu</TITLE>
+GtkRecentChooserMenu
+gtk_recent_chooser_menu_new
+gtk_recent_chooser_menu_new_for_manager
+gtk_recent_chooser_menu_get_show_numbers
+gtk_recent_chooser_menu_set_show_numbers
+<SUBSECTION Standard>
+GTK_RECENT_CHOOSER_MENU
+GTK_IS_RECENT_CHOOSER_MENU
+GTK_TYPE_RECENT_CHOOSER_MENU
+GTK_RECENT_CHOOSER_MENU_CLASS
+GTK_IS_RECENT_CHOOSER_MENU_CLASS
+GTK_RECENT_CHOOSER_MENU_GET_CLASS
+
+<SUBSECTION Private>
+gtk_recent_chooser_menu_get_type
+GtkRecentChooserMenuPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gtkrecentchooserwidget</FILE>
+<TITLE>GtkRecentChooserWidget</TITLE>
+GtkRecentChooserWidget
+gtk_recent_chooser_widget_new
+gtk_recent_chooser_widget_new_for_manager
+<SUBSECTION Standard>
+GTK_RECENT_CHOOSER_WIDGET
+GTK_IS_RECENT_CHOOSER_WIDGET
+GTK_TYPE_RECENT_CHOOSER_WIDGET
+GTK_RECENT_CHOOSER_WIDGET_CLASS
+GTK_IS_RECENT_CHOOSER_WIDGET_CLASS
+GTK_RECENT_CHOOSER_WIDGET_GET_CLASS
+
+<SUBSECTION Private>
+gtk_recent_chooser_widget_get_type
+GtkRecentChooserWidgetPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gtkrecentfilter</FILE>
+<TITLE>GtkRecentFilter</TITLE>
+GtkRecentFilter
+GtkRecentFilterInfo
+GtkRecentFilterFlags
+GtkRecentFilterFunc
+gtk_recent_filter_new
+gtk_recent_filter_get_name
+gtk_recent_filter_set_name
+gtk_recent_filter_add_mime_type
+gtk_recent_filter_add_pattern
+gtk_recent_filter_add_pixbuf_formats
+gtk_recent_filter_add_application
+gtk_recent_filter_add_group
+gtk_recent_filter_add_age
+gtk_recent_filter_add_custom
+gtk_recent_filter_get_needed
+gtk_recent_filter_filter
+<SUBSECTION Standard>
+GTK_RECENT_FILTER
+GTK_IS_RECENT_FILTER
+GTK_TYPE_RECENT_FILTER
+
+<SUBSECTION Private>
+gtk_recent_filter_get_type
+</SECTION>
+
+<SECTION>
+<FILE>gtkrecentmanager</FILE>
+<TITLE>GtkRecentManager</TITLE>
+GtkRecentManager
+GtkRecentInfo
+GtkRecentData
+GTK_RECENT_MANAGER_ERROR
+GtkRecentManagerError
+gtk_recent_manager_new
+gtk_recent_manager_get_default
+gtk_recent_manager_get_for_screen
+gtk_recent_manager_set_screen
+gtk_recent_manager_add_item
+gtk_recent_manager_add_full
+gtk_recent_manager_remove_item
+gtk_recent_manager_lookup_item
+gtk_recent_manager_has_item
+gtk_recent_manager_move_item
+gtk_recent_manager_get_limit
+gtk_recent_manager_set_limit
+gtk_recent_manager_get_items
+gtk_recent_manager_purge_items
+<SUBSECTION>
+gtk_recent_info_ref
+gtk_recent_info_unref
+gtk_recent_info_get_uri
+gtk_recent_info_get_display_name
+gtk_recent_info_get_description
+gtk_recent_info_get_mime_type
+gtk_recent_info_get_added
+gtk_recent_info_get_modified
+gtk_recent_info_get_visited
+gtk_recent_info_get_private_hint
+gtk_recent_info_get_application_info
+gtk_recent_info_get_applications
+gtk_recent_info_last_application
+gtk_recent_info_get_groups
+gtk_recent_info_has_group
+gtk_recent_info_has_application
+gtk_recent_info_get_icon
+gtk_recent_info_get_short_name
+gtk_recent_info_get_uri_display
+gtk_recent_info_get_age
+gtk_recent_info_is_local
+gtk_recent_info_exists
+gtk_recent_info_match
+<SUBSECTION Standard>
+GTK_RECENT_MANAGER
+GTK_IS_RECENT_MANAGER
+GTK_TYPE_RECENT_MANAGER
+GTK_RECENT_MANAGER_CLASS
+GTK_IS_RECENT_MANAGER_CLASS
+GTK_RECENT_MANAGER_GET_CLASS
+GTK_TYPE_RECENT_INFO
+
+<SUBSECTION Private>
+gtk_recent_manager_get_type
+gtk_recent_info_get_type
+GtkRecentManagerPrivate
+gtk_recent_manager_error_quark
+</SECTION>
+
 <SECTION>
 <FILE>gtkruler</FILE>
 <TITLE>GtkRuler</TITLE>
@@ -2912,6 +3126,7 @@ gtk_size_group_set_ignore_hidden
 gtk_size_group_get_ignore_hidden
 gtk_size_group_add_widget
 gtk_size_group_remove_widget
+gtk_size_group_get_widgets
 <SUBSECTION Standard>
 GTK_SIZE_GROUP
 GTK_IS_SIZE_GROUP
@@ -3031,6 +3246,9 @@ gtk_status_icon_get_visible
 gtk_status_icon_set_blinking
 gtk_status_icon_get_blinking
 gtk_status_icon_is_embedded
+gtk_status_icon_position_menu
+gtk_status_icon_get_geometry
+
 <SUBSECTION Standard>
 GTK_TYPE_STATUS_ICON
 GTK_STATUS_ICON
@@ -3039,6 +3257,7 @@ GTK_IS_STATUS_ICON
 GTK_IS_STATUS_ICON_CLASS
 GTK_STATUS_ICON_GET_CLASS
 <SUBSECTION Private>
+GtkStatusIconPrivate
 gtk_status_icon_get_type
 </SECTION>
 
@@ -3189,7 +3408,41 @@ gtk_text_buffer_begin_user_action
 gtk_text_buffer_end_user_action
 gtk_text_buffer_add_selection_clipboard
 gtk_text_buffer_remove_selection_clipboard
+
+<SUBSECTION Serialization>
+GtkTextBufferTargetInfo
+GtkTextBufferDeserializeFunc
+gtk_text_buffer_deserialize
+gtk_text_buffer_deserialize_get_can_create_tags
+gtk_text_buffer_deserialize_set_can_create_tags
+gtk_text_buffer_get_copy_target_list
+gtk_text_buffer_get_deserialize_formats
+gtk_text_buffer_get_paste_target_list
+gtk_text_buffer_get_serialize_formats
+gtk_text_buffer_register_deserialize_format
+gtk_text_buffer_register_deserialize_tagset
+gtk_text_buffer_register_serialize_format
+gtk_text_buffer_register_serialize_tagset
+GtkTextBufferSerializeFunc
+gtk_text_buffer_serialize
+gtk_text_buffer_unregister_deserialize_format
+gtk_text_buffer_unregister_serialize_format
+
 <SUBSECTION Standard>
+gtk_text_buffer_deserialize
+gtk_text_buffer_deserialize_get_can_create_tags
+gtk_text_buffer_deserialize_set_can_create_tags
+gtk_text_buffer_get_copy_target_list
+gtk_text_buffer_get_deserialize_formats
+gtk_text_buffer_get_paste_target_list
+gtk_text_buffer_get_serialize_formats
+gtk_text_buffer_register_deserialize_format
+gtk_text_buffer_register_deserialize_tagset
+gtk_text_buffer_register_serialize_format
+gtk_text_buffer_register_serialize_tagset
+gtk_text_buffer_serialize
+gtk_text_buffer_unregister_deserialize_format
+gtk_text_buffer_unregister_serialize_format
 GTK_TEXT_BUFFER
 GTK_IS_TEXT_BUFFER
 GTK_TYPE_TEXT_BUFFER
@@ -4073,6 +4326,8 @@ gtk_tree_store_remove
 gtk_tree_store_insert
 gtk_tree_store_insert_before
 gtk_tree_store_insert_after
+gtk_tree_store_insert_with_values
+gtk_tree_store_insert_with_valuesv
 gtk_tree_store_prepend
 gtk_tree_store_append
 gtk_tree_store_is_ancestor
@@ -4234,6 +4489,11 @@ gtk_tree_view_get_search_column
 gtk_tree_view_set_search_column
 gtk_tree_view_get_search_equal_func
 gtk_tree_view_set_search_equal_func
+gtk_tree_view_get_search_entry
+gtk_tree_view_set_search_entry
+GtkTreeViewSearchPositionFunc
+gtk_tree_view_get_search_position_func
+gtk_tree_view_set_search_position_func
 gtk_tree_view_get_fixed_height_mode
 gtk_tree_view_set_fixed_height_mode
 gtk_tree_view_get_hover_selection
@@ -4245,6 +4505,14 @@ gtk_tree_view_set_destroy_count_func
 GtkTreeViewRowSeparatorFunc
 gtk_tree_view_get_row_separator_func
 gtk_tree_view_set_row_separator_func
+gtk_tree_view_get_rubber_banding
+gtk_tree_view_set_rubber_banding
+gtk_tree_view_get_enable_tree_lines
+gtk_tree_view_set_enable_tree_lines
+GtkTreeViewGridLines
+gtk_tree_view_get_grid_lines
+gtk_tree_view_set_grid_lines
+
 <SUBSECTION Standard>
 GtkTreeSelectionClass
 GTK_TREE_VIEW
@@ -4380,6 +4648,7 @@ GTK_IS_CELL_RENDERER_SPIN
 GTK_IS_CELL_RENDERER_SPIN_CLASS
 GTK_CELL_RENDERER_SPIN_GET_CLASS
 <SUBSECTION Private>
+GtkCellRendererSpinPrivate
 gtk_cell_renderer_spin_get_type
 </SECTION>
 
@@ -4457,6 +4726,7 @@ GtkCellRendererProgressPrivate
 <FILE>gtkcellrendereraccel</FILE>
 <TITLE>GtkCellRendererAccel</TITLE>
 GtkCellRendererAccel
+GtkCellRendererAccelMode
 gtk_cell_renderer_accel_new
 
 <SUBSECTION Standard>
@@ -4821,6 +5091,7 @@ gtk_widget_list_mnemonic_labels
 gtk_widget_add_mnemonic_label
 gtk_widget_remove_mnemonic_label
 gtk_widget_get_action
+gtk_widget_is_composited
 <SUBSECTION>
 gtk_requisition_copy
 gtk_requisition_free
@@ -5248,8 +5519,11 @@ gtk_target_list_add_table
 gtk_target_list_add_text_targets
 gtk_target_list_add_image_targets
 gtk_target_list_add_uri_targets
+gtk_target_list_add_rich_text_targets
 gtk_target_list_remove
 gtk_target_list_find
+gtk_target_table_free
+gtk_target_table_new_from_list
 gtk_selection_owner_set
 gtk_selection_owner_set_for_display
 gtk_selection_add_target
@@ -5267,18 +5541,22 @@ gtk_selection_data_get_targets
 gtk_selection_data_targets_include_image
 gtk_selection_data_targets_include_text
 gtk_selection_data_targets_include_uri
+gtk_selection_data_targets_include_rich_text
 gtk_targets_include_image
 gtk_targets_include_text
 gtk_targets_include_uri
+gtk_targets_include_rich_text
 gtk_selection_remove_all
 gtk_selection_clear
 gtk_selection_data_copy
 gtk_selection_data_free
 <SUBSECTION Standard>
 GTK_TYPE_SELECTION_DATA
+GTK_TYPE_TARGET_LIST
 <SUBSECTION Private>
 gtk_selection_data_copy
 gtk_selection_data_get_type
+gtk_target_list_get_type
 </SECTION>
 
 <SECTION>
@@ -5289,6 +5567,7 @@ GtkClipboardReceivedFunc
 GtkClipboardTextReceivedFunc
 GtkClipboardImageReceivedFunc
 GtkClipboardTargetsReceivedFunc
+GtkClipboardRichTextReceivedFunc
 GtkClipboardGetFunc
 GtkClipboardClearFunc
 gtk_clipboard_get
@@ -5304,11 +5583,14 @@ gtk_clipboard_request_contents
 gtk_clipboard_request_text
 gtk_clipboard_request_image
 gtk_clipboard_request_targets
+gtk_clipboard_request_rich_text
 gtk_clipboard_wait_for_contents
 gtk_clipboard_wait_for_text
 gtk_clipboard_wait_for_image
+gtk_clipboard_wait_for_rich_text
 gtk_clipboard_wait_is_text_available
 gtk_clipboard_wait_is_image_available
+gtk_clipboard_wait_is_rich_text_available
 gtk_clipboard_wait_for_targets
 gtk_clipboard_wait_is_target_available
 gtk_clipboard_set_can_store
@@ -5649,6 +5931,10 @@ GTK_STOCK_NEW
 GTK_STOCK_NO
 GTK_STOCK_OK
 GTK_STOCK_OPEN
+GTK_STOCK_ORIENTATION_LANDSCAPE
+GTK_STOCK_ORIENTATION_PORTRAIT
+GTK_STOCK_ORIENTATION_REVERSE_LANDSCAPE
+GTK_STOCK_ORIENTATION_REVERSE_PORTRAIT
 GTK_STOCK_PASTE
 GTK_STOCK_PREFERENCES
 GTK_STOCK_PRINT
@@ -5794,3 +6080,395 @@ gtk_icon_factory_get_type
 gtk_icon_set_get_type
 gtk_icon_source_get_type
 </SECTION>
+
+
+<SECTION>
+<FILE>gtkprintoperation</FILE>
+<TITLE>High-level Printing API</TITLE>
+GtkPrintOperation
+GtkPrintStatus
+GtkPrintOperationAction
+GtkPrintOperationResult
+GtkPrintError
+GTK_PRINT_ERROR
+gtk_print_operation_new
+gtk_print_operation_set_allow_async
+gtk_print_operation_get_error
+gtk_print_operation_set_default_page_setup
+gtk_print_operation_get_default_page_setup
+gtk_print_operation_set_print_settings
+gtk_print_operation_get_print_settings
+gtk_print_operation_set_job_name
+gtk_print_operation_set_n_pages
+gtk_print_operation_set_current_page
+gtk_print_operation_set_use_full_page
+gtk_print_operation_set_unit
+gtk_print_operation_set_export_filename 
+gtk_print_operation_set_show_progress
+gtk_print_operation_set_track_print_status
+gtk_print_operation_set_custom_tab_label
+gtk_print_operation_run
+gtk_print_operation_cancel
+gtk_print_operation_get_status
+gtk_print_operation_get_status_string
+gtk_print_operation_is_finished
+gtk_print_operation_get_error
+gtk_print_run_page_setup_dialog
+GtkPageSetupDoneFunc
+gtk_print_run_page_setup_dialog_async
+
+<SUBSECTION Preview>
+GtkPrintOperationPreview
+gtk_print_operation_preview_end_preview
+gtk_print_operation_preview_is_selected
+gtk_print_operation_preview_render_page
+
+<SUBSECTION Standard>
+GTK_TYPE_PRINT_OPERATION
+GTK_PRINT_OPERATION
+GTK_IS_PRINT_OPERATION
+GTK_IS_PRINT_OPERATION_CLASS
+GTK_PRINT_OPERATION_CLASS
+GTK_PRINT_OPERATION_GET_CLASS
+GTK_IS_PRINT_OPERATION_PREVIEW
+GTK_PRINT_OPERATION_PREVIEW
+GTK_PRINT_OPERATION_PREVIEW_GET_IFACE
+GTK_TYPE_PRINT_OPERATION_PREVIEW
+
+<SUBSECTION Private>
+gtk_print_error_quark
+gtk_print_operation_get_type
+gtk_print_operation_preview_get_type
+GtkPrintOperationPrivate
+</SECTION>
+
+
+<SECTION>
+<INCLUDE>gtk/gtkprintunixdialog.h</INCLUDE>
+<FILE>gtkprintunixdialog</FILE>
+<TITLE>GtkPrintUnixDialog</TITLE>
+GtkPrintUnixDialog
+gtk_print_unix_dialog_new
+gtk_print_unix_dialog_set_page_setup
+gtk_print_unix_dialog_get_page_setup
+gtk_print_unix_dialog_set_current_page
+gtk_print_unix_dialog_get_current_page
+gtk_print_unix_dialog_set_settings
+gtk_print_unix_dialog_get_settings
+gtk_print_unix_dialog_get_selected_printer
+gtk_print_unix_dialog_add_custom_tab
+GtkPrintCapabilities
+gtk_print_unix_dialog_set_manual_capabilities
+
+<SUBSECTION Standard>
+GTK_TYPE_PRINT_UNIX_DIALOG
+GTK_PRINT_UNIX_DIALOG
+GTK_PRINT_UNIX_DIALOG_CLASS
+GTK_IS_PRINT_UNIX_DIALOG
+GTK_IS_PRINT_UNIX_DIALOG_CLASS
+GTK_PRINT_UNIX_DIALOG_GET_CLASS
+
+<SUBSECTION Private>
+GtkPrintUnixDialogPrivate
+gtk_print_unix_dialog_get_type
+gtk_print_capabilities_get_type
+</SECTION>
+
+
+<SECTION>
+<FILE>gtkprinter</FILE>
+<TITLE>GtkPrinter</TITLE>
+GtkPrinter
+GtkPrintBackend
+gtk_printer_new
+gtk_printer_get_backend
+gtk_printer_get_name
+gtk_printer_get_state_message
+gtk_printer_get_description
+gtk_printer_get_location
+gtk_printer_get_icon_name
+gtk_printer_get_job_count
+gtk_printer_is_active
+gtk_printer_is_virtual
+gtk_printer_is_default
+gtk_printer_accepts_ps
+gtk_printer_accepts_pdf
+gtk_printer_compare
+GtkPrinterFunc
+gtk_enumerate_printers
+
+<SUBSECTION Standard>
+GTK_TYPE_PRINTER
+GTK_PRINTER
+GTK_PRINTER_CLASS
+GTK_IS_PRINTER
+GTK_IS_PRINTER_CLASS
+GTK_PRINTER_GET_CLASS
+
+<SUBSECTION Private>
+GtkPrinterPrivate
+gtk_printer_get_type 
+</SECTION>
+
+
+<SECTION>
+<FILE>gtkprintsettings</FILE>
+<TITLE>GtkPrintSettings</TITLE>
+GtkPrintSettings
+GtkPrintSettingsFunc
+gtk_print_settings_new
+gtk_print_settings_copy
+gtk_print_settings_has_key
+gtk_print_settings_get
+gtk_print_settings_set
+gtk_print_settings_unset
+gtk_print_settings_foreach
+gtk_print_settings_get_bool
+gtk_print_settings_set_bool
+gtk_print_settings_get_double
+gtk_print_settings_get_double_with_default
+gtk_print_settings_set_double
+gtk_print_settings_get_length
+gtk_print_settings_set_length
+gtk_print_settings_get_int
+gtk_print_settings_get_int_with_default
+gtk_print_settings_set_int
+GTK_PRINT_SETTINGS_PRINTER
+gtk_print_settings_get_printer
+gtk_print_settings_set_printer
+GtkPageOrientation
+GTK_PRINT_SETTINGS_ORIENTATION
+gtk_print_settings_get_orientation
+gtk_print_settings_set_orientation
+GTK_PRINT_SETTINGS_PAPER_FORMAT
+gtk_print_settings_get_paper_size
+gtk_print_settings_set_paper_size
+GTK_PRINT_SETTINGS_PAPER_WIDTH
+gtk_print_settings_get_paper_width
+gtk_print_settings_set_paper_width
+GTK_PRINT_SETTINGS_PAPER_HEIGHT
+gtk_print_settings_get_paper_height
+gtk_print_settings_set_paper_height
+GTK_PRINT_SETTINGS_USE_COLOR
+gtk_print_settings_get_use_color
+gtk_print_settings_set_use_color
+GTK_PRINT_SETTINGS_COLLATE
+gtk_print_settings_get_collate
+gtk_print_settings_set_collate
+GTK_PRINT_SETTINGS_REVERSE
+gtk_print_settings_get_reverse
+gtk_print_settings_set_reverse
+GtkPrintDuplex
+GTK_PRINT_SETTINGS_DUPLEX
+gtk_print_settings_get_duplex
+gtk_print_settings_set_duplex
+GtkPrintQuality
+GTK_PRINT_SETTINGS_QUALITY
+gtk_print_settings_get_quality
+gtk_print_settings_set_quality
+GTK_PRINT_SETTINGS_N_COPIES
+gtk_print_settings_get_n_copies
+gtk_print_settings_set_n_copies
+GTK_PRINT_SETTINGS_NUMBER_UP
+gtk_print_settings_get_number_up
+gtk_print_settings_set_number_up
+GTK_PRINT_SETTINGS_RESOLUTION
+gtk_print_settings_get_resolution
+gtk_print_settings_set_resolution
+GTK_PRINT_SETTINGS_SCALE
+gtk_print_settings_get_scale
+gtk_print_settings_set_scale
+GtkPrintPages
+GTK_PRINT_SETTINGS_PRINT_PAGES
+gtk_print_settings_get_print_pages
+gtk_print_settings_set_print_pages
+GtkPageRange
+GTK_PRINT_SETTINGS_PAGE_RANGES
+gtk_print_settings_get_page_ranges
+gtk_print_settings_set_page_ranges
+GtkPageSet
+GTK_PRINT_SETTINGS_PAGE_SET
+gtk_print_settings_get_page_set
+gtk_print_settings_set_page_set
+GTK_PRINT_SETTINGS_DEFAULT_SOURCE
+gtk_print_settings_get_default_source
+gtk_print_settings_set_default_source
+GTK_PRINT_SETTINGS_MEDIA_TYPE
+gtk_print_settings_get_media_type
+gtk_print_settings_set_media_type
+GTK_PRINT_SETTINGS_DITHER
+gtk_print_settings_get_dither
+gtk_print_settings_set_dither
+GTK_PRINT_SETTINGS_FINISHINGS
+gtk_print_settings_get_finishings
+gtk_print_settings_set_finishings
+GTK_PRINT_SETTINGS_OUTPUT_BIN
+gtk_print_settings_get_output_bin
+gtk_print_settings_set_output_bin
+GTK_PRINT_SETTINGS_OUTPUT_FILE_FORMAT
+GTK_PRINT_SETTINGS_OUTPUT_URI
+GTK_PRINT_SETTINGS_WIN32_DRIVER_EXTRA
+GTK_PRINT_SETTINGS_WIN32_DRIVER_VERSION
+
+
+<SUBSECTION Standard>
+GTK_TYPE_PRINT_SETTINGS
+GTK_PRINT_SETTINGS
+GTK_IS_PRINT_SETTINGS
+
+<SUBSECTION Private>
+gtk_print_settings_get_type
+</SECTION>
+
+
+<SECTION>
+<FILE>gtkpapersize</FILE>
+<TITLE>GtkPaperSize</TITLE>
+GtkPaperSize
+GtkUnit
+GTK_PAPER_NAME_A3
+GTK_PAPER_NAME_A4
+GTK_PAPER_NAME_A5
+GTK_PAPER_NAME_B5
+GTK_PAPER_NAME_LETTER
+GTK_PAPER_NAME_EXECUTIVE
+GTK_PAPER_NAME_LEGAL
+gtk_paper_size_new
+gtk_paper_size_new_from_ppd
+gtk_paper_size_new_custom
+gtk_paper_size_copy
+gtk_paper_size_free
+gtk_paper_size_is_equal
+gtk_paper_size_get_name
+gtk_paper_size_get_display_name
+gtk_paper_size_get_ppd_name
+gtk_paper_size_get_width
+gtk_paper_size_get_height
+gtk_paper_size_is_custom
+gtk_paper_size_set_size
+gtk_paper_size_get_default_top_margin
+gtk_paper_size_get_default_bottom_margin
+gtk_paper_size_get_default_left_margin
+gtk_paper_size_get_default_right_margin
+gtk_paper_size_get_default
+
+<SUBSECTION Standard>
+GTK_TYPE_PAPER_SIZE
+<SUBSECTION Private>
+gtk_paper_size_get_type
+</SECTION>
+
+
+<SECTION>
+<FILE>gtkpagesetup</FILE>
+<TITLE>GtkPageSetup</TITLE>
+GtkPageSetup
+gtk_page_setup_new
+gtk_page_setup_copy
+gtk_page_setup_get_orientation
+gtk_page_setup_set_orientation
+gtk_page_setup_get_paper_size
+gtk_page_setup_set_paper_size
+gtk_page_setup_get_top_margin
+gtk_page_setup_set_top_margin
+gtk_page_setup_get_bottom_margin
+gtk_page_setup_set_bottom_margin
+gtk_page_setup_get_left_margin
+gtk_page_setup_set_left_margin
+gtk_page_setup_get_right_margin
+gtk_page_setup_set_right_margin
+gtk_page_setup_set_paper_size_and_default_margins
+gtk_page_setup_get_paper_width
+gtk_page_setup_get_paper_height
+gtk_page_setup_get_page_width
+gtk_page_setup_get_page_height
+
+<SUBSECTION Standard>
+GTK_TYPE_PAGE_SETUP
+GTK_PAGE_SETUP
+GTK_IS_PAGE_SETUP
+
+<SUBSECTION Private>
+gtk_page_setup_get_type
+</SECTION>
+
+
+<SECTION>
+<FILE>gtkprintcontext</FILE>
+<TITLE>GtkPrintContext</TITLE>
+GtkPrintContext
+gtk_print_context_get_cairo_context
+gtk_print_context_set_cairo_context
+gtk_print_context_get_page_setup
+gtk_print_context_get_width
+gtk_print_context_get_height
+gtk_print_context_get_dpi_x
+gtk_print_context_get_dpi_y
+gtk_print_context_get_pango_fontmap
+gtk_print_context_create_pango_context
+gtk_print_context_create_pango_layout
+
+<SUBSECTION Standard>
+GTK_TYPE_PRINT_CONTEXT
+GTK_PRINT_CONTEXT
+GTK_IS_PRINT_CONTEXT
+
+<SUBSECTION Private>
+gtk_print_context_get_type
+</SECTION>
+
+
+<SECTION>
+<FILE>gtkprintjob</FILE>
+<TITLE>GtkPrintJob</TITLE>
+GtkPrintJob
+GtkPrintJobCompleteFunc
+gtk_print_job_new
+gtk_print_job_get_settings
+gtk_print_job_get_printer
+gtk_print_job_get_title
+gtk_print_job_get_status
+gtk_print_job_set_source_file
+gtk_print_job_get_surface
+gtk_print_job_send
+gtk_print_job_set_track_print_status
+gtk_print_job_get_track_print_status
+
+<SUBSECTION Standard>
+GTK_TYPE_PRINT_JOB
+GTK_PRINT_JOB
+GTK_PRINT_JOB_CLASS
+GTK_IS_PRINT_JOB
+GTK_IS_PRINT_JOB_CLASS
+GTK_PRINT_JOB_GET_CLASS
+
+<SUBSECTION Private>
+GtkPrintJobPrivate
+gtk_print_job_get_type
+</SECTION>
+
+
+<SECTION>
+<INCLUDE>gtk/gtkpagesetupunixdialog.h</INCLUDE>
+<FILE>gtkpagesetupunixdialog</FILE>
+<TITLE>GtkPageSetupUnixDialog</TITLE>
+GtkPageSetupUnixDialog
+gtk_page_setup_unix_dialog_new
+gtk_page_setup_unix_dialog_set_page_setup
+gtk_page_setup_unix_dialog_get_page_setup
+gtk_page_setup_unix_dialog_set_print_settings
+gtk_page_setup_unix_dialog_get_print_settings
+
+<SUBSECTION Standard>
+GtkPageSetupUnixDialogClass
+GTK_TYPE_PAGE_SETUP_UNIX_DIALOG
+GTK_PAGE_SETUP_UNIX_DIALOG
+GTK_PAGE_SETUP_UNIX_DIALOG_CLASS
+GTK_IS_PAGE_SETUP_UNIX_DIALOG
+GTK_IS_PAGE_SETUP_UNIX_DIALOG_CLASS
+GTK_PAGE_SETUP_UNIX_DIALOG_GET_CLASS
+
+<SUBSECTION Private>
+GtkPageSetupUnixDialogPrivate
+gtk_page_setup_unix_dialog_get_type
+</SECTION>

docs/reference/gtk/gtk.types

@@ -1,4 +1,8 @@
 #include <gtk/gtk.h>
+#include <gtk/gtkprintunixdialog.h>
+#include <gtk/gtkpagesetupunixdialog.h>
+#include <gtk/gtkprinter.h>
+#include <gtk/gtkprintjob.h>
 
 gtk_about_dialog_get_type
 gtk_accel_group_get_type
@@ -24,6 +28,7 @@ gtk_cell_renderer_combo_get_type
 gtk_cell_renderer_get_type
 gtk_cell_renderer_pixbuf_get_type
 gtk_cell_renderer_progress_get_type
+gtk_cell_renderer_spin_get_type
 gtk_cell_renderer_text_get_type
 gtk_cell_renderer_toggle_get_type
 gtk_cell_view_get_type
@@ -96,10 +101,19 @@ gtk_notebook_get_type
 gtk_object_get_type
 gtk_old_editable_get_type
 gtk_option_menu_get_type
+gtk_page_setup_get_type
+gtk_page_setup_unix_dialog_get_type
 gtk_paned_get_type
+gtk_paper_size_get_type
 gtk_pixmap_get_type
 gtk_plug_get_type
 gtk_preview_get_type
+gtk_printer_get_type
+gtk_print_context_get_type
+gtk_print_job_get_type
+gtk_print_operation_get_type
+gtk_print_settings_get_type
+gtk_print_unix_dialog_get_type
 gtk_progress_bar_get_type
 gtk_progress_get_type
 gtk_radio_action_get_type
@@ -108,6 +122,11 @@ gtk_radio_menu_item_get_type
 gtk_radio_tool_button_get_type
 gtk_range_get_type
 gtk_rc_style_get_type
+gtk_recent_chooser_get_type
+gtk_recent_chooser_dialog_get_type
+gtk_recent_chooser_menu_get_type
+gtk_recent_chooser_widget_get_type
+gtk_recent_manager_get_type
 gtk_ruler_get_type
 gtk_scale_get_type
 gtk_scrollbar_get_type

docs/reference/gtk/migrating-GtkLinkButton.sgml

@@ -0,0 +1,72 @@
+<chapter id="gtk-migrating-GtkLinkButton">
+
+  <title>Migrating from GnomeHRef to GtkLinkButton</title>
+
+  <para>
+    Since version 2.10, GTK+ provides the #GtkLinkButton widget as a
+    replacement for the <structname>GnomeHRef</structname> widget
+    in the libgnomeui library.
+  </para>
+
+  <para>
+    Porting an application from <structname>GnomeHRef</structname> to
+    #GtkLinkButton is very simple. #GtkLinkButton does not have a
+    default action for "clicked" signal. So instead of simply creating
+    the widget
+    <informalexample><programlisting>
+      GtkWidget *button;
+
+      button = gnome_href_new (url, "");
+    </programlisting></informalexample>
+    you will have to handle the activation of the #GtkLinkButton, using
+    the "clicked" signal for instance
+    <informalexample><programlisting>
+      static void
+      link_button_clicked_cb (GtkWidget *widget,
+                              gpointer   data)
+      {
+        const gchar *link;
+
+	link = gtk_link_button_get_uri (GTK_LINK_BUTTON (widget));
+	open_browser_at_url (link);
+      }
+
+      /* ... */
+      
+        GtkWidget *button;
+
+	button = gtk_link_button_new (url);
+	g_signal_connect (button, "clicked",
+	                  G_CALLBACK (link_button_clicked_cb), NULL);
+     </programlisting></informalexample>
+    If you have more than one #GtkLinkButton instead of connecting
+    a signal to each one, you can use a "hook function" which will be
+    called whenever a user activates a link button
+    <informalexample><programlisting>
+      static void
+      link_button_hook (GtkLinkButton *button,
+                        const gchar   *link,
+			gpointer       user_data)
+      
+      {
+        open_browser_at_url (link);
+      }
+      
+      /* ... */
+      
+        GtkWidget *button1 = gtk_link_button_new (uri1);
+	GtkWidget *button2 = gtk_link_button_new (uri2);
+
+        gtk_link_button_set_uri_hook (link_button_hook, NULL, NULL);
+    </programlisting></informalexample>
+
+  </para>
+     
+</chapter>
+
+<!--
+Local variables:
+mode: sgml
+sgml-parent-document: ("gtk-docs.sgml" "book" "part" "chapter")
+End:
+-->

docs/reference/gtk/migrating-GtkRecentChooser.sgml

@@ -0,0 +1,319 @@
+<chapter id="gtk-migrating-GtkRecentChooser">
+  <chapterinfo>
+    <author>
+      <firstname>Emmanuele</firstname>
+      <lastname>Bassi</lastname>
+      <affiliation>
+        <address>
+	  <email>ebassi@gmail.com</email>
+	</address>
+      </affiliation>
+    </author>
+  </chapterinfo>
+
+  <title>Migrating from EggRecent to GtkRecentChooser</title>
+
+  <para>
+    Since version 2.10, GTK+ provides a way of handling the recently used
+    documents. It is similar to the code that has lived inside the libegg
+    library and has been incorporated by many applications. The GTK+ version
+    aims to completely replace that code, and offers many distinctive features
+    that improve the registration and visualization of the recently used
+    documents, such as:
+  </para>
+
+  <para>
+    <itemizedlist>
+      <listitem><para>
+        Better performances while reading and writing the list of recently used
+	files
+      </para></listitem>
+      <listitem><para>
+        More meta-data available for each recent document, like the
+	applications that have registered a document inside the list, the last
+	time and the number of times the same application did register a
+	document inside the list, an optional user readable name and
+	description of the document
+      </para></listitem>
+      <listitem><para>
+        Improved the ability to sort and filter the documents, also using
+	custom sorting and filtering functions
+      </para></listitem>
+      <listitem><para>
+        New widgets for displaying the list, and better integration with
+	current #GtkFileChooser and #GtkUIManager widgets
+      </para></listitem>
+    </itemizedlist>
+  </para>
+
+  <section id="gtkrecent-manager">
+    <title>Managing the Recently Used Documents</title>
+
+    <para>
+      #GtkRecentManager is used to manage the Recently Used Documents. To
+      create a new #GtkRecentManager, you simply call gtk_recent_manager_new().
+      Like the <structname>EggRecentModel</structname> inside EggRecent, the
+      #GtkRecentManager loads the list of the recent documents and notifies
+      you of changes inside the list.
+    </para>
+
+    <para>
+      Usually, instead of creating a new #GtkRecentManager each time you
+      need it, you'll want to use the gtk_recent_manager_get_default()
+      function.
+    </para>
+
+    <para>
+      To add a document to the list, you can use gtk_recent_manager_add_item(),
+      like:
+      <informalexample><programlisting>
+        GtkRecentManager *manager;
+
+	manager = gtk_recent_manager_new (<!-- -->);
+
+	if (!gtk_recent_manager_add_item (manager, document_uri))
+	  {
+	    /* warn about the error */
+	  }
+	
+	g_object_unref (manager);
+      </programlisting></informalexample>
+      The gtk_recent_manager_add_item() function will try and guess some of the
+      meta-data associated to a URI. If you know some of meta-data about the
+      document yourself, set the desired fields of a #GtkRecentData structure
+      and pass it to the gtk_recent_manager_add_full() function instead:
+      <informalexample><programlisting>
+        GtkRecentManager *manager;
+        GtkRecentData *recent_data;
+
+	manager = gtk_recent_manager_new (<!-- -->);
+	
+	recent_data = g_new0 (GtkRecentData, 1);
+	/* the user visible name of the document (maybe its title); should
+	 * be preferred when displaying the item into the list
+	 */
+        recent_data-&gt;display_name = document_name;
+	
+	/* the MIME type is mandatory */
+	recent_data-&gt;mime_type = document_mime_type;
+
+	/* the name of the application that is registering the document
+	 * (also mandatory); usually, the same name you used with
+	 * the g_set_application_name (<!-- -->) function.
+	 */
+	recent_data-&amp;app_name = APP_NAME;
+
+	/* the command to open a file; the %u string will be automagically
+	 * expanded to the document's URI when getting the application's
+	 * command line from the GtkRecentInfo object with
+	 * gtk_recent_info_get_application_info (<!-- -->)
+	 */
+	recent_data-&amp;app_exec = g_strjoin (" ", g_get_prgname (<!-- -->), "--open-file", "%u", NULL);
+
+	if (!gtk_recent_manager_add_full (manager, document_uri, recent_data))
+	  {
+	    /* warn about the error */
+	  }
+
+	g_free (recent_data-&gt;app_exec);
+	g_free (recent_data);
+	g_object_unref (manager);
+      </programlisting></informalexample>
+    </para>
+
+    <para>
+      Getting the list of items is also similar to
+      <structname>EggRecentModel</structname>; the GtkRecentInfo data is
+      allocated at look up time in order not to waste memory keeping it
+      around, so you must remember to free the data inside the list and then
+      the list itself when you are done using it:
+      <informalexample><programlisting>
+        GtkRecentManager *manager;
+        GList *recent_items, *l;
+
+	manager = gtk_recent_manager_get_default(<!-- -->);
+
+	recent_items = gtk_recent_manager_get_items (manager);
+	for (l = recent_items; l != NULL; l = l-&gt;next)
+	  {
+	    GtkRecentInfo *recent_info = l-&gt;data;
+
+	    do_something_with_the_item (recent_info);
+	  }
+	
+	/* free everything and the list */
+	g_list_foreach (recent_items, (GFunc) gtk_recent_info_unref, NULL);
+	g_list_free (recent_items);
+      </programlisting></informalexample>
+      You can also look up a single item:
+      <informalexample><programlisting>
+        GtkRecentInfo *recent_info;
+	GError *error = NULL;
+
+	recent_info = gtk_recent_manager_lookup_item (manager, document_uri, &amp;error);
+	if (error)
+	  {
+	    display_error (error);
+
+	    g_error_free (error);
+	  }
+	else
+	  {
+	    do_something_with_the_item (recent_info);
+
+	    gtk_recent_info_unref (recent_info);
+	  }
+      </programlisting></informalexample>
+      The #GtkRecentInfo is a reference counted boxed type, and it holds all
+      the meta-data of a recently used document, like its display name, its
+      description, the list of each application that has registered the
+      document or the list of groups to which the document belong.
+    </para>
+  
+  </section> <!-- gtkrecent-manager -->
+
+  <section id="gtkrecent-chooser">
+    <title>Displaying the Recently Used Documents</title>
+
+    <para>
+      Displaying the Recently Used Documents list is handled by any widget
+      implementing the #GtkRecentChooser interface. These widgets also handle
+      the sorting and filtering of the list; they will create their own
+      #GtkRecentManager objects by default:
+      <informalexample><programlisting>
+        GtkWidget *chooser;
+	gint response;
+
+	/* create a new dialog with the recently used documents list shown
+	 * using a GtkTreeView widget
+	 */
+	chooser = gtk_recent_chooser_dialog_new ("Recent Documents",
+	                                         parent_window,
+						 GTK_STOCK_CLOSE, GTK_RESPONSE_CANCEL,
+						 GTK_STOCK_OPEN, GTK_RESPONSE_OK,
+						 NULL);
+        /* set the sorting order to "most recently used first" */
+	gtk_recent_chooser_set_sort_type (GTK_RECENT_CHOOSER (chooser), GTK_RECENT_SORT_MRU);
+	response = gtk_dialog_run (GTK_DIALOG (chooser));
+	if (response == GTK_RESPONSE_OK)
+	  {
+	    GtkRecentInfo *info;
+
+            info = gtk_recent_chooser_get_current_item (GTK_RECENT_CHOOSER (chooser));
+	    do_something_with_the_item (info);
+
+	    gtk_recent_info_unref (info);
+	  }
+	
+	gtk_widget_destroy (chooser);
+      </programlisting></informalexample>
+    </para>
+    
+  </section> <!-- gtkrecent-chooser -->
+
+  <section id="gtkrecent-advanced">
+    <title>Advanced usage</title>
+
+    <para>
+      The #GtkRecentChooser widgets might display items sorted and filtered,
+      either with already supplied or custom sorting and filtering functions.
+      The biggest difference from the <structname>EggRecentView</structname>
+      widgets in EggRecent is that the #GtkRecentChooser widgets will use
+      their own copy of the list and will apply the sorting and filtering
+      functions only on the copy; this allows the creation of many viewers
+      with a single controller, like using many #GtkTreeView with a single
+      #GtkTreeModel instance.
+    </para>
+
+    <para>
+      Available sorting methods are:
+      <informalexample><programlisting>
+        /* no sorting */
+	gtk_recent_chooser_set_sort_type (GTK_RECENT_CHOOSER (chooser), GTK_RECENT_SORT_NONE);
+	
+        /* most recently used first */
+	gtk_recent_chooser_set_sort_type (GTK_RECENT_CHOOSER (chooser), GTK_RECENT_SORT_MRU);
+	
+	/* most recently used last */
+	gtk_recent_chooser_set_sort_type (GTK_RECENT_CHOOSER (chooser), GTK_RECENT_SORT_LRU);
+      </programlisting></informalexample>
+      You can create your own sorting function, and the use the
+      GTK_RECENT_SORT_CUSTOM method:
+      <informalexample><programlisting>
+	/* custom sorting function, based on the registration count
+	 * (most used first)
+	 */
+	static void
+	sort_by_usage_count (GtkRecentInfo *a,
+                             GtkRecentInfo *b,
+                             gpointer       data)
+        {
+	  gint count_a, count_b;
+
+	  count_a = count_b = 0;
+
+	  if (gtk_recent_info_has_application (a, APP_NAME))
+	    gtk_recent_info_get_application_info (a, APP_NAME, NULL, &amp;count_a, NULL);
+
+	  if (gtk_recent_info_has_application (b, APP_NAME))
+	    gtk_recent_info_get_application_info (b, APP_NAME, NULL, &amp;count_b, NULL);
+
+	  return count_a &lt; count_b;
+	}
+
+	...
+
+	  /* set custom sorting and set the custom sorting function */
+	  gtk_recent_chooser_set_sort_type (GTK_RECENT_CHOOSER (chooser),
+	                                    GTK_RECENT_SORT_CUSTOM);
+	  gtk_recent_chooser_set_sort_func (GTK_RECENT_CHOOSER,
+	                                    sort_by_usage_count,
+			  		    NULL, /* sort function data */
+					    NULL  /* destroy notify for the data */);
+      </programlisting></informalexample>
+    </para>
+
+    <para>
+      Filtering is done using the #GtkRecentFilter object, similar to the
+      #GtkFileFilter object used by the #GtkFileChooser widgets. The
+      #GtkRecentFilter object has a set of pre-defined options based on the
+      meta-data exposed by the #GtkRecentInfo object. It also allows custom
+      filtering function:
+      <informalexample><programlisting>
+        GtkRecentFilter *filter;
+
+	filter = gtk_recent_filter_new (<!-- -->);
+	
+	/* set the user visible name of the filter */
+	gtk_recent_filter_set_name (filter, "Since Last Month");
+
+	/* set the maximum age of a recently used document */
+	gtk_recent_filter_set_age (filter, 31);
+
+	/* the chooser takes the ownership of the object */
+	gtk_recent_chooser_add_filter (GTK_RECENT_CHOOSER (chooser), filter);
+
+	/* set the currently used filter */
+	gtk_recent_chooser_set_filter (GTK_RECENT_CHOOSER (chooser), filter);
+
+	filter = gtk_recent_filter_new (<!-- -->);
+	gtk_recent_filter_set_name (filter, "Every text file");
+	gtk_recent_filter_set_mime_type (filter, "text/plain");
+
+	gtk_recent_chooser_add_filter (GTK_RECENT_CHOOSER (chooser), filter);
+      </programlisting></informalexample>
+      The #GtkRecentChooserWidget and #GtkRecentChooserDialog widgets allow
+      multiple filters and the selection of an appropriate one; the
+      #GtkRecentChooserMenu widget allows just a single filter object.
+    </para>
+    
+  </section> <!-- gtkrecent-advanced -->
+  
+</chapter>
+
+<!--
+Local variables:
+mode: sgml
+sgml-parent-document: ("gtk-docs.sgml" "book" "part" "chapter")
+End:
+-->

docs/reference/gtk/migrating-checklist.sgml

@@ -68,8 +68,8 @@ do_popup_menu (GtkWidget *my_widget, GdkEventButton *event)
       event_time = gtk_get_current_event_time (<!-- -->);
     }
 
-  gtk_menu_attach_to_widget (GTK_MENU (popup), my_widget, NULL);
-  gtk_menu_popup (GTK_MENU (popup), NULL, NULL, NULL, NULL, 
+  gtk_menu_attach_to_widget (GTK_MENU (menu), my_widget, NULL);
+  gtk_menu_popup (GTK_MENU (menu), NULL, NULL, NULL, NULL, 
                   button, event_time);
 }
 	</programlisting>

docs/reference/gtk/question_index.sgml

@@ -205,13 +205,15 @@ You eventually have to call gettext() on the string to actually fetch the
 translation.  _() both marks the string for translation and actually translates it.
 </para>
 <para>
+Nowadays, GLib provides the common shorthand macros in the header file
+<filename>gi18n.h</filename>, so you don't have to define them yourself, just
+include that header.
+</para>
+<para>
 Code using these macros ends up looking like this:
 <informalexample>
 <programlisting>
- #include &lt;libintl.h&gt;
-
- #define  _(x)  gettext (x)
- #define N_(x)  x
+ #include &lt;gi18n.h&gt;
 
  static const char *global_variable = N_("Translate this string");
 
@@ -238,6 +240,11 @@ of using the default.For dgettext() the _() macro can be defined as:
 </programlisting>
 </informalexample>
 </para>
+<para>
+Again, GLib comes with the <filename>gi18n-lib.h</filename>, saving you the trouble
+of defining the macros by hand. The macros in that header expect the translation
+domain to be specified by the %GETTEXT_PACKAGE macro. 
+</para>
 </answer>
 </qandaentry>
 
@@ -517,6 +524,45 @@ volatile GType dummy = GTK_TYPE_BLAH;
 </para>
 </answer>
 </qandaentry>
+
+<qandaentry>
+<question>
+<para>
+How do I create a transparent toplevel window ?
+</para>
+</question>
+
+<answer>
+<para>
+To make a window transparent, it needs to use a visual which supports that.
+This is done by getting the RGBA colormap of the screen with 
+gdk_screen_get_rgba_colormap() and setting it on the window. Note that
+gdk_screen_get_rgba_colormap() will return %NULL if transparent windows
+are not supported on the screen; also note that this may change from
+screen to screen, so it needs to be repeated whenever the window is moved
+to a different screen.
+<informalexample><programlisting>
+GdkColormap *colormap;
+
+colormap = gdk_screen_get_rgba_colormap (screen);
+if (!colormap)
+  colormap = gtk_screen_get_rgb_colormap (screen);
+
+gtk_widget_set_colormap (widget, colormap);
+</programlisting></informalexample>
+One possibility to fill the alpha channel on the window is to use
+gdk_draw_rgb_32_image().
+</para>
+<para>
+Note that the presence of an RGBA visual is no guarantee that the
+window will actually appear transparent on screen. On X11, this 
+requires a compositing manager to be running. See 
+gtk_widget_is_composited() for a way to find out if the alpha
+channel will be respected.
+</para>
+</answer>
+</qandaentry>
+
 </qandadiv>
 
 <qandadiv><title>Which widget should I use...</title>
@@ -711,18 +757,21 @@ How do I make a text view scroll to the end of the buffer automatically ?
 
 <answer>
 <para>
-The "insert" <link linkend="GtkTextMark">mark</link> marks the insertion point
-where gtk_text_buffer_insert() inserts new text into the buffer. The text is inserted 
-<emphasis>before</emphasis> the "insert" mark, so that it generally stays 
-at the end of the buffer. If it gets explicitly moved to some other position, 
-e.g. when the user selects some text, use gtk_text_buffer_move_mark() to set it to 
-the desired location before inserting more text. The "insert" mark of a buffer can be 
-obtained with gtk_text_buffer_get_insert().
+A good way to keep a text buffer scrolled to the end is to place a
+<link linkend="GtkTextMark">mark</link> at the end of the buffer, and
+give it right gravity. The gravity has the effect that text inserted
+at the mark gets inserted <emphasis>before</emphasis>, keeping the mark
+at the end. 
 </para>
 
 <para> 
 To ensure that the end of the buffer remains visible, use
-gtk_text_view_scroll_to_mark() to scroll to the "insert" mark after inserting new text.
+gtk_text_view_scroll_to_mark() to scroll to the mark after 
+inserting new text.
+</para>
+
+<para>
+The gtk-demo application contains an example of this technique. 
 </para>
 </answer>
 </qandaentry>
@@ -885,6 +934,83 @@ See gtk_tree_view_set_expander_column() and gtk_tree_view_column_set_visible().
 
 </qandadiv>
 
+<qandadiv><title>Using cairo with GTK+</title>
+
+<qandaentry>
+<question><para>
+How do I use cairo to draw in GTK+ applications ?
+</para></question>
+
+<answer><para>
+USe gdk_cairo_create() to obtain a cairo context for drawing
+on a GDK window or pixmap. See <link linkend="gdk-Cairo-Interaction">Cairo 
+Interaction</link> for some more useful functions.
+</para></answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>
+I have created a cairo context with gdk_cairo_create(), but when I
+later use it, my drawing does not show up. Why is that ?
+</para></question>
+
+<answer>
+<para>
+All drawing in GTK+ is normally done in an expose handler, and GTK+
+creates a temporary pixmap for double-buffering the drawing. If you 
+create a cairo context outside the expose handler, it is backed
+by the GDK window itself, not the double-buffering pixmap. Consequently,
+any drawing you do with that cairo context gets overwritten at the 
+end of the expose handler, when the double-buffering pixmap is copied
+back.
+</para>
+<para>
+Possible solutions to this problem are:
+<itemizedlist>
+<listitem><para>
+Turn off double-buffering, with gtk_widget_set_double_buffered().
+This is not ideal, since it can cause some flickering.
+</para></listitem>
+<listitem><para>
+Create the cairo context inside the expose handler. If you do this,
+gdk_create_cairo() arranges for it to be backed by the double-buffering 
+pixmap. This is the preferred solution, and is used throughout GTK+
+itself.
+</para></listitem>
+</itemizedlist>
+</para>
+</answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>
+Can I improve the performance of my application by using the
+Glitz backend of cairo ?
+</para></question>
+
+<answer><para>
+No. The GDK X11 backend uses the cairo X backend (and the other
+GDK backends use their respective native cairo backends). The
+GTK+ developers believe that the best way to improving the GDK
+drawing performance is to optimize the cairo X backend and the
+relevant code paths in the X server that is uses (mostly the
+Render extension).
+</para></answer>
+</qandaentry>
+
+<qandaentry>
+<question><para>
+Can I use cairo to draw on a #GdkPixbuf ?
+</para></question>
+
+<answer><para>
+No, at least not yet. The cairo image surface does not support the
+pixel format used by GdkPixbuf. 
+</para></answer>
+</qandaentry>
+
+</qandadiv>
+
 </qandaset>
 
 </refsect1>

docs/reference/gtk/running.sgml

@@ -174,6 +174,14 @@ additional environment variables.
       <term>geometry</term>
       <listitem><para>Size allocation</para></listitem>
     </varlistentry>
+    <varlistentry>
+      <term>icontheme</term>
+      <listitem><para>Icon themes</para></listitem>
+    </varlistentry>
+    <varlistentry>
+      <term>printing</term>
+      <listitem><para>Printing support</para></listitem>
+    </varlistentry>
 
   </variablelist>
   The special value <literal>all</literal> can be used to turn on all debug options.

docs/reference/gtk/tmpl/gtk-unused.sgml

@@ -336,6 +336,18 @@ Turns off certain object flags.  (Private)
 @obj: the object to affect.
 @flag: the flags to unset.
 
+<!-- ##### MACRO GTK_PRINT_SETTINGS_NUM_COPIES ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO GTK_PRINT_SETTINGS_PRINT_TO_FILE ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### MACRO GTK_STOCK_BUTTON_APPLY ##### -->
 <para>
 
@@ -513,6 +525,12 @@ Use to get the value of a GtkArg whose GtkType is GTK_TYPE_C_FOREIGN
 @b: 
 @Returns: 
 
+<!-- ##### ARG GtkAboutDialog:link-color ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### STRUCT GtkAccelEntry ##### -->
 <para>
 This is a private struct used by GTK+ internally, don't worry about it.
@@ -620,6 +638,20 @@ Define a function pointer.  Deprecated.
 </para>
 
 
+<!-- ##### SIGNAL GtkComboBox::popup-hide ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
+<!-- ##### SIGNAL GtkComboBox::popup-show ##### -->
+<para>
+
+</para>
+
+@combobox: the object which received the signal.
+
 <!-- ##### ARG GtkComboBox:appearance ##### -->
 <para>
 
@@ -845,12 +877,78 @@ You may not attach these to signals created with the
 </para>
 
 
+<!-- ##### ARG GtkFileChooser:action ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:do-overwrite-confirmation ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:extra-widget ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkFileChooser:file-system ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### ARG GtkFileChooser:file-system-backend ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:filter ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:local-only ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:preview-widget ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:preview-widget-active ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:select-multiple ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:show-hidden ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkFileChooser:use-preview-label ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ENUM GtkFontFilterType ##### -->
 <para>
 A set of bit flags used to specify the filter being set
@@ -925,6 +1023,33 @@ a RC file.
 @menubar: the object which received the signal.
 @arg1: 
 
+<!-- ##### SIGNAL GtkNotebook::tab-added ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkNotebook::tab-removed ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@arg2: 
+
+<!-- ##### SIGNAL GtkNotebook::tab-reordered ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@arg1: 
+@arg2: 
+
 <!-- ##### ARG GtkObject:object-signal ##### -->
 <para>
 Setting this with a GtkType of GTK_TYPE_SIGNAL connects
@@ -1079,6 +1204,12 @@ after other user handlers and the default handler.
 @user_data: 
 @seq_id: 
 
+<!-- ##### ARG GtkPrintOperation:number-of-pages ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ENUM GtkPrivateFlags ##### -->
 <para>
 
@@ -1099,6 +1230,66 @@ after other user handlers and the default handler.
 </para>
 
 
+<!-- ##### ARG GtkRecentChooser:filter ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:limit ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:local-only ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:recent-manager ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:select-multiple ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:show-icons ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:show-not-found ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:show-private ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:show-tips ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkRecentChooser:sort-type ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkScrolledWindow:shadow ##### -->
 <para>
 
@@ -2136,6 +2327,13 @@ Claim or disclaim ownership of the PRIMARY X selection.
 @claim: if %TRUE, claim the selection, otherwise, disclaim it.
 @time: the timestamp for claiming the selection.
 
+<!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
 <!-- ##### FUNCTION gtk_file_chooser_get_folder_mode ##### -->
 <para>
 
@@ -2723,6 +2921,78 @@ Set the the handle size to @size x @size pixels.
 @pspec: 
 @pattern: 
 
+<!-- ##### FUNCTION gtk_print_context_create_context ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_print_context_create_layout ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_print_context_get_cairo ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_print_context_get_fontmap ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_print_operation_set_nr_of_pages ##### -->
+<para>
+
+</para>
+
+@op: 
+@n_pages: 
+
+<!-- ##### FUNCTION gtk_print_settings_get_num_copies ##### -->
+<para>
+
+</para>
+
+@settings: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_print_settings_get_print_to_file ##### -->
+<para>
+
+</para>
+
+@settings: 
+@Returns: 
+
+<!-- ##### FUNCTION gtk_print_settings_set_num_copies ##### -->
+<para>
+
+</para>
+
+@settings: 
+@num_copies: 
+
+<!-- ##### FUNCTION gtk_print_settings_set_print_to_file ##### -->
+<para>
+
+</para>
+
+@settings: 
+@print_to_file: 
+
 <!-- ##### FUNCTION gtk_rc_init ##### -->
 <para>
 Internal function.

docs/reference/gtk/tmpl/gtkaboutdialog.sgml

@@ -114,11 +114,6 @@ only private fields and should not be directly accessed.
 
 </para>
 
-<!-- ##### ARG GtkAboutDialog:link-color ##### -->
-<para>
-
-</para>
-
 <!-- ##### FUNCTION gtk_about_dialog_new ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkaccelgroup.sgml

@@ -94,9 +94,6 @@ Deprecated equivalent of g_object_unref().
 @accel_mods: 
 @accel_flags: 
 @closure: 
-<!-- # Unused Parameters # -->
-@accel_path_quark: 
-@path_quark: 
 
 
 <!-- ##### FUNCTION gtk_accel_group_connect_by_path ##### -->
@@ -141,9 +138,6 @@ Deprecated equivalent of g_object_unref().
 @accel_group: 
 @closure: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@accel_key: 
-@accel_mods: 
 
 
 <!-- ##### FUNCTION gtk_accel_group_disconnect_key ##### -->
@@ -216,8 +210,6 @@ Deprecated equivalent of g_object_unref().
 @accel_key: 
 @accel_mods: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@acceleratable: 
 
 
 <!-- ##### FUNCTION gtk_accel_groups_from_object ##### -->

docs/reference/gtk/tmpl/gtkaccellabel.sgml

@@ -114,8 +114,6 @@ Creates a new #GtkAccelLabel.
 
 @accel_label: 
 @accel_closure: 
-<!-- # Unused Parameters # -->
-@closure: 
 
 
 <!-- ##### FUNCTION gtk_accel_label_get_accel_widget ##### -->

docs/reference/gtk/tmpl/gtkaction.sgml

@@ -75,6 +75,11 @@ and should not be accessed directly.
 
 </para>
 
+<!-- ##### ARG GtkAction:icon-name ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkAction:is-important ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkarrow.sgml

@@ -39,35 +39,20 @@ style of an arrow can be changed after creation by using gtk_arrow_set().
 
 <!-- ##### STRUCT GtkArrow ##### -->
 <para>
-The #GtkArrow-struct containes the following fields.
+The #GtkArrow struct containes the following fields.
 (These fields should be considered read-only. They should never be set by
-an application.)
-
-<informaltable pgwide="1" frame="none" role="struct">
-<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
-<tbody>
-
-<row>
-<entry>#gint16 <structfield>arrow_type</structfield>;</entry>
-<entry>the direction of the arrow, one of #GtkArrowType.</entry>
-</row>
-
-<row>
-<entry>#gint16 <structfield>shadow_type</structfield>;</entry>
-<entry>the style of the arrow, one of #GtkShadowType.</entry>
-</row>
-</tbody></tgroup></informaltable>
+an application.)
 </para>
 
 
 <!-- ##### ARG GtkArrow:arrow-type ##### -->
-<para>
-
+<para>
+
 </para>
 
 <!-- ##### ARG GtkArrow:shadow-type ##### -->
-<para>
-
+<para>
+
 </para>
 
 <!-- ##### FUNCTION gtk_arrow_new ##### -->

docs/reference/gtk/tmpl/gtkassistant.sgml

@@ -324,3 +324,11 @@ or GTK_ASSISTANT_PAGE_SUMMARY to be correct.
 @child: 
 
 
+<!-- ##### FUNCTION gtk_assistant_update_buttons_state ##### -->
+<para>
+
+</para>
+
+@assistant: 
+
+

docs/reference/gtk/tmpl/gtkbutton.sgml

@@ -70,7 +70,7 @@ This should not be accessed directly.  Use the accessor functions below.
 
 </para>
 
-@button:
+@button: 
 
 <!-- ##### ARG GtkButton:focus-on-click ##### -->
 <para>
@@ -82,6 +82,11 @@ This should not be accessed directly.  Use the accessor functions below.
 
 </para>
 
+<!-- ##### ARG GtkButton:image-position ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkButton:label ##### -->
 <para>
 
@@ -137,6 +142,16 @@ This should not be accessed directly.  Use the accessor functions below.
 
 </para>
 
+<!-- ##### ARG GtkButton:image-spacing ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkButton:inner-border ##### -->
+<para>
+
+</para>
+
 <!-- ##### FUNCTION gtk_button_new ##### -->
 <para>
 Creates a new #GtkButton widget. To add a child widget to the button,
@@ -270,8 +285,6 @@ Returns the current relief style of the given #GtkButton.
 
 @button: 
 @use_stock: 
-<!-- # Unused Parameters # -->
-@value: 
 
 
 <!-- ##### FUNCTION gtk_button_get_use_underline ##### -->
@@ -290,8 +303,6 @@ Returns the current relief style of the given #GtkButton.
 
 @button: 
 @use_underline: 
-<!-- # Unused Parameters # -->
-@value: 
 
 
 <!-- ##### FUNCTION gtk_button_set_focus_on_click ##### -->
@@ -350,3 +361,21 @@ Returns the current relief style of the given #GtkButton.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_button_set_image_position ##### -->
+<para>
+
+</para>
+
+@button: 
+@position: 
+
+
+<!-- ##### FUNCTION gtk_button_get_image_position ##### -->
+<para>
+
+</para>
+
+@button: 
+@Returns: 
+
+

docs/reference/gtk/tmpl/gtkcelllayout.sgml

@@ -11,6 +11,18 @@ want to provide a #GtkTreeViewColumn-like API for packing cells, setting
 attributes and data funcs. 
 </para>
 
+<para>
+One of the notable features provided by implementations of GtkCellLayout
+are <emphasis>attributes</emphasis>. Attributes let you set the properties
+in flexible ways. They can just be set to constant values like regular
+properties. But they can also be mapped to a column of the underlying 
+tree model with gtk_cell_layout_set_attributes(), which means that the value 
+of the attribute can change from cell to cell as they are rendered by the 
+cell renderer. Finally, it is possible to specify a function with 
+gtk_cell_layout_set_cell_data_func() that is called to determine the value 
+of the attribute for each cell that is rendered.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkcellrendereraccel.sgml

@@ -7,7 +7,7 @@ Renders a keyboard accelerator in a cell
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 #GtkCellRendererAccel displays a keyboard accelerator (i.e. a 
-key combination like <Control>-a). If the cell renderer is editable, the 
+key combination like &lt;Control&gt;-a). If the cell renderer is editable, the 
 accelerator can be changed by simply typing the new combination.
 </para>
 
@@ -20,7 +20,6 @@ The #GtkCellRendererAccel cell renderer was added in GTK+ 2.10.
 
 </para>
 
-
 <!-- ##### SECTION Stability_Level ##### -->
 
 
@@ -69,6 +68,14 @@ The #GtkCellRendererAccel cell renderer was added in GTK+ 2.10.
 
 </para>
 
+<!-- ##### ENUM GtkCellRendererAccelMode ##### -->
+<para>
+
+</para>
+
+@GTK_CELL_RENDERER_ACCEL_MODE_GTK: 
+@GTK_CELL_RENDERER_ACCEL_MODE_OTHER: 
+
 <!-- ##### FUNCTION gtk_cell_renderer_accel_new ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkcellrendererspin.sgml

@@ -16,7 +16,7 @@ that means that the text has to be parseable as a floating point number.
 The range of the spinbutton is taken from the adjustment property of the
 cell renderer, which can be set explicitly or mapped to a column in the 
 tree model, like all properties of cell renders. #GtkCellRendererSpin
-also has properties for the climb rante and the number of digits to
+also has properties for the climb rate and the number of digits to
 display. Other #GtkSpinButton properties can be set in a handler for the
 start-editing signal.
 </para>
@@ -25,13 +25,11 @@ start-editing signal.
 The #GtkCellRendererSpin cell renderer was added in GTK+ 2.10.
 </para>
 
-
 <!-- ##### SECTION See_Also ##### -->
 <para>
 #GtkCellRendererText, #GtkSpinButton
 </para>
 
-
 <!-- ##### SECTION Stability_Level ##### -->
 
 
@@ -40,7 +38,21 @@ The #GtkCellRendererSpin cell renderer was added in GTK+ 2.10.
 
 </para>
 
-@parent: 
+
+<!-- ##### ARG GtkCellRendererSpin:adjustment ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRendererSpin:climb-rate ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkCellRendererSpin:digits ##### -->
+<para>
+
+</para>
 
 <!-- ##### FUNCTION gtk_cell_renderer_spin_new ##### -->
 <para>

docs/reference/gtk/tmpl/gtkcellview.sgml

@@ -41,6 +41,11 @@ and drag and drop.
 
 </para>
 
+<!-- ##### ARG GtkCellView:model ##### -->
+<para>
+
+</para>
+
 <!-- ##### FUNCTION gtk_cell_view_new ##### -->
 <para>
 
@@ -130,7 +135,5 @@ and drag and drop.
 
 @cell_view: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@cellview: 
 
 

docs/reference/gtk/tmpl/gtkclipboard.sgml

@@ -152,6 +152,18 @@ Storing data on clipboards
 @Since: 2.4
 
 
+<!-- ##### USER_FUNCTION GtkClipboardRichTextReceivedFunc ##### -->
+<para>
+
+</para>
+
+@clipboard: 
+@format: 
+@text: 
+@length: 
+@data: 
+
+
 <!-- ##### USER_FUNCTION GtkClipboardGetFunc ##### -->
 <para>
 A function that will be called to provide the contents of the selection.
@@ -319,6 +331,17 @@ will not be used again.
 @user_data: 
 
 
+<!-- ##### FUNCTION gtk_clipboard_request_rich_text ##### -->
+<para>
+
+</para>
+
+@clipboard: 
+@buffer: 
+@callback: 
+@user_data: 
+
+
 <!-- ##### FUNCTION gtk_clipboard_wait_for_contents ##### -->
 <para>
 
@@ -347,6 +370,18 @@ will not be used again.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_clipboard_wait_for_rich_text ##### -->
+<para>
+
+</para>
+
+@clipboard: 
+@buffer: 
+@format: 
+@length: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_clipboard_wait_is_text_available ##### -->
 <para>
 
@@ -365,6 +400,16 @@ will not be used again.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_clipboard_wait_is_rich_text_available ##### -->
+<para>
+
+</para>
+
+@clipboard: 
+@buffer: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_clipboard_wait_for_targets ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkcolorbutton.sgml

@@ -6,8 +6,9 @@ A button to launch a color selection dialog
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-The #GtkColorButton is a button which displays the currently selected color an allows to open a color 
-selection dialog to change the color. It is suitable widget for selecting a color in a preference dialog.
+The #GtkColorButton is a button which displays the currently selected color 
+an allows to open a color selection dialog to change the color. It is suitable 
+widget for selecting a color in a preference dialog.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -20,7 +21,8 @@ selection dialog to change the color. It is suitable widget for selecting a colo
 
 <!-- ##### STRUCT GtkColorButton ##### -->
 <para>
-
+The GtkColorButton struct has only private fields and 
+should not be used directly.
 </para>
 
 

docs/reference/gtk/tmpl/gtkcombobox.sgml

@@ -55,20 +55,6 @@ gtk_combo_box_get_active_text().
 
 @combobox: the object which received the signal.
 
-<!-- ##### SIGNAL GtkComboBox::popup-hide ##### -->
-<para>
-
-</para>
-
-@combobox: the object which received the signal.
-
-<!-- ##### SIGNAL GtkComboBox::popup-show ##### -->
-<para>
-
-</para>
-
-@combobox: the object which received the signal.
-
 <!-- ##### ARG GtkComboBox:active ##### -->
 <para>
 
@@ -99,6 +85,11 @@ gtk_combo_box_get_active_text().
 
 </para>
 
+<!-- ##### ARG GtkComboBox:popup-shown ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkComboBox:row-span-column ##### -->
 <para>
 
@@ -125,8 +116,6 @@ gtk_combo_box_get_active_text().
 </para>
 
 @Returns: 
-<!-- # Unused Parameters # -->
-@model: 
 
 
 <!-- ##### FUNCTION gtk_combo_box_new_with_model ##### -->
@@ -208,8 +197,6 @@ gtk_combo_box_get_active_text().
 
 @combo_box: 
 @index_: 
-<!-- # Unused Parameters # -->
-@index: 
 
 
 <!-- ##### FUNCTION gtk_combo_box_get_active_iter ##### -->

docs/reference/gtk/tmpl/gtkcomboboxentry.sgml

@@ -59,9 +59,6 @@ with gtk_combo_box_entry_new_text().
 </para>
 
 @Returns: 
-<!-- # Unused Parameters # -->
-@model: 
-@text_column: 
 
 
 <!-- ##### FUNCTION gtk_combo_box_entry_new_with_model ##### -->

docs/reference/gtk/tmpl/gtkcontainer.sgml

@@ -260,7 +260,6 @@ Does the same as gtk_container_set_border_width().
 Does the same as gtk_container_get_children().
 </para>
 
-@Returns: 
 @Deprecated: Use gtk_container_get_children() instead.
 
 
@@ -364,8 +363,6 @@ Does the same as gtk_container_get_children().
 @child: 
 @first_prop_name: 
 @Varargs: 
-<!-- # Unused Parameters # -->
-@first_arg_name: 
 
 
 <!-- ##### FUNCTION gtk_container_child_get_property ##### -->
@@ -485,8 +482,6 @@ Does the same as gtk_container_get_children().
 @cclass: 
 @property_name: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@class: 
 
 
 <!-- ##### FUNCTION gtk_container_class_install_child_property ##### -->
@@ -497,8 +492,6 @@ Does the same as gtk_container_get_children().
 @cclass: 
 @property_id: 
 @pspec: 
-<!-- # Unused Parameters # -->
-@class: 
 
 
 <!-- ##### FUNCTION gtk_container_class_list_child_properties ##### -->
@@ -509,7 +502,5 @@ Does the same as gtk_container_get_children().
 @cclass: 
 @n_properties: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@class: 
 
 

docs/reference/gtk/tmpl/gtkdialog.sgml

@@ -281,8 +281,6 @@ directly, but into the @vbox and @action_area, as described above.
 @dialog: 
 @child: 
 @response_id: 
-<!-- # Unused Parameters # -->
-@widget: 
 
 
 <!-- ##### FUNCTION gtk_dialog_get_has_separator ##### -->

docs/reference/gtk/tmpl/gtkdnd.sgml

@@ -164,6 +164,24 @@ notification of drags.
 @widget: 
 
 
+<!-- ##### FUNCTION gtk_drag_dest_set_track_motion ##### -->
+<para>
+
+</para>
+
+@widget: 
+@track_motion: 
+
+
+<!-- ##### FUNCTION gtk_drag_dest_get_track_motion ##### -->
+<para>
+
+</para>
+
+@widget: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_drag_finish ##### -->
 <para>
 Informs the drag source that the drop is finished, and

docs/reference/gtk/tmpl/gtkentry.sgml

@@ -131,6 +131,11 @@ The #GtkEntry-struct struct contains only private data.
 
 </para>
 
+<!-- ##### ARG GtkEntry:inner-border ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkEntry:invisible-char ##### -->
 <para>
 
@@ -156,6 +161,11 @@ The #GtkEntry-struct struct contains only private data.
 
 </para>
 
+<!-- ##### ARG GtkEntry:truncate-multiline ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkEntry:visibility ##### -->
 <para>
 
@@ -171,12 +181,21 @@ The #GtkEntry-struct struct contains only private data.
 
 </para>
 
-<!-- ##### FUNCTION gtk_entry_new ##### -->
 <para>
 Creates a new #GtkEntry widget.
 </para>
 
-@Returns: a new #GtkEntry.
+<!-- ##### ARG GtkEntry:inner-border ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION gtk_entry_new ##### -->
+<para>
+
+</para>
+
+@Returns: 
 
 
 <!-- ##### FUNCTION gtk_entry_new_with_max_length ##### -->
@@ -323,6 +342,15 @@ use gtk_editable_set_editable() instead.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_entry_get_inner_border ##### -->
+<para>
+
+</para>
+
+@entry: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_entry_get_width_chars ##### -->
 <para>
 
@@ -350,6 +378,15 @@ use gtk_editable_set_editable() instead.
 @setting: 
 
 
+<!-- ##### FUNCTION gtk_entry_set_inner_border ##### -->
+<para>
+
+</para>
+
+@entry: 
+@border: 
+
+
 <!-- ##### FUNCTION gtk_entry_set_width_chars ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkentrycompletion.sgml

@@ -145,8 +145,6 @@ to the unmodified key via <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_comp
 
 @completion: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@entry: 
 
 
 <!-- ##### FUNCTION gtk_entry_completion_set_model ##### -->
@@ -220,8 +218,6 @@ to the unmodified key via <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_comp
 @completion: 
 @index_: 
 @text: 
-<!-- # Unused Parameters # -->
-@index: 
 
 
 <!-- ##### FUNCTION gtk_entry_completion_insert_action_markup ##### -->
@@ -232,8 +228,6 @@ to the unmodified key via <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_comp
 @completion: 
 @index_: 
 @markup: 
-<!-- # Unused Parameters # -->
-@index: 
 
 
 <!-- ##### FUNCTION gtk_entry_completion_delete_action ##### -->
@@ -243,8 +237,6 @@ to the unmodified key via <literal>gtk_entry_get_text (GTK_ENTRY (gtk_entry_comp
 
 @completion: 
 @index_: 
-<!-- # Unused Parameters # -->
-@index: 
 
 
 <!-- ##### FUNCTION gtk_entry_completion_set_text_column ##### -->

docs/reference/gtk/tmpl/gtkenums.sgml

@@ -58,6 +58,7 @@ Used to indicate the direction in which a #GtkArrow should point.
 @GTK_ARROW_DOWN: Represents a downward pointing arrow.
 @GTK_ARROW_LEFT: Represents a left pointing arrow.
 @GTK_ARROW_RIGHT: Represents a right pointing arrow.
+@GTK_ARROW_NONE: No arrow. Since 2.10.
 
 <!-- ##### ENUM GtkAttachOptions ##### -->
 <para>
@@ -360,9 +361,8 @@ Used to change the appearance of an outline typically provided by a #GtkFrame.
 @GTK_SHADOW_NONE: No outline.
 @GTK_SHADOW_IN: The outline is bevelled inwards.
 @GTK_SHADOW_OUT: The outline is bevelled outwards like a button.
-@GTK_SHADOW_ETCHED_IN: The outline itself is an inward bevel, but the frame
-does
-@GTK_SHADOW_ETCHED_OUT: 
+@GTK_SHADOW_ETCHED_IN: The outline has a sunken 3d appearance.
+@GTK_SHADOW_ETCHED_OUT: The outline has a raised 3d appearance
 
 <!-- ##### ENUM GtkSideType ##### -->
 <para>

docs/reference/gtk/tmpl/gtkfilechooser.sgml

@@ -672,61 +672,6 @@ gtk_widget_destroy (chooser);
 
 @filechooser: the object which received the signal.
 
-<!-- ##### ARG GtkFileChooser:action ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:do-overwrite-confirmation ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:extra-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:file-system-backend ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:filter ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:local-only ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:preview-widget ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:preview-widget-active ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:select-multiple ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:show-hidden ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkFileChooser:use-preview-label ##### -->
-<para>
-
-</para>
-
 <!-- ##### ENUM GtkFileChooserAction ##### -->
     <para>
       Describes whether a #GtkFileChooser is being used to open
@@ -783,14 +728,6 @@ gtk_widget_destroy (chooser);
 @GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
 @GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS: 
 
-<!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
 <!-- ##### FUNCTION gtk_file_chooser_set_action ##### -->
 <para>
 
@@ -816,8 +753,6 @@ gtk_widget_destroy (chooser);
 
 @chooser: 
 @local_only: 
-<!-- # Unused Parameters # -->
-@files_only: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_get_local_only ##### -->
@@ -1101,8 +1036,6 @@ gtk_widget_destroy (chooser);
 
 @chooser: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@file_chooser: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_get_preview_uri ##### -->
@@ -1112,8 +1045,6 @@ gtk_widget_destroy (chooser);
 
 @chooser: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@file_chooser: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_set_extra_widget ##### -->
@@ -1219,8 +1150,6 @@ gtk_widget_destroy (chooser);
 @uri: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@folder: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder_uri ##### -->
@@ -1232,8 +1161,6 @@ gtk_widget_destroy (chooser);
 @uri: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@folder: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folder_uris ##### -->

docs/reference/gtk/tmpl/gtkfontbutton.sgml

@@ -20,7 +20,8 @@ dialog to change the font. It is suitable widget for selecting a font in a prefe
 
 <!-- ##### STRUCT GtkFontButton ##### -->
 <para>
-
+The GtkFontButton struct has only private members and should not be used
+directly.
 </para>
 
 

docs/reference/gtk/tmpl/gtkfontsel.sgml

@@ -89,8 +89,8 @@ Gets the currently-selected font.
 <para>
 </para>
 
-@fontsel:
-@fontname:
+@fontsel: 
+@fontname: 
 @Returns: 
 
 

docs/reference/gtk/tmpl/gtkiconfactory.sgml

@@ -220,8 +220,6 @@ looking up the icon to use for a given stock ID.
 @width: 
 @height: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@alias: 
 
 
 <!-- ##### FUNCTION gtk_icon_size_lookup_for_settings ##### -->
@@ -245,8 +243,6 @@ looking up the icon to use for a given stock ID.
 @width: 
 @height: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@alias: 
 
 
 <!-- ##### FUNCTION gtk_icon_size_register_alias ##### -->

docs/reference/gtk/tmpl/gtkicontheme.sgml

@@ -84,8 +84,8 @@ pixbuf = gtk_icon_theme_load_icon (icon_theme,
                                    &error);
 if (!pixbuf)
   {
-    g_warning ("Couldn't load icon: %s", error->message);
-    g_error_free (message);
+    g_warning ("Couldn't load icon: %s", error->message);
+    g_error_free (error);
   }
 else
   {
@@ -140,7 +140,7 @@ gtk_icon_theme_set_custom_theme().
 
 <!-- ##### MACRO GTK_ICON_THEME_ERROR ##### -->
 <para>
-
+The #GQuark used for #GtkIconThemeError errors.
 </para>
 
 

docs/reference/gtk/tmpl/gtkiconview.sgml

@@ -180,11 +180,9 @@ A function used by gtk_icon_view_selected_foreach() to map all
 selected rows.  It will be called on every selected row in the view.
 </para>
 
-@icon_view: 
+@icon_view: a #GtkIconView
 @path: The #GtkTreePath of a selected row
 @data: user data
-<!-- # Unused Parameters # -->
-@model: The #GtkTreeModel being viewed
 
 
 <!-- ##### FUNCTION gtk_icon_view_new ##### -->
@@ -563,15 +561,15 @@ selected rows.  It will be called on every selected row in the view.
 
 <!-- ##### ENUM GtkIconViewDropPosition ##### -->
 <para>
-
+An enum for determining where a dropped item goes.
 </para>
 
-@GTK_ICON_VIEW_NO_DROP: 
-@GTK_ICON_VIEW_DROP_INTO: 
-@GTK_ICON_VIEW_DROP_LEFT: 
-@GTK_ICON_VIEW_DROP_RIGHT: 
-@GTK_ICON_VIEW_DROP_ABOVE: 
-@GTK_ICON_VIEW_DROP_BELOW: 
+@GTK_ICON_VIEW_NO_DROP: no drop possible
+@GTK_ICON_VIEW_DROP_INTO: dropped item replaces the item
+@GTK_ICON_VIEW_DROP_LEFT: droppped item is inserted to the left
+@GTK_ICON_VIEW_DROP_RIGHT: dropped item is inserted to the right
+@GTK_ICON_VIEW_DROP_ABOVE: dropped item is inserted above
+@GTK_ICON_VIEW_DROP_BELOW: dropped item is inserted below
 
 <!-- ##### FUNCTION gtk_icon_view_enable_model_drag_source ##### -->
 <para>

docs/reference/gtk/tmpl/gtkimage.sgml

@@ -189,7 +189,8 @@ functions), but they will all return %NULL values.
 @GTK_IMAGE_STOCK: the widget contains a stock icon name (see <xref linkend="gtk-Stock-Items"/>)
 @GTK_IMAGE_ICON_SET: the widget contains a #GtkIconSet
 @GTK_IMAGE_ANIMATION: the widget contains a #GdkPixbufAnimation
-@GTK_IMAGE_ICON_NAME: 
+@GTK_IMAGE_ICON_NAME: the widget contains a named icon. 
+  This image type was added in GTK+ 2.6
 
 <!-- ##### FUNCTION gtk_image_get_icon_set ##### -->
 <para>
@@ -437,7 +438,6 @@ functions), but they will all return %NULL values.
 
 @Returns: the #GtkImage
 <!-- # Unused Parameters # -->
-@val: 
 @mask: a #GdkBitmap that indicates which parts of the image should be transparent.
 
 

docs/reference/gtk/tmpl/gtkimagemenuitem.sgml

@@ -56,9 +56,6 @@ fill in the text label.
 </para>
 
 @Returns: 
-<!-- # Unused Parameters # -->
-@widget: 
-@label: 
 
 
 <!-- ##### FUNCTION gtk_image_menu_item_new_from_stock ##### -->

docs/reference/gtk/tmpl/gtklabel.sgml

@@ -258,6 +258,11 @@ described below.
 
 </para>
 
+<!-- ##### ARG GtkLabel:wrap-mode ##### -->
+<para>
+
+</para>
+
 <!-- ##### FUNCTION gtk_label_new ##### -->
 <para>
 
@@ -385,6 +390,15 @@ probably only used within the Gtk+ library itself for menu items and such.
 @wrap: 
 
 
+<!-- ##### FUNCTION gtk_label_set_line_wrap_mode ##### -->
+<para>
+
+</para>
+
+@label: 
+@wrap_mode: 
+
+
 <!-- ##### MACRO gtk_label_set ##### -->
 <para>
 Aliases gtk_label_set_text().  Probably used for backward compatibility with
@@ -548,6 +562,15 @@ Gtk+ 1.0.x.
 @Returns: 
 
 
+<!-- ##### FUNCTION gtk_label_get_line_wrap_mode ##### -->
+<para>
+
+</para>
+
+@label: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gtk_label_get_mnemonic_widget ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtklayout.sgml

@@ -95,8 +95,6 @@ area.
 @child_widget: 
 @x: 
 @y: 
-<!-- # Unused Parameters # -->
-@widget: 
 
 
 <!-- ##### FUNCTION gtk_layout_move ##### -->
@@ -108,8 +106,6 @@ area.
 @child_widget: 
 @x: 
 @y: 
-<!-- # Unused Parameters # -->
-@widget: 
 
 
 <!-- ##### FUNCTION gtk_layout_set_size ##### -->

docs/reference/gtk/tmpl/gtklinkbutton.sgml

@@ -0,0 +1,115 @@
+<!-- ##### SECTION Title ##### -->
+GtkLinkButton
+
+<!-- ##### SECTION Short_Description ##### -->
+Create buttons bound to a URL
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+A #GtkLinkButton is a #GtkButton with a hyperlink, similar to the one
+used by web browsers, which triggers an action when clicked. It is useful
+to show quick links to resources.
+</para>
+
+<para>
+A link button is created by calling either gtk_link_button_new() or
+gtk_link_button_new_with_label(). If using the former, the URI you pass
+to the constructor is used as a label for the widget.
+</para>
+
+<para>
+The URI bound to a #GtkLinkButton can be set specifically using
+gtk_link_button_set_uri(), and retrieved using gtk_link_button_get_uri().
+</para>
+
+<para>
+#GtkLinkButton offers a global hook, which is called when the used clicks
+on it: see gtk_link_button_set_uri_hook().
+</para>
+
+<para>
+#GtkLinkButton was added in GTK+ 2.10.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+#GtkButton
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkLinkButton ##### -->
+<para>
+The #GtkLinkButton struct contains private data only, and should be
+manipulated using the functions below.
+</para>
+
+
+<!-- ##### ARG GtkLinkButton:uri ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION gtk_link_button_new ##### -->
+<para>
+
+</para>
+
+@uri: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_link_button_new_with_label ##### -->
+<para>
+
+</para>
+
+@uri: 
+@label: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_link_button_get_uri ##### -->
+<para>
+
+</para>
+
+@link_button: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_link_button_set_uri ##### -->
+<para>
+
+</para>
+
+@link_button: 
+@uri: 
+
+
+<!-- ##### USER_FUNCTION GtkLinkButtonUriFunc ##### -->
+<para>
+The type of a function which is called when the #GtkLinkButton is
+clicked.
+</para>
+
+@button: the #GtkLinkButton which was clicked
+@link: the URI to which the clicked #GtkLinkButton points
+@user_data: 
+<!-- # Unused Parameters # -->
+@data: user data that was passed when the function was registered
+  with gtk_link_button_set_uri_hook()
+
+
+<!-- ##### FUNCTION gtk_link_button_set_uri_hook ##### -->
+<para>
+
+</para>
+
+@func: 
+@data: 
+@destroy: 
+@Returns: 
+
+

docs/reference/gtk/tmpl/gtkliststore.sgml

@@ -189,8 +189,6 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 @list_store: 
 @iter: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@store: 
 
 
 <!-- ##### FUNCTION gtk_list_store_insert ##### -->
@@ -201,8 +199,6 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 @list_store: 
 @iter: 
 @position: 
-<!-- # Unused Parameters # -->
-@store: 
 
 
 <!-- ##### FUNCTION gtk_list_store_insert_before ##### -->
@@ -213,8 +209,6 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 @list_store: 
 @iter: 
 @sibling: 
-<!-- # Unused Parameters # -->
-@store: 
 
 
 <!-- ##### FUNCTION gtk_list_store_insert_after ##### -->
@@ -225,8 +219,6 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 @list_store: 
 @iter: 
 @sibling: 
-<!-- # Unused Parameters # -->
-@store: 
 
 
 <!-- ##### FUNCTION gtk_list_store_insert_with_values ##### -->
@@ -260,8 +252,6 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 
 @list_store: 
 @iter: 
-<!-- # Unused Parameters # -->
-@store: 
 
 
 <!-- ##### FUNCTION gtk_list_store_append ##### -->
@@ -271,8 +261,6 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 
 @list_store: 
 @iter: 
-<!-- # Unused Parameters # -->
-@store: 
 
 
 <!-- ##### FUNCTION gtk_list_store_clear ##### -->

docs/reference/gtk/tmpl/gtkmain.sgml

@@ -173,6 +173,7 @@ for GTK+.
 target system but at least on Unix systems %0 means success.
 @Deprecated: Use the standard exit() function instead.
 
+
 <!-- ##### FUNCTION gtk_events_pending ##### -->
 <para>
 Checks if any events are pending. This can be used to update the GUI 
@@ -620,7 +621,6 @@ it again).
 @Deprecated: 2.4: This macro is deprecated. You should use %GDK_PRIORITY_REDRAW instead.
 
 
-
 <!-- ##### MACRO GTK_PRIORITY_RESIZE ##### -->
 <para>
 Use this priority for resizing related stuff. It is used internally by
@@ -640,7 +640,6 @@ inside the toolkit.
 @Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_HIGH instead.
 
 
-
 <!-- ##### MACRO GTK_PRIORITY_INTERNAL ##### -->
 <para>
 This priority is for GTK+ internal stuff. Don't use it in your applications.
@@ -656,7 +655,6 @@ Default priority for idle functions.
 @Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_DEFAULT_IDLE instead.
 
 
-
 <!-- ##### MACRO GTK_PRIORITY_LOW ##### -->
 <para>
 Priority for very unimportant background tasks.
@@ -665,7 +663,6 @@ Priority for very unimportant background tasks.
 @Deprecated: 2.4: This macro is deprecated. You should use %G_PRIORITY_LOW instead.
 
 
-
 <!-- ##### FUNCTION gtk_key_snooper_install ##### -->
 <para>
 Installs a key snooper function, which will get called on all key events

docs/reference/gtk/tmpl/gtkmenu.sgml

@@ -124,6 +124,11 @@ should be accessed using the functions below.
 
 </para>
 
+<!-- ##### ARG GtkMenu:double-arrows ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkMenu:horizontal-offset ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtkmenubar.sgml

@@ -70,6 +70,7 @@ Adds a new #GtkMenuItem to the beginning of the GtkMenuBar
 @child: the #GtkMenuItem to add
 @Deprecated: Use gtk_menu_shell_prepend() instead.
 
+
 <!-- ##### MACRO gtk_menu_bar_insert ##### -->
 <para>
 Adds a new #GtkMenuItem to the GtkMenuBar at the position defined by @position

docs/reference/gtk/tmpl/gtkmessagedialog.sgml

@@ -71,11 +71,36 @@ You might do a non-modal #GtkMessageDialog as follows:
 
 </para>
 
+<!-- ##### ARG GtkMessageDialog:image ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkMessageDialog:message-type ##### -->
 <para>
 
 </para>
 
+<!-- ##### ARG GtkMessageDialog:secondary-text ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMessageDialog:secondary-use-markup ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMessageDialog:text ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkMessageDialog:use-markup ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkMessageDialog:message-border ##### -->
 <para>
 
@@ -95,6 +120,7 @@ The type of message being displayed in the dialog.
 @GTK_MESSAGE_WARNING: Nonfatal warning message
 @GTK_MESSAGE_QUESTION: Question requiring a choice
 @GTK_MESSAGE_ERROR: Fatal error message
+@GTK_MESSAGE_OTHER: 
 
 <!-- ##### ENUM GtkButtonsType ##### -->
 <para>
@@ -147,6 +173,15 @@ then call gtk_dialog_add_buttons().
 @str: 
 
 
+<!-- ##### FUNCTION gtk_message_dialog_set_image ##### -->
+<para>
+
+</para>
+
+@dialog: 
+@image: 
+
+
 <!-- ##### FUNCTION gtk_message_dialog_format_secondary_text ##### -->
 <para>
 

docs/reference/gtk/tmpl/gtknotebook.sgml

@@ -46,7 +46,6 @@ will be a popup menu allowing the users to switch pages.
 
 @notebook: the object which received the signal.
 @arg1: 
-<!-- # Unused Parameters # -->
 @Returns: 
 
 <!-- ##### SIGNAL GtkNotebook::focus-tab ##### -->
@@ -66,6 +65,33 @@ will be a popup menu allowing the users to switch pages.
 @notebook: the object which received the signal.
 @arg1: 
 
+<!-- ##### SIGNAL GtkNotebook::page-added ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@widget: 
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::page-removed ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@widget: 
+@arg1: 
+
+<!-- ##### SIGNAL GtkNotebook::page-reordered ##### -->
+<para>
+
+</para>
+
+@notebook: the object which received the signal.
+@widget: 
+@arg1: 
+
 <!-- ##### SIGNAL GtkNotebook::reorder-tab ##### -->
 <para>
 
@@ -73,7 +99,8 @@ will be a popup menu allowing the users to switch pages.
 
 @notebook: the object which received the signal.
 @arg1: 
-@: 
+@Param3: 
+@Returns: 
 
 <!-- ##### SIGNAL GtkNotebook::select-page ##### -->
 <para>
@@ -93,33 +120,6 @@ Emitted when the user or a function changes the current page.
 @page: the new current page
 @page_num: the index of the page
 
-<!-- ##### SIGNAL GtkNotebook::tab-added ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkNotebook::tab-removed ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1: 
-@arg2: 
-
-<!-- ##### SIGNAL GtkNotebook::tab-reordered ##### -->
-<para>
-
-</para>
-
-@notebook: the object which received the signal.
-@arg1: 
-@arg2: 
-
 <!-- ##### ARG GtkNotebook:enable-popup ##### -->
 <para>
 
@@ -215,6 +215,11 @@ Emitted when the user or a function changes the current page.
 
 </para>
 
+<!-- ##### ARG GtkNotebook:arrow-spacing ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkNotebook:has-backward-stepper ##### -->
 <para>
 
@@ -576,7 +581,7 @@ gtk_notebook_set_current_page() instead.
 
 @notebook: 
 @child: 
-@reorderable: 
+@detachable: 
 
 
 <!-- ##### FUNCTION gtk_notebook_get_menu_label_text ##### -->
@@ -708,5 +713,6 @@ If the function returns %NULL, the drag will be cancelled.
 
 @func: 
 @data: 
+@destroy: 
 
 

docs/reference/gtk/tmpl/gtkpagesetup.sgml

@@ -0,0 +1,251 @@
+<!-- ##### SECTION Title ##### -->
+GtkPageSetup
+
+<!-- ##### SECTION Short_Description ##### -->
+Stores page setup information
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+A GtkPageSetup object stores the page size, orientation and margins. 
+The idea is that you can get one of these from the page setup dialog 
+and then pass it to the #GtkPrintOperation when printing. 
+The benefit of splitting this out of the #GtkPrintSettings is that 
+these affect the actual layout of the page, and thus need to be set 
+long before user prints. 
+</para>
+<para id="print-margins">
+The margins specified in this object are the "print margins", i.e. the 
+parts of the page that the printer cannot print on. These are different
+from the layout margins that a word processor uses; they are typically
+used to determine the <emphasis>minimal</emphasis> size for the layout 
+margins.
+</para>
+<para>
+To obtain a #GtkPageSetup use gtk_page_setup_new()
+to get the defaults, or use gtk_print_run_page_setup_dialog() to show 
+the page setup dialog and receive the resulting page setup.
+</para>
+<example>
+<title>A page setup dialog</title>
+<programlisting>
+static GtkPrintSettings *settings = NULL;
+static GtkPageSetup *page_setup = NULL;
+
+static void
+do_page_setup (void)
+{
+  GtkPageSetup *new_page_setup;
+
+  if (settings == NULL)
+    settings = gtk_print_settings_new (<!-- -->);
+
+  new_page_setup = gtk_print_run_page_setup_dialog (GTK_WINDOW (main_window),
+                                                    page_setup, settings);
+
+  if (page_setup)
+    g_object_unref (page_setup);
+
+  page_setup = new_page_setup;
+}
+</programlisting>
+</example>
+<para>
+Printing support was added in GTK+ 2.10.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkPageSetup ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_page_setup_new ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_copy ##### -->
+<para>
+
+</para>
+
+@other: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_orientation ##### -->
+<para>
+
+</para>
+
+@setup: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_orientation ##### -->
+<para>
+
+</para>
+
+@setup: 
+@orientation: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_paper_size ##### -->
+<para>
+
+</para>
+
+@setup: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_paper_size ##### -->
+<para>
+
+</para>
+
+@setup: 
+@size: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_top_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_top_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@margin: 
+@unit: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_bottom_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_bottom_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@margin: 
+@unit: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_left_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_left_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@margin: 
+@unit: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_right_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_right_margin ##### -->
+<para>
+
+</para>
+
+@setup: 
+@margin: 
+@unit: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_set_paper_size_and_default_margins ##### -->
+<para>
+
+</para>
+
+@setup: 
+@size: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_paper_width ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_paper_height ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_page_width ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_get_page_height ##### -->
+<para>
+
+</para>
+
+@setup: 
+@unit: 
+@Returns: 
+
+

docs/reference/gtk/tmpl/gtkpagesetupunixdialog.sgml

@@ -0,0 +1,79 @@
+<!-- ##### SECTION Title ##### -->
+GtkPageSetupUnixDialog
+
+<!-- ##### SECTION Short_Description ##### -->
+A page setup dialog
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+GtkPageSetupUnixDialog implements a page setup dialog for platforms
+which don't provide a native page setup dialog, like Unix. It can
+be used very much like any other GTK+ dialog, at the cost of
+the portability offered by the <link
+linkend="gtk-High-level-Printing-API">high-level printing API</link>
+</para>
+
+<para>
+Printing support was added in GTK+ 2.10.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkPageSetupUnixDialog ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_page_setup_unix_dialog_new ##### -->
+<para>
+
+</para>
+
+@title: 
+@parent: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_unix_dialog_set_page_setup ##### -->
+<para>
+
+</para>
+
+@dialog: 
+@page_setup: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_unix_dialog_get_page_setup ##### -->
+<para>
+
+</para>
+
+@dialog: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_unix_dialog_set_print_settings ##### -->
+<para>
+
+</para>
+
+@dialog: 
+@print_settings: 
+
+
+<!-- ##### FUNCTION gtk_page_setup_unix_dialog_get_print_settings ##### -->
+<para>
+
+</para>
+
+@dialog: 
+@Returns: 
+
+

docs/reference/gtk/tmpl/gtkpapersize.sgml

@@ -0,0 +1,274 @@
+<!-- ##### SECTION Title ##### -->
+GtkPaperSize
+
+<!-- ##### SECTION Short_Description ##### -->
+Support for named paper sizes
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+GtkPaperSize handles paper sizes. It uses the standard called 
+"PWG 5101.1-2002 PWG: Standard for Media Standardized Names" 
+<!-- FIXME link here -->
+to name the paper sizes (and to get the data for the page sizes).
+In addition to standard paper sizes, GtkPaperSize allows to
+construct custom paper sizes with arbitrary dimensions.
+</para>
+<para>
+The #GtkPaperSize object stores not only the dimensions (width
+and height) of a paper size and its name, it also provides
+default <link linkend="print-margins">print margins</link>.
+</para>
+
+<para>
+Printing support has been added in GTK+ 2.10.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+#GtkPageSetup
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkPaperSize ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM GtkUnit ##### -->
+<para>
+
+</para>
+
+@GTK_UNIT_PIXEL: 
+@GTK_UNIT_POINTS: 
+@GTK_UNIT_INCH: 
+@GTK_UNIT_MM: 
+
+<!-- ##### MACRO GTK_PAPER_NAME_A3 ##### -->
+<para>
+Name for the A4 paper size.
+</para>
+
+
+
+<!-- ##### MACRO GTK_PAPER_NAME_A4 ##### -->
+<para>
+Name for the A4 paper size.
+</para>
+
+
+
+<!-- ##### MACRO GTK_PAPER_NAME_A5 ##### -->
+<para>
+Name for the A5 paper size.
+</para>
+
+
+
+<!-- ##### MACRO GTK_PAPER_NAME_B5 ##### -->
+<para>
+Name for the B5 paper size.
+</para>
+
+
+
+<!-- ##### MACRO GTK_PAPER_NAME_LETTER ##### -->
+<para>
+Name for the Letter paper size.
+</para>
+
+
+
+<!-- ##### MACRO GTK_PAPER_NAME_EXECUTIVE ##### -->
+<para>
+Name for the Executive paper size.
+</para>
+
+
+
+<!-- ##### MACRO GTK_PAPER_NAME_LEGAL ##### -->
+<para>
+Name for the Legal paper size.
+</para>
+
+
+
+<!-- ##### FUNCTION gtk_paper_size_new ##### -->
+<para>
+
+</para>
+
+@name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_new_from_ppd ##### -->
+<para>
+
+</para>
+
+@ppd_name: 
+@ppd_display_name: 
+@width: 
+@height: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_new_custom ##### -->
+<para>
+
+</para>
+
+@name: 
+@display_name: 
+@width: 
+@height: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_copy ##### -->
+<para>
+
+</para>
+
+@other: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_free ##### -->
+<para>
+
+</para>
+
+@size: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_is_equal ##### -->
+<para>
+
+</para>
+
+@size1: 
+@size2: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_name ##### -->
+<para>
+
+</para>
+
+@size: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_display_name ##### -->
+<para>
+
+</para>
+
+@size: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_ppd_name ##### -->
+<para>
+
+</para>
+
+@size: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_width ##### -->
+<para>
+
+</para>
+
+@size: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_height ##### -->
+<para>
+
+</para>
+
+@size: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_is_custom ##### -->
+<para>
+
+</para>
+
+@size: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_set_size ##### -->
+<para>
+
+</para>
+
+@size: 
+@width: 
+@height: 
+@unit: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_default_top_margin ##### -->
+<para>
+
+</para>
+
+@size: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_default_bottom_margin ##### -->
+<para>
+
+</para>
+
+@size: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_default_left_margin ##### -->
+<para>
+
+</para>
+
+@size: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_default_right_margin ##### -->
+<para>
+
+</para>
+
+@size: 
+@unit: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_paper_size_get_default ##### -->
+<para>
+
+</para>
+
+@Returns: 
+
+

docs/reference/gtk/tmpl/gtkpreview.sgml

@@ -97,7 +97,7 @@ Create a new preview widget.
 
 @type: the type data contained by the widget. 
 (Grayscale or RGB)
-@Returns: 
+@Returns: a new #GtkPreview
 
 
 <!-- ##### FUNCTION gtk_preview_size ##### -->

docs/reference/gtk/tmpl/gtkprintcontext.sgml

@@ -0,0 +1,186 @@
+<!-- ##### SECTION Title ##### -->
+GtkPrintContext
+
+<!-- ##### SECTION Short_Description ##### -->
+Encapsulates context for drawing pages
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+A GtkPrintContext encapsulates context information that is required when
+drawing pages for printing, such as the cairo context and important 
+parameters like page size and resolution. It also lets you easily
+create #PangoLayout and #PangoContext objects that match the font metrics 
+of the cairo surface.
+</para>
+<para>
+GtkPrintContext objects gets passed to the ::begin-print, ::end-print, 
+::request-page-setup and ::draw-page signals on the #GtkPrintOperation.
+</para>
+
+<example>
+<title>Using GtkPrintContext in a ::draw-page callback</title>
+<programlisting>
+static void
+draw_page (GtkPrintOperation *operation,
+	   GtkPrintContext   *context,
+	   int                page_nr)
+{
+  cairo_t *cr;
+  PangoLayout *layout;
+  PangoFontDescription *desc;
+  
+  cr = gtk_print_context_get_cairo_context (context);
+
+  /* Draw a red rectangle, as wide as the paper (inside the margins) */
+  cairo_set_source_rgb (cr, 1.0, 0, 0);
+  cairo_rectangle (cr, 0, 0, gtk_print_context_get_width (context), 50);
+  
+  cairo_fill (cr);
+
+  /* Draw some lines */
+  cairo_move_to (cr, 20, 10);
+  cairo_line_to (cr, 40, 20);
+  cairo_arc (cr, 60, 60, 20, 0, M_PI);
+  cairo_line_to (cr, 80, 20);
+  
+  cairo_set_source_rgb (cr, 0, 0, 0);
+  cairo_set_line_width (cr, 5);
+  cairo_set_line_cap (cr, CAIRO_LINE_CAP_ROUND);
+  cairo_set_line_join (cr, CAIRO_LINE_JOIN_ROUND);
+  
+  cairo_stroke (cr);
+
+  /* Draw some text */ 
+  layout = gtk_print_context_create_layout (context);
+  pango_layout_set_text (layout, "Hello World! Printing is easy", -1);
+  desc = pango_font_description_from_string ("sans 28");
+  pango_layout_set_font_description (layout, desc);
+  pango_font_description_free (desc);
+
+  cairo_move_to (cr, 30, 20);
+  pango_cairo_layout_path (cr, layout);
+
+  /* Font Outline */
+  cairo_set_source_rgb (cr, 0.93, 1.0, 0.47);
+  cairo_set_line_width (cr, 0.5);
+  cairo_stroke_preserve (cr);
+
+  /* Font Fill */
+  cairo_set_source_rgb (cr, 0, 0.0, 1.0);
+  cairo_fill (cr);
+  
+  g_object_unref (layout);
+}
+</programlisting>
+</example>
+
+<para>
+Printing support was added in GTK+ 2.10.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT GtkPrintContext ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gtk_print_context_get_cairo_context ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_set_cairo_context ##### -->
+<para>
+
+</para>
+
+@context: 
+@cr: 
+@dpi_x: 
+@dpi_y: 
+
+
+<!-- ##### FUNCTION gtk_print_context_get_page_setup ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_get_width ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_get_height ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_get_dpi_x ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_get_dpi_y ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_get_pango_fontmap ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_create_pango_context ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+
+<!-- ##### FUNCTION gtk_print_context_create_pango_layout ##### -->
+<para>
+
+</para>
+
+@context: 
+@Returns: 
+
+