gtk/docs/reference/ChangeLog

Thu Jun 21 12:31:29 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/gtk-sections.txt: Update a bit.

	* Makefile.am: build GTK+ docs. 

Fri Jun  8 12:33:29 2001  Jonathan Blandford  <jrb@redhat.com>

	* gtk/tmpl/gtktable.sgml: fix bug #55921

2001-06-05  Havoc Pennington  <hp@redhat.com>

	* gtk/tmpl/gtkscale.sgml: more docs

Tue Jun  5 10:54:48 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkenums.sgml: Improve docs for GtkStateType.
	(Fixes #55751, among other things.)

Mon Jun  4 15:08:21 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/gtk-overrides.txt: Remove GtkArgSetFunc, GtkArgGetFunc.

Wed May 30 16:56:07 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkrc.sgml (pattern): Correct typoe when
	describing order of composition. (#53371, Skip Montanaro)
	
2001-05-22  Havoc Pennington  <hp@pobox.com>

	* gtk/gtk-sections.txt: add gtk_bin_get_child

Fri May 18 12:28:08 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtksizegroup.sgml gtk/gtk-sections.txt gtk/gtk.types:
	Add documentation about GtkSizeGroup.

2001-05-11  Havoc Pennington  <hp@pobox.com>

	* gtk/tmpl/gtkvruler.sgml, 
	gtk/tmpl/gtkhruler.sgml: fix bug #54431

	* gtk/tmpl/gtkdrawingarea.sgml: fix bug #54331

	* gtk/tmpl/gtkenums.sgml: fix bug #54329, and 
	update some other random things

	* gtk/gtk-sections.txt: updates

	* gtk/tmpl/gtkmenuitem.sgml: fix bug #54277

	* gtk/tmpl/gtkradiomenuitem.sgml: fix bug #54323,
	#54324, #54325 

2001-04-26  Havoc Pennington  <hp@redhat.com>

	* gtk/tmpl/gtkimage.sgml: document GtkImageType

	* gtk/gtk-sections.txt: GtkImageType is public

	* gdk/tmpl/images.sgml: add warning about gtk_image_new_bitmap

Wed Apr 25 12:33:03 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtktreeitem.sgml: Add note about GTK_ENABLE_BROKEN.

Tue Apr 17 10:59:13 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/Makefile.am (GTKDOC_CFLAGS): Remove -DGTK_DISABLE_COMPAT
	add -DGTK_ENABLE_BROKEN

	* {gtk/gtk,gdk/gdk}-sections.txt: Updated

Fri Apr 13 10:41:10 2001  Owen Taylor  <otaylor@redhat.com>

	* */Makefile.am: Add $(top_builddir) to includes as necessary,
	Run gtkdoc-scangobj from builddir, not srcdir, don't distribute
	foo-doc.{top,bottom}, recomment in code to distribute HTML
	images, with shell fixes.

	* gtk/gtk.hierarchy gdk-pixbuf/gdk-pixbuf.{args,signals,hierarchy}:
	Remove generated files.
	
Wed Apr  4 01:26:04 2001  Tim Janik  <timj@gtk.org>

        * gdk-pixbuf/Makefile.am: disabled "for i in $(HTML_IMAGES) ;"
	dist-hook because $(HTML_IMAGES) is empty.
	* gtk/Makefile.am: same here.
	* gdk/Makefile.am: same here. touched gdk.types since make rules
	require it ;(

2001-03-29  Mike Kestner  <mkestner@ameritech.net>

	* gtk/tmpl/gtkspinbutton.html: killed function docs that are now
	inline.

2001-03-23  Havoc Pennington  <hp@redhat.com>

	* gdk/gdk-sections.txt: updates

	* gtk/gtk-sections.txt: updates

	* gtk/gtk-docs.sgml: mop up TreeModelSimple entity

	* gdk/gdk-docs.sgml: remove input method
	and input context docs

2001-03-22  Havoc Pennington  <hp@redhat.com>

	* gdk/tmpl/keys.sgml: docs on GdkKeymap

2001-03-16  Havoc Pennington  <hp@redhat.com>

	* gtk/gtk-docs.sgml: remove GtkData entity usage

2001-03-14  Havoc Pennington  <hp@redhat.com>

	* gtk/gtk-docs.sgml: remove gtkdata, gtktreemodelsimple

	* gtk/gtk.types: remove gtk_data_get_type

Wed Mar  7 23:58:53 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkwidget.sgml: Document ::hierarchy-changed.

Wed Mar  7 00:27:13 2001  Jonathan Blandford  <jrb@redhat.com>

	* gdk-pixbuf/Makefile.am (scan-build.stamp): add --nogtkinit.

Sat Mar  3 17:20:53 2001  Owen Taylor  <otaylor@redhat.com>

	* */Makefile.am (scan-build.stamp): You can't use
	+ as a metacharacter for basic regular expressions.
	(This was the "all objects disappear")

	* gdk/gdk-sections.txt gdk-pixbuf/gdk-pixbuf-sections.txt

	* */*-unused.sgml: Remove a lot of empty stuff. (No
	point in saving old docs when there aren't any.)

2001-02-20  Havoc Pennington  <hp@pobox.com>

	* gdk/tmpl/rgb.sgml: fix these docs to reflect the current state
	of affairs

2001-02-19  Havoc Pennington  <hp@pobox.com>

	* gdk/Makefile.am (SCAN_OPTIONS): add --deprecated-guards

	* gdk/gdk-sections.txt: update

	* gdk/gdk-docs.sgml: update

2001-02-18  Havoc Pennington  <hp@pobox.com>

	* gdk-pixbuf/Makefile.am (IGNORE_HFILES): add gdk-pixbuf-marshal.h

	* gdk-pixbuf/gdk-pixbuf-sections.txt: fixes

Sun Feb 11 22:16:34 2001  Owen Taylor  <otaylor@redhat.com>

	* */Makefile.am: Use the new snazzy mother-of-all-gtk-doc-makefiles.

	* gdk/tmpl/* gdk-pixbuf/tmpl/*: Recover a bunch of docs that were 
	lost at one point.

2001-02-08  Havoc Pennington  <hp@pobox.com>

	* gtk/windows.sgml: windows (file is blank)

	* gtk/framebuffer.sgml: framebuffer (file is blank)

	* gtk/compiling.sgml: how to use pkg-config, etc. (file is 
	blank for now)

2001-02-03  Havoc Pennington  <hp@pobox.com>

	* gtk/tmpl/gtkfixed.sgml: Add the intro docs section

2001-02-01  Havoc Pennington  <hp@redhat.com>

	* gtk/gtk-sections.txt: updated

	* gtk/gtk-docs.sgml: Move the below from "Deprecated" section to
	"special-purpose" section; move GtkItem out of deprecated section,
	since GtkMenuItem uses it, though probably the GtkItem signals
	should just migrate down to GtkMenuItem someday it won't happen
	for 2.0

	* gtk/tmpl/gtkgamma.sgml: add note about eventual removal

	* gtk/tmpl/gtkcurve.sgml: add note about eventual removal

	* gtk/tmpl/gtkruler.sgml: add note about eventual removal

	* gtk/tmpl/gtkhruler.sgml: add note about eventual removal

	* gtk/tmpl/gtkvruler.sgml: add note about eventual removal

	* gtk/tmpl/gtkinputdialog.sgml: add note about eventual removal

2001-01-30  Havoc Pennington  <hp@pobox.com>

        Also committed a bunch of automatic changes made by gtk-doc, 
	after reviewing for correctness.
	
	* gtk/tmpl/gtktext.sgml: add warning about deprecation and note
	about what to use instead

	* gtk/tmpl/gtktree.sgml: ditto

	* gtk/Makefile.am (scan): pass --deprecated-guards option to
	gtk-doc

	* gtk/gtk-docs.sgml: move GtkText to the deprecated section 
	instead of the GtkTextView section. Oops.

Tue Jan 30 16:01:54 2001  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkclist.sgml: Added note explaining how
	the @button parameter is off by 1. (#6739)

Mon Jan  8 15:21:15 2001  Owen Taylor  <otaylor@redhat.com>

	* Makefile.am (SUBDIRS): Restore build.

	* gdk/gdk-sections.txt gdk/gdk-docs.sgml 
	  gdk-pixbuf/gdk-pixbuf-sections.txt 
	  gtk/gtk-sections.txt gtk/gtk-docs.sgml: : Update.

	* */tmpl/*: Changes from update.

Wed Oct 25 15:19:40 2000  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtknotebook.sgml: Moved function docs into .c
	file, fairly extensive rewriting.

Thu Nov 30 00:53:45 2000  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkfilesel.sgml: Fix to say that file_selection_complete()
	filters both files and directories.

	* gtk/tmpl/gtktogglebutton.sgml: Fix description
	of gtk_toggle_button_toggled().

Fri Nov 17 17:31:30 2000  Owen Taylor  <otaylor@redhat.com>

	* gtk/Makefile.am (content_files): Add a couple
	of files.

Mon Nov 13 16:58:43 2000  Owen Taylor  <otaylor@redhat.com>

	* {gtk,gdk,gdk-pixbuf}/Makefile.am: cd to srcdir before
	calling gtkdoc-fixref, distribute index.sgml.

	* gtk/gtk-docs.sgml gtk/Makefile.am gtk/gtk-sections.txt
	gtk/gtk.types: Update

2000-11-05  Havoc Pennington  <hp@pobox.com>

	* gtk/tmpl/gtktexttag.sgml: documented some of the object args

	* gtk/text_widget.sgml: fixups

2000-11-04  Havoc Pennington  <hp@pobox.com>

	* gtk/gtk-sections.txt: Added a bunch of stuff from unused

2000-11-01  Havoc Pennington  <hp@redhat.com>

	* gtk/tmpl/gtkmessagedialog.sgml: Check in these docs, I seem to
	have written them a while ago then forgotten about them.

2000-11-01  Havoc Pennington  <hp@pobox.com>

	* gtk/gtk-sections.txt: Add new label functions

Sun Oct 29 02:59:50 2000  Owen Taylor  <otaylor@redhat.com>

	* **: Updates to new gtk-doc, gsignal, causing quite
	a bit of diffs but little real changes.

2000-10-24  Havoc Pennington  <hp@redhat.com>

	* gtk/text_widget.sgml: add note about UTF-8

2000-10-23  Havoc Pennington  <hp@redhat.com>

	* gtk/gtk-sections.txt: remove GtkTextBTree

	* gtk/text_widget.sgml: Overview of the text widget

	* gtk/gtk-docs.sgml: Change to using categories for the toplevel 
	organization of the reference entries. We'll add an alphabetical 
	index eventually. The category way is a lot easier for people who
	aren't familiar with the widgets. Removed objects_grouped.sgml 
	from gtk-docs.sgml for now, it doesn't seem useful anymore.

	* gtk/objects_grouped.sgml: Add a section for deprecated
	objects; add a section for the TextView object collection

Wed Oct 18 11:01:12 2000  Owen Taylor  <otaylor@redhat.com>

	* gtk/Makefile.am gdk-pixbuf/Makefile.am: Fix typo

2000-10-20  Havoc Pennington  <hp@redhat.com>

	* gtk/gtk-sections.txt: Add dialog docs

2000-10-18  Havoc Pennington  <hp@redhat.com>

	* gtk/gtk-sections.txt: Some updates

	* gdk/gdk-sections.txt: remove GdkPixbufAlphaMode

	* gdk-pixbuf/gdk-pixbuf-sections.txt: Add new API, remove 
	GdkPixbufClass/GdkAnimationClass since those are private

	* gdk-pixbuf/Makefile.am (IGNORE_HFILES): ignore more headers

2000-10-06  Havoc Pennington  <hp@redhat.com>

        * gdk-pixbuf/*.sgml, gdk-pixbuf/tmpl/*.sgml: copy in from 1.0
	
	* gdk-pixbuf/gdk-pixbuf-sections.txt: add Xlib sections from 1.0
	tree

	* gdk-pixbuf/Makefile.am: add stuff from 1.0 tree

	* gdk-pixbuf/compiling.sgml: copy from 1.0 tree

2000-09-26  Havoc Pennington  <hp@redhat.com>

	* gtk/tmpl/gtkrc.sgml: Document stock icon stuff

Thu Sep  7 14:15:03 2000  Owen Taylor  <otaylor@redhat.com>

        * gdk/* gtk/*: Move gtk-reference files into GTK+ tree proper.

	* Update sections.txt files to correspond to current code,
	tweak .sgml files and Makefiles to correspond.

	* gtk/tmpl/gtkradiomenuitem.sgml (this): Remove extra <para>

2000-06-14  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtktooltips.sgml: added a note about no-window widgets.

Mon Jun  5 11:17:25 2000  Owen Taylor  <otaylor@redhat.com>

	* gdk/tmpl/general.sgml: Fix gdk_pointer_grab description
	as pointed out by Dave Morse.

Sun May 28 12:16:01 2000  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkaspectframe.sgml: Fix typo
	pointed out by Gregory McLean.

2000-05-28  Damon Chaplin  <damon@helixcode.com>

	* gdk/tmpl/event_structs.sgml: typo.

2000-04-22  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtkenums.sgml: update from Lee Mallabone
	<lee0@callnetuk.com>

2000-04-09  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtkmain.sgml: update from Torsten Landschoff
	<t.landschoff@gmx.net>

	* gdk/tmpl/input_methods.sgml: 
	* gdk/tmpl/general.sgml: fixed typos.

Tue Mar 14 14:17:46 2000  Raph Levien  <raph@acm.org>

	* gdk/tmpl/rgb.sgml: Better explanation of gdk_rgb_set_min_colors.
	Thanks to Stric for spotting it.

2000-03-07  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtkclist.sgml: fix to gtk_clist_set_reorderable(). It
	reorders rows, not columns. From Guy Harris <gharris@flashcom.net>.

2000-02-29  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtkmenuitem.sgml: minor fix from Nicolas GEORGE
	<nicolas.george@ens.fr>.

2000-02-28  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtkradiomenuitem.sgml: 
	* gtk/tmpl/gtkmenuitem.sgml: 
	* gtk/tmpl/gtknotebook.sgml: new menu item sections and minor update to
	notebook section from Nicolas GEORGE <nicolas.george@ens.fr>.

2000-02-18  Damon Chaplin  <damon@helixcode.com>

	* gtk/tmpl/gtktooltips.sgml: patch from
	David Benson <daveb@idealab.com> to note that gtk_tooltips_set_colors()
	does not work.

2000-02-09  Damon Chaplin  <damon@helixcode.com>

	* gdk/tmpl/input_methods.sgml: minor fix.

2000-02-03  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gdk/gdk-sections.txt: rearranged a bit.

	* gdk/tmpl/event_structs.sgml: updated.

	* gtk/gtk-sections.txt: added INCLUDE tag for Private Info section.

	* gdk/tmpl/color_contexts.sgml: added note saying it is deprecated.
	* gdk/tmpl/dnd.sgml: added note saying read the GTK+ DnD docs.

2000-02-02  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gdk/tmpl/*.sgml: ran make templates.

	* gdk/gdk-docs.sgml: rearranged sections.

	* gdk/tmpl/events.sgml: documented.

	* gdk/tmpl/general.sgml: documented.

	* gdk/tmpl/rgb.sgml: fixed a few '@' -> '#'.

	* gdk/gdk-sections.txt: rearranged a few bits, including moving
	GdkWChar and related functions from the input method section to the
	font section, and GdkCapStyle etc. from Drawing Primitives to GCs.

	* gdk/tmpl/images.sgml: documented.

	* gdk/tmpl/drawing.sgml: updated.

	* gdk/tmpl/regions.sgml: updated.

	* gdk/tmpl/input_contexts.sgml: documented.

	* gdk/tmpl/input_methods.sgml: documented.

	* gdk/tmpl/selections.sgml: changed xref to a link since Jade says
	a xref to a RefEntry is not supported.

2000-01-19  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkscrollbar.sgml: Started.

2000-01-08  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkclist.sgml: update from Paul Schifferer
	<isengard@geocities.com>

Wed Jan  5 10:23:41 2000  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkprogress.sgml: Missing </listitem>, remove extra <para>
	* gtk/tmpl/gtkobject.sgml: dos2unix
	* gtk/tmpl/gtkcurve.sgml: missing </para>
	* gtk/tmpl/gtkarg.sgml: dos2unix, missing </para>
	* gtk/tmpl/gtkcolorsel.sgml: Missing </listitem>'s
	* gtk/tmpl/gtksignal.sgml (signal): dos2unix, missing </para>'s
	* gtk/tmpl/gtkmarshal.sgml: Missing </refsect2>

1999-11-16  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkmenubar.sgml: fixed minor error - using <em>.

	* gtk/tmpl/gtknotebook.sgml: 
	* gtk/tmpl/gtklist.sgml: new sections from
	Nicolas George <george@clipper.ens.fr>, with help from
	"Bob Springett"	<bobspringett@claranet.fr>.

	* gtk/tmpl/gtkobject.sgml: 
	* gtk/tmpl/gtkarg.sgml: new sections from
	David Benson <daveb@idealab.com>.

	* gtk/tmpl/gtkvbox.sgml: 
	* gtk/tmpl/gtkhbox.sgml: fixed line endings.

	* gtk/tmpl/gtkvbbox.sgml: update from Lee Mallabone
	<lee0@callnetuk.com>

	* gdk/tmpl/drawing.sgml: fixed error in gdk_draw_arc() @angle2 param
	- it is relative to @angle1 rather than from the 3 o'clock position.

	* gtk/tmpl/gtkfontseldlg.sgml: changed enums to use @ fields.

	* gtk/tmpl/gtkcolorsel.sgml: 
	* gtk/tmpl/gtkcolorseldlg.sgml: 
	* gtk/tmpl/gtkprogress.sgml: 
	* gtk/tmpl/gtkprogressbar.sgml: new sections from Tom Martone
	<tom@martoneconsulting.com>

	* gtk/tmpl/gtkclist.sgml: partially written documentation from
	Paul Schifferer <isengard@geocities.com> who won't be able to finish it

1999-09-22  Martin Norb<72>ck  <d95mback@dtek.chalmers.se>
	
	* gtk/tmpl/gtkclist.sgml: Added information about the sorting functions

Tue Oct 26 16:50:15 1999  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtkrc.sgml: Added information about widget
	paths and pattern matching.

1999-09-22  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/*.sgml: ran make templates, to fix problems with structs.

	* gtk/gtk-sections.txt: rearranged GtkCombo section.

	* gtk/tmpl/gtkvseparator.sgml: 
	* gtk/tmpl/gtkhseparator.sgml: 
	* gtk/tmpl/gtkgc.sgml: 
	* gtk/tmpl/gtkfeatures.sgml: 
	* gtk/tmpl/gtktipsquery.sgml: 
	* gtk/tmpl/gtkitem.sgml: 
	* gtk/tmpl/gtkinvisible.sgml: 
	* gtk/tmpl/gtkgamma.sgml: 
	* gtk/tmpl/gtkdata.sgml: 
	* gtk/tmpl/gtkcurve.sgml: 
	* gtk/tmpl/gtkcombo.sgml: 
	* gtk/tmpl/gtkaccellabel.sgml: documented.

1999-09-20  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/gtk-docs.sgml: added role="no-toc" to the GTK+ Widgets & Objects
	chapter since we've created our own special contents page.

1999-09-19  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkmarshal.sgml: 
	* gtk/tmpl/gtksignal.sgml: new sections from 
         David Benson <daveb@idealab.com>.

	* gtk/gtk-sections.txt: rearranged signal sections, and made most
	marshallers private. Moved GtkSignalRunType to signals section.

	* gtk/tmpl/gtkradiobutton.sgml: new section from Lee Mallabone.

1999-09-17  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/gtk-docs.sgml: removed menu factory and debugging sections.

	* gtk/gtk-sections.txt: made menu factory stuff private since it is
	deprecated. Also made debugging stuff private since it is only useful
	within GTK+.

1999-09-14  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkfilesel.sgml: fixed mismatched parentheses.

1999-09-02  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gdk/tmpl/event_structs.sgml: 
	* gdk/tmpl/drawing.sgml: minor fixes.

1999-09-20  David C. Mason  <dcm@redhat.com>

	* gtk/tmpl/gtkimage.sgml: first pass at gtkimage... not complete

1999-08-28  Damon Chaplin  <damon@karuna.freeserve.co.uk>

	* gtk/tmpl/gtkbbox.sgml: new section from Lee Mallabone.

	* gdk/gdk-sections.txt: rearranged rgb, regions, and drawing sections.

	* gdk/tmpl/rgb.sgml: new section from Raph Levien, with a few changes
	by me, including a little example app.

	* gdk/tmpl/regions.sgml: 
	* gdk/tmpl/event_structs.sgml: 
	* gdk/tmpl/drawing.sgml: my first attempt.
	* gdk/tmpl/cursors.sgml: tiny changes.

Tue Aug 17 09:14:01 1999  Owen Taylor  <otaylor@redhat.com>

	* gtk/tmpl/gtktypeutils.sgml: Fix corrupted end tag.

	* gtk/tmpl/gtkselection.sgml gtk/tmpl/gtkrc.sgml
	  gtk/tmpl/gtkdnd.sgml gtk/tmpl/gtkarrow.sgml
	  gtk/tmpl/gtkpaned.sgml gtk/tmpl/gtkmisc.sgml
	  gtk/tmpl/gtkhandlebox.sgml gtk/tmpl/gtkctree.sgml:
	Added missing close tags.

Thu Aug 19 14:43:08 1999  Owen Taylor  <otaylor@redhat.com>

	* gdk/tmpl/gcs.sgml gdk/gdk-sections.txt: Added section. 
	  (Written a while ago but fell through the cracks)

	* gtk/gtk-docs.sgml: Add a &hash; entity here as a
	  temporary hack. (There is no standard entity
	  for '#', and no way of escaping '#' in gtk-doc)

	* gtk/tmpl/gtkrc.sgml: Use the above to fix up #rrggbb
	  string literals.

	* gtk/tmpl/gtkdrawingarea.sgml: Fixed a couple
	  of errors in the example. (pointed out by
	  Nick Lamb)

Mon Aug 16 6:60:53 1999  Owen Taylor  <otaylor@redhat.com>

	* gdk/tmpl/properties.sgml
	  gdk/tmpl/selections.sgml
	  gdk/tmpl/input_devices.sgml: Documented

	* gdk/gdk-sections.txt: Moved around types for
	  input devices properties and selections, marked
	  a few functions as private.