src/util/file.hlp

        file.hlp 2.1 10/27/94

This help file is associated with the getfile.tcl routines, which
produce a screen for browsing and naming files.

.Directory.Intro

The current directory may be set either by choosing a new directory
by double-clicking on a directory in the file window, or by
explicitly changing the directory named in the entry window.

A directory may be given absolutely,
relative to the current path, or relative to your home directory or
that of another user using the tilde (~) shorthand.

Hitting <return> in the directory entry window has the same effect as
pressing the "List" button.
That is, the interface changes to that directory and lists all files
matching the given pattern(s).

If an attempt is made to change to a non-existent or read-protected
directory, an error message is printed in red and the interface
returns to the previously selected directory.

.Directory.Match

One or more matching (i.e. globbing) patterns may be given in this window,
separated by white spaces.

Nothing or a single asterisk (*) matches all files in
this directory.
Whatever the selected pattern, directories will always be listed,
followed by a slash (/).
This makes changing directories more convenient.

To list files beginning with a period (.), use the ".*" pattern.
Thus, it is possible to include all files in the directory listing by
entering ".* *" in the pattern window.

Hitting <return> in the pattern entry window has the same effect as
pressing the "List" button.

.Directory.List

The "List" button causes the interface to change to the selected
directory and list all files there matching the given pattern(s).

The same effect may be achieved by hitting <return> in either the
directory entry or pattern entry window.

.File.Intro

The file list box shows all files in the given directory matching the
specified pattern(s).
In addition, all subdirectories and the parent directory are listed
unconditionally.

Double-clicking on a directory in the file list box is the most
convenient method of filesystem navigation.

Clicking on a file selects it for editing, but does not enter it.
Double-click on a file if you wish to enter it.

.File.Entry

The file entry field allows you to enter the name of a file that may
or may not exist in the current directory.

Hitting <return> in this field is equivalent to
pressing the "OK" button (if it exists).

.File.View

The "View" button, if it exists, permits you to edit the highlighted
file from the directory listing, using either xedit or the editor
indicated by the EDITOR environment variable, if defined.
Revision:	2.2
Committed:	Sat Feb 22 02:07:30 2003 UTC (22 years, 8 months ago) by greg
Branch:	MAIN
CVS Tags:	rad4R1, rad4R0, rad3R9, rad3R8, rad3R7P2, rad3R7P1, rad3R6P1, rad3R6, rad3R5
Changes since 2.1:	+1 -1 lines
Log Message:	Changes and check-in for 3.5 release Includes new source files and modifications not recorded for many years See ray/doc/notes/ReleaseNotes for notes between 3.1 and 3.5 release
#	User	Rev	Content
1	greg	2.2	file.hlp 2.1 10/27/94
2	greg	2.1
3			This help file is associated with the getfile.tcl routines, which
4			produce a screen for browsing and naming files.
5
6			.Directory.Intro
7
8			The current directory may be set either by choosing a new directory
9			by double-clicking on a directory in the file window, or by
10			explicitly changing the directory named in the entry window.
11
12			A directory may be given absolutely,
13			relative to the current path, or relative to your home directory or
14			that of another user using the tilde (~) shorthand.
15
16			Hitting <return> in the directory entry window has the same effect as
17			pressing the "List" button.
18			That is, the interface changes to that directory and lists all files
19			matching the given pattern(s).
20
21			If an attempt is made to change to a non-existent or read-protected
22			directory, an error message is printed in red and the interface
23			returns to the previously selected directory.
24
25			.Directory.Match
26
27			One or more matching (i.e. globbing) patterns may be given in this window,
28			separated by white spaces.
29
30			Nothing or a single asterisk (*) matches all files in
31			this directory.
32			Whatever the selected pattern, directories will always be listed,
33			followed by a slash (/).
34			This makes changing directories more convenient.
35
36			To list files beginning with a period (.), use the ".*" pattern.
37			Thus, it is possible to include all files in the directory listing by
38			entering ".* *" in the pattern window.
39
40			Hitting <return> in the pattern entry window has the same effect as
41			pressing the "List" button.
42
43			.Directory.List
44
45			The "List" button causes the interface to change to the selected
46			directory and list all files there matching the given pattern(s).
47
48			The same effect may be achieved by hitting <return> in either the
49			directory entry or pattern entry window.
50
51			.File.Intro
52
53			The file list box shows all files in the given directory matching the
54			specified pattern(s).
55			In addition, all subdirectories and the parent directory are listed
56			unconditionally.
57
58			Double-clicking on a directory in the file list box is the most
59			convenient method of filesystem navigation.
60
61			Clicking on a file selects it for editing, but does not enter it.
62			Double-click on a file if you wish to enter it.
63
64			.File.Entry
65
66			The file entry field allows you to enter the name of a file that may
67			or may not exist in the current directory.
68
69			Hitting <return> in this field is equivalent to
70			pressing the "OK" button (if it exists).
71
72			.File.View
73
74			The "View" button, if it exists, permits you to edit the highlighted
75			file from the directory listing, using either xedit or the editor
76			indicated by the EDITOR environment variable, if defined.