.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "SORTATR" 1 "2024-05-10" "0.9.0" "Ken Siders' Atari 8-bit Tools"
.SH NAME
sortatr \- sort Atari DOS directory in an ATR image
.SH SYNOPSIS
.sp
sortatr \fIimagefile.atr\fP
.SH DESCRIPTION
.sp
\fBsortatr\fP sorts the directory entries in an Atari DOS 2.0S or MyDOS
compatible ATR images. The sort is alphabetical, and the disk image
is modified in place.
.sp
\fBsortatr\fP does not take any options.
.sp
XFD format images are not supported.
.SH WARNINGS
.sp
\fBDO NOT USE\fP this utility with DOS 2.5 disk images!
.sp
\fBDO NOT USE\fP this utility with MyDOS images containing subdirectories!
.sp
\fBDATA LOSS\fP will occur if these warnings are not heeded! The
modified directory in the  image will  not contain any
references to DOS 2.5 files using sectors above 720, or to MyDOS
subdirectories. This effectively deletes these files from the image.
.sp
If in doubt, list the image\(aqs directory with \fBatrdir\fP\&. If you see
files marked with a \fI:\fP (colon) or \fI<\fP (less\-than), then \fBsortatr\fP
should not be used on the image. Even if your purpose is actually to
delete these files/dirs, you should use some other utility (or DOS
on a real or emulated Atari) to delete them, because \fBsortatr\fP
doesn\(aqt free the sectors occupied by the files/dirs.
.sp
If you ignore these warnings and manage to delete files or directories
from your disk image, it should be possible to recover them with
a good Atari undelete or disk\-repair utility. Although the affected
files/dirs have been removed from the disk directory, the data
sectors have not been overwritten nor marked as free (meaning they
won\(aqt be overwritten by later write operations, unlike most "undelete"
situations). First, you have to find the starting sector of the
missing file/dir and create a directory entry for it in the directory
at sectors 36\-368. You will probably also have to change the file
number in the sector link bytes, or else delete the file in the new
directory that\(aqs using the file number of the old (deleted) file.
.SS Further warnings
.sp
\fBDO NOT USE\fP this utility with any non\-standard (non\-AtariDOS, non\-MyDOS
compatible) disk image.
.sp
Boot  disks  with no directory, SpartaDOS, Atari DOS 3/4, DOS XE,
or other non\-standard DOS formatted disks might (if you\(aqre lucky)
just cause an error message. If you\(aqre  not  lucky, they  may  be
corrupted. There is no easy way to recover an image that gets damaged
in this way.
.sp
\fBDO NOT USE\fP this utility with any image without creating a backup first!
.sp
Any image you use with \fBsortatr\fP is modified in\-place, and no backup is
made by \fBsortatr\fP\&. Always make a backup copy of an ATR image before you
use \fBsortatr\fP on it. You have been warned.
.SH EXIT STATUS
.sp
Exit status is zero if the sort was successful, or non\-zero if any
errors occurred. In case of a non\-zero return, the disk image may be
truncated, or its directory sectors may be damaged. Hope you had a
backup of that image!
.SH COPYRIGHT
.sp
Copyright 1997, Ken Siders.
.SH AUTHOR
.sp
Ken Siders was the original author of this utility.
.sp
Man page and Linux port done by B. Watson <\fI\%urchlay@slackware.uk\fP>;
Urchlay on irc.libera.chat \fI##atari\fP\&.
.SH SEE ALSO
.sp
\fBatrdir\fP(1),
\fBatrextr\fP(1),
\fBmakeatr\fP(1),
\fBsortatr\fP(1).
.sp
Any good Atari 8\-bit book: \fIDe Re Atari\fP, \fIThe Atari BASIC  Reference
Manual\fP,  the  \fIOS Users\(aq Guide\fP, \fIMapping the Atari\fP, etc.
.\" Generated by docutils manpage writer.
.