GPLv2. Added appendix with full license. Added refernece to that from
[pazpar2-moved-to-github.git] / doc / book.xml
1 <?xml version="1.0" standalone="no"?>
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1//EN"
3     "http://www.oasis-open.org/docbook/xml/4.1/docbookx.dtd" 
4 [
5      <!ENTITY % local SYSTEM "local.ent">
6      %local;
7      <!ENTITY % entities SYSTEM "entities.ent">
8      %entities;
9      <!ENTITY % common SYSTEM "common/common.ent">
10      %common;
11 ]>
12 <!-- $Id: book.xml,v 1.8 2007-04-10 08:48:55 adam Exp $ -->
13 <book id="book">
14  <bookinfo>
15   <title>Pazpar2 - User's Guide and Reference</title>
16   <author>
17    <firstname>Sebastian</firstname><surname>Hammer</surname>
18   </author>
19   <releaseinfo>&version;</releaseinfo>
20   <copyright>
21    <year>&copyright-year;</year>
22    <holder>Index Data</holder>
23   </copyright>
24   <abstract>
25    <simpara>
26     Pazpar2 is a high-performance, user interface-independent, data
27     model-independent metasearching
28     middleware featuring merging, relevance ranking, record sorting, 
29     and faceted results.
30    </simpara>
31    <simpara>
32     This document is a guide and reference to Pazpar version &version;.
33    </simpara>
34    <simpara>
35     <inlinemediaobject>
36      <imageobject>
37       <imagedata fileref="common/id.png" format="PNG"/>
38    </imageobject>
39     <imageobject>
40      <imagedata fileref="common/id.eps" format="EPS"/>
41    </imageobject>
42    </inlinemediaobject>
43    </simpara>
44   </abstract>
45   </bookinfo>
46  
47   <chapter id="introduction">
48    <title>Introduction</title>
49    <para>
50      Pazpar2 is a stand-alone metasearch client with a webservice API, designed
51      to be used either from a browser-based client (JavaScript, Flash, Java,
52      etc.), from from server-side code, or any combination of the two.
53      Pazpar2 is a highly optimized client designed to
54      search many resources in parallel. It implements record merging,
55      relevance-ranking and sorting by arbitrary data content, and facet
56      analysis for browsing purposes. It is designed to be data model
57      independent, and is capable of working with MARC, DublinCore, or any
58      other XML-structured response format -- XSLT is used to normalize and extract
59      data from retrieval records for display and analysis. It can be used
60      against any server which supports the Z39.50 protocol. Proprietary
61      backend modules can be used to support a large number of other protocols
62      (please contact Index Data for further information about this).
63    </para>
64    <para>
65      Additional functionality such as
66      user management, attractive displays are expected to be implemented by
67      applications that use pazpar2. Pazpar2 is user interface independent.
68      Its functionality is exposed through a simple REST-style webservice API,
69      designed to be simple to use from an Ajax-enbled browser, Flash
70      animation, Java applet, etc., or from a higher-level server-side language
71      like PHP or Java. Because session information can be shared between
72      browser-based logic and your server-side scripting, there is tremendous
73      flexibility in how you implement your business logic on top of pazpar2.
74    </para>
75    <para>
76      Once you launch a search in pazpar2, the operation continues behind the
77      scenes. Pazpar2 connects to servers, carries out searches, and
78      retrieves, deduplicates, and stores results internally. Your application
79      code may periodically inquire about the status of an ongoing operation,
80      and ask to see records or other result set facets. Result become
81      available immediately, and it is easy to build end-user interfaces which
82      feel extremely responsive, even when searching more than 100 servers
83      concurrently.
84    </para>
85    <para>
86      Pazpar2 is designed to be highly configurable. Incoming records are
87      normalized to XML/UTF-8, and then further normalized using XSLT to a
88      simple internal representation that is suitable for analysis. By
89      providing XSLT stylesheets for different kinds of result records, you
90      can tune pazpar2 to work against different kinds of information
91      retrieval servers. Finally, metadata is extracted, in a configurable
92      way, from this internal record, to support display, merging, ranking,
93      result set facets, and sorting. Pazpar2 is not bound to a specific model
94      of metadata, such as DublinCore or MARC -- by providing the right
95      configuration, it can work with a number of different kinds of data in
96      support of many different applications.
97    </para>
98    <para>
99      Pazpar2 is designed to be efficient and scalable. You can set it up to
100      search several hundred targets in parallel, or you can use it to support
101      hundreds of concurrent users. It is implemented with the same attention
102      to performance and economy that we use in our indexing engines, so that
103      you can focus on building your application, without worrying about the
104      details of metasearch logic. You can devote all of your attention to
105      usability and let pazpar2 do what it does best -- metasearch.
106     </para>
107     <para>
108       If you wish to connect to commercial or other databases which do not
109       support open standards, please contact Index Data. We have a licensing
110       agreement with a third party vendor which will enable pazpar2 to access
111       thousands of online databases, in addition the vast number of catalogs
112       and online services that support the Z39.50 protocol.
113     </para>
114     <para>
115       Pazpar2 is our attempt to re-think the traditional paradigms for
116       implementing and deploying metasearch logic, with an uncompromising
117       approach to performance, and attempting to make maximum use of the
118       capabilities of modern browsers. The demo user interface that
119       accompanies the distribution is but one example. If you think of new
120       ways of using pazpar2, we hope you'll share them with us, and if we
121       can provide assistance with regards to training, design, programming,
122       integration with different backends, hosting, or support, please don't
123       hesitate to contact us. If you'd like to see functionality in pazpar2
124       that is not there today, please don't hesitate to contact us. It may
125       already be in our development pipeline, or there might be a
126       possibility for you to help out by sponsoring development time or
127       code. Either way, get in touch and we will give you straight answers.
128     </para>
129     <para>
130       Enjoy!
131     </para>
132     <para>
133       Pazpar2 is covered by the GNU license version 2.
134       See <xref linkend="license"/> for further information.
135     </para>
136   </chapter>
137
138   <chapter id="installation">
139    <title>Installation</title>
140    <para>
141     Pazpar2 depends on the following tools/libraries:
142     <variablelist>
143      <varlistentry><term><ulink url="&url.yaz;">YAZ</ulink></term>
144       <listitem>
145        <para>
146         The popular Z39.50 toolkit for the C language. YAZ must be
147         compiled with Libxml2/Libxslt support.
148        </para>
149       </listitem>
150      </varlistentry>
151     </variablelist>
152    </para>
153    <para>
154     In order to compile Pazpar2 an ANSI C compiler is
155     required. The requirements should be the same as for YAZ.
156    </para>
157
158    <section id="installation.unix">
159     <title>Installation on Unix (from Source)</title>
160     <para>
161      Here is a quick step-by-step guide on how to compile the
162      tools that Pazpar2 uses. Only few systems have none of the required
163      tools binary packages. If, for example, Libxml2/libxslt are already
164      installed as development packages use these.
165     </para>
166     
167     <para>
168      Ensure that the development libraries + header files are
169      available on your system before compiling Pazpar2. For installation
170      of YAZ, refer to the YAZ installation chapter.
171     </para>
172     <screen>
173      gunzip -c pazpar2-version.tar.gz|tar xf -
174      cd pazpar2-version
175      ./configure
176      make
177      su
178      make install
179     </screen>
180    </section>
181
182    <section id="installation.debian">
183     <title>Installation on Debian GNU/Linux</title>
184     <para>
185      All dependencies for Pazpar2 are available as 
186      <ulink url="&url.debian;">Debian</ulink>
187      packages for the sarge (stable in 2005) and etch (testing in 2005)
188      distributions.
189     </para>
190     <para>
191      The procedures for Debian based systems, such as
192      <ulink url="&url.ubuntu;">Ubuntu</ulink> is probably similar
193     </para>
194     <screen>
195      apt-get install libyaz-dev
196     </screen>
197     <para>
198      With these packages installed, the usual configure + make
199      procedure can be used for Pazpar2 as outlined in
200      <xref linkend="installation.unix"/>.
201     </para>
202    </section>
203   </chapter>
204
205   <chapter id="using">
206     <title>Using pazpar2</title>
207     <para>
208       This chapter provides a general introduction to the use and deployment of pazpar2.
209     </para>
210
211     <section id="architecture">
212       <title>Pazpar2 and your systems architecture</title>
213       <para>
214         Pazpar2 is designed to provide asynchronous, behind-the-scenes
215         metasearching functionality to your application, exposing this
216         functionality using a simple webservice API that can be accessed
217         from any number of development environments. In particular, it is
218         possible to combine pazpar2 either with your server-side dynamic
219         website scripting, with scripting or code running in the browser, or
220         with any combination of the two. Pazpar2 is an excellent tool for
221         building advanced, Ajax-based user interfaces for metasearch
222         functionality, but it isn't a requirement -- you can choose to use
223         pazpar2 entirely as a backend to your regular server-side scripting.
224         When you do use pazpar2 in conjunction
225         with browser scripting (JavaScript/Ajax, Flash, applets, etc.), there are
226         special considerations.
227       </para>
228
229       <para>
230         Pazpar2 implements a simple but efficient HTTP server, and it is
231         designed to interact directly with scripting running in the browser
232         for the best possible performance, and to limit overhead when
233         several browser clients generate numerous webservice requests.
234         However, it is still desirable to use a conventional webserver,
235         such as Apache, to serve up graphics, HTML documents, and
236         server-side scripting. Because the security sandbox environment of
237         most browser-side programming environments only allows communication
238         with the server from which the enclosing HTML page or object
239         originated, pazpar2 is designed so that it can act as a transparent
240         proxy in front of an existing webserver (see <xref
241         linkend="pazpar2_conf"/> for details). In this mode, all regular
242         HTTP requests are transparently passed through to your webserver,
243         while pazpar2 only intercepts search-related webservice requests.
244       </para>
245
246       <para>
247         If you want to expose your combined service on port 80, you can
248         either run your regular webserver on a different port, a different
249         server, or a different IP address associated with the same server.
250       </para>
251
252       <para>
253         Sometimes, it may be necessary to implement functionality on your
254         regular webserver that makes use of search results, for example to
255         implement data import functionality, emailing results, history
256         lists, personal citation lists, interlibrary loan functionality
257         ,etc. Fortunately, it is simple to exchange information between
258         pazpar2, your browser scripting, and backend server-side scripting.
259         You can send a session ID and possibly a record ID from your browser
260         code to your server code, and from there use pazpar2s webservice API
261         to access result sets or individual records. You could even 'hide'
262         all of pazpar2s functionality between your own API implemented on
263         the server-side, and access that from the browser or elsewhere. The
264         possibilities are just about endless.
265       </para>
266     </section>
267
268     <section id="data_model">
269       <title>Your data model</title>
270       <para>
271         Pazpar2 does not have a preconceived model of what makes up a data
272         model. There are no assumption that records have specific fields or
273         that they are organized in any particular way. The only assumption
274         is that data comes packaged in a form that the software can work
275         with (presently, that means XML or MARC), and that you can provide
276         the necessary information to massage it into pazpar2's internal
277         record abstraction.
278       </para>
279
280       <para>
281         Handling retrieval records in pazpar2 is a two-step process. First,
282         you decide which data elements of the source record you are
283         interested in, and you specify any desired massaging or combining of
284         elements using an XSLT stylesheet (MARC records are automatically
285         normalized to MARCXML before this step). If desired, you can run
286         multiple XSLT stylesheets in series to accomplish this, but the
287         output of the last one should be a representation of the record in a
288         schema that pazpar2 understands.
289       </para>
290
291       <para>
292         The intermediate, internal representation of the record looks like
293         this:
294         <screen><![CDATA[
295 <record   xmlns="http://www.indexdata.com/pazpar2/1.0"
296           mergekey="title The Shining author King, Stephen">
297
298     <metadata type="title">The Shining</metadata>
299
300     <metadata type="author">King, Stephen</metadata>
301
302     <metadata type="kind">ebook</metadata>
303
304     <!-- ... and so on -->
305 </record>
306 ]]></screen>
307
308         As you can see, there isn't much to it. There are really only a few
309         important elements to this file.
310       </para>
311
312       <para>
313         Elements should belong to the namespace
314         http://www.indexdata.com/pazpar2/1.0. If the root node contains the
315         attribute 'mergekey', then every record that generates the same
316         merge key (normalized for case differences, white space, and
317         truncation) will be joined into a cluster. In other words, you
318         decide how records are merged. If you don't include a merge key,
319         records are never merged. The 'metadata' elements provide the meat
320         of the elements -- the content. the 'type' attribute is used to
321         match each element against processing rules that determine what
322         happens to the data element next.
323       </para>
324
325       <para>
326         The next processing step is the extraction of metadata from the
327         intermediate representation of the record. This is governed by the
328         'metadata' elements in the 'service' section of the configuration
329         file. See <xref linkend="config-server"/> for details. The metadata
330         in the retrieval record ultimately drives merging, sorting, ranking,
331         the extraction of browse facets, and display, all configurable.
332       </para>
333     </section>
334
335     <section id="client">
336       <title>Client development</title>
337       <para>
338         You can use pazpar2 from any environment that allows you to use
339         webservices. The initial goal of the software was to support
340         Ajax-based applications, but there literally are no limits to what
341         you can do. You can use pazpar2 from Javascript, Flash, Java, etc.,
342         on the browser side, and from any development environment on the
343         server side, and you can pass session tokens and record IDs freely
344         around between these environments to build sophisticated applications.
345         Use your imagination.
346       </para>
347
348       <para>
349         The webservice API of pazpar2 is described in detail in <xref
350         linkend="pazpar2_protocol"/>.
351       </para>
352
353       <para>
354         In brief, you use the 'init' command to create a session, a
355         temporary workspace which carries information about the current
356         search. You start a new search using the 'search' command. Once the
357         search has been started, you can follow its progress using the
358         'stat', 'bytarget', 'termlist', or 'show' commands. Detailed records
359         can be fetched using the 'record' command.
360       </para>
361     </section>
362   </chapter> <!-- Using pazpar2 -->
363
364  <reference id="reference">
365   <title>Reference</title>
366   <partintro>
367    <para>
368     The material in this chapter is drawn directly from the individual
369     manual entries.
370    </para>
371   </partintro>
372   &manref;
373  </reference>
374
375  <appendix id="license"><title>License</title>
376   
377   <section id="gpl"><title>GPL</title>
378    
379    <para>
380     Pazpar2,
381     Copyright &copy; 2006-2007 Index Data.
382    </para>
383    
384    <para>
385     Pazpar2 is free software; you can redistribute it and/or modify it under
386     the terms of the GNU General Public License as published by the Free
387     Software Foundation; either version 2, or (at your option) any later
388     version.
389    </para>
390    
391    <para>
392     Pazpar2 is distributed in the hope that it will be useful, but WITHOUT ANY
393     WARRANTY; without even the implied warranty of MERCHANTABILITY or
394     FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
395     for more details.
396    </para>
397    
398    <para>
399     You should have received a copy of the GNU General Public License
400     along with Pazpar2; see the file LICENSE.  If not, write to the
401     Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
402     02111-1307, USA.
403    </para>
404    
405    <screen>
406                     GNU GENERAL PUBLIC LICENSE
407                        Version 2, June 1991
408
409  Copyright (C) 1989, 1991 Free Software Foundation, Inc.
410      59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
411  Everyone is permitted to copy and distribute verbatim copies
412  of this license document, but changing it is not allowed.
413
414                             Preamble
415
416   The licenses for most software are designed to take away your
417 freedom to share and change it.  By contrast, the GNU General Public
418 License is intended to guarantee your freedom to share and change free
419 software--to make sure the software is free for all its users.  This
420 General Public License applies to most of the Free Software
421 Foundation's software and to any other program whose authors commit to
422 using it.  (Some other Free Software Foundation software is covered by
423 the GNU Library General Public License instead.)  You can apply it to
424 your programs, too.
425
426   When we speak of free software, we are referring to freedom, not
427 price.  Our General Public Licenses are designed to make sure that you
428 have the freedom to distribute copies of free software (and charge for
429 this service if you wish), that you receive source code or can get it
430 if you want it, that you can change the software or use pieces of it
431 in new free programs; and that you know you can do these things.
432
433   To protect your rights, we need to make restrictions that forbid
434 anyone to deny you these rights or to ask you to surrender the rights.
435 These restrictions translate to certain responsibilities for you if you
436 distribute copies of the software, or if you modify it.
437
438   For example, if you distribute copies of such a program, whether
439 gratis or for a fee, you must give the recipients all the rights that
440 you have.  You must make sure that they, too, receive or can get the
441 source code.  And you must show them these terms so they know their
442 rights.
443
444   We protect your rights with two steps: (1) copyright the software, and
445 (2) offer you this license which gives you legal permission to copy,
446 distribute and/or modify the software.
447
448   Also, for each author's protection and ours, we want to make certain
449 that everyone understands that there is no warranty for this free
450 software.  If the software is modified by someone else and passed on, we
451 want its recipients to know that what they have is not the original, so
452 that any problems introduced by others will not reflect on the original
453 authors' reputations.
454
455   Finally, any free program is threatened constantly by software
456 patents.  We wish to avoid the danger that redistributors of a free
457 program will individually obtain patent licenses, in effect making the
458 program proprietary.  To prevent this, we have made it clear that any
459 patent must be licensed for everyone's free use or not licensed at all.
460
461   The precise terms and conditions for copying, distribution and
462 modification follow.
463
464                     GNU GENERAL PUBLIC LICENSE
465    TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
466
467   0. This License applies to any program or other work which contains
468 a notice placed by the copyright holder saying it may be distributed
469 under the terms of this General Public License.  The "Program", below,
470 refers to any such program or work, and a "work based on the Program"
471 means either the Program or any derivative work under copyright law:
472 that is to say, a work containing the Program or a portion of it,
473 either verbatim or with modifications and/or translated into another
474 language.  (Hereinafter, translation is included without limitation in
475 the term "modification".)  Each licensee is addressed as "you".
476
477 Activities other than copying, distribution and modification are not
478 covered by this License; they are outside its scope.  The act of
479 running the Program is not restricted, and the output from the Program
480 is covered only if its contents constitute a work based on the
481 Program (independent of having been made by running the Program).
482 Whether that is true depends on what the Program does.
483
484   1. You may copy and distribute verbatim copies of the Program's
485 source code as you receive it, in any medium, provided that you
486 conspicuously and appropriately publish on each copy an appropriate
487 copyright notice and disclaimer of warranty; keep intact all the
488 notices that refer to this License and to the absence of any warranty;
489 and give any other recipients of the Program a copy of this License
490 along with the Program.
491
492 You may charge a fee for the physical act of transferring a copy, and
493 you may at your option offer warranty protection in exchange for a fee.
494
495   2. You may modify your copy or copies of the Program or any portion
496 of it, thus forming a work based on the Program, and copy and
497 distribute such modifications or work under the terms of Section 1
498 above, provided that you also meet all of these conditions:
499
500     a) You must cause the modified files to carry prominent notices
501     stating that you changed the files and the date of any change.
502
503     b) You must cause any work that you distribute or publish, that in
504     whole or in part contains or is derived from the Program or any
505     part thereof, to be licensed as a whole at no charge to all third
506     parties under the terms of this License.
507
508     c) If the modified program normally reads commands interactively
509     when run, you must cause it, when started running for such
510     interactive use in the most ordinary way, to print or display an
511     announcement including an appropriate copyright notice and a
512     notice that there is no warranty (or else, saying that you provide
513     a warranty) and that users may redistribute the program under
514     these conditions, and telling the user how to view a copy of this
515     License.  (Exception: if the Program itself is interactive but
516     does not normally print such an announcement, your work based on
517     the Program is not required to print an announcement.)
518
519 These requirements apply to the modified work as a whole.  If
520 identifiable sections of that work are not derived from the Program,
521 and can be reasonably considered independent and separate works in
522 themselves, then this License, and its terms, do not apply to those
523 sections when you distribute them as separate works.  But when you
524 distribute the same sections as part of a whole which is a work based
525 on the Program, the distribution of the whole must be on the terms of
526 this License, whose permissions for other licensees extend to the
527 entire whole, and thus to each and every part regardless of who wrote it.
528
529 Thus, it is not the intent of this section to claim rights or contest
530 your rights to work written entirely by you; rather, the intent is to
531 exercise the right to control the distribution of derivative or
532 collective works based on the Program.
533
534 In addition, mere aggregation of another work not based on the Program
535 with the Program (or with a work based on the Program) on a volume of
536 a storage or distribution medium does not bring the other work under
537 the scope of this License.
538
539   3. You may copy and distribute the Program (or a work based on it,
540 under Section 2) in object code or executable form under the terms of
541 Sections 1 and 2 above provided that you also do one of the following:
542
543     a) Accompany it with the complete corresponding machine-readable
544     source code, which must be distributed under the terms of Sections
545     1 and 2 above on a medium customarily used for software interchange; or,
546
547     b) Accompany it with a written offer, valid for at least three
548     years, to give any third party, for a charge no more than your
549     cost of physically performing source distribution, a complete
550     machine-readable copy of the corresponding source code, to be
551     distributed under the terms of Sections 1 and 2 above on a medium
552     customarily used for software interchange; or,
553
554     c) Accompany it with the information you received as to the offer
555     to distribute corresponding source code.  (This alternative is
556     allowed only for noncommercial distribution and only if you
557     received the program in object code or executable form with such
558     an offer, in accord with Subsection b above.)
559
560 The source code for a work means the preferred form of the work for
561 making modifications to it.  For an executable work, complete source
562 code means all the source code for all modules it contains, plus any
563 associated interface definition files, plus the scripts used to
564 control compilation and installation of the executable.  However, as a
565 special exception, the source code distributed need not include
566 anything that is normally distributed (in either source or binary
567 form) with the major components (compiler, kernel, and so on) of the
568 operating system on which the executable runs, unless that component
569 itself accompanies the executable.
570
571 If distribution of executable or object code is made by offering
572 access to copy from a designated place, then offering equivalent
573 access to copy the source code from the same place counts as
574 distribution of the source code, even though third parties are not
575 compelled to copy the source along with the object code.
576
577   4. You may not copy, modify, sublicense, or distribute the Program
578 except as expressly provided under this License.  Any attempt
579 otherwise to copy, modify, sublicense or distribute the Program is
580 void, and will automatically terminate your rights under this License.
581 However, parties who have received copies, or rights, from you under
582 this License will not have their licenses terminated so long as such
583 parties remain in full compliance.
584
585   5. You are not required to accept this License, since you have not
586 signed it.  However, nothing else grants you permission to modify or
587 distribute the Program or its derivative works.  These actions are
588 prohibited by law if you do not accept this License.  Therefore, by
589 modifying or distributing the Program (or any work based on the
590 Program), you indicate your acceptance of this License to do so, and
591 all its terms and conditions for copying, distributing or modifying
592 the Program or works based on it.
593
594   6. Each time you redistribute the Program (or any work based on the
595 Program), the recipient automatically receives a license from the
596 original licensor to copy, distribute or modify the Program subject to
597 these terms and conditions.  You may not impose any further
598 restrictions on the recipients' exercise of the rights granted herein.
599 You are not responsible for enforcing compliance by third parties to
600 this License.
601
602   7. If, as a consequence of a court judgment or allegation of patent
603 infringement or for any other reason (not limited to patent issues),
604 conditions are imposed on you (whether by court order, agreement or
605 otherwise) that contradict the conditions of this License, they do not
606 excuse you from the conditions of this License.  If you cannot
607 distribute so as to satisfy simultaneously your obligations under this
608 License and any other pertinent obligations, then as a consequence you
609 may not distribute the Program at all.  For example, if a patent
610 license would not permit royalty-free redistribution of the Program by
611 all those who receive copies directly or indirectly through you, then
612 the only way you could satisfy both it and this License would be to
613 refrain entirely from distribution of the Program.
614
615 If any portion of this section is held invalid or unenforceable under
616 any particular circumstance, the balance of the section is intended to
617 apply and the section as a whole is intended to apply in other
618 circumstances.
619
620 It is not the purpose of this section to induce you to infringe any
621 patents or other property right claims or to contest validity of any
622 such claims; this section has the sole purpose of protecting the
623 integrity of the free software distribution system, which is
624 implemented by public license practices.  Many people have made
625 generous contributions to the wide range of software distributed
626 through that system in reliance on consistent application of that
627 system; it is up to the author/donor to decide if he or she is willing
628 to distribute software through any other system and a licensee cannot
629 impose that choice.
630
631 This section is intended to make thoroughly clear what is believed to
632 be a consequence of the rest of this License.
633
634   8. If the distribution and/or use of the Program is restricted in
635 certain countries either by patents or by copyrighted interfaces, the
636 original copyright holder who places the Program under this License
637 may add an explicit geographical distribution limitation excluding
638 those countries, so that distribution is permitted only in or among
639 countries not thus excluded.  In such case, this License incorporates
640 the limitation as if written in the body of this License.
641
642   9. The Free Software Foundation may publish revised and/or new versions
643 of the General Public License from time to time.  Such new versions will
644 be similar in spirit to the present version, but may differ in detail to
645 address new problems or concerns.
646
647 Each version is given a distinguishing version number.  If the Program
648 specifies a version number of this License which applies to it and "any
649 later version", you have the option of following the terms and conditions
650 either of that version or of any later version published by the Free
651 Software Foundation.  If the Program does not specify a version number of
652 this License, you may choose any version ever published by the Free Software
653 Foundation.
654
655   10. If you wish to incorporate parts of the Program into other free
656 programs whose distribution conditions are different, write to the author
657 to ask for permission.  For software which is copyrighted by the Free
658 Software Foundation, write to the Free Software Foundation; we sometimes
659 make exceptions for this.  Our decision will be guided by the two goals
660 of preserving the free status of all derivatives of our free software and
661 of promoting the sharing and reuse of software generally.
662
663                             NO WARRANTY
664
665   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
666 FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
667 OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
668 PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
669 OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
670 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
671 TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
672 PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
673 REPAIR OR CORRECTION.
674
675   12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
676 WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
677 REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
678 INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
679 OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
680 TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
681 YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
682 PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
683 POSSIBILITY OF SUCH DAMAGES.
684
685                      END OF TERMS AND CONDITIONS
686    </screen> 
687   </section>
688  </appendix>
689
690 </book>
691
692  <!-- Keep this comment at the end of the file
693  Local variables:
694  mode: sgml
695  sgml-omittag:t
696  sgml-shorttag:t
697  sgml-minimize-attributes:nil
698  sgml-always-quote-attributes:t
699  sgml-indent-step:1
700  sgml-indent-data:t
701  sgml-parent-document: nil
702  sgml-local-catalogs: nil
703  sgml-namecase-general:t
704  End:
705  -->