mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-04-27 23:11:15 -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:
@@ -33,6 +33,7 @@ Synopsis
|
||||
status build-info
|
||||
status get-file FILE
|
||||
status list-files [PATH]
|
||||
status help-sections
|
||||
status terminal
|
||||
status test-terminal-feature FEATURE
|
||||
|
||||
@@ -125,6 +126,13 @@ The following operations (subcommands) are available:
|
||||
This lists the files embedded in the fish binary at compile time. Only files where the path starts with the optional *FILE* argument are shown.
|
||||
Returns 0 if something was printed, 1 otherwise.
|
||||
|
||||
**help-sections**
|
||||
NOTE: this subcommand is intended for fish's internal use.
|
||||
|
||||
List section arguments for the :doc:`help <help>` command.
|
||||
If you have the latest version of fish, these URL fragments are valid on `<https://fishshell.com/docs/current/>`__.
|
||||
Always returns 0.
|
||||
|
||||
.. _status-terminal:
|
||||
|
||||
**terminal**
|
||||
|
||||
Reference in New Issue
Block a user