Imported Upstream version 7.3.1
[platform/upstream/dos2unix.git] / README.txt
index 16bdd16..41d2109 100644 (file)
@@ -4,49 +4,60 @@ dos2unix - DOS/Mac to Unix and vice versa text file format converter.
 
 FILE LIST
 
-        README.txt      : This file.
-        INSTALL.txt     : How to build and install.
-        COPYING.txt     : distribution license.
-        NEWS.txt        : Basic change log for users.
-        ChangeLog.txt   : Detailed change log for programmers.
-        TODO.txt        : Things to do.
-        BUGS.txt        : Known bugs and instructions on reporting new ones.
-        dos2unix.txt    : Dos2unix manual, text format.
-        dos2unix.ps     : Dos2unix manual, PostScript format.
-        dos2unix.pdf    : Dos2unix manual, PDF format.
-        dos2unix.htm    : Dos2unix manual, HTML format.
+        README.txt            : This file.
+        INSTALL.txt           : How to build and install.
+        COPYING.txt           : distribution license.
+        NEWS.txt              : Basic change log for users.
+        ChangeLog.txt         : Detailed change log for programmers.
+        TODO.txt              : Things to do.
+        BUGS.txt              : Known bugs and instructions on reporting new ones.
+        man/man1/dos2unix.txt : Dos2unix manual, text format.
+        man/man1/dos2unix.htm : Dos2unix manual, HTML format.
+
+
+PROJECT HOME PAGE
+
+        http://waterlan.home.xs4all.nl/dos2unix.html
 
 
 HISTORY
 
         This is an update of Benjamin Lin's implementations of dos2unix and
-        unix2dos.  Benjamin Lin's implementations of dos2unix and unix2dos are
-        part of several Linux distributions such as RedHat, Fedora, Suse and
-        others.  This update includes all RedHat patches and fixes several
-        other problems.  Internationalization has been added and ports to DOS,
-        Windows, Cygwin and OS/2 Warp have been made.
+        unix2dos.  Benjamin Lin's implementations of dos2unix and unix2dos were
+        distributed via SunSITE.unc.edu (later MetaLab.unc.edu, now ibiblio)
+        and became part of several Linux distributions such as RedHat, Suse,
+        Gentoo, and others. This update includes all RedHat patches and fixes
+        several other problems. Internationalization has been added and ports
+        to DOS, Windows, Cygwin and OS/2 Warp have been made.
 
         These implementations of dos2unix and unix2dos have been modelled after
-        dos2unix/unix2dos under SunOS/Solaris.  They have similar conversion
-        modes, namely ascii, 7bit and iso.  The first versions were made by
+        dos2unix/unix2dos under SunOS/Solaris. The first versions were made by
         John Birchfield in 1989, and in 1995 rewritten from scratch by Benjamin
         Lin. Mac to Unix conversion was added by Bernd Johannes Wuebben in
         1998, Unix to Mac conversion by Erwin Waterlander in 2010.
 
+        In 2010 the two separate dos2unix and unix2dos packages have been
+        bundled into a single dos2unix package (version 5.0). Support for
+        Unicode UTF-16 was added in 2012 (version 6.0). Version 7.0, in 2014,
+        was a major code cleanup and added a test suite. 
+
+
         Features
 
-        * Native language support: Dutch, English, Esperanto, German, Spanish.
-        * Automatically skips binary and non-regular files
+        * Native language support.
+        * Automatically skips binary and non-regular files.
         * In-place, paired, or stdio mode conversion.
         * Keep original file dates option.
         * 7-bit and iso conversion modes like SunOS dos2unix.
-        * Conversion of Windows UTF-16 files to Unix UTF-8.
+        * Conversion of Unicode UTF-16 files.
+        * Handles Unicode Byte Order Mark (BOM).
+        * Display file information.
         * Secure.
 
 
 AUTHORS
 
-        Erwin Waterlander       version 3.2-6.0.3  2009-2013
+        Erwin Waterlander       version 3.2-7.3.1  2009-2015
         Christian Wurll         version 3.1        1998
         Bernd Johannes Wuebben  version 3.0        1998
         Benjamin Lin            version 1.1-2.3    1994-1995
@@ -54,17 +65,60 @@ AUTHORS
 
 TRANSLATORS
 
-        Dutch           Erwin Waterlander <waterlan@xs4all.nl>
-        Esperanto       Rugxulo <rugxulo@gmail.com>
-        German          Philipp Thomas <psmt@opensuse.org>
-        Spanish         Julio A. Freyre-Gonzalez <jfreyreg@gmail.com>
+        Since verion 6.0.5 dos2unix is part of the Translation Project (TP).
+        All translations go via the Translation Project.
+
+        Translation of the messages.
+        See http://translationproject.org/domain/dos2unix.html
+
+        Brazilian Portuguese  Enrico Nicoletto             Version 6.0.5
+        Brazilian Portuguese  Rafael Ferreira              Version 6.0.6 - 7.2
+        Chinese (simplified)  zwpwjwtz                     Version 7.3.1
+        Chinese (traditional) mail6543210                  Version 6.0.5
+        Danish                Thomas Pryds                 Version 6.0.5 - 6.0.6
+        Danish                Joe Hansen                   Version 7.2.3 - 7.3
+        Dutch                 Erwin Waterlander            Version 4.0   - 6.0.4
+        Dutch                 Benno Schulenberg            Version 6.0.5 - 7.3.1
+        Esperanto             Rugxulo                      Version 5.1   - 6.0.4
+        Esperanto             Benno Schulenberg            Version 6.0.5 - 7.3
+        French                Frédéric Marchal             Version 6.0.5 - 7.3.1
+        German                Philipp Thomas               Version 5.0   - 6.0.3, 7.0,
+                                                           7.2.2 - 7.3.1
+        German                Lars Wendler                 Version 6.0.4
+        German                Mario Blättermann            Version 6.0.6, 7.1 - 7.2
+        Hungarian             Balázs Úr                    Version 6.0.5 - 7.2.3
+        Japanese              Yasuaki Taniguchi            Version 7.1.1
+        Norwegian Bokmaal     Åka Sikrom                   Version 6.0.6 - 7.3.1
+        Polish                Jakub Bogusz                 Version 6.0.5 - 7.3.1
+        Russian               Андрей Углик (Andrei Uhlik)  Version 6.0.4
+        Russian               Yuri Kozlov                  Version 6.0.6 - 7.3.1
+        Serbian               Мирослав Николић             Version 6.0.5 - 7.2.2
+        Spanish               Julio A. Freyre-Gonzalez     Version 5.3.1 - 6.0.4
+        Spanish               Enrique Lazcorreta Puigmartí Version 6.0.6 - 7.3.1
+        Ukrainian             Yuri Chornoivan              Version 6.0.5 - 7.3.1
+        Vietnamese            Trần Ngọc Quân               Version 6.0.5 - 7.3.1
+
+        Translation of the manual.
+        See http://translationproject.org/domain/dos2unix-man.html
+
+        Brazilian Portuguese  Rafael Ferreira              Version 6.0.5 - 7.2
+        Chinese (simplified)  zwpwjwtz                     Version 7.3.1
+        Dutch                 Erwin Waterlander            Version 5.1.1 - 6.0.4
+        Dutch                 Benno Schulenberg            Version 6.0.5 - 7.3.1
+        French                Frédéric Marchal             Version 6.0.5 - 7.3.1
+        German                Mario Blättermann            Version 6.0.5 - 7.3.1
+        Polish                Jakub Bogusz                 Version 6.0.5 - 7.3.1
+        Spanish               Julio A. Freyre-Gonzalez     Version 5.3.1 - 6.0.4
+        Spanish               Enrique Lazcorreta Puigmartí Version 6.0.6 - 7.2.1
+        Ukrainian             Yuri Chornoivan              Version 6.0.5 - 7.3.1
+
 
 ACKNOWLEDGEMENTS
 
         Rugxulo               query_con_codepage(), code page detection in DOS.
         Rugxulo               DJGPP stubs for mac2unix and unix2mac.
         Jari Aalto            Improvements man page.
-        Jari Aalto            Improvments Makefile.
+        Jari Aalto            Improvements Makefile.
         Ben Pfaff             Treat form feeds as valid text.
         Marc Gianzero         Darwin OS port.
         Elbert Pol            OS/2 port.
@@ -79,7 +133,26 @@ ACKNOWLEDGEMENTS
         Steven H. Levine      Support wildcard expansion on OS/2.
         Steve Hay             Support wildcard expansion on win64.
         Michael Schindler     Fixed compiler warning.
-       Somsak Pattanaprateep Print line number when binary symbol is found.
+        Somsak Pattanaprateep Print line number when binary symbol is found.
+        Justin Lecher         Makefile improvement.
+        F.J. Brandelik        Reported problems when win32 version processes
+                              huge files on a network drive.
+        Benno Schulenberg     Cleaning up the UI messages.
+        Mario Blättermann     Generate pod files from gettext po files with po4a.
+        Daniel Macks          Reported dependency on GNU sed.
+        Alan S. Jones         Reported bug in UTF-16 conversion by mac2unix.
+        Alan S. Jones         Idea for an info option, to list file statistics
+                              about line breaks and byte order marks.
+        Gary Johnson          Idea for an info option, to list only files which have
+                              DOS line breaks, or only files with Unix line breaks.
+        Helmut Karlowski      Makefile and PrintVersion() update for freeMiNT.
+        Tom Christiansen      Fix for wrong title in HTML manuals.
+        Armin Müller          Fixed typo in if condition in write_bom().
+        Philip Rowlands       Reported that dos2unix was not checking for file I/O
+                              errors while reading the input.
+        Baruch Siach          Fix compilation error "'wchar_t' undeclared"
+                              when Unicode support is disabled.
+
 
 FINDUTILS
 
@@ -93,11 +166,13 @@ FINDUTILS
 
 CONTACT INFORMATION
 
-        Project page             : http://waterlan.home.xs4all.nl/dos2unix.html
+        Project home page        : http://waterlan.home.xs4all.nl/dos2unix.html
         SourceForge project page : http://sourceforge.net/projects/dos2unix/
-        Freecode project page    : http://freecode.com/projects/dos2unix/
 
         Erwin Waterlander
         waterlan@xs4all.nl
         http://waterlan.home.xs4all.nl/
 
+        If you need support you can email me directly or make a ticket on the
+        SourceForge project page. Help in any form is appreciated. A problem
+        report, a fix, or just a remark.