source: release-kits/lirk3/resources/gs3-release-maker/ant/docs/manual/api/org/apache/tools/ant/filters/StripJavaComments.html@ 14982

Last change on this file since 14982 was 14982, checked in by oranfry, 16 years ago

initial import of LiRK3
File size: 16.5 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<!--NewPage-->
3<HTML>
4<HEAD>
5<!-- Generated by javadoc (build 1.4.2_13) on Mon Oct 01 14:33:16 NZST 2007 -->
6<TITLE>
7StripJavaComments (Apache Ant API)
8</TITLE>
9
10<META NAME="keywords" CONTENT="org.apache.tools.ant.filters.StripJavaComments class">
11
12<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
13
14<SCRIPT type="text/javascript">
15function windowTitle()
16{
17 parent.document.title="StripJavaComments (Apache Ant API)";
18}
19</SCRIPT>
20
21</HEAD>
22
23<BODY BGCOLOR="white" onload="windowTitle();">
24
25
26<!-- ========= START OF TOP NAVBAR ======= -->
27<A NAME="navbar_top"><!-- --></A>
28<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
29<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
30<TR>
31<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
32<A NAME="navbar_top_firstrow"><!-- --></A>
33<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
34 <TR ALIGN="center" VALIGN="top">
35 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
36 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
37 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
39 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
42 </TR>
43</TABLE>
44</TD>
45<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
46</EM>
47</TD>
48</TR>
49
50<TR>
51<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
52&nbsp;<A HREF="../../../../../org/apache/tools/ant/filters/StringInputStream.html" title="class in org.apache.tools.ant.filters"><B>PREV CLASS</B></A>&nbsp;
53&nbsp;<A HREF="../../../../../org/apache/tools/ant/filters/StripLineBreaks.html" title="class in org.apache.tools.ant.filters"><B>NEXT CLASS</B></A></FONT></TD>
54<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
55 <A HREF="../../../../../index.html" target="_top"><B>FRAMES</B></A> &nbsp;
56&nbsp;<A HREF="StripJavaComments.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
57&nbsp;<SCRIPT type="text/javascript">
58 <!--
59 if(window==top) {
60 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
61 }
62 //-->
63</SCRIPT>
64<NOSCRIPT>
65 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
66</NOSCRIPT>
67
68</FONT></TD>
69</TR>
70<TR>
71<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
72 SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.io.FilterReader">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
73<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
74DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
75</TR>
76</TABLE>
77<A NAME="skip-navbar_top"></A>
78<!-- ========= END OF TOP NAVBAR ========= -->
79
80<HR>
81<!-- ======== START OF CLASS DATA ======== -->
82<H2>
83<FONT SIZE="-1">
84org.apache.tools.ant.filters</FONT>
85<BR>
86Class StripJavaComments</H2>
87<PRE>
88java.lang.Object
89 <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by">java.io.Reader
90 <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by">java.io.FilterReader
91 <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by"><A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html" title="class in org.apache.tools.ant.filters">org.apache.tools.ant.filters.BaseFilterReader</A>
92 <IMG SRC="../../../../../resources/inherit.gif" ALT="extended by"><B>org.apache.tools.ant.filters.StripJavaComments</B>
93</PRE>
94<DL>
95<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../../org/apache/tools/ant/filters/ChainableReader.html" title="interface in org.apache.tools.ant.filters">ChainableReader</A></DD>
96</DL>
97<HR>
98<DL>
99<DT>public final class <B>StripJavaComments</B><DT>extends <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html" title="class in org.apache.tools.ant.filters">BaseFilterReader</A><DT>implements <A HREF="../../../../../org/apache/tools/ant/filters/ChainableReader.html" title="interface in org.apache.tools.ant.filters">ChainableReader</A></DL>
100
101<P>
102This is a Java comment and string stripper reader that filters
103 those lexical tokens out for purposes of simple Java parsing.
104 (if you have more complex Java parsing needs, use a real lexer).
105 Since this class heavily relies on the single char read function,
106 you are recommended to make it work on top of a buffered reader.
107<P>
108
109<P>
110<HR>
111
112<P>
113<!-- ======== NESTED CLASS SUMMARY ======== -->
114
115
116<!-- =========== FIELD SUMMARY =========== -->
117
118<A NAME="field_summary"><!-- --></A>
119<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
120<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
121<TD COLSPAN=2><FONT SIZE="+2">
122<B>Field Summary</B></FONT></TD>
123</TR>
124</TABLE>
125&nbsp;<A NAME="fields_inherited_from_class_java.io.FilterReader"><!-- --></A>
126<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
127<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
128<TD><B>Fields inherited from class java.io.FilterReader</B></TD>
129</TR>
130<TR BGCOLOR="white" CLASS="TableRowColor">
131<TD><CODE>in</CODE></TD>
132</TR>
133</TABLE>
134&nbsp;<A NAME="fields_inherited_from_class_java.io.Reader"><!-- --></A>
135<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
136<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
137<TD><B>Fields inherited from class java.io.Reader</B></TD>
138</TR>
139<TR BGCOLOR="white" CLASS="TableRowColor">
140<TD><CODE>lock</CODE></TD>
141</TR>
142</TABLE>
143&nbsp;
144<!-- ======== CONSTRUCTOR SUMMARY ======== -->
145
146<A NAME="constructor_summary"><!-- --></A>
147<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
148<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
149<TD COLSPAN=2><FONT SIZE="+2">
150<B>Constructor Summary</B></FONT></TD>
151</TR>
152<TR BGCOLOR="white" CLASS="TableRowColor">
153<TD><CODE><B><A HREF="../../../../../org/apache/tools/ant/filters/StripJavaComments.html#StripJavaComments()">StripJavaComments</A></B>()</CODE>
154
155<BR>
156&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructor for "dummy" instances.</TD>
157</TR>
158<TR BGCOLOR="white" CLASS="TableRowColor">
159<TD><CODE><B><A HREF="../../../../../org/apache/tools/ant/filters/StripJavaComments.html#StripJavaComments(java.io.Reader)">StripJavaComments</A></B>(java.io.Reader&nbsp;in)</CODE>
160
161<BR>
162&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new filtered reader.</TD>
163</TR>
164</TABLE>
165&nbsp;
166<!-- ========== METHOD SUMMARY =========== -->
167
168<A NAME="method_summary"><!-- --></A>
169<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
170<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
171<TD COLSPAN=2><FONT SIZE="+2">
172<B>Method Summary</B></FONT></TD>
173</TR>
174<TR BGCOLOR="white" CLASS="TableRowColor">
175<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
176<CODE>&nbsp;java.io.Reader</CODE></FONT></TD>
177<TD><CODE><B><A HREF="../../../../../org/apache/tools/ant/filters/StripJavaComments.html#chain(java.io.Reader)">chain</A></B>(java.io.Reader&nbsp;rdr)</CODE>
178
179<BR>
180&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Creates a new StripJavaComments using the passed in
181 Reader for instantiation.</TD>
182</TR>
183<TR BGCOLOR="white" CLASS="TableRowColor">
184<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
185<CODE>&nbsp;int</CODE></FONT></TD>
186<TD><CODE><B><A HREF="../../../../../org/apache/tools/ant/filters/StripJavaComments.html#read()">read</A></B>()</CODE>
187
188<BR>
189&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the next character in the filtered stream, not including
190 Java comments.</TD>
191</TR>
192</TABLE>
193&nbsp;<A NAME="methods_inherited_from_class_org.apache.tools.ant.filters.BaseFilterReader"><!-- --></A>
194<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
195<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
196<TD><B>Methods inherited from class org.apache.tools.ant.filters.<A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html" title="class in org.apache.tools.ant.filters">BaseFilterReader</A></B></TD>
197</TR>
198<TR BGCOLOR="white" CLASS="TableRowColor">
199<TD><CODE><A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#getInitialized()">getInitialized</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#getProject()">getProject</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#read(char[], int, int)">read</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#readFully()">readFully</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#readLine()">readLine</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#setInitialized(boolean)">setInitialized</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#setProject(org.apache.tools.ant.Project)">setProject</A>, <A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#skip(long)">skip</A></CODE></TD>
200</TR>
201</TABLE>
202&nbsp;<A NAME="methods_inherited_from_class_java.io.FilterReader"><!-- --></A>
203<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
204<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
205<TD><B>Methods inherited from class java.io.FilterReader</B></TD>
206</TR>
207<TR BGCOLOR="white" CLASS="TableRowColor">
208<TD><CODE>close, mark, markSupported, ready, reset</CODE></TD>
209</TR>
210</TABLE>
211&nbsp;<A NAME="methods_inherited_from_class_java.io.Reader"><!-- --></A>
212<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
213<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
214<TD><B>Methods inherited from class java.io.Reader</B></TD>
215</TR>
216<TR BGCOLOR="white" CLASS="TableRowColor">
217<TD><CODE>read</CODE></TD>
218</TR>
219</TABLE>
220&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
221<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
222<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
223<TD><B>Methods inherited from class java.lang.Object</B></TD>
224</TR>
225<TR BGCOLOR="white" CLASS="TableRowColor">
226<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
227</TR>
228</TABLE>
229&nbsp;
230<P>
231
232<!-- ============ FIELD DETAIL =========== -->
233
234
235<!-- ========= CONSTRUCTOR DETAIL ======== -->
236
237<A NAME="constructor_detail"><!-- --></A>
238<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
239<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
240<TD COLSPAN=1><FONT SIZE="+2">
241<B>Constructor Detail</B></FONT></TD>
242</TR>
243</TABLE>
244
245<A NAME="StripJavaComments()"><!-- --></A><H3>
246StripJavaComments</H3>
247<PRE>
248public <B>StripJavaComments</B>()</PRE>
249<DL>
250<DD>Constructor for "dummy" instances.
251<P>
252<DT><B>See Also:</B><DD><A HREF="../../../../../org/apache/tools/ant/filters/BaseFilterReader.html#BaseFilterReader()"><CODE>BaseFilterReader.BaseFilterReader()</CODE></A></DL>
253<HR>
254
255<A NAME="StripJavaComments(java.io.Reader)"><!-- --></A><H3>
256StripJavaComments</H3>
257<PRE>
258public <B>StripJavaComments</B>(java.io.Reader&nbsp;in)</PRE>
259<DL>
260<DD>Creates a new filtered reader.
261<P>
262<DT><B>Parameters:</B><DD><CODE>in</CODE> - A Reader object providing the underlying stream.
263 Must not be <code>null</code>.</DL>
264
265<!-- ============ METHOD DETAIL ========== -->
266
267<A NAME="method_detail"><!-- --></A>
268<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
269<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
270<TD COLSPAN=1><FONT SIZE="+2">
271<B>Method Detail</B></FONT></TD>
272</TR>
273</TABLE>
274
275<A NAME="read()"><!-- --></A><H3>
276read</H3>
277<PRE>
278public final int <B>read</B>()
279 throws java.io.IOException</PRE>
280<DL>
281<DD>Returns the next character in the filtered stream, not including
282 Java comments.
283<P>
284<DD><DL>
285</DL>
286</DD>
287<DD><DL>
288
289<DT><B>Returns:</B><DD>the next character in the resulting stream, or -1
290 if the end of the resulting stream has been reached
291<DT><B>Throws:</B>
292<DD><CODE>java.io.IOException</CODE> - if the underlying stream throws an IOException
293 during reading</DL>
294</DD>
295</DL>
296<HR>
297
298<A NAME="chain(java.io.Reader)"><!-- --></A><H3>
299chain</H3>
300<PRE>
301public final java.io.Reader <B>chain</B>(java.io.Reader&nbsp;rdr)</PRE>
302<DL>
303<DD>Creates a new StripJavaComments using the passed in
304 Reader for instantiation.
305<P>
306<DD><DL>
307<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../../org/apache/tools/ant/filters/ChainableReader.html#chain(java.io.Reader)">chain</A></CODE> in interface <CODE><A HREF="../../../../../org/apache/tools/ant/filters/ChainableReader.html" title="interface in org.apache.tools.ant.filters">ChainableReader</A></CODE></DL>
308</DD>
309<DD><DL>
310<DT><B>Parameters:</B><DD><CODE>rdr</CODE> - A Reader object providing the underlying stream.
311 Must not be <code>null</code>.
312<DT><B>Returns:</B><DD>a new filter based on this configuration, but filtering
313 the specified reader</DL>
314</DD>
315</DL>
316<!-- ========= END OF CLASS DATA ========= -->
317<HR>
318
319
320<!-- ======= START OF BOTTOM NAVBAR ====== -->
321<A NAME="navbar_bottom"><!-- --></A>
322<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
323<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
324<TR>
325<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
326<A NAME="navbar_bottom_firstrow"><!-- --></A>
327<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
328 <TR ALIGN="center" VALIGN="top">
329 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
330 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
331 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
332 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
333 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
334 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
335 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
336 </TR>
337</TABLE>
338</TD>
339<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
340</EM>
341</TD>
342</TR>
343
344<TR>
345<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
346&nbsp;<A HREF="../../../../../org/apache/tools/ant/filters/StringInputStream.html" title="class in org.apache.tools.ant.filters"><B>PREV CLASS</B></A>&nbsp;
347&nbsp;<A HREF="../../../../../org/apache/tools/ant/filters/StripLineBreaks.html" title="class in org.apache.tools.ant.filters"><B>NEXT CLASS</B></A></FONT></TD>
348<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
349 <A HREF="../../../../../index.html" target="_top"><B>FRAMES</B></A> &nbsp;
350&nbsp;<A HREF="StripJavaComments.html" target="_top"><B>NO FRAMES</B></A> &nbsp;
351&nbsp;<SCRIPT type="text/javascript">
352 <!--
353 if(window==top) {
354 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
355 }
356 //-->
357</SCRIPT>
358<NOSCRIPT>
359 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
360</NOSCRIPT>
361
362</FONT></TD>
363</TR>
364<TR>
365<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
366 SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.io.FilterReader">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
367<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
368DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
369</TR>
370</TABLE>
371<A NAME="skip-navbar_bottom"></A>
372<!-- ======== END OF BOTTOM NAVBAR ======= -->
373
374<HR>
375Copyright © 2000-2007 Apache Software Foundation. All Rights Reserved.
376</BODY>
377</HTML>
Note: See TracBrowser for help on using the repository browser.