documentation: text mode moved to quick start guide

2 files changed, 71 insertions, 59 deletions

diff --git a/doc/quick-start.org b/doc/quick-start.org
index 5ae9d1a..c214fdf 100644
--- a/doc/quick-start.org
+++ b/doc/quick-start.org
@@ -1,13 +1,11 @@
 #+title: Quick start: using xmobar
 
-Xmobar can either be configured using the configuration language, or
-used as a Haskell library (similar to xmonad) and compiled with your
-specific configuration. For an example of the latter, you can have a
-loot at [[../examples/xmobar.hs][examples/xmobar.hs]] or, for a more complicated example, peruse
-[[https://gitlab.com/jaor/xmobar-config/][the author's configuration]].
-
-There is also an example of a config using the configuration language
-available [[https://codeberg.org/xmobar/xmobar/src/branch/master/examples/xmobar.config][here]].
+Xmobar can either be configured using the configuration language, or [[file:using-haskell.org][used as a
+Haskell library]] (similar to xmonad) and compiled with your specific
+configuration. For an example of a configuration file using the plain
+configuration language, see [[file:~/usr/jao/xmobar/xmobar/examples/xmobar.config][examples/xmobar.config]], and you can have a look at
+[[../examples/xmobar.hs][examples/xmobar.hs]] for an example of how to write your own xmobar using
+Haskell.
 
 * Command Line Options
 
@@ -404,6 +402,63 @@ available [[https://codeberg.org/xmobar/xmobar/src/branch/master/examples/xmobar
    See below.
 
 * Runtime behaviour
+** Running xmobar in text mode
+   :PROPERTIES:
+   :CUSTOM_ID: text-mode
+   :END:
+
+   By default, xmobar will run as an X11 application, in a docked window, but
+   it is possible to redirect xmobar's output to the standard output,
+   optionally with color escape sequences.  In this mode, xmobar can be run
+   inside a terminal o console, or its output piped to other applications, and
+   there is no need for an X11 display (so, for instance, you could pipe
+   xmobar's output to a Wayland application, such as swaybar.)
+
+   To run xmobar in text mode, either pass the =-T= flag to its
+   invocation:
+
+   #+begin_src shell
+     xmobar -T /path/to/config &
+   #+end_src
+
+   or set the parameter =textOutput= to True in its configuration.  You
+   can also specify the format of color escapes, for instance,
+   omitting them altogether with ~Plain~:
+
+   #+begin_src shell
+     xmobar -TPlain /path/to/config &
+   #+end_src
+
+   Other options are ~Ansi~, ~Pango~, and ~Swaybar~.
+** Using xmobar in wayland with swaybar or waybar
+   :PROPERTIES:
+   :CUSTOM_ID: wayland
+   :END:
+
+   In text mode, xmobar can be told to ouput its information using
+   pango markup for colors and fonts, and it that way you can use it
+   with swaybar or waybar, if you don't have actions or boxes in your
+   template.  Here's a minimal ~bar~ configuration for sway's
+   configuration file:
+
+   #+begin_src conf
+     bar {
+     status_command xmobar -TPango
+     pango_markup enabled
+     }
+   #+end_src
+
+   In case you want to use boxes around text or click actions in your
+   template, you can use instead the format ~Swaybar~, which supports
+   both.  This output format follows the JSON /swaybar-protocol/
+   defined by swaybar.  Configure it simply with:
+
+   #+begin_src conf
+     bar {
+     status_command xmobar -TSwaybar
+     }
+   #+end_src
+
 ** Running xmobar with =i3status=
 
    xmobar can be used to display information generated by [[http://i3wm.org/i3status/][i3status]], a small
diff --git a/readme.org b/readme.org
index bf48e10..64d86d4 100644
--- a/readme.org
+++ b/readme.org
@@ -121,56 +121,13 @@ channel, ~#xmobar~, at [[ircs://irc.libera.chat][Libera]].
 
 ** Running xmobar in text mode
 
-   By default, xmobar will run as an X11 application, in a docked
-   window, but it is possible to redirect xmobar's to the standard
-   output, optionally with color escape sequences.  In this mode,
-   xmobar can be run inside a terminal o console, or its output piped
-   to other applications, and there is no need for an X11 display
-   (so, for instance, you could pipe xmobar's output to a Wayland
-   application, such as swaybar.)
-
-   To run xmobar in text mode, either pass the =-T= flag to its
-   invocation:
-
-   #+begin_src shell
-     xmobar -T /path/to/config &
-   #+end_src
-
-   or set the parameter =textOutput= to True in its configuration.  You
-   can also specify the format of color escapes, for instance,
-   omitting them altogether with ~Plain~:
-
-   #+begin_src shell
-     xmobar -TPlain /path/to/config &
-   #+end_src
-
-   Other options are ~Ansi~, ~Pango~, and ~Swaybar~.
-
-** Using xmobar in Wayland with swaybar or waybar
-
-   In text mode, xmobar can be told to ouput its information using
-   pango markup for colors and fonts, and it that way you can use it
-   with swaybar or waybar, if you don't have actions or boxes in your
-   template.  Here's a minimal ~bar~ configuration for sway's
-   configuration file:
-
-   #+begin_src conf
-     bar {
-     status_command xmobar -TPango
-     pango_markup enabled
-     }
-   #+end_src
-
-   In case you want to use boxes around text or click actions in your
-   template, you can use instead the format ~Swaybar~, which supports
-   both.  This output format follows the JSON /swaybar-protocol/
-   defined by swaybar.  Configure it simply with:
-
-   #+begin_src conf
-     bar {
-     status_command xmobar -TSwaybar
-     }
-   #+end_src
+   By default, xmobar will run as an X11 application, in a docked window, but
+   it is possible to redirect xmobar's output to the standard output,
+   optionally with color escape sequences.  In this mode, xmobar can be run
+   inside a terminal o console, or its output piped to other applications, and
+   there is no need for an X11 display.  See [[file:doc/quick-start.org#text-mode][Running xmobar in text mode]] for
+   details.  Using this mode, you could [[file:doc/quick-start.org#wayland][pipe xmobar's output to, say, swaybar]],
+   and use it in wayland.
 
 * Configuration and further documentation
 
@@ -180,7 +137,7 @@ channel, ~#xmobar~, at [[ircs://irc.libera.chat][Libera]].
   - If you want to get a detailed overview of all available plugins and
     monitors, visit the [[./doc/plugins.org][plugins index]].
 
-  - For elaborated examples of how to use xmobar as a Haskell library see the
+  - For more information on how to use xmobar as a Haskell library see the
     [[file:doc/using-haskell.org][using Haskell docs]].
 
   - If you want to know how to contribute to the xmobar project, check out