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> -- http://linuxfromscratch.org/mailman/listinfo/blfs-book FAQ: http://www.linuxfromscratch.org/blfs/faq.html Unsubscribe: See the above information page
