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.

Hitting <return> in a list window is equivalent to double-clicking.

.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.3
Committed:	Sun Jun 3 20:13:51 2012 UTC (13 years, 4 months ago) by greg
Branch:	MAIN
CVS Tags:	rad5R4, rad5R2, rad5R3, rad5R0, rad5R1, rad4R2, rad6R0, rad4R2P1, rad4R2P2, HEAD
Changes since 2.2:	+2 -0 lines
Log Message:	Added work-around for broken double-click binding
#	Content
1	file.hlp 2.1 10/27/94
2
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	Hitting <return> in a list window is equivalent to double-clicking.
26
27	.Directory.Match
28
29	One or more matching (i.e. globbing) patterns may be given in this window,
30	separated by white spaces.
31
32	Nothing or a single asterisk (*) matches all files in
33	this directory.
34	Whatever the selected pattern, directories will always be listed,
35	followed by a slash (/).
36	This makes changing directories more convenient.
37
38	To list files beginning with a period (.), use the ".*" pattern.
39	Thus, it is possible to include all files in the directory listing by
40	entering ".* *" in the pattern window.
41
42	Hitting <return> in the pattern entry window has the same effect as
43	pressing the "List" button.
44
45	.Directory.List
46
47	The "List" button causes the interface to change to the selected
48	directory and list all files there matching the given pattern(s).
49
50	The same effect may be achieved by hitting <return> in either the
51	directory entry or pattern entry window.
52
53	.File.Intro
54
55	The file list box shows all files in the given directory matching the
56	specified pattern(s).
57	In addition, all subdirectories and the parent directory are listed
58	unconditionally.
59
60	Double-clicking on a directory in the file list box is the most
61	convenient method of filesystem navigation.
62
63	Clicking on a file selects it for editing, but does not enter it.
64	Double-click on a file if you wish to enter it.
65
66	.File.Entry
67
68	The file entry field allows you to enter the name of a file that may
69	or may not exist in the current directory.
70
71	Hitting <return> in this field is equivalent to
72	pressing the "OK" button (if it exists).
73
74	.File.View
75
76	The "View" button, if it exists, permits you to edit the highlighted
77	file from the directory listing, using either xedit or the editor
78	indicated by the EDITOR environment variable, if defined.