docs: add more documentation for emit_embed_alias

docs/howto/embedding.md

@@ -58,4 +58,24 @@ type ScoreAndTestsRow struct {
 	Student   Student
 	TestScore TestScore
 }
-```
+```
+
+sqlc can generate structs with fields based on the alias inside the macro `sqlc.embed()` by adding the `emit_embed_alias` key to the configuration file as it shows on [configuration reference](../reference/config.md).
+
+```sql
+-- name: ListUserLink :many
+SELECT
+    sqlc.embed(owner),
+    sqlc.embed(consumer)
+FROM
+    user_links
+    INNER JOIN users AS owner ON owner.id = user_links.owner_id
+    INNER JOIN users AS consumer ON consumer.id = user_links.consumer_id;
+```
+
+```
+type ListUserLinkRow struct {
+	Owner    User
+	Consumer User
+}
+```

docs/reference/config.md

@@ -164,7 +164,7 @@ The `gen` mapping supports the following keys:
   - If true, emit a function per enum type
     that returns all valid enum values.
 - `emit_embed_alias`:
-  - If true, use alias name inside `sqlc.embed()` function instead of table name for field name. Defaults to `false`.
+  - If true, use alias name inside `sqlc.embed()` macro instead of table name for field name. Defaults to `false`.
 - `build_tags`:
   - If set, add a `//go:build <build_tags>` directive at the beginning of each generated Go file.
 - `json_tags_id_uppercase`:
@@ -467,7 +467,7 @@ Each mapping in the `packages` collection has the following keys:
   - If true, emit a function per enum type
     that returns all valid enum values.
 - `emit_embed_alias`:
-  - If true, use alias name inside `sqlc.embed()` function instead of table name for field name. Defaults to `false`.
+  - If true, use alias name inside `sqlc.embed()` macro instead of table name for field name. Defaults to `false`.
 - `build_tags`:
   - If set, add a `//go:build <build_tags>` directive at the beginning of each generated Go file.
 - `json_tags_case_style`: