diff options
| author | Anthon van der Neut <anthon@mnt.org> | 2017-08-15 15:59:38 +0200 |
|---|---|---|
| committer | Anthon van der Neut <anthon@mnt.org> | 2017-08-15 15:59:38 +0200 |
| commit | 74222db016e319460cbccc39ddad0180968490f5 (patch) | |
| tree | 0769506c67cb2b4ee8564e048ec883d371f8fb4d /_doc | |
| parent | e9b75ce00c67f82cd61f738986b50ae85c89ebb9 (diff) | |
| download | ruamel.yaml-74222db016e319460cbccc39ddad0180968490f5.tar.gz | |
fix comment dumping0.15.31
Diffstat (limited to '_doc')
| -rw-r--r-- | _doc/detail.ryd | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/_doc/detail.ryd b/_doc/detail.ryd index 7867169..ea976e1 100644 --- a/_doc/detail.ryd +++ b/_doc/detail.ryd @@ -92,6 +92,27 @@ intuitive results. **but this is not enforced**. Depending on your structure, not following this advice **might lead to invalid output**. +Inconsistently indented YAML +++++++++++++++++++++++++++++ + +If your input is inconsistently indented, such indentation cannot be preserverd. +The first round-trip will make it consistent/normalize it. Here are some +inconsistently indented YAML examples. + +``b`` indented 3, ``c`` indented 4 positions:: + + a: + b: + c: 1 + +Top level sequence is indented 2 without offset, the other sequence 4 (with offset 2):: + + - key: + - foo + - bar + + + Positioning ':' in top level mappings, prefixing ':' ==================================================== |