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