anchor.diff: -Frequently Asked Questions
  ---------------------------
  +KAKOUNE(1)
  +==========
  +
  +NAME
  +----
  +faq - a
   
   How to pronounce the name of the project and what does it mean ?
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   
  -The name of the project is pronounced "Kak-oon", and is a word taken from
  -a New Caledonia dialect based on french. It means a hard blow, usually a
  -punch, but generally refers to a blow in which all of one's strength went
  -into doing.
  +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,
  +but generally refers to a blow into which which all of one's strength went.
   
   Is there going to be a Windows port of Kakoune ?
   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
positive.code: How do I automatically indent code, as Vim does with `=` ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  As `Kakoune` doesn't parse the contents of the buffers, there is no
  builtin equivalent for this Vim feature. Use a formatter/prettifier
  dedicated to the language you're using with the help of the `|` key.
  
  Example: `%|indent<ret>` to indent an entire buffer with C code.
  
  
negative.code: Can Kakoune automatically complete the parameters of my functions ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  As mentioned in the above question about Vim's `=` key, Kakoune does not
  parse the contents of a buffer by itself, which makes it impossible for
  the editor to propose candidates upon completion.
  
  However, support for such a feature can be achieved through the use of a
  dedicated tool, as is the case with `clang` and C code: you can use the
  `clang-enable-autocomplete` and `clang-complete` builtin commands whenever
  editing a C/C++ file, and completion will work on function parameters.
  
  Note that the same features are available for python buffers, with the
  `jedi` script.
  
  Why aren't widely known command line shortcuts such as <c-w> or <c-u> available in Kakoune ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  Despite their widespread availability in multiple tools, those shortcuts do
  not fit the paradigm that Kakoune implements, which is based on selections
  first.
  
  However, you can easily declare key mappings in your configuration file
  to be able to use those control-based shortcuts in insert mode (c.f. the
  "map" command in the "commands" documentation page).
  
  How can I explore the filesystem the way Vim's NerdTree does ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  The builtin file completion engine used when opening a file for editing
  (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.
  
  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,
  which should in return send an "edit" command followed by the path of the
  file you selected to the current Kakoune session (e.g. `echo "eval -client
  $kak_client edit /path/to/file" | kak -p $kak_session`).
  
  Why aren't there other scopes similar to `%sh{}` e.g. python ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  Supporting custom scopes would add hard dependencies to the project, which
  is too much of an drawback when balanced against the low cost of using
  an interpreter in a regular shell scope (e.g. `%sh{ python -c "..." }`).
  The shell scope allows users to spawn any interpreter they want, for a minimal
  cost in terms of performance, it is therefore the reason why it's the only
  one available by default.
  
  Can I disable auto-indentation completely ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  All the indentation hooks are conventionally named `<lang>-indent`, which
  allows us to use the `disabled_hooks` variable to disable indentation
  globally with the following command: `set global disabled_hooks '.+-indent'`
  
  Can I disable syntax highlighting completely ?
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  
  Similarly to the indentation hooks, the name format followed by the
  highlighting hooks is `<lang>-highlight`. You can thus disable syntax
  highlighting using the following command: `set global disabled_hooks
  '.+-highlight'`
  