Recientemente di un taller sobre herramientas de Linux y les he estado diciendo a los estudiantes que consulten las páginas de comando de manual si encuentran errores.
Sin embargo, noté que el comando en sí nunca devuelve un mensaje para ver la página del manual con el mancomando.
La mayoría de los comandos recomiendan usar la --helpopción, usar la infopágina, una propaganda sobre el uso o simplemente imprimir el mensaje de error.
Me pregunto por qué ningún comando pide al usuario que consulte la página de manual. ¿No sería ese el primer lugar al que acudir cuando se utiliza incorrectamente?
Respuesta1
Alláesuna razón objetiva para ello.
--helpes un indicador integrado en la propia utilidad: integrado en el ejecutable binario o, si es un script, integrado en el script.
Las páginas de manual se almacenan por separado en el sistema de archivos del propio ejecutable.
Es posible que falten páginas de manual y que el ejecutable aún esté accesible.
Como desarrollador de utilidades, indicar a los usuarios un recurso de documentación quepuede o puede que noestar presente en su sistema tiene menos sentido que incluir la información en el código mismo.
No solamente eso, perola versión del ejecutable y la versión de la página de manual pueden alinearse o no.
Me encontré con esto, por ejemplo, cuando se envió una versión de Postgres con un determinado paquete y también se instaló una versión diferente de Postgres en el sistema. man psqlmostraría información paraunoversión, pero no era la versión que realmente obtuviste al ejecutar psql. Si no hubiera ninguna --helpbandera, habría tenido un gran misterio por qué ciertas opciones no funcionaban según la página de manual.
Respuesta2
Esto está sujeto a opinión porque probablemente no haya estadísticas sobre cómo se presentan los consejos en los mensajes de error.
El vínculo predominante que he visto es imprimir el mensaje de uso (que puede tener más de una línea), tal vez porque era innecesario decirle a alguien que leyera la página del manual. Decirle a alguien que lea el --helpmensaje es redundante y sólo una pequeña fracción recomienda leer la página de información.
Todos los programas que he desarrollado proporcionan un mensaje de uso (normalmente varias líneas).