source: chapter01/changelog.xml@ 4089c23

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 6.0 6.1 6.1.1 6.3 6.4 6.5 6.6 6.7 6.8 7.0 7.1 7.2 7.3 7.4 7.5 7.5-systemd 7.6 7.6-systemd 7.7 7.7-systemd 7.8 7.8-systemd 7.9 7.9-systemd 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk v3_1 v3_2 v3_3 v4_0 v4_1 v5_0 v5_1 v5_1_1 xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since 4089c23 was 4089c23, checked in by Gerard Beekmans <gerard@…>, 23 years ago

added <?dbhtml> tag for output redirection into subdir

git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@1260 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

  • Property mode set to 100644
File size: 21.0 KB
Line 
1<sect1 id="ch01-changelog">
2<title>Changelog</title>
3<?dbhtml filename="changelog.html" dir="chapter01"?>
4
5<para>&version; - &releasedate;</para>
6
7<itemizedlist>
8
9<listitem><para>September 22nd, 2001 [markh]: Appendix A: Re-ordered the
10descriptions into alphabetical order.</para></listitem>
11
12</itemizedlist>
13
14<para>3.0 - September 21st, 2001</para>
15
16<itemizedlist>
17
18<listitem><para>Updated to:
19
20<itemizedlist>
21
22<listitem><para>e2fsprogs-1.24</para></listitem>
23
24</itemizedlist>
25
26</para></listitem>
27
28<listitem><para>September 21st, 2001 [markh]: Chapter 1+7: Changed the
29mailing list information to reflect the new ml
30structure. The Ch7 change is that the rc and rcS scripts now ask people
31to report problems to lfs-dev instead of lfs-discuss.</para></listitem>
32
33<listitem><para>September 18th, 2001 [gerard]: Chapter 5+6 - GCC:
34Added --enable-threads=posix to chapter 5, and changed --enable-threads to
35--enable-threads=posix in chapter 6. Although the default is posix threads when
36not specified, it's clearer this way what's being enabled.</para></listitem>
37
38<listitem><para>September 17th, 2001 [gerard]: Chapter 6 - Psmisc:
39Added notes how to deal with psmisc's pidof symlink (in case sysvinit
40isn't installed) and man page. Also, added --exec-prefix=/ to psmisc's
41configure script in order for the programs to be installed in /bin
42rather than /usr/bin (bootscripts may use them, so they must be in
43/bin).</para></listitem>
44
45<listitem><para>September 16th, 2001 [markh]: Chapter 6 - Util-linux:
46Added USRGAMES_DIR=/usr/bin to the make install routine so that
47/usr/games isn't created for banner and it is installed in
48/usr/bin.</para></listitem>
49
50<listitem><para>September 14th, 2001 [markh]: Chapter 6 - E2fsprogs:
51Updated to version 1.24.</para></listitem>
52
53<listitem><para>September 11th, 2001 [gerard]: Chapter 6 - Man: Added
54missing &amp;&amp; to 'done' and chmod the configure script to mode 755
55instead of 700 (more of a default mode so people don't _have_ to be
56running as the owner of that file).</para></listitem>
57
58</itemizedlist>
59
60<para>3.0-rc2 - September 8th, 2001</para>
61
62<itemizedlist>
63
64<listitem><para>Updated to:
65
66<itemizedlist>
67
68<listitem><para>sysvinit-2.82</para></listitem>
69
70</itemizedlist>
71
72</para></listitem>
73
74<listitem><para>September 7th, 2001 [gerard]: Chapter 6 - Sysvinit:
75Seperated the commands to change the status msg in init.c from the main
76commands.</para></listitem>
77
78<listitem><para>September 7th, 2001 [gerard]: Chapter 6 - Bash: Added
79--login to the exec /bin/bash command.</para></listitem>
80
81<listitem><para>September 7th, 2001 [gerard]: Chapter 5 - GCC: Removed
82duplicate explanation (the patch and --enable-languages ones) that are
83already in chapter 5 - gcc.</para></listitem>
84
85<listitem><para>September 7th, 2001 [markh]: Chapter 6 - Sysvinit:
86updated to 2.82.</para></listitem>
87
88<listitem><para>September 7th, 2001 [gerard]: Chapter 2: Added "How to
89ask for help" section.</para></listitem>
90
91<listitem><para>September 7th, 2001 [gerard]: Chapter 6 - Makedev:
92changed chmod to 754. Makes more sense, non-root can't run it
93anways.</para></listitem>
94
95<listitem><para>September 6th, 2001 [markh]: Chapter 5 - Diffutils, Grep
96and Sed: Moved the export CPPFLAGS fixes out of the main install
97instructions and explained when they are necessary.</para></listitem>
98
99<listitem><para>September 5th, 2001 [markh]: Chapter 5 - Gzip and
100Sh-utils: Moved the patches out of the main install instructions to a
101seperate section as we already do with the tar patch. Also removed
102gzip-exp.xml and shellutils-exp.xml as the explanations are now part of
103the installation text.</para></listitem>
104
105<listitem><para>September 5th, 2001 [gerard]: Chapter 5 - Bash: Added
106notes that the ncurses-dev package must be installed and the libcurses.a
107symlink created if missing. Added --with-curses back to Bash's
108installation, this now functions as a good test to make sure ncurses is
109installed (if not, texinfo will fail).</para></listitem>
110
111<listitem><para>September 5th, 2001 [gerard]: Chapter 6 - Net-tools:
112Instead of running make install, we now run make update. It does the
113same, except make update doesn't make backup of programs it's
114replacing.</para></listitem>
115
116<listitem><para>September 5th, 2001 [markh]: Chapter 6 - Procinfo:
117Removed sed and replaced with a flag to make.</para></listitem>
118
119<listitem><para>September 5th, 2001 [markh]: Chapter 6 - E2fsprogs:
120Added explanation as to why we use --with-root-prefix=/</para></listitem>
121
122<listitem><para>September 5th, 2001 [gerard]: Chapter 6 - E2fsprogs: We
123can supply a value to --with-root-prefix now. It's not necessary, but
124it makes things a lot clearer.</para></listitem>
125
126<listitem><para>September 5th, 2001 [markh]: Chapter 6 - E2fsprogs:
127Removed command to move mklost+found to /sbin.</para></listitem>
128
129<listitem><para>September 5th, 2001 [gerard]: Chapters 5 &amp; 6: Added
130notes to the gcc, binutils and glibc installations that these packages
131behave badly when the default optimization flags are changed and should
132be left alone.</para></listitem>
133
134<listitem><para>September 4th, 2001 [gerard]: Chapter 6-Bzip2: Added ln
135command to create /lib/libbz2.so</para></listitem>
136
137<listitem><para>September 2nd, 2001 [gerard]: Appendix A - Psmisc: This
138package provides a pidof as well, added explanation of
139it.</para></listitem>
140
141<listitem><para>September 2nd, 2001 [gerard]: Chapter 6 - Ed, Vim,
142Shadow: Added missing &amp;&amp; after the sed and echo
143commands.</para></listitem>
144
145<listitem><para>September 1st, 2001 [gerard]: Changed links to other
146areas in the book to xml xref tags so you can click on them when reading
147non-html formats (like pdf).</para></listitem>
148
149<listitem><para>September 1st, 2001 [gerard]: Chapter 1 - Contact
150information: Changed the text to use one of the mailing lists, not just
151lfs-discuss (and provide a link to maillist.xml for the mailing lists
152list).</para></listitem>
153
154<listitem><para>August 31st, 2001 [gerard]: Chapter7 - mountfs,
155functions: Added the -f option to the rm command that removes fastboot
156and forcecheck. This option should never have been removed in the first
157place.</para></listitem>
158
159</itemizedlist>
160
161<para>3.0-RC1 - August 31st, 2001</para>
162
163<itemizedlist>
164
165<listitem><para>Updated to:
166
167<itemizedlist>
168
169<listitem><para>MAKEDEV-1.3</para></listitem>
170<listitem><para>autoconf-2.52</para></listitem>
171<listitem><para>automake-1.5</para></listitem>
172<listitem><para>binutils-2.11.2</para></listitem>
173<listitem><para>e2fsprogs-1.23</para></listitem>
174<listitem><para>file-3.36</para></listitem>
175<listitem><para>gcc-2.95.3</para></listitem>
176<listitem><para>gettext-0.10.39</para></listitem>
177<listitem><para>glibc-2.2.4</para></listitem>
178<listitem><para>groff-1.17.2</para></listitem>
179<listitem><para>linux-2.4.8</para></listitem>
180<listitem><para>man-pages-1.39</para></listitem>
181<listitem><para>modutils-2.4.7</para></listitem>
182<listitem><para>sysvinit-2.81</para></listitem>
183<listitem><para>util-linux-2.11h</para></listitem>
184
185</itemizedlist>
186
187</para></listitem>
188
189<listitem><para>August 29th, 2001 [gerard]: Chapter6 - Kbd: Removed the
190removal of the defkeymap file. Instead just make install it, added a
191note that loadkeys -d doesn't work properly and leave it with
192that..</para></listitem>
193
194<listitem><para>August 29th, 2001 [gerard]: Chapter 6 - Binutils:
195removed the -e options to 'make' which aren't necessary anymore. They
196were removed in chapter 5 already, but forgotten to commit changes to
197chapter 6.</para></listitem>
198
199<listitem><para>August 29th, 2001 [gerard]: Chapter 6 - Bin86: Added a
200note that this package may not be needed if lilo isn't
201used.</para></listitem>
202
203<listitem><para>August 29th, 2001 [gerard]: Chapter 6 - Ed: Added a note
204that nothing in LFS depends on Ed (except for patch, but ed formatted
205patch files are very rare these days), so you can safely skip
206it.</para></listitem>
207
208<listitem><para>August 29th, 2001 [gerard]: Various updates to the text
209through the entire book (mostly grammatical fixes and
210such).</para></listitem>
211
212<listitem><para>August 28th, 2001 [gerard]: Chapter 6-Texinfo: Added
213the explanation of the make TEXMF=/usr/share/texmf install-tex
214command.</para></listitem>
215
216<listitem><para>August 28th, 2001 [gerard]: Chapter 6-M4: Removed the note
217about linking m4 statically outside of chroot. LFS doesn't use
218Glibc-2.1.x anymore, so this claim may not be true. It'll have to be
219tested again.</para></listitem>
220
221<listitem><para>August 28th, 2001 [gerard]: Chapter 5+6+*: Removed the
222-f flags from cp commands. cp's behaviour has changed with
223fileutils-4.1, doing something totally different than
224expected.</para></listitem>
225
226<listitem><para>August 28th, 2001 [gerard]: Chapter 5+6: Removed some
227unnecessary line breaks (so a command continues on a next
228line).</para></listitem>
229
230<listitem><para>August 27th, 2001 [gerard]: Chapter 5: The former two sed
231operations are combined into one sed operation now.</para></listitem>
232
233<listitem><para>August 27th, 2001 [gerard]: Preface: Inserted the
234currrent LFS website's introduction into "Who wants to read this
235book".</para></listitem>
236
237<listitem><para>August 27th, 2001 [gerard]: Chapter 1: Synchronized the
238changelog, http and ftp mirrors with the LFS website.</para></listitem>
239
240<listitem><para>August 27th, 2001 [gerard]: Chapter 6-Glibc and Bash:
241simplified the installation instructions. We no longer exit chroot to
242finish the installation. This _may_ not work properly if your host
243distribution is an old 2.0.x based kernel, but we have no way of testing
244this at the moment. We'll deal with that when bug reports come
245in.</para></listitem>
246
247<listitem><para>August 27th, 2001 [gerard]: Moved rebooting into LFS from
248chapter 8 to chapter 9, after we run that find
249command.</para></listitem>
250
251<listitem><para>August 27th, 2001 [gerard]: Updated the find command in
252chapter 9.</para></listitem>
253
254<listitem><para>August 27th, 2001 [markh]: upgraded to e2fsprogs-1.23 and
255MAKEDEV-1.3.</para></listitem>
256
257<listitem><para>August 27th, 2001 [gerard]: Added dependency lists for
258all installed packages. You now can see which programs from which
259packages you need in order to compile and install a
260package.</para></listitem>
261
262<listitem><para>August 27th, 2001 [markh]: After a discussion on #lfs,
263we've downgraded the book to linux-2.4.8 due to performance problems
264with 2.4.9.</para></listitem>
265
266<listitem><para>August 26th, 2001 [markh]: Moved appendix c --&gt; appendix d and
267appendix b --&gt; appendix c in order to create room for the dependency
268information to go into appendix b.</para></listitem>
269
270<listitem><para>After much testing and discussing, it's been decided to
271downgrade to gcc-2.95.3 for the time being, until problems with the new
272gcc-3.0 version have been fixed.</para></listitem>
273
274<listitem><para>Chapter 5: sed commands for bzip2 and mawk static
275compiles have been replaced with a simpler flag to gcc.</para></listitem>
276
277<listitem><para>Chapter 5: A sed for fileutils-4.1 static has been added to
278avoid Segmentation Fault problems on glibc-2.2.3 systems.</para></listitem>
279
280<listitem><para>Chapter 5: Binutils doens't require us passing -e to
281make in order for LDFLAGS=-static to work properly.</para></listitem>
282
283<listitem><para>Chapter 5: GCC isn't statically linked anymore by using
284make -e LDFLAGS=-static, but by make BOOT_LDFLAGS=-static.</para></listitem>
285
286<listitem><para>Chapter 5: Removed kernel patch for gcc-3.0
287compilation</para></listitem>
288
289<listitem><para>Chapter 5: Added gcc-patch to fix re_max_failure
290compile problems</para></listitem>
291
292<listitem><para>Chapter 5: Added missing chown root.root
293$LFS/usr/include/linux to kernel installation </para></listitem>
294
295<listitem><para>Chapter 5 &amp; 6: Changed tar patch to use -j for bzip2
296files instead of -y in order to be compatible with next tar release. Also
297renamed patch file to tar-1.13.patch</para></listitem>
298
299<listitem><para>Chapters 5 &amp; 6: Added a new patch for gcc-2.95.3
300which fixes various problems such as the weak symbol
301bug.</para></listitem>
302
303<listitem><para>Chapter 6: Bzip2 and shadowutils static libraries
304are now put in /usr/lib instead of /lib. There are now also links
305from /usr/lib to their dynamic libraries in /lib to enable the linker to
306still find the dynamic versions.</para></listitem>
307
308<listitem><para>Chapter 6: ncurses patch totally
309removed. Static libraries now moved to /usr/lib and libcurses.a symlink
310created manually. A symlink is also created from /usr/lib to the
311dynamic libraries in /lib so that the linker still sees them.</para></listitem>
312
313<listitem><para>Chapter 6: Yacc script in bison page now uses exec bison
314which replaces the shell.</para></listitem>
315
316<listitem><para>Chapter 6: Util-linux sed command has been replaced with a
317flag to make.</para></listitem>
318
319<listitem><para>Chapter 6: Man patch replaced with
320sed command.</para></listitem>
321
322<listitem><para>Chapter 6: Removed shadow-utils patch in favour of a sed
323command</para></listitem>
324
325<listitem><para>Chapter 6: Removed sysvinit patch in favour of a sed
326command.</para></listitem>
327
328<listitem><para>Chapter 6: Removed the Groff command explanation
329regarding CXXFLAGS which has been made obsolete with the update
330to groff-1.17.1</para></listitem>
331
332<listitem><para>Chapter 6: Moved the net-tools installation until after
333sh-utils so that net-tools can replace sh-utils's
334/bin/hostname.</para></listitem>
335
336<listitem><para>Chapter 6: After installing Glibc, run exec /bin/bash
337--login instead of exiting and re-entering the chroot'ed
338environment.</para></listitem>
339
340<listitem><para>Chapter 7: Changed $* into "$@" in the functions and rc
341scripts. "$@" allows usage of quoted arguments with blanks.</para></listitem>
342
343<listitem><para>Chapter 7: Added print_error_msg from the rcS script as
344it appears in the rc script as well.</para></listitem>
345
346</itemizedlist>
347
348<para>3.0-pre4 - June 22nd, 2001</para>
349
350<itemizedlist>
351
352<listitem><para>Chapter 5: Reordered the installations
353alphabetically.</para></listitem>
354
355<listitem><para>Chapter 6: Moved the installations of ed and
356patch into their alphabetical positions.</para></listitem>
357
358<listitem><para>Chapter 7: Added [ ATTN ] warning message to
359the functions script. When you attemp to start a service that's
360already running or stop a service that's not running, it'll not
361print FAILED anymore but [ ATTN ] along with "Already running"
362or "Not running".</para></listitem>
363
364<listitem><para>Chapter 9: Renamed the network-scripts
365directory in nic-config.</para></listitem>
366
367</itemizedlist>
368
369<para>3.0-pre3 - May 12th, 2001</para>
370
371<itemizedlist>
372
373<listitem><para>Added numerous FHS compliance notes. These
374instructions can be followed if one wishes to build a fully
375FHS-compliant system.</para></listitem>
376
377<listitem><para>Chapter 4: Updated the directory list to be more
378FHS compliant. Mainly this meant adding the opt directories and
379removing /usr/tmp and /usr/local/tmp</para></listitem>
380
381<listitem><para>Chapter 5: We now copy the kernel include directories
382instead of linking to them. This is theoretically safer if we plan on
383upgrading the kernel.</para></listitem>
384
385<listitem><para>Chapter 5+6: Removed fileutils-patch. After upgrading
386to fileutils-4.1 the patch isn't needed anymore.</para></listitem>
387
388<listitem><para>Chapter 5+6: Put back the instructions on how to
389copy/remove the old NSS library files, in case the original distribution
390uses glibc-2.0.x.</para></listitem>
391
392<listitem><para>Chapter 5: Added the notice about an old version
393of install-info.</para></listitem>
394
395<listitem><para>Chapter 5: Removed the installation of a static
396gettext.</para></listitem>
397
398<listitem><para>Chapter 6: Changed bin86's installation from
399"make PREFIX=/usr install" to "make INSTALL_OPTS="-m 755"
400PREFIX=/usr install". This will prevent install from invoking strip -s
401on the files. This fails because a couple of the installed files are
402shell scripts rather than programs, so they can't be stripped.</para></listitem>
403
404<listitem><para>Chapter 6: Removed the ld.so section since we
405only used the man pages and replaced it with a patch to man-pages.</para></listitem>
406
407<listitem><para>Chapter 7+8: Moved the creation of /etc/fstab
408to chapter 8.</para></listitem>
409
410<listitem><para>Appendix A: Added missing descriptions of frcode,
411code and bigram in the findutils-4.1 package.</para></listitem>
412
413</itemizedlist>
414
415<para>3.0-pre2 - April 14th, 2001</para>
416
417<itemizedlist>
418
419<listitem><para>Chapter 5: Simplified ln commands.</para></listitem>
420
421<listitem><para>Chapter 5: Removed prefix=$LFS/usr from tar's
422make install.</para></listitem>
423
424<listitem><para>Chapter 5+6: Removed --disable-nls from configuration
425of programs that don't need it (bash, diffutils, gzip, sed,
426m4).</para></listitem>
427
428<listitem><para>Chapter 5+6: Changed from "cd dir &amp;&amp; make"
429to "make -C dir" (gettext-static, sysvinit).</para></listitem>
430
431<listitem><para>Chapter 5: Beautified the static link process
432for mawk.</para></listitem>
433
434<listitem><para>Chapter 5: Changed the links we create during
435gcc-installation to $LFS/usr/bin/cpp.</para></listitem>
436
437<listitem><para>Chapter 6: Changed the procps installation
438from sed'ing to an easier way.</para></listitem>
439
440<listitem><para> Chapter 6: Changed all "rm file &amp;&amp; ln -s dest
441file" into "ln -sf file" (in glibc, bzip2 and gzip
442installations).</para></listitem>
443
444<listitem><para>Chapter 6: Added a sed to fix a problem during
445glibc-installation. pt_chown can not be installed setuid root,
446because "root" is not known by glibc yet (kind of hen and
447egg-problem).</para></listitem>
448
449<listitem><para>Chapter 6: Changed consoledata/tools to kbd, which
450is more actively developed, and less of a pain to install.</para></listitem>
451
452<listitem><para>Appendix A: Added the description of the Netkit-base
453and Net-tools packages.</para></listitem>
454
455</itemizedlist>
456
457<para>3.0-pre1 - February 27th, 2001</para>
458
459<itemizedlist>
460
461<listitem><para>Converted the SGML source to XML.</para></listitem>
462
463<listitem><para>Chapter 4: Tell the user to use cfdisk rather than
464fdisk. The fdisk man page recommends cfdisk over fdisk because
465it's more stable.</para></listitem>
466
467<listitem><para>Chapter 4: Changed the wording to make it more general
468as ext2 no longer is the only used file system. Reiser for example is
469often used too now.</para></listitem>
470
471<listitem><para>Chapter 5: Added static mawk, texinfo and partially
472gettext to faciliate the move of Glibc from Chapter 5
473to Chapter 6.</para></listitem>
474
475<listitem><para>Chapter 5: Added Makedev to chapter 5. We don't create
476the device files here, only copy the MAKEDEV script and make a temp
477copy which will be used to create device files. This second file
478(MAKEDEV-temp) doesn't contain user names and group names but only user
479id's and group id's. We need a few device files to get Glibc installed,
480but before GLibc is installed user and group names are not recognized yet;
481only the numeric id's. This requires a slightly modified MAKEDEV script
482which will be generated by patching the original one. This patching is done
483here in chapter 5. Also, fixed the explanations on both
484makedev installations.</para></listitem>
485
486<listitem><para>Chapter 5: Recommended to install all the software
487while logged in (or su'ed to) user root.</para></listitem>
488
489<listitem><para>Chapter 5+6: Added the fileutils-4.0 patch which is
490needed to compile the fileutils package on Glibc-2.2 based systems
491(such as the upcoming LFS-3.0 system).</para></listitem>
492
493<listitem><para>Chapter 5+6: Upgraded from gcc-2.95.2 to
494gcc-2.95.2.1</para></listitem>
495
496<listitem><para>Chapter 5+6: Moved Glibc from chapter 5 to
497chapter 6</para></listitem>
498
499<listitem><para>Chapter 6: Changed libexecdir=/usr/bin in fileutils
500to libexecdir=/bin</para></listitem>
501
502<listitem><para>Chapter 6: Updated Glibc installation instructions.
503'configparms' file creation has been deleted. No need to pick a compiler
504(either distro's native or the /usr/local/gcc2952/bin/gcc one);
505we're in chroot now so we'll use the one we have</para></listitem>
506
507<listitem><para>Chapter 6: Only copy the man pages from the
508ld.so package. We don't need the ldconfig and ldd programs anymore;
509Glibc-2.2.1 comes with good working versions.</para></listitem>
510
511<listitem><para>Chapter 6: Added the creation of the lex symlink
512to the flex installation.</para></listitem>
513
514<listitem><para>Chapter 6: Changed $* into "$@" in the yacc script
515during bison's installation. "$@" allows usage of quoted arguments
516with blanks. </para></listitem>
517
518<listitem><para>Chapter 6: Fixed the man page installation during
519console-tools' installation.</para></listitem>
520
521<listitem><para>Chapter 6: When entering chroot the $TERM variable
522inside chroot is set properly. This is accomplished by: chroot ...
523-i HOME=/root TERM=$TERM...</para></listitem>
524
525<listitem><para>Chapter 6: Merged the different sulogin lines from
526the inittab file into one line.</para></listitem>
527
528<listitem><para>Chapter 7: Fixed the delays in the killproc function
529in the functions script. Now after kill, first check PIDs, then
530sleep 2 if needed. More details can be read in the comments
531in the script itself.</para></listitem>
532
533<listitem><para>Chapter 7: Added the explanation how the runlevels
534and boot process works when using the LFS scripts.</para></listitem>
535
536<listitem><para>Chapter 10: Added this chapter. It contains "thanks
537and good luck"notes and suggest creating the /etc/lfs-&version;
538file</para></listitem>
539
540</itemizedlist>
541
542</sect1>
543
Note: See TracBrowser for help on using the repository browser.