source: trunk/kBuild/tools/GXX4MACHO.kmk@ 2408

Last change on this file since 2408 was 2379, checked in by bird, 16 years ago

TOOL_G*4MACHO_PREFIX and TOOL_G*4MACHO_SUFFIX
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 16.1 KB
Line 
1# $Id: GXX4MACHO.kmk 2379 2010-01-13 22:20:22Z bird $
2## @file
3# kBuild Tool Config - GCC v4 targeting Darwin (Mac OS X) Mach-o, for building C++ code.
4#
5
6#
7# Copyright (c) 2004-2009 knut st. osmundsen <bird-kBuild-spamix@anduin.net>
8#
9# This file is part of kBuild.
10#
11# kBuild is free software; you can redistribute it and/or modify
12# it under the terms of the GNU General Public License as published by
13# the Free Software Foundation; either version 2 of the License, or
14# (at your option) any later version.
15#
16# kBuild is distributed in the hope that it will be useful,
17# but WITHOUT ANY WARRANTY; without even the implied warranty of
18# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19# GNU General Public License for more details.
20#
21# You should have received a copy of the GNU General Public License
22# along with kBuild; if not, write to the Free Software
23# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24#
25#
26# As a special exception you are granted permission to include this file, via
27# the kmk include directive, as you wish without this in itself causing the
28# resulting makefile, program or whatever to be covered by the GPL license.
29# This exception does not however invalidate any other reasons why the makefile,
30# program, whatever should not be covered the GPL.
31#
32#
33
34TOOL_GXX4MACHO := GCC v4 targeting Darwin (Mac OS X) Mach-o, for building C++ code.
35
36# Tool Specific Properties
37TOOL_GXX4MACHO_PREFIX ?=
38TOOL_GXX4MACHO_SUFFIX ?= $(HOSTSUFF_EXE)
39TOOL_GXX4MACHO_CC ?= $(TOOL_GXX4MACHO_PREFIX)gcc$(TOOL_GXX4MACHO_SUFFIX)
40TOOL_GXX4MACHO_CXX ?= $(TOOL_GXX4MACHO_PREFIX)g++$(TOOL_GXX4MACHO_SUFFIX)
41TOOL_GXX4MACHO_OBJC ?= $(TOOL_GXX4MACHO_PREFIX)gcc$(TOOL_GXX4MACHO_SUFFIX)
42TOOL_GXX4MACHO_OBJCXX ?= $(TOOL_GXX4MACHO_PREFIX)gcc$(TOOL_GXX4MACHO_SUFFIX)
43TOOL_GXX4MACHO_AS ?= $(TOOL_GXX4MACHO_PREFIX)gcc$(TOOL_GXX4MACHO_SUFFIX)
44TOOL_GXX4MACHO_LD ?= $(TOOL_GXX4MACHO_PREFIX)g++$(TOOL_GXX4MACHO_SUFFIX)
45TOOL_GXX4MACHO_LD_SYSMOD ?= $(TOOL_GXX4MACHO_PREFIX)g++$(TOOL_GXX4MACHO_SUFFIX)
46ifndef TOOL_GXX4MACHO_LDFLAGS.$(KBUILD_TARGET)
47TOOL_GXX4MACHO_LDFLAGS.dll ?= -dynamiclib
48else
49TOOL_GXX4MACHO_LDFLAGS.dll ?= $(TOOL_GXX4MACHO_LDFLAGS.$(KBUILD_TARGET))
50endif
51TOOL_GXX4MACHO_LDFLAGS.sysmod ?= -r
52#TOOL_GXX4MACHO_LD_SONAME = -Wl,-dylib_install_name $(firstword $($(1)_SONAME.$(KBUILD_TARGET).$(KBUILD_TYPE)) $($(1)_SONAME.$(KBUILD_TARGET)) $($(1)_SONAME.$(KBUILD_TYPE)) $($(1)_SONAME) $(notdir $(2)))
53
54ifdef SLKRUNS
55TOOL_GXX4MACHO_CC += -fmessage-length=0
56TOOL_GXX4MACHO_CXX += -fmessage-length=0
57TOOL_GXX4MACHO_OBJC += -fmessage-length=0
58TOOL_GXX4MACHO_OBJCXX += -fmessage-length=0
59endif
60
61# General Properties used by kBuild
62TOOL_GXX4MACHO_COBJSUFF ?= .o
63TOOL_GXX4MACHO_CFLAGS ?=
64TOOL_GXX4MACHO_CFLAGS.debug ?= -g
65TOOL_GXX4MACHO_CFLAGS.profile ?= -O2 #-g -pg
66TOOL_GXX4MACHO_CFLAGS.release ?= -O2
67TOOL_GXX4MACHO_CINCS ?=
68TOOL_GXX4MACHO_CDEFS ?=
69
70TOOL_GXX4MACHO_CXXOBJSUFF ?= .o
71TOOL_GXX4MACHO_CXXFLAGS ?=
72TOOL_GXX4MACHO_CXXFLAGS.debug ?= -g
73TOOL_GXX4MACHO_CXXFLAGS.profile ?= -O2 #-g -pg
74TOOL_GXX4MACHO_CXXFLAGS.release ?= -O2
75TOOL_GXX4MACHO_CXXINCS ?=
76TOOL_GXX4MACHO_CXXDEFS ?=
77
78TOOL_GXX4MACHO_OBJCOBJSUFF ?= .o
79TOOL_GXX4MACHO_OBJCFLAGS ?=
80TOOL_GXX4MACHO_OBJCFLAGS.debug ?= -g
81TOOL_GXX4MACHO_OBJCFLAGS.profile?= -O2 #-g -pg
82TOOL_GXX4MACHO_OBJCFLAGS.release?= -O2
83TOOL_GXX4MACHO_OBJCINCS ?=
84TOOL_GXX4MACHO_OBJCDEFS ?=
85
86TOOL_GXX4MACHO_OBJCXXOBJSUFF ?= .o
87TOOL_GXX4MACHO_OBJCXXFLAGS ?=
88TOOL_GXX4MACHO_OBJCXXFLAGS.debug ?= -g
89TOOL_GXX4MACHO_OBJCXXFLAGS.profile ?= -O2 #-g -pg
90TOOL_GXX4MACHO_OBJCXXFLAGS.release ?= -O2
91TOOL_GXX4MACHO_OBJCXXINCS ?=
92TOOL_GXX4MACHO_OBJCXXDEFS ?=
93
94TOOL_GXX4MACHO_ASFLAGS ?= -x assembler-with-cpp
95TOOL_GXX4MACHO_ASFLAGS.debug ?= -g
96TOOL_GXX4MACHO_ASFLAGS.profile ?= -g
97TOOL_GXX4MACHO_ASOBJSUFF ?= .o
98
99TOOL_GXX4MACHO_AR ?= ar$(HOSTSUFF_EXE)
100TOOL_GXX4MACHO_ARFLAGS ?= -c -rs
101TOOL_GXX4MACHO_ARLIBSUFF ?= .a
102
103TOOL_GXX4MACHO_LDFLAGS ?=
104TOOL_GXX4MACHO_LDFLAGS.debug ?= -g
105TOOL_GXX4MACHO_LDFLAGS.profile ?= -g
106
107
108## Compile C source.
109# @param $(target) Normalized main target name.
110# @param $(source) Source filename (relative).
111# @param $(obj) Object file name. This shall be (re)created by the compilation.
112# @param $(dep) Dependcy file. This shall be (re)created by the compilation.
113# @param $(flags) Flags.
114# @param $(defs) Definitions. No -D or something.
115# @param $(incs) Includes. No -I or something.
116# @param $(dirdep) Directory creation dependency.
117# @param $(deps) Other dependencies.
118#
119# @param $(outbase) Output basename (full). Use this for list files and such.
120# @param $(objsuff) Object suffix.
121TOOL_GXX4MACHO_COMPILE_C_DEPEND =
122TOOL_GXX4MACHO_COMPILE_C_DEPORD =
123ifdef KBUILD_USE_KOBJCACHE
124TOOL_GXX4MACHO_COMPILE_C_USES_KOBJCACHE = 1
125TOOL_GXX4MACHO_COMPILE_C_OUTPUT = $(outbase).i
126define TOOL_GXX4MACHO_COMPILE_C_CMDS
127 $(QUIET)$(KOBJCACHE) -f $(outbase).koc -d $(PATH_OBJCACHE) -t $(bld_trg).$(bld_trg_arch) -p\
128 --kObjCache-cpp $(outbase).i\
129 $(TOOL_GXX4MACHO_CC) -E -o -\
130 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
131 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
132 $(abspath $(source))\
133 --kObjCache-cc $(obj)\
134 $(TOOL_GXX4MACHO_CC) -c\
135 $(flags) -fpreprocessed -x c\
136 -o $(obj)\
137 -
138endef
139else # !KBUILD_USE_KOBJCACHE
140TOOL_GXX4MACHO_COMPILE_C_OUTPUT =
141define TOOL_GXX4MACHO_COMPILE_C_CMDS
142 $(QUIET)$(TOOL_GXX4MACHO_CC) -c\
143 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
144 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
145 -o $(obj)\
146 $(abspath $(source))
147endef
148endif # !KUSE_OBJCACHE
149
150
151## Compile C++ source.
152# @param $(target) Normalized main target name.
153# @param $(source) Source filename (relative).
154# @param $(obj) Object file name. This shall be (re)created by the compilation.
155# @param $(dep) Dependcy file. This shall be (re)created by the compilation.
156# @param $(flags) Flags.
157# @param $(defs) Definitions. No -D or something.
158# @param $(incs) Includes. No -I or something.
159# @param $(dirdep) Directory creation dependency.
160# @param $(deps) Other dependencies.
161# @param $(outbase) Output basename (full). Use this for list files and such.
162# @param $(objsuff) Object suffix.
163TOOL_GXX4MACHO_COMPILE_CXX_DEPEND =
164TOOL_GXX4MACHO_COMPILE_CXX_DEPORD =
165ifdef KBUILD_USE_KOBJCACHE
166TOOL_GXX4MACHO_COMPILE_CXX_USES_KOBJCACHE = 1
167TOOL_GXX4MACHO_COMPILE_CXX_OUTPUT = $(outbase).ii
168define TOOL_GXX4MACHO_COMPILE_CXX_CMDS
169 $(QUIET)$(KOBJCACHE) -f $(outbase).koc -d $(PATH_OBJCACHE) -t $(bld_trg).$(bld_trg_arch) -p\
170 --kObjCache-cpp $(outbase).ii\
171 $(TOOL_GXX4MACHO_CXX) -E -o -\
172 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
173 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
174 $(abspath $(source))\
175 --kObjCache-cc $(obj)\
176 $(TOOL_GXX4MACHO_CXX) -c\
177 $(flags) -fpreprocessed -x c++\
178 -o $(obj)\
179 -
180endef
181else # !KBUILD_USE_KOBJCACHE
182TOOL_GXX4MACHO_COMPILE_CXX_OUTPUT =
183define TOOL_GXX4MACHO_COMPILE_CXX_CMDS
184 $(QUIET)$(TOOL_GXX4MACHO_CXX) -c\
185 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
186 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
187 -o $(obj)\
188 $(abspath $(source))
189endef
190endif # !KUSE_OBJCACHE
191
192
193## Compile Objective-C source.
194# @param $(target) Normalized main target name.
195# @param $(source) Source filename (relative).
196# @param $(obj) Object file name. This shall be (re)created by the compilation.
197# @param $(dep) Dependcy file. This shall be (re)created by the compilation.
198# @param $(flags) Flags.
199# @param $(defs) Definitions. No -D or something.
200# @param $(incs) Includes. No -I or something.
201# @param $(dirdep) Directory creation dependency.
202# @param $(deps) Other dependencies.
203# @param $(outbase) Output basename (full). Use this for list files and such.
204# @param $(objsuff) Object suffix.
205TOOL_GXX4MACHO_COMPILE_OBJC_DEPEND =
206TOOL_GXX4MACHO_COMPILE_OBJC_DEPORD =
207ifdef KBUILD_USE_KOBJCACHE
208TOOL_GXX4MACHO_COMPILE_OBJC_USES_KOBJCACHE = 1
209TOOL_GXX4MACHO_COMPILE_OBJC_OUTPUT = $(outbase).mi
210define TOOL_GXX4MACHO_COMPILE_OBJC_CMDS
211 $(QUIET)$(KOBJCACHE) -f $(outbase).koc -d $(PATH_OBJCACHE) -t $(bld_trg).$(bld_trg_arch) -p\
212 --kObjCache-cpp $(outbase).ii\
213 $(TOOL_GXX4MACHO_OBJC) -E -o -\
214 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
215 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
216 $(abspath $(source))\
217 --kObjCache-cc $(obj)\
218 $(TOOL_GXX4MACHO_OBJC) -c\
219 $(flags) -fpreprocessed -x objective-c \
220 -o $(obj)\
221 -
222endef
223else # !KBUILD_USE_KOBJCACHE
224TOOL_GXX4MACHO_COMPILE_OBJC_OUTPUT =
225define TOOL_GXX4MACHO_COMPILE_OBJC_CMDS
226 $(QUIET)$(TOOL_GXX4MACHO_OBJC) -c\
227 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
228 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
229 -o $(obj)\
230 $(abspath $(source))
231endef
232endif # !KUSE_OBJCACHE
233
234
235## Compile Objective-C++ source.
236# @param $(target) Normalized main target name.
237# @param $(source) Source filename (relative).
238# @param $(obj) Object file name. This shall be (re)created by the compilation.
239# @param $(dep) Dependcy file. This shall be (re)created by the compilation.
240# @param $(flags) Flags.
241# @param $(defs) Definitions. No -D or something.
242# @param $(incs) Includes. No -I or something.
243# @param $(dirdep) Directory creation dependency.
244# @param $(deps) Other dependencies.
245# @param $(outbase) Output basename (full). Use this for list files and such.
246# @param $(objsuff) Object suffix.
247TOOL_GXX4MACHO_COMPILE_OBJCXX_DEPEND =
248TOOL_GXX4MACHO_COMPILE_OBJCXX_DEPORD =
249ifdef KBUILD_USE_KOBJCACHE
250TOOL_GXX4MACHO_COMPILE_OBJCXX_USES_KOBJCACHE = 1
251TOOL_GXX4MACHO_COMPILE_OBJCXX_OUTPUT = $(outbase).mii
252define TOOL_GXX4MACHO_COMPILE_OBJCXX_CMDS
253 $(QUIET)$(KOBJCACHE) -f $(outbase).koc -d $(PATH_OBJCACHE) -t $(bld_trg).$(bld_trg_arch) -p\
254 --kObjCache-cpp $(outbase).mii\
255 $(TOOL_GXX4MACHO_OBJCXX) -E -o -\
256 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
257 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
258 $(abspath $(source))\
259 --kObjCache-cc $(obj)\
260 $(TOOL_GXX4MACHO_OBJCXX) -c\
261 $(flags) -fpreprocessed -x objective-c++ \
262 -o $(obj)\
263 -
264endef
265else # !KBUILD_USE_KOBJCACHE
266TOOL_GXX4MACHO_COMPILE_OBJCXX_OUTPUT =
267define TOOL_GXX4MACHO_COMPILE_OBJCXX_CMDS
268 $(QUIET)$(TOOL_GXX4MACHO_OBJCXX) -c\
269 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
270 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
271 -o $(obj)\
272 $(abspath $(source))
273endef
274endif # !KUSE_OBJCACHE
275
276
277## Compile Assembly source.
278# @param $(target) Normalized main target name.
279# @param $(source) Source filename (relative).
280# @param $(obj) Object file name. This shall be (re)created by the compilation.
281# @param $(dep) Dependcy file. This shall be (re)created by the compilation.
282# @param $(flags) Flags.
283# @param $(defs) Definitions. No -D or something.
284# @param $(incs) Includes. No -I or something.
285# @param $(dirdep) Directory creation dependency.
286# @param $(deps) Other dependencies.
287# @param $(outbase) Output basename (full). Use this for list files and such.
288# @param $(objsuff) Object suffix.
289#
290TOOL_GXX4MACHO_COMPILE_AS_OUTPUT =
291TOOL_GXX4MACHO_COMPILE_AS_DEPEND =
292TOOL_GXX4MACHO_COMPILE_AS_DEPORD =
293define TOOL_GXX4MACHO_COMPILE_AS_CMDS
294 $(QUIET)$(TOOL_GXX4MACHO_AS) -c\
295 $(flags) $(addprefix -I, $(incs)) $(addprefix -D, $(defs))\
296 -Wp,-MD,$(dep) -Wp,-MT,$(obj) -Wp,-MP\
297 -o $(obj)\
298 $(abspath $(source))
299endef
300
301
302## Link library
303# @param $(target) Normalized main target name.
304# @param $(out) Library name.
305# @param $(objs) Object files to put in the library.
306# @param $(flags) Flags.
307# @param $(dirdep) Directory creation dependency.
308# @param $(deps) Other dependencies.
309# @param $(othersrc) Unhandled sources.
310# @param $(outbase) Output basename (full). Use this for list files and such.
311TOOL_GXX4MACHO_LINK_LIBRARY_OUTPUT =
312TOOL_GXX4MACHO_LINK_LIBRARY_DEPEND = $(othersrc)
313TOOL_GXX4MACHO_LINK_LIBRARY_DEPORD =
314define TOOL_GXX4MACHO_LINK_LIBRARY_CMDS
315 $(if $(strip $(objs)),$(call xargs,$(QUIET)$(TOOL_GXX4MACHO_AR) $(flags) $(out),$(objs)))
316 $(foreach lib,$(othersrc)\
317 ,$(NL)$(TAB)$(call MSG_AR_MERGE,$(target),$(out),$(lib)) \
318 $(NL)$(TAB)$(QUIET)$(RM_EXT) -f $(dir $(outbase))ar.tmp.dir/* \
319 $(NL)$(TAB)$(QUIET)$(MKDIR) -p $(dir $(outbase))/ar.tmp.dir/ \
320 $(NL)$(TAB)$(QUIET)(cd $(dir $(outbase))ar.tmp.dir/ \
321 && $(TOOL_GXX4MACHO_AR) -x $(abspath $(lib)) \
322 && $(RM_EXT) -f ./__.SYMDEF* \
323 && $(TOOL_GXX4MACHO_AR) $(flags) $(out) *) \
324 $(NL)$(TAB)$(QUIET)$(RM_EXT) -f $(dir $(outbase))/ar.tmp.dir/* \
325 $(NL)$(TAB)$(QUIET)$(RMDIR) $(dir $(outbase))ar.tmp.dir/)
326endef
327
328
329## Link program
330# @param $(target) Normalized main target name.
331# @param $(out) Program name.
332# @param $(objs) Object files to link together.
333# @param $(libs) Libraries to search.
334# @param $(libpath) Library search paths.
335# @param $(flags) Flags.
336# @param $(dirdep) Directory creation dependency.
337# @param $(deps) Other dependencies.
338# @param $(othersrc) Unhandled sources.
339# @param $(custom_pre) Custom step invoked before linking.
340# @param $(custom_post) Custom step invoked after linking.
341# @param $(outbase) Output basename (full). Use this for list files and such.
342TOOL_GXX4MACHO_LINK_PROGRAM_OUTPUT = $(outbase).rsp
343TOOL_GXX4MACHO_LINK_PROGRAM_DEPEND = $(foreach lib,$(libs),$(if $(findstring $(lib),$(subst /,x,$(lib))),, $(lib)))
344TOOL_GXX4MACHO_LINK_PROGRAM_DEPORD =
345define TOOL_GXX4MACHO_LINK_PROGRAM_CMDS
346 $(QUIET)$(APPEND) -n $(outbase).rsp $(objs)
347 $(QUIET)$(TOOL_GXX4MACHO_LD) $(flags) -o $(out)\
348 -filelist $(outbase).rsp\
349 $(foreach p,$(libpath), -L$(p))\
350 $(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(lib)), $(lib)))
351endef
352
353
354## Link DLL
355# @param $(target) Normalized main target name.
356# @param $(out) Program name.
357# @param $(objs) Object files to link together.
358# @param $(libs) Libraries to search.
359# @param $(libpath) Library search paths.
360# @param $(flags) Flags.
361# @param $(dirdep) Directory creation dependency.
362# @param $(deps) Other dependencies.
363# @param $(othersrc) Unhandled sources.
364# @param $(custom_pre) Custom step invoked before linking.
365# @param $(custom_post) Custom step invoked after linking.
366# @param $(outbase) Output basename (full). Use this for list files and such.
367TOOL_GXX4MACHO_LINK_DLL_OUTPUT = $(outbase).rsp
368TOOL_GXX4MACHO_LINK_DLL_DEPEND = $(foreach lib,$(libs),$(if $(findstring $(lib),$(subst /,x,$(lib))),, $(lib)))
369TOOL_GXX4MACHO_LINK_DLL_DEPORD =
370define TOOL_GXX4MACHO_LINK_DLL_CMDS
371 $(QUIET)$(APPEND) -n $(outbase).rsp $(objs)
372 $(QUIET)$(TOOL_GXX4MACHO_LD) $(TOOL_GXX4MACHO_LDFLAGS.dll) $(flags) -o $(out)\
373 $(call TOOL_GXX4MACHO_LD_SONAME,$(target),$(out))\
374 -filelist $(outbase).rsp\
375 $(foreach p,$(libpath), -L$(p))\
376 $(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(lib)), $(lib)))
377endef
378
379
380## Link system module (windows aka driver, linux aka kernel module)
381# @param $(target) Normalized main target name.
382# @param $(out) System module name.
383# @param $(objs) Object files to link together.
384# @param $(libs) Libraries to search.
385# @param $(libpath) Library search paths.
386# @param $(flags) Flags.
387# @param $(dirdep) Directory creation dependency.
388# @param $(deps) Other dependencies.
389# @param $(othersrc) Unhandled sources.
390# @param $(custom_pre) Custom step invoked before linking.
391# @param $(custom_post) Custom step invoked after linking.
392# @param $(outbase) Output basename (full). Use this for list files and such.
393TOOL_GXX4MACHO_LINK_SYSMOD_OUTPUT = $(outbase).rsp
394TOOL_GXX4MACHO_LINK_SYSMOD_DEPEND = $(foreach lib,$(libs),$(if $(findstring $(lib),$(subst /,x,$(lib))),, $(lib)))
395TOOL_GXX4MACHO_LINK_SYSMOD_DEPORD =
396define TOOL_GXX4MACHO_LINK_SYSMOD_CMDS
397 $(QUIET)$(APPEND) -n $(outbase).rsp $(objs)
398 $(QUIET)$(TOOL_GXX4MACHO_LD_SYSMOD) $(TOOL_GXX4MACHO_LDFLAGS.sysmod) $(flags) -o $(out)\
399 -filelist $(outbase).rsp\
400 $(foreach p,$(libpath), -L$(p))\
401 $(foreach lib,$(libs), $(if $(findstring $(lib),$(subst /,x,$(lib))), -l$(patsubst lib%,%,$(lib)), $(lib)))
402endef
403
Note: See TracBrowser for help on using the repository browser.