clean up headers + add manual title

git-svn-id: https://www.opensc-project.org/svnp/opensc/trunk@2216 c6295689-39f2-0310-b995-f0e70906c6a9
This commit is contained in:
bert 2005-03-01 23:18:24 +00:00
parent 923b4b5217
commit d8729db066
9 changed files with 47 additions and 12 deletions

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>
@ -36,5 +38,10 @@ int sc_disconnect_card(<link linkend="sccardt">sc_card_t</link> *card, int actio
The card is not reset nor powered down after the operation.
</para>
</refsect1>
<refsect1>
<title>Return value</title>
<para>Returns 0 if successful, or a negative value in case of error.</para>
</refsect1>
</refentry>

View File

@ -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>

View File

@ -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>

View File

@ -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>

View File

@ -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>
</para>
<refsect1>
<title>Return value</title>
<para>This function always return 0, indicating success.</para>
</refsect1>
</refentry>

View File

@ -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>