From ccdc2bdd3d03a6103e3659258192944f1b9bfe9f Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Tue, 8 Mar 2005 04:46:05 +0000 Subject: [PATCH] Apply patches by Stefan Kost to document naming restrictions. (#167614) 2005-03-07 Matthias Clasen * gobject/tmpl/gtype.sgml: * gobject/tmpl/param_value_types.sgml: * gobject/tmpl/gparamspec.sgml: Apply patches by Stefan Kost to document naming restrictions. (#167614) --- docs/reference/ChangeLog | 7 +++++++ docs/reference/gobject/tmpl/gparamspec.sgml | 5 +++++ docs/reference/gobject/tmpl/gtype.sgml | 8 +++++++- docs/reference/gobject/tmpl/param_value_types.sgml | 5 +++++ 4 files changed, 24 insertions(+), 1 deletion(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index e65d7c367..11873677c 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,10 @@ +2005-03-07 Matthias Clasen + + * gobject/tmpl/gtype.sgml: + * gobject/tmpl/param_value_types.sgml: + * gobject/tmpl/gparamspec.sgml: Apply patches by + Stefan Kost to document naming restrictions. (#167614) + 2005-02-28 Matthias Clasen * === Released 2.6.3 === diff --git a/docs/reference/gobject/tmpl/gparamspec.sgml b/docs/reference/gobject/tmpl/gparamspec.sgml index cbed37753..cb10458a7 100644 --- a/docs/reference/gobject/tmpl/gparamspec.sgml +++ b/docs/reference/gobject/tmpl/gparamspec.sgml @@ -9,6 +9,11 @@ Metadata for parameter specifications #GParamSpec is an object structure that encapsulates the metadata required to specify parameters, such as e.g. #GObject properties. + +Parameter names need to start with a letter (a-z or A-Z). Subsequent +characters can be letters, numbers or a '-'. +All other characters are replaced by a '-' during construction. + diff --git a/docs/reference/gobject/tmpl/gtype.sgml b/docs/reference/gobject/tmpl/gtype.sgml index fac09d658..d63b52f57 100644 --- a/docs/reference/gobject/tmpl/gtype.sgml +++ b/docs/reference/gobject/tmpl/gtype.sgml @@ -32,7 +32,13 @@ types called g_type_register_fundamental() which requires both a #GTypeInfo structure and a #GTypeFundamentalInfo structure but it is seldom used since most fundamental types are predefined rather than user-defined. - + +A final word about type names. +Such an identifier needs to be at least three characters long. There is no +upper length limit. The first character needs to be a letter (a-z or A-Z) +or an underscore '_'. Subsequent characters can be letters, numbers or +any of '-_+'. + diff --git a/docs/reference/gobject/tmpl/param_value_types.sgml b/docs/reference/gobject/tmpl/param_value_types.sgml index 29fe43c14..07f189689 100644 --- a/docs/reference/gobject/tmpl/param_value_types.sgml +++ b/docs/reference/gobject/tmpl/param_value_types.sgml @@ -13,6 +13,11 @@ Parameter specifications for most value types can be created as #GParamSpec derived instances, to implement e.g. #GObject properties which operate on #GValue containers. + +Parameter names need to start with a letter (a-z or A-Z). Subsequent +characters can be letters, numbers or a '-'. +All other characters are replaced by a '-' during construction. +