Guía Info de Gentoo

1.  Introducción

¿Qué es info?

La mayoría de los usuarios conoce el sistema de documentación man. Mientras que man es bueno para buscar algo rápidamente, le falta estructura, al no poder enlazar entre sí las páginas man. Es aquí donde entra en juego info. Las páginas info son creadas con las herramientas texinfo y pueden enlazarse con otras páginas, crear menús y facilitar la navegación en general. En la siguiente sección veremos como se estructuran las páginas info.

Estructura de las páginas info

Las principales páginas info se encuentran en /usr/share/info. A diferencia de la estructura de man, /usr/share/info contiene una colección de archivos bastante extensa. Estos archivos tienen el siguiente formato:

pagename.info[-node].gz

pagename es el nombre de la página (por ejemplo: wget). [-node] es una estructura opcional, que designa un nivel adicional de nodos (generalmente serán llamados desde el nivel más alto (toplevel) del documento info en cuestión). Para ahorrar espacio estas páginas info se comprimen con gzip. Páginas info adicionales pueden ser listadas usando la variable de entorno INFOPATH (normalmente configurado a través de los distintos archivos en /etc/env.d/). Para empezar, es importante notar el archivo /usr/share/info/dir. Este archivo especial se usa al ejecutar info sin parámetros. Contiene una lista de todas la páginas info disponibles para navegar. Para comenzar, ejecutaremos el comando sin parámetros:

$ info

En el siguiente capítulo veremos cómo manejar la navegación básica en info.

2.  Trabajando con páginas info

Navegando con los menús

Ahora que hemos iniciado info, tendremos una pantalla similar a esta:

File: dir,      Node: Top       This is the top of the INFO tree

  This (the Directory node) gives a menu of major topics.
  Typing "q" exits, "?" lists all Info commands, "d" returns here,
  "h" gives a primer for first-timers,
  "mEmacs<Return>" visits the Emacs manual, etc.

  In Emacs, you can click mouse button 2 on a menu item or cross reference
  to select it.

* Menu:

User Interface Toolkit
* GDK: (gdk).           The General Drawing Kit
* GTK: (gtk).           The GIMP Toolkit

GNU programming tools
* Autoconf v2.1: (autoconf).         Create source code configuration scripts.

Hay varias entradas precedidas por un asterisco. Estos son los ítems del menu para navegar los distintos niveles de nodos. Hay dos maneras de seleccionar los menús. Veremos la primera ahora y la otra más adelante. Primero, buscaremos y miraremos la página info de wget. Para hacerlo, bajemos usando la flecha hacia abajo del teclado hasta llegar al área indicado por el fondo azul:

Network Applications
* GnuTLS: (gnutls).                     Package for Transport Layer Security.
* Wget: (wget).         The non-interactive network downloader.
* certtool: (gnutls)Invoking certtool.  Manipulate certificates and keys.
* gnutls-cli: (gnutls)Invoking gnutls-cli.      GNU TLS test client.
* gnutls-cli-debug: (gnutls)Invoking gnutls-cli-debug.  GNU TLS debug client.
* gnutls-serv: (gnutls)Invoking gnutls-serv.    GNU TLS test server.
* srptool: (gnutls)Invoking srptool.    Simple SRP password tool.

Una vez acá, pulse la tecla ENTER para seleccionar el ítem del menú. Esto traerá la página info de wget:

File: wget.info,  Node: Top,  Next: Overview,  Up: (dir)

Wget 1.10.2
***********

This manual documents version 1.10.2 of GNU Wget, the freely available
utility for network downloads.

   Copyright (C) 1996-2005 Free Software Foundation, Inc.

* Menu:

* Overview::            Features of Wget.
* Invoking::            Wget command-line arguments.
* Recursive Download::  Downloading interlinked pages.
* Following Links::     The available methods of chasing links.
* Time-Stamping::       Mirroring according to time-stamps.
* Startup File::        Wget's initialization file.

Ahora que tenemos una página info, la siguiente sección nos mostrará cómo es la navegación básica.

Navegación básica

Hablando en términos de nodos, éste sería el nodo superior o Top de la página de wget. Considere que el nodo Top es la tabla de contenidos o índice para esa página info. Ahora, a navegar a la página en sí, para lo cual disponemos de un par de métodos distintos. Primero, el método standard de info usando la tecla SPACE (barra espaciadora) para adelantar y la tecla BACKSPACE/DELETE (borrar) para volver atrás una página. Esta es la manera recomendada ya que adelanta/devuelve al nodo apropiado del documento, permitiendo una navegación algo linear para los acostumbrados a las páginas man. Otra manera es usando las teclas PAGE UP/PAGE DOWN. Estas funcionan, aunque no avanzarán/retrocederán igual a las teclas SPACE/BACKSPACE/DELETE. Si desea saltar nodos enteros sin usar SPACE/BACKSPACE/DELETE puede también usar la tecla [ (retroceder) y la tecla ] (avanzar).

Como mencionamos antes, hay dos manera de navegar los menús. La otra manera es usando los números 1-9, saltar a los novenos de las entradas del menú de un documento. Funciona para hacer un barrido rápido a través de documentos. Por ejemplo, usaremos el 3 para llegar a la entrada de menú Recursive Download. Pulse 3 y llegará en seguida a la pantalla Recursive Download:

File: wget.info,  Node: Recursive Download,  Next: Following Links,  Prev: Invoking,  Up: Top

3 Recursive Download
********************

GNU Wget is capable of traversing parts of the Web (or a single HTTP or
FTP server), following links and directory structure.  We refer to this
as to "recursive retrieval", or "recursion".

Ya que estamos en la pantalla Recursive Download, aprovechamos para notar un par de cosas. Primero el encabezado, que muestra las posibilidades de navegación disponibles desde esta pantalla. Podemos tener acceso a la página indicada por Next: (siguiente) pulsando la tecla n, y la página indicada por Prev: (previa) con la tecla p. Por favor note que esto solo funciona al mismo nivel. Si lo usa demasiado podría terminar mirando un contenido nada relacionado. Es preferible utilizar SPACE/BACKSPACE/DELETE/[/] para navegar linearmente.

Si por alguna razón se pierde, existen unas cuantas maneras para salirse. Primero la tecla t, que lo llevará directamente a la tabla de contenidos en el nivel superior de la página que está navegando. Si desea regresar a la última página vista, puede hacerlo con la tecla l. Si quiere subir un nivel, hágalo con la tecla u key. Ahora que hemos visto algunas ideas para navegar una página info, el capítulo siguiente investigará cómo buscar contenido. content.

3.  Buscando en info

Navegando a otras páginas info

Ahora que sabemos como navegar en una página info individual, es importante ver cómo obtener acceso a otras páginas info. La primera y más obvia manera es ir a ella a través del listado principal de páginas info dir. Para llegar a dir desde las profundidades de un documento, pulse la d. Entonces, desde allí puede buscar la página apropiada. Sin embargo, si conoce la página, hay una manera más fácil, usando el comando Goto node (tecla g). Para ir a una página info por nombre, escriba g para el indicador y allí podrá escribir el nombre de la página entre paréntesis:

* Startup File::        Wget's initialization file.
* Examples::            Examples of usage.
* Various::             The stuff that doesn't fit anywhere else.
* Appendices::          Some useful references.
* Copying::             You may give out copies of Wget and of this manual.
--zz-Info: (wget.info.gz)Top, 24 lines --Top-------------------------------
Goto node: (libc)

Buscaremos la página de libc, como se muestra a continuación:

File: libc.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)

Main Menu
*********

This is Edition 0.10, last updated 2001-07-06, of `The GNU C Library
Reference Manual', for Version 2.3.x of the GNU C Library.

* Menu:

* Introduction::                 Purpose of the GNU C Library.

Ahora que sabemos buscar páginas info por nombre, veremos en la siguiente sección cómo buscar información usando el índice de páginas info.

Buscando usando el índice

En este ejemplo, veremos como buscar la función printf de la librería c usando el índice de la página info de libc. Debería estar todavía en la página info de libc info, desde la sección pasada, si no, hágalo con el comando Goto node. Para buscar a través del índice, pulse la tecla i para obtener el indicador e ingrese el término deseado. Así haremos para printf:

* Character Set Handling::       Support for extended character sets.
* Locales::                      The country and language can affect the
                                   behavior of library functions.
* Message Translation::          How to make the program speak the user's
                                   language.
--zz-Info: (libc.info.gz)Top, 1291 lines --Top-- Subfile: libc.info-1.gz-----
Index entry: printf

Luego de pulsar enter al completar el término a buscar, estaremos ante la definición de libc para printf:

File: libc.info,  Node: Formatted Output Functions,  Next: Dynamic Output,  Prev: Other Output Conversions,  Up: Formatted Output

12.12.7 Formatted Output Functions
----------------------------------

This section describes how to call `printf' and related functions.
Prototypes for these functions are in the header file `stdio.h'.
Because these functions take a variable number of arguments, you _must_
declare prototypes for them before using them.  Of course, the easiest
way to make sure you have all the right prototypes is to just include

Ahora hemos tenido éxito buscando un término en la página índice de libc. Sin embargo, a veces lo que buscamos se encuentra dentro de la página misma. A continuación buscaremos dentro del texto de la página.

Buscando con el comando search

Comenzando desde la ubicación reciente, del nodo Formatted Output Functions, buscaremos la variante sprintf de la función printf. Para realizar una búsqueda, pulse la tecla s para obtener el indicador e ingrese el término (en este caso, sprintf):

 -- Function: int wprintf (const wchar_t *TEMPLATE, ...)
     The `wprintf' function prints the optional arguments under the
     control of the wide template string TEMPLATE to the stream
     `stdout'.  It returns the number of wide characters printed, or a
--zz-Info: (libc.info.gz)Formatted Output Functions, 127 lines --Top-- Subfile: libc.info-3.gz--
Search for string []: sprintf

Pulse ENTER y verá el resultado:

-- Function: int sprintf (char *S, const char *TEMPLATE, ...)
     This is like `printf', except that the output is stored in the
     character array S instead of written to a stream.  A null
     character is written to mark the end of the string.

     The `sprintf' function returns the number of characters stored in
     the array S, not including the terminating null character.

Y tendremos la información acerca de la función que necesitamos.

4.  Conclusión

Conclusión

Esto concluye el tour sobre el uso y navegación de las páginas info. Como siempre, damos la bienvenida y apreciamos cualquier comentario. Hacer clic sobre mi nombre (Chris White) a la derecha me enviará un correo electrónico.

Recursos adicionales

Para facilitar las cosas a los que deseen navegar las páginas info con un interfaz gráfico, existen los siguientes recursos:

• app-text/info2html - convierte las páginas info a un formato HTML navegable
• app-text/pinfo - un visualizador info basado en ncurses
• app-text/tkinfo - un navegador info basado en tcl/tk
• app-vim/info - un navegador info basado en vim

El navegador Konqueror de KDE también permite navegar páginas info precediendo los URI con info: .

El contenido de este documento, a no ser que se especifique expresamente, está registrado bajo los términos de la licencia CC-BY-SA-2.5. Se aplican las Pautas de Utilización del logotipo y nombre de Gentoo.