Como obtener ayuda en la terminal, para la mayoria de los humanos normales recordar todos los parámetros y los argumentos que tiene un comando es prácticamente imposible. Gracias a los que pensaron el sistema, el sistema operativo nos propone varias opciones, una de ellas es la ayuda rápida la otra es usar el comando help.
Obtener ayuda en la terminal nos permite saber cuales son los comandos internos de bash y aquellos que son comandos externos, de esta manera indirectamente vamos a seguir profundizando en el conocimiento, no solo de los comandos si no tambien del interprete de comandos.
En la mayoria de los comandos podemos obtener ayuda usando el parámetro –help. Vamos a un ejemplo supongamos que queremos saber la hora y el día entonces podemos utilizar el comando date.
$ date --help
Modo de empleo: date [OPCIÓN]... [+FORMATO]
o bien: date [-u|--utc|--universal] [MMDDhhmm[[SS]AA][.ss]]
Muestra la hora actual en el FORMATO dado, o establece la fecha del sistema.
Los argumentos obligatorios para las opciones largas son también obligatorios
para las opciones cortas.
-d, --date=STRING display time described by STRING, not 'now'
--debug annotate the parsed date,
and warn about questionable usage to stderr
-f, --file=DATEFILE like --date; once for each line of DATEFILE
-I[FMT], --iso-8601[=FMT] output date/time in ISO 8601 format.
FMT='date' for date only (the default),
'hours', 'minutes', 'seconds', or 'ns'
for date and time to the indicated precision.
Example: 2006-08-14T02:34:56-06:00
Cuando usamos el parámetro –help y queremos obtener ayuda el sistema nos muestra la ayuda incluida dentro del programa en este caso date.
En este caso la ayuda esta bastante bien explicada y no tiene una gran cantidad de información.
Que pasa si queremos obtener ayuda y el parámetro nos presenta el siguiente error:
$ cal --help
cal: opción incorrecta -- «-»
Usage: cal [general options] [-jy] [[month] year]
cal [general options] [-j] [-m month] [year]
ncal -C [general options] [-jy] [[month] year]
ncal -C [general options] [-j] [-m month] [year]
ncal [general options] [-bhJjpwySM] [-H yyyy-mm-dd] [-s country_code] [[month] year]
ncal [general options] [-bhJeoSM] [year]
General options: [-31] [-A months] [-B months] [-d yyyy-mm]
El comando nos informa que no tiene help incluido por lo tanto nos brinda directamente cual es la forma correcta de ejecutar el comando para esto voy a usar el comando interno pwd.
Obtener ayuda directamente desde el shell
Los comandos internos no aceptan el parámetro –-help, para estos casos el interprete de comandos nos brinda su propia ayuda, para esto nos propone el comando help. Si al comando help no le proporcionamos ningún parámetro, nos muestra la lista de comandos internos. Si al ejecutarlo le enviamos un parámetro en este caso el nombre de un comando interno, este nos muestra la ayuda correspondiente.
$ help pwd
pwd: pwd [-LP]
Muestra el nombre del directorio de trabajo actual.
Opciones:
-L muestra el valor de $PWD si nombra al directorio de
trabajo actual
-P muestra el directorio físico, sin enlaces simbólicos
Por defecto, `pwd' se comporta como si se especificara `-L'.
Estado de Salida:
Devuelve 0 a menos que se de una opción inválida o no se pueda leer
el directorio actual.
Enlaces:
Cuando comence a trabajar buscaba ayuda en http://es.tldp.org/
Otro enlace interesante es https://docs.oracle.com/cd/E19620-01/805-7644/6j76kloom/index.html
Tambien podes encontrar mas ayuda en este enlace: https://blog.carreralinux.com.ar/2018/09/ayuda-en-gnu-linux-1/