                           String List Editor for BRed 1.0
			                 Written by Cyril VELTER
								  V1.0 07/12/96
			
1. Introduction

StringList Editor for BRed 1.0 is a BRed add-on that make it easy to
edit StrL ressource. a StrL resource is a list of string. each string
in the list is limited to 65535 chars but the total number of string
is not limited. however, since extraction is sequencial too much strings
will slow down extraction process.


2. How to Use it

2.1 Installation

To install StringList Editor for BRed 1.0, drag the add-on (StrL)
into BRed "Plugins" folder.


2.2 Editing StringList

Simply create or open a 'StrL' resource in BRed main window. A new
window is opened with 6 controls :
	- 4 buttons (new, remove, up and down)
	- Text control
	- String List
	
2.2.1 Create a string

Enter your text in the text control and click the new button

2.2.2 Remove a string

Select the string you want ti remove in the list and click the remove button

2.2.3 control ordering of strings

you can change strings order by using up and down button on list items

2.3 Using Strings

By including StrL resource in an application file, you can use a string 
with this kind of code :

	// Load resource into memory

	long size;
	char* Buffer;
	Buffer=File.FindResource('StrL',id,&size);

	// Extract string at index idx
	
	GetIdxString(Buffer,size,idx);

	(File is a valid resource file)

Check out the file ExtractString.cpp for GetIdxString details  

3 StrL structure

a StrL resource is a concatenation of strings. Each string is coded
in a pseudo pascal form (two bytes for length and then string datas).
I've choosen pacal strings in order to speed up extraction. And two
byte length to break the 256 chars limit.


4 Note

This program is in the public domain.  However, I disclaim all
responsibility for any damage that may result, directly or indirectly,
through the use of this program.


