[blfs-book] r12393 - in trunk/BOOK: . general/prog introduction/welcome

pierre at higgs.linuxfromscratch.org pierre at higgs.linuxfromscratch.org
Sat Dec 14 11:03:50 PST 2013


Author: pierre
Date: Sat Dec 14 11:03:50 2013
New Revision: 12393

Log:
Add SWIG package

Added:
   trunk/BOOK/general/prog/swig.xml   (contents, props changed)
Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/prog/prog.xml
   trunk/BOOK/introduction/welcome/changelog.xml

Modified: trunk/BOOK/general.ent
==============================================================================
--- trunk/BOOK/general.ent	Sat Dec 14 04:22:52 2013	(r12392)
+++ trunk/BOOK/general.ent	Sat Dec 14 11:03:50 2013	(r12393)
@@ -383,6 +383,7 @@
 <!ENTITY scons-version                "2.3.0">
 <!ENTITY slang-version                "2.2.4">
 <!ENTITY subversion-version           "1.8.5">
+<!ENTITY swig-version                 "2.0.11">
 <!ENTITY tcl-version                  "8.6.1">
 <!ENTITY tk-version                   "8.6.1">
 <!ENTITY vala-major-version           "0.22">  <!-- even minors only -->

Modified: trunk/BOOK/general/prog/prog.xml
==============================================================================
--- trunk/BOOK/general/prog/prog.xml	Sat Dec 14 04:22:52 2013	(r12392)
+++ trunk/BOOK/general/prog/prog.xml	Sat Dec 14 11:03:50 2013	(r12393)
@@ -52,6 +52,7 @@
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="slang.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="subversion.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="svnserver.xml"/>
+  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="swig.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tcl.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="tk.xml"/>
   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="vala.xml"/>

Added: trunk/BOOK/general/prog/swig.xml
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/BOOK/general/prog/swig.xml	Sat Dec 14 11:03:50 2013	(r12393)
@@ -0,0 +1,215 @@
+<?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 swig-download-http "&sourceforge-repo;/swig/swig-&swig-version;.tar.gz">
+  <!ENTITY swig-download-ftp  " ">
+  <!ENTITY swig-md5sum        "291ba57c0acd218da0b0916c280dcbae">
+  <!ENTITY swig-size          "5.06 MB">
+  <!ENTITY swig-buildsize     "80.5 MB (up to 1 GB for tests)">
+  <!ENTITY swig-time          "0.35 SBU (11 SBU for tests of Perl, Python, Lua, Ruby, Guile, tcl, and PHP)">
+]>
+
+<!-- Try to keep the indentation used in this file-->
+<sect1 id="swig" xreflabel="SWIG-&swig-version;">
+  <?dbhtml filename="swig.html"?>
+
+  <sect1info>
+    <othername>$LastChangedBy$</othername>
+    <date>$Date$</date>
+  </sect1info>
+
+  <!-- No other tags inside any title.
+       Use Title Case in All Titles -->
+  <title>SWIG-&swig-version;</title>
+
+  <indexterm zone="swig">
+    <primary sortas="a-swig">SWIG</primary>
+  </indexterm>
+
+  <!--Required section-->
+  <sect2 role="package">
+    <title>Introduction to SWIG</title>
+
+    <para>
+       <application>SWIG</application> (Simplified Wrapper and Interface
+       Generator) is a compiler that integrates <application>C</application>
+       and <application>C++</application> with languages including
+       <application>Perl</application>, <application>Python</application>,
+       <application>Tcl</application>, <application>Ruby</application>,
+       <application>PHP</application>, <application>Java</application>,
+       <application>C#</application>, <application>D</application>,
+       <application>Go</application>, <application>Lua</application>,
+       <application>Octave</application>, <application>R</application>,
+       <application>Scheme</application>, <application>Ocaml</application>,
+       <application>Modula-3</application>,
+       <application>Common Lisp</application>, and
+       <application>Pike</application>. <application>SWIG</application> can
+       also export its parse tree into <application>Lisp</application>
+       s-expressions and <application>XML</application>.
+    </para>
+    <para>
+       <application>SWIG</application> reads annotated
+       <application>C/C++</application> header files and creates wrapper
+       code (glue code) in order to make the corresponding
+       <application>C/C++</application> libraries available to the listed
+       languages, or to extend <application>C/C++</application> programs
+       with a scripting language.
+    </para>
+
+    &lfs74_checked;
+
+    <bridgehead renderas="sect3">Package Information</bridgehead>
+    <itemizedlist spacing="compact">
+      <listitem>
+        <para>
+          Download (HTTP): <ulink url="&swig-download-http;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download (FTP): <ulink url="&swig-download-ftp;"/>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download MD5 sum: &swig-md5sum;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Download size: &swig-size;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated disk space required: &swig-buildsize;
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Estimated build time: &swig-time;
+        </para>
+      </listitem>
+    </itemizedlist>
+
+    <bridgehead renderas="sect3">SWIG Dependencies</bridgehead>
+
+    <bridgehead renderas="sect4">Required</bridgehead>
+    <para role="required">
+      <xref linkend="pcre"/>
+    </para>
+
+    <bridgehead renderas="sect4">Optional</bridgehead>
+    <para role="optional">
+      <xref linkend="boost"/> for tests, and any of the languages mentionned
+      in the introduction, as run-time dependencies
+    </para>
+
+    <para condition="html" role="usernotes">
+      User Notes: <ulink url="&blfs-wiki;/swig"/>
+    </para>
+  </sect2>
+
+  <sect2 role="installation">
+    <title>Installation of SWIG</title>
+
+    <para>
+      Install <application>SWIG</application> by running the following
+      commands:
+    </para>
+
+<!-- Spaces are significant in <screen> sections -->
+<screen><userinput>./configure --prefix=/usr &&
+make</userinput></screen>
+
+    <para>
+      To test the results, issue: <command>make -k check</command>. According to
+      <application>SWIG</application>'s documentation, the failure of some
+      tests should not be considered harmful.
+    </para>
+
+    <para>
+      Now, as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>make install &&
+install -v -m755 -d /usr/share/doc/swig-&swig-version; &&
+cp -v -R Doc/* /usr/share/doc/swig-&swig-version;</userinput></screen>
+  </sect2>
+
+  <!--Optional section-->
+  <sect2 role="commands">
+    <title>Command Explanations</title>
+
+    <para>
+      <option>--without-<language></option>: allows disabling the
+      building of tests and examples for <language>, but all the
+      languages capabilities of <application>SWIG</application> are always
+      built.
+    </para>
+  </sect2>
+
+  <sect2 role="content">
+    <title>Contents</title>
+
+    <segmentedlist>
+      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Library</segtitle>
+      <segtitle>Installed Directories</segtitle>
+
+      <seglistitem>
+        <seg>
+          swig and ccache-swig
+        </seg>
+        <seg>
+          None
+        </seg>
+        <seg>
+          /usr/share/swig/&swig-version; and
+          /usr/share/doc/swig-&swig-version;
+        </seg>
+      </seglistitem>
+    </segmentedlist>
+
+    <variablelist>
+      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
+      <?dbfo list-presentation="list"?>
+      <?dbhtml list-presentation="table"?>
+
+      <!-- If the program or library name conflicts (is the same) as the
+      package name, add -prog or -lib to the varlistentry entity id
+      and the 2nd entry of the indexterm zone entity -->
+
+      <varlistentry id="swig-prog">
+        <term><command>swig</command></term>
+        <listitem>
+          <para>
+            takes an interface file containing C/C++ declarations and
+            SWIG special instructions, and generates the corresponding
+            wrapper code needed to build extension modules.
+          </para>
+          <indexterm zone="swig swig-prog">
+            <primary sortas="b-swig">swig</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry id="ccache-swig">
+        <term><command>ccache-swig</command></term>
+        <listitem>
+          <para>
+            is a compiler cache, which speeds up re-compilation of
+            C/C++/SWIG code.
+          </para>
+          <indexterm zone="swig ccache-swig">
+            <primary sortas="b-ccache-swig">ccache-swig</primary>
+          </indexterm>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+  </sect2>
+</sect1>

Modified: trunk/BOOK/introduction/welcome/changelog.xml
==============================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	Sat Dec 14 04:22:52 2013	(r12392)
+++ trunk/BOOK/introduction/welcome/changelog.xml	Sat Dec 14 11:03:50 2013	(r12393)
@@ -47,6 +47,10 @@
       <para>December 14th, 2013</para>
       <itemizedlist>
         <listitem>
+          <para>[pierre] - Add SWIG-2.0.11. Fixes
+          <ulink url="&blfs-ticket-root;2653">#2653</ulink>.</para>
+        </listitem>
+        <listitem>
           <para>[fernando] - MesaLib-10.0.1: remove removed librarires:
           libdricore, libXvMCr300 and libXvMCsoftpipe.</para>
         </listitem>



More information about the blfs-book mailing list