[software-management-guide] Modificaciones para F15

Guillermo Gómez gomix at fedoraproject.org
Fri Jun 3 00:50:13 UTC 2011


commit 787bd402a29c027fb046828127a175623fc59adb
Author: Guillermo Gomez S. (Gomix) <guillermo.gomez at gmail.com>
Date:   Thu Jun 2 20:19:26 2011 -0430

    Modificaciones para F15

 es-ES/Book_Info.xml                              |    3 +-
 es-ES/Configuracion_de_YUM.xml                   |   16 ++-
 es-ES/Introduccion_a_la_gestion_del_software.xml |   10 ++-
 es-ES/Las_interfases_GUI_de_gnome-packagekit.xml |  116 +++++++++++++++-------
 es-ES/PackageKit_CLI.xml                         |   96 ++++++++++++++----
 es-ES/images/Gnome3-buscando-gpk-application.png |  Bin 315768 -> 0 bytes
 6 files changed, 173 insertions(+), 68 deletions(-)
---
diff --git a/es-ES/Book_Info.xml b/es-ES/Book_Info.xml
index c053dd9..fc8914e 100644
--- a/es-ES/Book_Info.xml
+++ b/es-ES/Book_Info.xml
@@ -11,8 +11,7 @@
 	<edition>1</edition>
 	<pubsnumber>0</pubsnumber>
 	<abstract>
-		<para>
-			Este manual está dedicado a la gestión del software en Fedora. El lector adquirirá las habilidades necesarias para poder instalar, remover y actualizar el software de su sistema. Este manual esta diseñado para todos los niveles de lectores, desde usuarios de escritorio Fedora, hasta administradores de sistemas y desarrolladores Fedora.
+		<para>Este manual está dedicado a la gestión del software en Fedora. El lector adquirirá las habilidades necesarias para poder instalar, remover y actualizar el software de su sistema. Este manual esta diseñado para todos los niveles de lectores, desde usuarios de escritorio Fedora, hasta administradores de sistemas y desarrolladores Fedora.
 		</para>
 	</abstract>
 	<corpauthor>
diff --git a/es-ES/Configuracion_de_YUM.xml b/es-ES/Configuracion_de_YUM.xml
index 4b4c2a0..56b3a24 100644
--- a/es-ES/Configuracion_de_YUM.xml
+++ b/es-ES/Configuracion_de_YUM.xml
@@ -186,13 +186,16 @@ bandwidth=64000
 	<para>En redes gestionadas donde existe un proxy HTTP que regula qué estaciones y servidores pueden tener acceso a las redes externas o internas con por ejemplo el protocolo HTTP, yum debe ser configurado adecuadamente para que pueda utilizar los recursos del proxy para poder acceder a los repositorios de software necesarios.</para>
 	<para>En <filename>yum.conf</filename> puede utilizar las siguientes tres directivas:</para>
 	<variablelist>
-		<varlistentry><term><parameter>proxy</parameter></term>
+		<varlistentry>
+			<term><parameter>proxy</parameter></term>
 			<listitem><para>URL del servidor proxy que debe usar yum.</para></listitem>
 		</varlistentry>
-		<varlistentry><term><parameter>proxy_username</parameter></term>
+		<varlistentry>
+			<term><parameter>proxy_username</parameter></term>
 			<listitem><para>Nombre de usuario a utilizar con el servidor proxy.</para></listitem>
 		</varlistentry>
-		<varlistentry><term><parameter>proxy_password</parameter></term>
+		<varlistentry>
+			<term><parameter>proxy_password</parameter></term>
 			<listitem><para>Contraseña para este servidor proxy..</para></listitem>
 		</varlistentry>
 	</variablelist>
@@ -200,9 +203,10 @@ bandwidth=64000
  <para>Recuerde que YUM puede utilizar repositorios disponibles vía HTTP y FTP por lo que no necesariamente se trata de un servidor proxy HTTP.</para>
 
  <para>Estractos relevantes con configuración ejemplo en <filename>/etc/yum.conf</filename>:</para>
- <screen>    proxy http://proxy.dominio.com
-    proxy_username dragon
-    proxy_password 'secreto'
+ <screen>
+    proxy=http://proxy.dominio.com:puerto
+    proxy_username=dragon
+    proxy_password=secreto
  </screen>
 </section>
 
diff --git a/es-ES/Introduccion_a_la_gestion_del_software.xml b/es-ES/Introduccion_a_la_gestion_del_software.xml
index 82d5df3..9b76c02 100644
--- a/es-ES/Introduccion_a_la_gestion_del_software.xml
+++ b/es-ES/Introduccion_a_la_gestion_del_software.xml
@@ -35,7 +35,13 @@
 			<listitem><para><command>cvs co ...</command></para></listitem>
 		</itemizedlist>
 	</listitem>
-	<listitem><para>Usando las herramientas propia de la distribución.</para></listitem>
+	<listitem>
+		<para>Usando las herramientas propia de la distribución.</para>
+		<itemizedlist>
+			<listitem><para><command>yum install ...</command></para></listitem>
+			<listitem><para><command>aptitude install ...</command></para></listitem>
+		</itemizedlist>
+	</listitem>
 </itemizedlist>
 
 <para>Este manual es acerca de la última opción y en particular Fedora aunque muchos de los conceptos, herramientas y técnicas de este manual se pueden aplicar a otros sistemas. A continuación se resaltan algunos problemas de usar los otros métodos.</para>
@@ -107,7 +113,7 @@
 	<para>Si bien rpm es el gestor base de bajo nivel para los paquetes, su cálculo de dependencias es muy básico y puede fácilmente conducir a la situación conocida como "la pesadilla de las dependencias". Esta es la tarea fundamental que resuelve el sistema YUM, de ahí que aprender a usar yum evitará muchos malos ratos y que siempre y cuando se tenga acceso a un repositorio YUM, se podrá sonreír e instalar, desinstalar y actualizar cualquiera de los paquetes de software en nuestro sistema basado en RPM sin complicaciones debido a las dependencias.</para>
 	<para>La ventaja fundamental es el cálculo de las dependencias y en consecuencia su inclusión automática para poder instalar el paquete de software deseado, sin embargo no está limitado a ello y desde su diseño inicial a nuestros días, ha ganado una gran cantidad de extensiones que le permiten casi remplazar por completo a la herramienta rpm en la línea de comandos.</para>
 	<para>Luego existen programas gráficos GUIs como gpk-application y gpk-update-viewer que son frontales de YUM para gestionar el software de nuestro sistema basado en RPM, como por ejemplo Fedora, Red Hat o Centos. Estas aplicaciones son parte de la suite denominada PackageKit.</para>
-	<para>gpk-application en Fedora se invoca desde el menú <command>Sistema &gt; Administración &gt; Añadir/Quitar Software</command>. También existe Yumex que es una herramienta GUI más avanzada que ofrece más poder de control sobre YUM desde el entorno X.</para>
+	<para>También existe Yumex que es una herramienta GUI más avanzada que ofrece más poder de control sobre YUM desde el entorno X.</para>
 	<para>En cualquiera de los casos, la gestión del software es una operación sensible para el sistema y en consecuencia se requiere de privilegios suficientes para poder llevar a cabo dichas operaciones, típicamente debe ser root.</para>
 	<para>yum es la herramienta de consola principal del sistema YUM. En muchos casos es suficiente utilizar las herramientas GUI de alto nivel, en otros casos puede ser insuficiente o simplemente imposible de usar, por ejemplo un servidor sin entorno GUI (X), por ello aprender a usar la herramienta yum tiene doble beneficio, mayor poder y mayor alcance. Para hacer justicia hay que mencionar que PackageKit también incluye herramientas tipo consola en cuyo caso la discusión es si usar dichas herramientas versus la herramienta nativa yum. La documentación para dicho cliente en consola es realmente escasa y aún no le recomendamos su uso y se prefiere la herramienta nativa yum.</para>
 </section>
diff --git a/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml b/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml
index 30bdd7c..e0c15b9 100644
--- a/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml
+++ b/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml
@@ -9,8 +9,8 @@
 	
 	<screen># su -c "yum install gnome-packagekit"</screen>
 
-	<section><title>gpk-application</title>
-		<para>gpk-application es la interfase GUI hecha para GNOME y es el GUI estandar Fedora para gestión del software desde su versión 9 y luce como se muestra abajo. gpk-application se utiliza para instalar, remover y buscar paquetes de software en los sistemas Fedora y sus repositorios.</para>
+	<section><title>Añadir y quitar software con gpk-application</title>
+		<para><application>gpk-application</application> es la interfase GUI hecha para GNOME y es el GUI estandar Fedora para gestión del software desde su versión 9 y luce como se muestra abajo. <application>gpk-application</application> se utiliza para instalar, remover y buscar paquetes de software en los sistemas Fedora y sus repositorios.</para>
 
 	<figure><title>gpk-application</title>
 		<mediaobject>
@@ -23,11 +23,11 @@
 		</mediaobject>
 	</figure>
 
-	<para>En GNOME3, la mejor forma de invocar esta aplicación es buscándola y luego tal vez agregándola como favorita. Para buscar gpk-application presione la tecla Win o vaya al menú de actividades. Tipee "gpk" y obtendrá un resultado similar al pantallazo siguiente. En el pantallazo también se muestra el menú contextual que se obtiene de presionar clic derecho sobre el icono para agregar como aplicación favorita.</para>
+	<para>En GNOME3, la mejor forma de invocar esta aplicación es buscándola y luego tal vez agregándola como favorita. Para buscar <application>gpk-application</application> presione la tecla Win, la combinación Alt-F1 o vaya al menú de actividades en la esquina izquierda superior de su escritorio. Tipee "aña" y obtendrá un resultado similar al pantallazo siguiente. En el pantallazo también se muestra el menú contextual que se obtiene de presionar clic derecho sobre el icono para agregar como aplicación favorita.</para>
 	<figure><title>Buscando gpk-application en GNOME3</title>
 		<mediaobject>
 			<imageobject>
-				<imagedata fileref="images/Gpk-buscando-en-gnome3.png" format="PNG" scalefit="1" />
+				<imagedata fileref="images/Gnome3-buscando-gpk-application.png" format="PNG" scalefit="1" />
 				</imageobject>
 				<textobject>
 					<phrase>Pantallazo de GNOME3 buscando por "gpk"</phrase>
@@ -37,7 +37,7 @@
 
 
 	<section> <title>Estado de la aplicación</title>
-		<para>Antes de comenzar a detallar las operaciones que se pueden realizar con gpk-application, es importante notar el estado del sistema en cuanto a la gestión del software se refiere, es decir, el sistema debe por ejemplo hacer consultas a los repositorios externos para lograr un listado actualizado de aplicaciones disponibles, entonces, debemos esperar que dicha acción se culmine con éxito o que falle, no se desespere haciendo clic aquí y allá, sólo generará nuevas transacciones que se irán apilando. Abajo un pantallazo resaltando en un cruadro rojo el reporte del estado de la aplicación.</para>
+		<para>Antes de comenzar a detallar las operaciones que se pueden realizar con <application>gpk-application</application>, es importante notar el estado del sistema en cuanto a la gestión del software se refiere, es decir, el sistema debe por ejemplo hacer consultas a los repositorios externos para lograr un listado actualizado de aplicaciones disponibles, entonces, debemos esperar que dicha acción se culmine con éxito o que falle, no se desespere haciendo clic aquí y allá, sólo generará nuevas transacciones que se irán apilando. Abajo un pantallazo resaltando en un cruadro azul el reporte del estado de la aplicación.</para>
 	<figure><title>gpk-application estado de la aplicación</title>
 		<mediaobject>
 			<imageobject>
@@ -109,7 +109,7 @@
 	</section>
 
 	<section> <title>Instalación de paquetes</title>
-		<para>En todos los listados de gpk-application se reporta el estado del paquete o colección de paquetes, tildado equivale a instalado o por instalar, si no está tildado no está instalado o está agendado para desintalar, observe el cambio del icono y la activación de los botones Limpiar y Aplicar.</para>
+		<para>En todos los listados de <application>gpk-application</application> se reporta el estado del paquete o colección de paquetes, tildado equivale a instalado o por instalar, si no está tildado no está instalado o está agendado para desintalar, observe el cambio del icono y la activación de los botones  <guibutton>Limpiar</guibutton> y  <guibutton>Aplicar </guibutton>.</para>
 		<figure><title>gpk-application marcado para instalar</title>
 		<mediaobject>
 			<imageobject>
@@ -148,7 +148,7 @@
 		</mediaobject>
 	</figure>
 
-	<para>Al finalizar su selección de paquetes y colecciones a instalar presione el botón Aplicar para proceder con las transacciones agendadas, en este caso, instalar software nuevo. El sistema calculará las dependencias y las notificará de ser necesario para aprobación e instalación.</para>
+	<para>Al finalizar su selección de paquetes y colecciones a instalar presione el botón <guibutton>Aplicar</guibutton> para proceder con las transacciones agendadas, en este caso, instalar software nuevo. El sistema calculará las dependencias y las notificará de ser necesario para aprobación e instalación.</para>
 		<figure><title>gpk-application notificación dependencias al instalar</title>
 		<mediaobject>
 			<imageobject>
@@ -160,8 +160,8 @@
 		</mediaobject>
 	</figure>
 
-	<para>Si presiona el botón Limpiar, gpk-application olvidará todas las selecciones agendadas. En Paquetes seleccionados es posible corregir la selección individualmente. Es importante notar que gpk-application no permite agendar la remoción de paquetes de software si ha comenzado por agregar para instalar.</para>
-	<para>Si se acepta la instalación de las dependencias y se presionamos el botón Instalar, continuará el progreso de las transacciones agendadas. Ya que gestionar el software del sistema es una operación privilegiada, debe suministrar las credendicales del superusuario root antes de que el proceso pueda proseguir.</para>
+	<para>Si presiona el botón <guibutton>Limpiar</guibutton>, <application>gpk-application</application> olvidará todas las selecciones agendadas. En Paquetes seleccionados es posible corregir la selección individualmente. Es importante notar que <application>gpk-application</application> no permite agendar la remoción de paquetes de software si ha comenzado por agregar para instalar.</para>
+	<para>Si se acepta la instalación de las dependencias y se presiona el botón <guibutton>Instalar</guibutton>, continuará el progreso de las transacciones agendadas. Ya que gestionar el software del sistema es una operación privilegiada, debe suministrar las credendicales del superusuario root antes de que el proceso pueda proseguir.</para>
 		<figure><title>gpk-application autenticación root</title>
 		<mediaobject>
 			<imageobject>
@@ -172,8 +172,7 @@
 			</textobject>
 		</mediaobject>
 	</figure>
-	<para>Si no tiene dicha autorización, hable con el administrador de su sistema. Luego de autorizado pkg-application llevará a cabo las transacciones programadas que se resumen con la descarga e instalación de los paquetes.
-	</para>
+	<para>Si no tiene dicha autorización, hable con el administrador de su sistema. Luego de autorizado <application>gpk-application</application> llevará a cabo las transacciones programadas que se resumen con la descarga e instalación de los paquetes.</para>
 		<figure><title>gpk-application descargando</title>
 		<mediaobject>
 			<imageobject>
@@ -199,7 +198,7 @@
 
 <section>
 	<title>Desinstalación de paquetes</title>
-	<para>De forma análoga a la instalación, la desinstalación de paquetes con pkg-application es un proceso de listar, remover las tildes para agendar la desinstalación y aplicar, abajo los pantallazos correspondientes.</para>
+	<para>De forma análoga a la instalación, la desinstalación de paquetes con <application>gpk-application</application> es un proceso de listar, remover las tildes para agendar la desinstalación y aplicar, abajo los pantallazos correspondientes.</para>
 	<figure>
 		<title>gpk-application marcado para desinstalar</title>
 		<mediaobject>
@@ -311,59 +310,57 @@
 </section>
 </section>
 
-<section> 
-	<title>gpk-log</title>
-	<para>Es una aplicación para visualizar los registros de actividad relativos a la gestión del software, abajo un pantallazo.</para>
+
+<section>
+	<title>Alerta, actualizaciones disponibles</title>
+	<para>Cuando existan actualizaciones disponibles, aparecerá una notificación como la que se muestra en el pantallazo a continuación. En ella podrá invocar directamente <application>gpk-update-viewer</application> y proceder con la instalación o no de dichas actualizaciones.</para>
 	<figure>
-		<title>gpk-log.</title>
+		<title>GNOME3 alerta actualizaciones disponibles</title>
 		<mediaobject>
 			<imageobject>
-				<imagedata fileref="images/Gpk-log.png" format="PNG" scalefit="1"/>
+				<imagedata fileref="images/Gnome3-notificacion-actualizaciones-disponibles.png"/>
 				</imageobject>
 				<textobject>
-					<phrase>Pantallazo de gpk-log</phrase>
+					<phrase>Notificación de nuevas actualizaciones disponibles</phrase>
 			</textobject>
 		</mediaobject>
 	</figure>
-	<para>Desde gpk-application se puede invocar gráficamente esta aplicación. Por supuesto puede invocar gpk-log desde el shell o cualquier otra forma de ejecución de comando.</para>
+
+</section>
+
+<section>
+	<title>Actualizando con gpk-update-viewer</title>
+	<para>Permite listar las actualizaciones disponibes y actualizar el sistema. Usualmente <application>gpk-update-viewer</application> es invocado desde la alerta de notificación de nuevas actualizaciones.</para>
 	<figure>
-		<title>gpk-application menú sistema registro de software</title>
+		<title>gpk-update-viewer</title>
 		<mediaobject>
 			<imageobject>
-				<imagedata fileref="images/Gpk-application-menu-sistema-registro-de-software.png"/>
+				<imagedata fileref="images/Gpk-update-viewer.png"/>
 				</imageobject>
 				<textobject>
-					<phrase>Pantallazo de gpk-application menú sistema registro de software</phrase>
+					<phrase>Pantallazo de gpk-update-viewer</phrase>
 			</textobject>
 		</mediaobject>
 	</figure>
-</section>
 
-
-<section>
-	<title>gpk-update-viewer</title>
-	<para>Permite listar las actualizaciones disponibes y actualizar el sistema.</para>
+	<para>Si desea invocar manualmente puede buscar por "actualización" o mirando en las aplicaciones Herramientas del Sistema.</para>
 	<figure>
-		<title>gpk-update-viewer</title>
+		<title>GNOME3 Aplicaciones - Herramientas del Sistema</title>
 		<mediaobject>
 			<imageobject>
-				<imagedata fileref="images/Gpk-update-viewer.png"/>
+				<imagedata fileref="images/Gnome3-aplicaciones-herramientas-del-sistema.png"/>
 				</imageobject>
 				<textobject>
-					<phrase>Pantallazo de gpk-update-viewer</phrase>
+					<phrase>Actualización de Software</phrase>
 			</textobject>
 		</mediaobject>
 	</figure>
-</section>
 
-<section>
-	<title>Alertas de actualizaciones</title>
-	<para>_PENDIENTE_ ¡Actualízame, escríbeme!.</para>
 </section>
 
 <section>
-	<title>gpk-prefs</title>
-	<para> gpk-prefs permite establecer las preferencias del sistema con respecto a las actualizaciones de software y los repositorios de software habilitados. En su ventana principal se dividen en dos pestañas.</para>
+	<title>Ajuste de preferencias con gpk-prefs</title>
+	<para><application>gpk-prefs</application> permite establecer las preferencias del sistema con respecto a las actualizaciones de software y los repositorios de software habilitados. Su ventana principal se divide en dos pestañas.</para>
 	<para>La primera es para las preferencias de las actualizaciones.</para>
 	<figure>
 		<title>gpk-prefs Actualizar configuración</title>
@@ -389,6 +386,8 @@
 		</mediaobject>
 	</figure>
 
+	<para>A esta segunda pestaña de <application>gpk-prefs</application> tambén se le puede acceder directamente desde <application>gpk-application</application> en su menú sistema.</para>
+
 	<figure>
 		<title>gpk-application menú sistema repositorios de software</title>
 		<mediaobject>
@@ -401,6 +400,51 @@
 		</mediaobject>
 	</figure>
 
+	<para>Si desea localizar <application>gpk-prefs</application> para su invocación manual desde GNOME3 o para agregarlo como aplicación favorita, busque por "preferencia" y debería obtener un resultado similar al pantallazo siguiente.</para>
+
+	<figure>
+		<title>Localizando gpk-prefs en GNOME3</title>
+		<mediaobject>
+			<imageobject>
+				<imagedata fileref="images/Gnome3-buscando-gpk-prefs.png"/>
+				</imageobject>
+				<textobject>
+					<phrase>Pantallazo GNOME3 buscando gpk-prefs</phrase>
+			</textobject>
+		</mediaobject>
+	</figure>
+
+
+
+</section>
+
+
+<section> 
+	<title>Visualización de los registros con gpk-log</title>
+	<para><application>gpk-log</application> es una aplicación para visualizar los registros de actividad relativos a la gestión del software, abajo un pantallazo.</para>
+	<figure>
+		<title>gpk-log.</title>
+		<mediaobject>
+			<imageobject>
+				<imagedata fileref="images/Gpk-log.png" format="PNG" scalefit="1"/>
+				</imageobject>
+				<textobject>
+					<phrase>Pantallazo de gpk-log</phrase>
+			</textobject>
+		</mediaobject>
+	</figure>
+	<para>Desde <application>gpk-application</application> se puede invocar gráficamente esta aplicación. Por supuesto puede invocar <application>gpk-log</application> desde el shell o cualquier otra forma de ejecución de comando. Para el momento de redacción esta aplicación no aparece listada como aplicación de escritorio.</para>
+	<figure>
+		<title>gpk-application menú sistema registro de software</title>
+		<mediaobject>
+			<imageobject>
+				<imagedata fileref="images/Gpk-application-menu-sistema-registro-de-software.png"/>
+				</imageobject>
+				<textobject>
+					<phrase>Pantallazo de gpk-application menú sistema registro de software</phrase>
+			</textobject>
+		</mediaobject>
+	</figure>
 </section>
 
 </chapter>
diff --git a/es-ES/PackageKit_CLI.xml b/es-ES/PackageKit_CLI.xml
index eb77578..f8073a7 100644
--- a/es-ES/PackageKit_CLI.xml
+++ b/es-ES/PackageKit_CLI.xml
@@ -9,7 +9,7 @@
 
 	<section><title>pkcon</title>
 		<para><application>pkcon</application> es la interfase de PackageKit en la línea de comandos o CLI a la gestión del software.</para>
-		<para>En general, las acciones que requieran privilegios le requerirán que suministre la contraseña del superusuario en el entorno gráfico, algo no muy ortodoxo ya que estamos usando una herramienta CLI. También puede utilizar <application>sudo</application> en la línea de comandos para ejecutar <application>pkcon</application> para obtener los privilegios o simplemente ejecutar el comando directamente como root con la ayuda de <application>su</application> o después de hacer login shell root vía una consola virtual u otro mecanismo de consola remota.</para>
+		<para>En general, al ejecutar <application>pkcon</application> como usuario regular y si se requiere de privilegios de superusuario para completar la acción, no se le preguntará por contraseña sino que siplemente fallará con error de no autorizado. Puede escalar priviliegios y ejecutar el comando usando <application>sudo</application> o simplemente ejecutar el comando directamente como root con la ayuda de <application>su</application> o después de hacer login shell root vía una consola virtual u otro mecanismo de consola remota.</para>
 
 		<note><title>Básicamente ejemplos</title>
 			<para>Ya que no se posee mayor documentación, la mayoría de la documentación abajo son ejemplos de uso para las operaciones más comunes. También tenga en cuenta que algunos subcomandos simplemente no funcionan.</para>
@@ -18,7 +18,7 @@
 		<section><title>Documentación</title>		
 <para><emphasis>Ayuda en línea</emphasis></para>
 <screen>
-$ pkcon -help
+$ pkcon --help
 
 Uso:
   pkcon [OPCIÓN…] PackageKit Console Program
@@ -51,23 +51,24 @@ Subcomandos:
   repo-list
   repo-enable [repo_id]
   repo-disable [repo_id]
-  repo-set-data [repo_id] [parameter] [value];
   what-provides [search]
   get-categories
 
+
 Opciones de ayuda:
-  -h, --help               Mostrar opciones de ayuda
+  -?, --help               Mostrar opciones de ayuda
   --help-all               Muestra todas las opciones de ayuda
-  --help-debug             Mostrar información extra de depuración
 
 Opciones de la aplicación:
   --version                Mostrar la versión del programa y salir
   --filter                 Establecer el filtro, p. ej. instalado
-  --root                   Establecer la raíz de instalación, p. ej., '/', o '/mnt/ltsp'
+  --root                   Establecer la raíz de instalación, p. ej., «/», o «/mnt/ltsp»
   -n, --nowait             Salir sin esperar que las acciones se completen
   -y, --noninteractive     Instalar los paquetes sin confirmación
   --background             Ejecuta el comando utilizando menos potencia, y el ancho de bando libre
   -p, --plain              Imprime en la pantalla una salida legible por una máquina, en lugar de utilizar widgets animados
+  -c, --cache-age          El tiempo máximo de edad para la caché de metadatos. Usar -1 para «nunca».
+  -h, --help               Show help options.
   -v, --verbose            Mostrar información de depuración para todos los archivos
 </screen>
 </section>
@@ -75,29 +76,80 @@ Opciones de la aplicación:
 <section><title>Búsquedas</title>
 <para><emphasis>Búsqueda por nombre</emphasis></para>
 <para>Búsqueda por patrón en el nombre del paquete.</para>
-<para><command>search</command> <parameter>[name|details|group|file]</parameter> <parameter>[data]</parameter></para>
+<para><command>search</command> <parameter>name</parameter> <parameter>[data]</parameter></para>
 <screen>
 $ pkcon search name octa
-
+...
 Transacción:	Buscando por nombre
 Estado: 	Comenzando
 Estado: 	Consultando
-Paquete:	GMT-octave-4.5.2-1.fc13.x86_64
-Paquete:	GMT-octave-4.5.3-3.fc13.x86_64
-Paquete:	octave-6:3.2.4-2.fc13.i686
+Paquete:	csdp-octave-6.1.1-1.fc15.noarch
+Paquete:	csdp-octave-6.1.1-1.fc15.noarch
+Paquete:	octave-6:3.4.0-6.fc15.i686
 ...
-Paquete:	plplot-octave-5.9.5-7.fc13.x86_64
-Paquete:	qtoctave-0.9.1-1.fc13.x86_64
-Paquete:	qtoctave-0.9.1-2.fc13.x86_64
+Paquete:	qtoctave-0.10.1-3.fc15.x86_64
+Paquete:	qtoctave-0.10.1-3.fc15.x86_64
+Paquete:	qtoctave-debuginfo-0.10.1-3.fc15.x86_64
 Resultados:
-Disponible   GMT-octave-4.5.2-1.fc13.x86_64
-Disponible   GMT-octave-4.5.3-3.fc13.x86_64
-Disponible   octave-6:3.2.4-2.fc13.i686
+Disponible   csdp-octave-6.1.1-1.fc15.noarch
+Disponible   csdp-octave-6.1.1-1.fc15.noarch
+Disponible   octave-6:3.4.0-6.fc15.i686
 ...
-Disponible   plplot-octave-5.9.5-7.fc13.x86_64
-Disponible   qtoctave-0.9.1-1.fc13.x86_64
-Disponible   qtoctave-0.9.1-2.fc13.x86_64
+Disponible   qtoctave-0.10.1-3.fc15.x86_64
+Disponible   qtoctave-0.10.1-3.fc15.x86_64
+Disponible   qtoctave-debuginfo-0.10.1-3.fc15.x86_64
 </screen>
+
+<para><emphasis>Búsqueda en detalles</emphasis></para>
+<para>Búsqueda por patrón en los detalles de los paquetes.</para>
+<para><command>search</command> <parameter>details</parameter> <parameter>[data]</parameter></para>
+<screen>
+$ pkcon search details squid
+...
+
+Transacción:	Buscando por detalles
+Estado: 	Comenzando
+Estado: 	Consultando
+Paquete:	squid-7:3.1.12-1.fc15.x86_64
+Paquete:	awstats-7.0-3.fc15.noarch
+Paquete:	calamaris-2.59-4.fc15.noarch
+Paquete:	ccze-0.2.1-7.fc15.x86_64
+Paquete:	dansguardian-2.10.1.1-4.fc13.x86_64
+Paquete:	lightsquid-1.8-10.fc15.noarch
+Paquete:	lightsquid-apache-1.8-10.fc15.noarch
+Paquete:	mod_auth_ntlm_winbind-0.0.0-0.11.20070129svn713.fc15.x86_64
+Paquete:	squid-debuginfo-7:3.1.12-1.fc15.x86_64
+Paquete:	squidGuard-1.4-9.fc15.x86_64
+Paquete:	tinyproxy-1.8.2-2.fc15.x86_64
+Resultados:
+Disponible   awstats-7.0-3.fc15.noarch
+Disponible   calamaris-2.59-4.fc15.noarch
+Disponible   ccze-0.2.1-7.fc15.x86_64
+Disponible   dansguardian-2.10.1.1-4.fc13.x86_64
+Disponible   lightsquid-1.8-10.fc15.noarch
+Disponible   lightsquid-apache-1.8-10.fc15.noarch
+Disponible   mod_auth_ntlm_winbind-0.0.0-0.11.20070129svn713.fc15.x86_64
+Instalado    squid-7:3.1.12-1.fc15.x86_64
+Disponible   squid-debuginfo-7:3.1.12-1.fc15.x86_64
+Disponible   squidGuard-1.4-9.fc15.x86_64
+Disponible   tinyproxy-1.8.2-2.fc15.x86_64
+</screen>
+
+<para><emphasis>Búsqueda de archivo</emphasis></para>
+<para>Búsqueda por patrón de paquetes que proven el archivo dado.</para>
+<para><command>search</command> <parameter>file</parameter> <parameter>[data]</parameter></para>
+<screen>
+$ pkcon search details /etc/ddclient.conf
+...
+
+Transacción:	Buscando por archivos
+Estado: 	Comenzando
+Estado: 	Consultando
+Paquete:	ddclient-3.8.0-4.fc15.noarch
+Resultados:
+Instalado    ddclient-3.8.0-4.fc15.noarch
+</screen>
+
 </section>
 
 <section><title>Instalar,actualizar y remover paquetes</title>
@@ -261,7 +313,7 @@ Eliminados   suitesparse
 </section>
 
 <section><title>Información sobre paquetes</title>
-	<para><emphasis>Listado de todos los paquetes</emphasis></para>
+	<para><emphasis>Listado de todos los paquetes</emphasis>. Si no tiene conexión a los repositorios configurados, puede tomarse su tiempo en responder.</para>
 	<screen>
 $ pkcon get-packages
 
@@ -557,7 +609,7 @@ fwsnort-1.0.6-7.fc13.noarch.rpm
 </section>
 
 <section><title>Uso de filtros</title>
-<para><emphasis>Listado de filtros disponibles</emphasis></para>
+<para><emphasis>Listado de filtros disponibles</emphasis>. Debe usar los nombres listados aunque la ayuda en línea diga "ej. instalado".</para>
 <screen>
 $ pkcon get-filters
 	


More information about the docs-commits mailing list