Provided by: dos2unix_5.3.1-1_i386 bug

NOMBRE

       dos2unix - Convertidor de archivos de texto de formato DOS/Mac a Unix y
       viceversa

SINOPSIS

           dos2unix [parámetros] [ARCHIVO ...] [-n ARCH_DE_ENTRADA ARCH_DE_SALIDA ...]
           unix2dos [parámetros] [ARCHIVO ...] [-n ARCH_DE_ENTRADA ARCH_DE_SALIDA ...]

DESCRIPCIÓN

       El paquete Dos2unix incluye las utilerías "dos2unix" y "unix2dos" para
       convertir archivos de texto plano en formato DOS o Mac a formato Unix y
       viceversa.

       En archivos de texto DOS/Windows, un salto de línea, también conocido
       como nueva línea, es una combinación de dos caracteres: un retorno de
       carro (CR) seguido por un salto de línea (LF). En archivos de texto
       Unix, un salto de línea es solamente un carácter: el salto de línea
       (LF). En archivos de texto Mac, antes de Mac OS X, un salto de línea
       era sólo un carácter retorno de carro (CR).  Actualmente, Mac OS usa el
       estilo Unix de saltos de línea (LF).

       Los archivos binarios son ignorados automáticamente, a menos que se
       fuerce su conversión.

       Los archivos no regulares, tales como directorios y FIFO, son ignorados
       automáticamente.

       Los enlaces simbólicos y sus destinos no son modificados por defecto.
       Los enlaces simbólicos pueden opcionalmente ser reemplazados, o la
       salida puede ser escrita al archivo destino del enlace.  Los enlaces
       simbólicos en Windows no están soportados. Estos son siempre
       reemplazados, sin que se alteren sus destinos.

       Dos2unix fue moldeado a partir del dos2unix que existe en SunOS/Solaris
       y tiene modos de conversión similares.

PARÁMETROS

       --  Todos los parámetros siguientes son tratados como nombres de
           archivo. Use este parámetro si desea convertir archivos cuyos
           nombres inician con un guión. Por ejemplo para convertir un archivo
           llamado "-foo", use este comando:

               dos2unix -- -foo

           O en modo de archivo nuevo:

               dos2unix -n -- -foo out.txt

       -ascii
           Sólo convierte los salto de línea. Éste es el modo de conversión
           por defecto.

       -iso
           Conversión entre el conjunto de caracteres DOS e ISO-8859-1. Véase
           también la sección MODOS DE CONVERSIÓN.

       -1252
           Usa la página de códigos Windows 1252 (Europa Occidental).

       -437
           Usa la página de códigos DOS 437 (EE. UU.). Está es la página de
           códigos usada por defecto para conversión ISO.

       -850
           Usa la página de códigos DOS 850 (Europa Occidental).

       -860
           Usa la página de códigos DOS 860 (Portugués).

       -863
           Usa la página de códigos DOS 863 (Francocanadiense).

       -865
           Usa la página de códigos DOS 865 (Nórdico).

       -7  Convierte caracteres de 8 bits al espacio de 7 bits.

       -c, --convmode CONVMODE
           Establece el modo de conversión, Donde CONVMODE puede ser: ascii,
           7bit, iso, mac siendo ascii el valor por defecto.

       -f, --force
           Fuerza la conversión de archivos binarios.

       -h, --help
           Despiega la ayuda y termina el programa.

       -k, --keepdate
           Mantiene la fecha del archivo de salida igual a la del archivo de
           entrada.

       -L, --license
           Muestra la licencia del programa.

       -l, --newline
           Añade salto de línea adicional.

           dos2unix: Sólo los saltos de línea DOS son cambiados por dos saltos
           de línea Unix.  En modo Mac sólo los saltos de línea Mac son
           cambiados por dos saltos de línea Unix.

           unix2dos: Sólo los saltos de línea Unix son cambiados por dos
           saltos de línea DOS.  En modo Mac los saltos de línea Unix son
           cambiados por dos saltos de línea Mac.

       -n, --newfile ARCH_DE_ENTRADA ARCH_DE_SALIDA ...
           Modo de archivo nuevo. Convierte el archivo ARCH_DE_ENTRADA y
           escribe la salida al archivo ARCH_DE_SALIDA.  Los nombres de
           archivo deben ser dados en pares y los comodines no deben ser
           usados o perder sus archivos.

       -o, --oldfile ARCHIVO ...
           Modo de archivo viejo. Convierte el archivo ARCHIVO y lo
           sobrescribe con la salida.  El programa por defecto se ejecuta en
           este modo. Sí se pueden emplear comodines.

       -q, --quiet
           Modo silencioso. Suprime todas las advertencias y mensajes. El
           valor retornado es cero. Excepto cuando se emplean parámetros
           incorrectos.

       -s, --safe
           Ignora los archivos binarios (por defecto).

       -F, --follow-symlink
           Sigue los enlaces simbólicos y convierte los destinos.

       -R, --replace-symlink
           Reemplaza los enlaces simbólicos con los archivos convertidos (los
           archivos destino originales no se alteran).

       -S, --skip-symlink
           No altera los enlaces simbólicos ni sus destinos (por defecto).

       -V, --version
           Despiega la información de la versión y termina el programa.

MODO MAC

       En modo normal los saltos de línea son convertidos de DOS a Unix y
       viceversa.  Los saltos de línea Mac no son convertidos.

       En modo Mac los saltos de línea son convertidos de Mac a Unix y
       viceversa. Los saltos de línea DOS no son modificados.

       Para ejecutar en modo Mac use el modificador "-c mac" o use los
       comandos "mac2unix" o "unix2mac".

MODOS DE CONVERSIÓN

       Los modos de conversión ascii, 7bit, e iso son similares a los de los
       comandos dos2unix/unix2dos de SunOS/Solaris.

       ascii
           En modo "ascii" sólo los saltos de línea son convertidos. Éste es
           el modo de conversión por defecto.

           Aunque el nombre de este modo es ASCII, el cual es un estándar de 7
           bits, éste emplea 8 bits. Siempre use este modo cuando convierta
           archivos en Unicode UTF-8.

       7bit
           En este modo todos los caracteres no ASCII de 8 bits (con valores
           de 128 a 255) son convertidos al espacio de 7 bits.

       iso Los caracteres son convertidos entre un conjunto de caracteres DOS
           (página de códigos) y el conjunto de caracteres ISO-8859-1
           (Latín-1) de Unix. Los caracteres DOS sin equivalente ISO-8859-1,
           para los cuales la conversión es imposible, son convertidos en un
           punto. Lo mismo se aplica para caracteres ISO-8859-1 sin
           contraparte DOS.

           Cuando sólo se emplea el parámetro "-iso", dos2unix intentará
           determinar la página de códigos activa. Cuando esto no sea posible,
           dos2unix utilizará la página de códigos 437 por defecto, la cual es
           empleada principalmente en EE. UU.  Para forzar una página de
           códigos específica emplee los parámetros "-437" (EE. UU.), "-850"
           (Europa Occidental), "-860" (Portugués), "-863" (Francocanadiense),
           o "-865" (Nórdico). La página de códigos Windows 1252 (Europa
           Occidental) también está soportada con el parámetro "-1252". Para
           acceder a otras páginas de códigos use dos2unix en combinación con
           iconv(1).  Iconv puede convertir entre una larga lista de
           codificaciones de caracteres.

           Algunos ejemplos:

           Convierte de la página de códigos por defecto de DOS a Latín-1 de
           Unix.

               dos2unix -iso -n in.txt out.txt

           Convierte de DOS 850 a Unix Latín-1.

               dos2unix -850 -n in.txt out.txt

           Convierte de Windows 1252 a Unix Latín-1.

               dos2unix -1252 -n in.txt out.txt

           Convierte de Windows 1252 a Unix UTF-8 (Unicode).

               iconv -f CP1252 -t UTF-8 in.txt | dos2unix > out.txt

           Convierte de Windows UTF-16 (Unicode) a Unix UTF-8 (Unicode).

               iconv -f UTF-16 -t UTF-8 in.txt | dos2unix > out.txt

           Convierte de Unix Latín-1 a la página de códigos por defecto de
           DOS.

               unix2dos -iso -n in.txt out.txt

           Convierte de Unix Latín-1 a DOS 850.

               unix2dos -850 -n in.txt out.txt

           Convierte de Unix Latín-1 a Windows 1252.

               unix2dos -1252 -n in.txt out.txt

           Convierte de Unix UTF-8 (Unicode) a Windows 1252.

               unix2dos < in.txt | iconv -f UTF-8 -t CP1252 > out.txt

           Convierte de Unix UTF-8 (Unicode) a Windows UTF-16 (Unicode).

               unix2dos < in.txt | iconv -f UTF-8 -t UTF-16 > out.txt

           Véase también <http://czyborra.com/charsets/codepages.html> y
           <http://czyborra.com/charsets/iso8859.html>.

UNICODE

       Existen diferentes codificaciones Unicode. En Unix/Linux los archivos
       Unicode están en su mayoría codificados en UTF-8. UTF-8 es compatible
       con ASCII. Los archivos UTF-8 pueden tener saltos de línea DOS, Unix o
       Mac. Es seguro ejecutar dos2unix/unix2dos en archivos codificados con
       UTF-8. En Windows la codificación UTF-16 es mayormente empleada para
       los archivos Unicode.  Dos2unix/unix2dos no deberá ser ejecutado en
       archivos UTF-16. Los archivos UTF-16 son ignorados automáticamente,
       dado que se consideran binarios.

EJEMPLOS

       Lee la entrada desde 'stdin' y escribe la salida a 'stdout'.

           dos2unix
           dos2unix -l -c mac

       Convierte y reemplaza a.txt. Convierte y reemplaza b.txt.

           dos2unix a.txt b.txt
           dos2unix -o a.txt b.txt

       Convierte y reemplaza a.txt empleando modo de conversión ascii.

           dos2unix a.txt

       Convierte y reemplaza a.txt empleando modo de conversión ascii.
       Convierte y reemplaza b.txt empleando modo de conversión de 7bits.

           dos2unix a.txt -c 7bit b.txt
           dos2unix -c ascii a.txt -c 7bit b.txt
           dos2unix -ascii a.txt -7 b.txt

       Convierte a.txt del formato de Mac a Unix.

           dos2unix -c mac a.txt
           mac2unix a.txt

       Convierte a.txt del formato de Unix a Mac.

           unix2dos -c mac a.txt
           unix2mac a.txt

       Convierte y reemplaza a.txt manteniendo la fecha del archivo original.

           dos2unix -k a.txt
           dos2unix -k -o a.txt

       Convierte a.txt y escribe la salida a e.txt.

           dos2unix -n a.txt e.txt

       Convierte a.txt y escribe la salida a e.txt, manteniendo la fecha de
       e.txt igual a la de a.txt.

           dos2unix -k -n a.txt e.txt

       Convierte y reemplaza a.txt. Convierte b.txt y escribe a e.txt.

           dos2unix a.txt -n b.txt e.txt
           dos2unix -o a.txt -n b.txt e.txt

       Convierte c.txt y escribe a e.txt. Convierte y reemplaza a.txt.
       Convierte y reemplaza b.txt. Convierte d.txt y escribe a f.txt.

           dos2unix -n c.txt e.txt -o a.txt b.txt -n d.txt f.txt

INTERNACIONALIZACIÓN

       LANG
           El idioma principal se selecciona con la variable de entorno LANG.
           La variable LANG consiste de varias partes. La primer parte es el
           código del idioma en minúsculas. La segunda es opcional y es el
           código del país en mayúsculas, precedido por un guión bajo. Existe
           también una tercera parte opcional: la codificación de caracteres,
           precedida por un punto. Unos cuantos ejemplos para intérpretes de
           comandos tipo POSIX estándar:

               export LANG=nl               Neerlandés
               export LANG=nl_NL            Neerlandés, Países Bajos
               export LANG=nl_BE            Neerlandés, Bélgica
               export LANG=es_ES            Español, España
               export LANG=es_MX            Español, México
               export LANG=en_US.iso88591   Ingles, EE. UU., codificación Latín-1
               export LANG=en_GB.UTF-8      Ingles, Reino Unido, codificación UTF-8

           Para una lista completa de códigos de idioma y país véase el manual
           de gettext:
           http://www.gnu.org/software/gettext/manual/gettext.html#Language-Codes
           <http://www.gnu.org/software/gettext/manual/gettext.html#Language-
           Codes>

           En sistemas Unix puede emplear el comando locale(1) para obtener
           información específica del locale.

       LANGUAGE
           Con la variable de entorno LANGUAGE puede especificar una lista de
           prioridad de los idiomas, separados por dos puntos. Dos2unix da
           preferencia a LANGUAGE por encima de LANG. Por ejemplo, primero
           neerlandés y entonces alemán: "LANGUAGE=nl:de". Antes de que pueda
           usar una lista de prioridad de idiomas a través de la variable
           LANGUAGE, primero tiene que habilitar la internacionalización,
           mediante asignar un valor distinto de "C" a LANG (o LC_ALL). Véase
           también el manual de gettext:
           http://www.gnu.org/software/gettext/manual/gettext.html#The-LANGUAGE-variable
           <http://www.gnu.org/software/gettext/manual/gettext.html#The-
           LANGUAGE-variable>

           Si selecciona un idioma que no está disponible el programa
           funcionará en ingles.

       DOS2UNIX_LOCALEDIR
           Con la variable de entorno DOS2UNIX_LOCALEDIR el LOCALEDIR asignado
           durante la compilación puede ser modificado. LOCALEDIR es usado
           para encontrar los archivos de idioma. El valor por defecto de GNU
           es "/usr/local/share/locale".  El parámetro --version desplegará el
           LOCALEDIR en uso.

           Ejemplo (intérprete de comandos POSIX):

               export DOS2UNIX_LOCALEDIR=$HOME/share/locale

VALOR DE RETORNO

       Se regresa cero cuando el programa termina exitosamente. Cuando ocurre
       un error del sistema se regresará el número de error del sistema. Para
       otros errores se regresa 1.

       El valor de retorno es siempre cero en modo silencioso, excepto cuando
       se emplean parámetros incorrectos.

ESTÁNDARES

       http://es.wikipedia.org/wiki/Documento_de_texto
       http://es.wikipedia.org/wiki/Retorno_de_carro
       http://es.wikipedia.org/wiki/Nueva_l%C3%ADnea

AUTORES

       Benjamin Lin - <blin@socs.uts.edu.au> Bernd Johannes Wuebben (modo
       mac2unix) - <wuebben@kde.org>, Christian Wurll (añadió el salto de
       línea extra) - <wurll@ira.uka.de>, Erwin Waterlander -
       <waterlan@xs4all.nl> (Mantenimiento)

       Página del proyecto: <http://www.xs4all.nl/~waterlan/dos2unix.html>

       Página de SourceForge: <http://sourceforge.net/projects/dos2unix/>

       Freshmeat: <http://freshmeat.net/projects/dos2unix>

VÉASE TAMBIÉN

       file(1) iconv(1)