zsh: add basic plugin system, add evil-registers

[dotfiles.git] / etc / zsh / .zshenv

diff --git a/etc/zsh/.zshenv b/etc/zsh/.zshenv
index e20553d7e7fe57fe29b318bf836d60ceb504d798..37daf7fc58bceecc1c5f8c4dcf3cd918d9a53e40 100644 (file)
--- a/etc/zsh/.zshenv
+++ b/etc/zsh/.zshenv
@@ -3,6 +3,8 @@
 # XXX: only call after relevant vars have been set up, defined early so that
 #      below code can utilize it after they do so
 function _sev_zcleanup {
 # XXX: only call after relevant vars have been set up, defined early so that
 #      below code can utilize it after they do so
 function _sev_zcleanup {

+    local x p y
+

     # gpg forwarding
     if [[ -d $_sev_gpg_forward_dir && ( -z $1 || $1 == 'gpg-forward' ) ]] {
         # clean up forward dirs if its session is dead or we ask for it
     # gpg forwarding
     if [[ -d $_sev_gpg_forward_dir && ( -z $1 || $1 == 'gpg-forward' ) ]] {
         # clean up forward dirs if its session is dead or we ask for it


@@ -25,7 +27,7 @@ function _sev_zcleanup {
             }
         }
         # reset GNUPGHOME if we removed our own dir
             }
         }
         # reset GNUPGHOME if we removed our own dir

-        if [[ $GNUPGHOME =~ '/.ssh_forward/\d+/*$' && ! -e $GNUPGHOME ]]
+        if [[ $GNUPGHOME =~ '/.ssh_forward/\d+/*$' && ! -d $GNUPGHOME ]]

             GNUPGHOME=${GNUPGHOME%$MATCH}
     }
 
             GNUPGHOME=${GNUPGHOME%$MATCH}
     }
 


@@ -46,29 +48,40 @@ function _sev_zcleanup {
             }
         }
     }
             }
         }
     }

-
-    unset x p y

 }
 
 function _sev_setpath {
 }
 
 function _sev_setpath {

-    # NOTE: we utilize the fact that unique arrays keep the first occurrence and
-    #       remove any further occurences to capture elements from the old PATH
-    #       that we did not anticipate and shift them to the front, since they are
-    #       probably important to the system
-    typeset -gU path fpath

     # add as many generic paths as possible to keep the order we want
     # add as many generic paths as possible to keep the order we want

-    # NOTE: /usr/{local,pkg,games} are unix/bsdisms
-    # XXX: PREFIX not validated, non-posix but Termux uses it, maybe others
+    # NOTE: tied arrays path and fpath already exist, but are not unique (-U);
+    #       we utilize the fact that unique arrays keep the first occurrence
+    #       and remove any further occurrences to check for elements from the
+    #       old PATH that we did not anticipate and shift them to the front,
+    #       since they are probably important to the system
+    typeset -gU path fpath
+    local -a syspath=("$path[@]")
+    # NOTE: /usr/{pkg,games} are unix/bsdisms
+    # NOTE: some systems (esp. research machines) may have multiple versions of
+    #       packages installed in /opt/[pkg]/[ver]/bin or other dirs, managed
+    #       with something like Environment Modules. this code does not account
+    #       for this type of usage and will add all valid paths. any undesired
+    #       paths can be removed using .zshenv.local.
+    # NOTE: fun non-conformant systems like Android may have fun dirs that
+    #       contain binaries intended solely for the base system, and their use
+    #       by other users/subsystems may cause problems. for example,
+    #       /system/bin/bc on Android may be a different version of or
+    #       completely different codebase compared to the Termux-installed bc.
+    #       modern Termux does not add these such systems to PATH by default,
+    #       but older versions/configurations might.
+    # XXX: PREFIX not validated, non-POSIX but Termux uses it, maybe others

     # XXX: XDG specifies ~/.local/bin as the only user-writable dir for
     #      executables, but we specify more; technically this is against spec
     # XXX: XDG specifies ~/.local/bin as the only user-writable dir for
     #      executables, but we specify more; technically this is against spec

-    syspath=("$path[@]")
-    path=({{${_sev_home:-~},~}{/.local,},{$PREFIX,}{,/opt,/usr{,/local,/pkg}}}/{s,}bin
+    path=({{${_sev_home:-~},~}{/.local,},{$PREFIX,}{,/usr{,/local,/pkg},/opt{,/*{/*,}}}}/{s,}bin(N)

           {$PREFIX,}/usr/{X11R{7,6}/bin,games}
           # emulate Arch Linux flatpak-bindir.sh for use on other systems
           {${XDG_DATA_HOME:-~/.local/share},{$PREFIX,}/var/lib}/flatpak/exports/bin)
           {$PREFIX,}/usr/{X11R{7,6}/bin,games}
           # emulate Arch Linux flatpak-bindir.sh for use on other systems
           {${XDG_DATA_HOME:-~/.local/share},{$PREFIX,}/var/lib}/flatpak/exports/bin)

-    ((len=$#path))
-    path=("$path[@]" "$syspath[@]")
-    # remove bad paths
+    local -i i len=$#path
+    path+=("$syspath[@]")
+    # remove bad paths... after having combined the arrays to remove duplicates

     for (( i = 1; i <= $#path; i++ )) {
         if [[ ! -d $path[$i] ]] {
             path[$i]=()
     for (( i = 1; i <= $#path; i++ )) {
         if [[ ! -d $path[$i] ]] {
             path[$i]=()


@@ -80,7 +93,7 @@ function _sev_setpath {
     # shift valid system paths to the front if there are any left
     ((len > 0 && len < $#path)) && path=("${(@)path[len + 1, -1]}" "${(@)path[1, len]}")
     # include our zsh dir in fpath. unlike above, we always prefer our paths
     # shift valid system paths to the front if there are any left
     ((len > 0 && len < $#path)) && path=("${(@)path[len + 1, -1]}" "${(@)path[1, len]}")
     # include our zsh dir in fpath. unlike above, we always prefer our paths

-    fpath=({${ZDOTDIR:-~/.zsh},{${_sev_home:-~},~}/.zsh}/functions/**/*(/N) "$fpath[@]")
+    fpath=({${ZDOTDIR:-{${_sev_home:-~},~}/.zsh},{${_sev_home:-~},~}/.zsh}/functions/**/*(/N) "$fpath[@]")

     # remove bad paths
     for (( i = 1; i <= $#fpath; i++ )) {
         if [[ ! -d $fpath[$i] ]] {
     # remove bad paths
     for (( i = 1; i <= $#fpath; i++ )) {
         if [[ ! -d $fpath[$i] ]] {


@@ -91,6 +104,7 @@ function _sev_setpath {
     }
     # FPATH is not exported by default
     export FPATH
     }
     # FPATH is not exported by default
     export FPATH

+    # un-unique system arrays for consistency

     typeset +U path fpath
 }
 
     typeset +U path fpath
 }
 


@@ -102,7 +116,7 @@ export LANG=${LANG:-en_US.UTF-8}
 [[ -v _sev_home ]] || export _sev_home=$HOME
 
 ## fix broken term
 [[ -v _sev_home ]] || export _sev_home=$HOME
 
 ## fix broken term

-# NOTE: we do this here instead of .zshrc since we might echo stuff
+# NOTE: we do this here instead of .zshrc since we might print stuff

 if [[ -t 1 ]] { # only if stdout is tty
     [[ ! -v TERM ]] && export TERM=xterm-256color >/dev/null 2>&1
     if [[ $#terminfo -eq 0 ]] {
 if [[ -t 1 ]] { # only if stdout is tty
     [[ ! -v TERM ]] && export TERM=xterm-256color >/dev/null 2>&1
     if [[ $#terminfo -eq 0 ]] {


@@ -120,21 +134,23 @@ if [[ ! -v _sev_setup_path || -o login ]] {
     # NOTE: do not set _sev_setup_path, it is set in zprofile
 }
 
     # NOTE: do not set _sev_setup_path, it is set in zprofile
 }
 

-### home dir setup & exports
+### home dir setup & additional exports

 # XXX: traditionally, zshenv should just contain exports, and not touch the
 # XXX: traditionally, zshenv should just contain exports, and not touch the

-#      filesystem. however, some system profile scripts that are sourced in the
-#      system zprofile may attempt to do things that rely on some of these
-#      vars. for example, `flatpak-bindir.sh` in the Arch Linux flatpak package
-#      references $XDG_DATA_HOME with no fallback. since we do special handling
-#      for these vars before we export them, we're forced to do it all here
-#      instead of zprofile.
+#      filesystem. however, our TMPDIR and XDG vars rely on mutable user paths
+#      that may not exist, and as such need to be set up before the rest of the
+#      system can use them. this is important as some environments include code
+#      in the global zprofile, or source scripts of other shells in the global
+#      zprofile, that may rely on our desired dir structure and vars pointing
+#      to it. for example, `flatpak-bindir.sh` in the Arch Linux flatpak
+#      package references $XDG_DATA_HOME with no fallback. since we do special
+#      handling for these vars before we export them, we're forced to do it all
+#      here instead of at the top of the zprofile.

 
 ## xdg local dir
 # NOTE: need this for tmp, so confirm it exists.
 
 ## xdg local dir
 # NOTE: need this for tmp, so confirm it exists.

-# XXX: perms are not specified for XDG dirs except runtime, but I think 760
-#      makes the most sense. shouldn't break anything since no one else should
-#      be poking around in our dir.
-[[ -e ~/.local ]] || mkdir -m760 ~/.local
+# XXX: perms are not specified for XDG dirs except runtime. 760 makes the most
+#      sense, but we need to be a bit more permissive for zsu.
+[[ -e ~/.local ]] && chmod 755 ~/.local || mkdir -pm766 ~/.local

 
 ## tmp
 # NOTE: specs say that POSIX tmp and XDG runtime directories should exist
 
 ## tmp
 # NOTE: specs say that POSIX tmp and XDG runtime directories should exist


@@ -145,51 +161,57 @@ if [[ ! -v _sev_setup_path || -o login ]] {
 #       though it is not expressly spec compliant. this may also cause problems
 #       with disowned applications that still try to use the directories after
 #       the toplevel shell has already logged out and the dirs removed, but the
 #       though it is not expressly spec compliant. this may also cause problems
 #       with disowned applications that still try to use the directories after
 #       the toplevel shell has already logged out and the dirs removed, but the

-#       chances of that are slim.
+#       chances of that are slim. this also needs to be adjusted for usermode
+#       Xorg, as it requires $PREFIX/tmp/.X11-unix on most installs.

 if [[ ! -v _sev_tmp ]] {
 if [[ ! -v _sev_tmp ]] {

-    # create personal TMPDIR under system tmp
-    t=${TMPDIR:-${TEMPDIR:-${TEMP:-${TMP:-/tmp}}}}/.home-$LOGNAME
-    [[ -e $t ]] || mkdir -m700 $t 2>/dev/null

     _sev_tmp=~/.local/tmp
     _sev_tmp=~/.local/tmp

-    if [[ ! -d $t ]] {
+    # create personal TMPDIR under system tmp
+    # NOTE: under proot with uid remapping and shared /tmp, we can reuse old
+    #       dir, without worrying about permission issues; intended for termux.
+    _t=${TMPDIR:-${TEMPDIR:-${TEMP:-${TMP:-${${TMPPREFIX%/zsh}:-/tmp}}}}}/.home-${_sev_proot_real_user:-$LOGNAME}
+    [[ -e $_t ]] || mkdir -m700 $_t 2>/dev/null
+    if [[ ! -d $_t ]] {

         # fallback TMPDIR to bare local directory or existing softlink
         [[ -o interactive ]] &&
         # fallback TMPDIR to bare local directory or existing softlink
         [[ -o interactive ]] &&

-          print -P "%F{orange}*** Can't create tmp dir $t, using $_sev_tmp%f"
+          print -P "%F{orange}*** Can't create tmp dir $_t, using $_sev_tmp%f"

         [[ -h $_sev_tmp && ! -d _sev_tmp ]] && unlink $_sev_tmp 2>/dev/null
         [[ ! -e $_sev_tmp ]] && mkdir -m700 $_sev_tmp 2>/dev/null
         if [[ ! -d $_sev_tmp ]] {
         [[ -h $_sev_tmp && ! -d _sev_tmp ]] && unlink $_sev_tmp 2>/dev/null
         [[ ! -e $_sev_tmp ]] && mkdir -m700 $_sev_tmp 2>/dev/null
         if [[ ! -d $_sev_tmp ]] {

-            _sev_tmp=${$(mktemp 2>/dev/null):/tmp}
+            _sev_tmp=${$(mktemp 2>/dev/null):-/tmp}

             [[ -o interactive ]] &&
               print -P "%F{red}!!! Can't create tmp dir, using $_sev_tmp%f"
         }
             [[ -o interactive ]] &&
               print -P "%F{red}!!! Can't create tmp dir, using $_sev_tmp%f"
         }

-    } elif [[ -f $_sev_tmp || ( -d $_sev_tmp && ! -h $_sev_tmp ) ]] {
-        # file or non-softlink directory is on our local dir
+    } elif [[ -e $_sev_tmp && ! -h $_sev_tmp ]] {
+        # non-softlink node is on our local dir

         [[ -o interactive ]] &&
         [[ -o interactive ]] &&

-          print -P "%F{orange}*** $_sev_tmp exists, can't link to tmp dir $t, ignoring it%f"
-        _sev_tmp=$t
+          print -P "%F{orange}*** $_sev_tmp exists, can't link to tmp dir $_t, ignoring it%f"
+        _sev_tmp=$_t

     } else {
     } else {

-        # link local dir to tmp dir
-        if [[ -h $_sev_tmp && $_sev_tmp:P != $t:P ]] {
+        if [[ ! -v $_sev_tmp_keep_link && -h $_sev_tmp && $_sev_tmp:P != $_t:P ]] {

             [[ -o interactive ]] &&
               print -P "%F{orange}*** $_sev_tmp links to ${_sev_tmp:P} and not ${t:P}, unlinking it%f"
             [[ -o interactive ]] &&
               print -P "%F{orange}*** $_sev_tmp links to ${_sev_tmp:P} and not ${t:P}, unlinking it%f"

-            # XXX: race condition for existing sessions still using this dir
+            # NOTE: ln -f doesn't seem to work reliably with softlink
+            #       directories, so explicitly remove the target if it exists
+            # XXX: potential race condition
+            # TODO: handle cleanup of old dir if it doesn't match?

             unlink $_sev_tmp 2>/dev/null
         }
             unlink $_sev_tmp 2>/dev/null
         }

-        ln -s $t $_sev_tmp 2>/dev/null
-    }
-    if [[ -v _sev_tmp ]] {
-        # ensure dir is clean
-        _sev_zcleanup tmp
-        # finally create our subdir for this session
-        t=$_sev_tmp/.session.$$
-        if ! mkdir -m700 $t 2>/dev/null; then
-            [[ -o interactive ]] &&
-              print -P "%F{red}!!! Can't create session tmp subdir $t, using $_sev_tmp%f"
-            t=$_sev_tmp
-        fi
-        export _sev_tmp TMPDIR=$t TEMPDIR=$t TEMP=$t TMP=$t
+        if [[ ! -e $_sev_tmp ]] {
+            # link local dir to tmp dir
+            ln -s $_t $_sev_tmp 2>/dev/null
+        }

     }
     }

-    unset t
+    # ensure dir is clean
+    _sev_zcleanup tmp
+    # finally create our subdir for this session
+    _t=$_sev_tmp/.session.$$
+    if ! mkdir -m700 $_t 2>/dev/null; then
+        [[ -o interactive ]] &&
+          print -P "%F{red}!!! Can't create session tmp subdir $_t, using $_sev_tmp%f"
+        _t=$_sev_tmp
+    fi
+    export _sev_tmp TMPDIR=$_t TEMPDIR=$_t TEMP=$_t TMP=$_t TMPPREFIX=$_t/zsh
+    unset _t

 }
 
 ## xdg
 }
 
 ## xdg


@@ -204,56 +226,47 @@ if [[ ! -v _sev_setup_xdg ]] {
     # include any of the below dirs there, but you never know what crazy shit
     # people will do. I rather handle them sanely with our own code than let
     # them override after the fact.
     # include any of the below dirs there, but you never know what crazy shit
     # people will do. I rather handle them sanely with our own code than let
     # them override after the fact.

-    [[ -e $XDG_CONFIG_HOME/user-dirs.dirs ]] &&
+    [[ -f $XDG_CONFIG_HOME/user-dirs.dirs ]] &&

       emulate sh -c "source $XDG_CONFIG_HOME/user-dirs.dirs"
 
     typeset -UT XDG_DATA_DIRS xdg_data_dirs
       emulate sh -c "source $XDG_CONFIG_HOME/user-dirs.dirs"
 
     typeset -UT XDG_DATA_DIRS xdg_data_dirs

-    if [[ -v XDG_DATA_HOME ]] {
-        export XDG_DATA_HOME
-    } elif [[ ! -e ~/.local/share ]] {
-        mkdir -m760 ~/.local/share
-    }
-    xdg_data_dirs=($XDG_DATA_HOME /{opt,usr/local,usr/pkg,usr}/share
-      ${XDG_DATA_DIRS:+${xdg_data_dirs%%/}})
+    [[ -v XDG_DATA_HOME ]] && export XDG_DATA_HOME
+    [[ -e ${XDG_DATA_HOME:-~/.local/share} ]] ||
+      mkdir -m760 ${XDG_DATA_HOME:-~/.local/share}
+    xdg_data_dirs=($XDG_DATA_HOME ${XDG_DATA_DIRS:+${xdg_data_dirs%%/}}
+      /{usr{,/local,/pkg},opt{,/*{/*,}}}/share(N))
+    xdg_data_dirs=($xdg_data_dirs(/N))

     export XDG_DATA_DIRS
 
     typeset -UT XDG_CONFIG_DIRS xdg_config_dirs
     export XDG_DATA_DIRS
 
     typeset -UT XDG_CONFIG_DIRS xdg_config_dirs

-    if [[ -v XDG_CONFIG_HOME ]] {
-        export XDG_CONFIG_HOME
-    } elif [[ ! -e ~/.config ]] {
-        mkdir -m760 ~/.config
-    }
+    [[ -v XDG_CONFIG_HOME ]] && export XDG_CONFIG_HOME
+    [[ -e ${XDG_CONFIG_HOME:-~/.config} ]] ||
+      mkdir -m760 ${XDG_CONFIG_HOME:-~/.config}

     # I am of the belief .local should follow FHS /usr/local...
     # I am of the belief .local should follow FHS /usr/local...

-    [[ -e ~/.local/etc ]] || ln -s ~/.config ~/.local/etc
-    xdg_config_dirs=($XDG_CONFIG_HOME
-      ${XDG_CONFIG_DIRS:+${xdg_config_dirs%%/}}
-      {/opt,/usr/local,/usr/pkg,}/etc/xdg)
+    [[ -e ~/.local/etc ]] || ln -s ${XDG_CONFIG_HOME:-~/.config} ~/.local/etc
+    xdg_config_dirs=($XDG_CONFIG_HOME ${XDG_CONFIG_DIRS:+${xdg_config_dirs%%/}}
+      {,/usr{,/local,/pkg},opt{,/*{/*,}}}/etc/xdg(N))
+    xdg_config_dirs=($xdg_config_dirs(/N))

     export XDG_CONFIG_DIRS
 
     export XDG_CONFIG_DIRS
 

-    if [[ -v XDG_STATE_HOME ]] {
-        export XDG_STATE_HOME
-    } elif [[ ! -e ~/.local/state ]] {
-        mkdir -m760 ~/.local/state
-    }
+    [[ -v XDG_STATE_HOME ]] && export XDG_STATE_HOME
+    [[ -e ${XDG_STATE_HOME:-~/.local/state} ]] ||
+      mkdir -m760 ${XDG_STATE_HOME:-~/.local/state}

 
     if [[ -v XDG_CACHE_HOME ]] {
         export XDG_CACHE_HOME
     } else {
 
     if [[ -v XDG_CACHE_HOME ]] {
         export XDG_CACHE_HOME
     } else {

-        if [[ -v _sev_tmp ]] {
-            export XDG_CACHE_HOME=$_sev_tmp/.xdg.cache
-            [[ -e $XDG_CACHE_HOME ]] || mkdir -m700 $XDG_CACHE_HOME
-        } elif [[ ! -e ~/.cache ]] {
-            mkdir -m700 ~/.cache
-        }
+        export XDG_CACHE_HOME=$_sev_tmp/.xdg.cache

     }
     }

+    [[ -e ${XDG_CACHE_HOME:-~/.cache} ]] ||
+      mkdir -m700 ${XDG_CACHE_HOME:-~/.cache}

 
 

+    # NOTE: this can be set by systemd or other pre-shell supervisor, and if
+    #       any services were started such as pipewire, we need to use the
+    #       existing runtime dir to preserve runtime state

     if [[ -v XDG_RUNTIME_DIR ]] {
     if [[ -v XDG_RUNTIME_DIR ]] {

-        # NOTE: this can be set by systemd or other pre-shell supervisor, and
-        #       if any services were started such as pipewire, we need to use
-        #       the existing runtime dir so that we can get any existing
-        #       program sockets or other data

         export XDG_RUNTIME_DIR
         export XDG_RUNTIME_DIR

-    } elif [[ -v TMPDIR ]] {
+    } else {

         # make runtime dir in our session-specific tmpdir
         export XDG_RUNTIME_DIR=$TMPDIR/.xdg.runtime
         # same as in tmpdir creation, ensure dir doesn't exist
         # make runtime dir in our session-specific tmpdir
         export XDG_RUNTIME_DIR=$TMPDIR/.xdg.runtime
         # same as in tmpdir creation, ensure dir doesn't exist


@@ -262,8 +275,9 @@ if [[ ! -v _sev_setup_xdg ]] {
         } elif [[ -e $XDG_RUNTIME_DIR ]] {
             rm -rf $XDG_RUNTIME_DIR 2>/dev/null
         }
         } elif [[ -e $XDG_RUNTIME_DIR ]] {
             rm -rf $XDG_RUNTIME_DIR 2>/dev/null
         }

-        mkdir -m700 $XDG_RUNTIME_DIR 2>/dev/null

     }
     }

+    [[ ! -e $XDG_RUNTIME_DIR ]] &&
+      mkdir -m700 $XDG_RUNTIME_DIR 2>/dev/null

 
     export _sev_setup_xdg=
 }
 
     export _sev_setup_xdg=
 }


@@ -280,10 +294,31 @@ if [[ ! -v GNUPGHOME ]] {
 }
 
 ## perl local lib
 }
 
 ## perl local lib

-[[ ! -v PERL_LOCAL_LIB_ROOT && -v commands[perl] &&
-   -d $XDG_DATA_HOME/perl5/lib/perl5 ]] &&
-  eval $(perl -I$XDG_DATA_HOME/perl5/lib/perl5 \
-              -Mlocal::lib=$XDG_DATA_HOME/perl5 2>/dev/null)
+if [[ ! -v PERL_LOCAL_LIB_ROOT && -v commands[perl] ]] {
+    _p5=${XDG_DATA_HOME:-~/.local/share}/perl5
+    [[ -d $_p5 ]] || mkdir -p $_p5
+    if [[ -f $_p5/lib/perl5/local/lib.pm ]] {
+        eval $(perl -I$_p5/lib/perl5 -Mlocal::lib=$_p5 2>/dev/null)
+    } else {
+        # emulate local::lib if not installed
+        path=($_p5/bin "${path[@]}")
+        export \
+          PERL_MB_OPT="--install_base '$_p5'" \
+          PERL_MM_OPT=INSTALL_BASE=$_p5 \
+          PERL5LIB=$_p5/lib/perl5 \
+          PERL_LOCAL_LIB_ROOT=$_p5${PERL_LOCAL_LIB_ROOT:+:$PERL_LOCAL_LIB_ROOT}
+    }
+    unset _p5
+}
+## go
+if [[ -v commands[go] ]] {
+    [[ ! -v GOPATH ]] && export GOPATH=${XDG_DATA_HOME:-~/.local/share}/go:~/go
+    [[ ! -v GOBIN  ]] && export GOBIN=~/.local/bin
+}
+
+### plugins
+autoload -Uz load-plugins
+load-plugins zshenv

 
 ### load zshenv site-specific
 autoload -Uz load-site-dotfile
 
 ### load zshenv site-specific
 autoload -Uz load-site-dotfile


@@ -292,9 +327,9 @@ load-site-dotfile zshenv
 ### source .zprofile early for non-login shells that should be
 if [[ ! -v _sev_first_display && ( -v DISPLAY || -v WAYLAND_DISPLAY ) ]] {
     # most graphical login/session managers will spawn the user's shell as a
 ### source .zprofile early for non-login shells that should be
 if [[ ! -v _sev_first_display && ( -v DISPLAY || -v WAYLAND_DISPLAY ) ]] {
     # most graphical login/session managers will spawn the user's shell as a

-    # parent of all child processes for that session. however, if the parent shell
-    # isn't a login shell for some reason, our .zprofile won't be run, and the
-    # environment won't be configured for child processes.
+    # parent of all child processes for that session. however, if the parent
+    # shell isn't a login shell for some reason, our .zprofile won't be run,
+    # and the environment won't be configured for child processes.

     #
     # XXX: .zprofile will be sourced by every new child shell if zsh is not
     #      used to start the graphical session and the _sev_first_display var
     #
     # XXX: .zprofile will be sourced by every new child shell if zsh is not
     #      used to start the graphical session and the _sev_first_display var