use_tinymce 0.0.15 → 0.0.16

Sign up to get free protection for your applications and to get access to all the features.
Files changed (94) hide show
  1. data/README.markdown +34 -25
  2. data/Rakefile +13 -3
  3. data/assets/tinymce_jquery_4_0_2/tinymce/LICENSE.TXT +504 -0
  4. data/assets/tinymce_jquery_4_0_2/tinymce/changelog.txt +157 -0
  5. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/jquery.tinymce.min.js +1 -0
  6. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/langs/readme.md +3 -0
  7. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/license.txt +504 -0
  8. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/advlist/plugin.min.js +1 -0
  9. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/anchor/plugin.min.js +1 -0
  10. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/autolink/plugin.min.js +1 -0
  11. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/autoresize/plugin.min.js +1 -0
  12. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/autosave/plugin.min.js +1 -0
  13. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/bbcode/plugin.min.js +1 -0
  14. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/charmap/plugin.min.js +1 -0
  15. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/code/plugin.min.js +1 -0
  16. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/compat3x/editable_selects.js +70 -0
  17. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/compat3x/form_utils.js +210 -0
  18. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/compat3x/mctabs.js +162 -0
  19. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/compat3x/tiny_mce_popup.js +435 -0
  20. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/compat3x/validate.js +252 -0
  21. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/contextmenu/plugin.min.js +1 -0
  22. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/directionality/plugin.min.js +1 -0
  23. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-cool.gif +0 -0
  24. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-cry.gif +0 -0
  25. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-embarassed.gif +0 -0
  26. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-foot-in-mouth.gif +0 -0
  27. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-frown.gif +0 -0
  28. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-innocent.gif +0 -0
  29. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-kiss.gif +0 -0
  30. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-laughing.gif +0 -0
  31. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-money-mouth.gif +0 -0
  32. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-sealed.gif +0 -0
  33. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-smile.gif +0 -0
  34. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-surprised.gif +0 -0
  35. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-tongue-out.gif +0 -0
  36. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-undecided.gif +0 -0
  37. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-wink.gif +0 -0
  38. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/img/smiley-yell.gif +0 -0
  39. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/emoticons/plugin.min.js +1 -0
  40. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/example/plugin.min.js +1 -0
  41. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/example_dependency/plugin.min.js +1 -0
  42. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/fullpage/plugin.min.js +1 -0
  43. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/fullscreen/plugin.min.js +1 -0
  44. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/hr/plugin.min.js +1 -0
  45. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/image/plugin.min.js +1 -0
  46. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/insertdatetime/plugin.min.js +1 -0
  47. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/layer/plugin.min.js +1 -0
  48. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/legacyoutput/plugin.min.js +1 -0
  49. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/link/plugin.min.js +1 -0
  50. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/lists/plugin.min.js +1 -0
  51. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/media/moxieplayer.swf +0 -0
  52. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/media/plugin.min.js +1 -0
  53. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/nonbreaking/plugin.min.js +1 -0
  54. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/noneditable/plugin.min.js +1 -0
  55. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/pagebreak/plugin.min.js +1 -0
  56. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/paste/plugin.min.js +1 -0
  57. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/preview/plugin.min.js +1 -0
  58. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/print/plugin.min.js +1 -0
  59. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/save/plugin.min.js +1 -0
  60. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/searchreplace/plugin.min.js +1 -0
  61. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/spellchecker/plugin.min.js +1 -0
  62. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/tabfocus/plugin.min.js +1 -0
  63. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/table/plugin.min.js +1 -0
  64. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/template/plugin.min.js +1 -0
  65. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/textcolor/plugin.min.js +1 -0
  66. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/visualblocks/css/visualblocks.css +114 -0
  67. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/visualblocks/plugin.min.js +1 -0
  68. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/visualchars/plugin.min.js +1 -0
  69. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/plugins/wordcount/plugin.min.js +1 -0
  70. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/content.inline.min.css +1 -0
  71. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/content.min.css +1 -0
  72. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon-small.eot +0 -0
  73. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon-small.svg +166 -0
  74. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon-small.ttf +0 -0
  75. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon-small.woff +0 -0
  76. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon.eot +0 -0
  77. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon.svg +150 -0
  78. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon.ttf +0 -0
  79. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/icomoon.woff +0 -0
  80. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/fonts/readme.md +1 -0
  81. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/img/anchor.gif +0 -0
  82. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/img/loader.gif +0 -0
  83. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/img/object.gif +0 -0
  84. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/img/trans.gif +0 -0
  85. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/img/wline.gif +0 -0
  86. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/skin.ie7.min.css +1 -0
  87. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/skins/lightgray/skin.min.css +1 -0
  88. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/themes/modern/theme.min.js +1 -0
  89. data/assets/tinymce_jquery_4_0_2/tinymce/js/tinymce/tinymce.min.js +9 -0
  90. data/lib/tasks/use_tinymce.rake +14 -1
  91. data/lib/use_tinymce/railengine.rb +1 -1
  92. data/lib/use_tinymce/use_tinymce.rb +15 -6
  93. data/lib/use_tinymce/version.rb +1 -0
  94. metadata +474 -386
data/README.markdown CHANGED
@@ -1,38 +1,40 @@
1
- UseTinyMCE - 0.0.13.pre1
1
+ [![DevOps By Rultor.com](http://www.rultor.com/b/mikehoward/use_tinymce)](http://www.rultor.com/p/mikehoward/use_tinymce)
2
+
3
+ [![Gem Version](https://badge.fury.io/rb/use_tinymce.svg)](http://badge.fury.io/rb/use_tinymce)
4
+
5
+ UseTinyMCE
2
6
  ==========
3
7
 
4
8
  **UseTinyMCE** is yet another (as if we needed another) hack for including
5
- TinyMCE in a Rails 3.0, 3.1, or 3.2 app.
9
+ TinyMCE in a Rails 3.0, 3.1, 3.2 or 4.0 app.
6
10
 
7
11
  **NOTE:** Rails 3.1.0 broke version 0.0.8. The current version has been tested
8
- on Rails 3.1.0, 3.0.13 and (smoke tested) on Rails 3.2.1. All installations (seem to)
9
- work properly.
12
+ on Rails 4.0.0. It *should* work on 3.0, 3.1 and 3.2 because "nothing there has been changed". Let me know if this is not true.
10
13
 
11
- It differs from the others that I looked at on rubygems in that:
14
+ This gem differs from the others that I looked at on rubygems in that:
12
15
 
13
- 1. It works with Rails [3.0](#rails_30_integration) & [3.1.0](#rails_31_integration),
14
- details below
16
+ 1. It works with Rails [3.0](#rails_30_integration), [3.1 & 3.2](#rails_31_integration) and [4.0](#rails_40_integration) details below
15
17
  2. It's minimal. It does not provide any juicy Rails style configuration for
16
18
  TinyMCE. You just use the config stuff which comes with TinyMCE - in javascript.
17
- 3. I only use Ruby 1.9.2 & depend on others to find and patch bugs in 1.8.x.
18
- Version 0.0.12 contains a patch by github://janne to correct the syntax of the rakefile
19
+ 3. I've moved on to Ruby 2.0, so I'm now depending on others to find and patch bugs in 1.9.x
20
+ and 1.8.x. For example, version 0.0.12 contains a patch by github://janne to correct the syntax of the rakefile
19
21
  so that it works with the Regexp engine in 1.8.x
20
22
 
21
- ## Rails 3.0 & 3.1 Integration
23
+ ## Rails Integration
22
24
 
23
- It's almost the same in both cases. See [Step By Step](#step_by_step) below.
25
+ It's almost the same in all cases. See [Step By Step](#step_by_step) below.
24
26
 
25
27
  **Rails 3.0 Note:** Rails 3.0 defaults to `prototype` for javascript, so `use_tinymce`
26
28
  supports both *raw* TinyMCE (which works well with Prototype) and the *jquery* version,
27
29
  which works with 'jquery'. It also supports both *simple* and *advanced* editor
28
30
  installations for the *raw* type.
29
31
 
30
- **Rails 3.1 Note:** TinyMCE doesn't play well with the asset pipeline, so it is installed
32
+ **Rails 3.1, 3.2 and 4.0 Note:** TinyMCE doesn't play well with the asset pipeline, so it is installed
31
33
  in public. This has to do with the way TinyMCE is architected: it is plugin based
32
34
  and scatters javascript, css, and html all through it's plugin directory. It manages it's
33
35
  own loading.
34
36
 
35
- Also, **Rails 3.1** defaults to jQuery for javascript, so `use_tinymce` does not support
37
+ Also, since **3.1** Rails defaults to jQuery for javascript, so `use_tinymce` does not support
36
38
  installing the *raw* version of TinyMCE.
37
39
 
38
40
  ## Selectively adding TinyMCE to selected text areas
@@ -60,7 +62,7 @@ in which you want to run *TinyMCE*. `args` should be:
60
62
  * `:all` - to enable *TinyMCE* for all actions
61
63
  * `:foo, :bar` - to enable *TinyMCE* only for views rendered by `foo` and `bar` actions
62
64
  [usually this is something like `use_tinymce :new, :edit`].
63
-
65
+
64
66
  3. Add `<%= use_tinymce_link %>` to the `HEAD` section of you application layout - for *at least*
65
67
  all pages which should use *TinyMCE*
66
68
 
@@ -85,9 +87,9 @@ If you don't need much and aren't familiar with *TinyMCE*, then `rake use_tinymc
85
87
  should be fine. The *advanced* version configures *TinyMCE* with many more features. Go to
86
88
  the ["TinyMCE website for details"](http://tinymce.moxiecode.com/)
87
89
 
88
- Rails 3.1
90
+ Rails 3.1, 3.2 and 4.0
89
91
 
90
- * rake use_tinymce:install - installs the jQuery version of TinyMCE
92
+ * `rake use_tinymce:install` - installs the jQuery version of TinyMCE
91
93
  * `rake use_tinymce:uninstall` - removes all trace of TinyMCE & the initialization file from
92
94
  your `/public/javascripts` directory. **WARNING:** this wipes out any customizations you have
93
95
  done to the `init_tinymce.js` file. **WARNING:** `uninstall` is *always* run prior to
@@ -130,28 +132,30 @@ by a previous call to `use_tinymce` [or if you included `use_tinymce :all` in yo
130
132
  ## Rake Tasks:
131
133
 
132
134
  **NOTE** `assets` here refers to the `assets` directory in the `use_tinymce`
133
- gem - **not** the Rails 3.1 asset pipeline directory.
135
+ gem - **not** the Rails 3.1, 3.2 and 4.0 asset pipeline directory.
134
136
 
135
137
  This initialization scripts were copied literally from the TinyMCE website
136
- ["For Dummies" page](http://tinymce.moxiecode.com/wiki.php/%22For_Dummies%22)
138
+ ["For Dummies" page](http://tinymce.moxiecode.com/wiki.php/%22For_Dummies%22)
137
139
  - that is: *http://tinymce.moxiecode.com/wiki.php/%22For_Dummies%22*
138
140
 
139
141
  ### Rails 3.0
140
142
 
143
+ **NOTE** Rails 3.0 support is no longer maintained by me. I will accept patches, but will not test them.
144
+
141
145
  Prototype Versions:
142
146
 
143
147
  * `rake use_tinymce:install_advanced` copies `use_tinymce/assets/use_tinymce_init_advanced.js`
144
148
  and the contents of `use_tinymce/tinymce_no_jquery` -
145
149
  which provides all the full blown features.
146
150
 
147
- * `rake use_tinymce:install_simple` copies `use_tinymce/assets/use_tinymce_init_simple.js`
151
+ * `rake use_tinymce:install_simple` copies `use_tinymce/assets/use_tinymce_init_simple.js`
148
152
  and the contents of `use_tinymce/tinymce_no_jquery` -
149
153
  copies the bare bones version.
150
154
 
151
155
  The jQuery version was copied from an example script and then slightly modified
152
156
  [see the code comments].
153
157
 
154
- * `rake use_tinymce:install_jquery` copies `assets/use_tinymce_init_jquery.js`
158
+ * `rake use_tinymce:install_jquery` copies `assets/use_tinymce_init_jquery.js`
155
159
  and the contents of `use_tinymce/tinymce_jquery` -
156
160
  which attaches an 'advanced' TinyMCE configuration to textareas.
157
161
 
@@ -164,13 +168,15 @@ directory from your applications `public/javascripts`
164
168
  `rake use_tinymce::install_*` to insure you get a clean installation. This will also
165
169
  *clean* out any customization you have done.
166
170
 
167
- ### Rails 3.1
171
+ ### Rails 3.1, 3.2 and 4.0
172
+
173
+ **NOTE** I no longer support this gem for Rails 3.1 and 3.2. I will accept patches, but will not test them.
168
174
 
169
- `use_tinymce` only supports installing the jQuery version of TinyMCE on Rails 3.1.
175
+ `use_tinymce` only supports installing the jQuery version of TinyMCE on Rails 3.1, 3.2 and 4.0.
170
176
 
171
177
  There are two Rake tasks:
172
178
 
173
- * rake use_tinymce:install - copies `assets/use_tinymce_init_jquery.js`
179
+ * rake use_tinymce:install - copies `assets/use_tinymce_init_jquery.js`
174
180
  and the contents of `use_tinymce/tinymce_jquery` -
175
181
  which attaches an 'advanced' TinyMCE configuration to textareas.
176
182
  * `rake use_tinymce:uninstall` removes use_tinymce_init.js and the TinyMCE
@@ -192,10 +198,13 @@ So, if you want to do it, have a blast - but please don't send me the patches.
192
198
 
193
199
  ## Upgrading *TinyMCE*
194
200
 
195
- `use_tinymce` ships with version 3.4.2 of *TinyMCE* - which I downloaded from the Moxiecode
201
+ `use_tinymce` ships with two versions of *TinyMCE* which I downloaded from the Moxiecode
196
202
  website. You *should* be able to upgrade your *TinyMCE* if you want by doing the exact
197
203
  same thing and then unpacking the zip file in `/public/javascript`
198
204
 
205
+ version 3.4.2 of *TinyMCE* - used for Rails 3.0, 3.1 and 3.2 (it was working, so why change?)
206
+ version 4.0.2 for Rails 4.0.0 - I decided to add this when adding support for Rails 4.0
207
+
199
208
  **WARNING:** Rails 3.1 uses sprockets which has a problem compiling non-Unicoded characters.
200
209
  the advanced *TinyMCE* contains some directly encoded characters in the *spellchecker_word_separator_chars*
201
210
  variable in the spellchecking plugin. I've modified the code to convert them to Unicode \U...
@@ -211,4 +220,4 @@ Alternately (2), you can send me a note and I *might* upgrade the *TinyMCE* in t
211
220
  Then you'd need to do a `bundle update use_tinymce`, run the rake task, re-create your
212
221
  special customizations, etc.
213
222
 
214
- It's probably easier to grab the code from ["Moxiecode"](http://tinymce.moxiecode.com/download/download.php)
223
+ It's probably easier to grab the code from ["Moxiecode"](http://tinymce.moxiecode.com/download/download.php)
data/Rakefile CHANGED
@@ -1,4 +1,5 @@
1
1
  require 'rake'
2
+ require "./lib/use_tinymce/version.rb"
2
3
 
3
4
  gem_name = 'use_tinymce'
4
5
 
@@ -16,8 +17,13 @@ task :test do
16
17
  require "./test/test_#{gem_name}_base"
17
18
  end
18
19
 
20
+ desc "create README.markdown from README.markdown.in by replacing @@FOO@@ with FOO Value"
21
+ file "README.markdown" => ["README.markdown.in"] do
22
+ system "sed -e 's/@@VERSION@@/#{VERSION}/g' <'README.markdown.in' >'README.markdown'"
23
+ end
24
+
19
25
  desc "build gem"
20
- task :gem do
26
+ task :gem => ["README.markdown"] do
21
27
  system "gem build #{gem_name}.gemspec"
22
28
  if 'mike.local' == IO.popen('hostname').read.chomp
23
29
  system "cp #{gem_name}-#{gem_version}.gem ~/Rails/GemCache/gems/"
@@ -26,6 +32,10 @@ task :gem do
26
32
  end
27
33
 
28
34
  desc "push to rubygems"
29
- task :gem_push => :gem do
30
- system "gem push #{gem_name}-#{gem_version}.gem"
35
+ task :gem_push => [:gem] do
36
+ unless VERSION =~ /pre/ then
37
+ system "gem push #{gem_name}-#{gem_version}.gem"
38
+ else
39
+ puts "Cannot push a pre version - test it you fool!!!!"
40
+ end
31
41
  end
@@ -0,0 +1,504 @@
1
+ GNU LESSER GENERAL PUBLIC LICENSE
2
+ Version 2.1, February 1999
3
+
4
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
5
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
6
+ Everyone is permitted to copy and distribute verbatim copies
7
+ of this license document, but changing it is not allowed.
8
+
9
+ [This is the first released version of the Lesser GPL. It also counts
10
+ as the successor of the GNU Library Public License, version 2, hence
11
+ the version number 2.1.]
12
+
13
+ Preamble
14
+
15
+ The licenses for most software are designed to take away your
16
+ freedom to share and change it. By contrast, the GNU General Public
17
+ Licenses are intended to guarantee your freedom to share and change
18
+ free software--to make sure the software is free for all its users.
19
+
20
+ This license, the Lesser General Public License, applies to some
21
+ specially designated software packages--typically libraries--of the
22
+ Free Software Foundation and other authors who decide to use it. You
23
+ can use it too, but we suggest you first think carefully about whether
24
+ this license or the ordinary General Public License is the better
25
+ strategy to use in any particular case, based on the explanations below.
26
+
27
+ When we speak of free software, we are referring to freedom of use,
28
+ not price. Our General Public Licenses are designed to make sure that
29
+ you have the freedom to distribute copies of free software (and charge
30
+ for this service if you wish); that you receive source code or can get
31
+ it if you want it; that you can change the software and use pieces of
32
+ it in new free programs; and that you are informed that you can do
33
+ these things.
34
+
35
+ To protect your rights, we need to make restrictions that forbid
36
+ distributors to deny you these rights or to ask you to surrender these
37
+ rights. These restrictions translate to certain responsibilities for
38
+ you if you distribute copies of the library or if you modify it.
39
+
40
+ For example, if you distribute copies of the library, whether gratis
41
+ or for a fee, you must give the recipients all the rights that we gave
42
+ you. You must make sure that they, too, receive or can get the source
43
+ code. If you link other code with the library, you must provide
44
+ complete object files to the recipients, so that they can relink them
45
+ with the library after making changes to the library and recompiling
46
+ it. And you must show them these terms so they know their rights.
47
+
48
+ We protect your rights with a two-step method: (1) we copyright the
49
+ library, and (2) we offer you this license, which gives you legal
50
+ permission to copy, distribute and/or modify the library.
51
+
52
+ To protect each distributor, we want to make it very clear that
53
+ there is no warranty for the free library. Also, if the library is
54
+ modified by someone else and passed on, the recipients should know
55
+ that what they have is not the original version, so that the original
56
+ author's reputation will not be affected by problems that might be
57
+ introduced by others.
58
+
59
+ Finally, software patents pose a constant threat to the existence of
60
+ any free program. We wish to make sure that a company cannot
61
+ effectively restrict the users of a free program by obtaining a
62
+ restrictive license from a patent holder. Therefore, we insist that
63
+ any patent license obtained for a version of the library must be
64
+ consistent with the full freedom of use specified in this license.
65
+
66
+ Most GNU software, including some libraries, is covered by the
67
+ ordinary GNU General Public License. This license, the GNU Lesser
68
+ General Public License, applies to certain designated libraries, and
69
+ is quite different from the ordinary General Public License. We use
70
+ this license for certain libraries in order to permit linking those
71
+ libraries into non-free programs.
72
+
73
+ When a program is linked with a library, whether statically or using
74
+ a shared library, the combination of the two is legally speaking a
75
+ combined work, a derivative of the original library. The ordinary
76
+ General Public License therefore permits such linking only if the
77
+ entire combination fits its criteria of freedom. The Lesser General
78
+ Public License permits more lax criteria for linking other code with
79
+ the library.
80
+
81
+ We call this license the "Lesser" General Public License because it
82
+ does Less to protect the user's freedom than the ordinary General
83
+ Public License. It also provides other free software developers Less
84
+ of an advantage over competing non-free programs. These disadvantages
85
+ are the reason we use the ordinary General Public License for many
86
+ libraries. However, the Lesser license provides advantages in certain
87
+ special circumstances.
88
+
89
+ For example, on rare occasions, there may be a special need to
90
+ encourage the widest possible use of a certain library, so that it becomes
91
+ a de-facto standard. To achieve this, non-free programs must be
92
+ allowed to use the library. A more frequent case is that a free
93
+ library does the same job as widely used non-free libraries. In this
94
+ case, there is little to gain by limiting the free library to free
95
+ software only, so we use the Lesser General Public License.
96
+
97
+ In other cases, permission to use a particular library in non-free
98
+ programs enables a greater number of people to use a large body of
99
+ free software. For example, permission to use the GNU C Library in
100
+ non-free programs enables many more people to use the whole GNU
101
+ operating system, as well as its variant, the GNU/Linux operating
102
+ system.
103
+
104
+ Although the Lesser General Public License is Less protective of the
105
+ users' freedom, it does ensure that the user of a program that is
106
+ linked with the Library has the freedom and the wherewithal to run
107
+ that program using a modified version of the Library.
108
+
109
+ The precise terms and conditions for copying, distribution and
110
+ modification follow. Pay close attention to the difference between a
111
+ "work based on the library" and a "work that uses the library". The
112
+ former contains code derived from the library, whereas the latter must
113
+ be combined with the library in order to run.
114
+
115
+ GNU LESSER GENERAL PUBLIC LICENSE
116
+ TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
117
+
118
+ 0. This License Agreement applies to any software library or other
119
+ program which contains a notice placed by the copyright holder or
120
+ other authorized party saying it may be distributed under the terms of
121
+ this Lesser General Public License (also called "this License").
122
+ Each licensee is addressed as "you".
123
+
124
+ A "library" means a collection of software functions and/or data
125
+ prepared so as to be conveniently linked with application programs
126
+ (which use some of those functions and data) to form executables.
127
+
128
+ The "Library", below, refers to any such software library or work
129
+ which has been distributed under these terms. A "work based on the
130
+ Library" means either the Library or any derivative work under
131
+ copyright law: that is to say, a work containing the Library or a
132
+ portion of it, either verbatim or with modifications and/or translated
133
+ straightforwardly into another language. (Hereinafter, translation is
134
+ included without limitation in the term "modification".)
135
+
136
+ "Source code" for a work means the preferred form of the work for
137
+ making modifications to it. For a library, complete source code means
138
+ all the source code for all modules it contains, plus any associated
139
+ interface definition files, plus the scripts used to control compilation
140
+ and installation of the library.
141
+
142
+ Activities other than copying, distribution and modification are not
143
+ covered by this License; they are outside its scope. The act of
144
+ running a program using the Library is not restricted, and output from
145
+ such a program is covered only if its contents constitute a work based
146
+ on the Library (independent of the use of the Library in a tool for
147
+ writing it). Whether that is true depends on what the Library does
148
+ and what the program that uses the Library does.
149
+
150
+ 1. You may copy and distribute verbatim copies of the Library's
151
+ complete source code as you receive it, in any medium, provided that
152
+ you conspicuously and appropriately publish on each copy an
153
+ appropriate copyright notice and disclaimer of warranty; keep intact
154
+ all the notices that refer to this License and to the absence of any
155
+ warranty; and distribute a copy of this License along with the
156
+ Library.
157
+
158
+ You may charge a fee for the physical act of transferring a copy,
159
+ and you may at your option offer warranty protection in exchange for a
160
+ fee.
161
+
162
+ 2. You may modify your copy or copies of the Library or any portion
163
+ of it, thus forming a work based on the Library, and copy and
164
+ distribute such modifications or work under the terms of Section 1
165
+ above, provided that you also meet all of these conditions:
166
+
167
+ a) The modified work must itself be a software library.
168
+
169
+ b) You must cause the files modified to carry prominent notices
170
+ stating that you changed the files and the date of any change.
171
+
172
+ c) You must cause the whole of the work to be licensed at no
173
+ charge to all third parties under the terms of this License.
174
+
175
+ d) If a facility in the modified Library refers to a function or a
176
+ table of data to be supplied by an application program that uses
177
+ the facility, other than as an argument passed when the facility
178
+ is invoked, then you must make a good faith effort to ensure that,
179
+ in the event an application does not supply such function or
180
+ table, the facility still operates, and performs whatever part of
181
+ its purpose remains meaningful.
182
+
183
+ (For example, a function in a library to compute square roots has
184
+ a purpose that is entirely well-defined independent of the
185
+ application. Therefore, Subsection 2d requires that any
186
+ application-supplied function or table used by this function must
187
+ be optional: if the application does not supply it, the square
188
+ root function must still compute square roots.)
189
+
190
+ These requirements apply to the modified work as a whole. If
191
+ identifiable sections of that work are not derived from the Library,
192
+ and can be reasonably considered independent and separate works in
193
+ themselves, then this License, and its terms, do not apply to those
194
+ sections when you distribute them as separate works. But when you
195
+ distribute the same sections as part of a whole which is a work based
196
+ on the Library, the distribution of the whole must be on the terms of
197
+ this License, whose permissions for other licensees extend to the
198
+ entire whole, and thus to each and every part regardless of who wrote
199
+ it.
200
+
201
+ Thus, it is not the intent of this section to claim rights or contest
202
+ your rights to work written entirely by you; rather, the intent is to
203
+ exercise the right to control the distribution of derivative or
204
+ collective works based on the Library.
205
+
206
+ In addition, mere aggregation of another work not based on the Library
207
+ with the Library (or with a work based on the Library) on a volume of
208
+ a storage or distribution medium does not bring the other work under
209
+ the scope of this License.
210
+
211
+ 3. You may opt to apply the terms of the ordinary GNU General Public
212
+ License instead of this License to a given copy of the Library. To do
213
+ this, you must alter all the notices that refer to this License, so
214
+ that they refer to the ordinary GNU General Public License, version 2,
215
+ instead of to this License. (If a newer version than version 2 of the
216
+ ordinary GNU General Public License has appeared, then you can specify
217
+ that version instead if you wish.) Do not make any other change in
218
+ these notices.
219
+
220
+ Once this change is made in a given copy, it is irreversible for
221
+ that copy, so the ordinary GNU General Public License applies to all
222
+ subsequent copies and derivative works made from that copy.
223
+
224
+ This option is useful when you wish to copy part of the code of
225
+ the Library into a program that is not a library.
226
+
227
+ 4. You may copy and distribute the Library (or a portion or
228
+ derivative of it, under Section 2) in object code or executable form
229
+ under the terms of Sections 1 and 2 above provided that you accompany
230
+ it with the complete corresponding machine-readable source code, which
231
+ must be distributed under the terms of Sections 1 and 2 above on a
232
+ medium customarily used for software interchange.
233
+
234
+ If distribution of object code is made by offering access to copy
235
+ from a designated place, then offering equivalent access to copy the
236
+ source code from the same place satisfies the requirement to
237
+ distribute the source code, even though third parties are not
238
+ compelled to copy the source along with the object code.
239
+
240
+ 5. A program that contains no derivative of any portion of the
241
+ Library, but is designed to work with the Library by being compiled or
242
+ linked with it, is called a "work that uses the Library". Such a
243
+ work, in isolation, is not a derivative work of the Library, and
244
+ therefore falls outside the scope of this License.
245
+
246
+ However, linking a "work that uses the Library" with the Library
247
+ creates an executable that is a derivative of the Library (because it
248
+ contains portions of the Library), rather than a "work that uses the
249
+ library". The executable is therefore covered by this License.
250
+ Section 6 states terms for distribution of such executables.
251
+
252
+ When a "work that uses the Library" uses material from a header file
253
+ that is part of the Library, the object code for the work may be a
254
+ derivative work of the Library even though the source code is not.
255
+ Whether this is true is especially significant if the work can be
256
+ linked without the Library, or if the work is itself a library. The
257
+ threshold for this to be true is not precisely defined by law.
258
+
259
+ If such an object file uses only numerical parameters, data
260
+ structure layouts and accessors, and small macros and small inline
261
+ functions (ten lines or less in length), then the use of the object
262
+ file is unrestricted, regardless of whether it is legally a derivative
263
+ work. (Executables containing this object code plus portions of the
264
+ Library will still fall under Section 6.)
265
+
266
+ Otherwise, if the work is a derivative of the Library, you may
267
+ distribute the object code for the work under the terms of Section 6.
268
+ Any executables containing that work also fall under Section 6,
269
+ whether or not they are linked directly with the Library itself.
270
+
271
+ 6. As an exception to the Sections above, you may also combine or
272
+ link a "work that uses the Library" with the Library to produce a
273
+ work containing portions of the Library, and distribute that work
274
+ under terms of your choice, provided that the terms permit
275
+ modification of the work for the customer's own use and reverse
276
+ engineering for debugging such modifications.
277
+
278
+ You must give prominent notice with each copy of the work that the
279
+ Library is used in it and that the Library and its use are covered by
280
+ this License. You must supply a copy of this License. If the work
281
+ during execution displays copyright notices, you must include the
282
+ copyright notice for the Library among them, as well as a reference
283
+ directing the user to the copy of this License. Also, you must do one
284
+ of these things:
285
+
286
+ a) Accompany the work with the complete corresponding
287
+ machine-readable source code for the Library including whatever
288
+ changes were used in the work (which must be distributed under
289
+ Sections 1 and 2 above); and, if the work is an executable linked
290
+ with the Library, with the complete machine-readable "work that
291
+ uses the Library", as object code and/or source code, so that the
292
+ user can modify the Library and then relink to produce a modified
293
+ executable containing the modified Library. (It is understood
294
+ that the user who changes the contents of definitions files in the
295
+ Library will not necessarily be able to recompile the application
296
+ to use the modified definitions.)
297
+
298
+ b) Use a suitable shared library mechanism for linking with the
299
+ Library. A suitable mechanism is one that (1) uses at run time a
300
+ copy of the library already present on the user's computer system,
301
+ rather than copying library functions into the executable, and (2)
302
+ will operate properly with a modified version of the library, if
303
+ the user installs one, as long as the modified version is
304
+ interface-compatible with the version that the work was made with.
305
+
306
+ c) Accompany the work with a written offer, valid for at
307
+ least three years, to give the same user the materials
308
+ specified in Subsection 6a, above, for a charge no more
309
+ than the cost of performing this distribution.
310
+
311
+ d) If distribution of the work is made by offering access to copy
312
+ from a designated place, offer equivalent access to copy the above
313
+ specified materials from the same place.
314
+
315
+ e) Verify that the user has already received a copy of these
316
+ materials or that you have already sent this user a copy.
317
+
318
+ For an executable, the required form of the "work that uses the
319
+ Library" must include any data and utility programs needed for
320
+ reproducing the executable from it. However, as a special exception,
321
+ the materials to be distributed need not include anything that is
322
+ normally distributed (in either source or binary form) with the major
323
+ components (compiler, kernel, and so on) of the operating system on
324
+ which the executable runs, unless that component itself accompanies
325
+ the executable.
326
+
327
+ It may happen that this requirement contradicts the license
328
+ restrictions of other proprietary libraries that do not normally
329
+ accompany the operating system. Such a contradiction means you cannot
330
+ use both them and the Library together in an executable that you
331
+ distribute.
332
+
333
+ 7. You may place library facilities that are a work based on the
334
+ Library side-by-side in a single library together with other library
335
+ facilities not covered by this License, and distribute such a combined
336
+ library, provided that the separate distribution of the work based on
337
+ the Library and of the other library facilities is otherwise
338
+ permitted, and provided that you do these two things:
339
+
340
+ a) Accompany the combined library with a copy of the same work
341
+ based on the Library, uncombined with any other library
342
+ facilities. This must be distributed under the terms of the
343
+ Sections above.
344
+
345
+ b) Give prominent notice with the combined library of the fact
346
+ that part of it is a work based on the Library, and explaining
347
+ where to find the accompanying uncombined form of the same work.
348
+
349
+ 8. You may not copy, modify, sublicense, link with, or distribute
350
+ the Library except as expressly provided under this License. Any
351
+ attempt otherwise to copy, modify, sublicense, link with, or
352
+ distribute the Library is void, and will automatically terminate your
353
+ rights under this License. However, parties who have received copies,
354
+ or rights, from you under this License will not have their licenses
355
+ terminated so long as such parties remain in full compliance.
356
+
357
+ 9. You are not required to accept this License, since you have not
358
+ signed it. However, nothing else grants you permission to modify or
359
+ distribute the Library or its derivative works. These actions are
360
+ prohibited by law if you do not accept this License. Therefore, by
361
+ modifying or distributing the Library (or any work based on the
362
+ Library), you indicate your acceptance of this License to do so, and
363
+ all its terms and conditions for copying, distributing or modifying
364
+ the Library or works based on it.
365
+
366
+ 10. Each time you redistribute the Library (or any work based on the
367
+ Library), the recipient automatically receives a license from the
368
+ original licensor to copy, distribute, link with or modify the Library
369
+ subject to these terms and conditions. You may not impose any further
370
+ restrictions on the recipients' exercise of the rights granted herein.
371
+ You are not responsible for enforcing compliance by third parties with
372
+ this License.
373
+
374
+ 11. If, as a consequence of a court judgment or allegation of patent
375
+ infringement or for any other reason (not limited to patent issues),
376
+ conditions are imposed on you (whether by court order, agreement or
377
+ otherwise) that contradict the conditions of this License, they do not
378
+ excuse you from the conditions of this License. If you cannot
379
+ distribute so as to satisfy simultaneously your obligations under this
380
+ License and any other pertinent obligations, then as a consequence you
381
+ may not distribute the Library at all. For example, if a patent
382
+ license would not permit royalty-free redistribution of the Library by
383
+ all those who receive copies directly or indirectly through you, then
384
+ the only way you could satisfy both it and this License would be to
385
+ refrain entirely from distribution of the Library.
386
+
387
+ If any portion of this section is held invalid or unenforceable under any
388
+ particular circumstance, the balance of the section is intended to apply,
389
+ and the section as a whole is intended to apply in other circumstances.
390
+
391
+ It is not the purpose of this section to induce you to infringe any
392
+ patents or other property right claims or to contest validity of any
393
+ such claims; this section has the sole purpose of protecting the
394
+ integrity of the free software distribution system which is
395
+ implemented by public license practices. Many people have made
396
+ generous contributions to the wide range of software distributed
397
+ through that system in reliance on consistent application of that
398
+ system; it is up to the author/donor to decide if he or she is willing
399
+ to distribute software through any other system and a licensee cannot
400
+ impose that choice.
401
+
402
+ This section is intended to make thoroughly clear what is believed to
403
+ be a consequence of the rest of this License.
404
+
405
+ 12. If the distribution and/or use of the Library is restricted in
406
+ certain countries either by patents or by copyrighted interfaces, the
407
+ original copyright holder who places the Library under this License may add
408
+ an explicit geographical distribution limitation excluding those countries,
409
+ so that distribution is permitted only in or among countries not thus
410
+ excluded. In such case, this License incorporates the limitation as if
411
+ written in the body of this License.
412
+
413
+ 13. The Free Software Foundation may publish revised and/or new
414
+ versions of the Lesser General Public License from time to time.
415
+ Such new versions will be similar in spirit to the present version,
416
+ but may differ in detail to address new problems or concerns.
417
+
418
+ Each version is given a distinguishing version number. If the Library
419
+ specifies a version number of this License which applies to it and
420
+ "any later version", you have the option of following the terms and
421
+ conditions either of that version or of any later version published by
422
+ the Free Software Foundation. If the Library does not specify a
423
+ license version number, you may choose any version ever published by
424
+ the Free Software Foundation.
425
+
426
+ 14. If you wish to incorporate parts of the Library into other free
427
+ programs whose distribution conditions are incompatible with these,
428
+ write to the author to ask for permission. For software which is
429
+ copyrighted by the Free Software Foundation, write to the Free
430
+ Software Foundation; we sometimes make exceptions for this. Our
431
+ decision will be guided by the two goals of preserving the free status
432
+ of all derivatives of our free software and of promoting the sharing
433
+ and reuse of software generally.
434
+
435
+ NO WARRANTY
436
+
437
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
438
+ WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
439
+ EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
440
+ OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
441
+ KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
442
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
443
+ PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
444
+ LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
445
+ THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
446
+
447
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
448
+ WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
449
+ AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
450
+ FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
451
+ CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
452
+ LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
453
+ RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
454
+ FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
455
+ SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
456
+ DAMAGES.
457
+
458
+ END OF TERMS AND CONDITIONS
459
+
460
+ How to Apply These Terms to Your New Libraries
461
+
462
+ If you develop a new library, and you want it to be of the greatest
463
+ possible use to the public, we recommend making it free software that
464
+ everyone can redistribute and change. You can do so by permitting
465
+ redistribution under these terms (or, alternatively, under the terms of the
466
+ ordinary General Public License).
467
+
468
+ To apply these terms, attach the following notices to the library. It is
469
+ safest to attach them to the start of each source file to most effectively
470
+ convey the exclusion of warranty; and each file should have at least the
471
+ "copyright" line and a pointer to where the full notice is found.
472
+
473
+ <one line to give the library's name and a brief idea of what it does.>
474
+ Copyright (C) <year> <name of author>
475
+
476
+ This library is free software; you can redistribute it and/or
477
+ modify it under the terms of the GNU Lesser General Public
478
+ License as published by the Free Software Foundation; either
479
+ version 2.1 of the License, or (at your option) any later version.
480
+
481
+ This library is distributed in the hope that it will be useful,
482
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
483
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
484
+ Lesser General Public License for more details.
485
+
486
+ You should have received a copy of the GNU Lesser General Public
487
+ License along with this library; if not, write to the Free Software
488
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
489
+
490
+ Also add information on how to contact you by electronic and paper mail.
491
+
492
+ You should also get your employer (if you work as a programmer) or your
493
+ school, if any, to sign a "copyright disclaimer" for the library, if
494
+ necessary. Here is a sample; alter the names:
495
+
496
+ Yoyodyne, Inc., hereby disclaims all copyright interest in the
497
+ library `Frob' (a library for tweaking knobs) written by James Random Hacker.
498
+
499
+ <signature of Ty Coon>, 1 April 1990
500
+ Ty Coon, President of Vice
501
+
502
+ That's all there is to it!
503
+
504
+