Las páginas "man" no están muy bien diseñadas y a veces ni siquiera son útiles, ¿alternativas?

Question

Siempre pensé en escribir una utilidad bash llamada realmanque explicaría los comandos como en las páginas de manual, pero en lugar de ordenar los comandos en orden alfabético según las opciones que tiene el comando, simplemente daría ejemplos que el usuario promedio necesitaría.

Algunos comandos dan ejemplos, pero como las páginas de manual son construidas por diferentes personas, no existe un control central sobre cómo debería verse una página de manual en cuanto a legibilidad.

Tome una descripción de mancomo ejemplo.

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]

Es totalmente excesivo. Mi página de manual diría...

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

Tener que leer todas las opciones de un comando para encontrar la opción que usarían la mayoría de los usuarios no es muy constructivo.

Entonces mi pregunta es simple: ¿hay algún programa tipo "realman" disponible en Ubuntu a través de la línea de comando que esté más orientado al usuario que al administrador del sistema?

Answer 1

Es posible que lo que estás pidiendo no esté bien definido. No todos los comandos tienen "esa opción que usarían la mayoría de los usuarios".

Sin embargo, dijiste eso porque mante gustaría ver algo como:

Es un programa que te brinda más detalles de un comando.

Para obtener información como esa sobre comandos, utilice whatis. Esto resume las páginas de manual.

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

Esto todavía no le brinda ninguna información sobre las opciones de la línea de comandos para los comandos (pero tampoco lo hace "Es un programa que le brinda más detalles de un comando").

Si desea una cantidad intermedia de información, lo mejor podría ser buscar el comando en Internet. Puedes buscarlo en la web o incluso en Wikipedia. Muchos de los comandos más conocidos y utilizados tienen artículos de Wikipedia. Por ejemplo, consulte los artículos sobrels,man(sobre páginas de manual en general, pero incluye manconsejos de sintaxis),grep, yfsck.

Puede navegar por la web desde la línea de comandos, si lo desea, utilizando un navegador web que admita el modo de línea de comandos (comoenlaces2), o un navegador de línea de comandos únicamente (comolince).

Finalmente, tenga en cuenta que muchas utilidades de línea de comandos en Ubuntu provienen del proyecto GNU, que proporciona una documentación excelente. A menudo es más largo y detallado que las páginas del manual, pero es posible que lo encuentre mejor organizado. Y normalmente hay títulos descriptivos que le ayudan a encontrar información específica, en mi experiencia mucho más fácilmente que en muchas páginas de manual.

manuales GNUse puede encontrar aquí. (Recuerda notodoLas utilidades son utilidades GNU.) Muchos de los comandos más utilizados no aparecen por nombre, pero son parte dePrincipales utilidades de GNU. Los manuales de GNU se pueden ver en línea y también descargarse en varios formatos de archivo, algunos de los cuales son adecuados para verlos en la línea de comandos.