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