goodie_advanced_handle_functions: more examples and flow

- Improve overall flow (imo) in the "Further Qualifying the Query"
  section partially by removing an extraneous example.
- Add information which will help new developers figure out how their
  share directory will be named.
- Add information about how (and why) to slurp in UTF-8 encoded text,
  including an example.
- Fix a typo in the final section, using the blunt instrument of a
  reorganization.

Git ends up thinking it's a total (82%) rewrite.  :(
goodie_advanced_handle_functions: minor text updates.

- "many" is more straight-forward than "any number of"
- backtick-quote "return" to make clear it is an actual keyword.
- Add in missing word "in".

As always, thanks to @moollaza for the review.
Merge pull request #40 from mwmiller/slurpie

goodie_advanced_handle_functions: more examples and flow