Improve mrbgems documentation

doc/mrbgems/README.md

@@ -101,13 +101,13 @@ by tools like `mruby` and `mirb` to empower the GEM functionality.
 The following properties can be set inside of your `MRuby::Gem::Specification` for
 information purpose:
 
-* spec.license or spec.licenses (License [String] or Licenses [Array] for this GEM)
-* spec.author or spec.authors (Developer names author [String] authors [Array])
-* spec.version (Current Version [String]
-* spec.description (Detailed description [String])
-* spec.summary (Short summary [String])
-* spec.homepage (Homepage [String])
-* spec.requirements
+* `spec.license` or `spec.licenses` (A single license or a list of them under which this GEM is licensed)
+* `spec.author` or `spec.authors` (Developer name or a list of them)
+* `spec.version` (Current version)
+* `spec.description` (Detailed description)
+* `spec.summary` (Short summary)
+* `spec.homepage` (Homepage)
+* `spec.requirements` (External requirements as information for user)
 
 It is required for every GEM to have a license and an author!
 
@@ -118,30 +118,30 @@ In case your GEM is depending on other GEMs please use
 	  spec.license = 'MIT'
 	  spec.authors = 'mruby developers'
 
-	  # add GEM dependency parser.
-          # Version has to be between 1.0.0 and 1.5.2
-	  spec.add_dependency('parser', '> 1.0.0', '< 1.5.2')
+	  # add GEM dependency mruby-parser.
+	  # Version has to be between 1.0.0 and 1.5.2
+	  spec.add_dependency('mruby-parser', '> 1.0.0', '< 1.5.2')
 	end
 
 The usage of versions is optional.
 
-__ATTENTION__
+__ATTENTION:__
 The dependency system is currently (May 2013) under development and doesn't check
-or resolve dependencies for now!
+or resolve dependencies!
 
 In case your GEM has more complex build requirements you can use
 the following options additionally inside of your GEM specification:
 
-* spec.cflags (C compiler flags for this GEM)
-* spec.mruby_cflags (global C compiler flags for everything)
-* spec.mruby_ldflags (global linker flags for everything)
-* spec.mruby_libs (global libraries for everything)
-* spec.mruby_includes (global includes for everything)
-* spec.rbfiles (Ruby files to compile)
-* spec.objs (Object files to compile)
-* spec.test_rbfiles (Ruby test files for integration into mrbtest)
-* spec.test_objs (Object test files for integration into mrbtest)
-* spec.test_preload (Initialization files for mrbtest)
+* `spec.cflags` (C compiler flags)
+* `spec.mruby_cflags` (global C compiler flags for everything)
+* `spec.mruby_ldflags` (global linker flags for everything)
+* `spec.mruby_libs` (global libraries for everything)
+* `spec.mruby_includes` (global includes for everything)
+* `spec.rbfiles` (Ruby files to compile)
+* `spec.objs` (Object files to compile)
+* `spec.test_rbfiles` (Ruby test files for integration into mrbtest)
+* `spec.test_objs` (Object test files for integration into mrbtest)
+* `spec.test_preload` (Initialization files for mrbtest)
 
 ## C Extension