Add option to print hotkeys' descriptions to stdout

doc/sxhkd.1

@@ -2,12 +2,12 @@
 .\"     Title: sxhkd
 .\"    Author: [see the "Author" section]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 08/02/2020
+.\"      Date: 09/03/2021
 .\"    Manual: Sxhkd Manual
 .\"    Source: Sxhkd 0.6.2
 .\"  Language: English
 .\"
-.TH "SXHKD" "1" "08/02/2020" "Sxhkd 0\&.6\&.2" "Sxhkd Manual"
+.TH "SXHKD" "1" "09/03/2021" "Sxhkd 0\&.6\&.2" "Sxhkd Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -78,6 +78,11 @@ Output status information to the given FIFO\&.
 .RS 4
 Name of the keysym used for aborting chord chains\&.
 .RE
+.PP
+\fB\-p\fR
+.RS 4
+Print hotkeys and associated commands read from config files to stdout\&.
+.RE
 .SH "BEHAVIOR"
 .sp
 \fBsxhkd\fR is a daemon that listens to keyboard events and execute commands\&.

doc/sxhkd.1.asciidoc

@@ -48,6 +48,9 @@ Options
 *-a* _ABORT_KEYSYM_::
     Name of the keysym used for aborting chord chains.
 
+*-p*::
+    Print hotkeys and associated commands read from config files to stdout.
+
 
 Behavior
 --------

src/parse.c

@@ -2687,7 +2687,7 @@ bool parse_chain(char *string, chain_t *chain)
 			return false;
 		}
 		add_chord(chain, c);
-		if (status_fifo != NULL) {
+		if (status_fifo != NULL || print_hotkeys_mode) {
 			snprintf(c->repr, sizeof(c->repr), "%s", chord);
 		}
 		keysym = XCB_NO_SYMBOL;

src/sxhkd.c

@@ -52,7 +52,7 @@ int mapping_count;
 int timeout;
 
 hotkey_t *hotkeys_head, *hotkeys_tail;
-bool running, grabbed, toggle_grab, reload, bell, chained, locked;
+bool running, grabbed, toggle_grab, reload, bell, chained, locked, print_hotkeys_mode;
 xcb_keysym_t abort_keysym;
 chord_t *abort_chord;
 
@@ -72,7 +72,7 @@ int main(int argc, char *argv[])
 	redir_fd = -1;
 	abort_keysym = ESCAPE_KEYSYM;
 
-	while ((opt = getopt(argc, argv, "hvm:t:c:r:s:a:")) != -1) {
+	while ((opt = getopt(argc, argv, "hvpm:t:c:r:s:a:")) != -1) {
 		switch (opt) {
 			case 'v':
 				printf("%s\n", VERSION);
@@ -105,6 +105,9 @@ int main(int argc, char *argv[])
 					warn("Invalid keysym name: %s.\n", optarg);
 				}
 				break;
+		        case 'p':
+			        print_hotkeys_mode = 1;
+		                break;
 		}
 	}
 
@@ -144,6 +147,12 @@ int main(int argc, char *argv[])
 	load_config(config_file);
 	for (int i = 0; i < num_extra_confs; i++)
 		load_config(extra_confs[i]);
+
+	if (print_hotkeys_mode) {
+	  print_hotkeys(hotkeys_head, hotkeys_tail);
+	  exit(0);
+	}
+
 	grab();
 
 	xcb_generic_event_t *evt;
@@ -354,3 +363,23 @@ void put_status(char c, const char *s)
 	fprintf(status_fifo, "%c%s\n", c, s);
 	fflush(status_fifo);
 }
+
+void print_chain(chain_t *chain)
+{
+  chord_t *c = chain->head;
+  printf("%s", c->repr);
+  while (c != chain->tail) {
+    c = c->next;
+    printf(" ; %s", c->repr);
+  }
+  printf(" | ");
+}
+
+void print_hotkeys(hotkey_t *head, hotkey_t *tail)
+{
+  hotkey_t *h;
+  for (h = head; h != tail; h = h->next) {
+    print_chain(h->chain);
+    printf("%s\n", h->command);
+  }
+}

src/sxhkd.h

@@ -58,7 +58,7 @@ extern int mapping_count;
 extern int timeout;
 
 extern hotkey_t *hotkeys_head, *hotkeys_tail;
-extern bool running, grabbed, toggle_grab, reload, bell, chained, locked;
+extern bool running, grabbed, toggle_grab, reload, bell, chained, locked, print_hotkeys_mode;
 extern xcb_keysym_t abort_keysym;
 extern chord_t *abort_chord;
 
@@ -74,5 +74,7 @@ void reload_cmd(void);
 void toggle_grab_cmd(void);
 void hold(int sig);
 void put_status(char c, const char *s);
+void print_chord(chord_t *chord);
+void print_hotkeys(hotkey_t *head, hotkey_t *tail);
 
 #endif