[cairo-commit] cairo/doc/public .cvsignore, NONE, 1.1 Makefile.am, NONE, 1.1 cairo-docs.xml, NONE, 1.1 cairo-overrides.txt, NONE, 1.1 cairo-sections.txt, NONE, 1.1 cairo.types, NONE, 1.1

[Owen Taylor]

Committed by: otaylor

Update of /cvs/cairo/cairo/doc/public
In directory gabe:/tmp/cvs-serv29685/doc/public

Added Files:
	.cvsignore Makefile.am cairo-docs.xml cairo-overrides.txt 
	cairo-sections.txt cairo.types 
Log Message:
2005-01-27  Owen Taylor  <otaylor at redhat.com>

        * configure.in Makefile.am docs/Makefile.am docs/public/*:
        Add framework for doing docs via gtk-doc.

        * src/cairo.[ch] src/cairo-matrix.c: Add some inline docs
        for arcs and matrices.

        * gtk-doc.m4 acinclude.m4: Check in files from gtk-doc
        to make the dependency on gtk-doc optional.

        * autogen.sh (LANG): Add --enable-gtk-doc to the default
        args.


--- NEW FILE: .cvsignore ---
*.stamp
Makefile
Makefile.in
cairo-decl-list.txt
cairo-decl.txt
cairo-undocumented.txt
cairo-unused.txt
cairo.hierarchy
cairo.interfaces
cairo.prerequisites
cairo.args
cairo.signals
html
xml


--- NEW FILE: Makefile.am ---
## Process this file with automake to create Makefile.in.

AUTOMAKE_OPTIONS = 1.7

# The name of the module.
DOC_MODULE=cairo

# The top-level SGML file.
DOC_MAIN_SGML_FILE=cairo-docs.xml

# Extra options to supply to gtkdoc-scan
SCAN_OPTIONS=--deprecated-guards="CAIRO_DISABLE_DEPRECATED"

# The directory containing the source code. Relative to $(srcdir)
DOC_SOURCE_DIR=../../src

# Used for dependencies
HFILE_GLOB=$(top_srcdir)/src/*.h
CFILE_GLOB=$(top_srcdir)/src/*.c $(top_srcdir)/src/*.h

# Headers to ignore
IGNORE_HFILES= 			\
	cairo-features.h	\
	cairoft-private.h	\
	cairoint.h		\
	cairo-wideint.h

# CFLAGS and LDFLAGS for compiling scan program. Only needed
# if $(DOC_MODULE).types is non-empty.
INCLUDES =
GTKDOC_LIBS =

# Extra options to supply to gtkdoc-mkdb
MKDB_OPTIONS=--sgml-mode --output-format=xml

# Non-autogenerated SGML files to be included in $(DOC_MAIN_SGML_FILE)
content_files =

# Images to copy into HTML directory
HTML_IMAGES =

# Extra options to supply to gtkdoc-fixref
FIXXREF_OPTIONS=

include $(top_srcdir)/gtk-doc.make

--- NEW FILE: cairo-docs.xml ---
<?xml version='1.0' encoding='UTF-8'?> 
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
                "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<book lang="en"  id="libglade" xmlns:xi="http://www.w3.org/2003/XInclude"> 
<title>Cairo: A Vector Graphics Library</title>
  <part>
    <title>Tutorial</title>
  </part>				  
  <part>
    <title>Reference</title>
    <xi:include href="xml/cairo.xml"/>
    <xi:include href="xml/cairo-surface.xml"/>
    <xi:include href="xml/cairo-pattern.xml"/>
    <xi:include href="xml/cairo-matrix.xml"/>
    <xi:include href="xml/cairo-atsui.xml"/>
    <xi:include href="xml/cairo-ft.xml"/>
    <xi:include href="xml/cairo-glitz.xml"/>
    <xi:include href="xml/cairo-pdf.xml"/>
    <xi:include href="xml/cairo-png.xml"/>
    <xi:include href="xml/cairo-ps.xml"/>
    <xi:include href="xml/cairo-quartz.xml"/>
    <xi:include href="xml/cairo-xcb.xml"/>
    <xi:include href="xml/cairo-xlib.xml"/>
  </part>				  
</book>






--- NEW FILE: cairo-overrides.txt ---

--- NEW FILE: cairo-sections.txt ---
<SECTION>
<FILE>cairo-atsui</FILE>
<TITLE>ATSUI Fonts</TITLE>
cairo_atsui_font_create
</SECTION>

<SECTION>
<FILE>cairo-ft</FILE>
<TITLE>FreeType Fonts</TITLE>
cairo_ft_font_create
cairo_ft_font_create_for_ft_face
cairo_ft_font_lock_face
cairo_ft_font_unlock_face
cairo_ft_font_get_pattern
</SECTION>

<SECTION>
<FILE>cairo-glitz</FILE>
<TITLE>Glitz backend</TITLE>
cairo_set_target_glitz
cairo_glitz_surface_create
</SECTION>

<SECTION>
<FILE>cairo-pdf</FILE>
<TITLE>PDF Backend</TITLE>
cairo_set_target_pdf
cairo_pdf_surface_create
</SECTION>

<SECTION>
<FILE>cairo-png</FILE>
<TITLE>PNG Backend</TITLE>
cairo_set_target_png
cairo_png_surface_create
</SECTION>

<SECTION>
<FILE>cairo-ps</FILE>
<TITLE>PS Backend</TITLE>
cairo_set_target_ps
cairo_ps_surface_create
</SECTION>

<SECTION>
<FILE>cairo-quartz</FILE>
<TITLE>Quartz Backend</TITLE>
cairo_set_target_quartz_context
cairo_quartz_surface_create
</SECTION>

<SECTION>
<FILE>cairo-xcb</FILE>
<TITLE>XCB Backend</TITLE>
cairo_set_target_xcb
</SECTION>

<SECTION>
<FILE>cairo-xlib</FILE>
<TITLE>XLib Backend</TITLE>
cairo_set_target_drawable
cairo_xlib_surface_create
</SECTION>

<SECTION>
<FILE>cairo-surface</FILE>
<TITLE>cairo_surface_t</TITLE>
cairo_surface_t
cairo_surface_create_for_image
cairo_surface_create_similar
cairo_surface_reference
cairo_surface_destroy
cairo_surface_set_repeat
cairo_surface_set_matrix
cairo_surface_get_matrix
cairo_surface_set_filter
cairo_surface_get_filter
</SECTION>

<SECTION>
<FILE>cairo-pattern</FILE>
<TITLE>cairo_pattern_t</TITLE>
cairo_pattern_t
cairo_pattern_create_for_surface
cairo_pattern_create_linear
cairo_pattern_create_radial
cairo_pattern_reference
cairo_pattern_destroy
cairo_pattern_add_color_stop
cairo_pattern_set_matrix
cairo_pattern_get_matrix
cairo_extend_t
cairo_pattern_set_extend
cairo_pattern_get_extend
cairo_pattern_set_filter
cairo_pattern_get_filter
</SECTION>

<SECTION>
<FILE>cairo-matrix</FILE>
<TITLE>cairo_matrix_t</TITLE>
cairo_matrix_t
cairo_matrix_create
cairo_matrix_destroy
cairo_matrix_copy
cairo_matrix_set_identity
cairo_matrix_set_affine
cairo_matrix_get_affine
cairo_matrix_translate
cairo_matrix_scale
cairo_matrix_rotate
cairo_matrix_invert
cairo_matrix_multiply
cairo_matrix_transform_distance
cairo_matrix_transform_point
</SECTION>

<SECTION>
<FILE>cairo</FILE>
<TITLE>cairo_t</TITLE>
cairo_t
cairo_create
cairo_reference
cairo_destroy
cairo_save
cairo_restore
cairo_copy
cairo_set_target_surface
cairo_format_t
cairo_set_target_image
cairo_operator_t
cairo_set_operator
cairo_set_rgb_color
cairo_set_pattern
cairo_set_alpha
cairo_set_tolerance
cairo_fill_rule_t
cairo_set_fill_rule
cairo_set_line_width
cairo_line_cap_t
cairo_set_line_cap
cairo_line_join_t
cairo_set_line_join
cairo_set_dash
cairo_set_miter_limit
cairo_translate
cairo_scale
cairo_rotate
cairo_concat_matrix
cairo_set_matrix
cairo_default_matrix
cairo_identity_matrix
cairo_transform_point
cairo_transform_distance
cairo_inverse_transform_point
cairo_inverse_transform_distance
cairo_new_path
cairo_move_to
cairo_line_to
cairo_curve_to
cairo_arc
cairo_arc_negative
cairo_rel_move_to
cairo_rel_line_to
cairo_rel_curve_to
cairo_rectangle
cairo_close_path
cairo_stroke
cairo_fill
cairo_copy_page
cairo_show_page
cairo_in_stroke
cairo_in_fill
cairo_stroke_extents
cairo_fill_extents
cairo_init_clip
cairo_clip
cairo_font_t
cairo_glyph_t
cairo_text_extents_t
cairo_font_extents_t
cairo_font_slant_t
cairo_font_weight_t
cairo_select_font
cairo_scale_font
cairo_transform_font
cairo_show_text
cairo_show_glyphs
cairo_current_font
cairo_current_font_extents
cairo_set_font
cairo_text_extents
cairo_glyph_extents
cairo_text_path
cairo_glyph_path
cairo_font_reference
cairo_font_destroy
cairo_font_glyph_extents
cairo_show_surface
cairo_current_operator
cairo_current_rgb_color
cairo_current_pattern
cairo_current_alpha
cairo_current_tolerance
cairo_current_point
cairo_current_fill_rule
cairo_current_line_width
cairo_current_line_cap
cairo_current_line_join
cairo_current_miter_limit
cairo_current_matrix
cairo_current_target_surface
cairo_current_path
cairo_current_path_flat
cairo_status_t
cairo_status
cairo_status_string
cairo_filter_t
cairo_image_surface_create
cairo_image_surface_create_for_data
<SUBSECTION Private>
CAIRO_BEGIN_DECLS
CAIRO_END_DECLS
cairo_get_operator
cairo_get_rgb_color
cairo_get_alpha
cairo_get_tolerance
cairo_get_current_point
cairo_get_fill_rule
cairo_get_line_width
cairo_get_line_cap
cairo_get_line_join
cairo_get_miter_limit
cairo_get_matrix
cairo_get_target_surface
cairo_get_status
cairo_get_status_string
</SECTION>

--- NEW FILE: cairo.types ---