> On Jul 13, 2025, at 3:58 PM, Lawrence Velázquez <v...@larryv.me> wrote: > > On Sun, Jul 13, 2025, at 3:17 PM, jason stein wrote: >> *Pull Request:* >> https://github.com/jstein916/bash/pull/1 > > In general it's preferable to provide a patch directly (either inline > or as an attachment), rather than requiring prospective reviewers to > visit an external site. >
Sorry, here's the context, for those who aren't also on help-bash (also forwarded below): https://lists.gnu.org/archive/html/help-bash/2025-07/msg00033.html -- vq Begin forwarded message: > From: jason stein <jstein...@gmail.com> > Subject: new command dh (dirhistory) > Date: July 13, 2025 at 3:17:29 PM EDT > To: bash list <help-b...@gnu.org> > > Hey All, > I developed a new builtin and I was wondering what is the process for > getting it added to the official release (e.g. reviews, votes, etc). > > *Pull Request:* > https://github.com/jstein916/bash/pull/1 > > *What the command dh does:* > it adds a new command called "dh" which stands for directory history. The > new command is similar to history but deals exclusively with the > directories that have been cd to. It creates a .bash_dirhistory file > similar to history. > > *Help from bash:* > dh: dh [-ciw] [-m N] [N|partial_name] > Directory history navigation. > > Display the directories that have been visited using the cd command, > ordered by frequency of access. Directories are numbered with the most > frequently accessed directory having index 1 (displayed last in the > list). > > Options: > -c clear the directory history > -i show visit counts in parentheses > -m N limit display to N most recent directories > -w write directory history to file > > Usage: > dh display directory list > dh -i display directory list with visit counts > dh -m 10 display only the 10 most recent > directories > dh -w save directory history to file > dh N change to directory number N from the > list > dh N-M change to directory number N, then go > up M levels > dh partial_name change to directory matching > partial_name, or show matches > > Examples: > dh 5 change to the 5th directory in history > dh 5-2 change to the 5th directory, then go up > 2 parent directories > dh -m 5 -i show only 5 most recent directories > with visit counts > dh proj change to directory containing 'proj' > in its basename > dh bash change to directory containing 'bash', > or show all matches > > Exit Status: > Returns success unless an invalid option is given. > > > *Examples:* > Jason@PC MSYS /c/Projects/bash > $ cd /tmp/test1 > > Jason@PC MSYS /tmp/test1 > $ cd /tmp/test2/ > > Jason@PC MSYS /tmp/test2 > $ cd /tmp/test3 > > Jason@PC MSYS /tmp/test3 > $ dh > 3 /tmp/test3 > 2 /tmp/test2 > 1 /tmp/test1 > > Jason@PC MSYS /tmp/test3 > $ dh 31 > bash: dh: directory number 31 out of range (1-3) > > Jason@PC MSYS /tmp/test3 > $ dh 1 > /tmp/test1 > > Jason@PC MSYS /tmp/test1 > $ dh test3 > /tmp/test3 > > Jason@PC MSYS /tmp/test3 > $ dh > 3 /tmp/test3 > 2 /tmp/test2 > 1 /tmp/test1 > > Jason@PC MSYS /tmp/test3 > $ dh 2-1 > /tmp > > Jason@PC MSYS /tmp > > > $ dh tmp > Multiple matches found: > 1 /tmp/test3 > 3 /tmp/test2 > 2 /tmp/test1 > > > Thanks > > Jason