hd2u 0.8.0 - development release (2001/??/??) Copyright 1999,.. by Peter Hanecak <hanecak@megaloman.sk>. All rights reserved. Description ----------- hd2u is Hany's DOS <-> Unix convertor. dos2unix is filter used to convert plain texts from DOS (CR/LF) format to UNIX format (CR) and vice versa. Copying ------- This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. See the COPYING file for license information. Requirements ------------ popt: is required to process command line arguments. For more information about popt see <http://freshmeat.net/projects/popt/>. Sources can be downloaded from <ftp://ftp.rpm.org/pub/rpm/dist/rpm-4.0.x/>. RPM package of popt can be found for example at <http://rpmfind.net/linux/RPM/popt.html>. Download -------- You can find sources at: http://www.megaloman.com/~hany/_data/hd2u/ http://terminus.sk/~hany/_data/hd2u/ Also you can download RPM packages from: http://www.megaloman.com/~hany/RPM/hd2u.html To verify files, use my public key: <http://www.megaloman.com/~hany/gnupg-hany-public-key.txt>. Instalation ----------- To install this package under a Unix derivative, read the INSTALL file. Usage ----- dos2unix [--verbose|-v] [--test|-t] [--d2u|--u2d|--auto|-D|-U|-A] [<file name> [...]] --auto, -A output will be set based upon autodetection of source format --d2u, -U output will be in UNIX format --u2d, -D output will be in DOS format --skipbin, -b skip binary files --test, -t don't write any conversion results; usefull with --verbose to just report on source type --verbose, -v print extra information on stderr When no options are given then input format will be automatically detected and converted to another format on output (same as --auto option). When no file is given, then stdin is used as input and stdout as output. When concrete conversion type is used (--d2u or --u2d option) and file format is autodetected as target format, file is skipped - not touched - so there is no modification time change. Binary files will be skipped automatically if option --skipbin (or -b) is used. Stray '\r' characters (without a following '\n') are reported but only conversion 'DOS -> Unix' affects them (they are skipped). You can display usage information using 'dos2unix -h' or 'dos2unix --help'. Examples: - this converts README.txt into DOS format; if README.txt is in UNIX format, it is converted otherwise it will be unchanged: dos2unix --u2d README.txt - this is obvious: cat source_in_UNIX_format.txt | dos2unix > result_in_DOS_format.txt - this will just "copy" source.txt to unchanged_source.txt: cat source.txt | dos2unix | dos2unix > unchanged_source.txt - this will convert all .txt files in current directory into UNIX format, all documents in UNIX format and all binary files are skipped, verbose information will be displayed: dos2unix -Ubv *.txt Maintainer ---------- I (the author) consider myself maintainer :) . If you want to contact me, then send an e-mail to: hanecak@megaloman.sk How to contribute ----------------- If you would like to submit a patch, send it to me <hanecak@megaloman.sk>. Please be sure to include a textual explanation of what your patch does. The preferred format for changes is "diff -u" output. You might generate it like this: $ cd hd2u-work $ [your changes] $ make mrproper $ cd .. $ diff -urN hd2u-orig hd2u-work > mydiffs.patch Distribution ------------ The primary site for release of this software is: http://www.megaloman.com/~hany/software/hd2u/ Mirror is located at: http://terminus.sk/~hany/software/hd2u/