diff options
author | Lennart Poettering <lennart@poettering.net> | 2018-03-29 16:28:21 +0200 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2018-04-03 15:22:26 +0200 |
commit | 25ac900ad72e6fe15050228c45feed627c42495a (patch) | |
tree | 77087846ef41196e0a59085d0ef68f837b0ac02b /doc | |
parent | 46f88673729fad4df6d9d7b8e26a735648266bc5 (diff) | |
download | systemd-25ac900ad72e6fe15050228c45feed627c42495a.tar.gz |
CODING_STYLE: document suggested suffixes to use in documentation
Diffstat (limited to 'doc')
-rw-r--r-- | doc/CODING_STYLE | 12 |
1 files changed, 12 insertions, 0 deletions
diff --git a/doc/CODING_STYLE b/doc/CODING_STYLE index 7025d242fa..be30359160 100644 --- a/doc/CODING_STYLE +++ b/doc/CODING_STYLE @@ -454,3 +454,15 @@ O_NONBLOCK has a benefit: it bypasses any mandatory lock that might be in effect on the regular file. If in doubt consider turning off O_NONBLOCK again after opening. + +- When referring to a configuration file option in the documentation and such, + please always suffix it with "=", to indicate that it is a configuration file + setting. + +- When referring to a command line option in the documentation and such, please + allways prefix with "--" or "-" (as appropriate), to indicate that it is a + command line option. + +- When referring to a file system path that is a directory, please always + suffix it with "/", to indicate that it is a directory, not a regular file + (or other file system object). |