================================================================
ABF CD Shell. (Version 1.0)
Copyright (c) 2000-2003 ABF software, Inc. 
All Rights Reserved.
http://www.abf-dev.com/cd-shell.shtml
mailto:cd-shell@abf-dev.com
================================================================


Description
===========

ABF CD Shell is a constructor set for fast creating of different CD, DVD, and other catalogue shells. 


Configuration file
==================

Content and behavior of the shell is configured in one file. The configuration file is a usual *.INI file with the same name as program's EXE. Config contains information about each item of catalogue and associated to the item buttons. Each item and button have own group in the configuration file. 


General settings
================

Program settings are stored in the [Main] section, following values are allowed: 
Name - Name of program is shown in program caption and about dialog 
Icon - File name of icon is shown in caption task bar, and task list 
Version - Version of program (1.0.3.35 for example) 
Author - Author or company name, is shown in about dialog 
Copyright - Copyright text, is shown in about dialog 
Web - URL of web site or page is used in Web Site internal command and in the About dialog 
Email - e-mail address is used in the Send email internal command and in the About dialog 
RegistryKey - Name of key in the registry to save settings ("SOFTWARE/ABF software/ABF CD Shell" by default) 
Groups - List of groups in the side bar (names) 
Items - List of visible items (section names) 
DefaultGroup - Selected group by default (name) 
DefaultItem - Selected item by default (section name) 
Upgrade - Upgrading from the web is enabled if value is not 0 
Maximized - Program window is maximized on the first run if value is not 0 

Example:
=================================================
[Main]
Name=ABF-SOFT.COM CD-ROM (Limited edition)
Version=1.0.0.1
Author=ABF software, Inc.
Copyright=Copyright c 2000-2003 ABF software, Inc.
RegistryKey=SOFTWARE/ABF software/ABF-SOFT.COM CD-ROM
Groups=Programs, Games
Items=ABF OE Backup, ABF CD Shell, SeaBattle
=================================================


Internal commands
=================

You can use following internal commands for any item or button by index: 
Context help 
About dialog 
Web site 
Send email 
Interface options 
Upgrade 


Items
=====

Item is a base grouping element of your catalogue, let say it is an article in usual magazine. Each visible item has own icon in the side bar and menu item in the main menu. Item is visible when its name is present in the [Main].Items list. Every item performs some command or shows an according information when the user clicks on the icon or menu. Item has following properties: 
Group - Name of parent group, must be same as specified in [Main].Groups list. 
Index - Index in the group, node will be added to the end if Index is not specified. 
Type - Type of item: 
Normal, shows according information (default) 
Internal, performs some internal command (Interface options, About, Help manual) 
Command - index of internal command for Type 1 
Icon - File name of icon is shown in the side bar and header. Relative or absolute. 
Caption - Name is shown in sidebar and header 
Hint - Hint of the item in the side bar 
Description - File name of the according information (description), *.HTML or *.TXT. 
Buttons - List of buttons for current item (section names) 

Example:
=================================================
[ABF OE Backup]
Group=Programs
Icon=Programs\abfOutlookExpressBackup\main.ico
Caption=ABF Outlook Express Backup
Hint=Backup and synchronization tool for Outlook Express
Buttons=Install, License, ReadMe, Buy, Register, Help

[SeaBattle]
Group=Games
Caption=SeaBattle
Buttons=Run, License, ReadMe

[SomeHelpItem]
Group=Help
Command=0
=================================================


Buttons
=======

Buttons perform some actions or commands relative to the associated item (buy, order, preview, and so on). Each visible button is shown in the toolbar. Button is visible when its name is present in the [Item].Buttons list. Button has following properties: 
Type - Type of button: 
Normal, runs some file (default) 
Internal, performs some internal command (Interface options, About, Help manual) 
Dropdown commands list, commands are taken from some config section 
Dropdown file list, runs files are matched given mask 
Caption - Button text 
Hint - Hint of button 
Command - file, an index value of internal command, name of command group, or file mask depending on Type 
Format of command section for Type 2 is Caption=Command.

Example:
=================================================
[ABF OE Backup.License]
Type=0
Caption=License
Command=program\ABF Outlook Express Backup\License.txt

[ABF OE Backup.Help]
Type=1
Caption=HelpManual
Command=2

[ABF OE Backup.Install]
Type=2
Caption=Install
Hint=Install application
Command=ABF OE Backup.Install.Commands

[ABF OE Backup.Install.Commands]
EXE file=programs\ABF Outlook Express Backup\abfOutlookExpressBackupInstall.exe
ZIP file=programs\ABF Outlook Express Backup\abfOEB.zip

[ABF OE Backup.Register]
Type=3
Caption=Register
Command=programs\ABF Outlook Express Backup\Keys\*.key
=================================================


Upgrading from the web
======================
The program can upgrade itself from the web. In order to obtain an upgrade, you should be connected to the Internet. The application will check whether the new version is available. If the new version has been found, program will download all of the new files into your computer.


Distribution
============
ABF CD Shell is distributed on the "Try Before You Buy" basis. The evaluation version of this software may be distributed freely through the on-line services, bulletin boards, or other forms of electronic media, as long as the files are distributed in their entirety. Computer Magazines/Archives are authorized to distribute the evaluation version on any Cover Disk or CD-ROM without an individual permission.


Purchasing 
==========
The evaluation version of this software will only work for 30 days. If you like this program and decide to keep it, you need to purchase a registration key. You can purchase it on-line either by credit card, bank transfer or check. Ordering is also available by Phone, FAX, and postal mail. 

  http://www.abf-dev.com/cd-shell.shtml
  http://www.abf-dev.com/buy.shtml 

Purchasing will give you:
* An e-mail with instructions on how to register your copy.
* Removal of all limitations.
* Lifetime technical support.
* Free upgrades from 1.0 up to 1.9.
* And our appreciation, of course :). 


Software development
====================
If you or your company need some custom software development, such as: program, screen saver, presentation, CD shell, or web site, please contact us: 

  support@ABFsoftware.com. 

Or visit our corporative web site:

  http://www.ABFsoftware.com

We can develop any kind of software or web site you want.


History
=======
June 20, 2003. (Version 1.0):
First public release.
 

================================================================
Copyright (c) 2000-2003 ABF software, Inc. 
All Rights Reserved.
================================================================

