mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-06-06 08:51:14 -03:00
help: get section titles from Sphinx
functions/help and completions/help duplicate a lot of information from doc_src. Get this information from Sphinx. Drop short section titles such as "help globbing" in favor of the full HTML anchor: help language#wildcards-globbing I think the verbosity is no big deal because we have tab completion, we're trading in conciseness for consistency and better searchability. In future, we can add back shorter invocations like "help globbing" (especially given that completion descriptions often already repeated the anchor path), but it should be checked by CI. Also - Remove some unused Sphinx anchors - Remove an obsoleted script. - Test that completions are in sync with Sphinx sources. (note that an alternative would be to check in the generated help_sections.rs file, see https://internals.rust-lang.org/t/how-fail-on-cargo-warning-warnings-from-build-rs/23590/5) Here's a list of deleted msgids. Some of them were unused, for others there was a better message (+ translation). $variable $variable 变量 (command) command substitution (命令) 命令替换 < and > redirections < 和 > 重定向 Autoloading functions 自动加载函数 Background jobs 后台作业 Builtin commands 内建命令 Combining different expansions 合并不同的展开 Command substitution (SUBCOMMAND) 命令替换 (子命令) Defining aliases 定义别名 Escaping characters 转义字符 Help on how to reuse previously entered commands 关于如何重复使用先前输入的命令的帮助 How lists combine 列表如何组合 Job control 作业控制 Local, global and universal scope 局域、全局和通用作用域 Other features 其他功能 Programmable prompt 可编程提示符 Shell variable and function names Shell 变量和函数名 Some common words 一些常用词 The status variable 状况变量 Variable scope for functions 函数的变量作用域 Vi mode commands Vi 模式命令 What set -x does `set -x` 做什么 Writing your own completions 自己写补全 ifs and elses if 和 else var[x..y] slices var[x..y] 切片 {a,b} brace expansion {a,b} 大括号展开 ~ expansion ~ 展开 Closes #11796
This commit is contained in:
@@ -58,7 +58,7 @@ You can also write your own completions or install some you got from someone els
|
||||
|
||||
Completion scripts are loaded on demand, like :ref:`functions are <syntax-function-autoloading>`. The difference is the ``$fish_complete_path`` :ref:`list <variables-lists>` is used instead of ``$fish_function_path``. Typically you can drop new completions in ~/.config/fish/completions/name-of-command.fish and fish will find them automatically.
|
||||
|
||||
.. _color:
|
||||
.. _syntax-highlighting:
|
||||
|
||||
Syntax highlighting
|
||||
-------------------
|
||||
@@ -145,8 +145,6 @@ If a variable isn't set or is empty, fish usually tries ``$fish_color_normal``,
|
||||
- For ``$fish_color_valid_path``, if that doesn't have a color, but only modifiers, it adds those to the color that would otherwise be used,
|
||||
like ``$fish_color_param``. But if valid paths have a color, it uses that and adds in modifiers from the other color.
|
||||
|
||||
.. _variables-color-pager:
|
||||
|
||||
Pager color variables
|
||||
^^^^^^^^^^^^^^^^^^^^^^^
|
||||
|
||||
@@ -236,8 +234,6 @@ You can also change these functions yourself by running ``funced fish_prompt`` a
|
||||
|
||||
.. [#] The web interface runs purely locally on your computer and requires python to be installed.
|
||||
|
||||
.. _greeting:
|
||||
|
||||
Configurable greeting
|
||||
---------------------
|
||||
|
||||
@@ -257,8 +253,6 @@ or you can script it by changing the function::
|
||||
|
||||
save this in config.fish or :ref:`a function file <syntax-function-autoloading>`. You can also use :doc:`funced <cmds/funced>` and :doc:`funcsave <cmds/funcsave>` to edit it easily.
|
||||
|
||||
.. _title:
|
||||
|
||||
Programmable title
|
||||
------------------
|
||||
|
||||
@@ -566,8 +560,6 @@ Visual mode
|
||||
|
||||
- :kbd:`",*,y` copies the selection to the clipboard, and enters :ref:`command mode <vi-mode-command>`.
|
||||
|
||||
.. _custom-binds:
|
||||
|
||||
Custom bindings
|
||||
^^^^^^^^^^^^^^^
|
||||
|
||||
|
||||
Reference in New Issue
Block a user