2015-02-04 8:49 GMT+01:00 Rainer Gerhards <[email protected]>:

> 2015-02-03 23:28 GMT+01:00 Otis Gospodnetic <[email protected]>:
>
>> Hi,
>>
>> On Tue, Feb 3, 2015 at 4:13 AM, Rainer Gerhards <[email protected]
>> >
>> wrote:
>>
>> > 2015-02-03 0:30 GMT+01:00 David Lang <[email protected]>:
>> >
>> > >
>> > > On Mon, 2 Feb 2015, Otis Gospodnetic wrote:
>> > >
>> > >  Hi,
>> > >>
>> > >> Just installed the very latest 8.7.0 on one machine and spotted this
>> in
>> > >> the
>> > >> log:
>> > >>
>> > >> Feb  2 23:24:27 logsene-reports rsyslogd-2207: error during parsing
>> file
>> > >> /etc/rsyslog.conf, on or before line 55: warnings occured in file
>> > >> '/etc/rsyslog.conf' around line 55 [try
>> http://www.rsyslog.com/e/2207 ]
>> > >>
>> > >>
>> > >>
>> > didn't you get the other error message? This is what I see:
>> >
>> > 2015-02-03T10:10:14.076337+01:00 ubuntu1404esp rsyslogd-2184: action '*'
>> > treated as ':omusrmsg:*' - please change syntax, '*' will not be
>> supported
>> > in the future [v8.8.0.master try http://www.rsyslog.com/e/2184 ]
>> > 2015-02-03T10:10:14.146723+01:00 ubuntu1404esp rsyslogd-2207: error
>> during
>> > parsing file bluecoat.conf, on or before line 7: warnings occured in
>> file
>> > '/bluecoat.conf' around line 7 [v8.8.0.master try
>> > http://www.rsyslog.com/e/2207 ]
>> >
>>
>>
>> I did see this.  I didn't know how to interpret it.
>> May I change a slight change in wording?  A bit more direct for people
>> less
>> familiar with (r)syslog-specifics?
>>
>> e.g.
>> action '*' treated as ':omusrmsg:*' - please change syntax, '*' will not
>> be
>> supported in the future
>>
>> vs.
>>
>> action '*' treated as ':omusrmsg:*' - please use ":omusrmsg:" syntax
>> instead, '*' will not be supported in the future
>>
>> This is a bit more direct and informative IMHO.  It's not telling me just
>> that there is a problem - it's telling me what to do to fix it.
>>
>
> Will do ... but I have to admit I had to read it four times to see the
> difference in wording ;) To *me* it sounds absolutely the same (that's just
> another incarnation of the "It's better if others write doc" problem). I
> had to compare it word-by-word to find the difference.
>
>
Otis,

when I wanted to apply the change, I noticed that you left out the asterisk:

action '*' treated as ':omusrmsg:*' - please use ":omusrmsg:" syntax
instead, '*' will not be supported in the future

vs

action '*' treated as ':omusrmsg:*' - please use ':omusrmsg:*' syntax
instead, '*' will not be supported in the future

Is this intentional? I know it is technically correct, but couldn't it lead
to follow-up errors if people just copy&paste the suggestion. Note that in
my sample I have also changed the quote types to keep things consistent.

Feedback appreciated. I have not yet changed anything, will do when I
receive feedback.
Rainer
_______________________________________________
rsyslog mailing list
http://lists.adiscon.net/mailman/listinfo/rsyslog
http://www.rsyslog.com/professional-services/
What's up with rsyslog? Follow https://twitter.com/rgerhards
NOTE WELL: This is a PUBLIC mailing list, posts are ARCHIVED by a myriad of 
sites beyond our control. PLEASE UNSUBSCRIBE and DO NOT POST if you DON'T LIKE 
THAT.

Reply via email to