what the text=auto docs should be

It would be better if the text=auto section of the gitattributes
Manual Page had this:

This ensures that all files that git considers to be the text will
have normalized (LF) line endings in the repository. If
core.autocrlf=true, core.eol will be used to normalize the files in
your working directory. core.eol defaults to native line endings for
your platform.

I researched and put my thoughts down in a blog post:
http://blog.ctaggart.com/2014/02/time-to-kill-carriage-return.html

cheers,
Cameron