deb-version(5)

NOMBRE
deb-version - Formato del número de versión de paquete de Debian

SINOPSIS
[ epoch:] versión-autor-original [-revisión-debian ]

DESCRIPCIÓN
Los números de versión usados en los paquetes fuente y binarios de Debian, consisten de tres componentes. Estos son:

epoch
    Es un sólo entero sin signo (generalmente pequeño). Se puede omitir, en cuyo caso se asume cero. Si se omite, versión-autor-original no debe contener ningún símbolo de dos puntos.

    Está presente para permitir errores en los números de versiones anteriores de un paquete, y también los esquemas de numeración anteriores de un paquete, a desechar en un futuro.

versión-autor-original
    Esta es la parte principal del número de versión. Habitualmente, es igual al número de versión del paquete del autor original del cual se genera el fichero «.deb». Suele estar en el mismo formato que el especificado por el o los autor(es) originales; sin embargo, algunas veces puede tener otro formato para encajar con el formato del sistema de gestión de paquetes y el esquema de comparación.

    El funcionamiento del proceso de comparación del sistema de paquetes respecto a la versión-autor-original se describe a continuación. La sección versión-autor-original es obligatoria en el número de versión.

    La versión-autor-original solo puede contener letras y números («A-Za-z0-9») y los caracteres . + - : ~ (punto, suma, guión, dos puntos y virgulilla) y debe comenzar con un dígito. Si no existe revisión-debian no se permiten los guiones; si no hay epoch, tampoco se permiten los dos puntos.

revisión-debian
    Esta parte del número de versión define la versión del paquete de Debian en base a la versión del desarrollador original. Sólo puede contener caracteres alfanuméricos, además de los caracteres + . ~ (más, punto, virgulilla) y se compara de la misma manera que se compara versión-autor-original.

    Es opcional; si no está presente versión-autor-original no puede contener un guión. Este formato representa el caso en el que un programa fue escrito específicamente para ser un paquete de Debian, y por ello sólo existe una «debianización» del mismo. En este caso no se requiere un número de revisión.

    Por lo general la revisón-debian se reinicia con «1» cada vez que crece la versión-autor-original.

    dpkg separará el número de versión en el último guión en la cadena (si hay alguno) para determinar la versión-autor-original y la revisión-debian. La ausencia de revisión-debian se verifica antes que la presencia de la misma (pero tenga en cuenta que revisión-debian es la parte menos significativa del número de versión).

  Algoritmo de ordenación
Las partes revisión-autor-original y revisión-debian se comparan con el sistema de gestión de paquetes usando el mismo algoritmo:

Las cadenas se comparan de izquierda a derecha.

Primero se determina la parte inicial de cada cadena que consiste sólo de caracteres no numéricos. Esas dos partes (una de las cuales puede estar vacía) se comparan léxicamente. Si se encuentra una diferencia, se devuelve. La comparación léxica es una comparación de valores ASCII modificado para que todas las letras se ordenen antes que los caracteres que no son letras, de manera que la virgulilla aparezca en primer lugar, incluso antes que el fin de una sección. Por ejemplo, las siguientes partes están ordenadas: «~~», «~~a', «~», la sección vacía, «a».

Tras esto, se determina la sección inicial del resto de cada cadena que consiste sólo de dígitos. Los valores numéricos de estas dos secciones se comparan, y cualquier diferencia encontrada se devuelve como resultado de la comparación. Para este propósito, una cadena vacía (que sólo aparece al final de una o de las dos cadenas comparadas) tiene un valor de cero.

Estos dos pasos (comparar y eliminar caracteres iniciales no numéricos y numéricos del principio de las cadenas) se repiten hasta que se encuentre una diferencia o que se hayan analizado totalmente las dos cadenas.

Tenga en cuenta que el propósito del campo epoch es obviar errores en los números de versión, y para hacer frente a situaciones donde se cambia el esquema de numeración de versiones. No está diseñado para situaciones donde los números de versión tienen cadenas o letras que el gestor de paquetes no puede interpretar (como «ALPHA» o ,«pre-») o con ordenamientos confusos.

ADVERTENCIAS
El carácter de virgulilla (~) y sus propiedades especiales de búsqueda se introdujeron en la versión 1.10 de dpkg, y algunas partes de dpkg-dev sólo añadieron la compatibilidad con esto más tarde, con la serie 1.10.x.

VÉASE TAMBIÉN
deb-control(5), deb(5), dpkg(1)

TRADUCTOR
Rudy Godoy <rudy@kernel-panik.org>, Rubén Porras <nahoo@inicia.es>, Bruno Barrera C. <bruno.barrera@igloo.cl>, Carlos Izquierdo <gheesh@ertis.net>, Esteban Manchado y NOK. Debian L10n Spanish <debian-l10n-spanish@lists.debian.org>.
Revisiones por Santiago Vila <sanvila@unex.es>, Javier Fernández-Sanguino, Rubén Porras, Luis Uribe y Omar Campagne.