| commit | 273368f2ddb6d847877b833305075fcfb81482ff | |
| author | Guillem Jover <guillem@debian.org> | |
| Sun, 18 Sep 2022 18:36:12 +0000 (18 20:36 +0200) | ||
| committer | Guillem Jover <guillem@debian.org> | |
| Sat, 31 Dec 2022 14:28:29 +0000 (31 15:28 +0100) | ||
| tree | 0768f056335e27c1273131bc41388ff0eb934511 | treesnapshot (tar.gz zip) |
| parent | d10189de919e2183f99a3e81999833903f570535 | commitdiff |
man: Use stanza instead of paragraph, block or record for deb822 parts
The «stanza» name is a commonly used and understood term when referring
to deb822 parts. Although «paragraph» is commonly used it has the
problem of being confusing as it then makes it hard to distinguish
actual text paragraphs in prose, while «stanza» is a very specific
term that is not applied anywhere else in the deb822 context, so
it's always more clear and specific, than also block or record.
In addition «stanza» is shorter, which is always a nice attribute
on code for example.
This unifies the terminology used with recent changes in the Debian
policy manual, to try to make these concepts more clear in general.
The «stanza» name is a commonly used and understood term when referring
to deb822 parts. Although «paragraph» is commonly used it has the
problem of being confusing as it then makes it hard to distinguish
actual text paragraphs in prose, while «stanza» is a very specific
term that is not applied anywhere else in the deb822 context, so
it's always more clear and specific, than also block or record.
In addition «stanza» is shorter, which is always a nice attribute
on code for example.
This unifies the terminology used with recent changes in the Debian
policy manual, to try to make these concepts more clear in general.