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"
5 <!ENTITY % local SYSTEM "local.ent">
7 <!ENTITY % entities SYSTEM "entities.ent">
9 <!ENTITY % idcommon SYSTEM "common/common.ent">
12 <!-- $Id: book.xml,v 1.16 2007-06-06 11:33:18 adam Exp $ -->
15 <title>Pazpar2 - User's Guide and Reference</title>
17 <firstname>Sebastian</firstname><surname>Hammer</surname>
20 <firstname>Adam</firstname><surname>Dickmeiss</surname>
23 <firstname>Marc</firstname><surname>Cromme</surname>
25 <releaseinfo>&version;</releaseinfo>
27 <year>©right-year;</year>
28 <holder>Index Data</holder>
32 Pazpar2 is a high-performance, user interface-independent, data
33 model-independent metasearching
34 middleware featuring merging, relevance ranking, record sorting,
38 This document is a guide and reference to Pazpar version &version;.
43 <imagedata fileref="common/id.png" format="PNG"/>
46 <imagedata fileref="common/id.eps" format="EPS"/>
53 <chapter id="introduction">
54 <title>Introduction</title>
56 Pazpar2 is a stand-alone metasearch client with a webservice API, designed
57 to be used either from a browser-based client (JavaScript, Flash, Java,
58 etc.), from from server-side code, or any combination of the two.
59 Pazpar2 is a highly optimized client designed to
60 search many resources in parallel. It implements record merging,
61 relevance-ranking and sorting by arbitrary data content, and facet
62 analysis for browsing purposes. It is designed to be data model
63 independent, and is capable of working with MARC, DublinCore, or any
64 other XML-structured response format -- XSLT is used to normalize and extract
65 data from retrieval records for display and analysis. It can be used
66 against any server which supports the Z39.50 protocol. Proprietary
67 backend modules can be used to support a large number of other protocols
68 (please contact Index Data for further information about this).
71 Additional functionality such as
72 user management, attractive displays are expected to be implemented by
73 applications that use pazpar2. Pazpar2 is user interface independent.
74 Its functionality is exposed through a simple REST-style webservice API,
75 designed to be simple to use from an Ajax-enbled browser, Flash
76 animation, Java applet, etc., or from a higher-level server-side language
77 like PHP or Java. Because session information can be shared between
78 browser-based logic and your server-side scripting, there is tremendous
79 flexibility in how you implement your business logic on top of pazpar2.
82 Once you launch a search in pazpar2, the operation continues behind the
83 scenes. Pazpar2 connects to servers, carries out searches, and
84 retrieves, deduplicates, and stores results internally. Your application
85 code may periodically inquire about the status of an ongoing operation,
86 and ask to see records or other result set facets. Result become
87 available immediately, and it is easy to build end-user interfaces which
88 feel extremely responsive, even when searching more than 100 servers
92 Pazpar2 is designed to be highly configurable. Incoming records are
93 normalized to XML/UTF-8, and then further normalized using XSLT to a
94 simple internal representation that is suitable for analysis. By
95 providing XSLT stylesheets for different kinds of result records, you
96 can tune pazpar2 to work against different kinds of information
97 retrieval servers. Finally, metadata is extracted, in a configurable
98 way, from this internal record, to support display, merging, ranking,
99 result set facets, and sorting. Pazpar2 is not bound to a specific model
100 of metadata, such as DublinCore or MARC -- by providing the right
101 configuration, it can work with a number of different kinds of data in
102 support of many different applications.
105 Pazpar2 is designed to be efficient and scalable. You can set it up to
106 search several hundred targets in parallel, or you can use it to support
107 hundreds of concurrent users. It is implemented with the same attention
108 to performance and economy that we use in our indexing engines, so that
109 you can focus on building your application, without worrying about the
110 details of metasearch logic. You can devote all of your attention to
111 usability and let pazpar2 do what it does best -- metasearch.
114 If you wish to connect to commercial or other databases which do not
115 support open standards, please contact Index Data. We have a licensing
116 agreement with a third party vendor which will enable pazpar2 to access
117 thousands of online databases, in addition the vast number of catalogs
118 and online services that support the Z39.50 protocol.
121 Pazpar2 is our attempt to re-think the traditional paradigms for
122 implementing and deploying metasearch logic, with an uncompromising
123 approach to performance, and attempting to make maximum use of the
124 capabilities of modern browsers. The demo user interface that
125 accompanies the distribution is but one example. If you think of new
126 ways of using pazpar2, we hope you'll share them with us, and if we
127 can provide assistance with regards to training, design, programming,
128 integration with different backends, hosting, or support, please don't
129 hesitate to contact us. If you'd like to see functionality in pazpar2
130 that is not there today, please don't hesitate to contact us. It may
131 already be in our development pipeline, or there might be a
132 possibility for you to help out by sponsoring development time or
133 code. Either way, get in touch and we will give you straight answers.
139 Pazpar2 is covered by the GNU license version 2.
140 See <xref linkend="license"/> for further information.
144 <chapter id="installation">
145 <title>Installation</title>
147 Pazpar2 depends on the following tools/libraries:
149 <varlistentry><term><ulink url="&url.yaz;">YAZ</ulink></term>
152 The popular Z39.50 toolkit for the C language. YAZ must be
153 compiled with Libxml2/Libxslt support.
157 <varlistentry><term><ulink url="&url.icu;">International
158 Components for Unicode (ICU)</ulink></term>
161 ICU provides Unicode support for non-english languages with
162 character sets outside the range of 7bit ASCII, like
163 Greek, Russian, German and Frensh. Pazpar2 uses the ICU
164 unicode character conversions, unicode normalization, case
165 folding and other fundamental operations needed in
166 tokenization, normalization and ranking of records.
169 Compiling, linking, and usage of the ICU libraries is optional,
170 but strongly recommended for usage in an international
178 In order to compile Pazpar2 an ANSI C compiler is
179 required. The requirements should be the same as for YAZ.
182 <section id="installation.unix">
183 <title>Installation on Unix (from Source)</title>
185 Here is a quick step-by-step guide on how to compile the
186 tools that Pazpar2 uses. Only few systems have none of the required
187 tools binary packages. If, for example, Libxml2/libxslt are already
188 installed as development packages use these.
192 Ensure that the development libraries + header files are
193 available on your system before compiling Pazpar2. For installation
194 of YAZ, refer to the YAZ installation chapter.
197 gunzip -c pazpar2-version.tar.gz|tar xf -
206 <section id="installation.debian">
207 <title>Installation on Debian GNU/Linux</title>
209 All dependencies for Pazpar2 are available as
210 <ulink url="&url.debian;">Debian</ulink>
211 packages for the sarge (stable in 2005) and etch (testing in 2005)
215 The procedures for Debian based systems, such as
216 <ulink url="&url.ubuntu;">Ubuntu</ulink> is probably similar
219 apt-get install libyaz-dev
220 apt-get install libicu36-dev
223 With these packages installed, the usual configure + make
224 procedure can be used for Pazpar2 as outlined in
225 <xref linkend="installation.unix"/>.
229 <section id="installation.apache2proxy">
230 <title>Apache 2 Proxy</title>
233 <ulink url="http://httpd.apache.org/docs/2.2/mod/mod_proxy.html">
235 </ulink> which allows Pazpar2 to become a backend to an Apache 2
236 based web service. The Apache 2 proxy must operate in the
237 <emphasis>Reverse</emphasis> Proxy mode.
241 On a Debian based Apache 2 system, the relevant modules can
244 sudo a2enmod proxy_http
249 Traditionnally Pazpar2 interprets URL paths with suffix
250 <literal>/search.pz2</literal>.
253 url="http://httpd.apache.org/docs/2.2/mod/mod_proxy.html#proxypass"
254 >ProxyPass</ulink> directive of Apache must be used to map a URL path
255 the the Pazpar2 server (listening port).
260 The ProxyPass directive takes a prefix rather than
261 a suffix as URL path. It is important that the Java Script code
262 uses the prefix given for it.
266 <example id="installation.apache2proxy.example">
267 <title>Apache 2 proxy configuration</title>
269 If Pazpar2 is running on port 9004 and the portal is using
270 <filename>search.pz2</filename> inside portal in directory
271 <filename>/myportal/</filename> we could use the following
272 Apache 2 configuration:
275 <IfModule mod_proxy.c>
279 AddDefaultCharset off
284 ProxyPass /myportal/search.pz2 http://localhost:9004/search.pz2
295 <title>Using pazpar2</title>
297 This chapter provides a general introduction to the use and
298 deployment of pazpar2.
301 <section id="architecture">
302 <title>Pazpar2 and your systems architecture</title>
304 Pazpar2 is designed to provide asynchronous, behind-the-scenes
305 metasearching functionality to your application, exposing this
306 functionality using a simple webservice API that can be accessed
307 from any number of development environments. In particular, it is
308 possible to combine pazpar2 either with your server-side dynamic
309 website scripting, with scripting or code running in the browser, or
310 with any combination of the two. Pazpar2 is an excellent tool for
311 building advanced, Ajax-based user interfaces for metasearch
312 functionality, but it isn't a requirement -- you can choose to use
313 pazpar2 entirely as a backend to your regular server-side scripting.
314 When you do use pazpar2 in conjunction
315 with browser scripting (JavaScript/Ajax, Flash, applets,
316 etc.), there are special considerations.
320 Pazpar2 implements a simple but efficient HTTP server, and it is
321 designed to interact directly with scripting running in the browser
322 for the best possible performance, and to limit overhead when
323 several browser clients generate numerous webservice requests.
324 However, it is still desirable to use a conventional webserver,
325 such as Apache, to serve up graphics, HTML documents, and
326 server-side scripting. Because the security sandbox environment of
327 most browser-side programming environments only allows communication
328 with the server from which the enclosing HTML page or object
329 originated, pazpar2 is designed so that it can act as a transparent
330 proxy in front of an existing webserver (see <xref
331 linkend="pazpar2_conf"/> for details). In this mode, all regular
332 HTTP requests are transparently passed through to your webserver,
333 while pazpar2 only intercepts search-related webservice requests.
337 If you want to expose your combined service on port 80, you can
338 either run your regular webserver on a different port, a different
339 server, or a different IP address associated with the same server.
343 Sometimes, it may be necessary to implement functionality on your
344 regular webserver that makes use of search results, for example to
345 implement data import functionality, emailing results, history
346 lists, personal citation lists, interlibrary loan functionality
347 ,etc. Fortunately, it is simple to exchange information between
348 pazpar2, your browser scripting, and backend server-side scripting.
349 You can send a session ID and possibly a record ID from your browser
350 code to your server code, and from there use pazpar2s webservice API
351 to access result sets or individual records. You could even 'hide'
352 all of pazpar2s functionality between your own API implemented on
353 the server-side, and access that from the browser or elsewhere. The
354 possibilities are just about endless.
358 <section id="data_model">
359 <title>Your data model</title>
361 Pazpar2 does not have a preconceived model of what makes up a data
362 model. There are no assumption that records have specific fields or
363 that they are organized in any particular way. The only assumption
364 is that data comes packaged in a form that the software can work
365 with (presently, that means XML or MARC), and that you can provide
366 the necessary information to massage it into pazpar2's internal
371 Handling retrieval records in pazpar2 is a two-step process. First,
372 you decide which data elements of the source record you are
373 interested in, and you specify any desired massaging or combining of
374 elements using an XSLT stylesheet (MARC records are automatically
375 normalized to MARCXML before this step). If desired, you can run
376 multiple XSLT stylesheets in series to accomplish this, but the
377 output of the last one should be a representation of the record in a
378 schema that pazpar2 understands.
382 The intermediate, internal representation of the record looks like
385 <record xmlns="http://www.indexdata.com/pazpar2/1.0"
386 mergekey="title The Shining author King, Stephen">
388 <metadata type="title">The Shining</metadata>
390 <metadata type="author">King, Stephen</metadata>
392 <metadata type="kind">ebook</metadata>
394 <!-- ... and so on -->
398 As you can see, there isn't much to it. There are really only a few
399 important elements to this file.
403 Elements should belong to the namespace
404 http://www.indexdata.com/pazpar2/1.0. If the root node contains the
405 attribute 'mergekey', then every record that generates the same
406 merge key (normalized for case differences, white space, and
407 truncation) will be joined into a cluster. In other words, you
408 decide how records are merged. If you don't include a merge key,
409 records are never merged. The 'metadata' elements provide the meat
410 of the elements -- the content. the 'type' attribute is used to
411 match each element against processing rules that determine what
412 happens to the data element next.
416 The next processing step is the extraction of metadata from the
417 intermediate representation of the record. This is governed by the
418 'metadata' elements in the 'service' section of the configuration
419 file. See <xref linkend="config-server"/> for details. The metadata
420 in the retrieval record ultimately drives merging, sorting, ranking,
421 the extraction of browse facets, and display, all configurable.
425 <section id="client">
426 <title>Client development overview</title>
428 You can use pazpar2 from any environment that allows you to use
429 webservices. The initial goal of the software was to support
430 Ajax-based applications, but there literally are no limits to what
431 you can do. You can use pazpar2 from Javascript, Flash, Java, etc.,
432 on the browser side, and from any development environment on the
433 server side, and you can pass session tokens and record IDs freely
434 around between these environments to build sophisticated applications.
435 Use your imagination.
439 The webservice API of pazpar2 is described in detail in <xref
440 linkend="pazpar2_protocol"/>.
444 In brief, you use the 'init' command to create a session, a
445 temporary workspace which carries information about the current
446 search. You start a new search using the 'search' command. Once the
447 search has been started, you can follow its progress using the
448 'stat', 'bytarget', 'termlist', or 'show' commands. Detailed records
449 can be fetched using the 'record' command.
453 <section id="nonstandard">
454 <title>Connecting to non-standard resources</title>
456 Pazpar2 uses Z39.50 as its switchboard language -- i.e. as far as it
457 is concerned, all resources speak Z39.50. It is, however, equipped
458 to handle a broad range of different server behavior, through
459 configurable query mapping and record normalization. If you develop
460 configuration, stylesheets, etc., for a new type of resources, we
461 encourage you to share your work. But you can also use pazpar2 to
462 connect to hundreds of resources that do not support standard
467 For a growing number of resources, Z39.50 is all you need. Over the
468 last few years, a number of commercial, full-text resources have
469 implemented Z39.50. These can be used through pazpar2 with little or
470 no effort. Resources that use non-standard record formats will
471 require a bit of XSLT work, but that's all.
475 But what about resources that don't support Z39.50 at all? The NISO
476 SRU (MXG) protocol is slowly gathering steam. Other resources might
477 support OpenSearch, private, XML/HTTP-based protocols, or something
478 else entirely. Some databases exist only as web user interfaces and
479 will require screen-scraping. Still others exist only as static
480 files, or perhaps as databases supporting the OAI-PMH protocol.
481 There is hope! Read on.
485 Index Data continues to advocate the support of open standards. We
486 work with database vendors to support standards, so you don't have
487 to worry about programming against non-standard services. We also
488 provide tools (see <ulink
489 url="http://www.indexdata.com/simpleserver">SimpleServer</ulink>)
490 which make it comparatively easy to build gateways against servers
491 with non-standard behavior. Again, we encourage you to share any
492 work you do in this direction.
496 But the bottom line is that working with non-standard resources in
497 metasearching is really, really hard. If you want to build a
498 project with pazpar2, and you need access to resources with
499 non-standard interfaces, we can help. We run gateways to more than
500 2,000 popular, commercial databases and other resources,
502 to plug them directly into pazpar2. For a small annual fee per
503 database, we can help you establish connections to your licensed
504 resources. Meanwhile, you can help! If you build your own
505 standards-compliant gateways, host them for others, or share the
506 code! And tell your vendors that they can save everybody money and
507 increase the appeal of their resources by supporting standards.
511 There are those who will ask us why we are using Z39.50 as our
512 switchboard langyage rather than a different protocol. Basically,
513 we believe that Z39.50 is presently the most widely implemented
514 information retrieval protocol that has the level of functionality
515 required to support a good metasearching experience (structured
516 searching, structured, well-defined results). It is also compact and
517 efficient, and there is a very broad range of tools available to
522 <section id="unicode">
523 <title>Unicode Compliance</title>
525 Pazpar2 is unicode compliant and language and locale aware to
526 the exted the used backend Z39.50 targets are. Just a few bad
527 behaving targets can spoil the search experience considerably
528 if for example Greek, Russian or otherwise non 7-bit ASCII
529 search terms are entered. In these cases some targets return
530 records irrelevant to the query, and the result screens wil be
531 cluttered with noise.
534 While noise from misbehaving targets can not be removed, it can
535 be reduced using truely unicode based ranking. This is an
536 option which is available to the system administrator if ICU
537 support is compiled into Pazpar2, see
538 <xref linkend="installation"/> for details.
541 In addition, the ICU tokenization and normalization rules must
542 be defined in the master configuration file described in
543 <xref linkend="config-server"/>.
547 </chapter> <!-- Using pazpar2 -->
549 <reference id="reference">
550 <title>Reference</title>
551 <partintro id="reference-introduction">
553 The material in this chapter is drawn directly from the individual
560 <appendix id="license"><title>License</title>
562 <section id="gpl"><title>GPL</title>
566 Copyright © ©right-year; Index Data.
570 Pazpar2 is free software; you can redistribute it and/or modify it under
571 the terms of the GNU General Public License as published by the Free
572 Software Foundation; either version 2, or (at your option) any later
577 Pazpar2 is distributed in the hope that it will be useful, but WITHOUT ANY
578 WARRANTY; without even the implied warranty of MERCHANTABILITY or
579 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
584 You should have received a copy of the GNU General Public License
585 along with Pazpar2; see the file LICENSE. If not, write to the
586 Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA
591 GNU GENERAL PUBLIC LICENSE
594 Copyright (C) 1989, 1991 Free Software Foundation, Inc.
595 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
596 Everyone is permitted to copy and distribute verbatim copies
597 of this license document, but changing it is not allowed.
601 The licenses for most software are designed to take away your
602 freedom to share and change it. By contrast, the GNU General Public
603 License is intended to guarantee your freedom to share and change free
604 software--to make sure the software is free for all its users. This
605 General Public License applies to most of the Free Software
606 Foundation's software and to any other program whose authors commit to
607 using it. (Some other Free Software Foundation software is covered by
608 the GNU Library General Public License instead.) You can apply it to
611 When we speak of free software, we are referring to freedom, not
612 price. Our General Public Licenses are designed to make sure that you
613 have the freedom to distribute copies of free software (and charge for
614 this service if you wish), that you receive source code or can get it
615 if you want it, that you can change the software or use pieces of it
616 in new free programs; and that you know you can do these things.
618 To protect your rights, we need to make restrictions that forbid
619 anyone to deny you these rights or to ask you to surrender the rights.
620 These restrictions translate to certain responsibilities for you if you
621 distribute copies of the software, or if you modify it.
623 For example, if you distribute copies of such a program, whether
624 gratis or for a fee, you must give the recipients all the rights that
625 you have. You must make sure that they, too, receive or can get the
626 source code. And you must show them these terms so they know their
629 We protect your rights with two steps: (1) copyright the software, and
630 (2) offer you this license which gives you legal permission to copy,
631 distribute and/or modify the software.
633 Also, for each author's protection and ours, we want to make certain
634 that everyone understands that there is no warranty for this free
635 software. If the software is modified by someone else and passed on, we
636 want its recipients to know that what they have is not the original, so
637 that any problems introduced by others will not reflect on the original
638 authors' reputations.
640 Finally, any free program is threatened constantly by software
641 patents. We wish to avoid the danger that redistributors of a free
642 program will individually obtain patent licenses, in effect making the
643 program proprietary. To prevent this, we have made it clear that any
644 patent must be licensed for everyone's free use or not licensed at all.
646 The precise terms and conditions for copying, distribution and
649 GNU GENERAL PUBLIC LICENSE
650 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
652 0. This License applies to any program or other work which contains
653 a notice placed by the copyright holder saying it may be distributed
654 under the terms of this General Public License. The "Program", below,
655 refers to any such program or work, and a "work based on the Program"
656 means either the Program or any derivative work under copyright law:
657 that is to say, a work containing the Program or a portion of it,
658 either verbatim or with modifications and/or translated into another
659 language. (Hereinafter, translation is included without limitation in
660 the term "modification".) Each licensee is addressed as "you".
662 Activities other than copying, distribution and modification are not
663 covered by this License; they are outside its scope. The act of
664 running the Program is not restricted, and the output from the Program
665 is covered only if its contents constitute a work based on the
666 Program (independent of having been made by running the Program).
667 Whether that is true depends on what the Program does.
669 1. You may copy and distribute verbatim copies of the Program's
670 source code as you receive it, in any medium, provided that you
671 conspicuously and appropriately publish on each copy an appropriate
672 copyright notice and disclaimer of warranty; keep intact all the
673 notices that refer to this License and to the absence of any warranty;
674 and give any other recipients of the Program a copy of this License
675 along with the Program.
677 You may charge a fee for the physical act of transferring a copy, and
678 you may at your option offer warranty protection in exchange for a fee.
680 2. You may modify your copy or copies of the Program or any portion
681 of it, thus forming a work based on the Program, and copy and
682 distribute such modifications or work under the terms of Section 1
683 above, provided that you also meet all of these conditions:
685 a) You must cause the modified files to carry prominent notices
686 stating that you changed the files and the date of any change.
688 b) You must cause any work that you distribute or publish, that in
689 whole or in part contains or is derived from the Program or any
690 part thereof, to be licensed as a whole at no charge to all third
691 parties under the terms of this License.
693 c) If the modified program normally reads commands interactively
694 when run, you must cause it, when started running for such
695 interactive use in the most ordinary way, to print or display an
696 announcement including an appropriate copyright notice and a
697 notice that there is no warranty (or else, saying that you provide
698 a warranty) and that users may redistribute the program under
699 these conditions, and telling the user how to view a copy of this
700 License. (Exception: if the Program itself is interactive but
701 does not normally print such an announcement, your work based on
702 the Program is not required to print an announcement.)
704 These requirements apply to the modified work as a whole. If
705 identifiable sections of that work are not derived from the Program,
706 and can be reasonably considered independent and separate works in
707 themselves, then this License, and its terms, do not apply to those
708 sections when you distribute them as separate works. But when you
709 distribute the same sections as part of a whole which is a work based
710 on the Program, the distribution of the whole must be on the terms of
711 this License, whose permissions for other licensees extend to the
712 entire whole, and thus to each and every part regardless of who wrote it.
714 Thus, it is not the intent of this section to claim rights or contest
715 your rights to work written entirely by you; rather, the intent is to
716 exercise the right to control the distribution of derivative or
717 collective works based on the Program.
719 In addition, mere aggregation of another work not based on the Program
720 with the Program (or with a work based on the Program) on a volume of
721 a storage or distribution medium does not bring the other work under
722 the scope of this License.
724 3. You may copy and distribute the Program (or a work based on it,
725 under Section 2) in object code or executable form under the terms of
726 Sections 1 and 2 above provided that you also do one of the following:
728 a) Accompany it with the complete corresponding machine-readable
729 source code, which must be distributed under the terms of Sections
730 1 and 2 above on a medium customarily used for software interchange; or,
732 b) Accompany it with a written offer, valid for at least three
733 years, to give any third party, for a charge no more than your
734 cost of physically performing source distribution, a complete
735 machine-readable copy of the corresponding source code, to be
736 distributed under the terms of Sections 1 and 2 above on a medium
737 customarily used for software interchange; or,
739 c) Accompany it with the information you received as to the offer
740 to distribute corresponding source code. (This alternative is
741 allowed only for noncommercial distribution and only if you
742 received the program in object code or executable form with such
743 an offer, in accord with Subsection b above.)
745 The source code for a work means the preferred form of the work for
746 making modifications to it. For an executable work, complete source
747 code means all the source code for all modules it contains, plus any
748 associated interface definition files, plus the scripts used to
749 control compilation and installation of the executable. However, as a
750 special exception, the source code distributed need not include
751 anything that is normally distributed (in either source or binary
752 form) with the major components (compiler, kernel, and so on) of the
753 operating system on which the executable runs, unless that component
754 itself accompanies the executable.
756 If distribution of executable or object code is made by offering
757 access to copy from a designated place, then offering equivalent
758 access to copy the source code from the same place counts as
759 distribution of the source code, even though third parties are not
760 compelled to copy the source along with the object code.
762 4. You may not copy, modify, sublicense, or distribute the Program
763 except as expressly provided under this License. Any attempt
764 otherwise to copy, modify, sublicense or distribute the Program is
765 void, and will automatically terminate your rights under this License.
766 However, parties who have received copies, or rights, from you under
767 this License will not have their licenses terminated so long as such
768 parties remain in full compliance.
770 5. You are not required to accept this License, since you have not
771 signed it. However, nothing else grants you permission to modify or
772 distribute the Program or its derivative works. These actions are
773 prohibited by law if you do not accept this License. Therefore, by
774 modifying or distributing the Program (or any work based on the
775 Program), you indicate your acceptance of this License to do so, and
776 all its terms and conditions for copying, distributing or modifying
777 the Program or works based on it.
779 6. Each time you redistribute the Program (or any work based on the
780 Program), the recipient automatically receives a license from the
781 original licensor to copy, distribute or modify the Program subject to
782 these terms and conditions. You may not impose any further
783 restrictions on the recipients' exercise of the rights granted herein.
784 You are not responsible for enforcing compliance by third parties to
787 7. If, as a consequence of a court judgment or allegation of patent
788 infringement or for any other reason (not limited to patent issues),
789 conditions are imposed on you (whether by court order, agreement or
790 otherwise) that contradict the conditions of this License, they do not
791 excuse you from the conditions of this License. If you cannot
792 distribute so as to satisfy simultaneously your obligations under this
793 License and any other pertinent obligations, then as a consequence you
794 may not distribute the Program at all. For example, if a patent
795 license would not permit royalty-free redistribution of the Program by
796 all those who receive copies directly or indirectly through you, then
797 the only way you could satisfy both it and this License would be to
798 refrain entirely from distribution of the Program.
800 If any portion of this section is held invalid or unenforceable under
801 any particular circumstance, the balance of the section is intended to
802 apply and the section as a whole is intended to apply in other
805 It is not the purpose of this section to induce you to infringe any
806 patents or other property right claims or to contest validity of any
807 such claims; this section has the sole purpose of protecting the
808 integrity of the free software distribution system, which is
809 implemented by public license practices. Many people have made
810 generous contributions to the wide range of software distributed
811 through that system in reliance on consistent application of that
812 system; it is up to the author/donor to decide if he or she is willing
813 to distribute software through any other system and a licensee cannot
816 This section is intended to make thoroughly clear what is believed to
817 be a consequence of the rest of this License.
819 8. If the distribution and/or use of the Program is restricted in
820 certain countries either by patents or by copyrighted interfaces, the
821 original copyright holder who places the Program under this License
822 may add an explicit geographical distribution limitation excluding
823 those countries, so that distribution is permitted only in or among
824 countries not thus excluded. In such case, this License incorporates
825 the limitation as if written in the body of this License.
827 9. The Free Software Foundation may publish revised and/or new versions
828 of the General Public License from time to time. Such new versions will
829 be similar in spirit to the present version, but may differ in detail to
830 address new problems or concerns.
832 Each version is given a distinguishing version number. If the Program
833 specifies a version number of this License which applies to it and "any
834 later version", you have the option of following the terms and conditions
835 either of that version or of any later version published by the Free
836 Software Foundation. If the Program does not specify a version number of
837 this License, you may choose any version ever published by the Free Software
840 10. If you wish to incorporate parts of the Program into other free
841 programs whose distribution conditions are different, write to the author
842 to ask for permission. For software which is copyrighted by the Free
843 Software Foundation, write to the Free Software Foundation; we sometimes
844 make exceptions for this. Our decision will be guided by the two goals
845 of preserving the free status of all derivatives of our free software and
846 of promoting the sharing and reuse of software generally.
850 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
851 FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
852 OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
853 PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
854 OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
855 MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
856 TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
857 PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
858 REPAIR OR CORRECTION.
860 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
861 WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
862 REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
863 INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
864 OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
865 TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
866 YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
867 PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
868 POSSIBILITY OF SUCH DAMAGES.
870 END OF TERMS AND CONDITIONS
877 <!-- Keep this comment at the end of the file
882 sgml-minimize-attributes:nil
883 sgml-always-quote-attributes:t
886 sgml-parent-document: nil
887 sgml-local-catalogs: nil
888 sgml-namecase-general:t