Docs for 'Providing initial SQL data' misleading

[Michael Hipp <Michael@…>]

The documentation for 'Providing initial SQL data' is misleading.
​http://www.djangoproject.com/documentation/model-api/#providing-initial-sql-data

It says:
"Each SQL file, if given, is expected to contain valid SQL. The SQL files are piped directly into the database after all of the models’ table-creation statements have been executed."

This implies that any SQL is ok, as long as it is valid. And the SQL files are not "piped directly into the database", they are actually parsed and translated for different backends. The result is that only very simple SQL is allowed (mostly only value inserts). This needs to be clarified.

[James Bennett]

(In [8373]) Fixed #6765: Changed docs/model-apit.txt to better indicate what's expected of initial SQL files.