Initial import package mtools: Programs for accessing MS-DOS disks without mounting...
[pkgs/m/mtools.git] / mdir.1
1 .TH mdir 1 "03Nov09" mtools-4.0.12
2 .SH Name
3 mdir - display an MSDOS directory
4 '\" t
5 .de TQ
6 .br
7 .ns
8 .TP \\$1
9 ..
10
11 .tr \(is'
12 .tr \(if`
13 .tr \(pd"
14
15 .SH Note\ of\ warning
16 This manpage has been automatically generated from mtools's texinfo
17 documentation, and may not be entirely accurate or complete.  See the
18 end of this man page for details.
19 .PP
20 .SH Description
21 .iX "p mdir"
22 .iX "c Read-only files (listing them)"
23 .iX "c Listing a directory"
24 .iX "c Directory listing"
25 .PP
26 The \fR\&\f(CWmdir\fR command is used to display an MS-DOS directory. Its
27 syntax is:
28 .PP
29 \&\fR\&\f(CWmdir\fR [\fR\&\f(CW-/\fR] [\fR\&\f(CW-f\fR] [\fR\&\f(CW-w\fR] [\fR\&\f(CW-a\fR] [\fR\&\f(CW-b\fR] \fImsdosfile\fR [ \fImsdosfiles\fR\&...] 
30 .PP
31 \&\fR\&\f(CWMdir\fR
32 displays the contents of MS-DOS directories, or the entries for some
33 MS-DOS files.
34 .PP
35 \&\fR\&\f(CWMdir\fR supports the following command line options:
36 .TP
37 \&\fR\&\f(CW/\fR\ 
38 Recursive output, just like Dos' \fR\&\f(CW-s\fR option
39 .TP
40 \&\fR\&\f(CWw\fR\ 
41 Wide output.  With this option, \fR\&\f(CWmdir\fR prints the filenames across
42 the page without displaying the file size or creation date.
43 .TP
44 \&\fR\&\f(CWa\fR\ 
45 Also list hidden files.
46 .TP
47 \&\fR\&\f(CWf\fR\ 
48 Fast.  Do not try to find out free space.  On larger disks, finding out
49 the amount of free space takes up some non trivial amount of time, as
50 the whole FAT must be read in and scanned.  The \fR\&\f(CW-f\fR flag bypasses
51 this step.  This flag is not needed on FAT32 filesystems, which store
52 the size explicitely.
53 .TP
54 \&\fR\&\f(CWb\fR\ 
55 Concise listing. Lists each directory name or filename, one per line
56 (including the filename extension). This switch displays no heading
57 information and no summary. Only a newline separated list of pathnames
58 is displayed.
59 .PP
60 An error occurs if a component of the path is not a directory.
61 .PP
62 .SH See\ Also
63 Mtools' texinfo doc
64 .SH Viewing\ the\ texi\ doc
65 This manpage has been automatically generated from mtools's texinfo
66 documentation. However, this process is only approximative, and some
67 items, such as crossreferences, footnotes and indices are lost in this
68 translation process.  Indeed, these items have no appropriate
69 representation in the manpage format.  Moreover, not all information has
70 been translated into the manpage version.  Thus I strongly advise you to
71 use the original texinfo doc.  See the end of this manpage for
72 instructions how to view the texinfo doc.
73 .TP
74 * \ \ 
75 To generate a printable copy from the texinfo doc, run the following
76 commands:
77  
78 .nf
79 .ft 3
80 .in +0.3i
81     ./configure; make dvi; dvips mtools.dvi
82 .fi
83 .in -0.3i
84 .ft R
85 .lp
86  
87 \&\fR
88 .TP
89 * \ \ 
90 To generate a html copy,  run:
91  
92 .nf
93 .ft 3
94 .in +0.3i
95     ./configure; make html
96 .fi
97 .in -0.3i
98 .ft R
99 .lp
100  
101 \&\fRA premade html can be found at
102 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
103 .TP
104 * \ \ 
105 To generate an info copy (browsable using emacs' info mode), run:
106  
107 .nf
108 .ft 3
109 .in +0.3i
110     ./configure; make info
111 .fi
112 .in -0.3i
113 .ft R
114 .lp
115  
116 \&\fR
117 .PP
118 The texinfo doc looks most pretty when printed or as html.  Indeed, in
119 the info version certain examples are difficult to read due to the
120 quoting conventions used in info.
121 .PP