Imported Upstream version 4.0.31
[platform/upstream/mtools.git] / mcd.1
1 '\" t
2 .TH mcd 1 "19Jun21" mtools-4.0.31
3 .SH Name
4 mcd - change 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(CWmcd\fR command is used to change the mtools working directory
24 on the MS-DOS disk. It uses the following syntax:
25 .PP
26  
27 .nf
28 .ft 3
29 .in +0.3i
30 \&\fR\&\f(CWmcd [\fImsdosdirectory\fR\&\f(CW]
31 .fi
32 .in -0.3i
33 .ft R
34 .PP
35  
36 \&\fR
37 .PP
38 Without arguments, \fR\&\f(CWmcd\fR reports the current device and working
39 directory.  Otherwise, \fR\&\f(CWmcd\fR changes the current device and current
40 working directory relative to an MS-DOS file system.
41 .PP
42 The environmental variable \fR\&\f(CWMCWD\fR may be used to locate the file
43 where the device and current working directory information is stored.
44 The default is \fR\&\f(CW\(if$HOME/.mcwd\(is\fR.  Information in this file is ignored
45 if the file is more than 6 hours old.
46 .PP
47 \&\fR\&\f(CWMcd\fR returns 0 on success or 1 on failure.
48 .PP
49 Unlike MS-DOS versions of \fR\&\f(CWCD\fR, \fR\&\f(CWmcd\fR can be used to change to
50 another device. It may be wise to remove old \fR\&\f(CW\(if.mcwd\(is\fR files at logout.
51 .PP
52 .SH See\ Also
53 Mtools' texinfo doc
54 .SH Viewing\ the\ texi\ doc
55 This manpage has been automatically generated from mtools's texinfo
56 documentation. However, this process is only approximative, and some
57 items, such as crossreferences, footnotes and indices are lost in this
58 translation process.  Indeed, these items have no appropriate
59 representation in the manpage format.  Moreover, not all information has
60 been translated into the manpage version.  Thus I strongly advise you to
61 use the original texinfo doc.  See the end of this manpage for
62 instructions how to view the texinfo doc.
63 .TP
64 * \ \ 
65 To generate a printable copy from the texinfo doc, run the following
66 commands:
67  
68 .nf
69 .ft 3
70 .in +0.3i
71     ./configure; make dvi; dvips mtools.dvi
72 .fi
73 .in -0.3i
74 .ft R
75 .PP
76  
77 \&\fR
78 .TP
79 * \ \ 
80 To generate a html copy,  run:
81  
82 .nf
83 .ft 3
84 .in +0.3i
85     ./configure; make html
86 .fi
87 .in -0.3i
88 .ft R
89 .PP
90  
91 \&\fRA premade html can be found at
92 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
93 .TP
94 * \ \ 
95 To generate an info copy (browsable using emacs' info mode), run:
96  
97 .nf
98 .ft 3
99 .in +0.3i
100     ./configure; make info
101 .fi
102 .in -0.3i
103 .ft R
104 .PP
105  
106 \&\fR
107 .PP
108 The texinfo doc looks most pretty when printed or as html.  Indeed, in
109 the info version certain examples are difficult to read due to the
110 quoting conventions used in info.
111 .PP