summaryrefslogtreecommitdiff
path: root/doc/reference/librygel-server/gtkdoc/implementing-servers.xml
blob: ca9171c9b7605fe2dff7fcf80ac1df4783f5e93f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
<?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>