From 1c58c339bbc736bbdbe14cd33bbdaeb0c8376549 Mon Sep 17 00:00:00 2001
From: Ansa89 <ansalonistefano@gmail.com>
Date: Tue, 29 Jul 2014 12:07:24 +0200
Subject: [PATCH] Update toxic.conf manpage

---
 doc/toxic.conf.5        | 125 +++++++++++++++++++++++++++++++++++-----
 misc/toxic.conf.example |   2 +-
 2 files changed, 113 insertions(+), 14 deletions(-)

diff --git a/doc/toxic.conf.5 b/doc/toxic.conf.5
index 187a95a..c5d00a7 100644
--- a/doc/toxic.conf.5
+++ b/doc/toxic.conf.5
@@ -27,7 +27,7 @@ Sections:
 .PP
 .B ui
 .RS
-Configurations related to user interface.
+Configurations related to user interface elements.
 .PP
 Keys:
 .br
@@ -119,6 +119,8 @@ Values: <STRING> (absolute path where to store downloaded files)
 .B sounds
 .RS
 Configurations related to notification sounds.
+.br
+(Special value "silent" can be used to disable a specific notification)
 .PP
 Keys:
 .br
@@ -192,6 +194,78 @@ Sound to play when a file transfer is completed.
 Values: <STRING> (sound file absolute path)
 .RE
 .RE
+.PP
+.B keys
+.RS
+Configurations related to user interface interaction.
+.br
+(Currently supported: Ctrl modified keys, Tab, PAGEUP and PAGEDOWN (case insensitive))
+.PP
+Keys:
+.br
+.B next_tab
+.RS
+Key combination to switch next tab.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B prev_tab
+.RS
+Key combination to switch previous tab.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B scroll_line_up
+.RS
+Key combination to scroll one line up.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B scroll_line_down
+.RS
+Key combination to scroll one line down.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B half_page_up
+.RS
+Key combination to scroll half page up.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B half_page_down
+.RS
+Key combination to scroll half page down.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B page_bottom
+.RS
+Key combination to scroll to page bottom.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B peer_list_up
+.RS
+Key combination to scroll contacts list up.
+.br
+Values: <STRING> (key combination)
+.RE
+.PP
+.B peer_list_down
+.RS
+Key combination to scroll contacts list down.
+.br
+Values: <STRING> (key combination)
+.RE
+.RE
 .SH EXAMPLES
 Default settings from __DATADIR__/toxic.conf.exmaple:
 .PP
@@ -200,11 +274,10 @@ Default settings from __DATADIR__/toxic.conf.exmaple:
 // USES LIBCONFIG-ACCEPTED SYNTAX
 .br
 ui = {
-.br
+.RS
   // true to enable timestamps, false to disable
 .br
   timestamps:true;
-.br
 .br
   // true to enable terminal alerts on messages, false to disable
 .br
@@ -225,11 +298,11 @@ ui = {
   // maximum lines for chat window history
 .br
   history_size=700;
-.br
+.RE
 };
-.br
+.PP
 audio = {
-.br
+.RS
   // preferred audio input device; numbers correspond to /lsdev in
 .br
   input_device=2;
@@ -241,21 +314,21 @@ audio = {
   // default VAD treshold; float (recommended values are around 40)
 .br
   VAD_treshold=40.0;
-.br
+.RE
 };
-.br
+.PP
 tox = {
-.br
+.RS
   // where to store received files
 .br
-  // download_path="/home/USERNAME/Downloads/";
-.br
+  //download_path="/home/USERNAME/Downloads/";
+.RE
 };
-.br
+.PP
 // To disable a sound set the path to "silent"
 .br
 sounds = {
-.br
+.RS
   error="__DATADIR__/sounds/Error.wav";
 .br
   self_log_in="__DATADIR__/sounds/LogIn.wav";
@@ -275,7 +348,33 @@ sounds = {
   transfer_pending="__DATADIR__/sounds/TransferPending.wav";
 .br
   transfer_completed="__DATADIR__/sounds/TransferComplete.wav";
+.RE
+};
+.PP
+// Currently supported: Ctrl modified keys, Tab, PAGEUP and PAGEDOWN (case insensitive)
 .br
+// Note: All printable keys register as input
+.br
+keys = {
+.RS
+  next_tab="Ctrl+P";
+.br
+  prev_tab="Ctrl+O";
+.br
+  scroll_line_up="PAGEUP";
+.br
+  scroll_line_down="PAGEDOWN";
+.br
+  half_page_up="Ctrl+F";
+.br
+  half_page_down="Ctrl+V";
+.br
+  page_bottom="Ctrl+H";
+.br
+  peer_list_up="Ctrl+[";
+.br
+  peer_list_down="Ctrl+]";
+.RE
 };
 .SH FILES
 .IP ~/.config/tox/toxic.conf
diff --git a/misc/toxic.conf.example b/misc/toxic.conf.example
index 62f59cd..80ad9d1 100644
--- a/misc/toxic.conf.example
+++ b/misc/toxic.conf.example
@@ -34,7 +34,7 @@ audio = {
 
 tox = {
   // where to store received files
-  // download_path="/home/USERNAME/Downloads/";
+  //download_path="/home/USERNAME/Downloads/";
 };
 
 // To disable a sound set the path to "silent"