nhibernate 2.0.1.4000 → 2.1.0.4000

Sign up to get free protection for your applications and to get access to all the features.
Files changed (40) hide show
  1. data/docs/Antlr - Directory listing for -download-CSharp.url +5 -0
  2. data/docs/Configuration_Templates/FireBird.cfg.xml +31 -0
  3. data/docs/Configuration_Templates/MSSQL.cfg.xml +22 -0
  4. data/docs/Configuration_Templates/MySql.cfg.xml +17 -0
  5. data/docs/Configuration_Templates/Oracle.cfg.xml +19 -0
  6. data/docs/Configuration_Templates/PostgreSQL.cfg.xml +16 -0
  7. data/docs/Configuration_Templates/SQLite.cfg.xml +17 -0
  8. data/docs/HowInstall.txt +7 -0
  9. data/docs/LinFu.License.txt +167 -0
  10. data/docs/gfdl.txt +356 -0
  11. data/docs/{NHibernate.license.txt → lgpl.txt} +0 -0
  12. data/docs/nhibernate-configuration.xsd +12 -0
  13. data/docs/nhibernate-mapping.xsd +1312 -925
  14. data/docs/readme.html +60 -0
  15. data/docs/releasenotes.txt +418 -0
  16. data/lib/Required_Bins/Antlr3.Runtime.dll +0 -0
  17. data/lib/Required_Bins/Iesi.Collections.dll +0 -0
  18. data/lib/{Iesi.Collections.xml → Required_Bins/Iesi.Collections.xml} +16 -0
  19. data/lib/Required_Bins/NHibernate.Linq.dll +0 -0
  20. data/lib/Required_Bins/NHibernate.Linq.xml +725 -0
  21. data/lib/Required_Bins/NHibernate.dll +0 -0
  22. data/lib/{NHibernate.xml → Required_Bins/NHibernate.xml} +19837 -16023
  23. data/lib/Required_For_LazyLoading/Castle/NHibernate.ByteCode.Castle.dll +0 -0
  24. data/lib/Required_For_LazyLoading/Castle/NHibernate.ByteCode.Castle.xml +40 -0
  25. data/lib/Required_For_LazyLoading/Choose_Only_One.txt +2 -0
  26. data/lib/Required_For_LazyLoading/LinFu/LinFu.DynamicProxy.dll +0 -0
  27. data/lib/Required_For_LazyLoading/LinFu/NHibernate.ByteCode.LinFu.dll +0 -0
  28. data/lib/Required_For_LazyLoading/LinFu/NHibernate.ByteCode.LinFu.xml +8 -0
  29. data/lib/Required_For_LazyLoading/Spring/Common.Logging.dll +0 -0
  30. data/lib/Required_For_LazyLoading/Spring/NHibernate.ByteCode.Spring.dll +0 -0
  31. data/lib/Required_For_LazyLoading/Spring/NHibernate.ByteCode.Spring.xml +22 -0
  32. data/lib/Required_For_LazyLoading/Spring/Spring.Aop.dll +0 -0
  33. data/lib/Required_For_LazyLoading/Spring/Spring.Aop.xml +11277 -0
  34. data/lib/Required_For_LazyLoading/Spring/Spring.Core.dll +0 -0
  35. data/lib/Required_For_LazyLoading/Spring/Spring.Core.xml +45248 -0
  36. data/lib/Required_For_LazyLoading/Spring/antlr.runtime.dll +0 -0
  37. metadata +42 -15
  38. data/docs/Iesi.Collections.license.txt +0 -9
  39. data/lib/Iesi.Collections.dll +0 -0
  40. data/lib/NHibernate.dll +0 -0
@@ -0,0 +1,5 @@
1
+ [{000214A0-0000-0000-C000-000000000046}]
2
+ Prop3=19,2
3
+ [InternetShortcut]
4
+ URL=http://www.antlr.org/download/CSharp
5
+ IDList=
@@ -0,0 +1,31 @@
1
+ <?xml version="1.0" encoding="utf-8" ?>
2
+ <!--
3
+ To work with FireBird you must add the assembly binding for FirebirdClient ADO.NET 2.0 DataProvider
4
+ to your App.config.
5
+ Example:
6
+ <runtime>
7
+ <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
8
+ <qualifyAssembly partialName="FirebirdSql.Data.FirebirdClient" fullName="FirebirdSql.Data.FirebirdClient, Version=2.0.1.0, Culture=neutral, PublicKeyToken=3750abcc3150b00c" />
9
+ </assemblyBinding>
10
+ </runtime>
11
+ -->
12
+ <!--
13
+ This template was written to work with NHibernate.Test.
14
+ Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it
15
+ for your own use before compile tests in VisualStudio.
16
+ -->
17
+ <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
18
+ <session-factory name="NHibernate.Test">
19
+ <property name="connection.driver_class">NHibernate.Driver.FirebirdClientDriver</property>
20
+ <property name="connection.connection_string">
21
+ Server=localhost;
22
+ Database=C:\nhibernate.fdb;
23
+ User=SYSDBA;Password=masterkey
24
+ </property>
25
+ <property name="show_sql">false</property>
26
+ <property name="dialect">NHibernate.Dialect.FirebirdDialect</property>
27
+ <property name="command_timeout">60</property>
28
+ <property name="query.substitutions">true 1, false 0, yes 1, no 0</property>
29
+ <property name="proxyfactory.factory_class">NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>
30
+ </session-factory>
31
+ </hibernate-configuration>
@@ -0,0 +1,22 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!--
3
+ This template was written to work with NHibernate.Test.
4
+ Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it
5
+ for your own use before compile tests in VisualStudio.
6
+ -->
7
+ <!-- This is the System.Data.dll provider for SQL Server -->
8
+ <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
9
+ <session-factory name="NHibernate.Test">
10
+ <property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property>
11
+ <property name="connection.connection_string">
12
+ Server=(local);initial catalog=nhibernate;Integrated Security=SSPI
13
+ </property>
14
+ <property name="adonet.batch_size">10</property>
15
+ <property name="show_sql">false</property>
16
+ <property name="dialect">NHibernate.Dialect.MsSql2000Dialect</property>
17
+ <property name="use_outer_join">true</property>
18
+ <property name="command_timeout">60</property>
19
+ <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property>
20
+ <property name="proxyfactory.factory_class">NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>
21
+ </session-factory>
22
+ </hibernate-configuration>
@@ -0,0 +1,17 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!--
3
+ This template was written to work with NHibernate.Test.
4
+ Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it
5
+ for your own use before compile tests in VisualStudio.
6
+ -->
7
+ <!-- This is the ByteFX.Data.dll provider for MySql -->
8
+ <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
9
+ <session-factory name="NHibernate.Test">
10
+ <property name="connection.driver_class">NHibernate.Driver.MySqlDataDriver</property>
11
+ <property name="connection.connection_string">
12
+ Database=test;Data Source=someip;User Id=blah;Password=blah
13
+ </property>
14
+ <property name="dialect">NHibernate.Dialect.MySQLDialect</property>
15
+ <property name="proxyfactory.factory_class">NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>
16
+ </session-factory>
17
+ </hibernate-configuration>
@@ -0,0 +1,19 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!--
3
+ This template was written to work with NHibernate.Test.
4
+ Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it
5
+ for your own use before compile tests in VisualStudio.
6
+ -->
7
+ <!-- This is the System.Data.OracleClient.dll provider for Oracle from MS -->
8
+ <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
9
+ <session-factory name="NHibernate.Test">
10
+ <property name="connection.driver_class">NHibernate.Driver.OracleClientDriver</property>
11
+ <property name="connection.connection_string">
12
+ User ID=nhibernate;Password=nhibernate;Data Source=localhost
13
+ </property>
14
+ <property name="show_sql">false</property>
15
+ <property name="dialect">NHibernate.Dialect.OracleDialect</property>
16
+ <property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property>
17
+ <property name="proxyfactory.factory_class">NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>
18
+ </session-factory>
19
+ </hibernate-configuration>
@@ -0,0 +1,16 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!--
3
+ This template was written to work with NHibernate.Test.
4
+ Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it
5
+ for your own use before compile tests in VisualStudio.
6
+ -->
7
+ <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
8
+ <session-factory name="NHibernate.Test">
9
+ <property name="connection.driver_class">NHibernate.Driver.NpgsqlDriver</property>
10
+ <property name="connection.connection_string">
11
+ Server=localhost;initial catalog=nhibernate;User ID=nhibernate;Password=nhibernate;
12
+ </property>
13
+ <property name="dialect">NHibernate.Dialect.PostgreSQLDialect</property>
14
+ <property name="proxyfactory.factory_class">NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>
15
+ </session-factory>
16
+ </hibernate-configuration>
@@ -0,0 +1,17 @@
1
+ <?xml version="1.0" encoding="utf-8"?>
2
+ <!--
3
+ This template was written to work with NHibernate.Test.
4
+ Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it
5
+ for your own use before compile tests in VisualStudio.
6
+ -->
7
+ <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >
8
+ <session-factory name="NHibernate.Test">
9
+ <property name="connection.driver_class">NHibernate.Driver.SQLiteDriver</property>
10
+ <property name="connection.connection_string">
11
+ Data Source=nhibernate.db;Version=3
12
+ </property>
13
+ <property name="dialect">NHibernate.Dialect.SQLiteDialect</property>
14
+ <property name="query.substitutions">true=1;false=0</property>
15
+ <property name="proxyfactory.factory_class">NHibernate.ByteCode.LinFu.ProxyFactoryFactory, NHibernate.ByteCode.LinFu</property>
16
+ </session-factory>
17
+ </hibernate-configuration>
@@ -0,0 +1,7 @@
1
+ Required Bins : Minimal required assemblies to work with NHibernate
2
+
3
+
4
+ Required for LazyLoading :
5
+ NHibernate 2.1 has a new important feature regarding dynamic-proxy systems for lazy-loading
6
+ Details are available in releasenotes.txt and in this post
7
+ http://nhforge.org/blogs/nhibernate/archive/2008/11/09/nh2-1-0-bytecode-providers.aspx
@@ -0,0 +1,167 @@
1
+ The LinFu Library, (c) 2007 Philip Laureano, is subject to the terms of the following license:
2
+
3
+ GNU LESSER GENERAL PUBLIC LICENSE
4
+ Version 3, 29 June 2007
5
+
6
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
7
+ Everyone is permitted to copy and distribute verbatim copies
8
+ of this license document, but changing it is not allowed.
9
+
10
+
11
+ This version of the GNU Lesser General Public License incorporates
12
+ the terms and conditions of version 3 of the GNU General Public
13
+ License, supplemented by the additional permissions listed below.
14
+
15
+ 0. Additional Definitions.
16
+
17
+ As used herein, "this License" refers to version 3 of the GNU Lesser
18
+ General Public License, and the "GNU GPL" refers to version 3 of the GNU
19
+ General Public License.
20
+
21
+ "The Library" refers to a covered work governed by this License,
22
+ other than an Application or a Combined Work as defined below.
23
+
24
+ An "Application" is any work that makes use of an interface provided
25
+ by the Library, but which is not otherwise based on the Library.
26
+ Defining a subclass of a class defined by the Library is deemed a mode
27
+ of using an interface provided by the Library.
28
+
29
+ A "Combined Work" is a work produced by combining or linking an
30
+ Application with the Library. The particular version of the Library
31
+ with which the Combined Work was made is also called the "Linked
32
+ Version".
33
+
34
+ The "Minimal Corresponding Source" for a Combined Work means the
35
+ Corresponding Source for the Combined Work, excluding any source code
36
+ for portions of the Combined Work that, considered in isolation, are
37
+ based on the Application, and not on the Linked Version.
38
+
39
+ The "Corresponding Application Code" for a Combined Work means the
40
+ object code and/or source code for the Application, including any data
41
+ and utility programs needed for reproducing the Combined Work from the
42
+ Application, but excluding the System Libraries of the Combined Work.
43
+
44
+ 1. Exception to Section 3 of the GNU GPL.
45
+
46
+ You may convey a covered work under sections 3 and 4 of this License
47
+ without being bound by section 3 of the GNU GPL.
48
+
49
+ 2. Conveying Modified Versions.
50
+
51
+ If you modify a copy of the Library, and, in your modifications, a
52
+ facility refers to a function or data to be supplied by an Application
53
+ that uses the facility (other than as an argument passed when the
54
+ facility is invoked), then you may convey a copy of the modified
55
+ version:
56
+
57
+ a) under this License, provided that you make a good faith effort to
58
+ ensure that, in the event an Application does not supply the
59
+ function or data, the facility still operates, and performs
60
+ whatever part of its purpose remains meaningful, or
61
+
62
+ b) under the GNU GPL, with none of the additional permissions of
63
+ this License applicable to that copy.
64
+
65
+ 3. Object Code Incorporating Material from Library Header Files.
66
+
67
+ The object code form of an Application may incorporate material from
68
+ a header file that is part of the Library. You may convey such object
69
+ code under terms of your choice, provided that, if the incorporated
70
+ material is not limited to numerical parameters, data structure
71
+ layouts and accessors, or small macros, inline functions and templates
72
+ (ten or fewer lines in length), you do both of the following:
73
+
74
+ a) Give prominent notice with each copy of the object code that the
75
+ Library is used in it and that the Library and its use are
76
+ covered by this License.
77
+
78
+ b) Accompany the object code with a copy of the GNU GPL and this license
79
+ document.
80
+
81
+ 4. Combined Works.
82
+
83
+ You may convey a Combined Work under terms of your choice that,
84
+ taken together, effectively do not restrict modification of the
85
+ portions of the Library contained in the Combined Work and reverse
86
+ engineering for debugging such modifications, if you also do each of
87
+ the following:
88
+
89
+ a) Give prominent notice with each copy of the Combined Work that
90
+ the Library is used in it and that the Library and its use are
91
+ covered by this License.
92
+
93
+ b) Accompany the Combined Work with a copy of the GNU GPL and this license
94
+ document.
95
+
96
+ c) For a Combined Work that displays copyright notices during
97
+ execution, include the copyright notice for the Library among
98
+ these notices, as well as a reference directing the user to the
99
+ copies of the GNU GPL and this license document.
100
+
101
+ d) Do one of the following:
102
+
103
+ 0) Convey the Minimal Corresponding Source under the terms of this
104
+ License, and the Corresponding Application Code in a form
105
+ suitable for, and under terms that permit, the user to
106
+ recombine or relink the Application with a modified version of
107
+ the Linked Version to produce a modified Combined Work, in the
108
+ manner specified by section 6 of the GNU GPL for conveying
109
+ Corresponding Source.
110
+
111
+ 1) Use a suitable shared library mechanism for linking with the
112
+ Library. A suitable mechanism is one that (a) uses at run time
113
+ a copy of the Library already present on the user's computer
114
+ system, and (b) will operate properly with a modified version
115
+ of the Library that is interface-compatible with the Linked
116
+ Version.
117
+
118
+ e) Provide Installation Information, but only if you would otherwise
119
+ be required to provide such information under section 6 of the
120
+ GNU GPL, and only to the extent that such information is
121
+ necessary to install and execute a modified version of the
122
+ Combined Work produced by recombining or relinking the
123
+ Application with a modified version of the Linked Version. (If
124
+ you use option 4d0, the Installation Information must accompany
125
+ the Minimal Corresponding Source and Corresponding Application
126
+ Code. If you use option 4d1, you must provide the Installation
127
+ Information in the manner specified by section 6 of the GNU GPL
128
+ for conveying Corresponding Source.)
129
+
130
+ 5. Combined Libraries.
131
+
132
+ You may place library facilities that are a work based on the
133
+ Library side by side in a single library together with other library
134
+ facilities that are not Applications and are not covered by this
135
+ License, and convey such a combined library under terms of your
136
+ choice, if you do both of the following:
137
+
138
+ a) Accompany the combined library with a copy of the same work based
139
+ on the Library, uncombined with any other library facilities,
140
+ conveyed under the terms of this License.
141
+
142
+ b) Give prominent notice with the combined library that part of it
143
+ is a work based on the Library, and explaining where to find the
144
+ accompanying uncombined form of the same work.
145
+
146
+ 6. Revised Versions of the GNU Lesser General Public License.
147
+
148
+ The Free Software Foundation may publish revised and/or new versions
149
+ of the GNU Lesser General Public License from time to time. Such new
150
+ versions will be similar in spirit to the present version, but may
151
+ differ in detail to address new problems or concerns.
152
+
153
+ Each version is given a distinguishing version number. If the
154
+ Library as you received it specifies that a certain numbered version
155
+ of the GNU Lesser General Public License "or any later version"
156
+ applies to it, you have the option of following the terms and
157
+ conditions either of that published version or of any later version
158
+ published by the Free Software Foundation. If the Library as you
159
+ received it does not specify a version number of the GNU Lesser
160
+ General Public License, you may choose any version of the GNU Lesser
161
+ General Public License ever published by the Free Software Foundation.
162
+
163
+ If the Library as you received it specifies that a proxy can decide
164
+ whether future versions of the GNU Lesser General Public License shall
165
+ apply, that proxy's public statement of acceptance of any version is
166
+ permanent authorization for you to choose that version for the
167
+ Library.
data/docs/gfdl.txt ADDED
@@ -0,0 +1,356 @@
1
+ GNU Free Documentation License
2
+ Version 1.1, March 2000
3
+
4
+ Copyright (C) 2000 Free Software Foundation, Inc.
5
+ 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
6
+
7
+ Everyone is permitted to copy and distribute verbatim copies
8
+ of this license document, but changing it is not allowed.
9
+
10
+
11
+ 0. PREAMBLE
12
+
13
+ The purpose of this License is to make a manual, textbook, or other
14
+ written document "free" in the sense of freedom: to assure everyone
15
+ the effective freedom to copy and redistribute it, with or without
16
+ modifying it, either commercially or noncommercially. Secondarily,
17
+ this License preserves for the author and publisher a way to get
18
+ credit for their work, while not being considered responsible for
19
+ modifications made by others.
20
+
21
+ This License is a kind of "copyleft", which means that derivative
22
+ works of the document must themselves be free in the same sense. It
23
+ complements the GNU General Public License, which is a copyleft
24
+ license designed for free software.
25
+
26
+ We have designed this License in order to use it for manuals for free
27
+ software, because free software needs free documentation: a free
28
+ program should come with manuals providing the same freedoms that the
29
+ software does. But this License is not limited to software manuals;
30
+ it can be used for any textual work, regardless of subject matter or
31
+ whether it is published as a printed book. We recommend this License
32
+ principally for works whose purpose is instruction or reference.
33
+
34
+
35
+ 1. APPLICABILITY AND DEFINITIONS
36
+
37
+ This License applies to any manual or other work that contains a
38
+ notice placed by the copyright holder saying it can be distributed
39
+ under the terms of this License. The "Document", below, refers to any
40
+ such manual or work. Any member of the public is a licensee, and is
41
+ addressed as "you".
42
+
43
+ A "Modified Version" of the Document means any work containing the
44
+ Document or a portion of it, either copied verbatim, or with
45
+ modifications and/or translated into another language.
46
+
47
+ A "Secondary Section" is a named appendix or a front-matter section of
48
+ the Document that deals exclusively with the relationship of the
49
+ publishers or authors of the Document to the Document's overall subject
50
+ (or to related matters) and contains nothing that could fall directly
51
+ within that overall subject. (For example, if the Document is in part a
52
+ textbook of mathematics, a Secondary Section may not explain any
53
+ mathematics.) The relationship could be a matter of historical
54
+ connection with the subject or with related matters, or of legal,
55
+ commercial, philosophical, ethical or political position regarding
56
+ them.
57
+
58
+ The "Invariant Sections" are certain Secondary Sections whose titles
59
+ are designated, as being those of Invariant Sections, in the notice
60
+ that says that the Document is released under this License.
61
+
62
+ The "Cover Texts" are certain short passages of text that are listed,
63
+ as Front-Cover Texts or Back-Cover Texts, in the notice that says that
64
+ the Document is released under this License.
65
+
66
+ A "Transparent" copy of the Document means a machine-readable copy,
67
+ represented in a format whose specification is available to the
68
+ general public, whose contents can be viewed and edited directly and
69
+ straightforwardly with generic text editors or (for images composed of
70
+ pixels) generic paint programs or (for drawings) some widely available
71
+ drawing editor, and that is suitable for input to text formatters or
72
+ for automatic translation to a variety of formats suitable for input
73
+ to text formatters. A copy made in an otherwise Transparent file
74
+ format whose markup has been designed to thwart or discourage
75
+ subsequent modification by readers is not Transparent. A copy that is
76
+ not "Transparent" is called "Opaque".
77
+
78
+ Examples of suitable formats for Transparent copies include plain
79
+ ASCII without markup, Texinfo input format, LaTeX input format, SGML
80
+ or XML using a publicly available DTD, and standard-conforming simple
81
+ HTML designed for human modification. Opaque formats include
82
+ PostScript, PDF, proprietary formats that can be read and edited only
83
+ by proprietary word processors, SGML or XML for which the DTD and/or
84
+ processing tools are not generally available, and the
85
+ machine-generated HTML produced by some word processors for output
86
+ purposes only.
87
+
88
+ The "Title Page" means, for a printed book, the title page itself,
89
+ plus such following pages as are needed to hold, legibly, the material
90
+ this License requires to appear in the title page. For works in
91
+ formats which do not have any title page as such, "Title Page" means
92
+ the text near the most prominent appearance of the work's title,
93
+ preceding the beginning of the body of the text.
94
+
95
+
96
+ 2. VERBATIM COPYING
97
+
98
+ You may copy and distribute the Document in any medium, either
99
+ commercially or noncommercially, provided that this License, the
100
+ copyright notices, and the license notice saying this License applies
101
+ to the Document are reproduced in all copies, and that you add no other
102
+ conditions whatsoever to those of this License. You may not use
103
+ technical measures to obstruct or control the reading or further
104
+ copying of the copies you make or distribute. However, you may accept
105
+ compensation in exchange for copies. If you distribute a large enough
106
+ number of copies you must also follow the conditions in section 3.
107
+
108
+ You may also lend copies, under the same conditions stated above, and
109
+ you may publicly display copies.
110
+
111
+
112
+ 3. COPYING IN QUANTITY
113
+
114
+ If you publish printed copies of the Document numbering more than 100,
115
+ and the Document's license notice requires Cover Texts, you must enclose
116
+ the copies in covers that carry, clearly and legibly, all these Cover
117
+ Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
118
+ the back cover. Both covers must also clearly and legibly identify
119
+ you as the publisher of these copies. The front cover must present
120
+ the full title with all words of the title equally prominent and
121
+ visible. You may add other material on the covers in addition.
122
+ Copying with changes limited to the covers, as long as they preserve
123
+ the title of the Document and satisfy these conditions, can be treated
124
+ as verbatim copying in other respects.
125
+
126
+ If the required texts for either cover are too voluminous to fit
127
+ legibly, you should put the first ones listed (as many as fit
128
+ reasonably) on the actual cover, and continue the rest onto adjacent
129
+ pages.
130
+
131
+ If you publish or distribute Opaque copies of the Document numbering
132
+ more than 100, you must either include a machine-readable Transparent
133
+ copy along with each Opaque copy, or state in or with each Opaque copy
134
+ a publicly-accessible computer-network location containing a complete
135
+ Transparent copy of the Document, free of added material, which the
136
+ general network-using public has access to download anonymously at no
137
+ charge using public-standard network protocols. If you use the latter
138
+ option, you must take reasonably prudent steps, when you begin
139
+ distribution of Opaque copies in quantity, to ensure that this
140
+ Transparent copy will remain thus accessible at the stated location
141
+ until at least one year after the last time you distribute an Opaque
142
+ copy (directly or through your agents or retailers) of that edition to
143
+ the public.
144
+
145
+ It is requested, but not required, that you contact the authors of the
146
+ Document well before redistributing any large number of copies, to give
147
+ them a chance to provide you with an updated version of the Document.
148
+
149
+
150
+ 4. MODIFICATIONS
151
+
152
+ You may copy and distribute a Modified Version of the Document under
153
+ the conditions of sections 2 and 3 above, provided that you release
154
+ the Modified Version under precisely this License, with the Modified
155
+ Version filling the role of the Document, thus licensing distribution
156
+ and modification of the Modified Version to whoever possesses a copy
157
+ of it. In addition, you must do these things in the Modified Version:
158
+
159
+ A. Use in the Title Page (and on the covers, if any) a title distinct
160
+ from that of the Document, and from those of previous versions
161
+ (which should, if there were any, be listed in the History section
162
+ of the Document). You may use the same title as a previous version
163
+ if the original publisher of that version gives permission.
164
+ B. List on the Title Page, as authors, one or more persons or entities
165
+ responsible for authorship of the modifications in the Modified
166
+ Version, together with at least five of the principal authors of the
167
+ Document (all of its principal authors, if it has less than five).
168
+ C. State on the Title page the name of the publisher of the
169
+ Modified Version, as the publisher.
170
+ D. Preserve all the copyright notices of the Document.
171
+ E. Add an appropriate copyright notice for your modifications
172
+ adjacent to the other copyright notices.
173
+ F. Include, immediately after the copyright notices, a license notice
174
+ giving the public permission to use the Modified Version under the
175
+ terms of this License, in the form shown in the Addendum below.
176
+ G. Preserve in that license notice the full lists of Invariant Sections
177
+ and required Cover Texts given in the Document's license notice.
178
+ H. Include an unaltered copy of this License.
179
+ I. Preserve the section entitled "History", and its title, and add to
180
+ it an item stating at least the title, year, new authors, and
181
+ publisher of the Modified Version as given on the Title Page. If
182
+ there is no section entitled "History" in the Document, create one
183
+ stating the title, year, authors, and publisher of the Document as
184
+ given on its Title Page, then add an item describing the Modified
185
+ Version as stated in the previous sentence.
186
+ J. Preserve the network location, if any, given in the Document for
187
+ public access to a Transparent copy of the Document, and likewise
188
+ the network locations given in the Document for previous versions
189
+ it was based on. These may be placed in the "History" section.
190
+ You may omit a network location for a work that was published at
191
+ least four years before the Document itself, or if the original
192
+ publisher of the version it refers to gives permission.
193
+ K. In any section entitled "Acknowledgements" or "Dedications",
194
+ preserve the section's title, and preserve in the section all the
195
+ substance and tone of each of the contributor acknowledgements
196
+ and/or dedications given therein.
197
+ L. Preserve all the Invariant Sections of the Document,
198
+ unaltered in their text and in their titles. Section numbers
199
+ or the equivalent are not considered part of the section titles.
200
+ M. Delete any section entitled "Endorsements". Such a section
201
+ may not be included in the Modified Version.
202
+ N. Do not retitle any existing section as "Endorsements"
203
+ or to conflict in title with any Invariant Section.
204
+
205
+ If the Modified Version includes new front-matter sections or
206
+ appendices that qualify as Secondary Sections and contain no material
207
+ copied from the Document, you may at your option designate some or all
208
+ of these sections as invariant. To do this, add their titles to the
209
+ list of Invariant Sections in the Modified Version's license notice.
210
+ These titles must be distinct from any other section titles.
211
+
212
+ You may add a section entitled "Endorsements", provided it contains
213
+ nothing but endorsements of your Modified Version by various
214
+ parties--for example, statements of peer review or that the text has
215
+ been approved by an organization as the authoritative definition of a
216
+ standard.
217
+
218
+ You may add a passage of up to five words as a Front-Cover Text, and a
219
+ passage of up to 25 words as a Back-Cover Text, to the end of the list
220
+ of Cover Texts in the Modified Version. Only one passage of
221
+ Front-Cover Text and one of Back-Cover Text may be added by (or
222
+ through arrangements made by) any one entity. If the Document already
223
+ includes a cover text for the same cover, previously added by you or
224
+ by arrangement made by the same entity you are acting on behalf of,
225
+ you may not add another; but you may replace the old one, on explicit
226
+ permission from the previous publisher that added the old one.
227
+
228
+ The author(s) and publisher(s) of the Document do not by this License
229
+ give permission to use their names for publicity for or to assert or
230
+ imply endorsement of any Modified Version.
231
+
232
+
233
+ 5. COMBINING DOCUMENTS
234
+
235
+ You may combine the Document with other documents released under this
236
+ License, under the terms defined in section 4 above for modified
237
+ versions, provided that you include in the combination all of the
238
+ Invariant Sections of all of the original documents, unmodified, and
239
+ list them all as Invariant Sections of your combined work in its
240
+ license notice.
241
+
242
+ The combined work need only contain one copy of this License, and
243
+ multiple identical Invariant Sections may be replaced with a single
244
+ copy. If there are multiple Invariant Sections with the same name but
245
+ different contents, make the title of each such section unique by
246
+ adding at the end of it, in parentheses, the name of the original
247
+ author or publisher of that section if known, or else a unique number.
248
+ Make the same adjustment to the section titles in the list of
249
+ Invariant Sections in the license notice of the combined work.
250
+
251
+ In the combination, you must combine any sections entitled "History"
252
+ in the various original documents, forming one section entitled
253
+ "History"; likewise combine any sections entitled "Acknowledgements",
254
+ and any sections entitled "Dedications". You must delete all sections
255
+ entitled "Endorsements."
256
+
257
+
258
+ 6. COLLECTIONS OF DOCUMENTS
259
+
260
+ You may make a collection consisting of the Document and other documents
261
+ released under this License, and replace the individual copies of this
262
+ License in the various documents with a single copy that is included in
263
+ the collection, provided that you follow the rules of this License for
264
+ verbatim copying of each of the documents in all other respects.
265
+
266
+ You may extract a single document from such a collection, and distribute
267
+ it individually under this License, provided you insert a copy of this
268
+ License into the extracted document, and follow this License in all
269
+ other respects regarding verbatim copying of that document.
270
+
271
+
272
+ 7. AGGREGATION WITH INDEPENDENT WORKS
273
+
274
+ A compilation of the Document or its derivatives with other separate
275
+ and independent documents or works, in or on a volume of a storage or
276
+ distribution medium, does not as a whole count as a Modified Version
277
+ of the Document, provided no compilation copyright is claimed for the
278
+ compilation. Such a compilation is called an "aggregate", and this
279
+ License does not apply to the other self-contained works thus compiled
280
+ with the Document, on account of their being thus compiled, if they
281
+ are not themselves derivative works of the Document.
282
+
283
+ If the Cover Text requirement of section 3 is applicable to these
284
+ copies of the Document, then if the Document is less than one quarter
285
+ of the entire aggregate, the Document's Cover Texts may be placed on
286
+ covers that surround only the Document within the aggregate.
287
+ Otherwise they must appear on covers around the whole aggregate.
288
+
289
+
290
+ 8. TRANSLATION
291
+
292
+ Translation is considered a kind of modification, so you may
293
+ distribute translations of the Document under the terms of section 4.
294
+ Replacing Invariant Sections with translations requires special
295
+ permission from their copyright holders, but you may include
296
+ translations of some or all Invariant Sections in addition to the
297
+ original versions of these Invariant Sections. You may include a
298
+ translation of this License provided that you also include the
299
+ original English version of this License. In case of a disagreement
300
+ between the translation and the original English version of this
301
+ License, the original English version will prevail.
302
+
303
+
304
+ 9. TERMINATION
305
+
306
+ You may not copy, modify, sublicense, or distribute the Document except
307
+ as expressly provided for under this License. Any other attempt to
308
+ copy, modify, sublicense or distribute the Document is void, and will
309
+ automatically terminate your rights under this License. However,
310
+ parties who have received copies, or rights, from you under this
311
+ License will not have their licenses terminated so long as such
312
+ parties remain in full compliance.
313
+
314
+
315
+ 10. FUTURE REVISIONS OF THIS LICENSE
316
+
317
+ The Free Software Foundation may publish new, revised versions
318
+ of the GNU Free Documentation License from time to time. Such new
319
+ versions will be similar in spirit to the present version, but may
320
+ differ in detail to address new problems or concerns. See
321
+ http://www.gnu.org/copyleft/.
322
+
323
+ Each version of the License is given a distinguishing version number.
324
+ If the Document specifies that a particular numbered version of this
325
+ License "or any later version" applies to it, you have the option of
326
+ following the terms and conditions either of that specified version or
327
+ of any later version that has been published (not as a draft) by the
328
+ Free Software Foundation. If the Document does not specify a version
329
+ number of this License, you may choose any version ever published (not
330
+ as a draft) by the Free Software Foundation.
331
+
332
+
333
+ ADDENDUM: How to use this License for your documents
334
+
335
+ To use this License in a document you have written, include a copy of
336
+ the License in the document and put the following copyright and
337
+ license notices just after the title page:
338
+
339
+ Copyright (c) YEAR YOUR NAME.
340
+ Permission is granted to copy, distribute and/or modify this document
341
+ under the terms of the GNU Free Documentation License, Version 1.1
342
+ or any later version published by the Free Software Foundation;
343
+ with the Invariant Sections being LIST THEIR TITLES, with the
344
+ Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
345
+ A copy of the license is included in the section entitled "GNU
346
+ Free Documentation License".
347
+
348
+ If you have no Invariant Sections, write "with no Invariant Sections"
349
+ instead of saying which ones are invariant. If you have no
350
+ Front-Cover Texts, write "no Front-Cover Texts" instead of
351
+ "Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
352
+
353
+ If your document contains nontrivial examples of program code, we
354
+ recommend releasing these examples in parallel under your choice of
355
+ free software license, such as the GNU General Public License,
356
+ to permit their use in free software.