/usr/dt/share/man/cat1/dtsearchpath.1

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

NAME
     dtsearchpath - set	desktop	search paths

SYNOPSIS
     dtsearchpath [ -u username	] [ -v ] [ -o ]

DESCRIPTION
     The dtsearchpath command line utility sets	local and remote
     locations that desktop components should search for Applica-
     tion Manager groups, for filetype and action defintions, for
     desktop icons, and	for help files.

     The /usr/dt/bin/Xsession startup script sources the user's
     $HOME/.dtprofile script and any scripts located under
     /etc/dt/config/Xsession.d and /usr/dt/config/Xsession.d.
     After sourcing the	Xsession.d files, the Xsession script
     will invoke /usr/dt/bin/dtsearchpath to set and export the
     environment variables DTAPPSEARCHPATH, DTDATABASESEARCHPATH,
     DTHELPSEARCHPATH, XMICONSEARCHPATH, and XMICONBMSEARCHPATH
     (see the ENVIRONMENT heading in this man page for a more
     detailed description).

  Search Path Syntax
     Each of the exported search path variables	is supported by,
     that is, built from, two comma-separated search path
     environment variables.  For example:  DTAPPSEARCHPATH is
     supported by DTSPSYSAPPHOSTS and DTSPUSERAPPHOSTS.	 XMICON-
     SEARCHPATH	is supported by	DTSPSYSICON and	DTSPUSERICON.

     The input search path environment variables fall into two
     categories	- those	that support the host:/path syntax and
     those that	do not.	 If the	name of	the input environment
     variable contains the string HOSTS, it will support
     host:/path	syntax.	 The syntax for	search paths that support
     host:/path	is:

	  search path element
	  [ host | pathname | hostname+pathname	]
	  host
	  <hostname> :
	  pathname
	  /<absolute path>

     The syntax	for search paths that do not support host:/path
     is:

	  search path element
	  [ pathname ]
	  pathname
	  /<absolute path>

Unix System LaboratoLast change: 1 August 1995			1

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

  Examples
     To	set the	Icon search path to include the
     /usr/local/games/icons subdirectory, the following	line
     would appear in a script in the /etc/dt/config/Xsession.d/
     subdirectory:
     DTSPSYSICON=/usr/local/games/icons

     To	set the	Database search	path to	include	host marlin, the
     following line would appear in a script in	the
     /etc/dt/config/Xsession.d/	subdirectory:
     DTSPSYSDATABASEHOSTS=marlin:

     To	set the	Application Manager path to include the	applica-
     tions on host steelhead under subdirectory	/usr/local, and
     under the default help location on	host halibut, the follow-
     ing line would appear in a	script in the
     /etc/dt/config/Xsession.d/	subdirectory:
     DTSPSYSAPPHOSTS=steelhead:/usr/local,halibut:

     The dtsearchpath command line utility parses these	path ele-
     ments and transforms them into a form suitable for	the desk-
     top components.

     If	a host element is included, then the Tooltalk library's
     filename mapping capabilities will	control	how a path to
     files on that host	are constructed.  For example, the path
     to	file /tmp/file on host goby may	be constructed as
     /net/goby/tmp/file	or as /nfs/goby/tmp/file.

  Default Locations
     By	default, dtsearchpath sets up three search locations for
     each subsystem.  In search	order, they are:

	o	The user's personal location, under $HOME/.dt.

	o	The system administrator's configuration loca-
		tion, under /etc/dt/appconfig.

	o	The factory default location, under
		/usr/dt/appconfig.

  Precedence
     When searching a path for a particular item, such as an icon
     file, the desktop will always be satisfied	by the first item
     found.  For example, when searching for an	icon whose
     basename is beeper, if that icon exists in	both the
     /etc/dt/appconfig/icons and the /usr/dt/appconfig/icons sub-
     directories, then the icon	under /etc/dt/appconfig/icons
     will be found first and used, because that	element	appears
     first in the XMICONSEARCHPATH.  The search	terminates when
     the first match occurs.

Unix System LaboratoLast change: 1 August 1995			2

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     Each of the DTSPSYS search	path environment variables has a
     corresponding DTSPUSER environment	variable which will take
     precedence	over the system	setting.  The DTSPUSER values
     will be prepended to the DT search	path whereas the DTSPSYS
     values will come after the	$HOME/.dt configuration	location
     but before	the factory default location.  The relationship
     between the system	administrator's	customization and the
     default /etc/dt configuration location is up to the user of
     the DTSPSYS value.

OPTIONS
	-u  user       Causes dtsearchpath to return the search
		       paths for the specified user.  This option
		       is useful for system administrators who
		       need to understand the search paths for a
		       particular user.

	-v	       The verbose option causes dtsearchpath to
		       print to	standard output	the values of the
		       search environment.  By default,	the com-
		       mand runs silently.

	-o	       The don't-optimize option causes	dtsear-
		       chpath to add a path to the search path
		       even if the path	does not exist.

RETURN VALUES
	0	       Command completed successfully.

	1	       Command invoked with incorrect usage.

ENVIRONMENT
     The values	set by dtsearchpath are	passed through to the
     individual	desktop	subsystems, such as the	action database
     and the help system, by means of environment variables.

     The DTSPSYSAPPHOSTS variable is the primary environment
     variable and drives the remaining search paths for	filetypes
     and actions, for desktop icons, and for help files.

     In	the following list, all	values are derived from	three
     places:  the user's $HOME directory ($HOME/.dt), the system
     configuration directory (/etc/dt/appconfig), and the factory
     defaults directory	(/usr/dt/appconfig).  The values are
     listed as tranformed for the individual desktop subsystems.

     To	verify these values, execute dtsearchpath with the ver-
     bose (-v) option.

     DTAPPSEARCHPATH, DTSPSYSAPPHOSTS, DTSPUSERAPPHOSTS:  Used to
     discover application hosts	and their registry subdirec-
     tories.  The default transformed value is:

Unix System LaboratoLast change: 1 August 1995			3

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     $HOME/.dt/appmanager
     /etc/dt/appconfig/appmanager/%L
     /etc/dt/appconfig/appmanager/C
     /usr/dt/appconfig/appmanager/%L
     /usr/dt/appconfig/appmanager/C
     Where %L is the value of the LANG environment variable.

     The value of DTAPPSEARCHPATH can be altered by either of two
     environment variables:  DTSPSYSAPPHOSTS and/or DTSPUSERAP-
     PHOSTS.  DTSPSYSAPPHOSTS is for use by system administra-
     tors.  Values are specified by adding a ksh script	to the
     /etc/dt/config/Xsession.d directory that exports the vari-
     able.

     export DTSPSYSAPPHOSTS=marlin:,goby:/vipapps,/opt
     The expected syntax for DTSPSYSAPPHOSTS is	a comma-separated
     list.  DTSPSYSAPPHOSTS accepts host:, host:/path, or just
     /path. The	effect is to insert a searchpath after the confi-
     guration location (/etc/dt/appconfig/appmanager) and before
     the factory default location (/usr/dt/appconfig/appmanager).
     $HOME/.dt/appmanager
     /etc/dt/appconfig/appmanager/%L
     /etc/dt/appconfig/appmanager/C
     /nfs/marlin/etc/dt/appconfig/appmanager/%L
     /nfs/marlin/etc/dt/appconfig/appmanager/C
     /nfs/goby/vipapps/appconfig/appmanager/%L
     /nfs/goby/vipapps/appconfig/appmanager/C
     /opt/appconfig/appmanager/%L
     /opt/appconfig/appmanager/C
     /usr/dt/appconfig/appmanager/%L
     /usr/dt/appconfig/appmanager/C

     If	the system administrator wants the local configuration
     directory to appear in a different	location within	the con-
     figurable search paths, the special host term 'localhost:'
     can be inserted anywhere into the environment variable:

     export DTSPSYSAPPHOSTS=marlin:,localhost:,goby:/vipapps,/opt
     The resulting value for DTAPPSEARCHPATH would be:
     $HOME/.dt/appmanager
     /nfs/marlin/etc/dt/appconfig/appmanager/%L
     /nfs/marlin/etc/dt/appconfig/appmanager/C
     /etc/dt/appconfig/appmanager/%L
     /etc/dt/appconfig/appmanager/C
     /nfs/goby/vipapps/appconfig/appmanager/%L
     /nfs/goby/vipapps/appconfig/appmanager/C
     /opt/appconfig/appmanager/%L
     /opt/appconfig/appmanager/C
     /usr/dt/appconfig/appmanager/%L
     /usr/dt/appconfig/appmanager/C

     In	fact, the value	'localhost:' can be inserted anywhere in

Unix System LaboratoLast change: 1 August 1995			4

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     the DTSPSYSAPPHOSTS value and its order within the
     DTSPSYSAPPHOSTS will be reflected in the DTAPPSEARCHPATH
     value.
     DTSPUSERAPPHOSTS is for use by end	users.	Values are speci-
     fied by exporting the value in the	user's .dtprofile.

     export DTSPUSERAPPHOSTS=appsvr:,/myapps
     DTSPUSERAPPHOSTS also accepts host:, host:/path, and /path
     specifications.  The effect is to insert a	searchpath before
     any other searchpath.
     /nfs/appsvr/etc/dt/appconfig/appmanager/%L
     /nfs/appsvr/etc/dt/appconfig/appmanager/C
     /myapps/appmanager/%L
     /myapps/appmanager/C
     $HOME/.dt/appmanager
     /etc/dt/appconfig/appmanager/%L
     /etc/dt/appconfig/appmanager/C
     /usr/dt/appconfig/appmanager/%L
     /usr/dt/appconfig/appmanager/C

     DTDATABASESEARCHPATH, DTSPSYSDATABASEHOSTS, DTSPUSERDATA-
     BASEHOSTS:
     Used to collect filetype and action definitions, as
     expressed in *.dt files.  The default transformed value is:
     $HOME/.dt/types
     /etc/dt/appconfig/types/%L
     /etc/dt/appconfig/types/C
     /usr/dt/appconfig/types/%L
     /usr/dt/appconfig/types/C
     Where %L is the value of the LANG environment variable.

     The value of DTDATABASESEARCHPATH can be altered by either
     of	two environment	variables:  DTSPSYSDATABASEHOSTS and/or
     DTSPUSERDATABASEHOSTS.
     DTSPSYSDATABASEHOSTS is for use by	system administrators.
     Values are	specified by adding a ksh script to the
     /etc/dt/config/Xsession.d directory that exports the vari-
     able.

     export DTSPSYSDATABASEHOSTS=marlin:,goby:/vipapps,/opt
     The expected syntax for DTSPSYSDATABASEHOSTS is a comma-
     separated list.  DTSPSYSDATABASEHOSTS accepts host:,
     host:/path, or just /path.	 The effect is to insert a sear-
     chpath after the configuration location
     (/etc/dt/appconfig/types) and before the factory default
     location (/usr/dt/appconfig/types).
     $HOME/.dt/types
     /etc/dt/appconfig/types/%L
     /etc/dt/appconfig/types/C
     marlin:/etc/dt/appconfig/types/%L
     marlin:/etc/dt/appconfig/types/C
     goby:/vipapps/appconfig/types/%L

Unix System LaboratoLast change: 1 August 1995			5

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     goby:/vipapps/appconfig/types/C
     /opt/appconfig/types/%L
     /opt/appconfig/types/C
     /usr/dt/appconfig/types/%L
     /usr/dt/appconfig/types/C

     As	is the case for	DTAPPSEARCHPATH, the placement of the
     local configuration directory can be affected by the adding
     special host term 'localhost:'  to	the DTSPSYSDATABASEHOSTS
     environment variable.

     export DTSPSYSDATABASEHOSTS=marlin:,localhost:,goby:/vipapps
     The resulting value for DTDATABASESEARCHPATH would	be:
     $HOME/.dt/types
     marlin:/etc/dt/appconfig/types/%L
     marlin:/etc/dt/appconfig/types/C
     /etc/dt/appconfig/types/%L
     /etc/dt/appconfig/types/C
     goby:/vipapps/appconfig/types/%L
     goby:/vipapps/appconfig/types/C
     /usr/dt/appconfig/types/%L
     /usr/dt/appconfig/types/C

     DTSPUSERDATABASEHOSTS is for use by end users.  Values are
     specified by exporting the	value in the user's .dtprofile.

     export DTSPUSERDATABASEHOSTS=dbsvr:,/mytypes
     DTSPUSERDATABASEHOSTS also	accepts	host:, host:/path, and
     /path specifications.  The	effect is to insert a searchpath
     before any	other searchpath.
     dbsvr:/etc/dt/appconfig/types/%L
     dbsvr:/etc/dt/appconfig/types/C
     /mytypes/types/%L
     /mytypes/types/C
     $HOME/.dt/types
     /etc/dt/appconfig/types/%L
     /etc/dt/appconfig/types/C
     /usr/dt/appconfig/types/%L
     /usr/dt/appconfig/types/C

     XMICONSEARCHPATH, XMICONBMSEARCHPATH, DTSPSYSICON,	DTSPUSER-
     ICON:
     Used to locate desktop icons.  The	default	transformed value
     is:
     $HOME/.dt/icons/%B%M.pm
     $HOME/.dt/icons/%B%M.bm
     $HOME/.dt/icons/%B
     /etc/dt/appconfig/icons/%L/%B%M.pm
     /etc/dt/appconfig/icons/%L/%B%M.bm
     /etc/dt/appconfig/icons/%L/%B
     /etc/dt/appconfig/icons/C/%B%M.pm
     /etc/dt/appconfig/icons/C/%B%M.bm

Unix System LaboratoLast change: 1 August 1995			6

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     /etc/dt/appconfig/icons/C/%B
     /usr/dt/appconfig/icons/%L/%B%M.pm
     /usr/dt/appconfig/icons/%L/%B%M.bm
     /usr/dt/appconfig/icons/%L/%B
     /usr/dt/appconfig/icons/C/%B%M.pm
     /usr/dt/appconfig/icons/C/%B%M.bm
     /usr/dt/appconfig/icons/C/%B

     Where %B is the basename of the requested icon, %M	is the
     magnitude (size) of the icon, and %L is the value of the
     LANG environment variable.

     The value of XMICONSEARCHPATH can be altered by either of
     two environment variables:	 DTSPSYSICON and/or DTSPUSERICON.
     DTSPSYSICON is for	use by system administrators.  Values are
     specified by adding a ksh script to the
     /etc/dt/config/Xsession.d directory that exports the vari-
     able.

     export DTSPSYSICON=/vipapps/icons

     The expected syntax for DTSPSYSICON is a comma-separated
     list.  DTSPSYSICON	accepts	the /path format.  The effect is
     to	insert a searchpath after the configuration location
     (/etc/dt/appconfig/icons) and before the factory default
     location (/usr/dt/appconfig/icons).
     $HOME/.dt/icons/%B%M.pm
     $HOME/.dt/icons/%B%M.bm
     $HOME/.dt/icons/%B%M
     /etc/dt/appconfig/icons/%L/%B%M.pm
     /etc/dt/appconfig/icons/%L/%B%M.bm
     /etc/dt/appconfig/icons/%L/%B%M
     /etc/dt/appconfig/icons/C/%B%M.pm
     /etc/dt/appconfig/icons/C/%B%M.bm
     /etc/dt/appconfig/icons/C/%B%M
     /vipapps/icons/%L/%B%M.pm
     /vipapps/icons/%L/%B%M.bm
     /vipapps/icons/%L/%B%M
     /vipapps/icons/C/%B%M.pm
     /vipapps/icons/C/%B%M.bm
     /vipapps/icons/C/%B%M
     usr/dt/appconfig/icons/%L/%B%M.pm
     /usr/dt/appconfig/icons/%L/%B%M.bm
     /usr/dt/appconfig/icons/%L/%B%M
     /usr/dt/appconfig/types/C/%B%M.pm
     /usr/dt/appconfig/types/C/%B%M.bm
     /usr/dt/appconfig/types/C/%B%M

     The placement of the local	configuration directory	can be
     affected by the adding the	path term /etc/dt/appconfig to
     the DTSPSYSICON environment variable.

Unix System LaboratoLast change: 1 August 1995			7

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     export DTSPSYSICON=/vipapps/icons,/etc/dt/appconfig

     The resulting value for XMICONSEARCHPATH would be:

     $HOME/.dt/icons/%B%M.pm
     $HOME/.dt/icons/%B%M.bm
     $HOME/.dt/icons/%B%M
     /vipapps/icons/%L/%B%M.pm
     /vipapps/icons/%L/%B%M.bm
     /vipapps/icons/%L/%B%M
     /vipapps/icons/C/%B%M.pm
     /vipapps/icons/C/%B%M.bm
     /vipapps/icons/C/%B%M
     /etc/dt/appconfig/icons/%L/%B%M.pm
     /etc/dt/appconfig/icons/%L/%B%M.bm
     /etc/dt/appconfig/icons/%L/%B%M
     /etc/dt/appconfig/icons/C/%B%M.pm
     /etc/dt/appconfig/icons/C/%B%M.bm
     /etc/dt/appconfig/icons/C/%B%M
     usr/dt/appconfig/icons/%L/%B%M.pm
     /usr/dt/appconfig/icons/%L/%B%M.bm
     /usr/dt/appconfig/icons/%L/%B%M
     /usr/dt/appconfig/types/C/%B%M.pm
     /usr/dt/appconfig/types/C/%B%M.bm
     /usr/dt/appconfig/types/C/%B%M

     DTSPUSERICON is for use by	end users.  Values are specified
     by	exporting the value in the user's .dtprofile.

     export DTSPUSERICON=$HOME/myicons

     DTSPUSERICON accepts /path	specifications.	 The effect is to
     insert a searchpath before	any other searchpath.

     $HOME/myicons/%B%M.pm
     $HOME/myicons/%B%M.bm
     $HOME/myicons/%B%M
     $HOME/.dt/icons/%B%M.pm
     $HOME/.dt/icons/%B%M.bm
     $HOME/.dt/icons/%B%M
     /etc/dt/appconfig/icons/%L/%B%M.pm
     /etc/dt/appconfig/icons/%L/%B%M.bm
     /etc/dt/appconfig/icons/%L/%B%M
     /etc/dt/appconfig/icons/C/%B%M.pm
     /etc/dt/appconfig/icons/C/%B%M.bm
     /etc/dt/appconfig/icons/C/%B%M
     /usr/dt/appconfig/icons/%L/%B%M.pm
     /usr/dt/appconfig/icons/%L/%B%M.bm
     /usr/dt/appconfig/icons/%L/%B%M
     /usr/dt/appconfig/types/C/%B%M.pm
     /usr/dt/appconfig/types/C/%B%M.bm
     /usr/dt/appconfig/types/C/%B%M

Unix System LaboratoLast change: 1 August 1995			8

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     DTHELPSEARCHPATH, DTSPSYSHELP, DTSPUSERHELP:

     Used to locate help volumes and families for the desktop
     help subsystem.  The default transformed value is:
     $HOME/.dt/help/<session>/%H
     $HOME/.dt/help/<session>/%H.sdl
     $HOME/.dt/help/<session>/%H.hv
     $HOME/.dt/help/%H
     $HOME/.dt/help/%H.sdl
     $HOME/.dt/help/%H.hv
     /etc/dt/appconfig/help/%L/%H
     /etc/dt/appconfig/help/%L/%H.sdl
     /etc/dt/appconfig/help/%L/%H.hv
     /etc/dt/appconfig/help/C/%H
     /etc/dt/appconfig/help/C/%H.sdl
     /etc/dt/appconfig/help/C/%H.hv
     /usr/dt/appconfig/help/%L/%H
     /usr/dt/appconfig/help/%L/%H.sdl
     /usr/dt/appconfig/help/%L/%H.hv
     /usr/dt/appconfig/help/C/%H
     /usr/dt/appconfig/help/C/%H.sdl
     /usr/dt/appconfig/help/C/%H.hv

     Where %H is the basename of the requested help volume, and
     %L	is the value of	the LANG environment variable.

     The value of DTHELPSEARCHPATH can be altered by either of
     two environment variables:	 DTSPSYSHELP and/or DTSPUSERHELP.
     DTSPSYSHELP is for	use by system administrators.  Values are
     specified by adding a ksh script to the
     /etc/dt/config/Xsession.d directory that exports the vari-
     able.

     export DTSPSYSHELP=/vipapps/help

     The expected syntax for DTSPSYSHELP is a comma-separated
     list.  DTSPSYSHELP	accepts	the /path format.  The effect is
     to	insert a searchpath after the configuration location
     (/etc/dt/appconfig/help) and before the factory default
     location (/usr/dt/appconfig/help).
     $HOME/.dt/help/<session>/%H
     $HOME/.dt/help/<session>/%H.sdl
     $HOME/.dt/help/<session>/%H.hv
     $HOME/.dt/help/%H
     $HOME/.dt/help/%H.sdl
     $HOME/.dt/help/%H.hv
     /etc/dt/appconfig/help/%L/%H
     /etc/dt/appconfig/help/%L/%H.sdl
     /etc/dt/appconfig/help/%L/%H.hv
     /etc/dt/appconfig/help/C/%H
     /etc/dt/appconfig/help/C/%H.sdl
     /etc/dt/appconfig/help/C/%H.hv

Unix System LaboratoLast change: 1 August 1995			9

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     /vipapps/help/%L/%H
     /vipapps/help/%L/%H.sdl
     /vipapps/help/%L/%H.hv
     /vipapps/help/C/%H
     /vipapps/help/C/%H.sdl
     /vipapps/help/C/%H.hv
     /usr/dt/appconfig/help/%L/%H
     /usr/dt/appconfig/help/%L/%H.sdl
     /usr/dt/appconfig/help/%L/%H.hv
     /usr/dt/appconfig/help/C/%H
     /usr/dt/appconfig/help/C/%H.sdl
     /usr/dt/appconfig/help/C/%H.hv

     The placement of the local	configuration directory	can be
     affected by the adding the	path term /etc/dt/appconfig to
     the DTSPSYSHELP environment variable.

     export DTSPSYSHELP=/vipapps/help,/etc/dt/appconfig

     The resulting value for DTHELPSEARCHPATH would be:
     $HOME/.dt/help/<session>/%H
     $HOME/.dt/help/<session>/%H.sdl
     $HOME/.dt/help/<session>/%H.hv
     $HOME/.dt/help/%H
     $HOME/.dt/help/%H.sdl
     $HOME/.dt/help/%H.hv
     /vipapps/help/%L/%H
     /vipapps/help/%L/%H.sdl
     /vipapps/help/%L/%H.hv
     /vipapps/help/C/%H
     /vipapps/help/C/%H.sdl
     /vipapps/help/C/%H.hv
     /etc/dt/appconfig/help/%L/%H
     /etc/dt/appconfig/help/%L/%H.sdl
     /etc/dt/appconfig/help/%L/%H.hv
     /etc/dt/appconfig/help/C/%H
     /etc/dt/appconfig/help/C/%H.sdl
     /etc/dt/appconfig/help/C/%H.hv
     /usr/dt/appconfig/help/%L/%H
     /usr/dt/appconfig/help/%L/%H.sdl
     /usr/dt/appconfig/help/%L/%H.hv
     /usr/dt/appconfig/help/C/%H
     /usr/dt/appconfig/help/C/%H.sdl
     /usr/dt/appconfig/help/C/%H.hv

     DTSPUSERHELP is for use by	end users.  Values are specified
     by	exporting the value in the user's .dtprofile.

     export DTSPUSERHELP=$HOME/myhelp

     DTSPUSERHELP accepts /path	specifications.	 The effect is to
     insert a searchpath before	any other searchpath.

Unix System LaboratoLast change: 1 August 1995		       10

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     $HOME/myhelp/%H
     $HOME/myhelp/%H.sdl
     $HOME/myhelp/%H.hv
     $HOME/.dt/help/<session>/%H
     $HOME/.dt/help/<session>/%H.sdl
     $HOME/.dt/help/<session>/%H.hv
     $HOME/.dt/help/%H
     $HOME/.dt/help/%H.sdl
     $HOME/.dt/help/%H.hv
     /etc/dt/appconfig/help/%L/%H
     /etc/dt/appconfig/help/%L/%H.sdl
     /etc/dt/appconfig/help/%L/%H.hv
     /etc/dt/appconfig/help/C/%H
     /etc/dt/appconfig/help/C/%H.sdl z.br
     /etc/dt/appconfig/help/C/%H.hv
     /usr/dt/appconfig/help/%L/%H
     /usr/dt/appconfig/help/%L/%H.sdl
     /usr/dt/appconfig/help/%L/%H.hv
     /usr/dt/appconfig/help/C/%H
     /usr/dt/appconfig/help/C/%H.sdl
     /usr/dt/appconfig/help/C/%H.hv

     (See also the OPTIMIZATIONS heading in this man page.)

     At	the conclusion of dtsearchpath,	DTSPSYS	and DTSPUSER
     variables are explicitly unset, so	that only the
     DT*SEARCHPATH values remain.

     MANPATH, DTMANPATH:
     In	addition to setting the	application search paths, dtsear-
     chpath augments the MANPATH environment variable with the
     path to the TED man pages,	/usr/dt/man. For example, if the
     value of MANPATH prior to execution of:  dtsearchpath is
     /net/manserver/usr/man:/usr/man
     then the augmented	value will be:
     /usr/dt/man:/net/manserver/usr/man:/usr/man.

     If	the MANPATH environment	variable is not	set prior to the
     invocation	of dtsearchpath, the system-defined default value
     of	MANPATH	will be	included in the	augmented MANPATH value.
     For example, if the system-defined	default	value is:
     /usr/man:/usr/local/man
     then dtsearchpath will generate a MANPATH value of:
     /usr/dt/man:/usr/man:/usr/local/man

LOCALES
     Each of the search	path elements contain a	path that refer-
     ences the LANG variable using the %L construct.  When the
     user selects a different language from the	greeting screen
     and logs in, the search path will already be set up.  At the
     same time,	the factory defaults are still included, but
     after the localized elements.

Unix System LaboratoLast change: 1 August 1995		       11

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

     For example, if the user chooses the german locale	from the
     greeting screen, then his/her DTDATABASESEARCHPATH	will
     already include these elements, as	specified by the LANG
     value set at session startup:
     $HOME/.dt/types
     /etc/dt/appconfig/types/%L
     /etc/dt/appconfig/types/C
     /usr/dt/appconfig/types/%L
     /usr/dt/appconfig/types/C

     (See also the OPTIMIZATIONS heading in this man page.)

     Note that the search path does not	use locales under the
     user's $HOME directory.  Whether the user adds personal
     icons under $HOME/.dt/icons or personal applications under
     $HOME/.dt/appmanager, they	will be	found regardless of the
     language selected at login.

OPTIMIZATIONS
     Before exporting the search paths to the user's environment,
     dtsearchpath first	checks to ensure that each subdirectory
     exists.  If a directory does not exist at login, then that
     element will not be added to the user's search path, to save
     needless file system accesses by the desktop components.

FILES
	$HOME/.dtprofile
		       Enables setting of the user's DTSPUSER
		       environment variables.

	Xsession.d/*   Enables setting of the system DTSPSYS
		       environment variables.

NOTES
     In	order to inject	the values from	dtsearchpath into the
     user's environment, the command must be eval'd, as	is done
     by	the Xsession login script.

     eval `/usr/dt/bin/dtsearchpath`

     Simply running dtsearchpath from the command line will have
     no	affect on the parent shell.

     It	is not possible	to affect the DT search	paths after log-
     ging in.  Components such as the Window Manager and File
     Manager inherit the values	from dtsearchpath by being
     invoked from the same shell.  Hence, if the system	adminis-
     trator creates a new search path element for the end user,
     the user will not be able to access it until the next login.

SEE ALSO
     dtappgather(1).

Unix System LaboratoLast change: 1 August 1995		       12

dtsearchpath(1)		 USER COMMANDS		  dtsearchpath(1)

Unix System LaboratoLast change: 1 August 1995		       13

See also dtsearchpath(1)