aboutsummaryrefslogtreecommitdiff
path: root/pkg/language/doc/chdir.hlp
blob: 112f135d3f5644e63f47b8c5696157d77d341944 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
.help chdir,cd Feb86 language
.ih
NAME
chdir, cd -- change the current working directory
.ih
USAGE
chdir [newdir]  or  cd [newdir]
.ih
PARAMETERS
.ls newdir
The new working directory.
The special name "." refers to the current directory; ".." refers to the next
higher directory.
.le
.ih
DESCRIPTION
\fIChdir\fR is used to change the current working directory.
When called without any arguments, \fIchdir\fR sets the default directory
to "home$", the users home directory.
The new directory can be specified as an IRAF logical name,
as a sub-directory of the current directory,
as a path from either a logical directory or the current directory,
or as an operating system dependent name.

The names \fIchdir\fR and \fIcd\fR are synonyms.  Note that the command
\fIback\fR may be called after a \fIchdir\fR to return to the previous
directory without typing its name.
.ih
EXAMPLES
1. Return to our home directory.

	cl> cd

2. Go to the package logical directory "pkg$".

	cl> chdir pkg

3. Go down one level to the directory "dataio", a subdirectory of "pkg".

	cl> cd dataio

4. From "dataio", go back up to "pkg" and down into "images".

	cl> cd ../images

5. Go to the "tv" directory, a subdirectory of "images", regardless of the
current directory

	cl> cd pkg$images/tv

6. On a VMS system, define a new logical directory on a different disk device
and go there.  Note that the character $ is not permitted in host file or
directory names.

.nf
	cl> set dd = scr1:[data]
	cl> cd dd
.fi
.ih
SEE ALSO
back, pathnames
.endhelp