source: BOOK/final-system/common/gmp.xml @ 7349750

clfs-3.0.0-sysvinitsysvinit
Last change on this file since 7349750 was 5183e68, checked in by Chris Staub <chris@…>, 10 years ago

Updated gmp doc install instructions

  • Property mode set to 100644
File size: 3.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
8<sect1 id="ch-system-gmp" role="wrap">
9  <?dbhtml filename="gmp.html"?>
10
11  <title>GMP-&gmp-version;</title>
12
13  <indexterm zone="ch-system-gmp">
14    <primary sortas="a-GMP">GMP</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>GMP is a library for arithmetic on arbitrary precision integers,
21    rational numbers, and floating-point numbers.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of GMP</title>
27
28<!--
29    <para os="p1">The following patch contains a number of updates to the
30    &gmp-version; branch by the GMP developers:</para>
31
32<screen os="p2"><userinput>patch -Np1 -i ../&gmp-branch_update-patch;</userinput></screen>
33
34-->
35
36    <note os="n1">
37      <para>If you are compiling this package on a different CPU than you plan
38      to run the CLFS system on, you must replace GMP's
39      <filename>config.guess</filename> and <filename>config.sub</filename>
40      wrappers with the originals. This will prevent GMP from optimizing for
41      the wrong CPU. You can make this change with the following command:</para>
42
43<screen>mv -v config{fsf,}.guess
44mv -v config{fsf,}.sub</screen>
45
46    </note>
47
48    <para os="a">Prepare GMP for compilation:</para>
49
50<screen os="b"><userinput>CC="gcc -isystem /usr/include" \
51CXX="g++ -isystem /usr/include" \
52LDFLAGS="-Wl,-rpath-link,/usr/lib:/lib" \
53  ./configure --prefix=/usr --enable-cxx \
54  --docdir=/usr/share/doc/gmp-&gmp-version;</userinput></screen>
55
56    <para os="c">Compile the package:</para>
57
58<screen os="d"><userinput>make</userinput></screen>
59
60    <para os="e">Build the HTML documentation:</para>
61
62<screen os="f"><userinput>make html</userinput></screen>
63
64    <important os="g">
65      <para>The test suite for GMP is considered
66      critical. Do not skip it under any circumstance.</para>
67    </important>
68
69    <para os="h">Test the results:</para>
70
71<screen os="i"><userinput remap="test">make check</userinput></screen>
72
73    <para os="j">Install the package:</para>
74
75<screen os="k"><userinput>make install</userinput></screen>
76
77    <para os="l">Install the documentation:</para>
78
79<screen os="m"><userinput>make install-html</userinput></screen>
80
81  </sect2>
82
83  <sect2 id="contents-gmp" role="content">
84    <title>Contents of GMP</title>
85
86    <segmentedlist>
87      <segtitle>Installed libraries</segtitle>
88      <segtitle>Installed directory</segtitle>
89
90      <seglistitem>
91        <seg>libgmp.[a,so], libgmpxx.[a,so]</seg>
92        <seg>/usr/share/doc/gmp-&gmp-version;</seg>
93      </seglistitem>
94    </segmentedlist>
95
96    <variablelist>
97      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
98      <?dbfo list-presentation="list"?>
99      <?dbhtml list-presentation="table"?>
100
101      <varlistentry id="libgmp">
102        <term><filename class="libraryfile">libgmp</filename></term>
103        <listitem>
104          <para>Contains the definitions for GNU multiple precision functions.</para>
105          <indexterm zone="ch-system-gmp libgmp">
106            <primary sortas="c-libgmp">libgmp</primary>
107          </indexterm>
108        </listitem>
109      </varlistentry>
110
111      <varlistentry id="libgmpxx">
112        <term><filename class="libraryfile">libgmpxx</filename></term>
113        <listitem>
114          <para>Contains a C++ class wrapper for GMP types.</para>
115          <indexterm zone="ch-system-gmp libgmpxx">
116            <primary sortas="c-libgmpxx">libgmpxx</primary>
117          </indexterm>
118        </listitem>
119      </varlistentry>
120
121    </variablelist>
122
123  </sect2>
124
125</sect1>
Note: See TracBrowser for help on using the repository browser.