Add date format for logger masks in user guide

2 files changed, 52 insertions, 7 deletions

diff --git a/doc/it/CMakeLists.txt b/doc/it/CMakeLists.txt
index bb3c72dd0..3562d5323 100644
--- a/doc/it/CMakeLists.txt
+++ b/doc/it/CMakeLists.txt
@@ -20,7 +20,7 @@
 # user's guide
 ADD_CUSTOM_COMMAND(
   OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.it.html
-  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=3 -a toc-title='Indice' -a date=`date "+%F"` -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.it.txt
+  COMMAND ${ASCIIDOC_EXECUTABLE} ARGS -a toc -a toclevels=4 -a toc-title='Indice' -a date=`date "+%F"` -a revision="${VERSION}" -a stylesheet=${CMAKE_CURRENT_SOURCE_DIR}/../asciidoc.css -n -o ${CMAKE_CURRENT_BINARY_DIR}/weechat_user.it.html ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.it.txt
   DEPENDS
   ${CMAKE_CURRENT_SOURCE_DIR}/weechat_user.it.txt
   ${CMAKE_CURRENT_SOURCE_DIR}/autogen/user/*.txt
diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt
index f7dda1995..42f28c53e 100644
--- a/doc/it/weechat_user.it.txt
+++ b/doc/it/weechat_user.it.txt
@@ -1566,14 +1566,59 @@ variabili locali per il buffer corrente:
 /buffer localvar
 ----------------------------------------
 
-Per esempio, se si vuole una cartella per server IRC e un file per canale al
-suo interno:
+// TRANSLATION MISSING
+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").
+
+// TRANSLATION MISSING
+[[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
+........................................
+
+// TRANSLATION MISSING
+[[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"
 ----------------------------------------
 
-Si avranno i seguenti file:
+You'll have following files:
 
 ........................................
 ~/.weechat/
@@ -1582,11 +1627,11 @@ Si avranno i seguenti file:
             |--- freenode/
             |       freenode.weechatlog
             |       #weechat.weechatlog
-            |       #miocanale.weechatlog
+            |       #mychan.weechatlog
             |--- oftc/
             |       oftc.weechatlog
-            |       #canale1.weechatlog
-            |       #canale2.weechatlog
+            |       #chan1.weechatlog
+            |       #chan2.weechatlog
 ........................................
 
 // TRANSLATION MISSING