clean up headers + add manual title

git-svn-id: https://www.opensc-project.org/svnp/opensc/trunk@2216 c6295689-39f2-0310-b995-f0e70906c6a9

doc/src/api/init/sc_card_valid.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="sccardvalid">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_card_valid</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_card_valid(const <link linkend="sccardt">sc_card_t</link> *card);
 		</programlisting>

doc/src/api/init/sc_connect_card.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scconnectcard">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_connect_card</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_connect_card(sc_reader_t *reader, int slot, <link linkend="sccardt">sc_card_t</link> **card);
 		</programlisting>
@@ -40,4 +42,9 @@ int sc_connect_card(sc_reader_t *reader, int slot, <link linkend="sccardt">sc_ca
 		</para>
 	</refsect1>
 
+	<refsect1>
+		<title>Return value</title>
+		<para>Returns 0 if successful, or a negative value in case of error.</para>
+	</refsect1>
+
 </refentry>

doc/src/api/init/sc_detect_card_presence.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scdetectcardpresence">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_detect_card_presence</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_detect_card_presence(sc_reader_t *reader, int slot_id);
 		</programlisting>

doc/src/api/init/sc_disconnect_card.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scdisconnectcard">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_disconnect_card</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_disconnect_card(<link linkend="sccardt">sc_card_t</link> *card, int action);
 		</programlisting>
@@ -37,4 +39,9 @@ int sc_disconnect_card(<link linkend="sccardt">sc_card_t</link> *card, int actio
 		</para>
 	</refsect1>
 
+	<refsect1>
+		<title>Return value</title>
+		<para>Returns 0 if successful, or a negative value in case of error.</para>
+	</refsect1>
+
 </refentry>

doc/src/api/init/sc_establish_context.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scestablishcontext">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_establish_context</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_establish_context(sc_context_t **ctx,
                          const char *appname);
@@ -75,4 +77,9 @@ typedef struct sc_reader {
 		</para>
 	</refsect1>
 
+	<refsect1>
+		<title>Return value</title>
+		<para>Returns 0 if successful, or a negative value in case of error.</para>
+	</refsect1>
+
 </refentry>

doc/src/api/init/sc_get_cache_dir.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scgetcachedir">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_get_cache_dir</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_get_cache_dir(struct sc_context *ctx, char *buf, size_t bufsize);
 		</programlisting>

doc/src/api/init/sc_make_cache_dir.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scmakecachedir">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_make_cache_dir</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_make_cache_dir(struct sc_context *ctx);
 		</programlisting>

doc/src/api/init/sc_release_context.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="screleasecontext">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_release_context</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_release_context(sc_context_t *ctx);
 		</programlisting>
@@ -29,9 +31,11 @@ int sc_release_context(sc_context_t *ctx);
 			to <link linkend="scestablishcontext">sc_establish_context()</link>. No further calls to OpenSC
 			using this context are possible after this.
 		</para>
+	</refsect1>
 
-		<para>
+	<refsect1>
-		</para>
+		<title>Return value</title>
+		<para>This function always return 0, indicating success.</para>
 	</refsect1>
 
 </refentry>

doc/src/api/init/sc_set_card_driver.xml

@@ -1,4 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <refentry id="scsetcarddriver">
+	<refentryinfo><title>OpenSC API Reference</title></refentryinfo>
 	<refmeta>
 		<refentrytitle>sc_set_card_driver</refentrytitle>
 		<manvolnum>3</manvolnum>
@@ -14,7 +16,7 @@
 		<title>Synopsis</title>
 		<para>
 		<programlisting>
-&includes;
+#include &lt;opensc.h&gt;
 
 int sc_set_card_driver(struct sc_context *ctx, const char *short_name);
 		</programlisting>