string-array: New functions for comparing string arrays.
[pspp] / doc / fdl.texi
1 @c PSPP - a program for statistical analysis.
2 @c Copyright (C) 2017 Free Software Foundation, Inc.
3 @c Permission is granted to copy, distribute and/or modify this document
4 @c under the terms of the GNU Free Documentation License, Version 1.3
5 @c or any later version published by the Free Software Foundation;
6 @c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
7 @c A copy of the license is included in the section entitled "GNU
8 @c Free Documentation License".
9 @c
10 @node GNU Free Documentation License
11 @appendix GNU Free Documentation License
12
13 @c The GNU Free Documentation License.
14 @center Version 1.3, 3 November 2008
15
16 @c This file is intended to be included within another document,
17 @c hence no sectioning command or @node.
18
19 @display
20 Copyright @copyright{} 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
21 @uref{http://fsf.org/}
22
23 Everyone is permitted to copy and distribute verbatim copies
24 of this license document, but changing it is not allowed.
25 @end display
26
27 @enumerate 0
28 @item
29 PREAMBLE
30
31 The purpose of this License is to make a manual, textbook, or other
32 functional and useful document @dfn{free} in the sense of freedom: to
33 assure everyone the effective freedom to copy and redistribute it,
34 with or without modifying it, either commercially or noncommercially.
35 Secondarily, this License preserves for the author and publisher a way
36 to get credit for their work, while not being considered responsible
37 for modifications made by others.
38
39 This License is a kind of ``copyleft'', which means that derivative
40 works of the document must themselves be free in the same sense.  It
41 complements the GNU General Public License, which is a copyleft
42 license designed for free software.
43
44 We have designed this License in order to use it for manuals for free
45 software, because free software needs free documentation: a free
46 program should come with manuals providing the same freedoms that the
47 software does.  But this License is not limited to software manuals;
48 it can be used for any textual work, regardless of subject matter or
49 whether it is published as a printed book.  We recommend this License
50 principally for works whose purpose is instruction or reference.
51
52 @item
53 APPLICABILITY AND DEFINITIONS
54
55 This License applies to any manual or other work, in any medium, that
56 contains a notice placed by the copyright holder saying it can be
57 distributed under the terms of this License.  Such a notice grants a
58 world-wide, royalty-free license, unlimited in duration, to use that
59 work under the conditions stated herein.  The ``Document'', below,
60 refers to any such manual or work.  Any member of the public is a
61 licensee, and is addressed as ``you''.  You accept the license if you
62 copy, modify or distribute the work in a way requiring permission
63 under copyright law.
64
65 A ``Modified Version'' of the Document means any work containing the
66 Document or a portion of it, either copied verbatim, or with
67 modifications and/or translated into another language.
68
69 A ``Secondary Section'' is a named appendix or a front-matter section
70 of the Document that deals exclusively with the relationship of the
71 publishers or authors of the Document to the Document's overall
72 subject (or to related matters) and contains nothing that could fall
73 directly within that overall subject.  (Thus, if the Document is in
74 part a textbook of mathematics, a Secondary Section may not explain
75 any mathematics.)  The relationship could be a matter of historical
76 connection with the subject or with related matters, or of legal,
77 commercial, philosophical, ethical or political position regarding
78 them.
79
80 The ``Invariant Sections'' are certain Secondary Sections whose titles
81 are designated, as being those of Invariant Sections, in the notice
82 that says that the Document is released under this License.  If a
83 section does not fit the above definition of Secondary then it is not
84 allowed to be designated as Invariant.  The Document may contain zero
85 Invariant Sections.  If the Document does not identify any Invariant
86 Sections then there are none.
87
88 The ``Cover Texts'' are certain short passages of text that are listed,
89 as Front-Cover Texts or Back-Cover Texts, in the notice that says that
90 the Document is released under this License.  A Front-Cover Text may
91 be at most 5 words, and a Back-Cover Text may be at most 25 words.
92
93 A ``Transparent'' copy of the Document means a machine-readable copy,
94 represented in a format whose specification is available to the
95 general public, that is suitable for revising the document
96 straightforwardly with generic text editors or (for images composed of
97 pixels) generic paint programs or (for drawings) some widely available
98 drawing editor, and that is suitable for input to text formatters or
99 for automatic translation to a variety of formats suitable for input
100 to text formatters.  A copy made in an otherwise Transparent file
101 format whose markup, or absence of markup, has been arranged to thwart
102 or discourage subsequent modification by readers is not Transparent.
103 An image format is not Transparent if used for any substantial amount
104 of text.  A copy that is not ``Transparent'' is called ``Opaque''.
105
106 Examples of suitable formats for Transparent copies include plain
107 @sc{ascii} without markup, Texinfo input format, La@TeX{} input
108 format, @acronym{SGML} or @acronym{XML} using a publicly available
109 @acronym{DTD}, and standard-conforming simple @acronym{HTML},
110 PostScript or @acronym{PDF} designed for human modification.  Examples
111 of transparent image formats include @acronym{PNG}, @acronym{XCF} and
112 @acronym{JPG}.  Opaque formats include proprietary formats that can be
113 read and edited only by proprietary word processors, @acronym{SGML} or
114 @acronym{XML} for which the @acronym{DTD} and/or processing tools are
115 not generally available, and the machine-generated @acronym{HTML},
116 PostScript or @acronym{PDF} produced by some word processors for
117 output purposes only.
118
119 The ``Title Page'' means, for a printed book, the title page itself,
120 plus such following pages as are needed to hold, legibly, the material
121 this License requires to appear in the title page.  For works in
122 formats which do not have any title page as such, ``Title Page'' means
123 the text near the most prominent appearance of the work's title,
124 preceding the beginning of the body of the text.
125
126 The ``publisher'' means any person or entity that distributes copies
127 of the Document to the public.
128
129 A section ``Entitled XYZ'' means a named subunit of the Document whose
130 title either is precisely XYZ or contains XYZ in parentheses following
131 text that translates XYZ in another language.  (Here XYZ stands for a
132 specific section name mentioned below, such as ``Acknowledgements'',
133 ``Dedications'', ``Endorsements'', or ``History''.)  To ``Preserve the Title''
134 of such a section when you modify the Document means that it remains a
135 section ``Entitled XYZ'' according to this definition.
136
137 The Document may include Warranty Disclaimers next to the notice which
138 states that this License applies to the Document.  These Warranty
139 Disclaimers are considered to be included by reference in this
140 License, but only as regards disclaiming warranties: any other
141 implication that these Warranty Disclaimers may have is void and has
142 no effect on the meaning of this License.
143
144 @item
145 VERBATIM COPYING
146
147 You may copy and distribute the Document in any medium, either
148 commercially or noncommercially, provided that this License, the
149 copyright notices, and the license notice saying this License applies
150 to the Document are reproduced in all copies, and that you add no other
151 conditions whatsoever to those of this License.  You may not use
152 technical measures to obstruct or control the reading or further
153 copying of the copies you make or distribute.  However, you may accept
154 compensation in exchange for copies.  If you distribute a large enough
155 number of copies you must also follow the conditions in section 3.
156
157 You may also lend copies, under the same conditions stated above, and
158 you may publicly display copies.
159
160 @item
161 COPYING IN QUANTITY
162
163 If you publish printed copies (or copies in media that commonly have
164 printed covers) of the Document, numbering more than 100, and the
165 Document's license notice requires Cover Texts, you must enclose the
166 copies in covers that carry, clearly and legibly, all these Cover
167 Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
168 the back cover.  Both covers must also clearly and legibly identify
169 you as the publisher of these copies.  The front cover must present
170 the full title with all words of the title equally prominent and
171 visible.  You may add other material on the covers in addition.
172 Copying with changes limited to the covers, as long as they preserve
173 the title of the Document and satisfy these conditions, can be treated
174 as verbatim copying in other respects.
175
176 If the required texts for either cover are too voluminous to fit
177 legibly, you should put the first ones listed (as many as fit
178 reasonably) on the actual cover, and continue the rest onto adjacent
179 pages.
180
181 If you publish or distribute Opaque copies of the Document numbering
182 more than 100, you must either include a machine-readable Transparent
183 copy along with each Opaque copy, or state in or with each Opaque copy
184 a computer-network location from which the general network-using
185 public has access to download using public-standard network protocols
186 a complete Transparent copy of the Document, free of added material.
187 If you use the latter option, you must take reasonably prudent steps,
188 when you begin distribution of Opaque copies in quantity, to ensure
189 that this Transparent copy will remain thus accessible at the stated
190 location until at least one year after the last time you distribute an
191 Opaque copy (directly or through your agents or retailers) of that
192 edition to the public.
193
194 It is requested, but not required, that you contact the authors of the
195 Document well before redistributing any large number of copies, to give
196 them a chance to provide you with an updated version of the Document.
197
198 @item
199 MODIFICATIONS
200
201 You may copy and distribute a Modified Version of the Document under
202 the conditions of sections 2 and 3 above, provided that you release
203 the Modified Version under precisely this License, with the Modified
204 Version filling the role of the Document, thus licensing distribution
205 and modification of the Modified Version to whoever possesses a copy
206 of it.  In addition, you must do these things in the Modified Version:
207
208 @enumerate A
209 @item
210 Use in the Title Page (and on the covers, if any) a title distinct
211 from that of the Document, and from those of previous versions
212 (which should, if there were any, be listed in the History section
213 of the Document).  You may use the same title as a previous version
214 if the original publisher of that version gives permission.
215
216 @item
217 List on the Title Page, as authors, one or more persons or entities
218 responsible for authorship of the modifications in the Modified
219 Version, together with at least five of the principal authors of the
220 Document (all of its principal authors, if it has fewer than five),
221 unless they release you from this requirement.
222
223 @item
224 State on the Title page the name of the publisher of the
225 Modified Version, as the publisher.
226
227 @item
228 Preserve all the copyright notices of the Document.
229
230 @item
231 Add an appropriate copyright notice for your modifications
232 adjacent to the other copyright notices.
233
234 @item
235 Include, immediately after the copyright notices, a license notice
236 giving the public permission to use the Modified Version under the
237 terms of this License, in the form shown in the Addendum below.
238
239 @item
240 Preserve in that license notice the full lists of Invariant Sections
241 and required Cover Texts given in the Document's license notice.
242
243 @item
244 Include an unaltered copy of this License.
245
246 @item
247 Preserve the section Entitled ``History'', Preserve its Title, and add
248 to it an item stating at least the title, year, new authors, and
249 publisher of the Modified Version as given on the Title Page.  If
250 there is no section Entitled ``History'' in the Document, create one
251 stating the title, year, authors, and publisher of the Document as
252 given on its Title Page, then add an item describing the Modified
253 Version as stated in the previous sentence.
254
255 @item
256 Preserve the network location, if any, given in the Document for
257 public access to a Transparent copy of the Document, and likewise
258 the network locations given in the Document for previous versions
259 it was based on.  These may be placed in the ``History'' section.
260 You may omit a network location for a work that was published at
261 least four years before the Document itself, or if the original
262 publisher of the version it refers to gives permission.
263
264 @item
265 For any section Entitled ``Acknowledgements'' or ``Dedications'', Preserve
266 the Title of the section, and preserve in the section all the
267 substance and tone of each of the contributor acknowledgements and/or
268 dedications given therein.
269
270 @item
271 Preserve all the Invariant Sections of the Document,
272 unaltered in their text and in their titles.  Section numbers
273 or the equivalent are not considered part of the section titles.
274
275 @item
276 Delete any section Entitled ``Endorsements''.  Such a section
277 may not be included in the Modified Version.
278
279 @item
280 Do not retitle any existing section to be Entitled ``Endorsements'' or
281 to conflict in title with any Invariant Section.
282
283 @item
284 Preserve any Warranty Disclaimers.
285 @end enumerate
286
287 If the Modified Version includes new front-matter sections or
288 appendices that qualify as Secondary Sections and contain no material
289 copied from the Document, you may at your option designate some or all
290 of these sections as invariant.  To do this, add their titles to the
291 list of Invariant Sections in the Modified Version's license notice.
292 These titles must be distinct from any other section titles.
293
294 You may add a section Entitled ``Endorsements'', provided it contains
295 nothing but endorsements of your Modified Version by various
296 parties---for example, statements of peer review or that the text has
297 been approved by an organization as the authoritative definition of a
298 standard.
299
300 You may add a passage of up to five words as a Front-Cover Text, and a
301 passage of up to 25 words as a Back-Cover Text, to the end of the list
302 of Cover Texts in the Modified Version.  Only one passage of
303 Front-Cover Text and one of Back-Cover Text may be added by (or
304 through arrangements made by) any one entity.  If the Document already
305 includes a cover text for the same cover, previously added by you or
306 by arrangement made by the same entity you are acting on behalf of,
307 you may not add another; but you may replace the old one, on explicit
308 permission from the previous publisher that added the old one.
309
310 The author(s) and publisher(s) of the Document do not by this License
311 give permission to use their names for publicity for or to assert or
312 imply endorsement of any Modified Version.
313
314 @item
315 COMBINING DOCUMENTS
316
317 You may combine the Document with other documents released under this
318 License, under the terms defined in section 4 above for modified
319 versions, provided that you include in the combination all of the
320 Invariant Sections of all of the original documents, unmodified, and
321 list them all as Invariant Sections of your combined work in its
322 license notice, and that you preserve all their Warranty Disclaimers.
323
324 The combined work need only contain one copy of this License, and
325 multiple identical Invariant Sections may be replaced with a single
326 copy.  If there are multiple Invariant Sections with the same name but
327 different contents, make the title of each such section unique by
328 adding at the end of it, in parentheses, the name of the original
329 author or publisher of that section if known, or else a unique number.
330 Make the same adjustment to the section titles in the list of
331 Invariant Sections in the license notice of the combined work.
332
333 In the combination, you must combine any sections Entitled ``History''
334 in the various original documents, forming one section Entitled
335 ``History''; likewise combine any sections Entitled ``Acknowledgements'',
336 and any sections Entitled ``Dedications''.  You must delete all
337 sections Entitled ``Endorsements.''
338
339 @item
340 COLLECTIONS OF DOCUMENTS
341
342 You may make a collection consisting of the Document and other documents
343 released under this License, and replace the individual copies of this
344 License in the various documents with a single copy that is included in
345 the collection, provided that you follow the rules of this License for
346 verbatim copying of each of the documents in all other respects.
347
348 You may extract a single document from such a collection, and distribute
349 it individually under this License, provided you insert a copy of this
350 License into the extracted document, and follow this License in all
351 other respects regarding verbatim copying of that document.
352
353 @item
354 AGGREGATION WITH INDEPENDENT WORKS
355
356 A compilation of the Document or its derivatives with other separate
357 and independent documents or works, in or on a volume of a storage or
358 distribution medium, is called an ``aggregate'' if the copyright
359 resulting from the compilation is not used to limit the legal rights
360 of the compilation's users beyond what the individual works permit.
361 When the Document is included in an aggregate, this License does not
362 apply to the other works in the aggregate which are not themselves
363 derivative works of the Document.
364
365 If the Cover Text requirement of section 3 is applicable to these
366 copies of the Document, then if the Document is less than one half of
367 the entire aggregate, the Document's Cover Texts may be placed on
368 covers that bracket the Document within the aggregate, or the
369 electronic equivalent of covers if the Document is in electronic form.
370 Otherwise they must appear on printed covers that bracket the whole
371 aggregate.
372
373 @item
374 TRANSLATION
375
376 Translation is considered a kind of modification, so you may
377 distribute translations of the Document under the terms of section 4.
378 Replacing Invariant Sections with translations requires special
379 permission from their copyright holders, but you may include
380 translations of some or all Invariant Sections in addition to the
381 original versions of these Invariant Sections.  You may include a
382 translation of this License, and all the license notices in the
383 Document, and any Warranty Disclaimers, provided that you also include
384 the original English version of this License and the original versions
385 of those notices and disclaimers.  In case of a disagreement between
386 the translation and the original version of this License or a notice
387 or disclaimer, the original version will prevail.
388
389 If a section in the Document is Entitled ``Acknowledgements'',
390 ``Dedications'', or ``History'', the requirement (section 4) to Preserve
391 its Title (section 1) will typically require changing the actual
392 title.
393
394 @item
395 TERMINATION
396
397 You may not copy, modify, sublicense, or distribute the Document
398 except as expressly provided under this License.  Any attempt
399 otherwise to copy, modify, sublicense, or distribute it is void, and
400 will automatically terminate your rights under this License.
401
402 However, if you cease all violation of this License, then your license
403 from a particular copyright holder is reinstated (a) provisionally,
404 unless and until the copyright holder explicitly and finally
405 terminates your license, and (b) permanently, if the copyright holder
406 fails to notify you of the violation by some reasonable means prior to
407 60 days after the cessation.
408
409 Moreover, your license from a particular copyright holder is
410 reinstated permanently if the copyright holder notifies you of the
411 violation by some reasonable means, this is the first time you have
412 received notice of violation of this License (for any work) from that
413 copyright holder, and you cure the violation prior to 30 days after
414 your receipt of the notice.
415
416 Termination of your rights under this section does not terminate the
417 licenses of parties who have received copies or rights from you under
418 this License.  If your rights have been terminated and not permanently
419 reinstated, receipt of a copy of some or all of the same material does
420 not give you any rights to use it.
421
422 @item
423 FUTURE REVISIONS OF THIS LICENSE
424
425 The Free Software Foundation may publish new, revised versions
426 of the GNU Free Documentation License from time to time.  Such new
427 versions will be similar in spirit to the present version, but may
428 differ in detail to address new problems or concerns.  See
429 @uref{http://www.gnu.org/copyleft/}.
430
431 Each version of the License is given a distinguishing version number.
432 If the Document specifies that a particular numbered version of this
433 License ``or any later version'' applies to it, you have the option of
434 following the terms and conditions either of that specified version or
435 of any later version that has been published (not as a draft) by the
436 Free Software Foundation.  If the Document does not specify a version
437 number of this License, you may choose any version ever published (not
438 as a draft) by the Free Software Foundation.  If the Document
439 specifies that a proxy can decide which future versions of this
440 License can be used, that proxy's public statement of acceptance of a
441 version permanently authorizes you to choose that version for the
442 Document.
443
444 @item
445 RELICENSING
446
447 ``Massive Multiauthor Collaboration Site'' (or ``MMC Site'') means any
448 World Wide Web server that publishes copyrightable works and also
449 provides prominent facilities for anybody to edit those works.  A
450 public wiki that anybody can edit is an example of such a server.  A
451 ``Massive Multiauthor Collaboration'' (or ``MMC'') contained in the
452 site means any set of copyrightable works thus published on the MMC
453 site.
454
455 ``CC-BY-SA'' means the Creative Commons Attribution-Share Alike 3.0
456 license published by Creative Commons Corporation, a not-for-profit
457 corporation with a principal place of business in San Francisco,
458 California, as well as future copyleft versions of that license
459 published by that same organization.
460
461 ``Incorporate'' means to publish or republish a Document, in whole or
462 in part, as part of another Document.
463
464 An MMC is ``eligible for relicensing'' if it is licensed under this
465 License, and if all works that were first published under this License
466 somewhere other than this MMC, and subsequently incorporated in whole
467 or in part into the MMC, (1) had no cover texts or invariant sections,
468 and (2) were thus incorporated prior to November 1, 2008.
469
470 The operator of an MMC Site may republish an MMC contained in the site
471 under CC-BY-SA on the same site at any time before August 1, 2009,
472 provided the MMC is eligible for relicensing.
473
474 @end enumerate
475
476 @page
477 @heading ADDENDUM: How to use this License for your documents
478
479 To use this License in a document you have written, include a copy of
480 the License in the document and put the following copyright and
481 license notices just after the title page:
482
483 @smallexample
484 @group
485   Copyright (C)  @var{year}  @var{your name}.
486   Permission is granted to copy, distribute and/or modify this document
487   under the terms of the GNU Free Documentation License, Version 1.3
488   or any later version published by the Free Software Foundation;
489   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
490   Texts.  A copy of the license is included in the section entitled ``GNU
491   Free Documentation License''.
492 @end group
493 @end smallexample
494
495 If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
496 replace the ``with@dots{}Texts.'' line with this:
497
498 @smallexample
499 @group
500     with the Invariant Sections being @var{list their titles}, with
501     the Front-Cover Texts being @var{list}, and with the Back-Cover Texts
502     being @var{list}.
503 @end group
504 @end smallexample
505
506 If you have Invariant Sections without Cover Texts, or some other
507 combination of the three, merge those two alternatives to suit the
508 situation.
509
510 If your document contains nontrivial examples of program code, we
511 recommend releasing these examples in parallel under your choice of
512 free software license, such as the GNU General Public License,
513 to permit their use in free software.
514
515 @c Local Variables:
516 @c ispell-local-pdict: "ispell-dict"
517 @c End:
518