summaryrefslogtreecommitdiffstats
path: root/archive/py2cairo.xml
blob: 0eee1ad18885c68ed5a58b0df22272fddca95e9b (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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY py2cairo-download-http
           "http://cairographics.org/releases/py2cairo-&py2cairo-version;.tar.bz2">
  <!ENTITY py2cairo-download-ftp  " ">
  <!ENTITY py2cairo-md5sum        "20337132c4ab06c1146ad384d55372c5">
  <!ENTITY py2cairo-size          "400 KB">
  <!ENTITY py2cairo-buildsize     "3.6 MB">
  <!ENTITY py2cairo-time          "less than 0.1 SBU">
]>

  <!-- Begin Py2cairo -->
  <sect2 id="py2cairo" xreflabel="Py2cairo-&py2cairo-version;">

    <title>Py2cairo-&py2cairo-version;</title>

    <indexterm zone="py2cairo">
      <primary sortas="a-Py2cairo">Py2cairo</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to Py2cairo Module</title>

      <para>
        Py2cairo provides <application>Python 2</application> bindings to
        <application>Cairo</application>.
      </para>

      &lfs80_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&py2cairo-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download (FTP): <ulink url="&py2cairo-download-ftp;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &py2cairo-md5sum;
          </para>
        </listitem>
        <listitem>
          <para>
            Download size: &py2cairo-size;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated disk space required: &py2cairo-buildsize;
          </para>
        </listitem>
        <listitem>
          <para>
            Estimated build time: &py2cairo-time;
          </para>
        </listitem>
      </itemizedlist>

      <bridgehead renderas="sect4">Py2cairo Dependencies</bridgehead>

      <bridgehead renderas="sect5">Required</bridgehead>
      <para role="required">
        <xref linkend="python2"/> and
        <xref linkend="cairo"/>
      </para>

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <ulink url="http://pytest.org">pytest</ulink>
      </para>

      <para condition="html" role="usernotes">
        User Notes: <ulink url="&blfs-wiki;/py2cairo"/>
      </para>
    </sect3>

    <sect3 role="installation">
      <title>Installation of Py2cairo</title>

      <para>
        Install <application>Py2cairo</application> by running the following
        commands:
      </para>

<screen><userinput>./waf configure --prefix=/usr &amp;&amp;
./waf build</userinput></screen>

      <para>
        The test suite must be run after the package is installed.
      </para>

      <para>
        Now, as the <systemitem class="username">root</systemitem> user:
      </para>

<screen role="root"><userinput>./waf install</userinput></screen>

      <para>
        The test suite requires the optional <application>pytest</application>
        package. If installed, it is run by changing to the
        <filename class='directory'>test</filename> directory and running
        <command>py.test</command> as an unprivileged user.
      </para>
    </sect3>

    <sect3 role="content">
      <title>Contents</title>

      <segmentedlist>
        <segtitle>Installed Programs</segtitle>
        <segtitle>Installed Library</segtitle>
        <segtitle>Installed Directory</segtitle>

        <seglistitem>
          <seg>
            None
          </seg>
          <seg>
            _cairo.so
          </seg>
          <seg>
            /usr/include/pycairo and
            /usr/lib/python&python2-majorver;/site-packages/cairo
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>
  </sect2>
  <!-- End Py2cairo -->