mirror of https://github.com/tLDP/LDP
First XML release having TOC and License.
This commit is contained in:
parent
1b6dc953f4
commit
9861c194de
|
@ -1,34 +1,703 @@
|
||||||
Om
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
||||||
|
<!--
|
||||||
|
$Id$
|
||||||
|
-->
|
||||||
|
|
||||||
|
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
||||||
|
"/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">
|
||||||
|
|
||||||
|
<article>
|
||||||
|
|
||||||
|
<articleinfo>
|
||||||
|
|
||||||
|
<!-- Use "HOWTO", "mini HOWTO", "FAQ" in title, if appropriate -->
|
||||||
|
<title>GNU-Build-System HOWTO</title>
|
||||||
|
<titleabbrev>GBS-HOWTO</titleabbrev>
|
||||||
|
|
||||||
|
<author>
|
||||||
|
<firstname>Giridhar</firstname>
|
||||||
|
<othername>Appaji Nag</othername>
|
||||||
|
<surname>Y</surname>
|
||||||
|
<affiliation>
|
||||||
|
<address>
|
||||||
|
<email>yganag{at}users{dot}sf{dot}net</email>
|
||||||
|
</address>
|
||||||
|
</affiliation>
|
||||||
|
</author>
|
||||||
|
|
||||||
|
<author>
|
||||||
|
<firstname>Mark</firstname>
|
||||||
|
<surname>Hoebeke</surname>
|
||||||
|
<affiliation>
|
||||||
|
<address><email>mark{dot}hoebeke{at}orange{dot}fr</email></address>
|
||||||
|
</affiliation>
|
||||||
|
</author>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- All dates specified in ISO "YYYY-MM-DD" format -->
|
||||||
|
<pubdate>None Yet!</pubdate>
|
||||||
|
|
||||||
|
<!-- Most recent revision goes at the top; list in descending order -->
|
||||||
|
<revhistory>
|
||||||
|
<revision>
|
||||||
|
<revnumber>0.01</revnumber>
|
||||||
|
<date>2003-11-05</date>
|
||||||
|
<authorinitials>mh</authorinitials>
|
||||||
|
<revremark>first formatting of consensus TOC</revremark>
|
||||||
|
</revision>
|
||||||
|
</revhistory>
|
||||||
|
|
||||||
|
<!-- Provide a good abstract; a couple of sentences is sufficient -->
|
||||||
|
<abstract>
|
||||||
|
<para>
|
||||||
|
This HOWTO aims to help beginning developers to leverage the power the the GNU Build System (GBS); The GBS is composed of well-known tools such as <command>make</command> and of less-used utilities such as <command>autconf, automake</command> or <command>libtool.</command>. The primary goal of the HOWTO is to ring developers up to speed with each of these tools, and, at another level to explain some of their inner workings.
|
||||||
|
</para>
|
||||||
|
</abstract>
|
||||||
|
|
||||||
|
</articleinfo>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- Content follows...include introduction, license information, feedback -->
|
||||||
|
|
||||||
|
<sect1 id="intro">
|
||||||
|
<title>Introduction</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Overview of the document.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<sect2 id="about">
|
||||||
|
<title>About this HOWTO</title>
|
||||||
|
<para>About this HOWTO.</para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="getting">
|
||||||
|
<title>Keeping up to date</title>
|
||||||
|
<para>How to get new versions of this document.</para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<!-- Legal Sections -->
|
||||||
|
<sect2 id="copyright">
|
||||||
|
<title>Copyright and License</title>
|
||||||
|
|
||||||
|
<!-- The LDP recommends, but doesn't require, the GFDL -->
|
||||||
|
<para>
|
||||||
|
This document, the <emphasis>GNU-Build-System HOWTO</emphasis>, is
|
||||||
|
copyrighted (c) 2002 by <emphasis>Y Giridhar Appaji
|
||||||
|
Nag</emphasis> and <emphasis>Mark Hoebeke</emphasis>. Permission
|
||||||
|
is granted to copy, distribute and/or modify this document under
|
||||||
|
the terms of the GNU Public License, Version 2 or any later
|
||||||
|
version published by the Free Software Foundation; with no
|
||||||
|
Invariant Sections, with no Front-Cover Texts, and with no
|
||||||
|
Back-Cover Texts. A copy of the license is available at
|
||||||
|
<ulink url="http://www.gnu.org/licenses/gpl.txt">
|
||||||
|
http://www.gnu.org/licenses/gpl.txt</ulink> and can be found in <xref linkend="gpl"/>.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Linux is a registered trademark of Linus Torvalds.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="disclaimer">
|
||||||
|
<title>Disclaimer</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
No liability for the contents of this document can be accepted.
|
||||||
|
Use the concepts, examples and information at your own risk.
|
||||||
|
There may be errors and inaccuracies, that could be damaging to
|
||||||
|
your system. Proceed with caution, and although this is highly
|
||||||
|
unlikely, the author(s) do not take any responsibility.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
All copyrights are held by their by their respective owners,
|
||||||
|
unless specifically noted otherwise. Use of a term in this
|
||||||
|
document should not be regarded as affecting the validity of any
|
||||||
|
trademark or service mark. Naming of particular products or
|
||||||
|
brands should not be seen as endorsements.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<!-- Give credit where credit is due...very important -->
|
||||||
|
<sect2 id="credits">
|
||||||
|
<title>Credits / Contributors</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
In this document, I have the pleasure of acknowledging:
|
||||||
|
</para>
|
||||||
|
|
||||||
|
|
||||||
|
<!-- Please scramble addresses; help prevent spam/email harvesting -->
|
||||||
|
<!--
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>Individual 1 <email>someone1 (at) somewhere.org</email></para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>Individual 2 <email>someone2 (at) somewhere.org</email></para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
-->
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<!-- Feedback -->
|
||||||
|
<sect2 id="feedback">
|
||||||
|
<title>Feedback</title>
|
||||||
|
|
||||||
|
<para>
|
||||||
|
Feedback is most certainly welcome for this document. Send
|
||||||
|
your additions, comments and criticisms to the following
|
||||||
|
email addresses : <email>xxx@xxx.xxx</email>.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<!-- Translations -->
|
||||||
|
<sect2 id="translations">
|
||||||
|
<title>Translations</title>
|
||||||
|
<para></para>
|
||||||
|
|
||||||
|
<!--
|
||||||
|
<para>
|
||||||
|
Pointers to available translations are nice.
|
||||||
|
Also your translators tend to give very important inputs.
|
||||||
|
</para>
|
||||||
|
|
||||||
|
<itemizedlist>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<ulink url="http://tldp.org/">French Translation</ulink>
|
||||||
|
provided by Individual <email>someone (at) somewhere.fr</email>
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para>
|
||||||
|
<ulink url="http://tlpd.org/">German Translation</ulink>
|
||||||
|
provided by Individual <email>someone (at) somewhere.de</email>
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</itemizedlist>
|
||||||
|
-->
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1 id="using">
|
||||||
|
<title>Using the GNU-Build System</title>
|
||||||
|
|
||||||
|
<sect2 id="whatismake">
|
||||||
|
<title>What is GNU Make?</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="whatisautoconf">
|
||||||
|
<title>What is GNU Autoconf?</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="whatisautomake">
|
||||||
|
<title>What is GNU Automake?</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="whatislibtool">
|
||||||
|
<title>What is GNU Libtool?</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1 id="realworld">
|
||||||
|
<title>Back to the Real World</title>
|
||||||
|
|
||||||
|
<sect2 id="rwmake">
|
||||||
|
<title>GNU Make</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="rwautoconf">
|
||||||
|
<title>GNU Autoconf</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="rwautomake">
|
||||||
|
<title>GNU Automake</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="rwlibtool">
|
||||||
|
<title>GNU Libtool</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1 id="inside">
|
||||||
|
<title>An inside look</title>
|
||||||
|
|
||||||
|
<sect2 id="insidemake">
|
||||||
|
<title>Inside GNU Make</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="insidem4">
|
||||||
|
<title>Inside the m4 macro language</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="insideautoconf">
|
||||||
|
<title>Inside GNU Autoconf</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="insideautomake">
|
||||||
|
<title>Inside GNU Automake</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="insidelibtool">
|
||||||
|
<title>Inside GNU Libtool</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<sect1 id="appinstall">
|
||||||
|
<title>Installation of the GNU-Build-System Tools</title>
|
||||||
|
|
||||||
|
<sect2 id="distinstall">
|
||||||
|
<title>Installing from GNU/Linux distribution packages</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
|
||||||
|
<sect2 id="srcinstall">
|
||||||
|
<title>Installing for source tarballs</title>
|
||||||
|
<para></para>
|
||||||
|
</sect2>
|
||||||
|
</sect1>
|
||||||
|
|
||||||
|
<appendix id="gpl">
|
||||||
|
<appendixinfo>
|
||||||
|
<title>GNU General Public License</title>
|
||||||
|
<pubdate>Version 2, June 1991</pubdate>
|
||||||
|
<copyright>
|
||||||
|
<year>1989, 1991</year>
|
||||||
|
<holder>Free Software Foundation, Inc.</holder>
|
||||||
|
</copyright>
|
||||||
|
<legalnotice>
|
||||||
|
<para>
|
||||||
|
<address>Free Software Foundation, Inc.
|
||||||
|
<street>59 Temple Place, Suite 330</street>,
|
||||||
|
<city>Boston</city>,
|
||||||
|
<state>MA</state>
|
||||||
|
<postcode>02111-1307</postcode>
|
||||||
|
<country>USA</country>
|
||||||
|
</address>.
|
||||||
|
</para>
|
||||||
|
<para> Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
|
||||||
|
</para>
|
||||||
|
</legalnotice>
|
||||||
|
<releaseinfo> Version 2, June 1991</releaseinfo>
|
||||||
|
</appendixinfo>
|
||||||
|
<title>GNU General Public License</title>
|
||||||
|
<sect1>
|
||||||
|
<title>Preamble</title>
|
||||||
|
<para> The licenses for most software are designed to take away your
|
||||||
|
freedom to share and change it. By contrast, the GNU General Public License is
|
||||||
|
intended to guarantee your freedom to share and change
|
||||||
|
free software - to make sure the software is free for all its users.
|
||||||
|
This General Public License applies to most of the Free Software
|
||||||
|
Foundation's software and to any other program whose authors commit
|
||||||
|
to using it. (Some other Free Software Foundation software is covered
|
||||||
|
by the GNU Library General Public License instead.) You can apply it
|
||||||
|
to your programs, too.
|
||||||
|
</para>
|
||||||
|
<para> When we speak of free software, we are referring to freedom, not price.
|
||||||
|
Our General Public Licenses are designed to make sure that you have the
|
||||||
|
freedom to distribute copies of free software (and charge for this
|
||||||
|
service if you wish), that you receive source code or can get it if you
|
||||||
|
want it, that you can change the software or use pieces of it in new free
|
||||||
|
programs; and that you know you can do these things.
|
||||||
|
</para>
|
||||||
|
<para> To protect your rights, we need to make restrictions that forbid anyone
|
||||||
|
to deny you these rights or to ask you to surrender the rights. These
|
||||||
|
restrictions translate to certain responsibilities for you if you distribute
|
||||||
|
copies of the software, or if you modify it.
|
||||||
|
</para>
|
||||||
|
<para> For example, if you distribute copies of such a program, whether gratis or
|
||||||
|
for a fee, you must give the recipients all the rights that you have. You
|
||||||
|
must make sure that they, too, receive or can get the source code. And you
|
||||||
|
must show them these terms so they know their rights.
|
||||||
|
</para>
|
||||||
|
<para> We protect your rights with two steps:
|
||||||
|
<orderedlist>
|
||||||
|
<listitem>
|
||||||
|
<para> copyright the software, and
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> offer you this license which gives you legal permission to copy,
|
||||||
|
distribute and/or modify the software.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</orderedlist>
|
||||||
|
</para>
|
||||||
|
<para> Also, for each author's protection and ours, we want to make certain that
|
||||||
|
everyone understands that there is no warranty for this free software. If
|
||||||
|
the software is modified by someone else and passed on, we want its
|
||||||
|
recipients to know that what they have is not the original, so that any
|
||||||
|
problems introduced by others will not reflect on the original authors'
|
||||||
|
reputations.
|
||||||
|
</para>
|
||||||
|
<para> Finally, any free program is threatened constantly by software patents.
|
||||||
|
We wish to avoid the danger that redistributors of a free program will
|
||||||
|
individually obtain patent licenses, in effect making the program
|
||||||
|
proprietary. To prevent this, we have made it clear that any patent must be
|
||||||
|
licensed for everyone's free use or not licensed at all.
|
||||||
|
</para>
|
||||||
|
<para> The precise terms and conditions for copying, distribution and modification
|
||||||
|
follow.
|
||||||
|
</para>
|
||||||
|
</sect1>
|
||||||
|
<sect1>
|
||||||
|
<title>TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION</title>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 0</title>
|
||||||
|
<para> This License applies to any program or other work which contains a notice
|
||||||
|
placed by the copyright holder saying it may be distributed under the terms
|
||||||
|
of this General Public License. The "Program", below, refers to any such
|
||||||
|
program or work, and a
|
||||||
|
<quote>work based on the Program
|
||||||
|
</quote> means either
|
||||||
|
the Program or any derivative work under copyright law: that is to say, a
|
||||||
|
work containing the Program or a portion of it, either verbatim or with
|
||||||
|
modifications and/or translated into another language. (Hereinafter, translation
|
||||||
|
is included without limitation in the term
|
||||||
|
<quote>modification
|
||||||
|
</quote>.) Each licensee is addressed as <quote>you</quote>.
|
||||||
|
</para>
|
||||||
|
<para> Activities other than copying, distribution and modification are not covered by
|
||||||
|
this License; they are outside its scope. The act of running the Program is not
|
||||||
|
restricted, and the output from the Program is covered only if its contents
|
||||||
|
constitute a work based on the Program (independent of having been made by running
|
||||||
|
the Program). Whether that is true depends on what the Program does.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2 id="sect1">
|
||||||
|
<title>Section 1</title>
|
||||||
|
<para> You may copy and distribute verbatim copies of the Program's source code as you
|
||||||
|
receive it, in any medium, provided that you conspicuously and appropriately
|
||||||
|
publish on each copy an appropriate copyright notice and disclaimer of warranty;
|
||||||
|
keep intact all the notices that refer to this License and to the absence of any
|
||||||
|
warranty; and give any other recipients of the Program a copy of this License
|
||||||
|
along with the Program.
|
||||||
|
</para>
|
||||||
|
<para> You may charge a fee for the physical act of transferring a copy, and you may at
|
||||||
|
your option offer warranty protection in exchange for a fee.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2 id="sect2">
|
||||||
|
<title>Section 2</title>
|
||||||
|
<para> You may modify your copy or copies of the Program or any portion of it, thus
|
||||||
|
forming a work based on the Program, and copy and distribute such modifications
|
||||||
|
or work under the terms of
|
||||||
|
<link linkend="sect1">Section 1
|
||||||
|
</link> above, provided
|
||||||
|
that you also meet all of these conditions:
|
||||||
|
<orderedlist>
|
||||||
|
<listitem>
|
||||||
|
<para> You must cause the modified files to carry prominent notices stating that
|
||||||
|
you changed the files and the date of any change.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> You must cause any work that you distribute or publish, that in whole or
|
||||||
|
in part contains or is derived from the Program or any part thereof, to be
|
||||||
|
licensed as a whole at no charge to all third parties under the terms of
|
||||||
|
this License.
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> If the modified program normally reads commands interactively when run, you
|
||||||
|
must cause it, when started running for such interactive use in the most
|
||||||
|
ordinary way, to print or display an announcement including an appropriate
|
||||||
|
copyright notice and a notice that there is no warranty (or else, saying
|
||||||
|
that you provide a warranty) and that users may redistribute the program
|
||||||
|
under these conditions, and telling the user how to view a copy of this
|
||||||
|
License.
|
||||||
|
<note>
|
||||||
|
<title>Exception:
|
||||||
|
</title>
|
||||||
|
<para> If the Program itself is interactive but does not normally print such an
|
||||||
|
announcement, your work based on the Program is not required to print an
|
||||||
|
announcement.)
|
||||||
|
</para>
|
||||||
|
</note>
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</orderedlist>
|
||||||
|
</para>
|
||||||
|
<para> These requirements apply to the modified work as a whole. If identifiable sections
|
||||||
|
of that work are not derived from the Program, and can be reasonably considered
|
||||||
|
independent and separate works in themselves, then this License, and its terms,
|
||||||
|
do not apply to those sections when you distribute them as separate works. But when
|
||||||
|
you distribute the same sections as part of a whole which is a work based on the
|
||||||
|
Program, the distribution of the whole must be on the terms of this License, whose
|
||||||
|
permissions for other licensees extend to the entire whole, and thus to each and
|
||||||
|
every part regardless of who wrote it.
|
||||||
|
</para>
|
||||||
|
<para> Thus, it is not the intent of this section to claim rights or contest your rights
|
||||||
|
to work written entirely by you; rather, the intent is to exercise the right to control
|
||||||
|
the distribution of derivative or collective works based on the Program.
|
||||||
|
</para>
|
||||||
|
<para> In addition, mere aggregation of another work not based on the Program with the Program
|
||||||
|
(or with a work based on the Program) on a volume of a storage or distribution medium
|
||||||
|
does not bring the other work under the scope of this License.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 3
|
||||||
|
</title>
|
||||||
|
<para> You may copy and distribute the Program (or a work based on it, under
|
||||||
|
<link linkend="sect2">Section 2
|
||||||
|
</link> in object code or executable form under the terms of
|
||||||
|
<link linkend="sect1">Sections 1
|
||||||
|
</link> and
|
||||||
|
<link linkend="sect2">2
|
||||||
|
</link> above provided that you also do one of the following:
|
||||||
|
<orderedlist>
|
||||||
|
<listitem>
|
||||||
|
<para> Accompany it with the complete corresponding machine-readable source code, which
|
||||||
|
must be distributed under the terms of Sections 1 and 2 above on a medium
|
||||||
|
customarily used for software interchange; or,
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> Accompany it with a written offer, valid for at least three years, to give any
|
||||||
|
third party, for a charge no more than your cost of physically performing source
|
||||||
|
distribution, a complete machine-readable copy of the corresponding source code,
|
||||||
|
to be distributed under the terms of Sections 1 and 2 above on a medium customarily
|
||||||
|
used for software interchange; or,
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
<listitem>
|
||||||
|
<para> Accompany it with the information you received as to the offer to distribute
|
||||||
|
corresponding source code. (This alternative is allowed only for noncommercial
|
||||||
|
distribution and only if you received the program in object code or executable form
|
||||||
|
with such an offer, in accord with Subsection b above.)
|
||||||
|
</para>
|
||||||
|
</listitem>
|
||||||
|
</orderedlist>
|
||||||
|
</para>
|
||||||
|
<para> The source code for a work means the preferred form of the work for making modifications
|
||||||
|
to it. For an executable work, complete source code means all the source code for all modules
|
||||||
|
it contains, plus any associated interface definition files, plus the scripts used to control
|
||||||
|
compilation and installation of the executable. However, as a special exception, the source
|
||||||
|
code distributed need not include anything that is normally distributed (in either source or
|
||||||
|
binary form) with the major components (compiler, kernel, and so on) of the operating system
|
||||||
|
on which the executable runs, unless that component itself accompanies the executable.
|
||||||
|
</para>
|
||||||
|
<para> If distribution of executable or object code is made by offering access to copy from a
|
||||||
|
designated place, then offering equivalent access to copy the source code from the same place
|
||||||
|
counts as distribution of the source code, even though third parties are not compelled to
|
||||||
|
copy the source along with the object code.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 4
|
||||||
|
</title>
|
||||||
|
<para> You may not copy, modify, sublicense, or distribute the Program except as expressly provided
|
||||||
|
under this License. Any attempt otherwise to copy, modify, sublicense or distribute the
|
||||||
|
Program is void, and will automatically terminate your rights under this License. However,
|
||||||
|
parties who have received copies, or rights, from you under this License will not have their
|
||||||
|
licenses terminated so long as such parties remain in full compliance.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 5
|
||||||
|
</title>
|
||||||
|
<para> You are not required to accept this License, since you have not signed it. However, nothing
|
||||||
|
else grants you permission to modify or distribute the Program or its derivative works.
|
||||||
|
These actions are prohibited by law if you do not accept this License. Therefore, by modifying
|
||||||
|
or distributing the Program (or any work based on the Program), you indicate your acceptance
|
||||||
|
of this License to do so, and all its terms and conditions for copying, distributing or
|
||||||
|
modifying the Program or works based on it.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 6
|
||||||
|
</title>
|
||||||
|
<para> Each time you redistribute the Program (or any work based on the Program), the recipient
|
||||||
|
automatically receives a license from the original licensor to copy, distribute or modify
|
||||||
|
the Program subject to these terms and conditions. You may not impose any further restrictions
|
||||||
|
on the recipients' exercise of the rights granted herein. You are not responsible for enforcing
|
||||||
|
compliance by third parties to this License.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 7
|
||||||
|
</title>
|
||||||
|
<para> If, as a consequence of a court judgment or allegation of patent infringement or for any other
|
||||||
|
reason (not limited to patent issues), conditions are imposed on you (whether by court order,
|
||||||
|
agreement or otherwise) that contradict the conditions of this License, they do not excuse you
|
||||||
|
from the conditions of this License. If you cannot distribute so as to satisfy simultaneously
|
||||||
|
your obligations under this License and any other pertinent obligations, then as a consequence
|
||||||
|
you may not distribute the Program at all. For example, if a patent license would not permit
|
||||||
|
royalty-free redistribution of the Program by all those who receive copies directly or
|
||||||
|
indirectly through you, then the only way you could satisfy both it and this License would be
|
||||||
|
to refrain entirely from distribution of the Program.
|
||||||
|
</para>
|
||||||
|
<para> If any portion of this section is held invalid or unenforceable under any particular circumstance,
|
||||||
|
the balance of the section is intended to apply and the section as a whole is intended to apply
|
||||||
|
in other circumstances.
|
||||||
|
</para>
|
||||||
|
<para> It is not the purpose of this section to induce you to infringe any patents or other property
|
||||||
|
right claims or to contest validity of any such claims; this section has the sole purpose of
|
||||||
|
protecting the integrity of the free software distribution system, which is implemented by public
|
||||||
|
license practices. Many people have made generous contributions to the wide range of software
|
||||||
|
distributed through that system in reliance on consistent application of that system; it is up
|
||||||
|
to the author/donor to decide if he or she is willing to distribute software through any other
|
||||||
|
system and a licensee cannot impose that choice.
|
||||||
|
</para>
|
||||||
|
<para> This section is intended to make thoroughly clear what is believed to be a consequence of the
|
||||||
|
rest of this License.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 8
|
||||||
|
</title>
|
||||||
|
<para> If the distribution and/or use of the Program is restricted in certain countries either by patents
|
||||||
|
or by copyrighted interfaces, the original copyright holder who places the Program under this License
|
||||||
|
may add an explicit geographical distribution limitation excluding those countries, so that
|
||||||
|
distribution is permitted only in or among countries not thus excluded. In such case, this License
|
||||||
|
incorporates the limitation as if written in the body of this License.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 9
|
||||||
|
</title>
|
||||||
|
<para> The Free Software Foundation may publish revised and/or new versions of the General Public License
|
||||||
|
from time to time. Such new versions will be similar in spirit to the present version, but may differ
|
||||||
|
in detail to address new problems or concerns.
|
||||||
|
</para>
|
||||||
|
<para> Each version is given a distinguishing version number. If the Program specifies a version number of
|
||||||
|
this License which applies to it and "any later version", you have the option of following the terms
|
||||||
|
and conditions either of that version or of any later version published by the Free Software
|
||||||
|
Foundation. If the Program does not specify a version number of this License, you may choose any
|
||||||
|
version ever published by the Free Software Foundation.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 10
|
||||||
|
</title>
|
||||||
|
<para> If you wish to incorporate parts of the Program into other free programs whose distribution
|
||||||
|
conditions are different, write to the author to ask for permission. For software which is copyrighted
|
||||||
|
by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions
|
||||||
|
for this. Our decision will be guided by the two goals of preserving the free status of all
|
||||||
|
derivatives of our free software and of promoting the sharing and reuse of software generally.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>NO WARRANTY Section 11
|
||||||
|
</title>
|
||||||
|
<para> BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT
|
||||||
|
PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
|
||||||
|
OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
|
||||||
|
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||||
|
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||||
|
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
<sect2>
|
||||||
|
<title>Section 12
|
||||||
|
</title>
|
||||||
|
<para> IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR
|
||||||
|
ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
|
||||||
|
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||||
|
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
|
||||||
|
INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH
|
||||||
|
ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
|
||||||
|
DAMAGES.
|
||||||
|
</para>
|
||||||
|
<para>END OF TERMS AND CONDITIONS
|
||||||
|
</para>
|
||||||
|
</sect2>
|
||||||
|
</sect1>
|
||||||
|
<sect1>
|
||||||
|
<title>How to Apply These Terms to Your New Programs
|
||||||
|
</title>
|
||||||
|
<para>
|
||||||
|
If you develop a new program, and you want it to be of the greatest
|
||||||
|
possible use to the public, the best way to achieve this is to make it
|
||||||
|
free software which everyone can redistribute and change under these terms.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
To do so, attach the following notices to the program. It is safest
|
||||||
|
to attach them to the start of each source file to most effectively
|
||||||
|
convey the exclusion of warranty; and each file should have at least
|
||||||
|
the "copyright" line and a pointer to where the full notice is found.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<one line to give the program's name and a brief idea of what it does.>
|
||||||
|
Copyright (C) <year> <name of author>
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
This program is free software; you can redistribute it and/or modify
|
||||||
|
it under the terms of the GNU General Public License as published by
|
||||||
|
the Free Software Foundation; either version 2 of the License, or
|
||||||
|
(at your option) any later version.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
This program is distributed in the hope that it will be useful,
|
||||||
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||||
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
|
GNU General Public License for more details.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
You should have received a copy of the GNU General Public License
|
||||||
|
along with this program; if not, write to the Free Software
|
||||||
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
Also add information on how to contact you by electronic and paper mail.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
If the program is interactive, make it output a short notice like this
|
||||||
|
when it starts in an interactive mode:
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
Gnomovision version 69, Copyright (C) year name of author
|
||||||
|
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||||
|
This is free software, and you are welcome to redistribute it
|
||||||
|
under certain conditions; type `show c' for details.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||||
|
parts of the General Public License. Of course, the commands you use may
|
||||||
|
be called something other than `show w' and `show c'; they could even be
|
||||||
|
mouse-clicks or menu items--whatever suits your program.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
You should also get your employer (if you work as a programmer) or your
|
||||||
|
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||||
|
necessary. Here is a sample; alter the names:
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
||||||
|
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
<signature of Ty Coon>, 1 April 1989
|
||||||
|
Ty Coon, President of Vice
|
||||||
|
</para>
|
||||||
|
<para>
|
||||||
|
This General Public License does not permit incorporating your program into
|
||||||
|
proprietary programs. If your program is a subroutine library, you may
|
||||||
|
consider it more useful to permit linking proprietary applications with the
|
||||||
|
library. If this is what you want to do, use the GNU Library General
|
||||||
|
Public License instead of this License.
|
||||||
|
</para>
|
||||||
|
</sect1>
|
||||||
|
</appendix>
|
||||||
|
</article>
|
||||||
|
|
||||||
1. Introduction, Usefulness [The usual stuff]
|
|
||||||
- Introduction and Usefulness of the tools
|
|
||||||
- About the document
|
|
||||||
- How to get new versions of this document
|
|
||||||
- Copyright and top level document license
|
|
||||||
2. Using the GNU build tools [What and how. Hello World!]
|
|
||||||
- What is GNU Make and how to use it
|
|
||||||
- What is Autoconf and how to use it
|
|
||||||
- What is Automake and how to use it
|
|
||||||
- What is Libtool and how to use it
|
|
||||||
3. Real life example of the GNU build tools [DSG Program]
|
|
||||||
- GNU Make for DSG Program
|
|
||||||
- Autoconf for DSG Program
|
|
||||||
- Automake for DSG Program
|
|
||||||
- Libtool for DSG Program
|
|
||||||
- Other tools with GNU autotools (autoscan, etc.)
|
|
||||||
4. How each of the tools work
|
|
||||||
- How Make works
|
|
||||||
- The m4 macroprocessor
|
|
||||||
- How Autoconf works
|
|
||||||
- How Automake works
|
|
||||||
- How Libtool works
|
|
||||||
Appendix: Installation of the tools
|
|
||||||
- Installation in distros [RedHat, Debian and ?]
|
|
||||||
- Requirements for installing from source
|
|
||||||
- Installing Make, Automake, Autoconf, Libtool.
|
|
||||||
5. References, Acknowledgements, Document License etc.
|
|
||||||
- Sending comments and suggestions
|
|
||||||
- Acknowledgements
|
|
||||||
- Document Disclaimer
|
|
||||||
- References and Resources
|
|
||||||
- Full document license (GNU GPL)
|
|
||||||
|
|
Loading…
Reference in New Issue