doc fixes

* remove stray comma in generated docs
* small improvements to clarity
* regenerated autodocs for latest libvips

see #97

CHANGELOG.md

@@ -1,5 +1,11 @@
 # master 
 
+# Version 1.0.4
+
+* remove stray comma from some docs lines [John Cupitt]
+* update generated docs for libvips 8.5 [John Cupitt]
+* small doc improvements [John Cupitt]
+
 # Version 1.0.3
 
 * doc improvements [John Cupitt]

TODO

@@ -1,26 +1,5 @@
 # Notes
 
-- travis needs fixing, we have this is 0.3
-
-	rvm:
-	  - 1.9.3
-	  - 2.0
-	  - 2.1
-	script: "rake"
-	gemfile:
-	  - Gemfile
-	before_install:
-	  - uname -a
-	  - sudo apt-get update
-	  - sudo apt-get install libvips-dev
-	before_script:
-	  - ./compile
-
-- need something like the old ruby-vips occasional GC stuff, we can fill 
-  memory before a GC is triggered
-
-  need a test case
-
 - mail about the getpoint unimplemented error
 
   http://sourceforge.net/p/ruby-gnome2/mailman/ruby-gnome2-devel-en/thread/CAGNS0RuZ5N6bha3M7B0%2BYf2M9-oni44idzZO17mtQiykS%2BmJKQ%40mail.gmail.com/#msg34790843
@@ -32,33 +11,6 @@
 	Complex(1, 2)
 	=> (1+2i)
 
-- fix travis ... the difficulty is getting a libvips with goi built first,
-  perhaps copy-paste from libvips .travis.yml
-
-  this is almost enough to do the ruby side:
-
-----------
-env:
-  global:
-    - NOKOGIRI_USE_SYSTEM_LIBRARIES=true
-
-language: ruby
-rvm:
-  - 2.1
-  - 2.2
-  - 2.3
-
-script: "bundle exec rake"
-
-gemfile:
-  - Gemfile
-
-before_install:
-  - uname -a
-  - sudo apt-get update
-  - sudo apt-get install libvips-dev
------------
-
 # Common operations
 
 - version bump

VERSION

@@ -1 +1 @@
-1.0.3
+1.0.4

lib/vips/image.rb

@@ -421,10 +421,11 @@ def self.method_missing(name, *args)
         # $ vips jpegload
         # ```
         #
-        # at the command-line to see a summary of the available options.
+        # at the command-line to see a summary of the available options for the
+        # JPEG loader.
         #
         # Loading is fast: only enough of the image is loaded to be able to fill
-        # out the header. Pixels will only be processed when they are needed.
+        # out the header. Pixels will only be decompressed when they are needed.
         #
         # @!macro [new] vips.loadopts
         #   @param [Hash] opts set of options
@@ -451,8 +452,8 @@ def self.new_from_file(name, opts = {})
             Vips::call_base loader, nil, option_string, [filename, opts]
         end
 
-        # Create a new {Image} for an image encoded in a format, such as
-        # JPEG, in a memory string. Load options may be passed encoded as
+        # Create a new {Image} for an image encoded, in a format such as
+        # JPEG, in a memory string. Load options may be passed as
         # strings, or appended as a hash. For example:
         #
         # ```
@@ -471,11 +472,12 @@ def self.new_from_file(name, opts = {})
         # $ vips jpegload_buffer
         # ```
         #
-        # at the command-line to see the available options. Only JPEG, PNG and
-        # TIFF images can be read from memory buffers. 
+        # at the command-line to see the available options. Not all loaders 
+        # support load from buffer, but at least JPEG, PNG and
+        # TIFF images will work. 
         #
         # Loading is fast: only enough of the image is loaded to be able to fill
-        # out the header. Pixels will only be processed when they are needed.
+        # out the header. Pixels will only be decompressed when they are needed.
         #
         # @param data [String] the data to load from
         # @param option_string [String] load options as a string
@@ -574,7 +576,7 @@ def self.new_from_array(array, scale = 1, offset = 0)
         # $ vips jpegsave
         # ```
         #
-        # to see all the available options. 
+        # to see all the available options for JPEG save. 
         #
         # @!macro [new] vips.saveopts
         #   @param [Hash] opts set of options
@@ -616,7 +618,7 @@ def write_to_file(name, opts = {})
         # $ vips jpegsave
         # ```
         #
-        # to see all the available options. 
+        # to see all the available options for JPEG save. 
         #
         # @param format_string [String] save format plus options
         # @macro vips.saveopts
@@ -1352,7 +1354,8 @@ def self.generate_yard
             print "self." if not member_x 
             print "#{nickname}("
             print required_input.map(&:name).join(", ")
-            puts ", opts = {})"
+            print ", " if required_input.length > 0
+            puts "opts = {})"
 
             puts "#   #{op.description.capitalize}."