Permalink
Browse files

Merge pull request #9348 from schuetzm/doc_no_indices_with_create_joi…

…n_table

Add more documentation for create_join_table.
  • Loading branch information...
2 parents 34c133a + 5b5f7a6 commit b0fa9b59c8c9cac52d4eb4d8d984b85d4a753e97 @fxn fxn committed Feb 21, 2013
@@ -192,6 +192,14 @@ def create_table(table_name, options = {})
# Set to true to drop the table before creating it.
# Defaults to false.
#
+ # Note that +create_join_table+ does not create any indices by default; you can use
+ # its block form to do so yourself:
+ #
+ # create_join_table :products, :categories do |t|
+ # t.index :products
+ # t.index :categories
+ # end
+ #
# ====== Add a backend specific option to the generated SQL (MySQL)
# create_join_table(:assemblies, :parts, options: 'ENGINE=InnoDB DEFAULT CHARSET=utf8')
# generates:
@@ -344,6 +344,16 @@ create_join_table :products, :categories, column_options: {null: true}
will create the `product_id` and `category_id` with the `:null` option as
`true`.
+`create_join_table` also accepts a block, which you can use to add indices
+(which are not created by default) or additional columns:
+
+```ruby
+create_join_table :products, :categories do |t|
+ t.index :products
+ t.index :categories
+end
+```
+
### Changing Tables
A close cousin of `create_table` is `change_table`, used for changing existing

0 comments on commit b0fa9b5

Please sign in to comment.