"hist" "1" "" "" "Starbuntu"

NAME

hist - historicises text entries (provided by Starbuntu)

SYNOPSIS

hist <path of the history file> <maximal number of entries> [<title> [<picture> [<invoking program>]]]

DESCRIPTION

The Starbuntu program hist historicises text entries.

After calling the program a text input box pops up with the chosen title and picture and, moreover, a select list of the history if the given history file already contains entries. Either you select an already existing entry or you type a new one. Then the program hist will place the selected or newly inserted entry at the beginning of the history file.

If you mark a text passage immediately before launching this program the marked text appears first in history and thus saves a manual typing.

FILES

/usr/local/bin/hist

EXAMPLE

From your picture stock you want to create a little collection of picture paths in $HOME/Images by using hist. You select certain pictures and copy their paths into the text input box. After 'OK' the inserted picture pic shall be displayed with the image viewer eog (Eye Of Gnome). An empty input terminates the program. Here the little shell script hist-example doing this:

#!/bin/bash
pic=" "
until [ -z "$pic" ]; do
  pic=$(hist $HOME/Images 100 "Pictures:" info)
  if [ -f "$pic" ]; then eog "$pic"; fi
done
exit 0

AUTHOR

Peter Starfinger <info@die-starfingers.de>