Correct the function signature for parse and add an entry for the shorter signature

My take on the discussion on parse at https://groups.google.com/forum/#!topic/julia-dev/ulCca30P55g was to add a documentation entry specific to the shorter signature.  In doing so, I noticed that the documentation for the long form had an incorrect default.  This fixes both.