facets 3.1.0 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 6968b01e3ed3e46be3265a381de7443ec38bb966
-  data.tar.gz: 4668e23ad2f1e44a65cf8ba895f0daccbf65c175
+SHA256:
+  metadata.gz: e83c6730d1db66b68b3cad1ff1d18d522e33c0c967a92827fdcc1e90896fd9a0
+  data.tar.gz: e36061c5e9e99c9aa03ede727764012df8aa54758c29493d75950bb8ff98d14b
 SHA512:
-  metadata.gz: 6deb1971ac97f93bb75d4c144fabb91d6e9f6424867e4be70a2b99623d35080a49cf774c18e36236877c3f35d3549ca5563eb6a6c18912beccd3e67b1a414ec0
-  data.tar.gz: 4fefcae7db154ac8b054aa4d5fc293653ea2376a1a36a59968bbad9a70763a06ca8bde410c1c3bb1c89d10e455420feee977264bfd8d1f4e49494bf90a16b9cf
+  metadata.gz: 65774ae87ae60eaf13b146db1403ba731df7b6c840c37602bb286e67fef3a4f474e0b32b7aee9f967d351667d0d3473627cf8c111113cb0013b7f811f334b5a7
+  data.tar.gz: 72a213e09c2ba90be9980f6cc300c46f5ba615cddb2e7149fee2c9d83a0b683870478632ee6dfb041dbe792303b9cd3ea7901ce9551a4148e12d3e33f7e6d7e8

data/HISTORY.md

@@ -1,5 +1,182 @@
 # Facets Release History
 
+## 3.2.1 / 2026-06-14
+
+Patch release that fixes the broken 3.2.0 release. 3.2.0 shipped with stale
+`require_relative` lines pointing at method files that had been removed or
+renamed, so `require 'facets'` raised `LoadError`. This restores loadability
+and adds a regression guard so it cannot recur. (The breaking-change and
+versioning concern raised in issue #314 is left for a future major release.)
+
+Changes:
+
+* New Features
+
+  * Add `OpenDSL` — build free-form, pluggable DSL modules from a block.
+  * Add `PIC` — COBOL-style edited-picture pattern matching as a simple
+    alternative to regular expressions.
+
+* Bug Fixes
+
+  * Fix `LoadError` on `require 'facets'`: remove stale `require_relative`
+    lines left pointing at removed method files, and correct the
+    `hash/to_proc` -> `hash/setter` require after the rename.
+    (issues #312, #315; PR#313)
+  * Fix `range.rb` requiring the removed `range/overlap`. (PR#318)
+  * Stop `Kernel::As` from redefining `object_id`, which emitted a
+    "redefining 'object_id' may cause serious problems" warning on load.
+    (issue #310)
+
+* Internal
+
+  * Add a load-path regression test that verifies every `require_relative`
+    target across the library resolves to an existing file.
+
+## 3.2.0 / 2026-04-01
+
+Modernization release targeting Ruby 3.1+. Cleans up long-standing
+compatibility issues and incorporates community contributions.
+
+Changes:
+
+* New Features
+
+  * Add `Crypt3` module — pure Ruby crypt(3) implementation (from rubyworks/crypt3).
+    Supports md5, sha1, sha256, sha384, sha512, rmd160.
+  * Add `Array#to_ranges` to convert arrays to ranges. (PR#265)
+  * Add `Array#remove` and `Array#remove!` for count-respecting subtraction. (PR#293)
+  * Add `Array#indexes` / `Array#index_all` to find all matching indexes. (PR#294)
+  * Add `String#dashcase` for kebab-case conversion. (PR#297)
+  * Add `Binding#caller_locations`.
+  * Add `Range.intersection` and `Range#intersection` for finding the shared
+    region of multiple ranges. Works with any comparable type.
+  * Add `Kernel#functor` — block-less method chaining via Functor, replaces `tap` override.
+  * Stop overriding `Hash#to_proc` and provide its behavior as `Hash#setter`
+    instead. Facets' version built a Proc that assigns the hash's key/value
+    pairs as attributes on a target object, which conflicted with Ruby's own
+    `Hash#to_proc` (added in 2.3, does key lookup). Facets now cedes `to_proc`
+    to Ruby; use `Hash#setter` for the attribute-assignment behavior. Also
+    renamed the option `response:` to `safe:` and fixed a receiver check.
+  * Consolidate `Array#arrange` and `Array#to_ranges`; `to_ranges` is now primary,
+    `arrange` and `rangify` are aliases. Now handles mixed ranges and values.
+  * Fix `Array#step` to start at index 0 (was n-1); add optional offset parameter.
+
+* Improved Features
+
+  * Adapt `Module#attr_setter` to frozen-string-literal. (PR#287)
+  * Update `Binding#__LINE__` and `__FILE__` to use `source_location`.
+  * Replace `URI.escape`/`URI.unescape` with `CGI.escape`/`CGI.unescape`.
+  * Rewrite `Kernel#callstack`, `#require_all`, `#load_all` to use `caller_locations`
+    instead of parsing caller strings with regex.
+  * Switch CI from Travis to GitHub Actions.
+  * Make `String#underscore` ActiveSupport-compatible (converts `::` to `/`).
+    Use `String#snakecase` for pure case conversion without namespace handling.
+  * Make `Kernel#try` ActiveSupport-compatible (supports block form and `try!`).
+    Facets' Tee/Functor form retained as extra feature.
+
+* Bug Fixes
+
+  * Fix `Math.gini_coefficient` referencing `self` instead of `array` parameter. (PR#302)
+  * Fix typo in `Array#after` doc. (PR#283)
+  * Fix typo in `String#to_b` doc. (PR#306)
+
+* Removals
+
+  * Remove `Array#**` (`op_pow`) alias for `product` (use `Array#product` directly).
+  * Deprecate `Array#occurrence` (use `Enumerable#tally` instead, adopted by Ruby in 2.7).
+  * Deprecate `Array#uniq_by!` (use `Array#uniq!(&block)` instead, adopted by Ruby in 1.9.2).
+  * Deprecate `Array#nonuniq` / `nonuniq!` (use `Array#duplicates` / `duplicates!` instead).
+  * Add `Array#duplicates!` (in-place version of `duplicates`).
+  * Remove `Kernel#tap` override. Use `Kernel#tee` for the block-less Functor form.
+  * Remove `Enumerable#filter` (conflicts with Ruby's built-in `filter` since 2.6).
+    Use `each_with_object` instead, with block arguments reversed:
+    `collection.each_with_object([]) { |el, out| out << el if cond }`.
+  * Remove Ruby 1.8 compatibility code from `enumerator.rb`.
+  * Remove `taint`/`tainted?` references (removed from Ruby in 3.2).
+  * Remove `Enumerable#sum` (adopted by Ruby in 2.4).
+    For non-numeric cases (e.g. `[[1],[2],[3]]`), use `reduce(:+)` instead.
+  * Remove `String#crypt` override (Ruby deprecated `crypt` in 3.2; use `bcrypt` gem instead).
+  * Remove `MatchData#match` (adopted by Ruby in 3.1).
+  * Remove `Range#overlap?` (adopted by Ruby in 3.3).
+  * Remove `Kernel#__DIR__` (adopted by Ruby as `__dir__` in 2.0).
+  * Remove `Kernel#instance_exec` (adopted by Ruby in 1.9).
+  * Remove `Kernel#singleton_class` (adopted by Ruby in 1.9).
+  * Remove `Kernel#p` override (Ruby's `p` returns its arguments since 1.9).
+  * Remove `Method#curry` (adopted by Ruby in 2.2).
+  * Remove `Array#to_h` (adopted by Ruby in 2.1).
+  * Remove `Array#intersection` (clashes with Ruby 2.7's `Array#intersection`).
+    Consider `Range.intersection` class method as future replacement.
+  * Remove `Hash#except` (adopted by Ruby in 3.0); `except!` and `remove!` retained.
+  * Remove `Hash#slice` (adopted by Ruby in 2.5); `slice!` retained.
+    Block form removed from both; use `slice(...).select { ... }` instead.
+  * Remove `Class#singleton_class?` (adopted by Ruby in 3.2).
+  * Remove `Class#subclasses` (adopted by Ruby in 3.1).
+  * Remove `Symbol#succ` (adopted by Ruby in 1.9).
+  * Remove `File.write` (adopted by Ruby in 1.9).
+  * Remove `Process.daemon` (adopted by Ruby in 1.9).
+  * Remove `Dir#each_child` (adopted by Ruby in 2.6).
+    Note: Ruby's version does not support the custom ignore argument.
+    Use `Dir.each_child('/path').reject { |f| ignore.include?(f) }` instead.
+  * Remove `Numeric#positive?` and `Numeric#negative?` (adopted by Ruby in 2.3).
+  * Remove `Object#itself` (adopted by Ruby in 2.6).
+  * Deprecate `Array#standard_deviation` (use `Array#stddev` or `Array#sd`).
+  * Deprecate `Struct#attributes` (use `Struct#to_h`, adopted by Ruby in 2.0).
+  * Deprecate `UnboundMethod#arguments` (use `UnboundMethod#parameters`, adopted by Ruby in 2.0).
+  * Remove `Object#dup!` and `Object#try_dup` (plain `dup` works on all objects since Ruby 2.4).
+  * Remove `Exception#set_message` (broken — did not actually change the message).
+  * Deprecate `Exception#error_print` (use `Exception#full_message`, adopted by Ruby in 2.5).
+  * Deprecate `Comparable#clip` (use `Comparable#clamp`, adopted by Ruby in 2.4).
+  * Redefine `Comparable#bound` as alias for `clamp`.
+  * Add `Dir.find` as convenience wrapper around Ruby's `Find.find`.
+  * Deprecate `Dir.recurse` / `Dir.ls_r` (use `Dir.find` or `Find.find` instead).
+  * Deprecate `Proc#compose` and `Proc#*` (use `Proc#<<` for right-to-left composition, Ruby 2.6+).
+  * Deprecate `Hash#update_keys` (use `Hash#transform_keys!` or `Hash#rekey!`).
+  * Deprecate `Hash#update_values` (use `Hash#transform_values!` or `Hash#revalue!`).
+  * Deprecate `Hash#fetch_nested` (use `Hash#dig`, adopted by Ruby in 2.3).
+  * Deprecate `Enumerable#compact_map` (use `Enumerable#filter_map`, adopted by Ruby in 2.7).
+  * Deprecate `Enumerable#defer` (use `Enumerable#lazy`, adopted by Ruby in 2.0).
+  * Deprecate `Enumerable#frequency` (use `Enumerable#tally`, adopted by Ruby in 2.7).
+  * Deprecate `Enumerable#hinge` (use `Enumerable#each_with_object`, note: block args reversed).
+  * Deprecate `Enumerable#map_with_index` (use `Enumerable#map.with_index`).
+  * Deprecate `Enumerable#mash` (use `Enumerable#graph` instead).
+  * Deprecate `Enumerable#uniq_by` (use `Enumerable#uniq(&block)`, Ruby 1.9.2+).
+  * Redefine `String#lchomp` / `#lchomp!` as aliases for `delete_prefix` / `delete_prefix!`.
+  * Rename `Time#trunc` to `Time#floor_to` (parallels `Time#round_to`; avoids confusion
+    with Ruby's `Time#floor` which takes sub-second digit precision). `trunc` deprecated.
+  * Fix `Binding#[]` and `#[]=` to use `local_variable_get`/`local_variable_set`
+    (broken since Ruby 1.9; now works again).
+  * Deprecate `Binding#self` (use `Binding#receiver`, adopted by Ruby in 2.6).
+  * Deprecate `Module#alias_method_chain` (use `Module#prepend`, Ruby 2.0+).
+  * Deprecate `Module#can` (use `Module#extend`).
+  * Deprecate `File.null` (use `File::NULL` constant, Ruby 1.9.3+).
+  * Deprecate `File.read_binary` (use `File.binread`, Ruby 1.9.3+).
+  * Deprecate `Kernel#eigenclass` (use `singleton_class` or `meta_class`; kept in tribute to _why).
+  * Deprecate `Kernel#extension`, `#instance_class`, `#qua_class`, `#object_class`
+    (use `singleton_class` or `meta_class`).
+  * Deprecate `Kernel#object_send` (use `public_send`), `#instance_send` (use `__send__`).
+  * Deprecate `Kernel#load_relative` (use `require_relative`).
+  * Deprecate `Kernel#returning` (use `Kernel#tap`).
+  * Deprecate `Kernel#memo` (use `Module#memoize`; global `$MEMO` is problematic).
+  * Update `Kernel#meta_class` to delegate to `singleton_class` internally.
+  * Fix dead requires for removed `kernel/singleton_class` in Proc and Kernel.
+  * Remove misplaced `applique/file_helpers` from core (test infrastructure).
+  * Remove OpenStruct extensions now built into Ruby (`to_h`, `each`, `[]`, `[]=`).
+  * Fix OpenStruct#initialize to not use removed `new_ostruct_member`.
+  * Add OpenStruct#merge (non-destructive version).
+  * Remove deprecated OpenStruct methods (`instance_delegate`, `ostruct_update`, etc.).
+  * Deprecate `cloneable.rb` (use `deep_dup`/`deep_clone` instead).
+  * Deprecate `continuation.rb` (callcc is obsolete; use Fiber).
+  * Deprecate `getoptlong.rb` (bundled gem heading for removal; use OptionParser).
+  * Deprecate `load_monitor.rb` (monkey-patches require/load globally).
+  * Clean up `random.rb`: remove Array#shuffle/shuffle! (Ruby built-in),
+    add Array#sample! (destructive sample), deprecate at_rand/pick (use sample).
+  * Fix Pathname#glob to wrap Ruby's built-in, adding symbol flag support.
+  * Remove Pathname#empty? (built into Ruby).
+  * Deprecate Pathname.null (use Pathname.new(File::NULL)).
+  * Fix `Math.kldivergence` (was broken — referenced `self` instead of array parameter).
+  * Drop unused `test_files` directive from gemspec. (PR#301)
+
+
 ## 3.1.0 / 2016-05-10
 
 More or less a minor release, but there are some backward incompatabilites

data/LICENSE.txt

@@ -1,349 +1,27 @@
+Ruby Facets
+Copyright (c) 2005, Thomas Sawyer
+All rights reserved.
 
- Ruby Facets
+(BSD-2 LICENSE)
 
- Copyright (c) 2005,2010 Thomas Sawyer
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
 
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
 
- THE RUBY LICENSE
- (http://www.ruby-lang.org/en/LICENSE.txt)
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
 
- You may redistribute this software and/or modify it under either the terms of
- the GPL (see below), or the conditions below:
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
-  1. You may make and give away verbatim copies of the source form of the
-     software without restriction, provided that you duplicate all of the
-     original copyright notices and associated disclaimers.
-
-  2. You may modify your copy of the software in any way, provided that
-     you do at least ONE of the following:
-
-       a) place your modifications in the Public Domain or otherwise
-          make them Freely Available, such as by posting said
-          modifications to Usenet or an equivalent medium, or by allowing
-          the author to include your modifications in the software.
-
-       b) use the modified software only within your corporation or
-          organization.
-
-       c) rename any non-standard executables so the names do not conflict
-          with standard executables, which must also be provided.
-
-       d) make other distribution arrangements with the author.
-
-  3. You may distribute the software in object code or executable
-     form, provided that you do at least ONE of the following:
-
-       a) distribute the executables and library files of the software,
-          together with instructions (in the manual page or equivalent)
-          on where to get the original distribution.
-
-       b) accompany the distribution with the machine-readable source of
-          the software.
-
-       c) give non-standard executables non-standard names, with
-          instructions on where to get the original software distribution.
-
-       d) make other distribution arrangements with the author.
-
-  4. You may modify and include the part of the software into any other
-     software (possibly commercial).  But some files in the distribution
-     are not written by the author, so that they are not under these terms.
-
-     For the list of those files and their copying conditions, see the
-     file LEGAL.
-
-  5. The scripts and library files supplied as input to or produced as
-     output from the software do not automatically fall under the
-     copyright of the software, but belong to whomever generated them,
-     and may be sold commercially, and may be aggregated with this
-     software.
-
-  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
-     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-     PURPOSE.
-
- ----------------------------------------------------------------------------
-
-
-                   GNU GENERAL PUBLIC LICENSE
-                     Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-    59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-                            Preamble
-
- The licenses for most software are designed to take away your
- freedom to share and change it.  By contrast, the GNU General Public
- License is intended to guarantee your freedom to share and change free
- software--to make sure the software is free for all its users.  This
- General Public License applies to most of the Free Software
- Foundation's software and to any other program whose authors commit to
- using it.  (Some other Free Software Foundation software is covered by
- the GNU Library General Public License instead.)  You can apply it to
- your programs, too.
-
- When we speak of free software, we are referring to freedom, not
- price.  Our General Public Licenses are designed to make sure that you
- have the freedom to distribute copies of free software (and charge for
- this service if you wish), that you receive source code or can get it
- if you want it, that you can change the software or use pieces of it
- in new free programs; and that you know you can do these things.
-
- To protect your rights, we need to make restrictions that forbid
- anyone to deny you these rights or to ask you to surrender the rights.
- These restrictions translate to certain responsibilities for you if you
- distribute copies of the software, or if you modify it.
-
- For example, if you distribute copies of such a program, whether
- gratis or for a fee, you must give the recipients all the rights that
- you have.  You must make sure that they, too, receive or can get the
- source code.  And you must show them these terms so they know their
- rights.
-
- We protect your rights with two steps: (1) copyright the software, and
- (2) offer you this license which gives you legal permission to copy,
- distribute and/or modify the software.
-
- Also, for each author's protection and ours, we want to make certain
- that everyone understands that there is no warranty for this free
- software.  If the software is modified by someone else and passed on, we
- want its recipients to know that what they have is not the original, so
- that any problems introduced by others will not reflect on the original
- authors' reputations.
-
- Finally, any free program is threatened constantly by software
- patents.  We wish to avoid the danger that redistributors of a free
- program will individually obtain patent licenses, in effect making the
- program proprietary.  To prevent this, we have made it clear that any
- patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
- modification follow.
-
-                    GNU GENERAL PUBLIC LICENSE
-  TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-   0. This License applies to any program or other work which contains
- a notice placed by the copyright holder saying it may be distributed
- under the terms of this General Public License.  The "Program", below,
- refers to any such program or work, and a "work based on the Program"
- means either the Program or any derivative work under copyright law:
- that is to say, a work containing the Program or a portion of it,
- either verbatim or with modifications and/or translated into another
- language.  (Hereinafter, translation is included without limitation in
- the term "modification".)  Each licensee is addressed as "you".
-
- Activities other than copying, distribution and modification are not
- covered by this License; they are outside its scope.  The act of
- running the Program is not restricted, and the output from the Program
- is covered only if its contents constitute a work based on the
- Program (independent of having been made by running the Program).
- Whether that is true depends on what the Program does.
-
-    1. You may copy and distribute verbatim copies of the Program's
-  source code as you receive it, in any medium, provided that you
-  conspicuously and appropriately publish on each copy an appropriate
-  copyright notice and disclaimer of warranty; keep intact all the
-  notices that refer to this License and to the absence of any warranty;
-  and give any other recipients of the Program a copy of this License
-  along with the Program.
-
-  You may charge a fee for the physical act of transferring a copy, and
-  you may at your option offer warranty protection in exchange for a fee.
-
-    2. You may modify your copy or copies of the Program or any portion
-  of it, thus forming a work based on the Program, and copy and
-  distribute such modifications or work under the terms of Section 1
-  above, provided that you also meet all of these conditions:
-
-      a) You must cause the modified files to carry prominent notices
-      stating that you changed the files and the date of any change.
-
-      b) You must cause any work that you distribute or publish, that in
-      whole or in part contains or is derived from the Program or any
-      part thereof, to be licensed as a whole at no charge to all third
-      parties under the terms of this License.
-
-      c) If the modified program normally reads commands interactively
-      when run, you must cause it, when started running for such
-      interactive use in the most ordinary way, to print or display an
-      announcement including an appropriate copyright notice and a
-      notice that there is no warranty (or else, saying that you provide
-      a warranty) and that users may redistribute the program under
-      these conditions, and telling the user how to view a copy of this
-      License.  (Exception: if the Program itself is interactive but
-      does not normally print such an announcement, your work based on
-      the Program is not required to print an announcement.)
-  
-  These requirements apply to the modified work as a whole.  If
-  identifiable sections of that work are not derived from the Program,
-  and can be reasonably considered independent and separate works in
-  themselves, then this License, and its terms, do not apply to those
-  sections when you distribute them as separate works.  But when you
-  distribute the same sections as part of a whole which is a work based
-  on the Program, the distribution of the whole must be on the terms of
-  this License, whose permissions for other licensees extend to the
-  entire whole, and thus to each and every part regardless of who wrote it.
-  
-  Thus, it is not the intent of this section to claim rights or contest
-  your rights to work written entirely by you; rather, the intent is to
-  exercise the right to control the distribution of derivative or
-  collective works based on the Program.
-  
-  In addition, mere aggregation of another work not based on the Program
-  with the Program (or with a work based on the Program) on a volume of
-  a storage or distribution medium does not bring the other work under
-  the scope of this License.
-  
-    3. You may copy and distribute the Program (or a work based on it,
-  under Section 2) in object code or executable form under the terms of
-  Sections 1 and 2 above provided that you also do one of the following:
-  
-      a) Accompany it with the complete corresponding machine-readable
-      source code, which must be distributed under the terms of Sections
-      1 and 2 above on a medium customarily used for software interchange; or,
-  
-      b) Accompany it with a written offer, valid for at least three
-      years, to give any third party, for a charge no more than your
-      cost of physically performing source distribution, a complete
-      machine-readable copy of the corresponding source code, to be
-      distributed under the terms of Sections 1 and 2 above on a medium
-      customarily used for software interchange; or,
-  
-      c) Accompany it with the information you received as to the offer
-      to distribute corresponding source code.  (This alternative is
-      allowed only for noncommercial distribution and only if you
-      received the program in object code or executable form with such
-      an offer, in accord with Subsection b above.)
-  
-  The source code for a work means the preferred form of the work for
-  making modifications to it.  For an executable work, complete source
-  code means all the source code for all modules it contains, plus any
-  associated interface definition files, plus the scripts used to
-  control compilation and installation of the executable.  However, as a
-  special exception, the source code distributed need not include
-  anything that is normally distributed (in either source or binary
-  form) with the major components (compiler, kernel, and so on) of the
-  operating system on which the executable runs, unless that component
-  itself accompanies the executable.
-  
-  If distribution of executable or object code is made by offering
-  access to copy from a designated place, then offering equivalent
-  access to copy the source code from the same place counts as
-  distribution of the source code, even though third parties are not
-  compelled to copy the source along with the object code.
-  
-    4. You may not copy, modify, sublicense, or distribute the Program
-  except as expressly provided under this License.  Any attempt
-  otherwise to copy, modify, sublicense or distribute the Program is
-  void, and will automatically terminate your rights under this License.
-  However, parties who have received copies, or rights, from you under
-  this License will not have their licenses terminated so long as such
-  parties remain in full compliance.
-  
-    5. You are not required to accept this License, since you have not
-  signed it.  However, nothing else grants you permission to modify or
-  distribute the Program or its derivative works.  These actions are
-  prohibited by law if you do not accept this License.  Therefore, by
-  modifying or distributing the Program (or any work based on the
-  Program), you indicate your acceptance of this License to do so, and
-  all its terms and conditions for copying, distributing or modifying
-  the Program or works based on it.
-  
-    6. Each time you redistribute the Program (or any work based on the
-  Program), the recipient automatically receives a license from the
-  original licensor to copy, distribute or modify the Program subject to
-  these terms and conditions.  You may not impose any further
-  restrictions on the recipients' exercise of the rights granted herein.
-  You are not responsible for enforcing compliance by third parties to
-  this License.
-  
-    7. If, as a consequence of a court judgment or allegation of patent
-  infringement or for any other reason (not limited to patent issues),
-  conditions are imposed on you (whether by court order, agreement or
-  otherwise) that contradict the conditions of this License, they do not
-  excuse you from the conditions of this License.  If you cannot
-  distribute so as to satisfy simultaneously your obligations under this
-  License and any other pertinent obligations, then as a consequence you
-  may not distribute the Program at all.  For example, if a patent
-  license would not permit royalty-free redistribution of the Program by
-  all those who receive copies directly or indirectly through you, then
-  the only way you could satisfy both it and this License would be to
-  refrain entirely from distribution of the Program.
-  
-  If any portion of this section is held invalid or unenforceable under
-  any particular circumstance, the balance of the section is intended to
-  apply and the section as a whole is intended to apply in other
-  circumstances.
-  
-  It is not the purpose of this section to induce you to infringe any
-  patents or other property right claims or to contest validity of any
-  such claims; this section has the sole purpose of protecting the
-  integrity of the free software distribution system, which is
-  implemented by public license practices.  Many people have made
-  generous contributions to the wide range of software distributed
-  through that system in reliance on consistent application of that
-  system; it is up to the author/donor to decide if he or she is willing
-  to distribute software through any other system and a licensee cannot
-  impose that choice.
-  
-  This section is intended to make thoroughly clear what is believed to
-  be a consequence of the rest of this License.
-  
-    8. If the distribution and/or use of the Program is restricted in
-  certain countries either by patents or by copyrighted interfaces, the
-  original copyright holder who places the Program under this License
-  may add an explicit geographical distribution limitation excluding
-  those countries, so that distribution is permitted only in or among
-  countries not thus excluded.  In such case, this License incorporates
-  the limitation as if written in the body of this License.
-  
-    9. The Free Software Foundation may publish revised and/or new versions
-  of the General Public License from time to time.  Such new versions will
-  be similar in spirit to the present version, but may differ in detail to
-  address new problems or concerns.
-  
-  Each version is given a distinguishing version number.  If the Program
-  specifies a version number of this License which applies to it and "any
-  later version", you have the option of following the terms and conditions
-  either of that version or of any later version published by the Free
-  Software Foundation.  If the Program does not specify a version number of
-  this License, you may choose any version ever published by the Free Software
-  Foundation.
-  
-    10. If you wish to incorporate parts of the Program into other free
-  programs whose distribution conditions are different, write to the author
-  to ask for permission.  For software which is copyrighted by the Free
-  Software Foundation, write to the Free Software Foundation; we sometimes
-  make exceptions for this.  Our decision will be guided by the two goals
-  of preserving the free status of all derivatives of our free software and
-  of promoting the sharing and reuse of software generally.
-  
-                              NO WARRANTY
-  
-    11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-  FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-  OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-  PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-  OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-  TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-  PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-  REPAIR OR CORRECTION.
-  
-    12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-  WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-  REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-  INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-  OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-  TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-  YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-  PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-  POSSIBILITY OF SUCH DAMAGES.
-  
-                      END OF TERMS AND CONDITIONS
-