joinable! docs: Prettier formatting of the example.
@@ -992,13 +992,21 @@ macro_rules! __diesel_table_query_source_impl {
///
/// ```
///
-/// In the example above, in line `joinable!(posts -> users (user_id));` specifies the relation of
-/// the tables and the ON clause in the following way:
+/// In the example above, the line `joinable!(posts -> users (user_id));`
+///
+/// specifies the relation of the tables and the ON clause in the following way:
+///
/// `parent_table -> child_table (foreign_key)`
-/// Where `parent_table` is the Table with the Primary key,
-/// `child_table` is the Table with the Foreighn key,
-/// So for the Table decaration in [Associations docs](http://docs.diesel.rs/diesel/associations/index.html),
-/// The parent table would be `User`, the child table would be `Post` and the Foreighn key would be `Post.user_id`
+///
+/// * `parent_table` is the Table with the Primary key.
+///
+/// * `child_table` is the Table with the Foreighn key.
+///
+/// So given the Table decaration from [Associations docs](http://docs.diesel.rs/diesel/associations/index.html)
+///
+/// * The parent table would be `User`
+/// * The child table would be `Post`
+/// * and the Foreighn key would be `Post.user_id`
///
/// For joins that do not explicitly use on clauses via [JoinOnDsl](http://docs.diesel.rs/diesel/prelude/trait.JoinOnDsl.html)
/// the following on clause is generated implicitly:
