From 346d851deb2bd491cbdf887d9371fb564f8f92df Mon Sep 17 00:00:00 2001 From: FRex Date: Tue, 17 Dec 2019 08:09:18 +0100 Subject: [PATCH] readme and notes info about shortcuts and uniqinstance --- README.md | 21 ++++++++++++++++++++- allnotes.txt | 14 +++++++++++++- 2 files changed, 33 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index acc3468..e36c653 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,26 @@ The total size of all files in `old` directory is also displayed on the status b In [releases](https://github.com/FRex/botes/releases) of this repo you will find the self-contained zips for 64 bit Windows that contain everything you need to get started. Releases are tagged using [Calendar Versioning](http://calver.org/) scheme `vYY.0M.0D`. -For Linux you will need to compile Botes yourself. +For Linux (and others) you will need to compile Botes yourself (let me know if you have any problems). + + +# Shortcut files +A plaintext file with a single line in it of the form `Query QUERYTEXT` (case sensitive) is +a `Botes` shortcut file that when passed as first argument to a `Botes` invocation will open +a new tab with text `QUERYTEXT` (or select if it's already open). Lines not starting with `Query` +are ignored (but in future they might have an additional effect), lines starting with `Query` +after first such line are ignored as well. I use extension `.bs` (`Botes` shortcut) for them +and associate them with `Botes` so that (double) clicking them in the file manager or opening +them in default program from the command line will cause them to be conveniently opened by `Botes`. + + +# One instance +Using the component described and provided at at +[FreePascalWiki/UniqueInstance](https://wiki.freepascal.org/UniqueInstance) `Botes` +is limited to a single instance, attempting to open another instance will attempt to +focus and bring up the already existing one (WM settings mightt affect how that goes). +If a shortcut file was being opened by this second instance, it will instead be opened by +the first instance properly (just how programs like VLC, Notepad++ and VS Code do it). # Screens diff --git a/allnotes.txt b/allnotes.txt index 317da76..7f70a39 100644 --- a/allnotes.txt +++ b/allnotes.txt @@ -15989,7 +15989,19 @@ Double click on status bar to open the directory Botes is in. Create old directory there to get a duplicate of every saved file. See the included README.md for more details about this feature. -Check https://github.com/FRex/Botes for the latest version. + +Create a file with a single line (case sensitive) in the form of 'Query YOURTAG' +and pass it as first and only argument when starting Botes to create a shortcut +to open/select a tab with 'YOURTAG' in it. You can further use a unique extension +(for example .bs, Botes shortcut) and associate it with Botes to create a file +that when opened with default app from explorer or command line will open Botes. + +There can only be one instance of Botes running, if you attempt to open another +it will instead focus the already opened one. This feature works properly with +the above shortcut file feature as well (it'll open or focus a tab specified in +the file you attempted to open in the already existing instance). + +Check https://github.com/FRex/Botes for the latest version and more information. When the suggestions list box is visible pressing down will go into it and pressing up when having first item selected in it or escape at