summaryrefslogtreecommitdiff
path: root/doc/en
diff options
context:
space:
mode:
authorSebastien Helleu <flashcode@flashtux.org>2010-12-11 22:03:21 +0100
committerSebastien Helleu <flashcode@flashtux.org>2010-12-11 22:03:21 +0100
commit4669eac3726a641978b3cc1b0716b67b3eec4050 (patch)
tree316fcd262dd7d1fe6bd5488639820039b321fb4b /doc/en
parentcabf0c4bc1c716d11847fbe2bbf76cf27b6bb3fb (diff)
downloadweechat-4669eac3726a641978b3cc1b0716b67b3eec4050.zip
Add date format for logger masks in user guide
Diffstat (limited to 'doc/en')
-rw-r--r--doc/en/CMakeLists.txt2
-rw-r--r--doc/en/weechat_user.en.txt46
2 files changed, 45 insertions, 3 deletions
diff --git a/doc/en/CMakeLists.txt b/doc/en/CMakeLists.txt
index 0330dc29e..24f30f284 100644
--- a/doc/en/CMakeLists.txt
+++ b/doc/en/CMakeLists.txt
@@ -20,7 +20,7 @@
# user's guide
ADD_CUSTOM_COMMAND(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.en.html
- COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a date=`date "+%F"` -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.en.txt
+ COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=4 -a date=`date "+%F"` -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.en.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.en.txt
DEPENDS
${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.en.txt
${CMAKE_CURRENT_SOURCE_DIR}/autogen/user/*.txt
diff --git a/doc/en/weechat_user.en.txt b/doc/en/weechat_user.en.txt
index 337527f77..bd47d4017 100644
--- a/doc/en/weechat_user.en.txt
+++ b/doc/en/weechat_user.en.txt
@@ -1529,8 +1529,50 @@ variables to build filename. To see local variables for current buffer:
/buffer localvar
----------------------------------------
-For example if you want one directory by IRC server and one file by channel
-inside:
+For example, on buffer "irc.freenode.#weechat", WeeChat will search a mask with
+option name, in this order:
+
+----------------------------------------
+logger.mask.irc.freenode.#weechat
+logger.mask.irc.freenode
+logger.mask.irc
+logger.file.mask
+----------------------------------------
+
+That means you can have masks specific for some IRC servers
+("logger.mask.irc.freenode") or for a plugin ("logger.mask.irc").
+
+[[logger_files_by_date]]
+Log files by date
++++++++++++++++++
+
+To have log files by date, you can use date/time specifiers in mask (see
+`man strftime` for formats), for example:
+
+----------------------------------------
+/set logger.file.mask "%Y/%m/$plugin.$name.weechatlog"
+----------------------------------------
+
+You'll have following files:
+
+........................................
+~/.weechat/
+ |--- logs/
+ |--- 2010/
+ |--- 11/
+ | irc.server.freenode.weechatlog
+ | irc.freenode.#weechat.weechatlog
+ |--- 2010/
+ |--- 12/
+ | irc.server.freenode.weechatlog
+ | irc.freenode.#weechat.weechatlog
+........................................
+
+[[logger_irc_files_by_server_channel]]
+IRC log files by server and channel
++++++++++++++++++++++++++++++++++++
+
+If you want one directory by IRC server and one file by channel inside:
----------------------------------------
/set logger.mask.irc "irc/$server/$channel.weechatlog"