From 8f60d7b2394cc967dc6ab6b65a68d3bdae259735 Mon Sep 17 00:00:00 2001
From: Lukas Holecek <hluk@email.cz>
Date: Sun, 10 Jan 2021 07:55:46 +0100
Subject: [PATCH] Docs: Add examples for using a different log file
---
docs/faq.rst | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)
diff --git a/docs/faq.rst b/docs/faq.rst
index 9f78f8032..3bdbaabdf 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -184,6 +184,27 @@ You can copy current log file path to clipboard from Action dialog (F5 shortcut)
by entering command ``copyq 'copy(info("log"))'``. Alternatively, press ``F12``
to directly access the log.
+If you **cannot access GUI**, you can **restart CopyQ from terminal** and **log
+to a separate file**. On Linux and macOS:
+
+.. code-block:: zsh
+
+ copyq exit
+ export COPYQ_LOG_LEVEL='DEBUG'
+ export COPYQ_LOG_FILE="$HOME\copyq.log"
+ echo "Logs will be written to $COPYQ_LOG_FILE"
+ copyq
+
+On Windows (in PowerShell):
+
+.. code-block:: powershell
+
+ & 'C:\Program Files (X86)\CopyQ\copyq.exe' exit
+ $env:COPYQ_LOG_LEVEL = 'DEBUG'
+ $env:COPYQ_LOG_FILE = [Environment]::GetFolderPath("MyDocuments") + '\copyq.log'
+ echo "Logs will be written to $env:COPYQ_LOG_FILE"
+ & 'C:\Program Files (X86)\CopyQ\copyq.exe'
+
How to preserve the order of copied items when copying or pasting multiple items?
---------------------------------------------------------------------------------
--
GitLab