Updating readme to be RDoc compliant.

README.rdoc

@@ -102,12 +102,12 @@ anywhere in the file:
         -r, --routes                     Annotate routes.rb with the output of 'rake routes'
         -v, --version                    Show the current version of this gem
         -m, --show-migration             Include the migration version number in the annotation
-        -i, --show-indexes               List the table's database indexes in the annotation
-        -s, --simple-indexes             Concat the column's related indexes in the annotation
+        -i, --show-indexes               List the indexes for the table in the annotation
+        -s, --simple-indexes             Include information about indexes inline with the relevant column
             --model-dir dir              Annotate model files stored in dir rather than app/models
             --ignore-model-subdirs       Ignore sub-directories of the models directory.
         -R, --require path               Additional files to require before loading models
-        -e [tests,fixtures]              Do not annotate fixtures/factories, and/or test files
+        -e [tests,fixtures]              Skip annotation of fixtures/factories/test files
             --exclude
         -n  --no-sort                    Sort by column creation order rather than alphabetical order
 
@@ -125,16 +125,16 @@ block in your models if it looks like it was previously added
 by annotate models, so you don't want to add additional text
 to an automatically created comment block.
 
-        * * Back up your model files before using... * *
+BACK UP YOUR MODELS BEFORE USING THIS TOOL!
 
 == LINKS
 
-* Factory Girl => http://github.com/thoughtbot/factory_girl
-* Object Daddy => http://github.com/flogic/object_daddy
-* Machinist => http://github.com/notahat/machinist
-* Fabrication => http://github.com/paulelliott/fabrication
-* SpatialAdapter => http://github.com/pdeffendol/spatial_adapter
-* PostgisAdapter => http://github.com/nofxx/postgis_adapter
+- Factory Girl: http://github.com/thoughtbot/factory_girl
+- Object Daddy: http://github.com/flogic/object_daddy
+- Machinist: http://github.com/notahat/machinist
+- Fabrication: http://github.com/paulelliott/fabrication
+- SpatialAdapter: http://github.com/pdeffendol/spatial_adapter
+- PostgisAdapter: http://github.com/nofxx/postgis_adapter
 
 == LICENSE:
 
@@ -142,29 +142,29 @@ Released under the same license as Ruby. No Support. No Warranty.
 
 == AUTHOR:
 
-Original code by: Dave Thomas -- Pragmatic Programmers, LLC <http://agilewebdevelopment.com/plugins/annotate_models>
-Overhauled by: Alex Chaffee <http://alexch.github.com>
-Gemmed by: Cuong Tran <http://github.com/ctran>
-Maintained by: Alex Chaffee and Cuong Tran
-Integrated by: Jon Frisby
+- Original code by: Dave Thomas -- Pragmatic Programmers, LLC <http://agilewebdevelopment.com/plugins/annotate_models>
+- Overhauled by: Alex Chaffee <http://alexch.github.com>
+- Gemmed by: Cuong Tran <http://github.com/ctran>
+- Maintained by: Alex Chaffee <http://github.com/alexch> and Cuong Tran <http://github.com/ctran>
+- Integrated by: Jon Frisby <http://github.com/mrjoy/>
 
 Modifications by:
 
- - Alex Chaffee - http://github.com/alexch - alex@pivotallabs.com
- - Cuong Tran - http://github.com/ctran - ctran@pragmaquest.com
- - Jack Danger - http://github.com/JackDanger
- - Michael Bumann - http://github.com/bumi
- - Henrik Nyh - http://github.com/henrik
- - Marcos Piccinini - http://github.com/nofxx
- - Neal Clark - http://github.com/nclark
- - Jacqui Maher - http://github.com/jacqui
- - Nick Plante - http://github.com/zapnap - http://blog.zerosum.org
- - Pedro Visintin - http://github.com/peterpunk - http://www.pedrovisintin.com
- - Bob Potter - http://github.com/bpot
- - Gavin Montague - http://github.com/govan/
- - Alexander Semyonov - http://github.com/rotuka/
- - Nathan Brazil - http://github.com/bitaxis/
- - Ian Duggan http://github.com/ijcd/
- - Jon Frisby http://github.com/mrjoy/
+- Alex Chaffee - http://github.com/alexch - alex@pivotallabs.com
+- Cuong Tran - http://github.com/ctran - ctran@pragmaquest.com
+- Jack Danger - http://github.com/JackDanger
+- Michael Bumann - http://github.com/bumi
+- Henrik Nyh - http://github.com/henrik
+- Marcos Piccinini - http://github.com/nofxx
+- Neal Clark - http://github.com/nclark
+- Jacqui Maher - http://github.com/jacqui
+- Nick Plante - http://github.com/zapnap - http://blog.zerosum.org
+- Pedro Visintin - http://github.com/peterpunk - http://www.pedrovisintin.com
+- Bob Potter - http://github.com/bpot
+- Gavin Montague - http://github.com/govan/
+- Alexander Semyonov - http://github.com/rotuka/
+- Nathan Brazil - http://github.com/bitaxis/
+- Ian Duggan http://github.com/ijcd/
+- Jon Frisby http://github.com/mrjoy/
 
 and many others that I may have missed to add.