mirror of https://github.com/GnoConsortium/gno.git
101 lines
2.8 KiB
Groff
101 lines
2.8 KiB
Groff
.\" Copyright (c) 1993-1997 Soenke Behrens, Devin Reade
|
|
.\"
|
|
.\" $Id: udl.1,v 1.14 1999/07/03 14:45:43 gdr-ftp Exp $
|
|
.\"
|
|
.TH UDL 1 "11 December 1997" GNO "Commands and Applications"
|
|
.SH NAME
|
|
udl - convert text files between different architectures
|
|
.SH SYNOPSIS
|
|
.BR udl
|
|
.BR -u | m | g
|
|
[
|
|
.B -RvpVh
|
|
]
|
|
.I file1
|
|
[
|
|
.IR file2 " ..."
|
|
]
|
|
.SH DESCRIPTION
|
|
.B udl
|
|
converts files between different computer systems by changing the EOL
|
|
(End-Of-Line) character.
|
|
.PP
|
|
On the Apple IIgs,
|
|
.B udl
|
|
will skip any file that is not of type TXT or SRC.
|
|
No notice is given of this unless the
|
|
.B -v
|
|
flag is used.
|
|
Since UNIX file systems do not have file types
|
|
.BR udl
|
|
is limited in the types of checks which it can carry out,
|
|
so the user must take care that
|
|
it is not invoked on object files or the like. On both platforms, if
|
|
.I file
|
|
appears to be a binary file (that is, no EOL is
|
|
found in the first part of the file) then
|
|
.I file
|
|
will be skipped.
|
|
Again, no notice is given of this unless the
|
|
.B -v
|
|
flag is used.
|
|
.PP
|
|
During file conversion
|
|
.B udl
|
|
creates a temporary file in the same directory as the original file.
|
|
The temporary file is close to or exactly the same size as the original
|
|
file.
|
|
.PP
|
|
When running under Byteworks' ORCA shell, the ORCA shell wildcards
|
|
.BR =
|
|
and
|
|
.BR ?
|
|
are properly expanded in file names.
|
|
.SH OPTIONS
|
|
.IP \fB\-u\fP
|
|
Convert to use LF as EOL (UNIX/Amiga).
|
|
.IP \fB\-m\fP
|
|
Convert to use CR/LF as EOL (MS-DOS).
|
|
.IP \fB\-g\fP
|
|
Convert to use CR as EOL (Apple).
|
|
.IP \fB\-p\fP
|
|
Be pedantic, only affects UNIX<->Apple conversions, see below.
|
|
.IP \fB\-R\fP
|
|
Recurse through subdirectories.
|
|
.IP \fB\-v\fP
|
|
Be verbose, show the file udl is currently working on.
|
|
.IP \fB\-V\fP
|
|
Print out udl's version number and abort.
|
|
.IP \fB\-h\fP
|
|
Print out usage information for udl.
|
|
.PP
|
|
If you specify the
|
|
.B -p
|
|
switch,
|
|
.B udl
|
|
is pedantic while doing the conversion. This means: The input file may
|
|
contain bytes with a value of zero (0), and the input file may contain
|
|
different EOL characters (ie: MS-DOS and UNIX style might be mixed in
|
|
one file). For conversions to or from MS-DOS
|
|
.B udl
|
|
is always pedantic, so this only affects conversions from UNIX to Apple
|
|
or vice versa. Being pedantic slows udl down by a factor of 1.5.
|
|
.SH LIMITATIONS
|
|
When running under GNO on the Apple IIgs, there is a limit to the nesting
|
|
depth when recusing on subdirectories. This is because the routine that
|
|
is responsible for this behavior is itself recursive. The default 2k
|
|
stack size will allow about 33 levels of nested directories, so this limit
|
|
should not normally be a problem. If the limit is exceeded,
|
|
.BR udl
|
|
will exit with an error message before any files are changed, and before
|
|
the stack actually overflows.
|
|
.SH BUGS
|
|
Bug reports should be directed to one of the two addresses below.
|
|
.SH AUTHOR
|
|
Soenke Behrens <sbehrens@bigfoot.com> with contributions by
|
|
Devin Reade <gdr@gno.org>.
|
|
.SH VERSION
|
|
This manual page documents
|
|
.B udl
|
|
version 1.1.6.
|