Clarifying rake:db:migrate & dump

I was confused as to why certain database tables were mysteriously reappearing in my db/schema.rb file, even though I (thought) I'd removed them a long time ago.

Here's what I think is happening:

1) I run rake db:migrate 2) this invokes the db:schema:dump task 3) this adds any tables/columns that exist in the actual database schema to db/schema.rb

I'm not sure if this is the case, but I wanted to file a ticket in the hopes that someone could confirm and document this. I'm attaching a documentation patch in the hopes that I'm understanding what's going on correctly.

Thanks!