annotate docs/nitros9guide/deldir.refentry @ 939:8f1263d3e3d5

Small touch-ups to source
author boisy
date Tue, 21 Jan 2003 13:20:52 +0000
parents 94476830df51
children c565a4700689
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
136
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="deldir">
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>DELDIR</refname>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Delete All Files In a Directory System</refpurpose>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
6
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>DELDIR</command>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
11 &replstart;directory name&replend;
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
13 </cmdsynopsis>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
14 </refsynopsisdiv>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
15
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
16 <refsect1><title>Description</title>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
17 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
18 This command is a convenient alternative to manually deleting
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
19 directories and files they contain. It is only used when
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
20 <emphasis>all</emphasis> files in the directory system are to be deleted.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
21 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
22 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
23 When DELDIR is run, it prints a prompt message like this:
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
24 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
25 <screen>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
26 OS9: deldir OLDFILES
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
27 Deleting directory file.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
28 List directory, delete directory, or quit ? (l/d/q)
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
29 </screen>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
30 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
31 An &quot;l&quot; response will cause a &quot;dir e&quot; command to be run so you can
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
32 have an opportunity to see the files in the directory before they
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
33 are deleted.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
34 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
35 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
36 A &quot;d&quot; response will initiate the process of deleting files.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
37 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
38 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
39 A &quot;q&quot; response will abort the command before action is taken.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
40 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
41 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
42 The directory to be deleted may include directory files, which
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
43 may themselves include directory files, etc. In this case, DELDIR
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
44 operates recursively (e.g., it calls itself) so all lower-level
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
45 directories are deleted as well. In this case the lower-level
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
46 directories are processed first.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
47 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
48 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
49 You must have correct access permission to delete all files and
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
50 directories encountered. If not, DELDIR will abort upon
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
51 encountering the first file for which you do not have write
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
52 permission.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
53 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
54 <para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
55 The DELDIR command automatically calls the DIR and ATTR
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
56 commands, so they both must reside in the current execution
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
57 directory.
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
58 </para>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
59 </refsect1>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
60 </refentry>
94476830df51 Split up the commands into individual files.
roug
parents:
diff changeset
61