summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorChristian Dywan <christian@lanedo.com>2010-04-28 21:28:06 +0200
committerJavier Jardón <jjardon@gnome.org>2010-06-28 23:38:03 +0200
commit655dcff09622777765f32d84549a7779c78147a5 (patch)
tree37a9ba76ab0c4bb7be5cf1c0fe20fe104071ec6d /docs
parent34573b53f3926c2081bcce585f5e99680fb874a6 (diff)
downloadgtk+-655dcff09622777765f32d84549a7779c78147a5.tar.gz
Remove deprecated GdkFont
Fixes https://bugzilla.gnome.org/show_bug.cgi?id=604196 Signed-off-by: Javier Jardón <jjardon@gnome.org>
Diffstat (limited to 'docs')
-rw-r--r--docs/reference/gdk/gdk3-sections.txt23
-rw-r--r--docs/reference/gdk/tmpl/fonts.sgml334
2 files changed, 0 insertions, 357 deletions
diff --git a/docs/reference/gdk/gdk3-sections.txt b/docs/reference/gdk/gdk3-sections.txt
index 35b29e1640..2e062f2377 100644
--- a/docs/reference/gdk/gdk3-sections.txt
+++ b/docs/reference/gdk/gdk3-sections.txt
@@ -74,7 +74,6 @@ gdk_extension_mode_get_type
gdk_fill_get_type
gdk_fill_rule_get_type
gdk_filter_return_get_type
-gdk_font_type_get_type
gdk_function_get_type
gdk_gc_values_mask_get_type
gdk_grab_ownership_get_type
@@ -395,28 +394,6 @@ gdk_color_get_type
</SECTION>
<SECTION>
-<TITLE>Fonts</TITLE>
-<FILE>fonts</FILE>
-GdkFont
-GdkFontType
-gdk_font_load
-gdk_fontset_load
-gdk_fontset_load_for_display
-gdk_font_get_display
-gdk_font_ref
-gdk_font_unref
-gdk_font_id
-gdk_font_equal
-
-<SUBSECTION Standard>
-GDK_TYPE_FONT
-GDK_TYPE_FONT_TYPE
-
-<SUBSECTION Private>
-gdk_font_get_type
-</SECTION>
-
-<SECTION>
<TITLE>Drawing Primitives</TITLE>
<FILE>drawing</FILE>
GdkDrawable
diff --git a/docs/reference/gdk/tmpl/fonts.sgml b/docs/reference/gdk/tmpl/fonts.sgml
deleted file mode 100644
index 2e693961fe..0000000000
--- a/docs/reference/gdk/tmpl/fonts.sgml
+++ /dev/null
@@ -1,334 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Fonts
-
-<!-- ##### SECTION Short_Description ##### -->
-Loading and manipulating fonts
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GdkFont data type represents a font for drawing on
-the screen. These functions provide support for
-loading fonts, and also for determining the dimensions
-of characters and strings when drawn with a particular
-font.
-</para>
-
-<para>
-Fonts in X are specified by a
-<firstterm>X Logical Font Description</firstterm>.
-The following description is considerably simplified.
-For definitive information about XLFD's see the
-X reference documentation. A X Logical Font Description (XLFD)
-consists of a sequence of fields separated (and surrounded by) '-'
-characters. For example, Adobe Helvetica Bold 12 pt, has the
-full description:
-<informalexample><programlisting>
-"-adobe-helvetica-bold-r-normal--12-120-75-75-p-70-iso8859-1"
-</programlisting></informalexample>
-</para>
-
-<para>
-The fields in the XLFD are:
-
-<informaltable pgwide="1" frame="none">
-<tgroup cols="2"><colspec colwidth="2*"/><colspec colwidth="8*"/>
-<tbody>
-
-<row>
-<entry>Foundry</entry>
-<entry>the company or organization where the font originated.</entry>
-</row>
-
-<row>
-<entry>Family</entry>
-<entry>the font family (a group of related font designs).</entry>
-</row>
-
-<row>
-<entry>Weight</entry>
-<entry>A name for the font's typographic weight
-For example, 'bold' or 'medium').</entry>
-</row>
-
-<row>
-<entry>Slant</entry>
-<entry>The slant of the font. Common values are 'R' for Roman,
-'I' for italoc, and 'O' for oblique.</entry>
-</row>
-
-<row>
-<entry>Set Width</entry>
-<entry>A name for the width of the font. For example,
-'normal' or 'condensed'.</entry>
-</row>
-
-<row>
-<entry>Add Style</entry>
-<entry>Additional information to distinguish a font from
-other fonts of the same family.</entry>
-</row>
-
-<row>
-<entry>Pixel Size</entry>
-<entry>The body size of the font in pixels.</entry>
-</row>
-
-<row>
-<entry>Point Size</entry>
-<entry>The body size of the font in 10ths of a point.
-(A <firstterm>point</firstterm> is 1/72.27 inch) </entry>
-</row>
-
-<row>
-<entry>Resolution X</entry>
-<entry>The horizontal resolution that the font was designed for.</entry>
-</row>
-
-<row>
-<entry>Resolution Y</entry>
-<entry>The vertical resolution that the font was designed for .</entry>
-</row>
-
-<row>
-<entry>Spacing</entry>
-<entry>The type of spacing for the font - can be 'p' for proportional,
-'m' for monospaced or 'c' for charcell.</entry>
-</row>
-
-<row>
-<entry>Average Width</entry>
-<entry>The average width of a glyph in the font. For monospaced
-and charcell fonts, all glyphs in the font have this width</entry>
-</row>
-
-<row>
-<entry>Charset Registry</entry>
-<entry>The registration authority that owns the encoding for
-the font. Together with the Charset Encoding field, this
-defines the character set for the font.</entry>
-</row>
-
-<row>
-<entry>Charset Encoding</entry>
-<entry>An identifier for the particular character set encoding.</entry>
-</row>
-
-</tbody></tgroup></informaltable>
-</para>
-
-<para>
-When specifying a font via a X logical Font Description,
-'*' can be used as a wildcard to match any portion of
-the XLFD. For instance, the above example could
-also be specified as
-<informalexample><programlisting>
-"-*-helvetica-bold-r-normal--*-120-*-*-*-*-iso8859-1"
-</programlisting></informalexample>
-
-It is generally a good idea to use wildcards for any
-portion of the XLFD that your program does not care
-about specifically, since that will improve the
-chances of finding a matching font.
-</para>
-
-<para>
-A <firstterm>fontset</firstterm> is a list of fonts
-that is used for drawing international text that may
-contain characters from a number of different character
-sets. It is represented by a list of XLFD's.
-</para>
-
-<para>
-The font for a given character set is determined by going
-through the list of XLFD's in order. For each one, if
-the registry and and encoding fields match the desired
-character set, then that font is used, otherwise if
-the XLFD contains wild-cards for the registry and encoding
-fields, the registry and encoding for the desired character
-set are substituted in and a lookup is done. If a match is found
-that font is used. Otherwise, processing continues
-on to the next font in the list.
-</para>
-
-<para>
-The functions for determining the metrics of a string
-come in several varieties that can take a number
-of forms of string input:
-
-<variablelist>
- <varlistentry>
- <term>8-bit string</term>
- <listitem><para>
- When using functions like gdk_string_width() that
- take a <type>gchar *</type>, if the font is of type
- %GDK_FONT_FONT and is an 8-bit font, then each
- <type>gchar</type> indexes the glyphs in the font directly.
- </para></listitem>
- </varlistentry>
- <varlistentry>
- <term>16-bit string</term>
- <listitem><para>
- For functions taking a <type>gchar *</type>, if the
- font is of type %GDK_FONT_FONT, and is a 16-bit
- font, then the <type>gchar *</type> argument is
- interpreted as a <type>guint16 *</type> cast to
- a <type>gchar *</type> and each <type>guint16</type>
- indexes the glyphs in the font directly.
- </para></listitem>
- </varlistentry>
- <varlistentry>
- <term>Multibyte string</term>
- <listitem><para>
- For functions taking a <type>gchar *</type>, if the
- font is of type %GDK_FONT_FONTSET, then the input
- string is interpreted as a <firstterm>multibyte</firstterm>
- encoded according to the current locale. (A multibyte
- string is one in which each character may consist
- of one or more bytes, with different lengths for different
- characters in the string). The string will
- be rendered using one or more different fonts from
- the fontset.
- </para></listitem>
- </varlistentry>
-</variablelist>
-</para>
-
-<para>
-GDK provides functions to determine a number of different
-measurements (metrics) for a given string. (Need diagram
-here).
-
-<variablelist>
- <varlistentry>
- <term>ascent</term>
- <listitem><para>
- The vertical distance from the origin of the drawing
- opereration to the top of the drawn character.
- </para></listitem>
- </varlistentry>
- <varlistentry>
- <term>descent</term>
- <listitem><para>
- The vertical distance from the origin of the drawing
- opereration to the bottom of the drawn character.
- </para></listitem>
- </varlistentry>
- <varlistentry>
- <term>left bearing</term>
- <listitem><para>
- The horizontal distance from the origin of the drawing
- operation to the left-most part of the drawn character.
- </para></listitem>
- </varlistentry>
- <varlistentry>
- <term>right bearing</term>
- <listitem><para>
- The horizontal distance from the origin of the drawing
- operation to the right-most part of the drawn character.
- </para></listitem>
- </varlistentry>
- <varlistentry>
- <term>width bearing</term>
- <listitem><para>
- The horizontal distance from the origin of the drawing
- operation to the correct origin for drawing another
- string to follow the current one. Depending on the
- font, this could be greater than or less than the
- right bearing.
- </para></listitem>
- </varlistentry>
-</variablelist>
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GdkFont ##### -->
-<para>
-The <structname>GdkFont</structname> structure represents a font or fontset. It
-contains the following public fields. A new <structname>GdkFont</structname>
-structure is returned by gdk_font_load() or gdk_fontset_load(),
-and is reference counted with gdk_font_ref() and gdk_font_unref()
-</para>
-
-@type: a value of type #GdkFontType which indicates
- whether this font is a single font or a fontset.
-@ascent: the maximum distance that the font, when drawn,
- ascends above the baseline.
-@descent: the maximum distance that the font, when drawn,
-descends below the baseline.
-
-<!-- ##### ENUM GdkFontType ##### -->
-<para>
-Indicates the type of a font. The possible values
-are currently:
-</para>
-
-@GDK_FONT_FONT: the font is a single font.
-@GDK_FONT_FONTSET: the font is a fontset.
-
-<!-- ##### FUNCTION gdk_fontset_load ##### -->
-<para>
-</para>
-
-@fontset_name:
-@Returns:
-
-
-<!-- ##### FUNCTION gdk_fontset_load_for_display ##### -->
-<para>
-
-</para>
-
-@display:
-@fontset_name:
-@Returns:
-
-
-<!-- ##### FUNCTION gdk_font_get_display ##### -->
-<para>
-
-</para>
-
-@font:
-@Returns:
-
-
-<!-- ##### FUNCTION gdk_font_ref ##### -->
-<para>
-</para>
-
-@font:
-@Returns:
-
-
-<!-- ##### FUNCTION gdk_font_unref ##### -->
-<para>
-</para>
-
-@font:
-
-
-<!-- ##### FUNCTION gdk_font_id ##### -->
-<para>
-</para>
-
-@font:
-@Returns:
-
-
-<!-- ##### FUNCTION gdk_font_equal ##### -->
-<para>
-</para>
-
-@fonta:
-@fontb:
-@Returns: