rsyslog-doc icon indicating copy to clipboard operation
rsyslog-doc copied to clipboard

source/configuration/basic_structure.rst still has the prior format names

Open deoren opened this issue 7 years ago • 1 comments

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

deoren avatar Jan 25 '18 00:01 deoren

See also #421.

deoren avatar Jan 25 '18 00:01 deoren