Imported Upstream version 7.1
[platform/upstream/dos2unix.git] / README.txt
1
2 dos2unix - DOS/Mac to Unix and vice versa text file format converter.
3
4
5 FILE LIST
6
7         README.txt            : This file.
8         INSTALL.txt           : How to build and install.
9         COPYING.txt           : distribution license.
10         NEWS.txt              : Basic change log for users.
11         ChangeLog.txt         : Detailed change log for programmers.
12         TODO.txt              : Things to do.
13         BUGS.txt              : Known bugs and instructions on reporting new ones.
14         man/man1/dos2unix.txt : Dos2unix manual, text format.
15         man/man1/dos2unix.htm : Dos2unix manual, HTML format.
16
17
18 PROJECT HOME PAGE
19
20         http://waterlan.home.xs4all.nl/dos2unix.html
21
22
23 HISTORY
24
25         This is an update of Benjamin Lin's implementations of dos2unix and
26         unix2dos.  Benjamin Lin's implementations of dos2unix and unix2dos were
27         distributed via SunSITE.unc.edu (later MetaLab.unc.edu, now ibiblio)
28         and became part of several Linux distributions such as RedHat, Suse,
29         Gentoo, and others. This update includes all RedHat patches and fixes
30         several other problems. Internationalization has been added and ports
31         to DOS, Windows, Cygwin and OS/2 Warp have been made.
32
33         These implementations of dos2unix and unix2dos have been modelled after
34         dos2unix/unix2dos under SunOS/Solaris. The first versions were made by
35         John Birchfield in 1989, and in 1995 rewritten from scratch by Benjamin
36         Lin. Mac to Unix conversion was added by Bernd Johannes Wuebben in
37         1998, Unix to Mac conversion by Erwin Waterlander in 2010.
38
39         In 2010 the two separate dos2unix and unix2dos packages have been
40         bundled into a single dos2unix package (version 5.0). Support for
41         Unicode UTF-16 was added in 2012 (version 6.0).
42
43
44         Features
45
46         * Native language support.
47         * Automatically skips binary and non-regular files.
48         * In-place, paired, or stdio mode conversion.
49         * Keep original file dates option.
50         * 7-bit and iso conversion modes like SunOS dos2unix.
51         * Conversion of Unicode UTF-16 and UTF-8 files.
52         * Conversion of UTF-16 files to UTF-8.
53         * Handles Unicode Byte Order Mark (BOM).
54         * Display file information.
55         * Secure.
56
57
58 AUTHORS
59
60         Erwin Waterlander       version 3.2-7.1    2009-2014
61         Christian Wurll         version 3.1        1998
62         Bernd Johannes Wuebben  version 3.0        1998
63         Benjamin Lin            version 1.1-2.3    1994-1995
64         John Birchfield         version 1.0        1989
65
66 TRANSLATORS
67
68         Since verion 6.0.5 dos2unix is part of the Translation Project (TP).
69         All translations go via the Translation Project.
70
71         Translation of the messages.
72         See http://translationproject.org/domain/dos2unix.html
73
74         Brazilian Portuguese  Enrico Nicoletto             Version 6.0.5
75         Brazilian Portuguese  Rafael Ferreira              Version 6.0.6 - 7.1
76         Chinese (traditional) mail6543210                  Version 6.0.5
77         Danish                Thomas Pryds                 Version 6.0.5 - 6.0.6
78         Dutch                 Erwin Waterlander            Version 4.0   - 6.0.4
79         Dutch                 Benno Schulenberg            Version 6.0.5 - 7.1
80         Esperanto             Rugxulo                      Version 5.1   - 6.0.4
81         Esperanto             Benno Schulenberg            Version 6.0.5 - 7.1
82         French                Frédéric Marchal             Version 6.0.5 - 7.0
83         German                Philipp Thomas               Version 5.0   - 6.0.3, 7.0
84         German                Lars Wendler                 Version 6.0.4
85         German                Mario Blättermann            Version 6.0.6, 7.1
86         Hungarian             Balázs Úr                    Version 6.0.5 - 7.1
87         Norwegian Bokmaal     Åka Sikrom                   Version 6.0.6 - 7.1
88         Polish                Jakub Bogusz                 Version 6.0.5 - 7.1
89         Russian               Андрей Углик (Andrei Uhlik)  Version 6.0.4
90         Russian               Yuri Kozlov                  Version 6.0.6 - 7.1
91         Serbian               Мирослав Николић             Version 6.0.5 - 6.0.6
92         Spanish               Julio A. Freyre-Gonzalez     Version 5.3.1 - 6.0.4
93         Spanish               Enrique Lazcorreta Puigmartí Version 6.0.6
94         Ukrainian             Yuri Chornoivan              Version 6.0.5 - 7.1
95         Vietnamese            Trần Ngọc Quân               Version 6.0.5 - 7.1
96
97         Translation of the manual.
98         See http://translationproject.org/domain/dos2unix-man.html
99
100         Brazilian Portuguese  Rafael Ferreira              Version 6.0.5 - 7.1
101         Dutch                 Erwin Waterlander            Version 5.1.1 - 6.0.4
102         Dutch                 Benno Schulenberg            Version 6.0.5 - 7.1
103         French                Frédéric Marchal             Version 6.0.5 - 7.0
104         German                Mario Blättermann            Version 6.0.5 - 7.1
105         Hungarian             Balázs Úr                    Version 6.0.6
106         Polish                Jakub Bogusz                 Version 6.0.5 - 7.1
107         Spanish               Julio A. Freyre-Gonzalez     Version 5.3.1 - 6.0.4
108         Spanish               Enrique Lazcorreta Puigmartí Version 6.0.6
109         Ukrainian             Yuri Chornoivan              Version 6.0.5 - 7.1
110
111
112 ACKNOWLEDGEMENTS
113
114         Rugxulo               query_con_codepage(), code page detection in DOS.
115         Rugxulo               DJGPP stubs for mac2unix and unix2mac.
116         Jari Aalto            Improvements man page.
117         Jari Aalto            Improvements Makefile.
118         Ben Pfaff             Treat form feeds as valid text.
119         Marc Gianzero         Darwin OS port.
120         Elbert Pol            OS/2 port.
121         Tim Waugh             Various patches.
122         Mike Harris           Man page update.
123         Bernard RosenKraenzer segfault patch.
124         Tim Powers            mkstemp patch.
125         Miloslav Trmac        safeconv patch.
126         Charles Wilson        Follow symbolic links.
127         Charles Wilson        Makefile and code cleanup for Cygwin.
128         Christopher Williams  Maintain file ownership in old file mode.
129         Steven H. Levine      Support wildcard expansion on OS/2.
130         Steve Hay             Support wildcard expansion on win64.
131         Michael Schindler     Fixed compiler warning.
132         Somsak Pattanaprateep Print line number when binary symbol is found.
133         Justin Lecher         Makefile improvement.
134         F.J. Brandelik        Reported problems when win32 version processes
135                               huge files on a network drive.
136         Benno Schulenberg     Cleaning up the UI messages.
137         Mario Blättermann     Generate pod files from gettext po files with po4a.
138         Daniel Macks          Reported dependency on GNU sed.
139         Alan S. Jones         Reported bug in UTF-16 conversion by mac2unix.
140         Alan S. Jones         Idea for an info option, to list file statistics
141                               about line breaks and byte order marks.
142         Gary Johnson          Idea for an info option, to list only files which have
143                               DOS line breaks, or only files with Unix line breaks.
144         Helmut Karlowski      Makefile and PrintVersion() update for freeMiNT.
145
146
147 FINDUTILS
148
149         Windows users who are looking for the Unix 'find' and 'xargs' commands
150         can find them in the findutils package for Windows at the ezwinports
151         project page at: http://sourceforge.net/projects/ezwinports/files/
152
153         A DOS version of the findutils package can be obtained from the DJGPP
154         project (http://www.delorie.com/djgpp/) at
155         ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/
156
157 CONTACT INFORMATION
158
159         Project home page        : http://waterlan.home.xs4all.nl/dos2unix.html
160         SourceForge project page : http://sourceforge.net/projects/dos2unix/
161
162         Erwin Waterlander
163         waterlan@xs4all.nl
164         http://waterlan.home.xs4all.nl/
165
166         If you need support you can email me directly or make a ticket on the
167         SourceForge project page. Help in any form is appreciated. A problem
168         report, a fix, or just a remark.