(Edit this file after your own preferences to add useful information)


       --------------------------------------------------
	Use this file to add notes for later reference:
	* Add tricks and tips
 	* Make notes on the libraries you make
	* Where to find additional info on LIBs and DLLs
       --------------------------------------------------




                            --- * ---


Installation:
--------------------------------------------------------------------
 Just put all the files in the same directory, and run 
 the EXE-file.


Filelist:
--------------------------------------------------------------------
 1. LibMak32.exe	(the main, and only, EXE-file)
 2. ReadMeHelp.txt	(some background info)
 3. HelpText.txt	(preliminary help text)
 4. Notes.txt		(this file)


Runtime Libraries:
--------------------------------------------------------------------
  1. C4ASCX.DLL - Version 4.000.3 (Clarion 4b)
  2. C4DOSX.DLL - Version 4.000.3 (Clarion 4b)
  3. C4RUNX.DLL - Version 4.000.3 (Clarion 4b)


Tips on testing the program:
--------------------------------------------------------------------
  Basically this version of LibMaker do exactly the same things as
  the original version. None of the functions with respect to making
  LIB-files are changed, and you can keep on using the program as 
  normal.
  In addition this version can do some other things as well. Here are 
  some suggestions on how to test some of these functions:

  (Make sure that the list is in focus when you use the command
  shortcuts below. You may also use the corresponding commands in the
  popup menues).

- Select the "Options" tab then press the key "Default folders..."
- Enter "C:\CLARION4\LIB" (or where you have this path) in the 
  default source folder and press OK.
- In the "Advanced options...": Check the "Show statusbar" and the 
  "Show Extracted functions tab" options and press OK.
- Go to the "Library" tab and press the "Add file..." button and load 
  the file WIN32.LIB. Then use Explorer and drag the file WIN16.LIB 
  onto the program's main window and drop it. Press Alt+C to contract 
  all the folders in the Library list.
  (Do not save this LIB-file. This is just for demonstrating some of 
  this programs functions - other than making a LIB-file).

- Then you can make a comparison to the DLLs on disk. 
  Do the following:
- Select COMCTL32.DLL in the "Library" list and press the F2 key. 
  Check the "Use autolocate" option in the compare dialog. Then press 
  the [#1] key and select the "WINDOWS\SYSTEM"-path (this is what I've
  called the "first priority search path"). Hit the [>] button 
  to "autolocate" the file. This button will turn black if the file
  is found. Finally press "Compare now" to start the compare process.
- In the resulting "Compared list" press Alt+S to toggle between 
  showing only the changed and showing all the functions.

- Now go to the "Extraced functions" tab. Make a query for "SOUND".

- Open the search dialog in the "Library" tab with the Alt+F3 shortcut. 
  Enter "Color Bitmap" and check the "Multiple keywords". Then press 
  the "Find next" button. Now you may press the F3 key to find the 
  next match to either of the two keywords. (The search dialog works 
  for all the lists).

- Open the Statistics dialog with the F4 key and sort the data by
  double-clicking on the listbox headers. Double-clicking once more 
  on the same header to sort descending. (This also works for all the
  lists). Find the "resize bar" between the two listboxes and drag
  it to change their relative sizes. Change the width of the fields
  in the listbox. Resize the window. 
  (By the way, for those who's interested, I've made a Clarion template 
  for the resize bar. This template makes one procedure that handles 
  multiple resize bars in any window - both vertical and horizontal).

- All the changes you make in any dialog window stays where you put 
  them till the next time you open the dialog window. Try closing the
  window and reopen it to see this. (Press Esc and then F4).

- Now go to the "Advanced options" dialog and try out more options 
  and features. Most of them are explained if you press the 
  "Read me..."-button in the "About" tab. 

- If you are interested in the command line parameters. Press the 
  "Help" button and go to the end of the file, or read the text at 
  the end of the "Read me" file. There you will also find information
  about Clarion template automation and the Drag & Drop capabilities
  of Clarion LibMaker 32.
 


Author's notes:
--------------------------------------------------------------------
PENDING:

  Program:
  --------
- Some options in the Compare Procedure dialog not implemented yet.
- Fonts/colors not finished yet.
- Listbox setting not yet implemented.

  Documentation:
  --------------
- Make a proper help-file

  "May be" or just ideas for the next version (if any):
  -----------------------------------------------------
- Toolbar.
- Menubar.
- Printing options.
- Undo most recent delete operations.
- Confirm dialog for delete operations.
- Link into API database, with the possibility to add your own
  modules (DLLs) and Prototypes.
- Make the search procedure work for several (or all) columns in lists.
- More options in the "goto dialog".
- More options for quickmenus.
- Save/retreive a statistics file associated with the library file.
- Increase number of items in library statistics: Disk filenames, 
  disk locations, dates, version info, etc. of the included library 
  source (DLL) files. This data may utilized to update the LIB-file.
- Search for exported functions in DLLs on disk, and/or scan disk 
  for LIB-files.
- Compare whole LIB-files (all the modules) to the corresponding 
  DLL-files on disk.
- Make more entries in the Compare Report (original file dates, 
  locations, etc.) and place it in the popup menu.
- "Merge LIB-files" as a menu item.
- Put in some real system info in the system info dialog.
- Reset to default options as an option.
- Shift+directional keys selects multiple items in a list box.
- Virusscan of source files.
- Several "search paths" for autolocate in the Compare tab.
  (may be entered in the Default folders dialog).
- Create a project file with LIB-file location/name/date/time 
  and DLLs to include (also with location/name/date/time).
  The project file may also include PROTOTYPES for all the 
  preocedures in all DLLs.
  The project file may be called/opened by name - all project
  files should be kept in one location (LIBMAKER/PROJECT/)
  The project file may be used to:
	i)  Regenerate LIB-file automatically
	ii) Produce an INC-file with prototypes
- Instance control.
- An option for placing the "read-only" attribute on created 
  LIB-files, to prevent accidental overwriting.
- An entry to specify an extension for the file to be "autosearched" 
  in the compare dialog.



Known bugs (or "malfunctions"):
--------------------------------------------------------------------
- Shift+Space - when held down it will skip some rows which are not
  marked as they should.
- Cannot open multiple files (selecting several files in the file open
  dialog) where the filename or path contains space.
- Cannot open multiple files in the filedialog when the "Use LFN in 
  add dialogs" are set. This may be a bug in Clarion4, or it may be 
  related to some incorrect settings in my Windows setup. I have not 
  put up any serious effort to try to solve this matter. It works fine
  when the LFN are turned off.
- The LOCATOR function does not work for the "Compared modules" list.
  (I haven't figured out this yet - the relevant code is allmost 
  identical to the "Extracted functions" list, where this works 
  fine - so it's still a mystery to me).


Tips & Tricks:
--------------------------------------------------------------------
Use Notepad and open the "Clarion4.ini" file which you will 
find in the CLARION4/BIN-directory.

Locate the section:
  [User Applications]

Add the following line:
  LibMaker=c:\Libmaker\LibMak32.exe (or where you have put it).

Then locate:
  [User Menus]

Add this:
  1=&Utilities/&Libmaker|LibMaker

Save the file.

Now you can open Clarion LibMaker from a new menu item in Clarion.



                            --- * ---



