Documentation 0.1

# Common Content

Edición 0

###

### Dude McDude

My Org Best Div in the place
`dude.mcdude@myorg.org`

Copyright © 2009 Red Hat, Inc.

# aviso legal

Copyright © 2009 Red Hat, Inc.. This material may only be distributed subject to the terms and conditions set forth in the Open Publication License, V1.0, (the latest version is presently available at http://www.opencontent.org/openpub/).
Fedora and the Fedora Infinity Design logo are trademarks or registered trademarks of Red Hat, Inc., in the U.S. and other countries.
Red Hat and the Red Hat "Shadow Man" logo are registered trademarks of Red Hat Inc. in the United States and other countries.
All other trademarks and copyrights referred to are the property of their respective owners.
Documentation, as with software itself, may be subject to export control. Read about Fedora Project export controls at http://fedoraproject.org/wiki/Legal/Export.

# Preface

## 1. Convenciones del documento

Este manual utiliza varias convenciones para resaltar algunas palabras y frases y llamar la atención sobre ciertas partes específicas de información.
En ediciones PDF y de papel, este manual utiliza tipos de letra procedentes de Liberation Fonts. Liberation Fonts también se utilizan en ediciones de HTML si están instalados en su sistema. Si no, se muestran tipografías alternativas pero equivalentes. Nota: Red Hat Enterprise Linux 5 y siguientes incluyen Liberation Fonts predeterminadas.

### 1.1. Convenciones tipográficas

Se utilizan cuatro convenciones tipográficas para llamar la atención sobre palabras o frases específicas. Dichas convenciones y las circunstancias en que se aplican son las siguientes:
`Negrita monoespaciado`
Utilizada para resaltar la entrada del sistema, incluyendo comandos de shell, nombres de archivo y rutas. También se utiliza para resaltar teclas claves y combinaciones de teclas.

> Para ver el contenido del archivo `my_next_bestselling_novel` en su directorio actual de trabajo, escriba el comando `cat my_next_bestselling_novel` en el intérprete de comandos de shell y pulse Enter para ejecutar el comando.

Lo anterior incluye un nombre de archivo, un comando de shell y una tecla clave, todo en negrita-monoespaciado y distinguible gracias al contexto.
Las combinaciones de teclas se pueden distinguir de las teclas claves mediante el guión que conecta cada parte de una combinación de tecla. Por ejemplo:

> Pulse Enter para ejecutar el comando.
> Pulse Control+Alt+F1 para cambiar a la primera terminal virtual. Pulse Control+Alt+F7 para volver a su sesión de Ventanas-X.

La primera oración resalta la tecla clave determinada que se debe pulsar. La segunda resalta dos conjuntos de tres teclas claves, cada conjunto presionado simultáneamente.
Si el código fuente es discutido, nombres de clase, métodos, funciones, nombres de variables, y valores de retorno mencionados dentro de un párrafo serán presentados como lo anterior, en `Negrita-monoespaciado`. Por ejemplo:

> las clases de archivo relacionadas incluyen `filename` para sistema de archivos, `file` para archivos y `dir` para directorios. Cada clase tiene su propio conjunto asociado de permisos.

Negrita proporcional
Esta denota palabras o frases encontradas en un sistema, incluyendo nombres de aplicación; texto de cuadro de diálogo, botones etiquetados, etiquetas de cajilla de verificación y botón de radio; títulos de menú y títulos del sub-menú. Por ejemplo:

> Seleccionar Sistema > Preferencias > Ratón desde la barra del menú principal para lanzar Preferencias de Ratón. En la pestaña de Botones, haga clic en la cajilla ratón de mano izquierda y luego haga clic en Cerrar para cambiar el botón principal del ratón de la izquierda a la derecha (adecuando el ratón para la mano izquierda).
> Para insertar un caracter especial en un archivo gedit, seleccione desde la barra del menú principal Aplicaciones > Accesorios > Mapa de caracteres. Luego, desde la barra del menú elija Búsqueda > Hallar… mapa de caracteres, teclee el nombre del caracter en el campo de Búsqueda y haga clic en Siguiente. El caracter buscado se resaltará en la Tabla de caracteres. Haga doble clic en este caracter resaltado para colocarlo en el campo de Texto para copiar y luego haga clic en el botón de Copiar. Ahora regrese a su documento y elija Editar > Pegar desde la barra de menú de gedit.

El texto anterior incluye nombres de aplicación; nombres de menú de todo el sistema y elementos; nombres de menú de aplicaciones específicas y botones y texto hallados dentro de una interfaz GUI, todos presentados en negrita proporcional y distinguibles por contexto.
Observe la > abreviatura utilizada para indicar recorrido a través de un menú y sus sub-menúes. Esto es para evitar la dificultad de seguir el método 'Seleccionar Ratón desde el sub-menú Preferencias en el menú de Sistema de la barra de menú principal'.
``Itálicas-negrita monoespaciado`` o `Itálicas-negrita proporcional`
Negrita monoespaciado o Negrita proporcional, la adición de itálicas indica texto reemplazable o variable. Las itálicas denotan texto que usted no escribe literalmente o texto mostrado que cambia dependiendo de la circunstancia. Por ejemplo:

> Para conectar a una máquina remota utilizando ssh, teclee `ssh `nombredeusuario`@`dominio.nombre`` en un intérprete de comandos de shell. Si la máquina remota es `example.com` y su nombre de usuario en esa máquina es john, teclee `ssh john@example.com`.
> El comando `mount -o remount `file-system`` remonta el sistema de archivo llamado. Por ejemplo, para volver a montar el sistema de archivo `/home`, el comando es `mount -o remount /home`.
> Para ver la versión de un paquete actualmente instalado, utilice el comando `rpm -q `paquete``. Éste entregará el resultado siguiente: ``paquete-versión-lanzamiento``.

Observe las palabras en itálicas- negrita sobre — nombre de usuario, domain.name, sistema de archivo, paquete, versión y lanzamiento. Cada palabra es un marcador de posición, tanto para el texto que usted escriba al ejecutar un comando como para el texto mostrado por el sistema.
Aparte del uso estándar para presentar el título de un trabajo, las itálicas denotan el primer uso de un término nuevo e importante. Por ejemplo:

> cuando el servidor Apache HTTP acepta solicitudes, envía procesos hijos o hilos para manejarlos. Este grupo de procesos hijos o hilos se conoce como un server-pool. Bajo el servidor HTTP de Apache 2.0, la responsabilidad para crear o mantener estos server-pool se resume en un grupo de módulos llamado Módulos de multi-procesamiento (MPMs). A diferencia de otros módulos, sólo un módulo del grupo MPM puede ser cargado por el servidor HTTP de Apache.

### 1.2. Convenciones del documento

Dos, usualmente de varias líneas, los tipos de datos se distinguen visualmente del texto circundante.
Salida enviada a una terminal está establecida en tipo `romano monoespaciado` y presentada así:

    libros        Escritorio   documentación  borradores  mss    fotos   cosas  svn
    libros_tests  Escritorio1  descargas      imágenes  notas  scripts  svgs

Los listados de código fuente también se establecen en `romano monoespaciado`, pero se presentan y resaltan de la siguiente manera:

    package org.jboss.book.jca.ex1;

    import javax.naming.InitialContext;

    public class ExClient
    {
       public static void main(String args[])
           throws Exception
       {
          InitialContext iniCtx = new InitialContext();
          Object         ref    = iniCtx.lookup("EchoBean");
          EchoHome       home   = (EchoHome) ref;
          Echo           echo   = home.create();

          System.out.println("Created Echo");

          System.out.println("Echo.echo('Hello') = " + echo.echo("Hello"));
       }

    }

### 1.3. Notas y advertencias

Finalmente, utilizamos tres estilos visuales para llamar la atención sobre la información que de otro modo se podría pasar por alto.

## Nota

Una nota es una sugerencia, atajo o enfoque alternativo que se tiene a mano para la tarea. Ignorar una nota no debería tener consecuencias negativas, pero podría perderse de algunos trucos que pueden facilitarle las cosas.

## Importante

Los cuadros de importante dan detalles de cosas que se pueden pasar por alto fácilmente: cambios de configuración únicamente aplicables a la sesión actual, o servicios que necesitan reiniciarse antes de que se aplique una actualización. Ignorar estos cuadros de importante no ocasionará pérdida de datos, pero puede causar enfado y frustración.

## Advertencia

Las advertencias no deben ignorarse. Ignorarlas muy probablemente ocasionará pérdida de datos.

## 2. ¡Necesitamos sus comentarios!

Si encuentra un error tipográfico en este manual o si sabe de alguna manera de mejorarlo, nos gustaría escuchar sus sugerencias. Por favor complete un reporte en Bugzilla: http://bugzilla.redhat.com/bugzilla/ usando el producto Documentation.
Cuando envíe un reporte de error no olvide mencionar el identificador del manual: Common_Content
Si tiene una sugerencia para mejorar la documentación, intente ser tan específico como sea posible cuando describa su sugerencia. Si ha encontrado un error, por favor incluya el número de sección y parte del texto que rodea el error para que podamos encontrarlo más fácilmente.