On Thu, 2004-02-19 at 09:28, Carlos Izquierdo wrote: > Hola, > > Soy nuevo en la lista. Estuve colaborando un tiempo con el DDTP (Debian > Description Translation Project) y quería volver a echar una mano con la > traducción de Debian al castellano, pero parece que todas las páginas > relativas a dicho proyecto ya no existen y esto es lo más parecido que pude > encontrar. ¿Podría alguien explicarme, o referirme a una FAQ al respecto, > cómo colaborar en la traducción/revisión (si es que el proceso sigue abierto, > no sé si ahora hay que inscribirse en algún sitio o cumplir unos requisitos)? > Básicamente, ¿por dónde empiezo? :-) > > Gracias. Ehm, yo lamentablemente me he quedado corto de tiempo en la traducción de dpkg-source. Llevo un poco mas de la mitad, quizas podrias empezar finalizando ese. Saludos! -- Midway upon the journey of our life, I found myself within a forest dark, For the straightforward pathway had been lost.
.\" Autor: Ian Jackson .TH "DPKG\-SOURCE" "1" "Enero 2000" "Debian Project" "utilidades de dpkg" .SH "NOMBRE " dpkg\-source, dpkg\-gencontrol, dpkg\-shlibdeps, dpkg\-genchanges, dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog \- Herramientas para los archivos fuentes de los paquetes de Debian. .SH "SINOPSIS" .B dpkg\-source .BI "\-x " archivo .dsc .br .B dpkg\-source \-b .RI [ opciones "] " directorio " [" directorio\-origen |''] .br .B dpkg\-gencontrol .RI [ opciones ] .br .B dpkg\-shlibdeps .I R opciones .br .B dpkg\-genchanges .RI [ opciones ] .br .B dpkg\-buildpackage .RI [ opciones ] .br .B dpkg\-distaddfile .RI [ opciones ] " archivo sección prioridad" .br .B dpkg\-parsechangelog .RI [ opciones ] .SH "DESCRIPCION" .B dpkg\-source empaqueta y desempaqueta archivos fuentes de los paquetes de Debian. .B dpkg\-gencontrol lee información desde el archivo fuente del paquete Debian y genera un archivo de control ( por defecto ubicado en debian/tmp/DEBIAN/control); también añade una entrada para el paquete binario en .BR debian/files . .B dpkg\-shlibdeps calcula las dependencias de las librerías compartidas requeridas por los archivos ejecutables. Las dependencias son añadidas a los archivos tales como .B debian/substvars en el siguiente formato .BI shlibs: dependencia donde .I dependencia es el nombre del paquete " dependiente " que se requiere. Cualquier otra variable empezando con .I shlibs: es eliminada del archivo. .B dpkg\-shlibdeps leerá la información de las librerias compartidas que son dependencia desde .BR debian/shlibs.local, .BR /etc/dpkg/shlibs.override, .B shlibs controla el archivo del paquete en el cual se encuentra el nombre de fichero que .B objdump reporta para satisfacer la dependencia , o bien .BR /etc/dpkg/shlibs.default . El primer resultado será usado. Véase .I el manual de empaquetamiento de Debian para más detalles sobre el formato de las librerias compartidas que son dependencias. .B dpkg\-genchanges lee la información a partir de archivo fuente de un paquete de Debian y también de los archivos que ha generado, y además genera un archivo de control sobre las actualizaciones del paquete. .B (Archivo ".changes"). .B dpkg\-buildpackage es un script de control el cual puede ser usado para automatizar la creación de un paquete. .B dpkg\-distaddfile añade una entrada para el archivo llamado .BR debian/files . .B dpkg\-parsechangelog lee y chequea el changelog de un archivo fuente de Debian, y muestra la información en un método legible para la maquina. Ninguno de estos comandos permite usar multiples opciones combinadas en una sola , y además no permiten opciones en argumentos separados. .SH "OPCIONES COMUNES" Muchos de estos programas comparten opciones; Estas son descritas aqui, junto con los programas que las aceptan. .TP .BI \-h Muestra en pantalla la versión y el uso del programa, incluyendo un resumen de los comandos disponibles. Esta opción es usada en todas las herramientas para los archivos fuentes de paquetes de Debian. .TP .BI \-v version En .BR dpkg\-buildpackage ", " dpkg\-genchanges " y " dpkg\-parsechangelog esto produce un cambio de toda la información .I versión de dichos programas a ser usada. En .BR dpkg\-gencontrol se configura la versión del paquete binario que será generado .TP .BI \-C changesdescription Lee la descripcion Read the description of the changes from the file .I changesdescription rather than using the information from the source tree's changelog file. This is understood by .BR dpkg\-buildpackage " and " dpkg\-genchanges . .TP .BI \-m maintaineraddress Use .I maintaineraddress as the name and email address of the maintainer for this package, rather than using the information from the source tree's control. This is understood by .BR dpkg\-buildpackage " and " dpkg\-genchanges . .TP .BI \-e maintaineraddress Use .I maintaineraddress as the name and email address of the maintainer for this upload, rather than using the information from the source tree's changelog. This is understood by .BR dpkg\-buildpackage " and " dpkg\-genchanges . .TP .BR \-si ", " \-sa ", " \-sd These options control whether the original source archive is included in the upload generated by .BR dpkg\-buildpackage " and " dpkg\-genchanges if any source is being generated (ie, .BR \-b " or " \-B haven't been used). By default, or if .B \-si is specified, the original source will be included if the version number ends in .BR \-0 " or " \-1 , ie if the Debian revision part of the version number is .BR 0 " or " 1 . .B \-sa forces the inclusion of the original source; .B \-sd forces its exclusion and includes only the diff. .TP .BI \-V name = value Set an output substitution variable. This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . See below for a discussion of output substitution. .TP .BI \-T substvarsfile Read (or, for .BR dpkg\-shlibdeps , write) substitution variables in .I R substvarsfile ; the default is .BR debian/substvars . This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol ", " dpkg\-shlibdeps " and " dpkg\-genchanges . .TP .BI \-D field = value Override or add an output control file field. This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . .TP .BI \-U field Remove an output control file field. This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . .TP .BR \-b | \-B | \-S For .BR dpkg\-genchanges " and " dpkg\-buildpackage .BR \-b " and " \-B specify that a binary\-only build is taking place. .B \-b indicates that no source files are to be built and/or distributed, and .B \-B that no architecture\-independent binary package files are to be distributed either. .B \-S specifies that only the source should be uploaded and no binary packages need to be made. The distinction between .BR \-b " and " \-B is only used by .BR dpkg\-buildpackage ; .B dpkg\-genchanges just produces a .B .changes file for whatever files were produced by the .B binary\-* target(s) of the package being built. .B \-b tells .B dpkg\-source to build a source package (rather than to extract one) \- see below. .TP .BI \-c controlfile Specifies the main source control file to read information from. The default is .BR debian/control . This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . .TP .BI \-l changelogfile Specifies the change log file to read information from. The default is .BR debian/changelog . This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . .TP .BI \-f fileslistfile Read or write the list of files to be uploaded here, rather than using .BR debian/files . This option is understood by .BR dpkg\-gencontrol ", " dpkg\-genchanges " and " dpkg\-distaddfile . .TP .BI \-F changelogformat Specifies the format of the changelog. By default the format is read from a special line near the bottom of the changelog (see the Debian packaging manual) or failing that defaults to .BR debian , the standard format described in the .I R "Debian packaging manual" . This option is understood by .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges . .TP .BI \-W This option turns certain errors into warnings. Only dpkg\-source uses this, but .BR dpkg\-buildpackage recognizes it, and passes it thru to .BR dpkg\-source "." .TP .BI \-E This option negates a previously set .BR \-W "." It is currently only understood by .BR dpkg\-buildpackage " and " dpkg\-source "." .SH "OPCIONES DE DPKG-SOURCE" When the common options .BR \-c " and " \-l are given with relative pathnames these are interpreted starting at the source tree's top level directory. .TP .B \-x Extract a source package. One non\-option argument should be supplied, the name of the Debian source control file .RB ( .dsc ). No options are useful with .BR "dpkg\-source \-x" . .B dpkg\-source will read the names of the other file(s) making up the source package from the control file; they are assumed to be in the same directory as the .BR .dsc . The files in the extracted package will have their permissions and ownerships set to those which would have been expected if the files and directories had simply been created \- directories and executable files will be 0777 and plain files will be 0666, both modified by the extractors' umask; if the parent directory is setgid then the extracted directories will be too, and all the files and directories will inherit its group ownership. .TP .B \-b Build: pack up a source tree. One or two non\-option arguments should be supplied. The first is taken as the name of the directory containing the unpacked source tree. If a second argument is supplied it should be the name of the original source directory or tarfile or the empty string if the package is a Debian\-specific one and so has no Debianisation diffs. If no second argument is supplied then .B dpkg\-source will look for the original source tarfile .I B package _ upstream\-version .orig.ta r.gz or the original source directory .I B directory .orig or the empty string (no original source, and so no diff) depending on the arguments. .TP .B \-i[<regexp>] You may specify a perl regular expression to match files you want filtered out of the list of files for the diff. (This list is generated by a find command.) \fB\-i\fR by itself enables the option, with a default that will filter out CVS, RCS and libtool .deps subdirectories, and all files within them, as well as ~ suffixed backup files and DEADJOEs. This is very helpful in cutting out extraneous files that get included in the .diff.gz, (eg: "debian/BUGS_TODO/*" or "debian/RCS/*,v"). For instance, if you maintain a package that you track via remote CVS, where you don't have access permissions for commiting the debian control files and making tags for \fIcvs\-buildpackage(1)\fR, it is necessary to perform an extra checkout/update into a directory you keep pristine, to generate the .orig.ta r.gz from. That directory will have CVS/Entries files in it that will contain timestamps that differ from the ones in your working directory, thus causing them to be unnecessarily included in every .diff.gz, unless you use the \fB\-i\fR switch. .TP .B \-I<filename> If this option is specified, the filename will be passed to tar's \-\-exclude option when it is called to generate a .orig.ta r.gz or .ta r.gz file. For example, \-ICVS will make tar skip over CVS directories when generating a .ta r.gz file. The option may be repeated multiple times to list multiple filenames to exclude. .TP .BR \-sa , \-sp , \-su , \-sk , \-sA , \-sP , \-sU , \-sK , \-ss " with " \-b If .BR \-sk " or " \-sp is specified .B dpkg\-source expects the original source as a tarfile, by default .I B package _ upstream\-version .orig.ta r.gz\fR. It will leave this original source in place as a tarfile, or copy it to the current directory if it isn't already there If .B \-sp is used rather than .B \-sk it will remove it again afterwards. If .BR \-su " or " \-sr is specified the original source is expected as a directory, by default .I B package \- upstream\-version .orig and .B dpkg\-source will create a new original source archive from it. If .B \-sr is used .B dpkg\-source will remove that directory after it has been used. If .B \-ss is specified .B dpkg\-source will expect that the original source is available both as a directory and as a tarfile. If will use the directory to create the diff, but the tarfile to create the .BR .dsc . This option must be used with care \- if the directory and tarfile do not match a bad source archive will be generated. If .B \-sn is specified .B dpkg\-source will not look for any original source, and will not generate a diff. The second argument, if supplied, must be the empty string. This is used for Debian\-specific packages which do not have a separate upstream source and therefore have no debianisation diffs. If .BR \-sa " or " \-sA is specified .B dpkg\-source will look for the original source archive as a tarfile or as a directory \- the second argument, if any, may be either, or the empty string (this is equivalent to using .BR \-sn ). If a tarfile is found it will unpack it to create the diff and remove it afterwards (this is equivalent to .BR \-sp ); if a directory is found it will pack it to create the original source and remove it afterwards (this is equivalent to .BR \-sr ); if neither is found it will assume that the package has no debianisation diffs, only a straightforward source archive (this is equivalent to .BR \-sn ). If both are found then dpkg\-source will ignore the directory, overwriting it, if .B \-sA was specified (this is equivalent to .BR \-sP ) or raise an error if .B \-sa was specified. .B \-sA is the default. .BR \-sa ", " \-sp ", " \-sk ", " \-su " and " \-sr will not overwrite existing tarfiles or directories. If this is desired then .BR \-sA ", " \-sP ", " \-sK ", " \-sU " and " \-sR should be used instead. .TP .BR \-sp , \-su , \-sn " with " \-x In all cases any existing original source tree will be removed. If .B \-sp is used when extracting then the original source (if any) will be left as a tarfile. If it is not already located in the current directory or if an existing but different file is there it will be copied there. This is the default. .B \-su unpacks the original source tree. .B \-sn ensures that the original source is neither copied to the current directory nor unpacked. Any original source tree that was in the current directory is still removed. .SH "OPCIONES DE DPKG-GENCONTROL" .B dpkg\-gencontrol no acepta ninguna opción fuera de lo común. .TP .BI \-p paquete Genera información para el paquete creado .I R paquete. Si el archivo de control lista solo paquetes binarios , entonces esta opción debe ser omitida.; de otra manera , es esencial selecciónar cual información del paquete se desea generar. .TP .BI \-n archivo Asume el fichero del paquete que será .I archivo en vez de el normal fichero paquete_version_arquitectura.deb . .TP .BR \-is ", " \-ip ", " \-isp Incluye los campos de .BR Sección " y " Prioridad para este paquete leyendo desde el fichero principal de control. Usualmente esta información no es incluida aqui, sino que solmente en el archivo .B .changes .B \-isp incluye ambos campos, .BR \-is " solo la " Sección " y " \-ip " sólo la " Prioridad . .TP .BI \-P directorioacrearpaquete Le dice a .B dpkg\-source que el paquete esta siendo creado en .I directoriocrearpaquete en vez de .BR debian/tmp . Esto normalmente es usado para encontrar el valor por defecto de la variable de substitución de .B Tamaño\-Instalado y el campo del fichero de control (usando .BR du ), y por defecto la ubicación del fichero de salida. .TP .B \-O Muestra el fichero de control por la salida estandar, algo como .B debian/tmp/DEBIAN/control (o .I B directoriocrearpaquete /DEBIAN/control si la opción .B \-P fué usada. .SH "OPCIONES DE DPKG-SHLIBDEPS" .B dpkg\-shlibdeps interpreta opciones fuera de lo comun como nombres ejectumable, solo si ellos podrían haber sido suplantados por .BI \-e ejecutable\fR. .TP .BI \-e ejecutable Incluye dependencias apropiadas para las librerias compartidas requeridas por el .I R ejecutable. .TP .BI \-d dependencia Añade dependencias a el fichero de control tomando .I R dependencia . (Las dependencias para este campo son dejadas en la variable .BI shlibs: dependencia\fR.) La opció .BI \-d dependencia toma efecto para todos los ejecutables despues de la opción, antes de la siguiente .BI \-d dependencia\fR. Por defecto .I dependencia es .BR Depends . Si la misma dependencia (o alguna alternativa) aparece en mas de una ocasión, entonces será reconocida por los campos .BR Pre\-Depends ", " Depends ", " Recommends ", " Enhances " or " Suggests entonces .B dpkg\-shlibdeps automaticamente removerá la dependencia de todos los campos, execptuando eso si las mas importantes. .TP .BI \-p prefixdelavariable Produce una substitución de variable empezando con .I B prefixdelavariable : en vez de .BR shlibs: . Asimismo, cualquier substitución ya existente de variable empezando con .I B prefixdelavariable : (algo como .BR shlibs: ) son borradas del archivo de substitución de variables. .TP .BI \-L archivodeshlibslocal Produce que .B dpkg\-shlibs empieze a leer las librerias que son dependencias desde .I archivosdeshlibslocal en vez de .BR debian/shlibs.local . .TP .B \-O Produce que las propiedades de la substitución de variables sean mostradas en pantalla por el método estandar, algo que puede ser añadido a el archivo de substitución de variables .RB ( debian/substvars por defecto). .SH "OPCIONES DE DPKG-GENCHANGES" .B dpkg\-genchanges no toma ninguna opcion fuera de lo común. .TP .BI \-u directorio Busca archivos para ser subidos al .I directorio algo como .B .. .RB ( dpkg\-genchanges necesita encontrar esos archivos asi puede incluir sus tamaños y checksums en el archivo .B .changes .TP .B \-q Usualmente .B dpkg\-genchanges producirá mensajes informativos en el formato estandar de error, por ejemplo acerca de cuantos archivos fuentes estan siendo subidos, pero con .B \-q esto no se producirá. .SH "OPCIONES DPKG-BUILDPACKAGE" .B dpkg\-buildpackage no acepta ninguna opción fuera de lo común. .TP .BI \-k key\-id Especifica un key\-ID que se usa cuando se firman paquetes. .TP .BI \-r el\-comando\-para\-tener\-root Cuando .B dpkg\-buildpackage necesita ejecutar procesos como root, lee el comando y ejecuta .I el\-comando\-para\-tener\-root si es que alguno ha sido especificado. .I el\-comando\-para\-tener\-root debe ser el nombre del programa que esta instalado en su .B sistema y tomará como argumentos el nombre del programa a lanzar, además de los argumentos que se deben usar. .I el\-comando\-para\-tener\-root no debe contener ningún espacio ni tampoco caracteres raros. .\" Y que pasa si este contiene espacios? (hs) .I el\-comando\-para\-tener\-root podría ser tipicamente .BR sudo ", " super " o " really . .B su no se puede usar, ya que requiere la opción .B \-c para lanzar un comando y siempre cuando pueda invocar la shell del usuario con .B \-c en vez de pasar los argumentos individualmente al comando que debe ser lanzado. .TP .BI \-p el\-comando\-para\-firmar Cuando .B dpkg\-buildpackage necesita ejecutar GPG o PGP para firmar el fichero fuente de control .RB ( .dsc ) o .B .changes el archivo lanzará .I el\-comando\-para\-firmar (buscando en su .B sistema si es necesario) en vez de .BR pgp . .I el\-comando\-para\-firmar tendrá todos los argumentos que .B pgp podría tener. Si .I el\-comando\-para\-firmar toma argumentos en GPG algo como el estilo de PGP, usted debe usar la opción .B \-sgpg .I el\-comando\-para\-firmar no debe tener espacios ni cualquier otro caracter raro. .TP .B \-tc Limpia la fuente (usando .I el\-comando\-para\-tener\-root .BR "debian/rules clean" ) luego de que el paquete ha sido creado. .TP .BR \-us ", " \-uc No firma el paquete ni el fichero .changes, respectivamente. .TP .BI \-a arquitectura Especifica la arquitectura para la cual el paquete esta siendo creado. La arquitectura de la maquina es detectada automaticamente de igual manera que para el host de la maquina. .TP .B \-i[<argumento>] Pasado sin cambios directamente a .BR dpkg\-source . .TP .B \-I<archivo> Pasado sin cambios a .BR dpkg\-source . Puede ser repetido cuantas veces desee. .TP .B \-D Revisa las dependencias y los conflictos; Termina con el proceso si alguna de las ya nombradas no son satisfacidas. .TP .B \-d No revisa dependencias ni conflictos. .TP .B \-nc No limpia las fuentes.(lo mismo que \-b). .SH "OPCIONES DE DPKG-DISTADDFILE" .B dpkg\-distaddfile no acepta ninguna opción fuera de lo comun. Toma 3 argumentos que no son opciones, el archivo, la sección y la prioridad para el archivo .B .changes El archivo debe ser especificado relavitvamente al directorio donde .B dpkg\-genchanges estara esperando para encontrar los archivos, usualmente .BR .. , algo que puede ser como una asignacion al directorio actual donde .B dpkg\-distaddfile fue lanzado. .SH "ARGUMENTOS DE DPKG-PARSECHANGELOG" .B dpkg\-parsechangelog no acepta ninguna opción o argumento fuera de lo comun. .SH "SUBSTITUCION DE VARIABLES" Before .BR dpkg\-source ", " dpkg\-gencontrol " and " dpkg\-genchanges write their control information (to the source control file .B .dsc for .B dpkg\-source and to standard output for .BR dpkg\-gencontrol " and " dpkg\-genchanges ) they perform some variable substitutions on the output file. A variable substitution has the form .BI ${ variable\-name }\fR. Variable names consist of alphanumerics, hyphens and colons and start with an alphanumeric. Variable substitutions are performed repeatedly until none are left; the full text of the field after the substitution is rescanned to look for more substitutions. After all the substitutions have been done each occurence of the string .B ${} (which is not a legal substitution) is replaced with a .B $ sign. Variables can be set using the .B \-V common option. They can be also specified in the file .B debian/substvars (or whatever other file is specified using the .B \-T option). This file consists of lines of the form .I B name = value\fR. Trailing whitespace on each line, blank lines, and lines starting with a .B # symbol (comments) are ignored. Additionally, the following standard variables are available: .TP .BI Arch The current build architecture (from .BR "dpkg \-\-print\-architecture" ). .TP .B Source\-Version The source package version (from the changelog file). .TP .B Installed\-Size The total size of the package's installed files. This value is copied into the corresponding control file field; setting it will modify the value of that field. If this variable isn't set .B dpkg\-gencontrol will use .B du \-k debian/tmp to find the default value. .TP .B Extra\-Size Additional disk space used when the package is installed. If this variable is set its value is added to that of the .B Installed\-Size variable (whether set explicitly or using the default value) before it is copied into the .B Installed\-Size control file field. .TP .BI F: fieldname The value of the output field .I R fieldname (which must be given in the canonical capitalisation). Setting these variables has no effect other than on places where they are expanded explicitly. .TP .B Format The .B .changes file format version generated by this version of the source packaging scripts. If you set this variable the contents of the .B Format field in the .B .changes file will change too. .TP .BR Newline ", " Space ", " Tab These variables each hold the corresponding character. .TP .BI shlibs: dependencyfield Variable settings with names of this form are generated by .B dpkg\-shlibdeps \- see above. .LP If a variable is referred to but not defined it generates a warning and an empty value is assumed. .SH "ARCHIVOS" .TP .B debian/control The main source control information file, giving version\-independent information about the source package and the binary packages it can produce. .TP .B debian/changelog The changelog file, used to obtain version\-dependent information about the source package, such as the urgency and distribution of an upload, the changes made since a particular release, and the source version number itself. .TP .B debian/files The list of generated files which are part of the upload being prepared. .B dpkg\-gencontrol adds the presumed filenames of binary packages whose control files it generates here; .B dpkg\-distaddfile can be used to add additional files. .B dpkg\-genchanges reads the data here when producing a .B .changes file. .TP .B debian/substvars List of substitution variables and values. .TP .B debian/shlibs.local Package\-local overriding shared library dependency information. .TP .B /etc/dpkg/shlibs.override Per\-system overriding shared library dependency information. .TP .B /etc/dpkg/shlibs.default Per\-system default shared library dependency information. .SH "BUGS" The point at which field overriding occurs compared to certain standard output field settings is rather confused. The binary package entries in the .B debian/files file will be passed through variable substitution twice. This should not matter, since .BR $ ", " { " and " } are not legal in package names or version numbers. It should be possible to specify spaces and shell metacharacters in and initial arguments for .I R el\-comando\-para\-tener\-root" and " . .SH "VÉASE TAMBIÉN" .I R "Manual de empaquetamiento de Debian" , .br .I R "Manual de terminos y condiciones de Debian." , .br .BR dpkg\-deb (1), .BR dpkg (8), .BR dselect (8), .BR gpg (1), .BR pgp (1). .SH "AUTHOR" Las utilidades y esta página man fueron escritas por Ian Jackson. .SH "COPYRIGHT" Copyright (C) 1995\-1996 Ian Jackson .br Copyright (C) 2000 Wichert Akkerman .br Vea la Licencia General Publica de GNU en su versión o superior para las condiciones de copia. .B no hay garantía alguna. Vea .B /usr/share/doc/dpkg/copyright y .B /usr/share/common\-licenses/GPL para mayores detalles. Está pagina fue traducida por Bruno Barrera C. <bruno.barrera@igloo.cl>
Attachment:
signature.asc
Description: This is a digitally signed message part