source: ChangeLog @ 8f44c6b

Last change on this file since 8f44c6b was 8f44c6b, checked in by James M. Kretchmar <>, 21 years ago
Changed version to 2.0.1-pre-1 Moved the (broken) newmsgproc stuff it a function procedure
  • Property mode set to 100644
File size: 28.1 KB
4        Moved the (broken) newmsgproc stuff it a function procedure
7        Class pings are displayed differently now
8        Updated owlconf.simple example to format outgoing messages.
11        Outgoing messages now go through the config for formatting
12        Zaway now makes an outgoing message, instead of an admin message
13        The 'zlocate' command can now handle multiple users
14        The simple user format for "To:" is in effect again
15        Prettyed up the zwrite line for using 'reply' on a zaway
16        Added a workaround for a libzephyr bug that caused zwrites to fail
17          if zephyrs were sent just before and just after renewing tickets
18        Fixed a memory bug in getsubs
19        Added receive support for zcrypt messages
20        Added the 'zcrypt' variable which controls whether or not zcrypt
21          messages are decrypted
22        'reply' is disabled for zcrypt until sending zcrypt works
23        Started implementing zcrypt command
24        More updates to the intro doc
27        Started adding code for newmsgproc.  It doesn't fully work yet!
28          Don't use it.
29        Added search, '/' and '?' to basic help.
30        Will attempt to keep the current message as close as possible
31             to the previous current message after an expunge.
32        "set <variable>" and "unset <variable>" now work for boolean variables.
33        Fixed a bug in owl_function_calculate_topmsg_normal that caused a
34          segfault
35        Fixed some typos in the intro doc
36        Removed old zlog functions from zephyr.c
37        Implemented the dump command
38        New startup message
41        Patch to fix memory bug in replying to CC messages
42        If we're on Athena and have static krb (or other) libraries, use
43          them
44        Added "athstatic" program to the release, which handles the above
45        Cast to an int for isspace, to make gcc -Wall quiet
46        Added 'zlist' and 'l' to basic help.
49        'zlog in' will now take an optional thrid argument to set the
50             'tty' variable before setting the zlocation
51        There is now a 'zlist' command that acts like 'znol -l'
52        'l' is bound to 'zlist'
53        Fixed memory leak uninitialzed memory read in fmtext
54        viewwin will now say "End" instead of "More" when at the end
55        Added a debugging message indicating the result of topmsg
56          calculations
57        You can now use %me% in filters
58        The built-in personal filter is updated to do so
59        Fixed a bug in moving the pointer after an expunge
60        Fixed up the normal scrolling code.  Now it should always
61          land on a message, but it's still not optimal.
62        Added the variable 'smartstrip' which will strip kerberos
63          instances out for the 'reply' command.
64        Added -R/usr/athena/lib to the build for Athena
65        Started updating the intro document
66        Small changes to help / about
67        The 'subscribe' and 'unsubscribe' commands (and their aliases) now
68          update .zephyr.subs by default.  If either is given the '-t'
69          (for "temporary") option the .zephyr.subs will not be updated
70        Turned off beeping for hitting the top or bottom of the list of
71          messages
72        Made daemon.webzephyr a special case for smartstrip
73        Added 'out' as a default filter for outgoing messages
76        Added filters "ping", "auto" and "login" by default.
77        Added "body" as a valid field to match on in a filter.
78        Temporary fix to bug where C-SPACE would cause the key handler to
79             lock up.
80        Messages now have a direciton (in, out or none).  Filters can
81             match on this direction
82        Outbound messages are no longer type 'admin' but are of the
83             appropriate message type (i.e. 'zephyr') and are direction
84             'out'.
85        Smartnarrow now works on outgoing messages
86        'info' updated to show more information for admin and outgoing
87             messages
88        Renamed pretty_sender to short_zuser and renamed long_sender to
89             long_zuser
90        Moved zsig generation to the zwrite object
91        Print the zsig used for outgoing messages
92        The tty variable now controls the zephyr location tty name
95        Added the 'search' command.
96        '/' is a keybinding for 'search'
97        '?' is a keybinding for 'search -r'
98        Fixed stristr, which was completely broken
99        renamed owl_fmtext_ztext_stylestrip to owl_function_ztext_styletsrip
100             and put it in functions.c
101        Attempts to stay near the current message when switching views.
102             When switching from an empty view to one we've previously
103             been in, the new current message position will attempt
104             to be close to the current position from the last
105             time we visited that view.
106        Fixed bug in readconfig.c that prevented building under perl 5.005.
107        Switched "C-x C-x" to only "startcommand quit"
108        'getsubs' prints closer to the order you sub in.
109        Modified the behavior of last so that "> >" will clear the screen.
110        The new behavior of last is:
111              Moves the pointer to the last message in the view.
112              If we are already at the last message in the view,
113              blanks the screen and moves just past the end of the view
114              so that new messages will appear starting at the top
115              of the screen.
116        Fixed a typo in the help for smartzpunt.
117        Fixed functions to handle curmsg being past the end of the view.
120        New framework for command handling.
121        New framework for keymap handling.
122        Added commands for everything that is bound
123             to a key (do 'show commands' to get the full list).
124        Added 'multi' and '(' commands to allow multiple commands
125             to be specified on a line.             
126        Added user keybindings with bindkey command.
127        Added command aliases (eg, "alias foo bar").
128        Added undelete command that parallels the delete command.
129        Added additional options to delete command.
130        The reply command now takes arguments.
131        Added 'edit:insert-text' command.
132        Added 'show zpunts' to show active punt filters.
133        Added 'show variable <name>' and 'show variables'.
134        Added 'show command <name>' and 'show commands'.
135        Added 'show keymap <name>' and 'show keymaps'.
136        Added 'M-u' to undelete all messages in current view.
137        Fixed dotsend so that the zephyr will still send if there
138             is whitespace after the dot but not on the same line.
139             This should resolve an issue where dotsend wouldn't work
140             if you'd gone up and edited a zephyr.
141        Bug in page down fixed
142        C-t will transpose characters
143        Fix the scrolling bug where we would sometimes fail to scroll
144             the screen down, leaving the current message off
145             the bottom of the screen.
146        Refixed 'login or login' typo in help
147        Fixed M-u description
148        Removed 'first' and 'last' from basic command help
149        Added M-N to basic key help
150        Added M-D, M-u to basic key help
151        Fixed a quoting problem in
152        Changed top of help to use 'show' instead of M-x
153        Fixed a bug in the summary field for user-created aliases
154        Added "reply zaway" which sends a zaway response to the current msg.
155        Added "edit:delete-prev-word" command and bound M-BACKSPACE to it.
156        Some buffer overruns fixed
157        Variables now have a summary and a long description.
158                Only the summary is shown with help.
159                The long description is shown with "show variable foo".
160        Added a 'scrollmode' variable which determines how the screen
161             will scroll as the cursor moves.  The default behaves
162             identically to previous versions of owl.
163             The following modes are supported:
164             normal      - This is the owl default.  Scrolling happens
165                           when it needs to, and an attempt is made to
166                           keep the current message roughly near
167                           the middle of the screen.  (default)
168             top         - The current message will always be the
169                           the top message displayed.
170             neartop     - The current message will be one down
171                           from the top message displayed,
172                           where possible.
173             center      - An attempt is made to keep the current
174                           message near the center of the screen.
175             paged       - The top message displayed only changes
176                           when user moves the cursor to the top
177                           or bottom of the screen.  When it moves,
178                           the screen will be paged up or down and
179                           the cursor will be near the top or
180                           the bottom.
181             pagedcenter - The top message displayed only changes
182                           when user moves the cursor to the top
183                           or bottom of the screen.  When it moves,
184                           the screen will be paged up or down and
185                           the cursor will be near the center.
186        Added owl_sprintf which returns the formatted string, or NULL.
187                The caller must free this string.
188                This will allocate enough memory and thus
189                avoid potential some buffer overrun situations.
190        Simple implementation of 'zwrite -m' (doesn't yet log an outgoing
191                message as having been sent.)
192        The "Not logged in or subscribing to messages" error
193                now includes the name of the recipient.
194        The "disable-ctrl-d" variable may also be set to "middle"
195                which will result in ctrl-d only sending at the
196                end of the message.  This is now the default.
197                This also added a command "editmulti:done-or-delete".
198        Fixed a bug in the "reply -e" command.
199        Always clear the command buffer before executing the command.
200                (So that interactive commands can sanely do start-command.)
201        Fixed preservation of e->dotsend across owl_editwin_clear().
202        Added history for multiline edit windows (eg, for zephyr composition).
203                The M-n and M-p keys will cycle through the history ring.
204                In particular, it is now possible to edit the command line
205                of a zephyr being composed:  C-c it and restart it
206                and then M-p to get the aborted composition back.
207        Added owl::send_zwrite(command, message) to the perl glue
208                to allow for the direct sending of multi-line messages.
209                For example:  owl::send_zwrite("-c foo -i bar", "hello");
210        Changed owl_fmtext_print_plain to return an alloc'd string to
211                avoid buffer overrun risks.
212        Added owl::ztext_stylestrip("...") function to perlglue
213                 which returns the ztext with formatting stripped out.
214        Added colorztext variable which can be used to disable @color()
215                 strings arriving in messages after it is set.
216                 (Currently, changing its value won't reformat messages).
217        Outgoing zephyr logging now obeys the logpath variable.
218        The '~' character in logpath and classlogpath now gets
219                 replaced with the user's home directory.
220        Added simple implementation of smartnarrow-to-admin that
221                 creates a "type-admin" autofilter.
222                 This was done mostly so that M-C-n and M-C-p do something
223                 sane on admin messages.
224        Added opera to the allowed options to the webbrowser variable.
225        Fixed some buffer overruns in the "reply" command.
226        When repying to "all" on a message that begins with "CC:" (eg, sent
227                 with "zwrite -C", the reply line will be constructed
228                 from the sender and the usernames on the CC: line
229                 of the message being replied to.
230        There is no such thing as C-R, so left C-r as it is but added:
231                 M-r --- edit reply to all
232                 M-R --- edit reply to sender
233        Added RCS Id strings to all files.
234        'show keymaps' shows details of all keymaps after summary list.
235        Added --no-move option to delete command.
236                In particular, delete-and-always-move-down may now
237                be implemented with
238                '( delete --no-move ; next --skip-deleted )'.
239        Folded the nextmsg and prevmsg commands and functions together into
240                one command which takes arguments.
241                Added '--filter <name>' option (eg, for next_personal),
242                '--skip-deleted' option, and
243                '--last-if-none'/'--first-if-none' options.
244                Help updated accordingly. 
245                In particular, the 'personal' filter is now used
246                for 'next personal'. 
247                Added --smart-filter and --smart-filter-instance options
248                to the next and prev commands.
249        Updated examples/owlconf.erik with the above.
250        Made owl_function_fast*filt return a string and not do the
251                narrowing, to make it more general.
252        Added a smartfilter command that creates a filter
253                based on the current message and returns the name
254                of the filter.
255        Added M-C-n and M-C-p keybindings to "move to next message
256                matching current" and "move to previous message
257                matching current"
258        Added variables edit:maxfillcols and edit:maxwrapcols which
259                will limit how wide editing paragraphs may get before
260                they get wrapped.  This is a max and may be narrower
261                depending on the current size of the window.
262                If 0, the max is unlimited.  Default is 70 columns for
263                edit:maxfillcols and unlimited for edit:maxwrapcols.
264        Added smartzpunt command with key binding of "C-x k".
265                This starts a zpunt command filled in with
266                the proposed zpunt.
267        Fixed a memory reference bug in delete and undelete commands.
268        Added support for perl to call directly back into owl.
269        Changed the implementation of owl::command("...") to immediately
270                call back into owl.  This allows perl to get the return
271                value of strings returned by owl commands.
272        Added the getview command which returns the name of the current
273                view's filter. 
274        Added the getvar command which returns the value of a variable.
275        Added an example to examples/owlconf.erik which uses TAB to
276                narrow and restore the view. 
277        Added an example to examples/owlconf.erik which uses M-c to
278                color messages matching the current one green.
279        Integrated change to fix problem with popup blinking on new zephyrs.
280        C-l and resizes will now refresh an open viewwin (eg, help).
281        Updated doc/code.txt to include info about filters, commands,
282                contexts, and keybindings.
283        Exec commands cleaned up to not have buffer-size limitations
284                and to not mess up spaces.  exec also returns a string
285                of the output now.
286        Integrated changes from 1.1.3, and added docs for "zlocate -d"
287                and new show commands.
288        Show with arguments produces help on show.
289        Fix a bug in readconfig caught by efence (where we'd try to read before
290                the beginning of a string if it was empty).
291        The perl command doesn't do makemsg directly, but instead
292             returns the string and it will get printed if it
293             was run interactively.
296        'show subs' and 'show subscriptions' are now the same as 'getsubs'
297        zlocate now takes an optional -d argument
298        'show terminal' / 'show term'
299        '>' / last doesn't set the last message at the top of the screen now
300        implemented _followlast as an unsupported feature
301        include 'default' in the 'show colors' list
302        added help for 'zpunt' and 'zunpunt'
303        changed the bug address in the startup message
304        can now do 'show status'
305        can now do 'show version'
306        'status' / 'show status' includes the owl version number now
307        'show terminal' includes whether the terminal can change colors
308        fixed off by one bugs in paging / scrolling viewwin
309        don't downcase the sender when getting the log name for personals
310        support @owl::fields as well as @fields
311        downcase class/inst filter names in auto filters
314        Fixed memory mishandling bug
315        Fixed bug in redfining the filter attached to the current view
316        M-n will narrow to message, instance on non-personal, class
317             MESSAGE messages
318        M-N behavies like M-n except that on class messages it narrows
319            to class and instance
320        line wrap earlier, to account for tabbing
321        fixed typo in help
322        'status' command now displays info on terminal color support
323        zephyr @ formatting is now case independant
324        added support for color terminals
325        zephyr @color(foo) now works
326        'D' for deleted messages is now not bold, unless it's the current
327          message
328        F1 displays the help screen
329        added filter colors
330        added the 'colorview' command
331        added the 'show colors' command
332        users who don't have a .zephyr.subs get a simpler format for
333          incoming messages
334        If colors are available 'show filters' will show a filter in the
335          color associated with it.
336        Added the zpunt and zunpunt commands
337        Lines in the subs file starting with '-' are zpunted
338        Include login/logout messages in auto user filters
339        'V' changes to the home view ('all' by default)
342        Fixed perl, aperl, and pperl commands to deal with quoting
343              and spaces in a saner manner.
344        Removed all owl_get_* methods for booleans and switched
345              cases where they were used to owl_is_*
346        Changes to owlconf.erik to use some new features.
347        Increased the size of the help buffer (as it
348              was overflowing and truncating the help message).
349        Variables prefixed with a _ are not shown in help
350              or by printallvars (and prefixed Not Yet Implemented
351              variables with this).
352        Fix typo in help
353        include stdio.h in functions.c
354        remove stale "q to quit" from bottom of info message
355        fix downward scrolling more than a page
356        use authentication for zlocate, by default
357        fixed buffer over run in info command on long messages
358        call 'perl <file>' from Makefile to avoid hardcoding perl paths
359        in Makefile don't build owl_prototypes.h unless necessary
360        store the time for admin messages
361        display admin message time in 'info' command
362        fixed an editwin M-> last character bug
365        reply is a normal function now
366        'R' does reply to sender
367        'T' tells you how many messages were marked for deletion
368        local realm removed from login / logout messages
369        added command history
370        better runtime / starttime reporting in 'status' command
371        leave the pointer near the current message after expunge
372        C-l recenters editwin
373        implemented zlocate
374        @italic works the same as @i
375        on reply only quote class / instance when necessary
376        C-r allows you to edit the reply line
377        don't use unecessary options in reply line
378        display 'info' errors in msgwin, not popup
379        impelemnted aexec, pexec commands
380        the zsig now goes through ztext formatting
381        messages have id numbers now
382        'info' prints the msgid
383        added the 'filter' command
384        added the 'view' command
385        added the 'show filter' command
386        added the 'viewclass' (and 'vc') commands
387        added the 'viewuser' (and 'vu') commands
388        M-n will filter to the current class or user
389        'v' starts a view command
390        M-D will delete all messages in current view
391        added the 'delete' (and 'del') command
392        load-subs with no argument loads the default subs file
393        '<truncated>' is now when the *current* message is truncated
394        the reply-lockout filter (with default) specifices messages that
395           cannot be replied to.
396        in the configfile owl::receive_msg is run whenever a message is
397          received
398        added the beep command
399        added the contributors file
400        declare ZGetSubscriptions and ZGetLocations since the includes
401          don't seem to
402        fixed bug in displaying last line in popwin if no final '\n'
403        'T' uses the 'trash' filter now
404        zaway_msg, zaway_msg_default and zaway are all user variables now.
405        zsig variable overrides zsigproc
406        If there's no appendtosepbar don't interfear with the sepbar
407        Changed: owl_message_get_numlines will return 0 of m is NULL
408        Added login messages to messages marked by owl_function_delete_automsgs
409        Added owl_function_delete_by_id(id) which acts independent of view
410        Added "-id <id>" option to delete command
411        Fixed an arg checking bug in delete command
412        Added owl::id to perl namespace with message id
413        Fixed a memory corruption bug in readconfig.c (where right
414              after the strdup to "out", we'd strcat a \n onto the end.
415              This would be triggered whenever owl::format_msg returned
416              a string not ending in a newline
417        Added 'X' keybinding which expunges and then switches to
418              a view defined by the variable "view_home" which defaults
419              to "all"
420        Consolidated readconfig.c somewhat to remove duplication.
421              owl_config_execute now returns a string.
422        Added an example config file that does vt-style formatting.
423              (examples/owlconf.vtformat)
424        Added the 'perl', 'aperl', and 'pperl' commands which will
425              evaluate perl expressions.
426        Fixed bug where pclose zsigproc would cause zombies
427        Can set zsigproc or zsig to "" to disable
428        Added support for multiple browsers (galeon and none were added).
429              Configure with the "webbrowser" variable.
430        Changing typewinsize height triggers resize event.
431        Added zsig variable which will be used if no zsigproc and non-empty.
432        Added "make test" rule to Makefile which will run regression tests,
433              and added regression testing framework to tester
434        Fixed to ignore static declarations.
435        Added dict.c which contains string->ptr dictionary routines
436              and the owl_dict type.
437              These include regression tests.
438        Overhaul/rewrite of variable handling.  Variables are now managed
439              in an owl_vardict (in g.vars) which contains a dictionary
440              of owl_variable's.  Each owl_variable has dispatch functions
441              for validating values, setting it and getting it,
442              and for setting it to and from string values.
443              The variable.c file contains the list of variables.
444              Stubs for the owl_global_<varname>_get functions and friends
445              are generated from variable.c by
446              The help.c messages for variables now calls into variable.c
447              so all information about most variables is in one place.   
448        Cleaned out code from global.c and command.c that was made obselete
449              by variable overhaul.
450        The set command now takes a -q option to not log a message.
451        Fixed a bug where set and print with no arguments would
452              print "Undefined variable" in addition
453              to running owl_function_printallvars.
454        debug is now a variable that can be turned on and off.
455        Fixed mail,inbox message parsing in examples/owlconf.erik
456        Made zaway_msg and zaway_msg_default into variables
457        Changed owl_function_makemsg and owl_function_debugmsg
458               to use varargs (ie, so they can now take a format
459               string with args).
460        Don't allow " and \ characters in URLs with the "w" command.
461        Removed lots of build warnings.
462        Popwins are wider by default so help messages fit better.
463        Added an atokenize_free function.
464        Fixes to work with an older version of libzephyr.
465        Added dependencies on header files to
466        Added pageup and pagedown key bindings to message list
467        Added pageup and pagedown to viewwin
468        Added configfile section to doc/intro.txt (from example config file)
469        Added appendtosepbar variable which may contain text which will
470              be appended to the sepbar.  This allows the configfile
471              to put information about pings and logins into
472              the sepbar.  (It may be worth also providing a variable
473              which enables this by default, but for now this allows
474              for experimenting with what works well.)
475        Added doc/code.txt which gives a brief overview of the code.
476        Added tags makefile rule and added TAGS to distclean rule.
479        fix frees in loadsubs and loadloginsubs
480        don't return in owl_free
483        'print' and 'set' with no arguments prints all variables
484        Added the 'unsubscribe' and 'unsub' command
485        Renamed the 'unsub' command to 'unsuball'
486        Added the 'getsubs' command which is like zctl ret
487        Fixed bug in logging messages sent to more than one recipient
488        Support '-C', '-O', and '-n' options to zwrite
489        Fixed bug in owl_editwin_delete_char when there are no later chars
490          after the cursor
491        Make "more" and "truncated" work in the status bar
492        enable printing of zsigproc and loginsubs variables
493        only allow message scrolling if the message is actually off the
494          screen
495        'T' will mark all automated message for deletion
496        'P' will go to the next personal message
497        'M-P' will go to the previous personal message
498        replying to a login message goes to the user now
499        added a status command
500        added the intro doc to the release
501        fixed off by one bug in viewwin
502        added complete online help
503        pass $owl::realm in configfile
504        fixed editwin wordwrapping on the last line
505        fixed editwin problem with key_right past the last char
506        print an error and quit if the configfile can't be parsed
507        got rid of owl_mainwin_calculate_topmsg
508        fixed off by one error in calculating topmsg upwards
509        you can now reply to an admin message
510        don't display an error about keypress on window resize
513        fixed bug in viewing messages longer than the screen
514        indicate in the sepbar if there is a non zero vert offset
515        send on '.' on a line by itself
516        added disable-ctrl-d variable
517        fixed bug where C-k did not delete the last \n in the buffer
518        make non-character meta keys work
519        use ZSendNotice instead of ZSendList
520        implemented <, >, M-< and M-> in viewwin
521        removed the spaces at the bottom of viewwin
522        added 'about' command
523        fixed bug using 'M' with no current message
524        changed message object to use char *'s to save on memory
525        change malloc, realloc, strdup and free to use owl hooks so that
526           debugging can be added
529        fixed a trailing space bug in the parser
530        impelemented the "burning ears" feature
531        have admin messages do ztext parsing
532        fixed bug in reporting which M- key was pressed
533        C-g will now cancel commands like C-c
536        implemented owl_function_full_redisplay().
537        C-l uses owl_function_full_redisplay().
538        when a popwin exists to a full redisplay.  (fixes bug)
539        improved the owl_editwin_process_char logic
540        removed all unnecessary wrefresh's and replaced with wnoutrefesh
541        owl_editwin_redisplay now takes an argument to optionally doupdate()
542        improved the cut-and-paste speed by not doing a usleep the first
543          time through the loop after getting a keypress.
544        nuked typwin.c and associated stuff.  It's useless now.
545        added viewwin code for paging windows
546        curly braces work for zephyr formatting
547        @i in zephyr formatting will be displayed as underlined text
548        turned off idlok
549        implemented viewwin
550        implemented viewwi in popwin for pageable popwins
551        help, info now use pageable popwins
552        bound 'M' to bring the current message up in a popwin
553        return, space bar, 'b' and backspace now scroll within a message
554        turned off resize message
555        C-v and M-v page the main window
556        implemented owl_message_is_mail
557        some build cleanup
561        added owl_message_is_personal and have things use it
562        added owl_message_is_private
563        fixed 'print personalbell' and have 'set personalbell'
564           print a message
565        bold only on message_is_personal
566        display the realm if not local
567        implemented M-f, M-b, M-d, M-<, M-> in editwin
568        implemnted word wrapping in editwin
569        implemented M-q (paragraph-fill) in editwin
570        fixed bug that caused owl to segfault logging a 'weird' class
571        M-x is a keysym for ':'
572        added smart bolding and userclue
573        fixed a bug causing pings to beep even if rxping is off
576        fixed bug in logging code
579        implemented personal logging
580        implemented class logging
581        implemented resize of typewin
582        fixed the backspace problem
583        -v command line option prints the version number
586        load-subs will report error opening file
587        skip comment lines in loadsubs and loadloginsubs
588        changed internal references to rxping and txping
589        fix replying to a blank instance
590        added subscribe command
591        subscribe to login messages from .anyone by default
592        'loginsubs' variarble controlls automated login messages
593        redisplay the editwin after a resize
594        leave the cursor in the editwin if active
595        fix problems in the build system
596        added displayoutgoing variable
597        temporarily removed error printing for zlog in / out
600        fixed bug in "message sent to <foo>" for zwrite
603        help updated
604        zaway key set to caps A
605        support zephyring other realms
606        rxping variable for receiving pings
607        txping variable for sending pings
608        function in place to resize typwin
609        C-l to refresh
610        personal bell variable
611        beta message now an admin message
614        Added the debug command and flag
615        Fixed bug in printing fields in info command
616        Added owl_fmtext_append_ztext and use it
617        Better formating for pings and login zephyrs
618        make tester depends on proto
Note: See TracBrowser for help on using the repository browser.