mirror of
https://github.com/nix-community/home-manager
synced 2024-06-23 15:08:31 +02:00
treewide: convert options with lists to Markdown
`nix-doc-munge` can't handle these, which is understandable as I can barely handle them either. There are a few infelicities here: the current processor can't handle multiple terms to one description in a description list so they get comma-separated in one case, and one case that should ideally render as a `<figure>` with a `<figcaption>` in HTML is reduced to a paragraph with some `<strong>` text. (Which, in fairness, is how it rendered in practice with the DocBook anyway.) The docs generator has since been updated to handle figures, but we can't use it until moving off DocBook output.
This commit is contained in:
Emily
parent
9e4a73c25e
commit
21c700d14b
|
|
@ -31,47 +31,33 @@ in {
|
|||
(types.enum [ "fcitx" "fcitx5" "nabi" "uim" "hime" "kime" ]);
|
||||
default = null;
|
||||
example = "fcitx5";
|
||||
description = ''
|
||||
Select the enabled input method. Input methods is a software to input
|
||||
description = lib.mdDoc ''
|
||||
Select the enabled input method. Input methods are software to input
|
||||
symbols that are not available on standard input devices.
|
||||
</para><para>
|
||||
Input methods are specially used to input Chinese, Japanese and Korean
|
||||
characters.
|
||||
</para><para>
|
||||
|
||||
Input methods are especially used to input Chinese, Japanese and
|
||||
Korean characters.
|
||||
|
||||
Currently the following input methods are available in Home Manager:
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>fcitx5</literal></term>
|
||||
<listitem><para>
|
||||
A customizable lightweight input method.
|
||||
The next generation of fcitx,
|
||||
addons (including engines, dictionaries, skins) can be added using
|
||||
<literal>i18n.inputMethod.fcitx5.addons</literal>.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>nabi</literal></term>
|
||||
<listitem><para>
|
||||
A Korean input method based on XIM. Nabi doesn't support Qt 5.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>uim</literal></term>
|
||||
<listitem><para>
|
||||
The universal input method, is a library with a XIM bridge.
|
||||
uim mainly support Chinese, Japanese and Korean.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>hime</literal></term>
|
||||
<listitem><para>An extremely easy-to-use input method framework.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>kime</literal></term>
|
||||
<listitem><para>A Korean IME.</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
`fcitx5`
|
||||
: A customizable lightweight input method.
|
||||
The next generation of fcitx.
|
||||
Addons (including engines, dictionaries, skins) can be added using
|
||||
[](#opt-i18n.inputMethod.fcitx5.addons).
|
||||
|
||||
`nabi`
|
||||
: A Korean input method based on XIM. Nabi doesn't support Qt 5.
|
||||
|
||||
`uim`
|
||||
: The "universal input method" is a library with an XIM bridge.
|
||||
uim mainly supports Chinese, Japanese and Korean.
|
||||
|
||||
`hime`
|
||||
: An extremely easy-to-use input method framework.
|
||||
|
||||
`kime`
|
||||
: A Korean IME.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -57,46 +57,25 @@ in
|
|||
display = mkOption {
|
||||
type = types.enum [ "silent" "notify" "show" ];
|
||||
default = "notify";
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
How unread and relevant news should be presented when
|
||||
running <command>home-manager build</command> and
|
||||
<command>home-manager switch</command>.
|
||||
|
||||
</para><para>
|
||||
running {command}`home-manager build` and
|
||||
{command}`home-manager switch`.
|
||||
|
||||
The options are
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>silent</literal></term>
|
||||
<listitem>
|
||||
<para>
|
||||
Do not print anything during build or switch. The
|
||||
<command>home-manager news</command> command still
|
||||
works for viewing the entries.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>notify</literal></term>
|
||||
<listitem>
|
||||
<para>
|
||||
The number of unread and relevant news entries will be
|
||||
printed to standard output. The <command>home-manager
|
||||
news</command> command can later be used to view the
|
||||
entries.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>show</literal></term>
|
||||
<listitem>
|
||||
<para>
|
||||
A pager showing unread news entries is opened.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
`silent`
|
||||
: Do not print anything during build or switch. The
|
||||
{command}`home-manager news` command still
|
||||
works for viewing the entries.
|
||||
|
||||
`notify`
|
||||
: The number of unread and relevant news entries will be
|
||||
printed to standard output. The {command}`home-manager
|
||||
news` command can later be used to view the entries.
|
||||
|
||||
`show`
|
||||
: A pager showing unread news entries is opened.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -55,35 +55,27 @@ in {
|
|||
[ "libsForQt5" "plasma-integration" ]
|
||||
[ "libsForQt5" "systemsettings" ]
|
||||
];
|
||||
description = ''
|
||||
Platform theme to use for Qt applications.</para>
|
||||
<para>The options are
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>gtk</literal></term>
|
||||
<listitem><para>Use GTK theme with
|
||||
<link xlink:href="https://github.com/qt/qtstyleplugins">qtstyleplugins</link>
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>gnome</literal></term>
|
||||
<listitem><para>Use GNOME theme with
|
||||
<link xlink:href="https://github.com/FedoraQt/QGnomePlatform">qgnomeplatform</link>
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>qtct</literal></term>
|
||||
<listitem><para>Use Qt style set using
|
||||
<link xlink:href="https://github.com/desktop-app/qt5ct">qt5ct</link>
|
||||
and
|
||||
<link xlink:href="https://github.com/trialuser02/qt6ct">qt6ct</link>
|
||||
applications</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>kde</literal></term>
|
||||
<listitem><para>Use Qt settings from Plasma</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
description = lib.mdDoc ''
|
||||
Platform theme to use for Qt applications.
|
||||
|
||||
The options are
|
||||
|
||||
`gtk`
|
||||
: Use GTK theme with
|
||||
[`qtstyleplugins`](https://github.com/qt/qtstyleplugins)
|
||||
|
||||
`gnome`
|
||||
: Use GNOME theme with
|
||||
[`qgnomeplatform`](https://github.com/FedoraQt/QGnomePlatform)
|
||||
|
||||
`qtct`
|
||||
: Use Qt style set using
|
||||
[`qt5ct`](https://github.com/desktop-app/qt5ct)
|
||||
and [`qt6ct`](https://github.com/trialuser02/qt6ct)
|
||||
applications
|
||||
|
||||
`kde`
|
||||
: Use Qt settings from Plasma
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
@ -100,45 +92,26 @@ in {
|
|||
[ "libsForQt5" "qtstyleplugin-kvantum" ]
|
||||
[ "qt6Packages" "qtstyleplugin-kvantum" ]
|
||||
];
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Style to use for Qt5/Qt6 applications. Case-insensitive.
|
||||
</para>
|
||||
<para>Some examples are
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>adwaita</literal></term>
|
||||
<term><literal>adwaita-dark</literal></term>
|
||||
<term><literal>adwaita-highcontrast</literal></term>
|
||||
<term><literal>adwaita-highcontrastinverse</literal></term>
|
||||
<listitem><para>Use the Adwaita style from
|
||||
<link xlink:href="https://github.com/FedoraQt/adwaita-qt">adwaita</link>
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>breeze</literal></term>
|
||||
<listitem><para>Use the Breeze style from
|
||||
<link xlink:href="https://github.com/KDE/breeze">breeze</link>
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>bb10bright</literal></term>
|
||||
<term><literal>bb10dark</literal></term>
|
||||
<term><literal>cde</literal></term>
|
||||
<term><literal>cleanlooks</literal></term>
|
||||
<term><literal>gtk2</literal></term>
|
||||
<term><literal>motif</literal></term>
|
||||
<term><literal>plastique</literal></term>
|
||||
<listitem><para>Use styles from
|
||||
<link xlink:href="https://github.com/qt/qtstyleplugins">qtstyleplugins</link>
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>kvantum</literal></term>
|
||||
<listitem><para>Use styles from
|
||||
<link xlink:href="https://github.com/tsujan/Kvantum">kvantum</link>
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
Some examples are
|
||||
|
||||
`adwaita`, `adwaita-dark`, `adwaita-highcontrast`, `adwaita-highcontrastinverse`
|
||||
: Use the Adwaita style from
|
||||
[`adwaita-qt`](https://github.com/FedoraQt/adwaita-qt)
|
||||
|
||||
`breeze`
|
||||
: Use the Breeze style from
|
||||
[`breeze`](https://github.com/KDE/breeze)
|
||||
|
||||
`bb10bright`, `bb10dark`, `cde`, `cleanlooks`, `gtk2`, `motif`, `plastique`
|
||||
: Use styles from
|
||||
[`qtstyleplugins`](https://github.com/qt/qtstyleplugins)
|
||||
|
||||
`kvantum`
|
||||
: Use styles from
|
||||
[`kvantum`](https://github.com/tsujan/Kvantum)
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -79,15 +79,20 @@ in {
|
|||
};
|
||||
example =
|
||||
"nvim-qt -- -c 'set ft=mail' '+set fileencoding=utf-8' '+set ff=unix' '+set enc=utf-8' '+set fo+=w' %1";
|
||||
description = ''
|
||||
You can use <code>%1</code>, <code>%2</code>, and
|
||||
<code>%3</code> to refer respectively to:
|
||||
<orderedlist numeration="arabic">
|
||||
<listitem><para>file name</para></listitem>
|
||||
<listitem><para>server name</para></listitem>
|
||||
<listitem><para>socket ID</para></listitem>
|
||||
</orderedlist>
|
||||
See <link xlink:href='https://github.com/astroidmail/astroid/wiki/Customizing-editor' />.
|
||||
description = lib.mdDoc ''
|
||||
You can use the following variables:
|
||||
|
||||
`%1`
|
||||
: file name
|
||||
|
||||
`%2`
|
||||
: server name
|
||||
|
||||
`%3`
|
||||
: socket ID
|
||||
|
||||
See [Customizing editor](https://github.com/astroidmail/astroid/wiki/Customizing-editor)
|
||||
on the Astroid wiki.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -30,44 +30,33 @@ let
|
|||
}
|
||||
]
|
||||
'';
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Define new verbs. For more information, see
|
||||
<link xlink:href="https://dystroy.org/broot/documentation/configuration/#verb-definition-attributes"/>.
|
||||
</para><para>
|
||||
The possible attributes are:
|
||||
</para>
|
||||
[Verb Definition Attributes](https://dystroy.org/broot/documentation/configuration/#verb-definition-attributes)
|
||||
in the broot documentation.
|
||||
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>invocation</literal> (optional)</term>
|
||||
<listitem><para>how the verb is called by the user, with placeholders for arguments</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>execution</literal> (mandatory)</term>
|
||||
<listitem><para>how the verb is executed</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>key</literal> (optional)</term>
|
||||
<listitem><para>a keyboard key triggering execution</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>shortcut</literal> (optional)</term>
|
||||
<listitem><para>an alternate way to call the verb (without
|
||||
the arguments part)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>leave_broot</literal> (optional)</term>
|
||||
<listitem><para>whether to quit broot on execution
|
||||
(default: <literal>true</literal>)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>from_shell</literal> (optional)</term>
|
||||
<listitem><para>whether the verb must be executed from the
|
||||
parent shell (default:
|
||||
<literal>false</literal>)</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
The possible attributes are:
|
||||
|
||||
`invocation` (optional)
|
||||
: how the verb is called by the user, with placeholders for arguments
|
||||
|
||||
`execution` (mandatory)
|
||||
: how the verb is executed
|
||||
|
||||
`key` (optional)
|
||||
: a keyboard key triggering execution
|
||||
|
||||
`shortcut` (optional)
|
||||
: an alternate way to call the verb (without
|
||||
the arguments part)
|
||||
|
||||
`leave_broot` (optional)
|
||||
: whether to quit broot on execution
|
||||
(default: `true`)
|
||||
|
||||
`from_shell` (optional)</term>
|
||||
: whether the verb must be executed from the
|
||||
parent shell (default: `false`)
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
@ -92,38 +81,35 @@ let
|
|||
code_fg = "lightyellow";
|
||||
}
|
||||
'';
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Color configuration.
|
||||
</para><para>
|
||||
|
||||
Complete list of keys (expected to change before the v1 of broot):
|
||||
|
||||
<itemizedlist>
|
||||
<listitem><para><literal>char_match</literal></para></listitem>
|
||||
<listitem><para><literal>code</literal></para></listitem>
|
||||
<listitem><para><literal>directory</literal></para></listitem>
|
||||
<listitem><para><literal>exe</literal></para></listitem>
|
||||
<listitem><para><literal>file</literal></para></listitem>
|
||||
<listitem><para><literal>file_error</literal></para></listitem>
|
||||
<listitem><para><literal>flag_label</literal></para></listitem>
|
||||
<listitem><para><literal>flag_value</literal></para></listitem>
|
||||
<listitem><para><literal>input</literal></para></listitem>
|
||||
<listitem><para><literal>link</literal></para></listitem>
|
||||
<listitem><para><literal>permissions</literal></para></listitem>
|
||||
<listitem><para><literal>selected_line</literal></para></listitem>
|
||||
<listitem><para><literal>size_bar_full</literal></para></listitem>
|
||||
<listitem><para><literal>size_bar_void</literal></para></listitem>
|
||||
<listitem><para><literal>size_text</literal></para></listitem>
|
||||
<listitem><para><literal>spinner</literal></para></listitem>
|
||||
<listitem><para><literal>status_error</literal></para></listitem>
|
||||
<listitem><para><literal>status_normal</literal></para></listitem>
|
||||
<listitem><para><literal>table_border</literal></para></listitem>
|
||||
<listitem><para><literal>tree</literal></para></listitem>
|
||||
<listitem><para><literal>unlisted</literal></para></listitem>
|
||||
</itemizedlist></para>
|
||||
* `char_match`
|
||||
* `code`
|
||||
* `directory`
|
||||
* `exe`
|
||||
* `file`
|
||||
* `file_error`
|
||||
* `flag_label`
|
||||
* `flag_value`
|
||||
* `input`
|
||||
* `link`
|
||||
* `permissions`
|
||||
* `selected_line`
|
||||
* `size_bar_full`
|
||||
* `size_bar_void`
|
||||
* `size_text`
|
||||
* `spinner`
|
||||
* `status_error`
|
||||
* `status_normal`
|
||||
* `table_border`
|
||||
* `tree`
|
||||
* `unlisted`
|
||||
|
||||
<para>
|
||||
Add <literal>_fg</literal> for a foreground color and
|
||||
<literal>_bg</literal> for a background colors.
|
||||
Add `_fg` for a foreground color and
|
||||
`_bg` for a background color.
|
||||
'';
|
||||
};
|
||||
};
|
||||
|
|
|
|||
|
|
@ -148,42 +148,24 @@ let
|
|||
backspaceBinding = mkOption {
|
||||
default = "ascii-delete";
|
||||
type = eraseBinding;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Which string the terminal should send to an application when the user
|
||||
presses the <emphasis>Backspace</emphasis> key.
|
||||
presses the *Backspace* key.
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>auto</literal></term>
|
||||
<listitem><para>
|
||||
Attempt to determine the right value from the terminal's IO settings.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>ascii-backspace</literal></term>
|
||||
<listitem><para>
|
||||
Send an ASCII backspace character (0x08).
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>ascii-delete</literal></term>
|
||||
<listitem><para>
|
||||
Send an ASCII delete character (0x7F).
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>delete-sequence</literal></term>
|
||||
<listitem><para>
|
||||
Send the <quote>@7</quote> control sequence.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>tty</literal></term>
|
||||
<listitem><para>
|
||||
Send terminal’s <quote>erase</quote> setting.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
`auto`
|
||||
: Attempt to determine the right value from the terminal's IO settings.
|
||||
|
||||
`ascii-backspace`
|
||||
: Send an ASCII backspace character (`0x08`).
|
||||
|
||||
`ascii-delete`
|
||||
: Send an ASCII delete character (`0x7F`).
|
||||
|
||||
`delete-sequence`
|
||||
: Send the `@7` control sequence.
|
||||
|
||||
`tty`
|
||||
: Send terminal's "erase" setting.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
@ -196,42 +178,24 @@ let
|
|||
deleteBinding = mkOption {
|
||||
default = "delete-sequence";
|
||||
type = eraseBinding;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Which string the terminal should send to an application when the user
|
||||
presses the <emphasis>Delete</emphasis> key.
|
||||
presses the *Delete* key.
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>auto</literal></term>
|
||||
<listitem><para>
|
||||
Send the <quote>@7</quote> control sequence.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>ascii-backspace</literal></term>
|
||||
<listitem><para>
|
||||
Send an ASCII backspace character (0x08).
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>ascii-delete</literal></term>
|
||||
<listitem><para>
|
||||
Send an ASCII delete character (0x7F).
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>delete-sequence</literal></term>
|
||||
<listitem><para>
|
||||
Send the <quote>@7</quote> control sequence.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>tty</literal></term>
|
||||
<listitem><para>
|
||||
Send terminal’s <quote>erase</quote> setting.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
`auto`
|
||||
: Send the `@7` control sequence.
|
||||
|
||||
`ascii-backspace`
|
||||
: Send an ASCII backspace character (`0x08`).
|
||||
|
||||
`ascii-delete`
|
||||
: Send an ASCII delete character (`0x7F`).
|
||||
|
||||
`delete-sequence`
|
||||
: Send the `@7` control sequence.
|
||||
|
||||
`tty`
|
||||
: Send terminal's "erase" setting.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -62,34 +62,27 @@ let
|
|||
}.${v}
|
||||
else
|
||||
v;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
The amount of trust you have in the key ownership and the care the
|
||||
owner puts into signing other keys. The available levels are
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>unknown</literal> or <literal>1</literal></term>
|
||||
<listitem><para>I don't know or won't say.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>never</literal> or <literal>2</literal></term>
|
||||
<listitem><para>I do NOT trust.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>marginal</literal> or <literal>3</literal></term>
|
||||
<listitem><para>I trust marginally.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>full</literal> or <literal>4</literal></term>
|
||||
<listitem><para>I trust fully.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>ultimate</literal> or <literal>5</literal></term>
|
||||
<listitem><para>I trust ultimately.</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para><para>
|
||||
See <link xlink:href="https://www.gnupg.org/gph/en/manual/x334.html"/>
|
||||
for more.
|
||||
|
||||
`unknown` or `1`
|
||||
: I don't know or won't say.
|
||||
|
||||
`never` or `2`
|
||||
: I do **not** trust.
|
||||
|
||||
`marginal` or `3`
|
||||
: I trust marginally.
|
||||
|
||||
`full` or `4`
|
||||
: I trust fully.
|
||||
|
||||
`ultimate` or `5`
|
||||
: I trust ultimately.
|
||||
|
||||
See the [Key Management chapter](https://www.gnupg.org/gph/en/manual/x334.html)
|
||||
of the GNU Privacy Handbook for more.
|
||||
'';
|
||||
};
|
||||
};
|
||||
|
|
|
|||
|
|
@ -73,48 +73,35 @@ let
|
|||
loginMethod = mkOption {
|
||||
type = nullOr (enum (attrNames loginMethodMap));
|
||||
default = null;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
The login method. The allowed options are:
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>null</literal></term>
|
||||
<listitem><para>Default</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"nickServMsg"</literal></term>
|
||||
<listitem><para>NickServ (/MSG NickServ + password)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"nickServ"</literal></term>
|
||||
<listitem><para>NickServ (/NICKSERV + password)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"challengeAuth"</literal></term>
|
||||
<listitem><para>Challenge Auth (username + password)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"sasl"</literal></term>
|
||||
<listitem><para>SASL (username + password)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"serverPassword"</literal></term>
|
||||
<listitem><para>Server password (/PASS password)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"saslExternal"</literal></term>
|
||||
<listitem><para>SASL EXTERNAL (cert)</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>"customCommands"</literal></term>
|
||||
<listitem>
|
||||
<para>Use "commands" field for auth. For example
|
||||
<programlisting language="nix">
|
||||
commands = [ "/msg NickServ IDENTIFY my_password" ]
|
||||
</programlisting>
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
`null`
|
||||
: Default
|
||||
|
||||
`"nickServMsg"`
|
||||
: NickServ (`/MSG NickServ` + password)
|
||||
|
||||
`"nickServ"`
|
||||
: NickServ (`/NICKSERV` + password)
|
||||
|
||||
`"challengeAuth"`
|
||||
: Challenge Auth (username + password)
|
||||
|
||||
`"sasl"`
|
||||
: SASL (username + password)
|
||||
|
||||
`"serverPassword"`
|
||||
: Server password (`/PASS` password)
|
||||
|
||||
`"saslExternal"`
|
||||
: SASL EXTERNAL (cert)
|
||||
|
||||
`"customCommands"`
|
||||
: Use "commands" field for auth. For example
|
||||
```nix
|
||||
commands = [ "/msg NickServ IDENTIFY my_password" ]
|
||||
```
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
@ -293,25 +280,20 @@ in {
|
|||
overwriteConfigFiles = mkOption {
|
||||
type = nullOr bool;
|
||||
default = false;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Enables overwriting HexChat configuration files
|
||||
(<filename>hexchat.conf</filename>, <filename>servlist.conf</filename>).
|
||||
Any existing HexChat configuration will be lost. Certify to back-up any
|
||||
previous configuration before enabling this.
|
||||
</para><para>
|
||||
({file}`hexchat.conf`, {file}`servlist.conf`).
|
||||
Any existing HexChat configuration will be lost. Make sure to back up
|
||||
any previous configuration before enabling this.
|
||||
|
||||
Enabling this setting is recommended, because everytime HexChat
|
||||
application is closed it overwrites Nix/Home Manager provided
|
||||
configuration files, causing:
|
||||
<orderedlist numeration="arabic">
|
||||
<listitem><para>
|
||||
Nix/Home Manager provided configuration to be out of sync with
|
||||
actual active HexChat configuration.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Blocking Nix/Home Manager updates until configuration files are
|
||||
manually removed.
|
||||
</para></listitem>
|
||||
</orderedlist>
|
||||
|
||||
1. Nix/Home Manager provided configuration to be out of sync with
|
||||
actual active HexChat configuration.
|
||||
2. Nix/Home Manager updates to be blocked until configuration files are
|
||||
manually removed.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -133,111 +133,77 @@ in {
|
|||
keyBindings = mkOption {
|
||||
type = with types; attrsOf (attrsOf (separatedString " ;; "));
|
||||
default = { };
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Key bindings mapping keys to commands in different modes. This setting
|
||||
is a dictionary containing mode names and dictionaries mapping keys to
|
||||
commands: <literal>{mode: {key: command}}</literal> If you want to map
|
||||
a key to another key, check the <literal>keyMappings</literal> setting
|
||||
instead. For modifiers, you can use either <literal>-</literal> or
|
||||
<literal>+</literal> as delimiters, and these names:
|
||||
commands: `{mode: {key: command}}` If you want to map
|
||||
a key to another key, check the `keyMappings` setting
|
||||
instead. For modifiers, you can use either `-` or
|
||||
`+` as delimiters, and these names:
|
||||
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
Control: <literal>Control</literal>, <literal>Ctrl</literal>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Meta: <literal>Meta</literal>, <literal>Windows</literal>,
|
||||
<literal>Mod4</literal>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Alt: <literal>Alt</literal>, <literal>Mod1</literal>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Shift: <literal>Shift</literal>
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
Control
|
||||
: `Control`, `Ctrl`
|
||||
|
||||
For simple keys (no <literal><></literal>-signs), a capital
|
||||
Meta
|
||||
: `Meta`, `Windows`, `Mod4`
|
||||
|
||||
Alt
|
||||
: `Alt`, `Mod1`
|
||||
|
||||
Shift
|
||||
: `Shift`
|
||||
|
||||
For simple keys (no `<>`-signs), a capital
|
||||
letter means the key is pressed with Shift. For special keys (with
|
||||
<literal><></literal>-signs), you need to explicitly add
|
||||
<literal>Shift-</literal> to match a key pressed with shift. If you
|
||||
want a binding to do nothing, bind it to the <literal>nop</literal>
|
||||
`<>`-signs), you need to explicitly add
|
||||
`Shift-` to match a key pressed with shift. If you
|
||||
want a binding to do nothing, bind it to the `nop`
|
||||
command. If you want a default binding to be passed through to the
|
||||
website, bind it to null. Note that some commands which are only useful
|
||||
for bindings (but not used interactively) are hidden from the command
|
||||
completion. See <literal>:</literal>help for a full list of available
|
||||
completion. See `:help` for a full list of available
|
||||
commands. The following modes are available:
|
||||
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>normal</literal></term>
|
||||
<listitem><para>
|
||||
Default mode, where most commands are invoked.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>insert</literal></term>
|
||||
<listitem><para>
|
||||
Entered when an input field is focused on a website, or by
|
||||
pressing i in normal mode. Passes through almost all keypresses
|
||||
to the website, but has some bindings like
|
||||
<literal><Ctrl-e></literal> to open an external editor.
|
||||
Note that single keys can’t be bound in this mode.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>hint</literal></term>
|
||||
<listitem><para>
|
||||
Entered when f is pressed to select links with the keyboard. Note
|
||||
that single keys can’t be bound in this mode.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>passthrough</literal></term>
|
||||
<listitem><para>
|
||||
Similar to insert mode, but passes through all keypresses except
|
||||
<literal><Escape></literal> to leave the mode. It might be
|
||||
useful to bind <literal><Escape></literal> to some other
|
||||
key in this mode if you want to be able to send an Escape key to
|
||||
the website as well. Note that single keys can’t be bound in this
|
||||
mode.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>command</literal></term>
|
||||
<listitem><para>
|
||||
Entered when pressing the : key in order to enter a command. Note
|
||||
that single keys can’t be bound in this mode.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>prompt</literal></term>
|
||||
<listitem><para>
|
||||
Entered when there’s a prompt to display, like for download
|
||||
locations or when invoked from JavaScript.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>yesno</literal></term>
|
||||
<listitem><para>
|
||||
Entered when there’s a yes/no prompt displayed.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>caret</literal></term>
|
||||
<listitem><para>
|
||||
Entered when pressing the v mode, used to select text using the
|
||||
keyboard.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>register</literal></term>
|
||||
<listitem><para>
|
||||
Entered when qutebrowser is waiting for a register name/key for
|
||||
commands like <literal>:set-mark</literal>.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
`normal`
|
||||
: Default mode, where most commands are invoked.
|
||||
|
||||
`insert`
|
||||
: Entered when an input field is focused on a website, or by
|
||||
pressing `i` in normal mode. Passes through almost all keypresses
|
||||
to the website, but has some bindings like
|
||||
`<Ctrl-e>` to open an external editor.
|
||||
Note that single keys can't be bound in this mode.
|
||||
|
||||
`hint`
|
||||
: Entered when `f` is pressed to select links with the keyboard. Note
|
||||
that single keys can't be bound in this mode.
|
||||
|
||||
`passthrough`
|
||||
: Similar to insert mode, but passes through all keypresses except
|
||||
`<Escape>` to leave the mode. It might be
|
||||
useful to bind `<Escape>` to some other
|
||||
key in this mode if you want to be able to send an Escape key to
|
||||
the website as well. Note that single keys can't be bound in this
|
||||
mode.
|
||||
|
||||
`command`
|
||||
: Entered when pressing the `:` key in order to enter a command. Note
|
||||
that single keys can't be bound in this mode.
|
||||
|
||||
`prompt`
|
||||
: Entered when there's a prompt to display, like for download
|
||||
locations or when invoked from JavaScript.
|
||||
|
||||
`yesno`
|
||||
: Entered when there's a yes/no prompt displayed.
|
||||
|
||||
`caret`
|
||||
: Entered when pressing the `v` mode, used to select text using the
|
||||
keyboard.
|
||||
|
||||
`register`
|
||||
: Entered when qutebrowser is waiting for a register name/key for
|
||||
commands like `:set-mark`.
|
||||
'';
|
||||
example = literalExpression ''
|
||||
{
|
||||
|
|
|
|||
|
|
@ -72,26 +72,19 @@ in {
|
|||
tray = mkOption {
|
||||
type = types.enum [ "always" "auto" "never" ];
|
||||
default = "auto";
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Whether to display tray icon.
|
||||
</para><para>
|
||||
|
||||
The options are
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>always</literal></term>
|
||||
<listitem><para>Always show tray icon.</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>auto</literal></term>
|
||||
<listitem><para>
|
||||
Show tray icon only when there is a device available.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>never</literal></term>
|
||||
<listitem><para>Never show tray icon.</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
`always`
|
||||
: Always show tray icon.
|
||||
|
||||
`auto`
|
||||
: Show tray icon only when there is a device available.
|
||||
|
||||
`never`
|
||||
: Never show tray icon.
|
||||
'';
|
||||
};
|
||||
};
|
||||
|
|
|
|||
|
|
@ -363,18 +363,16 @@ in {
|
|||
type = types.bool;
|
||||
default = pkgs.stdenv.isLinux;
|
||||
example = false;
|
||||
description = ''
|
||||
Whether to enable <filename>sway-session.target</filename> on
|
||||
description = lib.mdDoc ''
|
||||
Whether to enable {file}`sway-session.target` on
|
||||
sway startup. This links to
|
||||
<filename>graphical-session.target</filename>.
|
||||
{file}`graphical-session.target`.
|
||||
Some important environment variables will be imported to systemd
|
||||
and dbus user environment before reaching the target, including
|
||||
<itemizedlist>
|
||||
<listitem><para><literal>DISPLAY</literal></para></listitem>
|
||||
<listitem><para><literal>WAYLAND_DISPLAY</literal></para></listitem>
|
||||
<listitem><para><literal>SWAYSOCK</literal></para></listitem>
|
||||
<listitem><para><literal>XDG_CURRENT_DESKTOP</literal></para></listitem>
|
||||
</itemizedlist>
|
||||
* {env}`DISPLAY`
|
||||
* {env}`WAYLAND_DISPLAY`
|
||||
* {env}`SWAYSOCK`
|
||||
* {env}`XDG_CURRENT_DESKTOP`
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -164,40 +164,29 @@ in {
|
|||
type = with types;
|
||||
either bool (enum [ "suggest" "legacy" "sd-switch" ]);
|
||||
apply = p: if isBool p then if p then "legacy" else "suggest" else p;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Whether new or changed services that are wanted by active targets
|
||||
should be started. Additionally, stop obsolete services from the
|
||||
previous generation.
|
||||
</para><para>
|
||||
|
||||
The alternatives are
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><literal>suggest</literal> (or <literal>false</literal>)</term>
|
||||
<listitem><para>
|
||||
Use a very simple shell script to print suggested
|
||||
<command>systemctl</command> commands to run. You will have to
|
||||
manually run those commands after the switch.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>legacy</literal> (or <literal>true</literal>)</term>
|
||||
<listitem><para>
|
||||
Use a Ruby script to, in a more robust fashion, determine the
|
||||
necessary changes and automatically run the
|
||||
<command>systemctl</command> commands.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>sd-switch</literal></term>
|
||||
<listitem><para>
|
||||
Use sd-switch, a third party application, to perform the service
|
||||
updates. This tool offers more features while having a small
|
||||
closure size. Note, it requires a fully functional user D-Bus
|
||||
session. Once tested and deemed sufficiently robust, this will
|
||||
become the default.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
|
||||
`suggest` (or `false`)
|
||||
: Use a very simple shell script to print suggested
|
||||
{command}`systemctl` commands to run. You will have to
|
||||
manually run those commands after the switch.
|
||||
|
||||
`legacy` (or `true`)
|
||||
: Use a Ruby script to, in a more robust fashion, determine the
|
||||
necessary changes and automatically run the
|
||||
{command}`systemctl` commands.
|
||||
|
||||
`sd-switch`
|
||||
: Use sd-switch, a third party application, to perform the service
|
||||
updates. This tool offers more features while having a small
|
||||
closure size. Note, it requires a fully functional user D-Bus
|
||||
session. Once tested and deemed sufficiently robust, this will
|
||||
become the default.
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
|
|
@ -174,23 +174,19 @@ in {
|
|||
OpenTmuxWindowsIn = mkNullableOption {
|
||||
type = types.int;
|
||||
example = 2;
|
||||
description = ''
|
||||
description = lib.mdDoc ''
|
||||
Configures how to restore tmux windows when attaching to a session.
|
||||
|
||||
<variablelist><title>Possible Values</title>
|
||||
<varlistentry>
|
||||
<term><literal>0</literal></term>
|
||||
<listitem><para>Native windows</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>1</literal></term>
|
||||
<listitem><para>Native tabs in a new window</para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><literal>2</literal></term>
|
||||
<listitem><para>Tabs in the attaching window</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
**Possible Values**
|
||||
|
||||
`0`
|
||||
: Native windows
|
||||
|
||||
`1`
|
||||
: Native tabs in a new window
|
||||
|
||||
`2`
|
||||
: Tabs in the attaching window
|
||||
'';
|
||||
};
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user