<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
]>

<chapter id="implementing-servers">
<title>Implementing Servers</title>

<section id="implementing-servers-overview">
<title>Implementing Servers: Overview</title>

<para>
This library may be used to create UPnP or DLNA servers via its <link linkend="RygelMediaServer">RygelMediaServer</link> class.
</para>

<para>The <link linkend="RygelMediaServer">RygelMediaServer</link> reference documentation 
and this example explains how to implement a server.
</para>

</section>

<section id="implementing-servers-simple-example">
<title>Implementing Servers: Simple Example</title>

<!-- TODO: Find a way to mention this C example code in the RygelMediaServer valadoc comments instead. -->
<para>
This example program shows how to fill a container with media items and then instantiate a server to serve 
them.
</para>

<!-- Do not indent the xi:include node. That puts spaces at the start of the code. -->
<programlisting role="C">
<xi:include  href="../../../../examples/standalone-server.c"
    parse="text"
    xmlns:xi="http://www.w3.org/2001/XInclude"/>
</programlisting>

</section>

</chapter>
