____________________________________________________________________________
 ____              _                         _    
|  _ \            | |                       | |   
| |_) | ___   ___ | | ___ __ ___   __ _ _ __| | __
|  _ < / _ \ / _ \| |/ / '_ ` _ \ / _` | '__| |/ /
| |_) | (_) | (_) |   <| | | | | | (_| | |  |   < 
|____/ \___/ \___/|_|\_\_| |_| |_|\__,_|_|  |_|\_\

____________________________________________________________________________

Bookmark
v2.2 12-Oct-96
by Nicholas Metcalfe
nick@salokin.demon.co.uk
http://www.salokin.demon.co.uk/
____________________________________________________________________________


==> Contents

- Introduction
- New in this version (v2.2)
- Installation
- Hotkey summary and system variable information
- Hints
- Email me



==> Introduction

Bookmark provides a fast and easy way of switching/changing between
directories in DOS by letting you 'bookmark' directory paths with 
keyboard shortcuts. It also gives you a quick way of copying files 
between directories and can be used from batch files as a powerful 
means of returning the user to the current directory.

It does this using keyboard hotkeys:

Press Alt-F1 to 'bookmark' the current directory path. The current directory
path is then stored in a system variable. When you have wandered off
to another directory and want to return to the original directory press
Ctrl-F1 and the currently selected directory path will change to the one you
'bookmarked' earlier. Up to four locations can be 'bookmarked', using the 
function keys F1-F4. Try it out and you'll see just how fast and easy it is.

Press Shift-F5 to see a list of the current bookmarks.

The directory locations you store will remain until you store other locations
over the top of them or until you reboot the machine, since they are stored
in the system variables dir1-dir4 and drv1-4 respectively.



==> New in this version: (v2.2)

If you press Shift F1-F4 then the directory path stored in the bookmark is 
inserted at the current cursor position, allowing you to quickly move or copy
files to the selected location. For example, 
COPY *.TXT <Shift-F1>
will copy *.txt to bookmark number 1.
(can be applied to any other commands)
Because you will generally use the bookmark location as the last part of the
command, bookmark will 'press enter' for you to make use as fast as possible.

Bookmark can cope with directory names with spaces in them for when you use a 
dos window in windows 95.



==> Installation:

Copy the files BM.BAT and BM.TXT to a directory of your choice (I recommend 
C:\DOS or C:\WINDOWS\COMMAND), then simply run BM.BAT to initialise the 
keyboard hotkeys. I recommend you call BM.BAT from your autoexec.bat file. 
Bookmark requires ansi.sys to be loaded in config.sys. 

Bookmark stores the bookmarks in Dos's environment space where other system 
variables live. You may find that you need to increase the size of your 
environment space - if you get an 'out of environment space' message then you 
do. Look in config.sys and you will probably see a line like this:

SHELL=C:\COMMAND.COM C:\ /E:1024 /P

The number after the /E: is your environment size. 1024 bytes is generally a
good value.



==> Hotkey summary and system variable information:

Bookmark current directory location:
Alt-F1   (system variable: dir1 and drv1)  (command line: 'bm set 1')
Alt-F2                     dir2     drv2                  'bm set 2'
Alt-F3                     dir3     drv3                  'bm set 3'
Alt-F4                     dir4     drv4                  'bm set 4'

Go to bookmarked location (change to that directory):
Ctrl-F1  (change to dir1 on drv1)          (command line: 'bm go 1')
Ctrl-F2             dir2 on drv2)                         'bm go 2'
Ctrl-F3             dir3 on drv3)                         'bm go 3'
Ctrl-F4             dir4 on drv4)                         'bm go 4'

Type bookmark location at cursor position:
Shift-F1            (%dir1%)
Shift-F2            (%dir2%)
Shift-F3            (%dir3%)
Shift-F4            (%dir4%)

Show current bookmarks:
Shift-F5  (command line: 'bm show')



==> Hints:

Use your right hand to press ctrl or alt and your left hand to press the 
function key. Sounds a silly point but this makes it much easier.

Since the paths are stored as system variables (dir1, dir2, dir3 and dir4),
you can type %dir1% instead of the full path of location 1. Pressing Shift-F1
will make this quicker, but for speed I have set it to 'press enter' for you.
If you want to use %dir1% somewhere other than the end of the command or in a
batch file then just type it.

When you press any of the Bookmark hotkeys, the BM.BAT batch file is run. You 
can of course just type the command instead if you want. See the table above 
for the command line equivalent of each key. This way you can call Bookmark 
from other batch files if you want.

If you do type the commands then you are not limited to four bookmarks - you 
can have as many as you want. You don't have to use numbers to reference them 
either. 'BM SET FRED' will get bookmark to store the current directory to the 
system variables DRVFRED and DIRFRED. If you type BM GO FRED then you will be 
taken back to the directory you bookmarked as FRED earlier. 

This means you can use Bookmark with any batch files you write as an easy way
of storing directory locations. You can for example get the batch file to 
store the current directory location when the user runs it, and then get 
Bookmark to return to the stored location at the end, or use the system 
variables as part of the batch file. The number of bookmarks you can have is
limited only by available environment space. As Bookmark is a batch file, 
remember to 'CALL' it rather than just run it otherwise control will not be 
returned to your batch file. eg 'CALL BM SET FRED'.

For general Dos and Windows 95 hints and utilities see my web page:
http://www.salokin.demon.co.uk/



==> Email me:

Please email me if you like bookmark. I will keep you informed of any new 
versions. If you have ideas or suggestions for improvements then please email 
me. For more dos enhancements and the latest version of bookmark see my web 
page. Address below.

Thanks to Michael Donn <miked@wolfenet.com> for his help with Bookmark. Many
of his suggestions were used for version 2.0 of Bookmark, in particular the
single batch file format rather than separate batch files for the different
operations. 

 _  _ _    _
| \| (_)__| |__  Nicholas Metcalfe
| .` | / _| / /  nick@salokin.demon.co.uk
|_|\_|_\__|_\_\  http://www.salokin.demon.co.uk/

