docs: clarify format example coverage
This commit is contained in:
@@ -1,9 +1,10 @@
|
||||
# Format Usage Examples
|
||||
|
||||
Examples for `relspec convert` covering every reader and writer format. The
|
||||
"Writers" and "Readers" sections below were run against `examples/test_schema.dbml`.
|
||||
The cross-format and live-database examples were not run; they follow the flags
|
||||
shown in `relspec convert --help`.
|
||||
Examples for `relspec convert` covering the file-based reader and writer
|
||||
formats. The "Writers" and "Readers" sections below were run against
|
||||
`examples/test_schema.dbml`. The cross-format and live-database examples were
|
||||
not run; they follow the flags shown in `relspec convert --help` and require
|
||||
matching input files or reachable databases.
|
||||
|
||||
Any reader can be combined with any writer: pick `--from`/`--from-path` for the
|
||||
source and `--to`/`--to-path` for the target. Add `--silent` to suppress progress
|
||||
@@ -38,7 +39,7 @@ Notes:
|
||||
`--flatten-schema` for other formats if the target has no schema support.
|
||||
- `dctx` supports a single schema only; use `--schema <name>` to select one.
|
||||
|
||||
## Readers: every format back to DBML
|
||||
## Readers: file-based formats into DBML (or JSON where noted)
|
||||
|
||||
```bash
|
||||
relspec convert --from json --from-path schema.json --to dbml --to-path out.dbml
|
||||
|
||||
Reference in New Issue
Block a user