"SfR Fresh" - the SfR Freeware/Shareware Archive 
Member "see_bekijk-1.1/see.txt" of archive see_bekijk-1.1.tgz:
As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers.
Alternatively you can here view or download the uninterpreted source code file.
That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
1 ------------------------------------------------------------------------------
2 see / bekijk 1.1 (GPL) 1997,98 Belgie Belgium
3 Staf Wagemakers
4 ------------------------------------------------------------------------------
5
6
7 WHAT IS "SEE"?
8
9 "see" (or "bekijk" in the Dutch version) is a program to see Un*x text
10 files and manual pages.
11
12
13 HISTORY
14
15 Under DOS I used (and still use) list.com to view text files. I didn't find
16 such a program under my favorite OS, Linux. The standard Un*x utilities
17 ( more, less, view ...) waren't userfriendly enough. For this reason I have
18 made "see".
19
20
21 LICENSE
22
23 Like the most programs under Linux is "see" free :-))
24 and is the source available. "see" is published under the GNU General Public
25 License.
26
27 When you find "see" useful, or use the source for you own program please
28 let me know by sending my a postcard (or something else). This isn't a
29 obligation, but I would appreciate it.
30
31 NEW IN SEE 1.1
32
33 - View gzipped files
34 - View contents of *.tar, *.tgz and *.tar.gz files
35 - Read form stdin
36 - Write to stdout
37 - Move to a directory by the commandline.
38 - View manual pages
39 - License, version 1.1 is not donated to the Public Domain but is (like
40 most Linux programs) published under the GNU General Public License.
41 - BugFix : find
42 - BugFix : insert key in input routine
43
44 BUGS
45
46 Not knowed yet, when you find one you may let me know :-)
47
48
49 INSTALLATION
50
51 Just type 'make install_see', this will copy "see" in /usr/local/bin and
52 "see.txt" (this file) in /usr/doc/see_bekijk. "see" is compiled for the x86
53 PC, for other systems you need to recompile "see", by typing : 'make clean;
54 make' (not tested).
55
56 COMMANDLINE OPTIONS
57
58 --help : give a help text.
59 <file_name> : view <file_name>
60 <dir_name> : change the current directory to <dir_name>
61
62 HOW TO USE "SEE"?
63
64 There are four way's to start "see":
65
66 - by just typing 'see', after the program is started you can select the
67 file you want to view.
68
69 if there is already data on stdin, see will read the form stdin, and
70 display the contents of stdin
71
72 examples : ls | see
73 see < test.txt
74
75 - by type 'see <dir_name>', change the current directory to <dir_name>.
76 When the program is started you can select the file you want to view.
77
78 - by typing 'see <filename>', the file with <filename> will
79 automatically be loaded.
80
81 - in combination with "man"
82
83 examples : man -Psee ls
84 export PAGER=see;man ls
85
86 If you like "see" as your manual page viewer you can put the next
87 lines in your /etc/profile
88
89 alias man="man -Psee"
90
91 After you have loaded a file, the following keys can be used:
92
93 <-, C-b : move left / back
94 ->, C-f : move right / forward
95 arrow up, C-p : move up / previous line
96 arrow down, C-n : move down / next line
97 PgUp, u : move a screen up
98 PgDwn, d : move a screen down
99 HOME : go to the begin of a line
100 END : go to the end of a line
101 o : open a new file
102 b : go to the first line (start of file)
103 e : go to the last line (end of file)
104 g : go to a line number
105 /,z,s,f : search a string
106 F3, c, v : continue search
107 F9 : menu
108 ALT+f : file menu
109 ALT+g : go menu
110 ALT+s : search menu
111 ALT+h : help menu
112 F10,ESC,q : quit program
113 F1,h,? : view this help file
114
115
116 When you press F9 you get access to the pull-down menu's, most of the
117 functions are also available through the keyboard (see above).
118
119 File|Open or 'o':
120
121 When you select this function you get a window, at the left side of
122 the window you get the files of the current directory. By selecting
123 a file it will be loaded.
124 At the right size of the window you see the directories, by pressing
125 the TAB key you are able to switch between the file and the directory
126 selection. By selecting a directory with ENTER you change the current
127 directory.
128 With the ESC key you cancel the file open operation.
129
130 File|Quit or 'F10,ESC,q':
131
132 Quit program.
133
134 Go|to begin or 'b':
135
136 Move to the first line of the file.
137
138 Go|to end or 'e':
139
140 Move to the last line of the file.
141
142 Go|to line or 'g':
143
144 With this function you are able to move to a certain line number.
145 After you have selected this function you get a window which ask
146 you to give a line number. With ESC you cancel the operation, by
147 pressing the TAB key you can use the [ OK ] and [ Cancel ]
148 buttons.
149
150 Go|to end of a line or 'END':
151
152 Move to the end of a line.
153
154 Go|to begin of a line or 'HOME':
155
156 Move to the begin of a line.
157
158 Search|a string or '/,z,s,f'
159
160 With this function you can search for a string in the file. The
161 searching will start form the current line (the first line on the
162 screen) to the last line in the file. After you selected this
163 function you will see a window which ask you to give a string. The
164 searching can been done on two ways, with or without case
165 sensitivity. By pressing the TAB key you can select -with SPACE or
166 ENTER- how to search at
167
168 [ ] Case sensitive
169
170 With the TAB key you are also able to use the [ OK ] and
171 [ Cancel ] buttons.
172
173 Search|form begin of the file
174
175 See above, the searching will start form the first line.
176
177 Search|Again or 'F3'
178
179 Search for the last string again.
180
181 Help|See help file or 'F1,h,?'
182
183 View this help file.
184
185 Help|Keys ...
186
187 Shows a list with the keys you can use in "see".
188
189 Help|About
190
191 Shows information about the program (version ,etc.).
192
193
194 THANKS TO ...
195
196 Free Software Foundation inc.
197
198 The GNU C Library Reference Manual by Sandra Loosemore
199 And of course for gcc, make, bash, grep, man, ls, cp, tar, gzip,
200 vi, emacs, less, ..., and more :-)
201
202 Sven Golt, Sven van der Meer, Scott Burkett, Matt Welsh
203
204 Form the Linux Documentation Project for their Linux Programmer's
205 Guide.
206
207 Linus, and others ...
208
209 for Linux of course ;-)
210
211 Jan Wagemakers
212
213 For his debuging & to place "see" on his Webpage. You can find more
214 information about Linux and Assembly on his Webpage :
215 www.bewoner.dma.be/JanW
216
217 All freeware programmer's (on any computer system)
218
219 And everyone I had forgot to mention :-{
220
221 LAST WORDS ...
222
223 When you find "see" useful (or useless), have suggestions, find a bug :-(
224 you may let me know.
225
226
227 My address is :
228
229 Staf Wagemakers
230 Wildemansstraat 31
231 B-2550 Kontich
232 Belgie / Belgium
233
234 email : staf.wagemakers@pts.be
235
236 NOTE.
237
238 This is my first really useful ( I hope it is useful for you :-) ) C
239 program ( I used to program in x86 assembly on a DOS environment ), so a
240 few bugs are possible.
241
242 Please ignore my poor English.
243
244