id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
6792	Documentation for FileField does not mention the delete behavior	thebitguru <farhan@…>	nobody	"The current documentation for [http://www.djangoproject.com/documentation/model-api/#filefield FileField] does not mention that django will delete the underlying file in ''some'' cases.  I had to look through the code to figure out the exact behavior.  It would be useful to have this information in the documentation.

Below is what I figured out.

 1. Files are deleted only if there are no other records referring to it.
 2. File is not deleted if you update the record with a new file.  I see that #6157 mentions this, but this behavior is ''inconsistent'' with point 1 above.
 3. Files are deleted even if a transaction fails. I saw this behavior reported by #6456, but my application does not use transactions so this is more of an FYI."	Uncategorized	closed	Database layer (models, ORM)	dev	Normal	duplicate	delete file update bug	sjulean@… cortland@… michal.salaban@…	Accepted	0	0	0	0	0	0