README.selfile
1
2
3
4 XsraSelFile File Selection Dialog Package
5
6
7
8This directory contains the XsraSelFile file selection dialog package. This
9package allows an application to obtain a filename from a user. The filename is
10selected by typing in a text widget or by browsing with the mouse in directory
11listings.
12
13The following is a brief description of the available features.
14
15* filename completion
16
17 When the user types a filename in the Text widget, SelFile shows the
18 possible completions in the directory listings. The user can hit the space
19 bar to complete the filename.
20
21* fast directory reading
22
23 When a directory is opened, the entries are read and sorted. Then the stats
24 of only the first screenful of entries are taken, and these entries are
25 displayed. The stats of the other entries are taken upon demand (i.e. when
26 the user wishes to see them by scrolling, etc.) or in the background. The
27 Xt work procedure facility is used to do background work. The idea here is
28 to give the user some feedback as soon as possible.
29
30 "It's just an illu--sion" :-)
31
32* Xaw and/or Xw widgets
33
34 SelFile can be linked with Xaw (Athena) and/or Xw (Hewlett-Packard)
35 widgets. Normally, SelFile is linked with the R3 or a later version of the
36 Xt Intrinsics, but it can be linked with the R2 Xt. See the Imakefile for
37 details.
38
39* automatic display update after directory modification
40
41 Every now and then SelFile looks at the directories being displayed to see
42 if they have been updated, and updates the display accordingly. Similarly,
43 file modes are checked (but not as often).
44
45* tilde (~) for home directories
46
47 When the user types a tilde at the beginning of the Text widget, SelFile
48 shows the home directories.
49
50-------------------------------------------------------------------------------
51
52This work is loosely based on (and the name comes from) an earlier X10 SelFile
53by Michiharu `NinjaTerm' Ariza.
54
55Admittedly, this X11 SelFile also looks a bit like the directory browser on the
56NeXT machine.
57
58-------------------------------------------------------------------------------
59
60If you have any
61
62 porting problems
63
64 bug reports
65
66 comments (particularly about ideas in the TODO file)
67
68 or any other type of feedback
69
70please send mail to
71
72 erik@sra.co.jp
73 OR
74 erik%sra.co.jp@uunet.uu.net
75 OR
76 erik%sra.co.jp@mcvax.uucp
77 OR
78 try junet instead of co.jp
79 OR
80 Erik M. van der Poel
81 Software Research Associates, Inc.
82 1-1-1 Hirakawa-cho, Chiyoda-ku
83 Tokyo 102 Japan. TEL +81-3-234-2692
84