The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

mkdir_heute - create and find directories interactive

  mkdir_heute

  mkdir_heute --basedir=~/archive

  mkdir_heute --listlines=15

VERSION

This documentation refers to version 0.9.

USAGE

This script scans a basedir (~/A) for directories named YYYY/MM/DD where YYYY, MM and DD are numbers corresponding to a year, month, day of month and prints them on STDERR.

The script returns the choosen directory on STDOUT and may be used in a shell alias like this:

  alias cdheute='cd `mkdir_heute`'

so that you may say 'cdheute' on the command line and your working directory will be changed to the choosen directory.

When invoked you may

  • choose a directory from the list with it's number

  • choose the current directory with 'q' or '.'

  • advance to the next or last page with 'n' or 'l'

  • return to the previous or first page with 'p' or 'f'

  • constrain the shown directories with '/' and a pattern

  • constrain the creation date of the directories with 'd' followed by '=', '<' or '>' and a date (eg. 2009, 2009-04 or 2009-04-24)

  • create a new directory with '+' followed by a description for it

DESCRIPTION

Command Line Arguments

--basedir

With this argument it is possible to redirect the script to another base directory under which it scans for project descriptions to display. A new directory would be created below this directory.

  mkdir_heute --basedir=~/archive

  mkdir_heute -b ~/archive
--listlines

Since it is possible that on some systems Term::ReadKey::GetTerminalSize() does not deliver a meaningful value, you may skip the invocation of that function by providing the nummer of lines for the listing of descriptions on the command line.

  mkdir_heute --listlines=15

  mkdir_heute -l 15

DIAGNOSTICS

Unable to get Terminal Size. The TIOCGWINSZ ioctl didn't work. The COLUMNS and LINES environment variables didn't work. The resize program didn't work. at /usr/lib/perl5/Term/ReadKey.pm line 343.

This happened to me especially on elder systems when invoked via backtics such as

  cd `mkdir_heute`

although the program works fine when invoked directly.

One workaround is to install the program resize which comes on Debian GNU Linux within the package xutils.

If you can't install the program resize, you could start mkdir_heute with a fixed number of list lines like this

  cd `mkdir_heute -l 25`

AUTHOR

Mathias Weidner

LICENCE AND COPYRIGHT

Copyright (c) 2009 Mathias Weidner (mathias@weidner.in-bad-schmiedeberg.de). All rights reserved.

This module is free software; you can redistribute and/or modify it under the same terms as Perl itself. See perlartistic.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 184:

Unknown directive: =head