¿Cuál es la diferencia entre la documentación de "hombre" e "información"?


92

En cuanto a las páginas de manual y la documentación de ayuda de información:

¿Por qué existen dos fuentes similares de documentación?
A veces hay una página de manual disponible y la información no; o viceversa.
Todavía no me he aferrado a la rima y la razón detrás de ella.

Quizás haya una diferencia significativa entre ellos, pero incluso si la hay, ¿por qué ambos existen? Parece una duplicación innecesaria.


1
GNU-Info Bad, Man (1) Bueno de 2003 lectura divertida. Flat is better than nested.
n611x007

Intenta hacer info infoy man info. man infoMuestra ejemplos coloridos. Soy una persona más visual, usar el mismo color me da sueño. La sintaxis del hombre con un poco de color lo hace comprensible rápidamente.
randominstanceOfLivingThing

Respuestas:


80

Las páginas man son la forma tradicional de UNIX de distribuir documentación sobre programas. El término "página de manual" en sí es la abreviatura de "página de manual", ya que corresponden a las páginas del manual impreso; Las "secciones" de las páginas man (1 para comandos, 2 para llamadas al sistema, etc.) corresponden a secciones en el manual completo de UNIX. El soporte técnico sigue ahí si desea imprimir una página de manual en papel, aunque esto rara vez se hace en estos días, y la gran cantidad de páginas de manual hace que sea imposible unirlas en un solo libro.

A principios de los años 90, el proyecto GNU decidió que el sistema de documentación "man" estaba desactualizado, y escribió el comando info para reemplazarlo: info tiene características básicas de hipervínculos y un lenguaje de marcado más simple de usar (en comparación con el sistema "troff" utilizado para páginas man). Además, GNU defiende en absoluto el uso de páginas de manual y afirma que los sistemas de software complejos deben tener una documentación completa y completa en lugar de solo un conjunto de páginas de manual cortas.

En realidad, hay otros sistemas de documentación en uso, además de man e info : GNOME y KDE tienen su propio sistema basado en HTML, etc.

Al final, la forma en que obtiene la documentación depende de las políticas internas del proyecto que proporcionó el software en primer lugar; no existe un estándar aceptado a nivel mundial.


14
inforealmente nunca despegó, ¿verdad?
UncleZeiv

99
@UncleZeiv: se ejecuta infosin parámetros para tener una idea de cuántas aplicaciones usan documentación en formato de información.
JanC

24

Info es el formato predeterminado para la documentación dentro del proyecto GNU, man es el formato tradicional mucho más antiguo para UNIX.

Info utiliza Texinfo como su formato fuente, que es un conjunto de macros para TeX, y eso hace que sea mucho más fácil crear también versiones impresas o PDF "atractivas".

En general, las páginas de manual son más sobre 1 tema específico (un comando, un archivo de configuración, una función del sistema, ...) mientras que la información normalmente tiene más la estructura de un manual combinado, más como un libro.


14

man usa menos para mostrar la página del manual que a su vez usa las combinaciones de teclas vim, mientras que la información usa las combinaciones de teclas emacs y los comandos estándar de emacs para buscar, salir, etc.


3
El tema de las combinaciones de teclas es interesante (así que busqué en Google) ... Parece que infotiene una opción de combinaciones de teclas VI: --vi-keys (Use las combinaciones de teclas similares a vi y menos similares ) ... $ alias info = 'info - vi-keys '... tal vez?
Peter.O
Al usar nuestro sitio, usted reconoce que ha leído y comprende nuestra Política de Cookies y Política de Privacidad.
Licensed under cc by-sa 3.0 with attribution required.