Merge pull request #12 from ruby/doc

Documents clean-ups

Author: nobu

.builtins.rb

@@ -0,0 +1,4 @@
+# :stopdoc:
+class Array end
+class String end
+# :startdoc:

.document

@@ -0,0 +1,4 @@
+LICENSE.txt
+README.md
+.builtins.rb
+lib/

.rdoc_options

@@ -0,0 +1,2 @@
+---
+main_page: README.md

LICENSE.txt

@@ -4,10 +4,10 @@ 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.
+   notice, this list of conditions and the following disclaimer.
 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.
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
 
 THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

README.md

@@ -3,11 +3,11 @@
 This module manipulates strings according to the word parsing rules
 of the UNIX Bourne shell.
 
-The shellwords() function was originally a port of shellwords.pl,
-but modified to conform to the Shell & Utilities volume of the IEEE
-Std 1003.1-2008, 2016 Edition [1].
+The `shellwords()` function was originally a port of shellwords.pl,
+but modified to conform to [the Shell & Utilities volume of the IEEE
+Std 1003.1-2008, 2016 Edition].
 
-[1] [IEEE Std 1003.1-2008, 2016 Edition, the Shell & Utilities volume](http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.html)
+[the Shell & Utilities volume of the IEEE Std 1003.1-2008, 2016 Edition]: http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.html
 
 ## Installation
 
@@ -43,4 +43,3 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/shellwords.
-

lib/shellwords.rb

@@ -5,9 +5,9 @@
 # This module manipulates strings according to the word parsing rules
 # of the UNIX Bourne shell.
 #
-# The shellwords() function was originally a port of shellwords.pl,
-# but modified to conform to the Shell & Utilities volume of the IEEE
-# Std 1003.1-2008, 2016 Edition [1].
+# The <tt>shellwords()</tt> function was originally a port of shellwords.pl, but
+# modified to conform to {the Shell & Utilities volume of the IEEE Std 1003.1-2008, 2016
+# Edition}[http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.html]
 #
 # === Usage
 #
@@ -62,12 +62,9 @@
 #
 # === Contact
 # * Akinori MUSHA <knu@iDaemons.org> (current maintainer)
-#
-# === Resources
-#
-# 1: {IEEE Std 1003.1-2008, 2016 Edition, the Shell & Utilities volume}[http://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.html]
 
 module Shellwords
+  # The version number string.
   VERSION = "0.2.0"
 
   # Splits a string into an array of tokens in the same way the UNIX

shellwords.gemspec

@@ -21,8 +21,9 @@ Gem::Specification.new do |spec|
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = spec.homepage
 
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
-    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  srcdir, gemspec_file = File.split(__FILE__)
+  spec.files         = Dir.chdir(srcdir) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:(?:test|spec|features)/|\.git|Rake)}) || f ==  gemspec_file}
   end
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }