dirstack - builds a shell directory stack from a file of previously stored directories

NAME

dirstack - builds a shell directory stack from a file of previously stored directories

SYNOPSIS

  source dirstack

DESCRIPTION

dirstack is a csh/tcsh script that builds a directory stack for a login shell from a directory file. A directory file in this context is a file that lists the previously stored directories names used by csh or tcsh.

dirstack uses the most recently used directory file that is considered "current". Current directory files are those directory files in the ~/.sessions directory that do not have the .save suffix. After using a current directory file, dirstack will rename the directory file so that it has the .save suffix.

The source'ing shell's starting directory is removed from the final stack of directories. This is done because dirstack is intended to mirror the list of directories it is reading, not to add to the existing directory stack.

This script should be sourced, rather than executed. Directory names that contain spaces are properly handled.

csh has a facility for saving a directory stack, but it is geared towards single-shell use. This script is intended for use in a windowing environment.

REQUIREMENTS

There are a number of requirements for using dirstack:

There must be a directory in the user's home directory called .sessions, which will hold the directory files.
There will be a shell variable ttyname, which will be the name of an individual terminal. For example, my .cshrc uses this line to set this variable:
set ttyname = `xprop -id $WINDOWID WM_NAME | awk -F\" '{print $2}' | awk '{print $1}'`
The directory files are named d-${ttyname}-. So, for a terminal with a name of "devel", and an xterm with a pid of 38911, the directory file's absolute path will be ~/.sessions/d-devel-38911.
The directory files will be updated after every pushd/ popd execution. I use these two aliases (and a few other related ones) to accomplish this:
alias dv "dirs -v | perl -p -e 's/^\d+\s+//'"
alias pd "pushd \!* ; dv > $dirsfile"

LICENSE

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

AUTHOR