mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-08-12 19:28:55 +00:00
filename-munging on Solaris. It seems that the sys/stat.h header file doesn't agree with the stat implementation. Modified Makefile.gs to properly write the new executable over the old resource fork for udl. The resource fork originates with the file udl.r. Added suggested defines to the README for various Unix platforms. Man page changes, including grammar and the deletion of a bug that no longer exists. Fixed bug where invoking 'udl -u directory' would attempt to deref a NULL pointer, causing either memory tromping (IIgs) or a core dump (Unix). Tested under SunOS 4.x, SunOS 5.x (Solaris), and AIX.
98 lines
2.8 KiB
Groff
98 lines
2.8 KiB
Groff
.\" Copyright (c) 1993-1995 Soenke Behrens, Devin Reade
|
|
.\" $Id: udl.1,v 1.6 1995/02/08 06:12:40 gdr Exp $
|
|
.\"
|
|
.TH UDL 1 "Commands and Applications" "7 February 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) 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 orginal 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.
|
|
.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@contech.demon.co.uk> with contributions by
|
|
Devin Reade <gdr@myrias.ab.ca>.
|
|
.\" .br
|
|
.\" Version 1.13 updated by Devin Reade, gdr@myrias.ab.ca
|
|
.SH VERSION
|
|
This is
|
|
.B udl
|
|
version 1.14.
|