fix foreign_table_are default messages.

add foreign adjective to the default messages.
tests for foreign_tables_are() functions

Replicated the tests used by tables_are.
Add section for foreign_tables_are() functions.

Documentaiton for foreign_tables_are fucntions.
I used the tables_are documentation as a starting point.