6e209ed0569eba3abf7c75f8fb913643e8cdcc56
[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         * Secure.
55
56
57 AUTHORS
58
59         Erwin Waterlander       version 3.2-7.0    2009-2014
60         Christian Wurll         version 3.1        1998
61         Bernd Johannes Wuebben  version 3.0        1998
62         Benjamin Lin            version 1.1-2.3    1994-1995
63         John Birchfield         version 1.0        1989
64
65 TRANSLATORS
66
67         Since verion 6.0.5 dos2unix is part of the Translation Project (TP).
68         All translations go via the Translation Project.
69
70         Translation of the messages.
71         See http://translationproject.org/domain/dos2unix.html
72
73         Brazilian Portuguese  Enrico Nicoletto             Version 6.0.5
74         Brazilian Portuguese  Rafael Ferreira              Version 6.0.6 - 7.0
75         Chinese (traditional) mail6543210                  Version 6.0.5
76         Danish                Thomas Pryds                 Version 6.0.5 - 6.0.6
77         Dutch                 Erwin Waterlander            Version 4.0   - 6.0.4
78         Dutch                 Benno Schulenberg            Version 6.0.5 - 7.0
79         Esperanto             Rugxulo                      Version 5.1   - 6.0.4
80         Esperanto             Benno Schulenberg            Version 6.0.5 - 7.0
81         French                Frédéric Marchal             Version 6.0.5 - 7.0
82         German                Philipp Thomas               Version 5.0   - 6.0.3, 7.0
83         German                Lars Wendler                 Version 6.0.4
84         German                Mario Blättermann            Version 6.0.6
85         Hungarian             Balázs Úr                    Version 6.0.5 - 6.0.6
86         Norwegian Bokmaal     Åka Sikrom                   Version 6.0.6 - 7.0
87         Polish                Jakub Bogusz                 Version 6.0.5 - 7.0
88         Russian               Андрей Углик (Andrei Uhlik)  Version 6.0.4
89         Russian               Yuri Kozlov                  Version 6.0.6 - 7.0
90         Serbian               Мирослав Николић             Version 6.0.5 - 6.0.6
91         Spanish               Julio A. Freyre-Gonzalez     Version 5.3.1 - 6.0.4
92         Spanish               Enrique Lazcorreta Puigmartí Version 6.0.6
93         Ukrainian             Yuri Chornoivan              Version 6.0.5 - 7.0
94         Vietnamese            Trần Ngọc Quân               Version 6.0.5 - 7.0
95
96         Translation of the manual.
97         See http://translationproject.org/domain/dos2unix-man.html
98
99         Brazilian Portuguese  Rafael Ferreira              Version 6.0.5 - 7.0
100         Dutch                 Erwin Waterlander            Version 5.1.1 - 6.0.4
101         Dutch                 Benno Schulenberg            Version 6.0.5 - 7.0
102         French                Frédéric Marchal             Version 6.0.5 - 7.0
103         German                Mario Blättermann            Version 6.0.5 - 7.0
104         Hungarian             Balázs Úr                    Version 6.0.6
105         Polish                Jakub Bogusz                 Version 6.0.5 - 7.0
106         Spanish               Julio A. Freyre-Gonzalez     Version 5.3.1 - 6.0.4
107         Spanish               Enrique Lazcorreta Puigmartí Version 6.0.6
108         Ukrainian             Yuri Chornoivan              Version 6.0.5 - 7.0
109
110
111 ACKNOWLEDGEMENTS
112
113         Rugxulo               query_con_codepage(), code page detection in DOS.
114         Rugxulo               DJGPP stubs for mac2unix and unix2mac.
115         Jari Aalto            Improvements man page.
116         Jari Aalto            Improvements Makefile.
117         Ben Pfaff             Treat form feeds as valid text.
118         Marc Gianzero         Darwin OS port.
119         Elbert Pol            OS/2 port.
120         Tim Waugh             Various patches.
121         Mike Harris           Man page update.
122         Bernard RosenKraenzer segfault patch.
123         Tim Powers            mkstemp patch.
124         Miloslav Trmac        safeconv patch.
125         Charles Wilson        Follow symbolic links.
126         Charles Wilson        Makefile and code cleanup for Cygwin.
127         Christopher Williams  Maintain file ownership in old file mode.
128         Steven H. Levine      Support wildcard expansion on OS/2.
129         Steve Hay             Support wildcard expansion on win64.
130         Michael Schindler     Fixed compiler warning.
131         Somsak Pattanaprateep Print line number when binary symbol is found.
132         Justin Lecher         Makefile improvement.
133         F.J. Brandelik        Reported problems when win32 version processes
134                               huge files on a network drive.
135         Benno Schulenberg     Cleaning up the UI messages.
136         Mario Blättermann     Generate pod files from gettext po files with po4a.
137         Daniel Macks          Reported dependency on GNU sed.
138         Alan S. Jones         Reported bug in UTF-16 conversion by mac2unix.
139
140 FINDUTILS
141
142         Windows users who are looking for the Unix 'find' and 'xargs' commands
143         can find them in the findutils package for Windows at the ezwinports
144         project page at: http://sourceforge.net/projects/ezwinports/files/
145
146         A DOS version of the findutils package can be obtained from the DJGPP
147         project (http://www.delorie.com/djgpp/) at
148         ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/
149
150 CONTACT INFORMATION
151
152         Project home page        : http://waterlan.home.xs4all.nl/dos2unix.html
153         SourceForge project page : http://sourceforge.net/projects/dos2unix/
154
155         Erwin Waterlander
156         waterlan@xs4all.nl
157         http://waterlan.home.xs4all.nl/
158
159         If you need support you can email me directly or make a ticket on the
160         SourceForge project page. Help in any form is appreciated. A problem
161         report, a fix, or just a remark.