view docs/nitros9guide/del.refentry @ 1053:b5ff125a1d60

Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000
parents c565a4700689
children 4dae346c4969
line wrap: on
line source

<refentry id="del">
<refnamediv>
<refname>DEL</refname>
<refpurpose>Delete a file</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>DEL</command>
<arg choice="opt">
  <option>-x</option>
</arg>
<arg choice="plain">
  <replaceable>path</replaceable>
</arg>
<arg choice="plain">
  &repeatst;<replaceable>path</replaceable>&repeaten;
</arg>
<arg choice="opt">
  <option>-x</option>
</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
This command is used to delete the file(s) specified by the
pathlist(s). The user must have write permission for the file(s).
Directory files cannot be deleted unless their type is changed to
non-directory: see the <command>ATTR</command> command description.
</para>
<para>
If the -x option appears, the current
<emphasis>execution</emphasis> directory is assumed.
</para>
<para>
For more information see: 3.5, 3.8.1
</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>
del test_program old_test_program

del /D1/number_five

OS9:dir /D1

   Directory of /D1 14:29:46
myfile          newfile

OS9:del /D1/newfile
OS9:dir /D1

   Directory of /D1 14:30:37
myfile

OS9:del myprog -x
OS9:del -x CMDS.SUBDIR/file
</screen>
</refsect1>
</refentry>