summaryrefslogtreecommitdiff
path: root/doc/en/autogen/user/logger_options.adoc
blob: 0a39c5aa2367cb2822f79efe5859e08233072aac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
//
// This file is auto-generated by script docgen.py.
// DO NOT EDIT BY HAND!
//
* [[option_logger.color.backlog_end]] *logger.color.backlog_end*
** description: pass:none[color for line ending the backlog]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+default+`

* [[option_logger.color.backlog_line]] *logger.color.backlog_line*
** description: pass:none[color for backlog lines]
** type: color
** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline
** default value: `+default+`

* [[option_logger.file.auto_log]] *logger.file.auto_log*
** description: pass:none[automatically save content of buffers to files (unless a buffer disables log)]
** type: boolean
** values: on, off
** default value: `+on+`

* [[option_logger.file.flush_delay]] *logger.file.flush_delay*
** description: pass:none[number of seconds between flush of log files (0 = write in log files immediately for each line printed)]
** type: integer
** values: 0 .. 3600
** default value: `+120+`

* [[option_logger.file.fsync]] *logger.file.fsync*
** description: pass:none[use fsync to synchronize the log file with the storage device after the flush (see man fsync); this is slower but should prevent any data loss in case of power failure during the save of log file]
** type: boolean
** values: on, off
** default value: `+off+`

* [[option_logger.file.info_lines]] *logger.file.info_lines*
** description: pass:none[write information line in log file when log starts or ends for a buffer]
** type: boolean
** values: on, off
** default value: `+off+`

* [[option_logger.file.mask]] *logger.file.mask*
** description: pass:none[default file name mask for log files (format is "directory/to/file" or "file", without first "/" because "path" option is used to build complete path to file); local buffer variables are permitted (you should use only variables that are defined on all buffers, so for example you should NOT use $server nor $channel); date specifiers are permitted (see man strftime)]
** type: string
** values: any string
** default value: `+"$plugin.$name.weechatlog"+`

* [[option_logger.file.name_lower_case]] *logger.file.name_lower_case*
** description: pass:none[use only lower case for log filenames]
** type: boolean
** values: on, off
** default value: `+on+`

* [[option_logger.file.nick_prefix]] *logger.file.nick_prefix*
** description: pass:none[text to write before nick in prefix of message, example: "<"]
** type: string
** values: any string
** default value: `+""+`

* [[option_logger.file.nick_suffix]] *logger.file.nick_suffix*
** description: pass:none[text to write after nick in prefix of message, example: ">"]
** type: string
** values: any string
** default value: `+""+`

* [[option_logger.file.path]] *logger.file.path*
** description: pass:none[path for WeeChat log files; "%h" at beginning of string is replaced by WeeChat home ("~/.weechat" by default); date specifiers are permitted (see man strftime) (note: content is evaluated, see /help eval)]
** type: string
** values: any string
** default value: `+"%h/logs/"+`

* [[option_logger.file.replacement_char]] *logger.file.replacement_char*
** description: pass:none[replacement char for special chars in filename built with mask (like directory delimiter)]
** type: string
** values: any string
** default value: `+"_"+`

* [[option_logger.file.time_format]] *logger.file.time_format*
** description: pass:none[timestamp used in log files (see man strftime for date/time specifiers)]
** type: string
** values: any string
** default value: `+"%Y-%m-%d %H:%M:%S"+`

* [[option_logger.look.backlog]] *logger.look.backlog*
** description: pass:none[maximum number of lines to display from log file when creating new buffer (0 = no backlog)]
** type: integer
** values: 0 .. 2147483647
** default value: `+20+`

* [[option_logger.look.backlog_conditions]] *logger.look.backlog_conditions*
** description: pass:none[conditions to display the backlog (note: content is evaluated, see /help eval); empty value displays the backlog on all buffers; for example to display backlog on private buffers only: "${type} == private"]
** type: string
** values: any string
** default value: `+""+`