[syslog-ng] Syslog-NG (1.9) documentation issues (lots of...)

[Wolfram Schlich]

Referencing the current 2.0 online manual:
http://www.balabit.com/products/syslog_ng/reference-2.0/syslog-ng.html/

- Table 3.13
  - TZOFFSET: documented as '-0700', is effectively '-07:00'.
  - DATE: description is missing. Looks like "Jun 13 15:58:00".
  - FULLDATE: -"-. Looks like "2006 Jun 13 15:56:57".
  - ISODATE: -"-. Looks like "2006-06-13T15:56:51+02:00".
  - UNIXTIME: -"-. Standard UNIX timestamp.
  - FULLHOST, HOST_FROM, FULLHOST_FROM, SOURCEIP: -"-

- 3.2:
  - fsync(), timezone() and ts_format() are undocumented
    (obviously, the ts_format() part just needs to be copied from 3.5)

- 3.2.2.5 usertty():
  - documented to support template(), but...
    ...this works (of course it does):
      destination d_admintty { usertty("root"); };
    ...this makes 'syslog-ng -s' complain about a syntax error:
      destination d_admintty { usertty("root" template(t_admintty)); };

- 3.5 Options:
  - sync() and sync_freq() are marked as obsolete with flush_lines()
	as the successor, unfortunately flush_lines() itself is not
	documented in 3.5 (only in 3.2 with a reference to the global
	default which is just not present).
  - flush_timeout() is not documented in 3.5 (only in 3.2, just like
	flush_lines())

Yet more to come (no time right now :-()
-- 
Regards,
Wolfram Schlich <wschlich at gentoo.org>
Gentoo Linux * http://dev.gentoo.org/~wschlich/