diff options
Diffstat (limited to 'test/docbook/source/funcsynopsis.xml')
| -rw-r--r-- | test/docbook/source/funcsynopsis.xml | 131 |
1 files changed, 131 insertions, 0 deletions
diff --git a/test/docbook/source/funcsynopsis.xml b/test/docbook/source/funcsynopsis.xml new file mode 100644 index 00000000..98f1a0d7 --- /dev/null +++ b/test/docbook/source/funcsynopsis.xml @@ -0,0 +1,131 @@ +<chapter xmlns="http://docbook.org/ns/docbook" + id="funcsynopsis"> +<title>Function Synopses</title> + +<section id="funcsynopsis-ansi"> +<title>ANSI Formatting</title> + +<para>Here's an example with two <sgmltag>modifier</sgmltag> elements:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style ANSI?> +<funcsynopsisinfo>// This is a funcsynopsisinfo</funcsynopsisinfo> +<funcprototype> + <modifier>static</modifier> + <modifier>SILLY</modifier> + <funcdef><type>Foo *</type> <function>foo_list_get_nth</function></funcdef> + <paramdef><type>FooList *</type><parameter>list</parameter></paramdef> + <paramdef>int <parameter>n</parameter></paramdef> +</funcprototype> +</funcsynopsis> + +<para>This example uses <sgmltag>void</sgmltag>:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style ANSI?> +<funcprototype> + <modifier>static</modifier> + <funcdef>void <function>foo_noop</function></funcdef> + <void/> +</funcprototype> +</funcsynopsis> + +<para>This example uses <sgmltag>varargs</sgmltag>:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style ANSI?> +<funcprototype> + <modifier>static</modifier> + <funcdef>void <function>foo_process_args</function></funcdef> + <paramdef><type>Foo *</type><parameter>foo</parameter></paramdef> + <varargs/> +</funcprototype> +</funcsynopsis> + +<para>This example places a <sgmltag>modifier</sgmltag> after the +<sgmltag>func</sgmltag>, for some strange reason:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style ANSI?> +<funcprototype> + <funcdef>void <function>foo_process_args</function></funcdef> + <paramdef><type>Foo *</type><parameter>foo</parameter></paramdef> + <varargs/> + <modifier>AFTER</modifier> +</funcprototype> +</funcsynopsis> + +<para>This example uses <sgmltag>funcparams</sgmltag>:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style ANSI?> +<funcprototype> + <funcdef>void <function>foo_list_foreach</function></funcdef> + <paramdef><type>FooList *</type><parameter>list</parameter></paramdef> + <paramdef>int (*<parameter>func</parameter>) <funcparams>Foo *, void *</funcparams></paramdef> + <paramdef>void *<parameter>user_data</parameter></paramdef> +</funcprototype> + +</funcsynopsis> + +</section> <!-- funcsynopsis-ansi --> + +<section id="funcsynopsis-kr"> +<title>K&R Formatting</title> + +<para>Here's an example with two <sgmltag>modifier</sgmltag> elements:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style KR?> +<funcsynopsisinfo>// This is a funcsynopsisinfo</funcsynopsisinfo> +<funcprototype> + <modifier>static</modifier> + <modifier>SILLY</modifier> + <funcdef><type>Foo *</type> <function>foo_list_get_nth</function></funcdef> + <paramdef><type>FooList *</type><parameter>list</parameter></paramdef> + <paramdef>int <parameter>n</parameter></paramdef> +</funcprototype> +</funcsynopsis> + +<para>This example uses <sgmltag>void</sgmltag>:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style KR?> +<funcprototype> + <modifier>static</modifier> + <funcdef>void <function>foo_noop</function></funcdef> + <void/> +</funcprototype> +</funcsynopsis> + +<para>This example uses <sgmltag>varargs</sgmltag>:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style KR?> +<funcprototype> + <modifier>static</modifier> + <funcdef>void <function>foo_process_args</function></funcdef> + <paramdef><type>Foo *</type><parameter>foo</parameter></paramdef> + <varargs/> +</funcprototype> +</funcsynopsis> + +<para>This example places a <sgmltag>modifier</sgmltag> after the +<sgmltag>func</sgmltag>, for some strange reason:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style KR?> +<funcprototype> + <funcdef>void <function>foo_process_args</function></funcdef> + <paramdef><type>Foo *</type><parameter>foo</parameter></paramdef> + <varargs/> + <modifier>AFTER</modifier> +</funcprototype> +</funcsynopsis> + +<para>This example uses <sgmltag>funcparams</sgmltag>:</para> +<funcsynopsis> +<?db2html.funcsynopsis.style KR?> +<funcprototype> + <funcdef>void <function>foo_list_foreach</function></funcdef> + <paramdef><type>FooList *</type><parameter>list</parameter></paramdef> + <paramdef>int (*<parameter>func</parameter>) <funcparams>Foo *, void *</funcparams></paramdef> + <paramdef>void *<parameter>user_data</parameter></paramdef> +</funcprototype> + +</funcsynopsis> + +</section> <!-- funcsynopsis-kr --> + +</chapter> |