*  Press Ctrl-Alt-Down to Edit Help File
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
A:Desciption:

  Program 1: clipstep  (Modified version of clipstep (from Skrommel) version 1.1
  Program 2: ClpSeek   (Based on Seek, Coder   : Phi) version 1.1

CLIPSTEP is a modified version of Skrommel's Clipstep, which is a clipboard extension app
which uses only [Control]+v and [Control]+c and [Control]+x to allow clips to be stored as 
.CLIP files, and allows selection of stored clips for Re-Pasting. It is now modified to work
with CLIPSEEK, a new program (modified form of Seek from Phi) which has two different modes 
of operation:

CLIPSEEK CLIP Mode: 
  - Displays large table of clipboard CLIPs and shows Clip content
  - Predefine a Permanent directory for preconfigured applications to store clips
  - Allows Selection criteria to preselect clips to be displayed, many modes offered
  - Provides alternative Pasting options and other functions
  - Can add comments to individual clips, mark clips to preserve/display at top of list
  - Copy/Cut/Paste Selected block of clip-content from and to clip files
  
CLIPSEEK Directory Mode: 
  - Displays (Recursed) list of files (and directories), shows file contents/properties/icons
	for common file-types and common grahics. (uses external programs detailed in help file)
  - Allows Selection criteria for filename AND/OR contents to preselect files to be displayed, 
	many modes offered.
  - Can preconfigure settings for Active programs/Apps/extensions, which are automatically
	selected by ClipSeek when run, or can be manually selected, once .ini is configured.
  - Various display, selection and sort options
  - Allows files to be run (if File association exists)/ or Directories to be selected.
  - Allows listing of Apps (Link files etc) in StartMenu and StartMenuCommon, to search for 
	and run required application.
  - Can allow MS Word (2000) Document files to be listed with block of contents, on which
	Selective search can restrict list, to aid in file selection, and run MSWORD with
	selected file(s).

----------------------------------------------------------------------------------

B:	INSTALL:

 1. 'ClipSeek.ahk' and 'ClipStep.ahk' are AutoHotkey scripts. 
    To compile either, it is first necessary to install AutoHotkey v1.0.25 or higher on your 
    PC - download from:
    
	    http://www.autohotkey.com 

 2. There is no installation required, it doesn't write anything to the registry, and it 
 	doesn't access the Internet at all (no phoning home). 
    A small Setup routine is run when ClipSeek is run for the first time to set some important 
    keys in the clpsrch.ini file. The Initial Setup routine cannot set multipe pipe "|" 
    delimited paths which can be set from the "Setup" Tab.
    To uninstall, simply delete the clipstep directory, and remove the link to clipstep in 
    Start Menu\programs\STARTUP.

Details: 
First, UNZIP clipstep.zip to the "CLIPSTEP" directory from which the program will be run

The contents of CLIPSTEP.ZIP are as follows:
---------------------------------------------- CLIPSTEP.ZIP:
Directory: Clipstep\

ClpSrch.ini
ClpSrch0.ini
ClipStep.lnk
ClipStep.ico
ClipStep.exe
ClipStep.ahk
Clipseek.lnk
clipseek.exe
clipseek.ahk
[PermWord]  
[PermIntnt] 
[PermB]     
[Permahk]   
[Perm]      
[(S)]       
[!filscrpt] 

Directory: \!filscrpt

clipseek.txt
clip1.tmp   
_Seek.lst   
_Seek.key   

Directory: \(S)

Directory: \Perm

Directory: \Perm\(S)

Directory: \Permahk

Directory: \PermB

Directory: \PermIntnt

Directory: \PermWord
----------------------------------------------
The directory "!filscrpt" is required by the program, and the remaining directories 
are included to conform to the example "ClpSrch.ini" file which must be correctly
configured if the program is to run correctly.

Note:

Create a shortcut to the "ClipStep.exe" program and place this .lnk file in:
   "Start Menu\PROGRAMS\STARTUP"

----------------------------------------------------------------------------------

C:	Uses:

There are a number of programs to help extend Clipboard facilities. Such programs
can cause serious problems when used with older programs, some designed to work with 
Windows 98, when the clipboard chain is broken and peculiar results occur. 
Such problems did not arise when using Skrommel's clipstep program.
A further benefit of Skrommel's Clipstep is the limited use of Hotkeys, which are confined to
[Ctrl], X, C, V. With the use of a hotkey management program to build an elaborate program-
specific macro set and the freedom to utilise a variety of (macro) keys in diferent programs, 
common key combinations are quickly used up.


CLIPSTEP OPERATION:

Control multiple clipboards using only the keyboard's Ctrl(-Alt)-X-C-V.

Select some text, press Ctrl-C a couple of times to copy it to multiple new clipboards. 
Hold down [Ctrl] and press "V" repeatedly to step through the clipboard clips. 
While continuing to hold down [Ctrl] key, "C" steps forward and "V" steps backwards. 
When you've got the clipboard you want, release [Ctrl] to paste. 
To delete a clip file, hold down [Ctrl], press V followed by X twice to delete, or 
three times to delete all, or once to cancel. Release [Ctrl] to accept.
Note that the clip display does not show formatting; If the Active application shows a 
text file (.txt, or .txx), formatting is centred and justified, but for other formats,
the viewing panel shows only the first 65 characters of each line, Left justified
(except for filenames, web addresses, etc).

Hotkey List:
Press & Hold-[Ctrl] 
Press V: 	Display (Progress) of existing clips (initial text ONLY from last three clips)
  			Selected clip shown in Centre of Display, above is previous clip, below is next.
		 	If Progress Display visible:
Press V: 	Select previous clip (set of three) for display				
Press C: 	Select next clip (set of three) for display

Release [Ctrl] - Paste selected clip  - OR
Press X:   	& Release [Ctrl] - Exit clip Display mode, without Paste
Press XX:  	Delete selected clip when [Ctrl] released
Press XXX: 	Delete ALL clips when [Ctrl] released

			If Progress Display visible: WHILE Holding down [Ctrl]
Press [Ctrl]-Alt-V: to Toggle Current and "Permanent" dir: i.e. \Perm, & SELECT LAST CLIP 
Press [Ctrl]-Alt-C: to COPY current clip TO: Permanent dir.,

		 	If Progress Display NOT visible:
Press [Ctrl]-C: Copy item to Clipboard. Clipstep shows tooltip to indicate clip file created.
Press [Ctrl]-X: Cut  item to Clipboard. Clipstep shows tooltip to indicate clip file created.

For [Ctrl]-C and [Ctrl]-X, if editing a file, and text is not blocked or marked, Clipstep
will attempt to select the current line to copy/cut to clipboard and create the clip file.

     While  [Ctrl] is held down, then press and hold "V" (for SHOWCLIPS) and
Press C,ie: [Ctrl]-V+C to run the ClipSeek CLIP Search program **    OR
Press X,ie: [Ctrl]-V+X to run the ClipSeek Directory Search program **
i.e.
For  "Press [Ctrl]-V+C/X", press and hold "Control" then "V" keys down, THEN press and hold "C"
(or "X") down. then release all three keys.

IMPORTANT **

CLIPSEEK is a separate program designed to work in combination with
clipstep. It has two different modes of operation, described below in more detail.

In order to run CLIPSEEK: (Clipstep mode) [Ctrl-V-C]
   - PRESS AND HOLD [Ctrl], AND PRESS AND HOLD "V", THEN PRESS AND HOLD "C" so that all 
     three are keys are momentarily down at the same time.
   - Alternatively, right-click the Taskbar clipstep icon and select "ClipSelect..."

In order to run CLIPSEEK: (dir mode)  [Ctrl-V-X]
   - PRESS AND HOLD [Ctrl], AND PRESS AND HOLD "V", THEN PRESS AND HOLD "X" so that all 
     three are keys are momentarily down at the same time.
   - Alternatively, right-click the Taskbar clipstep icon and select "ClipSeek Dir"

Note that ClipSeek cannot function as it was designed to UNLESS clpsrch.ini is correctly
configured for the system and for the preconfigured applications.

Configure Clipstep:

Clipstep will store clips in the main Clipstep directory (Called "Current") or can be set 
to store and display clips in a specified "permanent" directory. This should be a Subdirectory
of the current directory. The particular "permanent" directory and its SubDirectories 
associated with a program, (or file extension) is specified in Clpsrch.ini, along with the 
window title associated with a program. 
Clipstep will detect the presence of the Active Window Title, and reset all parameters as 
specified in Clpsrch.ini, which for instance will control the name of the "permanent" directory, 
and whether this will be the default rather than "current". The usual default "permanent" 
directory is \Perm unless modified by Clpsrch.ini.

Neither Clipstep, nor Clipseek will operate properly if Clpsrch.ini is incorrectly
configured.

Clpsrch.ini

Various keys can be manually set in the program preset groups:
PrgPreset,WinTitle,perm,perm_Nom,pastequit,clipshow,recrs,VwrPane,DirSortList,TrackKeyPhrase
StrtShowAll,DirLstExc,DirExtInc,DirExtExc,AutprogDirkey,progrunkey,PrgExtB,PrgExecB,
scanAltPath,scanPath,ScanADDPath.

Clpsrch.ini may look like the following:
----------------------------------------------------------------------------------
[Settings]
Remvd=
SC_A=
SC_S=
SC_D=
SC_F=
clpblock=0
scanPath=A_StartMenu|A_StartMenuCommon
dirExplorer=G:\V\Q\FreeCMDR\FreeCommander.exe
StrtShowAll=1
DirSortList=2
TblFsize=0
pastequit=2
TrackKeyPhrase=ON
AutProgDirKey=CurrentFileDir
pn_widthADJ=0
pn_heightADJ=0

[clipSettings]
readclip=10
TrackKeyPhrase=ON
perm=0
perm_Nom=\Perm
pastequit=1
PrgPreset=EditPad
clipshow=1
recrs=0
VwrPane=0
ALLPresetPrg=0_Default,PSPad,ahk,EditPad,AOL,Microsoft Word,Paint,freeComm,Windir,Unassigned
scanPath=C:\My Documents
ActiveTitle=Open File

[0_Default]
PrgPreset=0_Default
readclip=1
StrtShowAll=1
DirSortList=2
clipshow=1
VwrPane=0
perm=0
perm_Nom=\Perm
pastequit=1
recrs=1
scanPath=A_StartMenu|A_StartMenuCommon
PrevKeyPhrase=

[ahk]
PrgPreset=ahk
WinTitle=.ahk]
perm=perm
perm_Nom=\Permahk
pastequit=1
clipshow=1
recrs=1
VwrPane=0
AutprogDirkey=CurrentFileDir
scanAltPath=G:\V\M\AutHotky\Extras\Editors\Syntax
scanPath=G:\00PROG\DON1-W98\EWINDOWS\AUTOHOTKEY\Compiled

[EditPad]
PrgPreset=EditPad
WinTitle=EditPad Pro
perm=0
perm_Nom=\Perm
pastequit=1
clipshow=1
recrs=0
StrtShowAll=1
TrackKeyPhrase=ON
AutprogDirkey=CurrentFileDir
scanPath=A_MyDocuments

[AOL]
PrgPreset=AOL
WinTitle=AOL
perm=0
perm_Nom=\PermIntnt
pastequit=1
clipshow=1
recrs=0
scanPath=C:\My Documents|A_MyDocuments

[Microsoft Word]
PrgPreset=Microsoft Word
WinTitle=Microsoft Word
perm=perm
perm_Nom=\PermWord
pastequit=1
clipshow=1
recrs=0
DirLstExc=0
DirExtInc=0
DirExtExc=0
VwrPane=1
progrunkey=^o
scanPath=G:\DD\DDW

[Paint]
PrgPreset=Paint
WinTitle=Jasc Paint Shop
perm=0
perm_Nom=\Perm
pastequit=1
clipshow=1
VwrPane=1
recrs=0
PrgExtB=Tgl_alternatExe,jpg,gif
PrgExecB=G:\T\P\ADPhtshp\Photosle.exe
scanAltPath=G:\SCAN\ADD2
scanPath=G:\SCAN\ADD
ScanADDPath=G:\SCAN\CLIPART

[FreeComm]
PrgPreset=FreeComm
WinTitle=FreeCommander
perm=0
perm_Nom=\Perm
pastequit=1
clipshow=1
recrs=0
StrtShowAll=1
DirSortList=2
TrackKeyPhrase=ON
AutprogDirkey=^!{F2}//^!{F3}
scanPath=G:\Y

[Windir]
PrgPreset=Windir
WinTitle=EditPad Pro
perm=0
perm_Nom=\Perm
pastequit=1
clipshow=1
recrs=0
VwrPane=1
StrtShowAll=1
DirSortList=2
TrackKeyPhrase=ON
DirLstExc=$Nt,..
DirExtInc=exe,dll,msu,com,bat
scanAltPath=A_WinDir\SYSTEM32
scanPath=A_WinDir

...

----------------------------------------------------------------------------------

An example of Clpsrch.ini is included with the program.

It is safer not to alter keys in section "Settings" or "ClipSettings" except for "dirExplorer".
Modify the key "dirExplorer" under the section "Settings" to display the full program path for
the preferred FileManager. 
In this example, the FileManager is an excellent freeware FileManager called FreeCommander:
G:\V\Q\FreeCMDR\FreeCommander.exe (vs. 2007.10a by Marek Jasinski, www.FreeCommander.com

This program permits a shortcut to be defined which causes the selected path
to be copied to the System "Clipboard". Since the example Clpsrch.ini contains the key: 
	"AutprogDirkey=^!{F2}//^!{F3}"
under freeComm section, Clipseek will send the key "{Ctrl}{Alt}F2" to the program automatically
if FreeCommander is Active when clipseek is run. If NO path\Filename is returned on Clipboard,
Clipseek will send "{Ctrl}{Alt}F3" to the program. If keys "{Ctrl}{Alt}F2" and "{Ctrl}{Alt}F3"
are defined in FreeCommander to place the selected File // path on the clipboard, this causes
clipseek to select the same path as that selected in FreeCommander.
The ini file key: "AutprogDirkey" defines the keys Clipseek will send to the program to copy
the current full path and filename to the clipboard. The full path is used by Cipseek as the 
"Scanpath", and the filename will cause the relevant file to be highlighted. 

Do not attempt to Edit clpsrch.ini in an editor while Clipstep is running! 
Clpsrch.ini may be modified by clipstep while editing, and this can corrupt the file.
A corrupted ini file or an ini file with the wrong settings can disrupt clipseek functions.

The Section name, usually a single word, must be a substring contained within the program 
"WinTitle", and be identical to the value of the "PrgPreset" key contained within the section. 
THE SECTION NAME MUST NOT BE A STRING OF CHARACTERS CONTAINED, AS A SUBSET, WITHIN ANOTHER 
SECTION NAME.

A comma separated list of all section names MUST be defined in the key "ALLPresetPrg"
under section "ClipSettings". Under each section, a "WinTitle" key defines a unique 
Window Title to enable ClipSeek (Clipstep) to identify a defined program. Those programs not
included will be classified as "Unassigned". Program parameters for Unassigned can be ammended
on the "Setup" screen. Clipseek identifies programs according to the listing order of the 
comma separated list, but priority is given to programs where "PrgPrmpt"="File Manager:".

A sample clpsrch.ini file is included along with the Clipstep program. Many of the settings
will be incorrect when Clipstep is installed on a new system. However, an easy way to modify
or add to the ini file is provided by clipseek, under the "Setup" Tab.

Expert Settings:

To modify the "Settings" section in the .ini file, switch to "Setup" Tab and HIGHLIGHT
"0_Default". Then press [Control]-[Alt]-[Enter] to reveal "Settings" in the right pane.
Then press [Control]-[Enter] to switch to the right pane, select the item to change and
press [Enter]. Care should be exercised in changing "Settings".

S:	ClipSeek, SetUp TAB: (Manual Update)

First, run the relevant program. To run Clipseek in Directory mode,
Hold [Ctrl] and press "V" AND "X" down so that both V and X keys are down for a short time, 
then release all keys. A little experimentation will reveal the correct technique to use to 
display the clipseek program.

For automatic scanpath selection, select General Tab, wait for list to display, and select 
button7 "File *spec". Select a new source "directory" (for program files). 
For a new undefined program, the "Setup" Tab should then be selected.
This displays a left and right window pane, where the left pane displays an alphabetical list
of program presets, or ClpSrch.ini section names, and the right pane shows all the keys, or 
presets, within that section. It is easy to switch focus between left and right panes with the 
mouse, or [Ctrl]-Up,[Ctrl]-Down, or for Setup only, [Ctrl]-Enter.
In the left-hand pane, select a program previously defined, highlight the section name
(first line) in the RIGHT pane and press [Enter]. 
(Note, for Setup, [Control]-[Enter] switches to the other pane}
Change the name in the Edit bar, ensuring the new section name is enclosed by square brackets
and press [Enter].
To Delete a section, use [] as a new section name, otherwise section name should be a subset
of the characters contained within the Window Title, without illegal characters like "*,[Space],."

If the new section name is correct, make sure the highlight bar is focused on the new name
in the LEFT pane and select the centre button, "Update Program:". The Active Window Title
for the relevant program should be displayed, and after appropriate modification, press [Enter].
If it is only necessary to export presets (Not WINDOW Title) to ini file, select "No" for 
Window Title modification, and "YES" to the next Message window for transfer of presets.

Note that holding down [Control] while pressing button, "Update Program:" causes 
"Install Setup" to be run, allowing all alterable program presets to be modified.


Edit Panel:

To add a new key, select a key from the right pane and press [Enter], then delete key and value
in Edit panel and type new "Key=Value" and press [Enter]. 

To alter "scanPath" or "scanAltPath", switch to right pane and move cursor to relevant key, and
press [Enter] which places key in the "Edit" panel. It can then be modified by typing new value,
or press [Ctrl]-[Enter] to select a drive and a directory from a Browse window.
Note that automatic substitution occurs for the following scanPath key-shortforms:
		 	"All Users\Start Menu" to "A_StartMenuCommon"
			"\Start Menu" to "A_StartMenu"
	  		"\My Documents" to "A_MyDocuments"
			":\Program Files" to "A_ProgramFiles"
			":\WINDOWS" to "A_WinDir"
			"\All Users\Desktop" to "A_DesktopCommon"
			"\Desktop" to "A_Desktop"

It is possible to add or modify a key from left or right panel by pressing [Space] to switch
to Edit Panel, and pressing [Down] key which reveals a Combo-Box of available keys to 
select using [Up]/[Down] and [Enter] keys. If [PageDown] is pressed after [Down] arrow is 
pressed, the selection moves down to the SCAN options, which also list the above scanPath-
key-shortforms. After either "Scanpath","ScanAltpath", or "ScanADDpath" are selected, pressing
[Down] key allows path shortforms to be added to line, including the "=" and also the pipe "|"
if more than one path is included. Note that if "Scanpath","ScanAltpath", or "ScanADDpath" 
exists on the Edit field, pressing [Control]-[Enter] will display a "Browse" window in order
to add a selected directory. See below.
i.e.
If keys within existing section name need to be included or amended, this can also be achieved
(once the correct preset is highlighted in the left pane) by pressing [Space] to focus on the 
Edit panel, and click the mouse on the comboBox "Down" key OR PRESS "DOWN" ARROW KEY, and 
mouseclick on an Entry on the ComboBox, or use [Up]/[Down] keys to highlight an Entry and press
[Enter]. 
Note that for scanpath,scanAltPath,ScanADDPath entries, a further mouseclick on the
ComboBox  "Down" key (or press "Down" key, then "PgDown" key) will reveal shortforms, eg:
A_StartMenu,A_StartMenuCommon,A_MyDocuments,A_ProgramFiles,A_WinDir,A_Desktop,A_DesktopCommon. 
Pressing [Enter] on these will add to the earlier selection of scanpath=,ScanADDPath=, or 
ScanAltPath=, (or use [Up]/[Down] keys to highlight an Entry and press [Enter]). 
Further selections by this means would also add a Pipe character "|" automatically, if more than one
scanpath entry is used. 

Alternatively, if the Editpanel contains scanpath,ScanAltPath, or ScanADDPath, pressing 
[Ctrl]-[Enter] will call a file Selection browsing window to manually add a selected path.

For automatic scanpath selection in clipseek, it is also possible to include up to two paths
(LFN or SFN) on the ClipSeek command line.

An option for Editors to have the scanpath read from the Active Window-title (Editor) is 
provided for named program preset with the key "AutprogDirkey=CurrentFileDir".
Extraction of other paths from ActiveWindow "Title" AND/OR "Text" is also attempted 
(for scanADDpath).

Note: if "AutprogDirkey=CurrentFileDir" key exists under Settings, extraction of "scanpath"
and/or "scanADDpath" is attempted for an Active Program Window which is not included in the 
clpsrch.ini Program-Presets. This can slow initial loading of clipseek, and rarely some 
programs misread this as a keypress "c".

Other keys can be amended using the Setup panel. A brief list below shows some of the keys
which can be preset.

Preset Selection:

The Setup screen Left pane allows a new PROGRAM preset to be selected:
To select a program preset, Select program preset from left pane and press [Enter].
If ClipSeek/ClipStep is launched while a Pre-set program is running, Clipstep and Clipseek
will automatically select the appropriate presets for that program. It is also possible to run
ClipSeek with the program preselect (ini Section name) on the command line, and it MUST be
contained within square brackets, [...].


Clpsrch.ini:
----------------------------------------------------------------------------------
[Settings]
clpblock=0		If set to "1" ONLY CLIPSEEK DIR mode operates, ie no clipstep clip functions
StrtShowAll:- 		If =0, requires initial Search string in Edit panel before List created
scanPath=A_StartMenu|A_StartMenuCommon          ; Default scanpath
dirExplorer=G:\V\Q\FreeCMDR\FreeCommander.exe	; Full path to FileManager
DirSortList=2           File/Directory sort (=0,1,2,3)
TblFsize=0		General fontsize for FileList (=0 or 1)
pastequit=2		Pastequit setting for Viewer pane in clipseek Dir Mode
TrackKeyPhrase=ON		Combo Box can save & recall previous Preselections in Dir mode
AutProgDirKey=CurrentFileDir 	Attempt to extract scanpath from Active program Window (Title or Text)
Keys		Previous ClipSearch settings and ClipSearch search strings
File_ListPrv=		Automatically programmed from Directory-List file window (File Mgr Button)
Editor_Prv=New Editor	Automatically programmed from Directory-List file window (File Mgr Button)
pn_widthADJ=0	Initial Window width
pn_heightADJ=0	Initial Window height

Optional extra keys:
In order to have additional programs run dirctly from the Taskbar icon:
SC_A			Path to a Link file to run program SC. A: {Right-click Taskbar icon)
SC_S			Path to a Link file to run program SC. S: {Right-click Taskbar icon)
SC_D			Path to a Link file to run program SC. D: {Right-click Taskbar icon)
SC_F			Path to a Link file to run program SC. F: {Right-click Taskbar icon)

[clipSettings]
...			Set by Program

;Program Settings:-
[Program...]
PrgPreset:- 		Name, usually a single word contained within WinTitle
WinTitle:-  		for unique identification of program "WinTitle"
perm:-      		clipstep: Initial selection of current-(0)or Perm-(1)directory
perm_Nom:-  	For clipstep: \Perm directory name for program
pastequit:- 		For clipstep: Copy/Clipboard mode select when Enter pressed
clipshow:-  		Display file contents or bare filenames
recrs:-	    		Select initial recurse mode - "1"=ON
VwrPane:-   		Display file contents in right Window pane
DirLstExc:-		preselect program search criteria: Exclude path/filename substring list,(comma sep.)
DirExtInc:-		preselect program search criteria: Include filename Extension substring list,(comma sep.)
DirExtExc:-		preselect program search criteria: Exclude filename Extension substring,(comma sep.)
PrevKeyPhrase:-	preselect program search criteria: Previous Edit panel Search text 
PrgExtB:-		Comma delimited string of file extensions to RUN PrgExecB(on Enter)
;				if Tgl_alternatExe contained in string, requires preseting
PrgExecB:-		RUN PrgExecB(on Enter) for comma delimited string of file extensions`,PrgExtB
progrunkey:-		"//" delimited string of keys (ahk) which when sent to EXISTING application 
				will open selected file
AutprogDirkey:-	String of keys (AutoHotKey) which, when sent to EXISTING application will store 
				defaultdir (and  filename) to clipboard to set ClipSeek "Scanpath". 
				Useful for Filemanager etc. "//" provides a 200msec delay.
				if AutprogDirkey=CurrentFileDir, scanpath set to directory of file in ActiveWindow Title
				    Extraction of other paths from ActiveWindow "Text" is attempted (for scanADDpath)
scanpath,ScanADDPath,scanAltPath:-
			Can use A_StartMenu,A_StartMenuCommon,A_MyDocuments,A_ProgramFiles,
			A_WinDir,A_Desktop,A_DesktopCommon; DO NOT INCLUDE "%" SYMBOLS
ScanADDPath	Additional path (Directories & subdirs only) added to scanpath List display
			(Press [Enter] on these entries for display of Subdirs. and files.)
			If "Sort 1st S/dir", ScanADDPath entries added to end of list

----------------------------------------------------------------------------------

G:	General List (General Tab):

ClipStep Mode: (CLipseek)

The General Tab shows the normal clipseek screen, which can be a single ListView Box (or the 
Left pane if the viewer is on), showing existing clips, (Clip filename on the left) and contents.
Also, the first level of Subdirectories are displayed at the top of the List of Clip files.
These can be "Topics" containing related clips. Pressing [Enter] on a Subdirectory of the selected
clip directory, will switch to the selected directory, and at the top of the List will be the
original directory (within quotes "") for quick return to the original directory, and the 1st.
level Subdirectories now present. From within a selected subdirectory, press the CopyMove
Button to copy or move clips from other directories. (See scanpath Button below).

The highlight bar will initially select the last used clip. If a number is typed, the highlight
bar will select the clip file corresponding to the number typed, if it exists.

Viewer Pane Select:

If Viewer pane is not preselected in the ini file, Right-click and select View - Toggle, which
modifies the Default ini setting, or, with any clip focused in the left pane press [Ctrl]-Up or 
[Ctrl]-Down. When Viewer pane is displayed, [Ctrl]-Up or [Ctrl]-Down in either pane switches focus 
to the other pane. In the Viewer pane, it is possible to Block many lines by holding the [Shift]
key and pressing [down]/[Up]. Pressing Enter will Paste selected lines, or copy/ADD selected
lines to "Clipboard". See below for details.

Using Button3, "Set Copy", the following list of options will appear:

		Paste&Exit|Paste-ReSel|clipboard|clipADD|Paste ClipBd|Exit

The first is "Paste&Exit" which will paste the item into the Active Window when "Enter" pressed.
If [Enter] is pressed in the left pane, the entire clip is Pasted or copied/Added to "Clipboard"
Note that if [Control]-[Enter] is pressed, clipseek returns after pasting. Option "Paste-ReSel"
is the default of the "Set Copy" Button and sets clipseek to automatically return after the 
clip is pasted. The default setting can be reset for preset programs in the .ini file.
Options "clipboard", and "clipADD" only copies to the "Clipboard". Option "clipADD" adds each
new clip to the existing "Clipboard". To clear the clipboard during a "clipADD", Press "Set Copy" 
Button and select "clipADD" option again ( or any "Set Copy" option).
The clipboard can be Pasted with the "Paste ClipBd" option, or by returning to the Active 
Window (quit clipseek) and pressing [Right-Control]-V.

In addition, if "Paste&Exit" is the default setting, and [Left-Control]-[Enter] is pressed, the 
clip file (Left pane) or the selected text (right pane) is pasted to the underlying window 
and clipseek returns, simulating the "Paste-ReSel" option. 

Furthermore, regardless of the "Set Copy" setting, if [Right-Control]-[Enter] is pressed, the 
clip file (Left pane) or the selected text (right pane) is copied to the Clipboard. Further 
clips/text made using [Right-Control]-[Enter] will be added to the clipboard, simulating the
"clipADD" option.

Selection Panel (clip mode):

An Edit panel is shown at the top of the screen, enabling preselection of clip files in the left pane
based on clip CONTENTS.
If focus is on the left (clips list pane), press [Space] to switch focus to the Edit panel. 
The Selection criteria will restrict display of clips shown to those that include the text 
entered. Type the plus character "+" to add a further selection criteria 
which is used as a Logical "OR" operand. Also, if any previous selections have been used, 
pressing "Cursor-Down" will reveal the Preselection Combo Box. Use Up/Down and Enter to select.
Pressing "PageDown" automatically selects the last Entry, "Nullstring", which clears all 
selection citeria and creates a complete listing.
[Escape] returns focus to the Active pane. 
If focus is on the RIGHT (view content) pane, press [Space] to switch focus to the Edit panel. 
Selection criteria can be entered as above (without combo-Box facility) and when [Enter] is 
pressed, the first occurence of the selection text is focused and appears highlighted. 
If [Space] is pressed again to switch to Selection panel and [Down] arrow is pressed, the original 
Selection text will be entered in the edit panel. If Enter is pressed without modifying the text,
the NEXT occurence will be highlighted in the Viewer pane. this can be repeated to locate every
occurence in displayed contents. If the [Up] arrow is pressed from the Edit Selection panel,
a new search starts from the TOP. By this means, it is possible to copy (and Paste) selected
sections of text from within any clip. 
Note, whenever a letter/number is typed while the viewer is active, the first line starting
with the typed character will be highlighted, if it exists.

(The "FILE*Addr" button (7) will also preselect to include only Address clips, or Filename 
clips. As with Button 3, when Button 7 is pressed, a DDL list of options is displayed. 
Press Up/Down arrow keys to select, or PageDown/End to close the list).



----------------------------------------------------------------------------------
:Buttons in Clip Mode:

RUNFile/ Button:

If clip contains a Filename, this file is run. This may require file-association to 
determine the application to run the file. Otherwise, the file Manager is opened for 
the path contained in the clip.

If no filepath contained in the clip, The File Mgr Gui is run.

Set Copy Button:

If a row is highlighted in the left pane (List of clips) and [Enter] is pressed, or Select 
button clicked, the outcome depends on the setting of the "Set Copy" button.
This can be changed by clicking the mouse on the "Set Copy" button, and pressing "Up"/"Down"
arrow keys (not too quickly) and pressing Enter. Pressing "PgUp"/"PgDn" causes instant selection
of the first or last entry.

	Paste&Exit:
	
	The "Paste&Exit", causes clipseek to paste the selected clip and exit.

	Paste-Resel:
	
	If [Ctrl]-Enter is pressed while a clip is highlighted, the clip is pasted and clipseek 
	remains	Active for further clips to be selected and pasted. 
	If "Paste-Resel" is selected, this will be the outcome when [Enter] is pressed on a 
	highlighted clip.

	Clipboard:
	
	This setting will simply place the clip on the clipboard.

	ClipADD:
	
	This setting will ADD the clip to the clipboard.

	Paste ClipBd:
	
	By clicking on Paste ClipBd, the current contents of the clipboard are pasted.
	This can also be achieved by right-click on the Clipstep Taskbar icon, and selecting
	Paste ClipBd. Alternatively, press Right-Control-v.

Note: Pressing "PageDown" automatically selects the last Entry, "Exit"

Sw.Perm Button:

Toggle-Switch ClipSeek scanpath between the "current" (Non-Perm) directory and the 
ini-Program preset Clip Directory, and the currently Selected Directory (if different)
Such scanpath changes resulting from this button alter "clipsettings" so "Clipstep" follows
the scanpath changes.
Note that altering the ini-program preset for scanpath to a different directory will cause
the displayed list of Clips to include the original ini-set path to be displayed in "" quote
marks at the top of the display. Pressing [Enter] on this, or any SubDirectory at the top
of the Clip List will reopen that dirstory as a new scanpath, but such List-selections
will not alter "Clipstep" settings, and Clipstep will not follow the Selection.


Delete Clip Button:

Deletes highlighted clip ("Delete button"), OR "Del_ALL" for deletion of either:
	ALL clips, including "Ordered" and "Comment" clips,  OR
	ALL clips, EXCLUDING "Ordered" and "Comment" clips,  OR
	ALL clips, EXCLUDING "Ordered" and "Comment" clips, stored during previous month

ScanSourceDir Button:

Rescan to compile a list of clips, with the option of resetting all button presets

FILE*Addr Button:

Use "Up"/"Down" arrow keys to select from options below:

	Directory:			Select new clip directory
	ONLY Files:			Show ONLY clips which contain only a filename
	ONLY Address:		Show ONLY clips which contain only an address (email)
	No PreSel-^:			Cancel preselects and Re-Scan. Automatically selected if [Ctrl] key is down
	Re-ScanSource:		Rescan to compile a list of clips, no option to reset all presets
	Exit:				Exit

Note: Pressing "PageDown" automatically selects the last Entry, "Exit"


DefPerm Button:

Select ScanPath from existing clip directories. This method of changing scanpath to one of
the "Perm" subdirectories, or back 1 level alters "clipsettings" so that clipstep follows
the selected directory. It is also possible to ADD, Rename, or Delete subdirectories with 
this button, making adjustment to the ini file as necessary.

Note that altering the ini-program preset for scanpath to a different directory will cause
the displayed list of Clips to include the original ini-set path to be displayed in "" quote
marks at the top of the display. Pressing [Enter] on this, or any SubDirectory at the top
of the Clip List will reopen that dirstory as a new scanpath, but such List-selections
will not alter "Clipstep" settings, and Clipstep will not follow the Selection.

CopyPerm Button:

Copy current clip to selected "Perm" dorectory. Use "DefPerm" to switch current directory
and FILE*Addr;Directory to alter designated "Perm" directory

S.C.-Desktop Button:

If clip starts with a Filename or path, place a shortcut on the Desktop

Exit Button:

Quit application

----------------------------------------------------------------------------------
Start:ShowAll Checkbox:
If UNChecked`, the display of matching entries is delayed until after a search criteria 
is entered in the Edit Panel.
In Clip mode, "Default" program settings (StrtShowAll=1) are not altered.

----------------------------------------------------------------------------------

O:	Ordered Clips:

Right-click on any clip and select "ReOrder"
This provides a menu to create a clip comment (or amend or remove a clip comment) and reassign 
priority so the clip is displayed at the top of the clip list, or simply change priority.
All clip comments are displayed in the clip Listing, and the clip file extension is "clip0"
All ordered clips without a comment are simply displayed at the top of the list and have a
clip file extension, "clip1". 

Menu option "Delete clip" offers the option to delete the highlighted clip, (select 
("Delete button")) OR "Del_ALL" for deletion of either:
	ALL clips, INCLUDING "Ordered" and "Comment" clips,  OR
	ALL clips, EXCLUDING "Ordered" and "Comment" clips,  OR
	ALL clips, EXCLUDING "Ordered" and "Comment" clips, stored during previous month


Forms:

One important feature of (ordered) Comment clips (with the extension: .clip0) is that if the
"Comment" given to the clip (which has the extension .clip0.C) contains the word "form", the
"PasteClip" function treats "Tab" as a control character. So, if the clip contains a string
of "Form" fields separated by "Tabs", pasting the clip using Clipstep OR Clipseek will place 
entries into the different fields of a form. In this way, a comment clip can automatically
fill out the fields of a form, providing the form's control-fields conform to the normal 
standard. To create the comment clip, write the field entries in for instance, a text file,
using a "Tab" to separate the fields, and perform a [Ctrl]-c copy.


V:	Viewer Pane:  (clip Mode)

Viewer pane can be activated (if absent) from the Right-click menu, or by pressing [Ctrl]-Up 
or [Ctrl]-Down.
[Ctrl]-Up or [Ctrl]-Down will switch focus between the clipList and the Viewer pane.
Within the viewer pane in "Clipstep" mode, pressing Enter will paste or copy the entire clip. 
To copy a single line, Right-click on a highlighted line within the viewer pane and select 
"Selected item to clipboard" to copy individual lines to the clipboard.

The Viewer pane can also display a number of graphics and icons when an appropriate file is
selected. Version info is shown for File extensions:  exe,msu,dll,drv,fon,ttf,vxd,sys,cpl,ocx.
In "Clip" mode, a clip containing a graphics filename will also display the image.

In Viewer pane, pressing an alphanumeric key, A-Z,1-0, will find the next line starting with
the letter (or number) pressed.

When Viewer pane is displayed, [Ctrl]-Up or [Ctrl]-Down in either pane switches focus 
to the other pane. In the Viewer pane, it is possible to Block many lines by holding the [Shift]
key and pressing [down]/[Up]. Pressing Enter will Paste selected lines, or copy/ADD selected
lines to "Clipboard", See Using "Copy Set"Button3 above.

Furthermore, regardless of the "Set Copy" setting, if [Right-Control]-c is pressed while focused
on the Right pane (Viewer) in clip mode, the selected text (right pane) is copied to the 
Clipboard. Further clips/text made using [Right-Control]-c will be added to the 
System clipboard, simulating the "clipADD" option.
If [Right-Control]-x is pressed after a line or a block of text is selected in the Viewer pane,
the selected text will be cut from the clip, and selected content added to the System clipboard.
If [Right-Control]-v is pressed after a line or a block of text is selected in the Viewer pane,
the content of the System clipboard will be inserted into the clip file just above the highlighted
or text selected in the viewer pane. By this means, text can be added to clip files or
transferred between clip files. 
The Viewer will display up to a maximum size for clip files of 82,120 Bytes.
(Note: Insertion point for Paste/Cut functions may not be accurately determined if only one line
is highlighted and a number of adjacent lines within clip are identical)

[Right-Ctrl]-c: 	Right-Pane: Copy selected text to clipboard (ADDED to clipboard on reuse).
[Right-Ctrl]-x: 	Right-Pane: Cut  selected text to clipboard (ADDED to clipboard on reuse).
[Right-Ctrl]-v: 	Right-Pane: Paste clipboard to clip at Selected position.

Text files and clip files will be be displayed (with wrapping) in the Viewer pane. In addition,
a number of other formats will display in the Viewer:

:TEXT Translation (Viewer):


MSWORD Documents:
The algorithm to allow text extraction of MS Word binary files was written for MS Word 2000, 
and may fail to operate correctly on untried versions of MS Word document files.

Excel (.xls) Documents:
Translation of xls files (to csv format) uses VBscript to call EXCEL.
The conversion process in EXCEL is slow and this delays the Viewer pane display.
If EXCEL is not installed, this function will not operate.

:Supplementary programs:

HTML files:
To convert HTML files to text, this version of ClipSeek allows the use of an external program:
	HTMLAsText v1.10
	Copyright (c) 2004 - 2009 Nir Sofer
	Web Site: http://www.nirsoft.net

HTMLAsText is an excellent program for Converting HTML files as a console tool, and if the 
appropriate configuration file "HTMLConv.ini" (as supplied in Clipstep.zip) is present in 
the Clipstep\!filscrpt directory, along with HtmlAsText.exe, ClipSeek will use this program 
to view HTML files.

Most forms of RTF file will also have contents listed.

This program also detects presence of 7za.EXE in \!filscrpt directory, and uses it to reveal
the contents of zip,7z,GZIP,BZIP2,TAR files
Also, if the file "README.TXT" or "FILE_ID.DIZ" exists in zip,7z,GZIP,BZIP2,TAR files,
an excerpt (2000 chars) of the contents are displayed in the Viewer pane before zip contents list

7za.EXE is the Command line version 4.57 of 7-Zip 
-------------------------------------------------
7-Zip Copyright (C) 1999-2007 Igor Pavlov.

7-Zip is a file archiver with high compression ratio.
7za.exe is a standalone command line version of 7-Zip.

Features of 7za.exe: 
  - High compression ratio in new 7z format
  - Supported formats:
      - Packing / unpacking: 7z, ZIP, GZIP, BZIP2 and TAR 
      - Unpacking only: Z
  - Highest compression ratio for ZIP and GZIP formats.
  - Fast compression and decompression
  - Strong AES-256 encryption in 7z and ZIP formats.

7za.exe is a free software distributed under the GNU LGPL + BSD LICENSE for AES part.

Source code of 7za.exe and 7-Zip can be found at http://www.7-zip.org/
7za.exe can work in Windows 95/98/ME/NT/2000/XP/2003/Vista.
-------------------------------------------------

This program also detects presence of WZUNZIP.EXE in \!filscrpt directory, and uses it to 
reveal the contents of ARJ,LZH,GZ,ACE,UUE,BZ2,JAR,ISO files.
	WinZip(R) Command Line Support Add-On Version 1.0 (build 3181)
	Copyright (C) 1991-2000 WinZip Computing, Inc.
	All Rights Reserved
    This WinZip Add-on requires WinZip 8.0 

This program also detects presence of RAR.exe in \!filscrpt directory, and uses it to reveal 
the contents of RAR files.
RAR.exe is part of WinRAR archiver 3.20, Copyrights(c) 1993-2003 Eugene Roshal
-------------------------------------------------

For PDF and CHM files, this program also detects presence of "Text Mining Tool" which is a 
freeware program for extraction of text from files of the type: pdf, doc, rtf, chm, html 
without need to have installed any other programs like Word, Arcrobat, etc. 
This program can be obtained from: text-mining-tool.com
If the included console tool, minetext.exe, exists in the \filscrpt directory, clipseek
will use the program to display text in the Viewer pane. However, since the program extracts 
text from the entire file, it can take too long, and is only used for the viewer pane.

----------------------------------------------------------------------------------
Special Keys: Clipstep:

Control multiple clipboards using only the keyboard's Ctrl-X-C-V. 

Select some text, press Ctrl-C a couple of times to copy it to multiple new clipboards.
Hold down [Ctrl] and press V repeatedly to step through the clipstep clips, or
C steps backwards. When you've got the clipstep clip you want, release Ctrl to paste. 
To delete a clip file, hold down [Ctrl], press V followed by X twice to delete, three times
to delete all, or once to cancel. Release [Ctrl] to accept.

Note: 

      [Ctrl] is held, and after "V" is pressed for SHOWCLIPS:
      [Ctrl]-Alt-V:  Toggle Current / Permanent dir: .\Perm, OR
      [Ctrl]-Alt-C:  COPY current clip TO: Permanent dir., OR
      [Ctrl]-V-C:    run the ClipSeek Clip program
      [Ctrl]-V-X:    run the ClipSeek Directory Search program

      [RightCtrl]-V, -C, or -X:  Normal Paste,Copy,Cut (ClipBoard) (when Ctrl key lifted)
      [LeftCtrl]-[RightAlt]-C:   Toggle Clip functions (clpBlock).If ON: restores normal function to keys: Ctrl-V,Ctrl-C,Ctrl-X
      [AltGr]-C:			Toggle Clip functions (clpBlock).If ON: restores normal function to keys: Ctrl-V,Ctrl-C,Ctrl-X

The default state for clipstep when run is determined by "clpBlock" key in clpsrch.ini
under section "settings". This remains unaltered by the above keys.
----------------------------------------------------------------------------------
----------------------------------------------------------------------------------

Special Keys: Clipseek

Keys ALL Modes:


F1 key 		will switch to the "Info" Tab.
F10 key 		is used as a general Exit or Quit key.
[Ctrl]-Up or 
	[Ctrl]-Dn 	will switch between Left and Right Panes.
[Ctrl]-PgUp or 
	[Ctrl]-PgDn 	will switch between Left and Right Panes.

Enter			Select
Space Bar		Switch focus to Selection Panel (Edit Panel in Setup)
Escape		if focus on Selection Panel, clear and switch to Listview or Table
Down arrow		if focus on Selection Panel, Open Combo-Box
PageDown		if focus on Combo Box, Select last entry (General) or 
				scanpath options in Setup.


Clip Mode Keys:

[Ctrl]-c: 		Left-pane:  Copy clip contents to Clipboard.
(not clpBlock)  	Right-Pane: Copy selected text to clipboard and create clip file in "Current" clip dir.
[Right-Ctrl]-c: 	Right-Pane: Copy selected text to clipboard (ADDED to clipboard on reuse).
[Right-Ctrl]-x: 	Right-Pane: Cut  selected text to clipboard (ADDED to clipboard on reuse).
[Right-Ctrl]-v: 	Right-Pane: Paste clipboard to clip at Selected position.

[Ctrl]-[Alt]-c:		COPY clip to selected "PERM" directory
[Ctrl]-[Alt]-v:		Toggle current/Perm directory
[Ctrl]-[Alt]-x:		Delete ALL clips, or Delete all unordered clips
[Enter]:		Paste selected clip (dependant on "Set Copy" -"PasteQuit" settings
[Ctrl]-[Enter]:		Paste selected clip and return to clipseek
[Right-Ctrl]-[Enter]:		Left pane:	Copy/Add selected clip to the System clipboard
						(This can be Pasted using [Right-Ctrl]-v, or right-click clipstep icon)
[Right-Ctrl]-[Enter]:		Right pane:	Copy/Add selected lines to the System clipboard
						(This can be Pasted using [Right-Ctrl]-v, or right-click clipstep icon)
						
Dir Mode Keys:

[Ctrl]-c: 		Left-pane:  Copy path\filename to clipboard and ADD to clipboard on reuse.
(Not clpBlock)  	Right-Pane: Copy selected text to clipboard and create clip file in "Current" clip dir.
[Right-Ctrl]-c: 	Right-Pane: Copy selected text to clipboard (ADDED to clipboard on reuse).


[Enter]:		Left-pane:  (Filename:) Run selected file (uses File-associations)
[Enter]:		Left-pane:  (Directory) Switch scanpath to highlighted directory
[Ctrl]-[Enter]:		Left-pane:  (Filename:) Run selected file and return to clipseek
[Enter]:		Left-pane:  ("Directory" - Prev)(top line) Switch to original scanpath
[Ctrl]-[Enter]:		Left-pane:  ("Directory" - Prev)(top line) Switch to highlighted directory


[Enter]:		Right-pane:  Paste lines into Active program and return to clipseek
[Ctrl]-[Enter]:		Right-pane:  Paste lines into Active program and return to clipseek
[Right-Ctrl]-[Enter]:	Right-pane:  Copy/Add selected lines (Right pane) to the System clipboard
						(This can be Pasted using [Right-Ctrl]-v, or right-click clipstep icon)

----------------------------------------------------------------------------------

Right-Click Menu: ("clip" mode):

View	 				- Toggle, Toggle On/Off for Viewer pane (General Tab)
Clear Previous Preselections, 	- clear all presets
; separator line.
ReOrder        			- Alter clip priority (to display at top) and/or Add or modify comment
; separator line.
Selected item to CLIPBOARD, 	- Transfer clip content to clipboard
Copy or Move clip			- Copy or Move selected clip to another directory
Delete clip				- Delete selected clip
; separator line.
Exit, ClearSelected			- Quit

----------------------------------------------------------------------------------
Note:
A brief help tooltip is displayed when Buttons are right-clicked. To obtain a tooltip
for the DDL multiple option buttons, first right-click on the appropriate button, and
then click on the button to reveal options.
----------------------------------------------------------------------------------
ClipSeek "Dir" Mode:


When 'Clipseek' is run, if no active program causes "Scanpath" to be preset, the "Setup"
window appears. If this occurs, choose a program preset from the left pane and press [Enter]
The "0_Default" at the top of the alphabetically sorted list of program presets should
set the "Scanpath" to "A_StartMenu" & "A_StarMenuCommon". See above for Scanpath options.

Note:	If under ini "settings", the key "AutProgDirKey=CurrentFileDir" exists, Clipseek will
attempt to extract a scanpath (and scanADDpath) from the Active program window Title (and Text).

The General Tab shows the normal clipseek screen, which can be a single ListBox or the Left
pane if the viewer is on, which lists the files present on the "Scanpath". Filenames appear at
the left, and "Contents" or "File Description" to the right. 
Note that contents displayed in the left pane when "File Content" reveal is "ON" will be shown
in three columns with a maximum length of 260 characters (ListView is limited to 260 character 
display).
If a filename is selected, and [Enter] is pressed, the file will be "RUN". If [Enter] is 
pressed with a directory selected, clipseek path (scanpath) will switch to the selected 
directory, If a non-program file is selected, the file-extension association will determine 
which program is run. Note that while focused on the Left pane, any [Control] button held down 
while [Enter] is pressed causes the selected file to be "RUN", and Clipseek to then return.
Also, the first level of Subdirectories are displayed at the top of the fileList (If DirSortList=2).
Pressing [Enter] on a Subdirectory of the selected path, will switch to the selected 
directory, and the original path will be shown at the top of the List within quotes "" for 
quick return to the original "scanpath". If [Control]-[Enter] is pressed on the top quoted 
path, ONLY the selected Directory will be selected, the original scanpath is not restored.
Also, if there are paths specified under "scanADDpath" in the ini file (with pipe "|" separator)
or detected from the Active program Window, (if AutProgDirKey=CurrentFileDir key exists), 
the paths will be shown at the bottom of the display. The "scanADDpath" entries are not 
recursed into or revealed until selected and [Enter] is pressed. The "scanADDpath" entries are 
shown in the path prompt with a "+" sign preceeding each path entry. The "scanADDpath" entries 
are also shown if "scanAltpath" is selected (if it exists) instead of "scanpath", using the 
"Scanpath" Button (4).

List/Viewer selection "Dir" Mode:

If "File Content" reveal is "ON", and Veiwer pane is "ON", the viewer pane displays 
contents/description on the right pane.
(This can be preset in the clpSrch.ini file or toggled using the "File Content" button.
If Viewer pane is not preselected in the ini file, Right-click and select View - Toggle,
or, with any row focused, press [Ctrl]-Up or [Ctrl]-Down.)

(If Viewer pane is not preselected in the ini file, Right-click and select View - Toggle, which
modifies the Default ini setting, or, with any file focused in the left pane press [Ctrl]-Up or 
[Ctrl]-Down.) When Viewer pane is displayed, [Ctrl]-Up or [Ctrl]-Down in either pane switches 
focus to the other pane. 

Viewer (contents) pane:

In the Viewer pane, it is possible to Block many lines by holding the [Shift]key and pressing 
[down]/[Up]. Pressing Enter will Paste selected lines, or copy/ADD selected lines to 
"Clipboard". Using [Control]-Button3, "View/Set", the following list of options appear:

		Paste&Exit|Paste-ReSel|clipboard|clipADD|Paste ClipBd|Exit

The first is "Paste&Exit" which will paste the item into the Active Window when "Enter" pressed.
Note that if [Control]-[Enter] is pressed, clipseek returns after pasting. Option "Paste-ReSel"
is the "Set Copy" default and sets clipseek to automatically return after the clip is pasted.
The default setting can be reset for preset programs in the .ini file.
Options "clipboard", and "clipADD" only copies to the "Clipboard". Option "clipADD" adds each
new clip to the existing "Clipboard". To clear the clipboard during a "clipADD", use "Set Copy"
([Control]-Button3) and select "clipADD" option again ( or any "Set Copy" option).
The clipboard can be Pasted with the "Paste ClipBd" option, or by returning to the Active 
Window (quit clipseek) and pressing [Right-Control]-V.

In addition, if "Paste&Exit" is the default setting, and [Left-Control]-[Enter] is pressed, the
the selected text (right pane) is pasted to the underlying window and clipseek returns, 
simulating the "Paste-ReSel" option. 

Furthermore, regardless of the "Set Copy" setting, if [Right-Control]-[Enter] is pressed, the 
the selected text (right pane) is copied to the Clipboard. Further clips/text made using 
[Right-Control]-[Enter] will be added to the clipboard, simulating the "clipADD" option.
It is also possible for selected viewer text to be stored as separate clip files by pressing
[Control]-c, if clpBlock setting is OFF, (see below).

The Viewer pane can also display a number of graphics and icons when an appropriate file is
selected. Version info is shown for File extensions:  exe,msu,dll,drv,fon,ttf,vxd,sys,cpl,ocx.

In Viewer pane, pressing an alphanumeric key, A-Z,1-0, will find the next line starting with
the letter (or number) pressed

Selection Panel (Dir mode):

An EditPanel is shown at the top of the screen, enabling preselection based on Filename or 
Filename & file-CONTENTS or just selection on filecontents.

If focus is on the left ListView, press [Space] to switch focus to the Edit panel. [Escape] returns
focus to the ListView. The Search criteria will restrict files listed to those that include 
the text entered. Type the plus character "+" to add a further selection criteria which
is used as a Logical "OR" operand. Words (separated by a space) in the Selection panel must all
be present (Logical "AND"). If [Down] arrow is pressed from the Edit Selection panel,, a Combo-
Box will open which records previous selections for selection using [Up/Down/Enter] keys
These are stored between sessions for each program preset in the ini file.

If focus is on the RIGHT (view contents) pane, press [Space] to switch focus to the Edit panel.
Selection criteria can be entered as above (without combo-Box facility) and when [Enter] is 
pressed, the first occurence of the selection text is focused and appears highlighted in Viewer. 
If [Space] is pressed again to switch to Selection panel and [Down] arrow is pressed, the original 
Selection text will be entered in the edit panel. If Enter is pressed without modifying the text,
the NEXT occurence will be highlighted in the Viewer pane. this can be repeated to locate every
occurence in displayed contents. If the [Up] arrow is pressed from the Edit Selection panel,
a new search starts from the TOP. By this means, it is possible to copy (and Paste) selected
sections of text from within any clip. 
Note, whenever a letter/number is typed while the viewer is active, the first line starting
with the typed character will be highlighted, if it exists.


(The "File *Spec" button (7) will also alter selection to include or exclude 
Filenames/extensions or paths.)

If, for instance, MS Word is CORRECTLY entered into the .ini file, and ClipSeek is run from the
Dektop (MS WORD not running), select Microsoft Word from the "Setup" preselects and press 
[Enter]. Assuming the appropriate scanpath for Word .DOCument files is correctly entered in the 
ini file (scanpath key), ClipSeek will switch to the Listbox on the General Tab and show 
Word Document files, with up to 800 bytes of the contents for each Word file, (if "File Content"
is enabled). If the Viewer pane is on, a larger block of text is displayed in the right pane for 
the highlighted file in the left pane.
Search criteria can be entered in the top Edit panel to display only those files which contain 
the search text. From the Listbox, press [Space] to focus on the Edit panel, [Escape] or [Enter]
to return.
If the cursor is moved to one of the displayed files and [Enter] is pressed, MS Word will run 
with the appropriate file. 
([Control]-[Enter] will allow return to clipseek for further file selection).

If [Enter] is pressed on a Directory name, the scanpath will switch to the highlighted directory.
When the scanpath is switched to a subdirectory, the original parent directory will be shown
(with Quote marks) at the top(/end) of the listing, and pressing [Ctrl]-[Enter] on THIS will 
return to the original scanpath.
Note that pressing [Enter] on any Directory will cause scanpath to switch to selected directory.

----------------------------------------------------------------------------------

S:	Selection Filter:

	From main List, press spacebar (do not click mouse on Selection panel) to enter selection 
	criteria. If words separated by spaces are entered, each word MUST be present for inclusion
	in List.
	To "OR" separate criteria, use the plus character "+"
	Searches work on Filename, or if "contents" is on, on filename AND contents ("Dir" mode)
	In clipstep mode, only contents are searched for inclusion.
	From the Selection prompt, press {Escape} to return to main list, or press [Enter] on
	empty selection string.

Selection in "Dir" mode:

If FileContent is ON (Button 9), the selection criteria will apply to Filenames AND 
FILE CONTENTS displayed (approx first 780 bytes) if [Space] is pressed while Left pane Active.
If "Content" is ON, by appending " ]]" or " [[" to selection criteria in the editpanel, 
the search will apply only to Filename " ]]", OR FileContent " [[".
If a program Preset setting is applied by Clipseek, (Clipseek detects the Active window running
when Clipseek is run, or through presetting on the command line or selecting from Setup Tab)
the last 20 Selection criteria are stored in the ini file under the program preset section name.
Rerunning Clipseek with the same program preset recalls previous Selection criteria which can
then be accessed from the Combo Box associated with the Edit Panel, activated by the "Down" key).

So, if [Space] is pressed from the main List, Focus is transfered to the Selection Filter.
If [Enter] is pressed in an empty line, focus returns to Listview.
If "Down arrow" is pressed, the ComboBox with previous selection strings is displayed, and 
pressing Up/Down arrow will select an entry into the Selection panel.
Press [Enter] again to use the selection to filter List display, or press [Escape] to cancel.

Note: Pressing "PageDown" automatically selects the last Entry, "Nullstring", to clear any
active selection. 
For "Dir" mode, "TrackKeyPhrase=ON" in clpsrch.ini section under [Settings] or [program],
Combo-Box can save & recall previous Preselections between clipseek sessions, when program
presets are used.

----------------------------------------------------------------------------------
:Buttons in Dir Mode:


Select Button:

RUN selected File. If Control is held down`, clipseek returns for further file selection


File Mgr Button:

A menu appears which allows either:

File Mgr Button: File Manager (preconfigured in Clipseek Setup) opens on selected "file" path.

OR:

List Files Button:

It is sometimes useful to maintain a text file listing containing filenames present in a 
directory (eg for a directory of installable program files). Clipseek allows the creation
of such a File-List from within Clipseek display, and using "List Files" button, clipseek
will also automatically locate the filename selected on the Clipseek display within the 
nominated File-List in oder to read/add to notes contained within the File-List

If a pre-set directory listing file (e.g. !Dirlst.txt) is present in the same directory, 
the nominated Editor is called and preloaded with the List File;
(and the selected filename can be automatically searched for within the list).
When menu first appears, pressing Up/Down cycles through any pre-configured File-Lists
Pressing "Enter" at this stage calls the selected File-List.

The "Browse.." button enables selection of a List-file on another drive/directory and the new 
list-file will become the default for this session, and recalled for future sessions in the
DropDownList. To clear and reset recalled List-files (from previous sessions), select a file
already contained in the DropDownList.

The "Editor" pane allows selection of a program to run the selected List-File. To program 
a new editor, (click the down arrow and) select "New Editor" in the DropDownList. 

The CheckBox "Editor:" selects between opening the List-File with the nominated editor, 
or using File-associations to run the List-File directly.
(Note: If "EditPad Pro" is used, the program is pre-configured to use "{Ctrl}r" followed by
"{Ctrl}f" to search for filename in File-List).

New List Button allows the creation of a new File-List containing the filenames displayed 
by Clipseek (with pre-selection filters and Search criteria) in the Clipseek display directory.
Preselection is available to determine whether filenames include "Path\", and the name (and
directory) of the stored file-List. The default path\filename is "!Dirlist.txt" in the current
display directory.

The "Retain on ClipBoard" checkBox determines whether the filename selected in Clipseek
remains on the clipboard (for searches and additions, etc).

The "Name Search" checkBox is normally clicked, to automatically locate filename in the 
File-List.

Note:

If a .lnk file is selected in main display list the "File Mgr" Button shows the menu which
will include, at the bottom, a group of four further buttons: 

	File Mgr:		Opens the nominated File Manager with the Link file target directory.

	CLPSK Path: 	causes Clipseek to switch to the Link file target directory

	Note:			"CLPSK Path" button changes Clipseek scanpath to the Link file target 
					directory, and the original scanpath is shown at the top of the display 
					list in ""quotes; Double click on this to return to the original scanpath.

	List Files: 		Find Link Target file in File-List

	Help: 			Help message

View/Set Button:

Select from the following:
	TglContentView:		Toggles the Viewer pane. (Shortcut: ALT-T,T)
	SortDir off:			No Directory Sort
	Sort 1st S/Dir:		Sort 1st. level Subdirectories to top of List
	Sort ALL s/Dir:		Sort ALL Subdirectories to top of List
	AlternateB Run:		Toggle between main Scanpath and .ini preset-Alternate Scanpath
	Exit:				Exit (Press PageDown or End key to clear)

Note: Pressing "PageDown" automatically selects the last Entry, "Exit"

If [Control] is held down while "View/Set" Button is clicked twice, 
on release of [Control] following options appear (for Viewer):

	Paste&Exit:			"Paste&Exit", causes clipseek to paste the selected Viewer clip and exit.
	Paste-Resel:			the clip is pasted and clipseek remains	Active for further clips to be selected and pasted. 
	Clipboard:			This setting will simply place the clip on the clipboard.
	ClipADD:			This setting will ADD the clip to the clipboard.
	Paste ClipBd:			the current contents of the clipboard are pasted.

Note: Pressing "PageDown" automatically selects the last Entry, "Exit"


ScanPath Button:

Toggle between main normal Scanpath and .ini presets for ScanAltpath

Note:  If .ini key "ScanADDpath" set, a link (Dir entry) is included at end of display table
as set by "scanADDpath" key for both Scanpath and "ScanAltpath" listing. 
If this is double-clicked, Clipseek scanpath changes to scanADDpath, with the original 
scanpath shown at the top of the display list in ""quotes; 
Double-click on this to return to the original scanpath.

Right-click on "Scanpath" button to see current settings for Scanpath, ScanAltPath,
and ScanADDpath.


ReadSel? Button:

Listing toggles between exclude-"FileType" entries which are not expanded, 
(Button label becomes "ReadSel1")
and include - (Button label becomes "ReadSel0". eg .dll included in list


ScanSourceDir Button:

Re-Scan Source files, with option to reset Button presets and "Fileseek" search criteria.


File *Spec Button:

	Directory:			Permits Selection of new scanpath directory (Original displayed at top of listing)
	.Ext-Incl:			Enter comma delimited file-extensions to be included
	.Ext-Excl:			Enter comma delimited file-extensions to be excluded
	Path-Excl:			Enter comma delimited Paths to be excluded
	ActiveWinSEL:		Extract scanpath & scanADDpath from ACTIVE window "Title" and "Text" if available
						 Automatically selected if [Ctrl] key is down
	Exit:				Exit (Press PageDown or End key to clear)

Note: Pressing "PageDown" automatically selects the last Entry, "Exit"

Recurse(0/1) Button:

Toggle between Recurse mode. Button shows "0" or "1" for Recurse mode "Off" or "On"


File Content Button:

Toggle between display of Filenames ONLY, or Filenames & content/desription


S.C.-Desktop Button:

If selection contains a valid Filepath, creates a shortcut to Desktop


Exit Button:

Quit application

----------------------------------------------------------------------------------
Start:ShowAll Checkbox:
If UNChecked`, the display of matching entries is delayed until after search criteria 
is entered in the Edit Panel.
In Dir mode, the "Default" program settings (StrtShowAll) are changed accordingly.

----------------------------------------------------------------------------------

Right-Click Menu: ("Dir" mode):

	View - Toggle:		Activate Viewer pane AND amend ini Preset default
	Clear Previous Preselections
					Clear PreSelection Combo Box history
; 	separator line.
	SelectItemDir:		Switch scanpath to the filepath of the selected item (filename)
	alternateB RUN:		Toggle between main Scanpath and .ini preset-Alternate Scanpath
	Send Fname to CLIPBd:
					Copy highlighted filename to Clipboard
	Store as Text file/OR (Dir):
					Convert selected file (doc,html etc) to .Txt and save
					Text file produced includes word-wrap. For speed, filesize is capped.
					(For xls, each sheet converted to .csv file)
					If Directory highlighted, creates a Directory List from table and save.
	Store Dirlist as Text file:
					Create a Directory List from displayed files (Dirs) and save.
					Option is provided to exclude path. Text file is word-wrapped.
	Tgl Sorted Directory:
				     	Toggle between sorted & unsorted file listing
	Rename Sel:			Rename selected file
	Delete Sel:			Delete selected file
	Properties:			Only impl. in v.2 for exe,msu,dll,drv,fon,ttf,vxd,sys,cpl,ocx
; 	separator line.
	Set ViewerLimit:		Switch between Limited text extract modes for speed/accuracy
	Exit:				Quit R.C.Menu

----------------------------------------------------------------------------------

Special Keys: Clipseek
[Ctrl]-c: 	Copy path/filename to clipboard

----------------------------------------------------------------------------------


O:	ClipSearch OPERATION:


Right-click Taskbar icon and select "ClipSearch" or Double=click the taskbar icon
Enter a single unquoted string to search within stored clips, using A-Z,1-9, BUT NO COMMAS.
To change the Search-keys, choose ClipSearch in the tray menu.
The clips matching the Search criteria are copied to the (S) subdirectory.
If search successful, Clips are shown in [CTRLdown] mode, ie. program simulates Control-Down,
(so pressing keys "V" and "C" down together (no [Ctrl]) launches clipseek for (S) Subdirectory)
As soon as the [Ctrl] key is pressed, normal mode is re-established.

To view full selection after Search, Press Alt-Ctrl-V
or select "ClipSearch", and press "Cancel".
On "Copy" (^C) or "Paste" (^V), full selection is restored.
"ClipSearch" operates on both normal and Perm. selection.

----------------------------------------------------------------------------------
Clipstep Menu:

Right-Click Taskbar clipstep icon to reveal following Menu:

If ClipBlock is OFF:

&About...:		General information
Clipsearch info:  	Special Search Input box (allows selective copying of Clips)
Clipstep &Help:	HELP File (calls editor if .TXT associated in Registry with editor)

ClipSearch...:	ClipSearch (Default). Special Search Input box (allows selective copying of Clips)
ClipSelect...:		Runs clipseek, Clip mode
ClipSeek Dir:		Runs clipseek, Dir  mode

Paste ClipBd:	Paste existing contents of clipboard
clipBlock ON:	Limits clipstep to Clipseek Dir mode. No clip functions (Toggles ON/OFF)
					and restores normal function to keys: Ctrl-V, Ctrl-C, Ctrl-X
Pause-Tgl..:	Suspends all Hotkeys
Exit:			EXIT clipstep

(Default means Double-click on icon runs this entry)

If ClipBlock is ON:

Clipstep &Help:	HELP File (calls editor if .TXT associated in Registry with editor)

ClipSeek Dir:	Runs clipseek, Dir mode (Default: Double-click icon runs this entry)

Paste ClipBd:	Paste existing contents of clipboard
clipBlock OFF:	Restore clipstep clip functions (Toggles ON/OFF), restore clipstep clip fn.
Pause-Tgl..:	Suspends all Hotkeys
Exit:			EXIT clipstep

Optional extra keys:
In order to have additional programs run dirctly from the Taskbar icon:
SC_A			Path to a Link file to run program SC. A: {Right-click Taskbar icon)
SC_S			Path to a Link file to run program SC. S: {Right-click Taskbar icon)
SC_D			Path to a Link file to run program SC. D: {Right-click Taskbar icon)
SC_F			Path to a Link file to run program SC. F: {Right-click Taskbar icon)
SC. Define		ADD or replace a  TRAY MENU Shortcut for:  A or S or D or F
----------------------------------------------------------------------------------

Program faults:

The ClipStep and ClipSeek programs have only been tested for screen resolution of:
 800 X 600, 1024 X 768, 1152 X 864, 1280 X 768, 1280 X 960
and may need modification for different resolutions, OR ASPECT ratios other than 3/4.
The ClipStep and ClipSeek programs have only been tested on MS WINDOWS XP (Home) and Vista.
	
If Program errors occur, especially on Setup Tab, carefully check "clpsrch.ini" for errors;
These might include duplicated keys within sections, or blank lines or repetitions.
Note that the key "ALLPresetPrg" in the ClipSettings section of clpsrch.ini MUST provide
a comma delimited list of ALL section names. Clipseek should create this key automatically.

The sourcecode .ahk file may include some characters which were inserted for editor 
coloring/folding purposes in Editpad Pro. These do not interfere with program function and 
most editors should cope.
----------------------------------------------------------------------------------

ClipSeek parameters (args):
    -scan  Force a directory scan to retrieve the latest directory listing
			of StartMenu & StartMenuCommon 	- OBSOLETE
    -scex  Scan & exit  - OBSOLETE
		   (this was useful for scheduling the potentially time-consuming 
			directory-scanning of StartMenu & StartMenuCommon as
           a background job
    -help  Show this help also: /h,-h,/?,-?,

    -clstep,--clstep,/c,-c:  Only used by clipstep to run clipseek

    %1%    FileAprm: To preselect directory directly from the command line 
    %2%    FileBprm: To preselect directory directly from the command line 

    [xyz]    Clpsrch.ini section preselect

----------------------------------------------------------------------------------
This brief help file mentions some of the features of Clipstep and ClipSeek.
----------------------------------------------------------------------------------

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
DISCLAIMER OF WARRANTY

THIS SOFTWARE IS DISTRIBUTED "AS IS" AND WITHOUT
WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY OR ANY
OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE
OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS 
FOR A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING
PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED
WITH NON-CRITICAL DATA AND SYSTEMS BEFORE RELYING ON IT.  
THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

	*****************************************************************
;--
Original SEEK program:

 Program : Seek
 Coder   :   Phi
 Updated : Mon Jan 31 10:08:37 2005

	*****************************************************************

ClipSeek (Coder, TWmailrec) is a development of Seek.ahk (Coder, Phi) which now shows 
contents (or descriptions) of files to enable rapid selection. The intention was to 
provide a means of rapidly finding a particular MS Word 2000 Document. New algorithms (ahk)
to perform a similar function for other filetypes (e.g PDF or CHM etc.) have not yet 
been developed but could be incorporated into the program in the future. Currently, external
programs mentioned above perform this function.

Clipseek now incorporates "GetFullVersionInfo" Coder: wOxxOm
; -----------------------------------
;  wOxxOm  (From www.AutoHotkey.com)
;  Posted: Sun Mar 12, 2006 5:06 pm    Post subject: [::script::GetFullVersionInfo] string version info for execs 
;  hot demonstration to fetch full string version information from executable files
; -----------------------------------
;  This script gets full version information for CompanyName/FileDescription/etc. string 
;  version info from executable. Because AHK doesn't include such a capability I took an 
;  example in VBA and recoded it in AHK
; -----------------------------------
	*****************************************************************

