optparse 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8070528a5fa8e91d067053a532c9771c71f63d16d6a31622c7ca3c6e487c425
-  data.tar.gz: e854fcd1fe22dd596fe2650e4141e59124d0f78ae492de3164b250a4d18cc9de
+  metadata.gz: 45145f867a14905754ed4e60fa3a217e5dd141afac7763be973a90aa488a4e1d
+  data.tar.gz: 925392a4e752b2fd4dbd2a26b9446e580c4c2e375611659d705b7f685b149c9a
 SHA512:
-  metadata.gz: 3e246c2d76a0b033b8f31e4d0c850050281b6722e3d7d4ae5e11de16bc00ad337f75243b2b932b915cc45406294038d7b770c3e2150d3faab5bc674135ce6355
-  data.tar.gz: 75b3d9526ad311161ad01507616dbd60ec97714a1440d10b15702bf360a3f0d081a5cade68d25d6bed50f56ed19599d657e7fb4e56d130b50b51861d501b08ce
+  metadata.gz: 1cbaf965329a82b9ec5ba8af7f4f56e4e91b54f4dfc524d0a1aa3abe4a72f5f2bb64af95d2a1d504bb3dd4cb24243dcf8aa346fbd14caf9959045bb9edf2d73b
+  data.tar.gz: 8e3c1ee8582ad9b524db35a864c0eafd4adcf4dd6475bb8c2faa6cad0aad1f3fe17617a681fb4319f632fa205a175be45f29920eeca9404a8b662f41565edb64

data/ChangeLog

@@ -0,0 +1,264 @@
+-*- coding: utf-8 -*-
+
+commit 1226b670e60d5ec8ad4c1a6b73040c9fdcf40fe2
+  Author:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  AuthorDate: 2021-10-21 20:38:56 +0900
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2021-10-21 20:38:56 +0900
+
+    Bump up optparse version to 0.2.0
+
+commit 0281b949c6cf86806a260ca6b39267d9b202fbf8
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-09-29 11:45:11 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-09-29 11:45:11 +0900
+
+    Add the argument from where synchronize tools
+
+commit a3d05c1be8efb552b64f3d1af84b8b8dea8e0afb
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-09-29 11:34:44 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-09-29 11:34:44 +0900
+
+    Revived `rdoc` task
+
+commit 6a2fa9737f5dab99c73a99a24472f620fff228ea
+  Author:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  AuthorDate: 2021-09-11 13:21:00 +0900
+  Commit:     Hiroshi SHIBATA <hsbt@ruby-lang.org>
+  CommitDate: 2021-09-11 13:21:00 +0900
+
+    Bump up the latest version of CoreAssertions
+
+commit bf03038d953902569c11448717ab584c65e35a89
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-22 14:22:11 -0500
+  Commit:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  CommitDate: 2021-04-22 14:22:11 -0500
+
+    Fix link in included file
+
+commit 47417f1b4cb5d819aa54f305a4009f45d7a112c1
+  Author:     Olle Jonsson <olle.jonsson@gmail.com>
+  AuthorDate: 2021-04-23 13:04:25 +0200
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-23 06:04:25 -0500
+
+    Remove an errant { character (#26)
+
+commit 40d51ccbad75ab5194ce5a3574b49fda41745849
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-22 08:48:23 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-22 08:48:23 -0500
+
+    More on tutorial (#24)
+
+    - Adds section "Parsing" to tutorial.rdoc.
+    - Removes section "Terminators" from option_params.rdoc. (Terminator '--' is not an option parameter.)
+
+commit 7f3195b9dbc3a984a5d3e928a9d70686484411c0
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-22 07:27:06 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-22 07:27:06 -0500
+
+    More on tutorial (#23)
+
+    - Removed a largish block of repeated text.
+    - Added sections "Top List and Base List" and "Methods for Defining Options" (on, define, etc.).
+    - Linked from class OptionParser doc to the tutorial.
+
+commit 7ef3d89e7859552daa057b6d5f42ffe3e562ae34
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-16 12:57:55 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-16 12:57:55 +0900
+
+    Removed a duplicate section
+
+commit 9c5b3f244b723e0231ef07c56c59dabf56a9dd3f
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-15 09:32:02 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-15 09:32:02 -0500
+
+    More on tutorial (#22)
+
+        Adds argument abbreviation in option_params.rdoc.
+        Adds entire Argument Values section to tutorial.rdoc.
+
+commit d07cb96a9616ae7489e41db7bb85e43a9b664831
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-12 20:33:19 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-13 10:33:19 +0900
+
+    Rdoc for help (#21)
+
+commit 385dd4322de67a989e5d271ed7ddb96b2375956f
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-11 23:43:02 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-12 06:43:02 +0200
+
+    Tutorial: explain custom argument converters (#19)
+
+commit f23d750d14936c0e3663f65ad1b97be82d232dae
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-12 02:02:11 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-12 02:02:11 +0900
+
+    nodoc private methods
+
+commit 7e65ef3cfa3a38aaac3a61e1a82307427f1d27c1
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-12 00:38:40 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-12 00:38:40 +0900
+
+    Fixed mismatched <tt> tag
+
+commit cccb28e0debbf0f96162291766d3ccafc2c558a3
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-11 09:03:07 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-11 09:03:07 +0900
+
+    Moved rdoc files to doc/optparse
+
+commit 8be031b5392cb440f3df23304805c8c814265c59
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-11 08:49:30 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-11 08:51:44 +0900
+
+    Fix relative paths
+
+commit 01c24ca4f606a455b8d135a48e11a0371ef6d7c0
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-11 08:24:03 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-11 08:24:03 +0900
+
+    Added `rdoc` task
+
+commit 4ff48f24c9b44740dd6c63bc5005db8959c21f80
+  Author:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  AuthorDate: 2021-04-09 23:20:03 +0900
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-11 08:10:41 +0900
+
+    No document in rakelib
+
+commit 39d39676c45083953a082c4f6e2e8a7315b7066d
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-10 16:30:19 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-10 16:30:19 -0500
+
+    More on tutorial (#16)
+
+    -   Added example in "Argument Converters"; it doesn't seem right for a tutorial to have no example in one of its topics (and instead just linking elsewhere).
+    -   Added section "Command-Line Abbreviations."
+     -  Added section "Keyword Argument into," showing how to:
+         -  Collect options.
+         -  Check for missing options.
+         -  Provide option defaults.
+
+commit c91ed8d33db7355cf0a5a8323f3f6aad57e18b38
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-10 10:05:44 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-10 10:05:44 -0500
+
+    Rdoc (#15)
+
+    * Resolve shared mixed_names.rb
+
+    * Add long option with negation
+
+    * Show --help for all examples
+
+    * Table of contents for tutorial
+
+    * Move argument converters to separate rdoc
+
+    * Add references to argument_converters.rdoc
+
+    * Tune up argument converters
+
+    * Change explicit links to auto-links
+
+commit 9a2352c1c9c3445d1618da577f19137243a2a748
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-09 08:21:34 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-09 08:21:34 -0500
+
+    Reorganize Ruby example files for sharing (#14)
+
+commit f3ca83caff20f6daf07a70a3f3f41a6666790b6c
+  Author:     Olle Jonsson <olle.jonsson@gmail.com>
+  AuthorDate: 2021-04-08 05:33:56 +0200
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-08 12:33:56 +0900
+
+    gemspec: Explicit files list (#10)
+
+    This avoid shelling out, and includes a narrower list of files.
+
+    Co-authored-by: Nobuyoshi Nakada <nobu@ruby-lang.org>
+
+commit d55d9284c3a02a794d63a842764591d4ff079241
+  Author:     BurdetteLamar <burdettelamar@yahoo.com>
+  AuthorDate: 2021-04-07 11:58:46 -0500
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-04-08 10:40:59 +0900
+
+    Make use of option_params.rdoc
+
+commit 5618eeb49ee2a316cd5d91a515dbb2734f553027
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-07 09:01:52 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-07 16:01:52 +0200
+
+    Enhanced doc for option parameters (#11)
+
+commit 84dfd92d2a7fb75bb40fbb8414bd8b90b7ccbac6
+  Author:     Burdette Lamar <BurdetteLamar@Yahoo.com>
+  AuthorDate: 2021-04-06 13:55:21 -0500
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-06 13:55:21 -0500
+
+    More on tutorial (#9)
+
+    * More on tutorial
+
+    * More on tutorial
+
+    * More on tutorial
+
+    * More on tutorial: clearer example output
+
+commit d14bf830078c2b2c8c8bcbe60aa2a2ebb40e0b6c
+  Author:     Olle Jonsson <olle.jonsson@gmail.com>
+  AuthorDate: 2021-04-06 10:01:37 +0200
+  Commit:     GitHub <noreply@github.com>
+  CommitDate: 2021-04-06 10:01:37 +0200
+
+    gemspec: Explicitly list 0 executables
+
+    This gem exposes no executable files.
+
+commit f209276f79d84578d4e40004ce7768194aae00cc
+  Author:     BurdetteLamar <burdettelamar@yahoo.com>
+  AuthorDate: 2021-03-29 14:03:04 -0500
+  Commit:     Nobuyoshi Nakada <nobu@ruby-lang.org>
+  CommitDate: 2021-03-30 12:00:31 +0900
+
+    Beginnings of tutorial

data/doc/optparse/argument_converters.rdoc

@@ -0,0 +1,380 @@
+== Argument Converters
+
+An option can specify that its argument is to be converted
+from the default \String to an instance of another class.
+
+=== Contents
+
+- {Built-In Argument Converters}[#label-Built-In+Argument+Converters]
+  - {Date}[#label-Date]
+  - {DateTime}[#label-DateTime]
+  - {Time}[#label-Time]
+  - {URI}[#label-URI]
+  - {Shellwords}[#label-Shellwords]
+  - {Integer}[#label-Integer]
+  - {Float}[#label-Float]
+  - {Numeric}[#label-Numeric]
+  - {DecimalInteger}[#label-DecimalInteger]
+  - {OctalInteger}[#label-OctalInteger]
+  - {DecimalNumeric}[#label-DecimalNumeric]
+  - {TrueClass}[#label-TrueClass]
+  - {FalseClass}[#label-FalseClass]
+  - {Object}[#label-Object]
+  - {String}[#label-String]
+  - {Array}[#label-Array]
+  - {Regexp}[#label-Regexp]
+- {Custom Argument Converters}[#label-Custom+Argument+Converters]
+
+=== Built-In Argument Converters
+
+\OptionParser has a number of built-in argument converters,
+which are demonstrated below.
+
+==== \Date
+
+File +date.rb+
+defines an option whose argument is to be converted to a \Date object.
+The argument is converted by method Date#parse.
+
+  :include: ruby/date.rb
+
+Executions:
+
+  $ ruby date.rb --date 2001-02-03
+  [#<Date: 2001-02-03 ((2451944j,0s,0n),+0s,2299161j)>, Date]
+  $ ruby date.rb --date 20010203
+  [#<Date: 2001-02-03 ((2451944j,0s,0n),+0s,2299161j)>, Date]
+  $ ruby date.rb --date "3rd Feb 2001"
+  [#<Date: 2001-02-03 ((2451944j,0s,0n),+0s,2299161j)>, Date]
+
+==== \DateTime
+
+File +datetime.rb+
+defines an option whose argument is to be converted to a \DateTime object.
+The argument is converted by method DateTime#parse.
+
+  :include: ruby/datetime.rb
+
+Executions:
+
+  $ ruby datetime.rb --datetime 2001-02-03T04:05:06+07:00
+  [#<DateTime: 2001-02-03T04:05:06+07:00 ((2451943j,75906s,0n),+25200s,2299161j)>, DateTime]
+  $ ruby datetime.rb --datetime 20010203T040506+0700
+  [#<DateTime: 2001-02-03T04:05:06+07:00 ((2451943j,75906s,0n),+25200s,2299161j)>, DateTime]
+  $ ruby datetime.rb --datetime "3rd Feb 2001 04:05:06 PM"
+  [#<DateTime: 2001-02-03T16:05:06+00:00 ((2451944j,57906s,0n),+0s,2299161j)>, DateTime]
+
+==== \Time
+
+File +time.rb+
+defines an option whose argument is to be converted to a \Time object.
+The argument is converted by method Time#httpdate or Time#parse.
+
+  :include: ruby/time.rb
+
+Executions:
+
+  $ ruby time.rb --time "Thu, 06 Oct 2011 02:26:12 GMT"
+  [2011-10-06 02:26:12 UTC, Time]
+  $ ruby time.rb --time 2010-10-31
+  [2010-10-31 00:00:00 -0500, Time]
+
+==== \URI
+
+File +uri.rb+
+defines an option whose argument is to be converted to a \URI object.
+The argument is converted by method URI#parse.
+
+  :include: ruby/uri.rb
+
+Executions:
+
+  $ ruby uri.rb --uri https://github.com
+  [#<URI::HTTPS https://github.com>, URI::HTTPS]
+  $ ruby uri.rb --uri http://github.com
+  [#<URI::HTTP http://github.com>, URI::HTTP]
+  $ ruby uri.rb --uri file://~/var
+  [#<URI::File file://~/var>, URI::File]
+
+==== \Shellwords
+
+File +shellwords.rb+
+defines an option whose argument is to be converted to an \Array object by method
+Shellwords#shellwords.
+
+  :include: ruby/shellwords.rb
+
+Executions:
+
+  $ ruby shellwords.rb --shellwords "ruby my_prog.rb | less"
+  [["ruby", "my_prog.rb", "|", "less"], Array]
+  $ ruby shellwords.rb --shellwords "here are 'two words'"
+  [["here", "are", "two words"], Array]
+
+==== \Integer
+
+File +integer.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer.
+
+  :include: ruby/integer.rb
+
+Executions:
+
+  $ ruby integer.rb --integer 100
+  [100, Integer]
+  $ ruby integer.rb --integer -100
+  [-100, Integer]
+  $ ruby integer.rb --integer 0100
+  [64, Integer]
+  $ ruby integer.rb --integer 0x100
+  [256, Integer]
+  $ ruby integer.rb --integer 0b100
+  [4, Integer]
+
+==== \Float
+
+File +float.rb+
+defines an option whose argument is to be converted to a \Float object.
+The argument is converted by method Kernel#Float.
+
+  :include: ruby/float.rb
+
+Executions:
+
+  $ ruby float.rb --float 1
+  [1.0, Float]
+  $ ruby float.rb --float 3.14159
+  [3.14159, Float]
+  $ ruby float.rb --float 1.234E2
+  [123.4, Float]
+  $ ruby float.rb --float 1.234E-2
+  [0.01234, Float]
+
+==== \Numeric
+
+File +numeric.rb+
+defines an option whose argument is to be converted to an instance
+of \Rational, \Float, or \Integer.
+The argument is converted by method Kernel#Rational,
+Kernel#Float, or Kernel#Integer.
+
+  :include: ruby/numeric.rb
+
+Executions:
+
+  $ ruby numeric.rb --numeric 1/3
+  [(1/3), Rational]
+  $ ruby numeric.rb --numeric 3.333E-1
+  [0.3333, Float]
+  $ ruby numeric.rb --numeric 3
+  [3, Integer]
+
+==== \DecimalInteger
+
+File +decimal_integer.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer.
+
+  :include: ruby/decimal_integer.rb
+
+The argument may not be in a binary or hexadecimal format;
+a leading zero is ignored (not parsed as octal).
+
+Executions:
+
+  $ ruby decimal_integer.rb --decimal_integer 100
+  [100, Integer]
+  $ ruby decimal_integer.rb --decimal_integer -100
+  [-100, Integer]
+  $ ruby decimal_integer.rb --decimal_integer 0100
+  [100, Integer]
+  $ ruby decimal_integer.rb --decimal_integer -0100
+  [-100, Integer]
+
+==== \OctalInteger
+
+File +octal_integer.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer.
+
+  :include: ruby/octal_integer.rb
+
+The argument may not be in a binary or hexadecimal format;
+it is parsed as octal, regardless of whether it has a leading zero.
+
+Executions:
+
+  $ ruby octal_integer.rb --octal_integer 100
+  [64, Integer]
+  $ ruby octal_integer.rb --octal_integer -100
+  [-64, Integer]
+  $ ruby octal_integer.rb --octal_integer 0100
+  [64, Integer]
+
+==== \DecimalNumeric
+
+File +decimal_numeric.rb+
+defines an option whose argument is to be converted to an \Integer object.
+The argument is converted by method Kernel#Integer
+
+  :include: ruby/decimal_numeric.rb
+
+The argument may not be in a binary or hexadecimal format;
+a leading zero causes the argument to be parsed as octal.
+
+Executions:
+
+  $ ruby decimal_numeric.rb --decimal_numeric 100
+  [100, Integer]
+  $ ruby decimal_numeric.rb --decimal_numeric -100
+  [-100, Integer]
+  $ ruby decimal_numeric.rb --decimal_numeric 0100
+  [64, Integer]
+
+==== \TrueClass
+
+File +true_class.rb+
+defines an option whose argument is to be converted to +true+ or +false+.
+The argument is evaluated by method Object#nil?.
+
+  :include: ruby/true_class.rb
+
+The argument may be any of those shown in the examples below.
+
+Executions:
+
+  $ ruby true_class.rb --true_class true
+  [true, TrueClass]
+  $ ruby true_class.rb --true_class yes
+  [true, TrueClass]
+  $ ruby true_class.rb --true_class +
+  [true, TrueClass]
+  $ ruby true_class.rb --true_class false
+  [false, FalseClass]
+  $ ruby true_class.rb --true_class no
+  [false, FalseClass]
+  $ ruby true_class.rb --true_class -
+  [false, FalseClass]
+  $ ruby true_class.rb --true_class nil
+  [false, FalseClass]
+
+==== \FalseClass
+
+File +false_class.rb+
+defines an option whose argument is to be converted to +true+ or +false+.
+The argument is evaluated by method Object#nil?.
+
+  :include: ruby/false_class.rb
+
+The argument may be any of those shown in the examples below.
+
+Executions:
+
+  $ ruby false_class.rb --false_class false
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class no
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class -
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class nil
+  [false, FalseClass]
+  $ ruby false_class.rb --false_class true
+  [true, TrueClass]
+  $ ruby false_class.rb --false_class yes
+  [true, TrueClass]
+  $ ruby false_class.rb --false_class +
+  [true, TrueClass]
+
+==== \Object
+
+File +object.rb+
+defines an option whose argument is not to be converted from \String.
+
+  :include: ruby/object.rb
+
+Executions:
+
+  $ ruby object.rb --object foo
+  ["foo", String]
+  $ ruby object.rb --object nil
+  ["nil", String]
+
+==== \String
+
+File +string.rb+
+defines an option whose argument is not to be converted from \String.
+
+  :include: ruby/string.rb
+
+Executions:
+
+  $ ruby string.rb --string foo
+  ["foo", String]
+  $ ruby string.rb --string nil
+  ["nil", String]
+
+==== \Array
+
+File +array.rb+
+defines an option whose argument is to be converted from \String
+to an array of strings, based on comma-separated substrings.
+
+  :include: ruby/array.rb
+
+Executions:
+
+  $ ruby array.rb --array ""
+  [[], Array]
+  $ ruby array.rb --array foo,bar,baz
+  [["foo", "bar", "baz"], Array]
+  $ ruby array.rb --array "foo, bar, baz"
+  [["foo", " bar", " baz"], Array]
+
+==== \Regexp
+
+File +regexp.rb+
+defines an option whose argument is to be converted to a \Regexp object.
+
+  :include: ruby/regexp.rb
+
+Executions:
+
+  $ ruby regexp.rb --regexp foo
+
+=== Custom Argument Converters
+
+You can create custom argument converters.
+To create a custom converter, call OptionParser#accept with:
+
+- An identifier, which may be any object.
+- An optional match pattern, which defaults to <tt>/.*/m</tt>.
+- A block that accepts the argument and returns the converted value.
+
+This custom converter accepts any argument and converts it,
+if possible, to a \Complex object.
+
+  :include: ruby/custom_converter.rb
+
+Executions:
+
+  $ ruby custom_converter.rb --complex 0
+  [(0+0i), Complex]
+  $ ruby custom_converter.rb --complex 1
+  [(1+0i), Complex]
+  $ ruby custom_converter.rb --complex 1+2i
+  [(1+2i), Complex]
+  $ ruby custom_converter.rb --complex 0.3-0.5i
+  [(0.3-0.5i), Complex]
+
+This custom converter accepts any 1-word argument
+and capitalizes it, if possible.
+
+  :include: ruby/match_converter.rb
+
+Executions:
+
+  $ ruby match_converter.rb --capitalize foo
+  ["Foo", String]
+  $ ruby match_converter.rb --capitalize "foo bar"
+  match_converter.rb:9:in `<main>': invalid argument: --capitalize foo bar (OptionParser::InvalidArgument)

data/doc/optparse/creates_option.rdoc

@@ -0,0 +1,7 @@
+Creates an option from the given parameters +params+.
+See {Parameters for New Options}[./doc/optparse/option_params_rdoc.html].
+
+The block, if given, is the handler for the created option.
+When the option is encountered during command-line parsing,
+the block is called with the argument given for the option, if any.
+See {Option Handlers}[./option_params_rdoc.html#label-Option+Handlers].