Storage.listdir() missing from the reference page

[kopernikus]

​http://docs.djangoproject.com/en/1.2/howto/custom-file-storage/ mentions Storage.listdir() as a required part of the interface but the linked reference page ​http://docs.djangoproject.com/en/1.2/ref/files/storage/#ref-files-storage lacks this method (and any description thereof ;))

On a related note: It would be nice if either of those pages would give some hints (or link to) how to USE the custom storage. Do one have to make an instance and pass it to every field? Can this go into settings.py or Meta?

thanks

Paul

[Russell Keith-Magee]

Agreed -- the file storage API docs could be improved.

[Gabriel Hurley]

(In [14831]) Fixed #13605 -- Improved documentation of the django.core.files.storage module. Added documentation for DefaultStorage, get_storage_class, FileSystemStorage, and some missing public methods on Storage. New metadata targets included for everything. Thanks to kopernikus for the report and elbarto for contributing to the patch.

[Gabriel Hurley]

(In [14832]) [1.2.X] Fixed #13605 -- Improved documentation of the django.core.files.storage module. Added documentation for DefaultStorage, get_storage_class, FileSystemStorage, and some missing public methods on Storage. New metadata targets included for everything. Thanks to kopernikus for the report and elbarto for contributing to the patch.

Backport of [14831] from trunk.