página de manual
Una página de manual (abreviatura de página del manual ) es una forma de documentación de software que normalmente se encuentran en un Unix o Unix sistema operativo . Los temas cubiertos incluyen programas de computadora (incluidas las llamadas a la biblioteca y al sistema ), estándares y convenciones formales, e incluso conceptos abstractos. Un usuario puede invocar una página de manual emitiendo el man comando .
Las páginas de manual se denominan a menudo una forma en línea o en línea de documentación de software, [1] aunque el mancomando no requiere acceso a Internet, ya que se remonta a la época en que los manuales impresos fuera de banda eran la norma.
En los dos primeros años de la historia de Unix , no existía documentación. [2] El Manual del programador de Unix se publicó por primera vez el 3 de noviembre de 1971. Las primeras páginas de manual reales fueron escritas por Dennis Ritchie y Ken Thompson ante la insistencia [ cita requerida ] de su gerente Doug McIlroy en 1971. Aparte de las páginas de manual, el Manual del programador también acumuló una serie de artículos breves, algunos de ellos tutoriales (por ejemplo, para el uso general de Unix, el lenguaje de programación C y herramientas como Yacc) y otras descripciones más detalladas de las características del sistema operativo. La versión impresa del manual encajaba inicialmente en una sola carpeta, pero a partir de PWB / UNIX y la 7ª edición de Research Unix , se dividió en dos volúmenes con las páginas de manual impresas formando el Volumen 1. [3]
Las versiones posteriores de la documentación imitaron la concisión de las primeras páginas de manual. Ritchie agregó una sección "Cómo comenzar" a la introducción de la Tercera Edición , y Lorinda Cherry proporcionó la referencia de bolsillo "Tarjeta Púrpura" para las Ediciones Sexta y Séptima . [2] Las versiones del software recibieron el nombre de la revisión del manual; la séptima edición del Manual del programador de Unix , por ejemplo, vino con la séptima edición o la versión 7 de Unix. [4]
Para la Cuarta Edición, las páginas de manual se formatearon utilizando el paquete de composición tipográfica troff [2] y su conjunto de -manmacros (que fueron completamente revisadas entre la Sexta y la Séptima Ediciones del Manual , [3] pero no han cambiado drásticamente desde entonces). En ese momento, la disponibilidad de documentación en línea a través del sistema de página del manual se consideró un gran avance. Hasta el día de hoy, prácticamente todas las aplicaciones de línea de comandos de Unix vienen con una página de manual, y muchos usuarios de Unix perciben la falta de páginas de manual de un programa como una señal de baja calidad; de hecho, algunos proyectos, como Debian , se desviven por escribir páginas de manual para programas que carecen de una. Los descendientes modernos de 4.4BSDtambién distribuye páginas de manual como una de las formas principales de documentación del sistema (habiendo reemplazado las -manmacros antiguas por las más nuevas -mdoc).
Había un easter egg oculto en la versión man-db del comando man que haría que el comando devolviera "dame, dame, dame" cuando se ejecute a las 00:30 (una referencia a la canción de ABBA Gimme! Gimme! Gimme! (A Man Después de la medianoche) . Se introdujo en 2011 [5] pero primero se restringió [6] y luego se eliminó en 2017 [7] después de ser finalmente encontrado [8].
