1 XCOMM ##########################################################################
5 XCOMM # user personal environment variables
7 XCOMM # Common Desktop Environment (CDE)
9 XCOMM # (c) Copyright 1996 Digital Equipment Corporation.
10 XCOMM # (c) Copyright 1993,1994,1996 Hewlett-Packard Company.
11 XCOMM # (c) Copyright 1993,1994,1996 International Business Machines Corp.
12 XCOMM # (c) Copyright 1993,1994,1996 Sun Microsystems, Inc.
13 XCOMM # (c) Copyright 1993,1994,1996 Novell, Inc.
14 XCOMM # (c) Copyright 1996 FUJITSU LIMITED.
15 XCOMM # (c) Copyright 1996 Hitachi.
17 XCOMM # SYSPROFILE COMMENT START
19 XCOMM # ************** DO NOT EDIT THIS FILE **************
21 XCOMM # CDE_INSTALLATION_TOP/config/sys.dtprofile is a factory-default file
22 XCOMM # and will be unconditionally overwritten upon subsequent installation.
23 XCOMM # Before making changes to the file, copy it to the configuration
24 XCOMM # directory, CDE_CONFIGURATION_TOP/config.
26 XCOMM # The sys.dtprofile file is copied to $HOME/.dtprofile the first
27 XCOMM # time a user logs into the desktop. Any lines in sys.dtprofile
28 XCOMM # located between "SYSPROFILE COMMENT START" and "SYSPROFILE COMMENT END"
29 XCOMM # are filtered out during the copy.
31 XCOMM # SYSPROFILE COMMENT END
33 XCOMM # $TOG: dtprofile.src /main/5 1999/03/30 10:32:43 mgreess $
35 XCOMM ##########################################################################
38 XCOMM ##########################################################################
40 XCOMM # Your $HOME/.dtprofile is read each time you login to the Common Desktop
41 XCOMM # Environment (CDE) and is the place to set or override desktop
42 XCOMM # environment variables for your session. Environment variables set in
43 XCOMM # $HOME/.dtprofile are made available to all applications on the desktop.
44 XCOMM # The desktop will accept either sh or ksh syntax for the commands in
45 XCOMM # $HOME/.dtprofile.
47 XCOMM ##########################################################################
50 XCOMM ##########################################################################
52 XCOMM # Random stdout and stderr output from apps started by Session Mgr or
53 XCOMM # by actions via front panel or workspace menu can be directed into
54 XCOMM # the user's $HOME/.dt/sessionlogs directory. By default this output
55 XCOMM # is not recorded. Instead it is sent off to /dev/null (Unix's "nothing"
58 XCOMM # If this random application output is wanted (usually only wanted for
59 XCOMM # debugging purposes), commenting out following "dtstart_sessionlogfile"
60 XCOMM # lines will send output to your $HOME/.dt/sessionlogs directory.
62 XCOMM # Alternatively, can change "/dev/null" to "/dev/console" to see this
63 XCOMM # debugging output on your console device. Can start a console via the
64 XCOMM # Workspace programs menu or via Application Mgr's Desktop Tools
65 XCOMM # "Terminal Console" icon.
67 XCOMM ##########################################################################
69 echo "This session log file is currently disabled." > $dtstart_sessionlogfile
70 echo "To enable logging, edit $HOME/.dtprofile and" >> $dtstart_sessionlogfile
71 echo "remove dtstart_sessionlogfile=/dev/null line." >> $dtstart_sessionlogfile
73 export dtstart_sessionlogfile="/dev/null"
76 XCOMM ##########################################################################
78 XCOMM # By default, the desktop does not read your standard $HOME/.profile
79 XCOMM # or $HOME/.login files. This can be changed by uncommenting the
80 XCOMM # DTSOURCEPROFILE variable assignment at the end of this file. The
81 XCOMM # desktop reads .profile if your $SHELL is "sh" or "ksh", or .login
82 XCOMM # if your $SHELL is "csh".
84 XCOMM # The desktop reads the .dtprofile and .profile/.login without an
85 XCOMM # associated terminal emulator such as xterm or dtterm. This means
86 XCOMM # there is no available command line for interaction with the user.
87 XCOMM # This being the case, these scripts must avoid using commands that
88 XCOMM # depend on having an associated terminal emulator or that interact
89 XCOMM # with the user. Any messages printed in these scripts will not be
90 XCOMM # seen when you log in and any prompts such as by the 'read' command
91 XCOMM # will return an empty string to the script. Commands that set a
92 XCOMM # terminal state, such as "tset" or "stty" should be avoided.
94 XCOMM # With minor editing, it is possible to adapt your .profile or .login
95 XCOMM # for use both with and without the desktop. Group the statements not
96 XCOMM # appropriate for your desktop session into one section and enclose them
97 XCOMM # with an "if" statement that checks for the setting of the "DT"
98 XCOMM # environment variable. When the desktop reads your .profile or .login
99 XCOMM # file, it will set "DT" to a non-empty value for which your .profile or
100 XCOMM # .login can test.
102 XCOMM # example for sh/ksh
104 XCOMM # if [ ! "$DT" ]; then
106 XCOMM # # commands and environment variables not appropriate for desktop
110 XCOMM # DISPLAY=mydisplay:0
115 XCOMM # # environment variables common to both desktop and non-desktop
117 XCOMM # PATH=$HOME/bin:$PATH
122 XCOMM # example for csh
124 XCOMM # if ( ! ${?DT} ) then
126 XCOMM # # commands and environment variables not appropriate for desktop
130 XCOMM # setenv DISPLAY mydisplay:0
135 XCOMM # # environment variables common to both desktop and non-desktop
137 XCOMM # setenv PATH $HOME/bin:$PATH
138 XCOMM # setenv MYVAR value
141 XCOMM # Errors in .dtprofile or .profile (.login) may prevent a successful
142 XCOMM # login. The login process scans .dtprofile and .profile (.login)
143 XCOMM # for errors (using the '-n' option to the shell). It avoids running
144 XCOMM # them if errors are found and prints the errors to the
145 XCOMM # $HOME/.dt/startlog file. However, his process is not fool proof
146 XCOMM # as some shells are better at finding errors thant others.
147 XCOMM # If after you login, your session startup terminates and you
148 XCOMM # are presented with the login screen, this might be the cause. If this
149 XCOMM # happens, select the Options->Sessions->Failsafe Session item on the
150 XCOMM # login screen, login and correct the error. The $HOME/.dt/startlog and
151 XCOMM # $HOME/.dt/errorlog files may be helpful in identifying errors.
153 XCOMM ##########################################################################
156 XCOMM If $HOME/.profile (.login) has been edited as described above, uncomment
157 XCOMM the following line.
159 XCOMM DTSOURCEPROFILE=true