mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-10-11 01:23:42 +00:00
85008f04ca
The temp file is now created in the same directory as the original file, then renamed after the conversion is done. Some small doc changes were made as well, mostly typos and addresses.
100 lines
2.9 KiB
Groff
100 lines
2.9 KiB
Groff
.\" Copyright (c) 1993-1995 Soenke Behrens, Devin Glyn Reade
|
|
.\" $Id: udl.1,v 1.5 1995/02/08 05:47:53 gdr Exp $
|
|
.TH UDL 1 "Commands and Applications" "28 January 1995" "Version 1.14"
|
|
.SH NAME
|
|
udl - convert text files between different architectures
|
|
.SH SYNOPSIS
|
|
.BR udl
|
|
.BR -u | m | g
|
|
[
|
|
.B -Rvp
|
|
]
|
|
.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), the file will be skipped.
|
|
Again, no notice is given of this unless the
|
|
.B -v
|
|
flag is used.
|
|
.PP
|
|
.B udl
|
|
creates a temporary file the size of the file it is currently working on
|
|
during conversion.
|
|
.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.
|
|
.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 (i.e., 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 BUGS
|
|
When compiling on some Solaris installations, files within subdirectories
|
|
do not get their names properly resolved.
|
|
This seems to be due to bad definitions in
|
|
.IR <sys/stat.h> .
|
|
If you have access to SunOS 4.x,
|
|
.BR udl
|
|
can be compiled there and used under Solaris.
|
|
.PP
|
|
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.
|
|
.LP
|
|
If you find any other bugs, please send a report to the address given below.
|
|
.SH AUTHOR
|
|
Soenke Behrens, sbehrens@contech.demon.co.uk
|
|
.br
|
|
Version 1.13 updated by Devin Reade, gdr@myrias.ab.ca
|
|
.SH VERSION
|
|
This is
|
|
.B udl
|
|
version 1.14.
|