aboutsummaryrefslogtreecommitdiffstats
path: root/archive/pycairo2.xml
blob: 94100019efa5d9864f39d0da2166730776ec7e48 (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
140
<?xml version="1.0" encoding="UTF-8"?>
<!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 pycairo2-download-http "https://github.com/pygobject/pycairo/releases/download/v&pycairo2-version;/pycairo-&pycairo2-version;.tar.gz">
  <!ENTITY pycairo2-download-ftp  " ">
  <!ENTITY pycairo2-md5sum        "be2ba51f234270dec340f28f1695a95e">
  <!ENTITY pycairo2-size          "196 KB">
  <!ENTITY pycairo2-buildsize     "2.3 MB">
  <!ENTITY pycairo2-time          "less than 0.1 SBU">
]>

  <!-- Begin PyCairo -->
  <sect2 id="pycairo2" xreflabel="PyCairo-&pycairo2-version;">

    <title>PyCairo-&pycairo2-version;</title>

    <indexterm zone="pycairo2">
      <primary sortas="a-PyCairo2">PyCairo2</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to PyCairo for Python2 Module</title>

      <para>
        This version of
        PyCairo provides <application>Python2</application> bindings to
        <application>Cairo</application>.
      </para>

      &lfs121_checked;

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

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

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

      <bridgehead renderas="sect5">Optional</bridgehead>
      <para role="optional">
        <ulink url="https://hypothesis.readthedocs.io">Hypothesis</ulink>
          (for tests)
      </para>

    </sect3>

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

      <note>
        <para>
           This version of PyCairo is only retained for packages such as <xref
           linkend="gimp"/> which is stuck on Python2 until Gimp-3 is released.
        </para>
      </note>

      <para>
        Install <application>PyCairo</application> for Python2 by
        running the following commands:
      </para>

<screen><userinput>python2 setup.py build</userinput></screen>

      <para>
        This package does not come with a test suite.
      </para>

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

<screen role="root"><userinput>python2 setup.py install --optimize=1   &amp;&amp;
python2 setup.py install_pycairo_header &amp;&amp;
python2 setup.py install_pkgconfig</userinput></screen>
    </sect3>

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

      <segmentedlist>
        <segtitle>Installed Program</segtitle>
        <segtitle>Installed Library</segtitle>
        <segtitle>Installed Directories</segtitle>

        <seglistitem>
          <seg>
            None
          </seg>
          <seg>
            <!--_cairo.so (python2) and -->
            _cairo.so
          </seg>
          <seg>
            /usr/include/pycairo,
            /usr/lib/python&python2-majorver;/site-packages/cairo,
            /usr/lib/python&python2-majorver;/site-packages/pycairo-&pycairo2-version;-py&python2-majorver;.egg,
          </seg>
        </seglistitem>
      </segmentedlist>
    </sect3>

  </sect2>