「手冊」頁面的佈局不是很好,有時甚至沒有幫助,有替代方案嗎?

「手冊」頁面的佈局不是很好,有時甚至沒有幫助,有替代方案嗎?

我一直想編寫一個名為 的 bash 實用程序realman,它可以像手冊頁中那樣解釋命令,但它不會按照命令具有的選項按字母順序排列命令,而是簡單地給出普通用戶需要的示例。

有些指令確實給出了範例,但由於手冊頁是由不同的人建構的,因此無法集中控製手冊頁的可讀性。

以描述man為例

NAME
       man - an interface to the on-line reference manuals

SYNOPSIS
       man  [-C  file]  [-d]  [-D] [--warnings[=warnings]] [-R encoding] [-L locale] [-m system[,...]] [-M path] [-S list] [-e extension] [-i|-I] [--regex|--wildcard]
       [--names-only] [-a] [-u] [--no-subpages] [-P pager] [-r prompt] [-7] [-E  encoding]  [--no-hyphenation]  [--no-justification]  [-p  string]  [-t]  [-T[device]]
       [-H[browser]] [-X[dpi]] [-Z] [[section] page ...] ...
       man -k [apropos options] regexp ...
       man -K [-w|-W] [-S list] [-i|-I] [--regex] [section] term ...
       man -f [whatis options] page ...
       man  -l  [-C  file]  [-d]  [-D]  [--warnings[=warnings]]  [-R  encoding]  [-L  locale]  [-P pager] [-r prompt] [-7] [-E encoding] [-p string] [-t] [-T[device]]
       [-H[browser]] [-X[dpi]] [-Z] file ...
       man -w|-W [-C file] [-d] [-D] page ...
       man -c [-C file] [-d] [-D] page ...
       man [-hV]

這完全是多餘的。我的手冊頁將顯示...

Its a program gives you more details of a command.
eg. "man bash" would explain more about the command "bash"

必須通讀命令的所有選項才能找到大多數使用者會使用的選項,這並不是很有建設性。

所以我的問題很簡單,Ubuntu 中是否有一個透過命令列提供的「真正的」類型的程序,它更面向用戶,而不是面向系統管理員?

答案1

您所要求的可能沒有明確定義。並非每個命令都有「大多數使用者會使用的選項」。

但是,您說您man希望看到類似的內容:

它是一個程序,為您提供命令的更多詳細資訊。

有關命令的信息,請使用whatis.這總結了手冊頁。

ek@Kip:~$ whatis man
man (7)              - macros to format man pages
man (1)              - an interface to the on-line reference manuals
ek@Kip:~$ whatis whatis
whatis (1)           - display manual page descriptions
ek@Kip:~$ whatis ls
ls (1)               - list directory contents
LS (6)               - display animations aimed to correct users who accident...
ek@Kip:~$ whatis ping
ping (8)             - send ICMP ECHO_REQUEST to network hosts

這仍然不會為您提供有關命令的命令列選項的任何資訊(但話又說回來,「這是一個為您提供命令的更多詳細資訊的程式」)。

如果您需要中等數量的信息,最好的方法可能是在 Internet 上查找該命令。您可以在網路上搜尋它,甚至可以在維基百科上搜尋。許多最著名、最常用的指令都有維基百科文章。例如,請參考以下文章ls,man(關於一般的線上幫助頁,但包括man文法建議),grep, 和fsck

如果您願意,您可以使用支援命令列模式的 Web 瀏覽器(例如連結2安裝連結2),或僅命令列瀏覽器(例如山貓安裝山貓)。

最後,請注意 Ubuntu 中的許多命令列實用程式都來自 GNU 項目,該專案提供了優秀的文件。通常它比手冊頁更長、更詳細,但您可能會發現它組織得更好。通常有描述性標題可以幫助您找到特定訊息,根據我的經驗,這比許多線上幫助頁更容易。

GNU 手冊可以在這裡找到。 (記住不是全部實用程式是 GNU 實用程式。GNU 核心工具。 GNU 手冊可以在線上查看,也可以以各種文件格式下載,其中一些非常適合在命令列上查看。

相關內容