gd-libgd / src / gd.1

.TH GD 1
gd \- alias: quickly change to another directory
.ll +8
.B gd
.RB [ " \-r "
.RB [ " \-\-rebuild "
.I "directory"
.ll -8
.I gd
makes it possible to move to another directory without entering more
of it's name than the start of the last path-element.
It keeps a file containing the directory structure of and in the
home directory of each user.

.I gd
is supposed to be a shell-alias or -function. See
gdprog(1) for installation instructions.

The program will first check if a normal chdir to the given
directory will work. If not, it searches the (home-) directory
tree top to bottom, left to right (in an alphabetic manner) for
a match. The search starts with the directory after the current,
and wraps around to the start when the end is reached.

To save some typing, a match is defined to be a directory who's
`last name' starts with the name given.

Scanning the directory structure takes some time, so instead of
doing that,
.I gd
keeps the structure in a file. This file needs to be updated
whenever directories are added or removed. If, whenever
.I gd
is started, the current directory
(below home) is not in the file, a rescan will be performed
automatically. However, if the directory structure is changed without
.IR gd 's
knowing, you may have to rebuild the file using the \-r option.
This is the case if
.I gd
is unable to find an existing directory, or
if it tries to move to a location that no longer exists.
.B \-r, \-\-rebuild
Rebuild the directory structure file. Use this when
.I gd
complains about unknown directories, or to update the file
when directories have been added or removed.
The directory structure is stored in .gdinfo in the user's
The environment variable
is used to determine the homedirectory of the current user.
.I gd
appeared in 1990 as an MS-DOS program (by the same author).
This perl-program was written from scratch in 1994 by Sverre H. Huseby,
Norway (
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.