doc faq: Fix the prose
This commit is contained in:
parent
cb5e005378
commit
61094a97e2
|
@ -6,16 +6,16 @@
|
||||||
|
|
||||||
The name of the project is pronounced "Kak-oon", and is a word taken from a
|
The name of the project is pronounced "Kak-oon", and is a word taken from a
|
||||||
New Caledonian dialect based on French. It means a hard blow, usually a punch,
|
New Caledonian dialect based on French. It means a hard blow, usually a punch,
|
||||||
but generally refers to a blow into which all of one's strength went.
|
but generally refers to a strike into which all of one's strength went.
|
||||||
|
|
||||||
=== Is there going to be a Windows port of Kakoune ?
|
=== Is there going to be a Windows port of Kakoune ?
|
||||||
|
|
||||||
As many features provided by UNIX systems would be missing, or if anything
|
As many features provided by UNIX systems would be missing, or albeit much
|
||||||
much less efficient on a Windows system, the incentive to porting the
|
less efficient, on a Windows system, the incentive to porting the project
|
||||||
project to this operating system is pretty low.
|
to this operating system is low.
|
||||||
|
|
||||||
Moreover, you can get pretty decent performance by using Kakoune on Cygwin
|
Moreover, you can achieve pretty decent performance by using Kakoune on
|
||||||
(which is officially supported).
|
Cygwin (which is officially supported).
|
||||||
|
|
||||||
== Interfacing
|
== Interfacing
|
||||||
|
|
||||||
|
@ -32,17 +32,17 @@ try experimental community-developed ones.
|
||||||
|
|
||||||
=== Why are colors misrendered in my Kakoune clients ?
|
=== Why are colors misrendered in my Kakoune clients ?
|
||||||
|
|
||||||
The most probable cause for that is a very widespread practice that consists
|
The most probable cause for colors being misrendered is a widespread practice
|
||||||
in setting the `TERM` environment variable in the shell's configuration file.
|
that consists in setting the `TERM` environment variable in the shell's
|
||||||
This variable should be set by the terminal emulator, and not overridden with
|
configuration file. This variable should be set by the terminal emulator,
|
||||||
an arbitrary value, otherwise it might interfere with general UI rendering on
|
and not overridden with an arbitrary value, otherwise it might interfere
|
||||||
the terminal's window.
|
with general UI rendering on the terminal's window.
|
||||||
|
|
||||||
=== I'm using `tmux` and colors look weird
|
=== I'm using `tmux` and colors look weird
|
||||||
|
|
||||||
If you're using a tool that doesn't support "palette switching", colors will
|
If you're using a tool that doesn't support "palette switching", colors will
|
||||||
still be slightly off: they are being rounded down to values supported by the
|
still be slightly off: they are being rounded down to values supported by the
|
||||||
regular color palette by Kakoune. Fortunately, on recent versions of `tmux`
|
regular color palette of Kakoune. Fortunately, on recent versions of `tmux`
|
||||||
(>=2.6), you can work around that by using the following configuration
|
(>=2.6), you can work around that by using the following configuration
|
||||||
settings:
|
settings:
|
||||||
|
|
||||||
|
@ -74,8 +74,8 @@ to verify that your locale is set correctly is to run the following command:
|
||||||
$ locale
|
$ locale
|
||||||
----
|
----
|
||||||
|
|
||||||
The output should look similar to the following (with eventually another
|
The output should look similar to the following (with your own
|
||||||
language set instead of `en_US`):
|
language/country code set, instead of `en_US`):
|
||||||
|
|
||||||
----
|
----
|
||||||
LANG=en_US.UTF-8
|
LANG=en_US.UTF-8
|
||||||
|
@ -114,7 +114,7 @@ to a short time, e.g. 25ms: `set -sg escape-time 25`
|
||||||
As a fairly compliant follower of the UNIX philosophy, Kakoune does not
|
As a fairly compliant follower of the UNIX philosophy, Kakoune does not
|
||||||
try to implement features that are best handled by separate, dedicated
|
try to implement features that are best handled by separate, dedicated
|
||||||
tools. Window splitting in terminals is a prime example of that
|
tools. Window splitting in terminals is a prime example of that
|
||||||
concept, where the editor provides commands to interact with several
|
concept, whereby the editor provides commands to interact with several
|
||||||
terminal multiplexers (e.g. `tmux`), as opposed to emulating their
|
terminal multiplexers (e.g. `tmux`), as opposed to emulating their
|
||||||
functionalities.
|
functionalities.
|
||||||
|
|
||||||
|
@ -158,7 +158,7 @@ post in an issue in unmangled form (c.f. `c++filt`).
|
||||||
|
|
||||||
The builtin file completion engine used when opening a file for editing
|
The builtin file completion engine used when opening a file for editing
|
||||||
(using the `:edit` command and letting the suggestions popup in the menu
|
(using the `:edit` command and letting the suggestions popup in the menu
|
||||||
beneath) is much more convenient than Vim's, which should suit basic needs.
|
beneath) is more convenient than Vim's, which should suit basic needs.
|
||||||
|
|
||||||
However, if you need an actual explorer to interact with the editor,
|
However, if you need an actual explorer to interact with the editor,
|
||||||
you can create a Kakoune script that will spawn the tool in question,
|
you can create a Kakoune script that will spawn the tool in question,
|
||||||
|
@ -218,21 +218,20 @@ globally with the following command: `set global disabled_hooks '.+-indent'`
|
||||||
|
|
||||||
=== How to enable syntax highlighting ?
|
=== How to enable syntax highlighting ?
|
||||||
|
|
||||||
The mimetype of the files opened in new buffers is detected using the
|
The MIME type of the files opened in new buffers is detected using the
|
||||||
`file` command, and syntax highlighting enabled automatically when
|
`file` command, and syntax highlighting enabled automatically when
|
||||||
possible.
|
possible.
|
||||||
|
|
||||||
=== My file seems to be highlighted with the wrong colors, I thought syntax highlighting was detected automatically ?
|
=== My file seems to be highlighted with the wrong colors, I thought syntax highlighting was detected automatically ?
|
||||||
|
|
||||||
The `file` utility has several shortcomings, such as detecting the
|
The `file` utility has several shortcomings, such as detecting the
|
||||||
wrong mimetype for a file containing data with different syntax, e.g.
|
wrong MIME type for a file containing data with different syntax, e.g.
|
||||||
a Python script containing hardcoded HTML templates detected as an HTML
|
a Python script containing hardcoded HTML templates detected as an HTML
|
||||||
file.
|
file.
|
||||||
|
|
||||||
Kakoune does its best at detecting file types (using known extensions
|
Kakoune does its best to detect file types (using known extensions for a
|
||||||
for a given format for instance), but not much can be done about those
|
given format for instance), but not much can be done about those ambiguous
|
||||||
ambiguous cases. You might consider writing a custom `$HOME/.magic` file
|
cases. You might consider writing a custom `$HOME/.magic` file if needed.
|
||||||
if needed.
|
|
||||||
|
|
||||||
=== Can I disable syntax highlighting completely ?
|
=== Can I disable syntax highlighting completely ?
|
||||||
|
|
||||||
|
@ -254,10 +253,10 @@ one available by default.
|
||||||
|
|
||||||
=== What shell is used to expand `%sh{}` scopes ?
|
=== What shell is used to expand `%sh{}` scopes ?
|
||||||
|
|
||||||
The server expands shell scopes using the `sh` binary, stored in one of the
|
The server expands shell scopes using the `sh` binary, located in one of
|
||||||
directories where all the POSIX standard utilities can be found -this list
|
the directories containing all the POSIX standard utilities. This list of
|
||||||
of directories is stored in a system configuration variable, and queried
|
directories is stored in a system configuration variable, and queried by
|
||||||
by Kakoune at startup.
|
Kakoune at startup.
|
||||||
|
|
||||||
In most distributions, `/bin/sh` will end up being used.
|
In most distributions, `/bin/sh` will end up being used.
|
||||||
|
|
||||||
|
@ -275,7 +274,7 @@ You can instruct the regex engine to stop matching newline characters with
|
||||||
=== Why does `a` extend the current selection, but `i` leaves it untouched ?
|
=== Why does `a` extend the current selection, but `i` leaves it untouched ?
|
||||||
|
|
||||||
Selections are ranges of characters whose delimiters are an "anchor" and
|
Selections are ranges of characters whose delimiters are an "anchor" and
|
||||||
a "cursor", and inserting characters is always done before the cursor in
|
a "cursor", and inserting characters is always done before the anchor in
|
||||||
insert mode.
|
insert mode.
|
||||||
|
|
||||||
Consequently, using the append primitive (`a`) nudges the cursor forward to
|
Consequently, using the append primitive (`a`) nudges the cursor forward to
|
||||||
|
|
Loading…
Reference in New Issue
Block a user