rsyslog-doc
rsyslog-doc copied to clipboard
source/configuration/basic_structure.rst still has the prior format names
Problem
The content in the Statement Types
section is a near duplicate of what is now in the source/configuration/conf_formats.rst
file. Either it needs to be updated to match the other file, we need to add a reference to the correct content (my current thoughts) or we need to remove it entirely.
Example
Statement Types
---------------
Rsyslog supports three different types of configuration statements
concurrently:
- **sysklogd** - this is the plain old format, taught everywhere and
still pretty useful for simple use cases. Note that some
constructs are no longer supported because they are incompatible with
newer features. These are mentioned in the compatibility docs.
- **legacy rsyslog** - these are statements that begin with a dollar
sign. They set some (case-insensitive) configuration parameters and
modify e.g. the way actions operate. This is the only format supported
in pre-v6 versions of rsyslog. It is still fully supported in v6 and
above. Note that some plugins and features may still only be available
through legacy format (because plugins need to be explicitly upgraded
to use the new style format, and this hasn't happened to all plugins).
- **RainerScript** - the new style format. This is the best and most
precise format to be used for more complex cases. As with the legacy
format, RainerScript parameters are also case-insensitive.
The rest of this page assumes RainerScript based rsyslog.conf.
References
- https://github.com/rsyslog/rsyslog-doc/blob/master/source/configuration/basic_structure.rst
- https://github.com/rsyslog/rsyslog-doc/blob/master/source/configuration/conf_formats.rst
See also #421.