it-swarm-es.com

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

Siempre pensé en escribir una utilidad bash llamada realman que explicara los comandos como en las páginas del manual, pero en lugar de presentar los comandos en orden alfabético por las opciones que tiene el comando, simplemente daría ejemplos al usuario promedio necesitaría.

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

Tome una descripción de man como 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 exagerado. Mi página de manual leerí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 esa opción que la mayoría de los usuarios usarían no es muy constructiva.

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

3
Meer Borg

Lo que está pidiendo podría no estar bien definido. No todos los comandos tienen "esa opción que usarían la mayoría de los usuarios".

Sin embargo, dijiste que para man querrías ver algo como:

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

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

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

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

Si desea una cantidad intermedia de información, el mejor curso puede ser que busque el comando en Internet. Puede 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 sobre ls , man (sobre páginas de manual en general, pero incluye consejos sobre la sintaxis man ), grep , y fsck .

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 (como links2 Install links2 ), o un navegador de línea de comandos solamente (como lynx Install lynx ).

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

manuales de GN se puede encontrar aquí. (Recuerde que no todas las utilidades son GNU utilidades). Muchos de los comandos más utilizados no aparecen por nombre pero son parte de GNU coreutils . GNU manuales se pueden ver en línea y también se pueden descargar en varios formatos de archivo, algunos de los cuales son adecuados para ver en el línea de comando.

7
Eliah Kagan