info: navegar por manuales GNU y buscar en sus índices

Linux

info es un lector de manuales en formato Info, usados por numerosos programas GNU. Permite recorrer nodos, seguir menús y referencias y buscar en índices. Comparte con man el propósito de consultar documentación instalada, pero utiliza otro formato y otra navegación.

En programas con documentación extensa como GNU Coreutils, los documentos Info suelen organizar con más detalle conceptos, interacciones de opciones y ejemplos. Este artículo explica cómo abrir documentos, moverse entre nodos y menús, buscar en el contenido o índice, ir directamente a una ubicación específica del documento y cómo solucionar problemas si no existe el documento.

¿Qué es el comando info?

info es un visor de documentos basado en texto que lee archivos Info creados con el sistema de documentos Texinfo. Normalmente, los archivos Info se instalan en directorios como /usr/share/info, y un manual se divide en varios nodos que forman una estructura jerárquica.

Los documentos Info pueden incluir menús para moverse a subtemas, referencias cruzadas que apuntan a otros nodos o manuales y un índice por tema. Son útiles no solo para leer los elementos en orden, sino también para seguir explicaciones relacionadas o buscar términos en el índice.

Sintaxis básica y cómo empezar

La sintaxis básica de GNU Info es la siguiente. Los corchetes indican opciones y los puntos suspensivos significan que se pueden especificar varios elementos, por lo que no se deben escribir en el comando real.

info [OPCIONES...] [MANUAL] [ELEMENTO-DE-MENÚ-O-ÍNDICE...]

Si se ejecuta sin argumentos, se abre el menú del directorio superior que reúne los documentos Info registrados en el sistema.

info

El manual de uso general de info y el manual detallado de Info independiente de GNU se pueden abrir de la siguiente manera.

info info
info info-stnd

Si se especifica el nombre de un programa en particular, se buscarán los elementos relacionados en el directorio superior y se accederá a su manual o nodo correspondiente.

info ls
info coreutils

info ls puede abrir, en lugar de un archivo ls.info independiente, el nodo relativo a ls dentro del manual de GNU Coreutils. Una entrada del directorio principal puede apuntar directamente a un nodo concreto de un manual.

Comprender la estructura de los documentos Info

Al ejecutarlo por primera vez, puede sentirse complejo debido a la terminología diferente de una página web común o de man. Entender los siguientes cuatro conceptos facilita la comprensión de la estructura del documento.

Terminología	Significado
Nodo (Node)	La unidad de página que forma un documento Info. A menudo corresponde a un capítulo o sección.
Menú (Menu)	Es una lista que permite moverse a subtemas o elementos relacionados del nodo actual.
Referencia cruzada (Xref)	Es un enlace que apunta a otro nodo relacionado con la descripción actual o a otro manual de Info.
Nodo de directorio	Es el menú principal que muestra varios manuales de Info registrados en el sistema, clasificados.

En la parte superior de la pantalla se pueden mostrar el archivo y el nombre del nodo actuales, así como destinos de navegación como Next, Prev, Up. En la línea de modo inferior se muestra el estado del manual y nodo actuales, y la posición en el documento.

Teclas utilizadas para mover la pantalla y explorar documentos

A continuación se muestra una tabla basada en las teclas predeterminadas de GNU Info independiente. Al usar configuraciones personalizadas o la opción --vi-keys, algunas teclas pueden diferir.

Tecla	Funcionamiento
`Space`	Se mueve a la siguiente pantalla y, al final del nodo, puede continuar moviéndose al siguiente nodo.
`Backspace`, `Delete`	Se moverá a la pantalla anterior. La tecla que funciona puede variar según el terminal.
`n`	Ir al nodo `Next` del nodo actual.
`p`	Ir al nodo `Prev` del nodo actual.
`u`	Avanza al nodo `Up` un nivel más arriba.
`t`	Actualmente, vaya al nodo `Top` del archivo Info.
`d`	Vaya al nodo del directorio que contiene los manuales instalados.
`l`	Vuelve al nodo que se veía anteriormente en el registro de visitas.
`m`	Introduce un nombre para seleccionar el elemento del menú del nodo actual.
`Tab`, `Shift+Tab`	Mueve el cursor al siguiente o anterior elemento del menú o referencia cruzada en la pantalla.
`Enter`	Abre el elemento del menú o la referencia cruzada sobre la que está colocado el cursor.
`H`	Abre la ventana de ayuda que resume las teclas básicas.
`h`	Ve al nodo de ayuda que explica el uso de Info.
`q`	Salir de Info.

La primera vez que lo utilice, es recomendable abrir info info-stnd, luego presionar H para verificar las teclas básicas y leer el documento con Space y Backspace.

Cómo seguir menús y referencias cruzadas

Seleccionar elementos en la pantalla con Tab y Enter

Si un menú o referencia cruzada aparece en la pantalla, puede moverse entre los elementos con Tab y seleccionarlos con Enter. Shift+Tab vuelve al elemento anterior. Este es el método de navegación más intuitivo cuando aún no se conoce la estructura del documento.

Ingresar el nombre del menú con m

Al presionar m, puede ingresar el nombre del elemento del menú en el área de entrada en la parte inferior de la pantalla. Después de ingresar solo una parte, puede verificar los elementos que se pueden completar con Tab, lo cual es útil para moverse rápidamente en menús largos.

Para volver a la posición original después de leer otros documentos siguiendo el menú, use l. Si desea moverse a un nodo superior en la estructura, debe usar u en lugar del historial de visitas.

Cómo buscar contenido deseado dentro del documento

Buscar cadenas en el texto principal

Al presionar s o / e ingresar un término de búsqueda, se busca la cadena en el archivo Info actual. Las palabras clave que no contienen mayúsculas no distinguen entre mayúsculas y minúsculas por defecto; si contienen mayúsculas, sí se distingue.

? busca hacia atrás. Ctrl+S realiza una búsqueda incremental hacia delante y Ctrl+R, hacia atrás. En GNU Info, s y / interpretan expresiones regulares por defecto; una mayúscula en el patrón activa la distinción de mayúsculas. Compruebe la ayuda de su configuración si utiliza teclas personalizadas.

Buscar temas en el índice

i busca el término ingresado en el índice del manual actual y se mueve al nodo señalado por la primera coincidencia. Puede ser más rápido y preciso que buscar en todo el texto cuando se busca un nombre de opción o un concepto en manuales largos.

I muestra las entradas coincidentes del índice en nodos virtuales. Después de la búsqueda i, al presionar la tecla coma (,) se puede ir a la siguiente coincidencia del índice.

Buscar en todos los índices de Info instalados

Si no se sabe en qué manual está la explicación, se utilizan las opciones -k o --apropos desde la shell. Esto busca en el índice de todos los archivos Info instalados, por lo que si hay muchos documentos, puede llevar tiempo.

info -k permissions
info --apropos='regular expression'

Ir directamente a un manual y nodo específicos

Abrir por nombre de manual o programa

Si conoce el nombre del manual, puede especificarlo directamente. Para abrir la documentación completa de GNU Coreutils, haga lo siguiente:

info coreutils

Si los elementos por programa están registrados en el directorio raíz, puede ir directamente al nodo correspondiente dentro del manual solo con el nombre del programa.

info ls
info cp
info date

Estos comandos asumen un entorno donde GNU Coreutils está instalado y los elementos del directorio Info están registrados correctamente.

Especificar el nombre del nodo

Puede especificar el nodo inicial con -n o --node. Si el nombre del nodo contiene espacios, encierre el nombre entre comillas para que se pase como un solo argumento en el shell.

info coreutils -n 'ls invocation'

También es posible especificar (MANUAL)NODO, que es el formato de referencia cruzada de Info, como un solo argumento. Encierre todo entre comillas para evitar que los paréntesis y los espacios sean interpretados por el shell.

info '(coreutils)ls invocation'

El nombre del nodo puede variar según la versión del documento instalada. Si no conoce el nombre exacto, es más seguro primero ir a info ls o buscar en el índice.

Encontrar el nodo que explica cómo ejecutar un comando

-O, --show-options o --usage buscan nodos de Invocación que expliquen cómo ejecutar en línea de comandos el programa especificado.

info ls -O
info --show-options coreutils

Dependiendo de la estructura del documento, puede que no se encuentre un nodo de Invocación adecuado. En ese caso, abra info PROGRAMA y use la búsqueda de índice de i.

Opciones de info de uso frecuente

Las siguientes opciones se basan en GNU Info autónomo. Para ver todas las opciones de la versión instalada, consulte info --help o info info-stnd.

Opciones	Descripción
`-k TEXTO`, `--apropos=TEXTO`	Busca una cadena en el índice de todos los archivos Info instalados.
`-n NODO`, `--node=NODO`	Especifica el nodo que se visitará primero.
`-f MANUAL`, `--file=MANUAL`	Abre un archivo Info o un manual específico sin consultar las entradas del directorio.
`-w`, `--where`	Imprime la ruta del archivo Info seleccionado sin abrir el documento.
`-d RUTA`, `--directory=RUTA`	Agrega rutas de búsqueda de archivos Info. Puede especificarse varias veces.
`-o ARCHIVO`, `--output=ARCHIVO`	Imprime el contenido del nodo que se visitará en un archivo en lugar de una pantalla interactiva.
`--subnodes`	Úselo con `--output` para imprimir recursivamente los subnodos del menú.
`-O`, `--show-options`	Busca el nodo que trata del uso de la línea de comandos del programa.
`--vi-keys`	Reasigna algunas teclas de una manera más cercana a vi y Less.
`--version`	Imprime la versión del Info instalado.

Verificación de la ubicación del archivo Info y salida de texto

Verificar los archivos de documentos realmente seleccionados

-w muestra la ubicación del archivo seleccionado en Info sin abrir el documento. Puede verificar qué documento se lee cuando hay varios archivos con el mismo nombre en diferentes rutas de búsqueda.

info -w coreutils

En un entorno que admite todas las rutas de archivos coincidentes, se puede usar junto con --all.

info --all --where coreutils

Exportar el documento a un archivo de texto

-o guarda los nodos seleccionados en un archivo; --subnodes incluye recursivamente los nodos enlazados mediante menús. Use un nombre de salida nuevo en un directorio propio para evitar sobrescribir documentos. El contenido procede de los manuales instalados: no se descarga ni se actualiza automáticamente por este comando.

info --subnodes -o coreutils.txt coreutils

Si se especifica - como archivo de salida, se puede enviar a la salida estándar, lo que facilita la conexión con otros comandos.

info -o - coreutils | less

El manual completo puede ser muy grande, por lo que primero considere el tamaño del archivo y el alcance necesario. Si solo se necesita un nodo específico, es eficiente usarlo junto con -n.

Especificar documentos de usuario y rutas de búsqueda

Abrir archivos Info locales directamente

Los archivos Info en el directorio actual se pueden abrir especificando una ruta relativa. Si la ruta incluye una barra, se apuntará al archivo en esa ubicación y no en la ruta de búsqueda general.

info ./project.info
info -f ./project.info

Los archivos Info comprimidos también se pueden leer directamente si el formato es compatible con la implementación.

Especificar directorios de búsqueda adicionales

Puede agregar directorios donde buscar documentos mediante -d. Esto es útil para abrir temporalmente documentos de herramientas instaladas fuera de la ruta del sistema.

info -d /opt/example/share/info example

Las rutas de búsqueda persistentes pueden verse afectadas por la variable de entorno INFOPATH. Si establece el valor directamente, la forma de incluir las rutas predeterminadas puede cambiar, por lo que primero verifique el estado actual y los resultados de info -w MANUAL.

printf '%s\n' "$INFOPATH"
info -w info-stnd

Diferencias entre info y man

Clasificación	`info`	`man`
Estructura del documento	Documentos jerárquicos conectados mediante nodos, menús, referencias cruzadas e índices	Documentos lineales que generalmente se leen de arriba hacia abajo en una sola página
Uso adecuado	Cuando se leen profundamente conceptos, explicaciones por capítulos, ejemplos largos y temas relacionados	Cuando se necesita verificar rápidamente gramática, opciones, archivos y estados de salida
Objetivo principal	Software que proporciona programas GNU y documentos Texinfo	Comandos, archivos de configuración, llamadas al sistema, funciones de biblioteca, etc.
Métodos de navegación	Movimiento de menú y nodos y búsqueda de contenido e índice	Movimiento de pantalla del paginador y búsqueda de cadenas
Estado de instalación	Dependiendo del programa, puede que no haya un documento Info	Dependiendo del paquete, puede que no haya páginas de manual

No es necesario usar solo uno de los dos. Cuando se desea verificar rápidamente el significado de una opción, man o --help son cómodos, y cuando se desea ver a fondo la relación entre el concepto general y las opciones de un programa GNU, info es útil. Elija la herramienta adecuada según el formato de documentación proporcionado por el programa y el estado de instalación.

Cuando no hay info o no se puede encontrar el documento

Instalar el programa info

En una instalación mínima puede faltar el lector info. El siguiente bloque reúne alternativas: en Debian o Ubuntu use solo las dos primeras líneas de APT; en Fedora o Rocky Linux use la línea de DNF. La instalación requiere repositorios y permisos adecuados y no incorpora necesariamente todos los manuales de otros programas.

sudo apt update
sudo apt install info

sudo dnf install info

Dependiendo de la versión de la distribución y de la configuración del repositorio, el nombre del paquete puede variar; si no se instala, consulte los resultados de búsqueda de paquetes de esa distribución.

Verificar si se ha instalado el documento Info de un programa específico

Aunque exista el archivo ejecutable info, es posible que el manual deseado no esté instalado. Primero, consulte la lista principal y los resultados de búsqueda.

info
info -k 'PROGRAMA O TEMA'
info -w MANUAL

Si el programa principal y la documentación están en paquetes separados, debe buscar el paquete de documentación del programa en el gestor de paquetes de la distribución.

Cuando la documentación no se muestra en el menú del directorio

Si el archivo existe pero no está registrado en el directorio principal, se puede abrir especificando directamente la ruta o el archivo.

info -d /RUTA/ADICIONAL/DE/DOCUMENTOS MANUAL
info -f /RUTA/COMPLETA/MANUAL.info

Si instaló el software directamente desde el código fuente, también debe verificar si el proceso de instalación actualizó los archivos del directorio Info. Antes de modificar manualmente el registro de documentación del sistema, consulte primero el historial de instalación del paquete y las instrucciones de instalación del programa.

Orden de uso práctico

Verifique si el documento relacionado se abre con info PROGRAMA.
Verifique la ayuda de la tecla actual con H y explore la estructura con Space, n, p, u.
Seleccione los menús visibles en la pantalla con Tab y Enter o m.
Si conoce el término exacto, busque en el índice con i; para frases generales, busque en el texto con s o /.
Si no sabe qué manual es, busque en todo el índice instalado desde la shell con info -k PALABRA_CLAVE.
Si es un lugar que revisará repetidamente, indique directamente el nodo con -n o imprima el contenido necesario con -o.

Preguntas frecuentes

¿Cómo se cierra info?

Al presionar q se cerrará. Si no conoce la configuración actual de la tecla, puede presionar la tecla mayúscula H para ver la ayuda rápida.

Al presionar n, no se obtienen los resultados de búsqueda, sino que se va a otro documento.

En la configuración de teclas predeterminada, n no lleva a los resultados de búsqueda, sino al nodo Next del nodo actual. Para buscar en el cuerpo, use s o /, y para buscar en el índice, use i. Al usar --vi-keys, la asignación de teclas puede cambiar.

¿Cuál es la diferencia entre info ls y info coreutils?

info ls busca la entrada ls en el directorio raíz y va directamente al nodo relacionado, mientras que info coreutils abre la posición inicial del manual de Coreutils. Según la entrada del directorio instalado y la versión del documento, el nodo inicial real puede variar.

¿Todos los comandos tienen un documento Info?

No. Info es ampliamente utilizado por el proyecto GNU, pero no todos los programas de Linux ofrecen documentos Info. Si no hay documento Info, consulte man COMANDO, COMANDO --help o la documentación oficial del programa.

¿El documento Info siempre es más preciso que man?

No siempre es así. Cada proyecto tiene documentos estándar y métodos de actualización diferentes. Algunos proyectos, como GNU Coreutils, ofrecen el manual Info como un documento de referencia detallado, pero otros programas pueden priorizar las páginas man o la documentación web. Es recomendable comprobar tanto la versión del programa actualmente instalada como las indicaciones de la documentación oficial del proyecto.

Resumen

info permite explorar la documentación extensa de programas GNU a través de nodos, menús, referencias cruzadas e índices. Al principio, aprender solo info PROGRAMA, H, Space, n, p, u, i y q es suficiente para poder leer la mayoría de los documentos.

Es eficiente verificar rápidamente la sintaxis simple y las opciones con --help o man, y continuar con info cuando se necesiten los conceptos de fondo y los ejemplos. Para explorar otros comandos básicos, se puede consultar Lista y resumen de comandos de Linux.

Las reglas de navegación y exportación se detallan en Manual oficial GNU Stand-alone Info, Cómo ejecutar GNU Info y sus opciones y Manual oficial de GNU Coreutils.

Puede comprobar los paquetes del lector en Información del paquete info de Debian y Información del paquete info de Fedora.

Linux