Dana Features
Dana Text Editor

"Dana"is multi-featured text editor for Windows95 or NT4.0.

Dana helps you to process many and huge text files with great ease of use.

It's fast!You can open a mega file at a moment.You can scroll text like water flows.

It's got a lot of features,but no needless bells and whistles.Everything you will need is at your fingertip!

Features:

-Multiple files edit up to 100.

-Unlimited Undo and Redo.(You can limit buffer sizeif you want)

-Useful bookmark feature.You can add visible bookmarks as many as you want and list them up.

-Clipboard history.

-Unique auto formatting function.You will get nicely formatted text as if you used word processor.But it's still plain text so that you can send it via e-mail or upload it to BBS.

-Superior text comparing function.No other editor does this better.You ought to try!

-Drag n Drop edit.

-Centered,Left,Right,and Sort.You won't believe this is just a text editor.

-Colored keywordswhich you can associate with particular file types.

-Print and Preview

-Find function supports regular expressions.

-Variable child process interfaces which allow you to use DOS based filtering program as if one of the functions of Dana.

-Customizable key assignments.You can use wordstar like two stroke keys,of course.

-Programmable script language 'Dana Script' allows you to customize your Dana to fit your particular purpose.

-Up to 99 generations backup,auto backup and mirroring which help you not to lose your precious work.


Start me up!

If you haven't set up Dana.Run SETUP.EXE first to install Dana to your program folder.

Create shortcut on your desktop if you like.

Dana doesn't have "uninstall"function.Don't worry.Dana won't copy any file to your Windows system folder.It doesn't even use system registry.So the folder you have installed Dana is her everything on your machine.You can simply delete the folder when you want to dump her.(Oh,I hope not.)

Dana.exe is the program you will use.


Create New Files

The very first file you will see in Dana is an empty text named "Untitled1.txt".You can start writing text here and save with the name you like.You will be able to create a new file with particular file type other than "txt"in "File"menu.

Create New File Using Templates

You will also be able to create new files using templates.Template files are saved as the file name of TML$FileName.Typ.TML$ is fixed.Typ is a particular file type you want to associate with this template.Those template files need to be placed in the folder which Dana.exe is in.

For instance,create a new "Dana Script"file and select "*.das"extension.A popup window will show up so that you can choose either "DanaScript"or "TsrScript".Because those two template files are prepared when you installed Dana.You will find two files;TML$DanaScript.DAS and TML$TsrScript.DAS,in the Dana's home folder.

Open Existing Files

To open existing file,select "Open"command in "File"menu.You can either select or type a file name you would like to open in "Open"dialog which will pop up.

If specified file does not exist,Dana will open it as a new file.

In the "Open"dialog box,you will find a unique feature in a text box.If you have Readme.txt file in the folder,all you need to do is to type three letters;"r","e","a".Dana will find Readme.txt immediately and complement the rest of the file name.

If you have two or more candidates in the folder (e.g.Readme.txt and Readme),you can choose the correct one by using up or down arrow key.

Auto Script

If you have a Dana Script which you want to run when a particular file is opened,put "@S"followed by the script name on the first line of the file.

For example,if you have a file with bookmarks and want to give that file to someone who also uses Dana,you would distribute three files;file.txt,file.txt.#marks#,and MarkList.DAS.Do not forget to place "@SMarkList"on the first line of the text so that they can see the bookmark list immediately when they open the file.(Since MarkList.DAS is initially installed to everyone's computer who uses Dana,you don't need to distribute this script actually.It's just a example.)


Other functions in "Open"dialog

You can use open dialog to inflate and deflate archive(zip and lzh)files.You will need to have installed programs which handle those archives.(Oh,I am sorry.You have to buy Winzip if you use it)The command lines of those programs are configured in "Tools"tab in "Preferences".

You will find the following settings as default:

ZIP

Inflate:\Program Files\Winzip\Winzip32.exe -a %1 @%2

%1 will be translated to the archive file name you will specify.

%2 will be translated to the 'response file' name which contains file names you will archive.

ZIP

Deflate:\Program Files\Winzip\Winzip32.exe %1

%1 will be translated to the archive file name you want to deflate.

%2,if specified,will be translated to the folder name you want to extract files.

I could not find the command line option which specifies target folder for Winzip,so I omit %2 option.


Command Line

File Names

To open a particular file when you run Dana,specify the file name in the command line.You can also open the file and jump to the specified position like this:

Dana /J line:column Filename

.	g.

Dana /J 100:10 Readme.txt (Open Readme text and locate the caret at 100lines:10columns position)

Command Line Options

The following command line options are available

/V	Open a file in "Readonly"mode

/Ttype	Force the file type "type"regardless the actual file extension (e.g./Thtml)

/P	Open a file and show print preview

/G	Run "Find in Files"command on startup

/M	Open another instance of Dana

/Aname	Run Dana Script file saved as "name"(e.g.myscript.das).

/Wname	Open project file saved as "name"(e.g.myfiles.prj).Project files are to be used for saving and restoring the current workspace.You can create project files in "Tool">"Save Project As"command.

/Jline:column	Jump to line:column after open a file (column can be omitted)


Initial Settings

You don't really have to configure anything to run Dana.It runs happily right after the installation without any modifications.

However,since each user has different computer,you will need to configure some folder settings to make backup functions work well.

The backup folder is configured in File Saveproperty.You will see "TMP"as "backup folder"and "Environment Variable"option is checked as default.That means backup files will be created in the folder you have set to "TMP"environment variable in AUTOEXEC.BAT file.

SET TMP=C:\temp

I hate this because it is too old fashioned.You don't have to use this default setting.You can specify your temporary folder name you usually use and uncheck the "Environment Variable"option.

To configure not to have any backup,specify 0(zero)for "Generations",although I don't recommend it.

You can configure "Mirroring Folder",as well.

Mirroring means that the file you will save will be doubled,so even if one file is corrupted (it happens especially on FAT file system),another file is still alive.I recommend to specify the folder on another HDD drive,if you are lucky to have it,to minimize risk.

Do not specify the same folder as the backup folder for mirroring.

Associate with Windows file types

As I told before,Dana doesn't modify any system registry settings.I regret to say that it means you will need some work if you want to associate particular file types with Dana.

Have no fear.It's quite easy,I guess...

For example,if you want Dana to open instead of Notepad by double-clicking a ".txt"file,do the following procedure:

1)Open Explorer and select "Options"in "View"menu

2)Choose "File Types"tab

3)Choose "Text documents"in the list and double-click it

4)Double-click "open"in the "Actions"list

5)Specify the full command line of Dana

6)Do not forget to add "%1"after the path name (e.g.C:\Program Files\RIMArts\Dana\Dana.exe "%1")

7)OK,OK,OK

Beware that you will need to reconfigure this setting when you decide to dump Dana.(Oh,again,I hope not)


Main Menu of Dana

Most of functions of Dana are accessible from the main menu.

File

Edit

Search

Tool

Window

Help


New
File menu

New

Create a new file.

c.f.Create New Files

Open

Open existing files in "Open"dialog.

c.f.Open Existing Files

Open by Another Dana

Run another instance of Dana and open files.You will be able to open another MDI session without destroying the current workspace.

Favorite Folders

Choose one of your favorite folders and open files.

ReOpen

Discard changes and open the current file again.Use this function when you need a fresh start.:-)

Close

Close the current file.

Save and Close

Close the current file.The file is saved if it is modified.

Save

Save the current file

Save As

Save the current file specifying a new name.

Save All

Save all the modified file.

Print

Print the current file.

Print Preview

Show the print preview image of the current file.

Recently Used Folders

Open one of ten recently used folder.

Recently Used 100 files

Open one of a hundred recently used file.

Save Workspace and Exit

Save all the work files and the workspace and exit the program.

This workspace is recovered when you restart Dana,so you can back to work immediately.

Save All and Exit

Save all the work files and exit the program.

Exit

Exit the program.

Dana will prompt if you have modified files.


Undo
Edit menu

Undo

Undo the previous edit in the current work file.

You can specify a limit of undo buffer size in "Tool"->"Preferences"->"Values"->"Undo Buffer Size Limit".

Redo

Redo the edit operation previously undone.

Repeat

Repeat the previous edit operation.

Step Undo and Redo

Undo and Redo by specified steps.

For example,characters input is undone one by one usually.You can specify number of characters you want to be undone at once.

Cut

Cut the selection and copy to the clipboard.

Copy

Copy the selection to the clipboard.

Append Cut

Cut the selection and append to the clipboard.

Append Copy

Append the selection to the clipboard.

Paste

Paste text in the clipboard at the caret position.

Clipboard History

Copy or Paste the text data that has been copied to the clipboard before

Box Select Begin

Begin the box-mode selection.

You can cut or copy the selection by using ordinary Cut,Copy command,although you will need to "Box Paste"command to paste it.

Box Paste

Paste the text data that has been cut or copied as a box.

Select All

Select the entire text.

Convert

Convert the selection:Upper/Lower case,Tab/Space.

Paragraph

Execute following paragraph edit command.

One line must be one *logical*line.(The each line ends with a return code.)

Left	Move the selected lines to the leftside of the window.

Right	Move the selected lines to the rightside of the window.

Centered	Move the selected lines to the center of the window.

Indent	Add one indent level to the selected lines.

UnIndent	Back-indent the selected lines by one level.

Append	Add specified string at the top or end of the selected lines.

Sort	Sorts the selected lines.

Format	Format the selection or one text block which ends with an empty line.

DeFormat	Remove return codes from the selection or one text block which ends with an empty line.

Copy to File

Write the selection to a specified file.

Append to File

Write the selection at the end of a specified file.

Paste from File

Paste a specified file at the caret position.

Insert Mode

Toggle Insert/Overwrite mode.

Auto Formatting Mode

Toggle auto formatting mode.

ReadOnly Mode

Toggle readonly mode of the current file.


Find
Find menu

Find

Search a specified string.

.	f.Find Dialog

Find Next

Find the next candidate.

Find Previous

Find the previous candidate

Replace

Replace the found words to the specified ones.

c.f.Replace Dialog

Find in Files

Find the specified string in files and Paste tag information in the output window of Dana like this:

FILENAME.TXT(10):

FILENAME.TXT(12):

FILENAME.TXT(15):

FILENAME.TXT(20):

.	f Find in Files DialogTag Jump

Retrive tag information from the caret position and open a file.Then move caret to the position the tag information indicates.

Back To Tag File

Activate the window from which the tag information has been retrieved.

Jump To

Move the caret to the specified position.

Previous Position

Move the caret to the position before Jump or Find command.

Top of File

Move the caret to the top of the text.

End of File

Move the caret to the end of the text.

Toggle Bookmark

Toggle bookmark on the current line or the selection.

Mark Caption Lines

Mark lines which begins with a 'Caption Character' which you can specify in "Tool"->"Preferences"->"Keywords"setting.

List Bookmarks

Show the bookmark list so that you can see the outline of the text.

c.f.Use Bookmarks

Clear Bookmarks

Remove all the bookmarks from the entire text or the selection.


Preferences
Tool Menu

Preferences

Change the variable settings in Dana

c.f.Preferences Dialog

Run

Run another application

Program Launcher

Run one of the registered program.

Record Key Sequences

Start/Stop the recording key sequences.

Run Key Sequences

Playback recorded key sequences.0

Save Key Sequences

Save the recorded key sequences as a 'Dana Script' file.

Load Key Sequences

Load the key sequences from the files which is saved as 'Dana Script' (*.das).

Dana Script Library

Register,Execute and Edit 'Dana Scripts'.

If you want to run a script from the menu or the shortcut keys,configure Tool->Preferences->Addin Scripts.16 permanent scripts can be assigned.

26(A-Z)*10 scripts can be registered in this "Library".

Open Project

Open a project file.

Close Project

Close the current project.

Save Project As

Save the current workspace as a project file.

Compare

Compare the current file and the other.

You will see the difference of the both files as bookmarks."Both Rollup/Down"(Alt+Pgup/Pgdn)command would be useful to see the difference.

c.f.Compare Dialog


Preferences Dialog

You can configure Dana in this dialog.

Value

Switches

Save Files

Appearances

Design

Print Layout

ShortCut

Menu

Addin Scripts

Keywords

Tools

Misc.


Cascade
Window menu

Cascade

Cascade all the MDI child windows.

Tile Horizontally

Tile all the MDI child windows.

Tile Two

Tile the current window and reference window.

You can toggle the tiling mode Vert/Horz/No Tile.

New Window

Open a new window which shares the same document with the current window.

Split current window

Split the current window in two.

Arrange Icons

Arrange the minimized MDI child windows.

Next Pane

Move the focus to another pane of the split window.

Switch Window

Switch the current window to another.

Select Edit Window

Select the current window in the list.


Help Contents
Help menu

Contents

Show the contents of help.

About Dana

Show the information about the current version,copyright,and the license.


File Save
About Dana

Show the information about the current version,copyright,and the license.

File Save

Space Conversion

Normal	No conversion

Tab to Space	Convert a HT code(0x09)to multiple space codes(0x20)

Space to Tab	Convert multiple space codes to a HT code

Return Code Conversion

DOS/Windows	EOL is CRLF(0x0d0a)

UNIX	EOL is LF(0x0a)

Macintosh	EOL is CR(0x0d)

Keep Original Return Code

Use the return code of the original file.

Save Bookmarks	Save bookmark information to separate files.

Add ^Z code	Add EOF code(0x1a)to the end of the file.This option is only for the compatibility of old DOS applications.

Remove white spaces at EOL

Remove white spaces at the end of each line.

Backup

Generations	Specify the generations of backup you want to have.

Backup Folder	Specify the backup folder.

Environment Variable	Check this if you specify an environment variable for "Backup Folder"instead of a folder name.

Mirroring	Check if you want to do 'Mirroring'save

Mirroring Folder	Specify the mirroring folder.

Environment Variable	Check this if you specify an environment variable for "Backup Folder"instead of a folder name.

Create Folder if Relative path is Specified

If Relative path (like "Backup\")is specified for the Backup Folder or the Mirroring folder,the new folder will be created if it doesn't exist.

Auto Backup Wait	Specify the interval of auto backup.If you do the auto backup,you will be able to recover the unsaved work file even after the program is abnormally terminated.If you don't want to auto backup,specify 0 for this value.


Find Dialog

Find String	A string you want to search.'\'character is used for the escape character.

From Beginning of Text	Start searching from the top of the current file.

Wrap Around Search	If the string is not found after (or before)the caret position,go to the top(or end)of text to continue searching.

In All Windows	Search in all files currently opened.

Mark Found Line	Set bookmark on a line which includes the matched strings.

Match Whole Word	Match a string whose before and after character is a whitespace or one of the delimiters.

Match Top of Line	Match a string which is at the top of the line.

Ignore Case	Search with no upper/lower case sensitivity.

Regular Expression	Use regular expressionfor the find string.

Mark All	Search in a whole text and mark all the found lines at once.

Save Option	Save this condition as the default setting.


Replace dialog

String to Find	A String you want to find.'\'character is used for the escape character.

String to Replace	A String you want to replace.

From Beginning of Text	Start searching from the top of the current file.

In All Windows	Search in all files currently opened.

Mark Replaced Line	Set bookmark on the line which includes the replaced strings.

Match Whole Word	Match a string whose before and after character is a whitespace or one of the delimiters.

Match Top of Line	Match a string which is at the top of the line.

Ignore Case	Search with no upper/lower case sensitivity.

Regular Expression:	Use regular expressionfor the "String to Find".

Replace All:	Find and Replace in a whole text at once.

Save Option:	Save this condition as the default setting.


Jump To dialog

Line No	Specify the line number you want to jump.

Physical/Logical	Specifiy the line number mode."Logical"means that the line number is the same as the count of return codes.


Mark Listing dialog

List up all the bookmarked lines in the current file.Sometimes you will see "+"mark at the left at the icon,which means following indented marked lines are hidden.You can see those folded lines by double clicking the icon.

You can also use <<or >>button to open or close folded lines.

c.f.Use Bookmarks


Clipboard History dialog

When you select an item in the list,this data is shown in the text box below.

Paste	Copy the selected data to the clipboard and paste into the caret position.

Copy	Copy the selected data to the clipboard.


Replace?dialog

Yes	Do replace.

No	Do not replace and search next.

Replace All	Replace all the found strings right away.

Cancel	Cancel replacing.


ShortCut property page

You can configure the following parameters in "ShortCuts"property page.

Functions	You can see all the command names of Dana in this list.And you can select a function whose key assign should be changed.

Key Assignment	The currently assigned short cut keys for the selected function.Use "Delete"button to delete.

Key To Add	You can specify a key stroke here.Set input focus on this text box and hit *actual*key stroke.The particular key strokes:Tab,CR and ESC,which cannot be input directly,can be input by clicking the button below the text box.

You can assign this key stroke to a function by clicking "Add"button.Note that up to 2 shortcut keys can be assigned for one function.

Two Stroke:	You can specify the prefixes of the "two stroke"key assignment from A to Z.Two stroke key is not popular for Windows applications.But if you are get used to use the DOS text editor which has "Word Star"like key assignment or you are an EMACS nuts and can't live without C-x C-*key strokes,you can use this weird (for Windows user <g>)key stroke.For example,"K"means that Ctrl+K is used as the prefix of the two stroke keys.

Load	Load key settings which as saved as *.key file.The loaded key definition will be used after that.

Save	Save current key settings as a *.key file.


Switches property page

You can configure the following parameters in "Switch"property page.

Use Shiftkey to Select Text

You can use the shift +cursor key to select string.If not,you can assign the shift +cursor key to a particular function you like.

Drag And Drop	You can use Drag and Drop operation to edit text.

C language Mode	The indent level of "}"corresponding "{"is automatically adjusted.And when you input a return code after the character "{"or ":",the top of the next line is automatically indented.This option only work for C program source.

Remove Spcs of Empty Lines by Enter

Remove whitespaces of empty line if you hit enter key on the line.

Fix Caret at Middle of Screen

When you use find or jump command,locate the caret at the middle of the screen.

Select Found Word	Select a word which is found.If you always want to specify the end of the selection using find command,do not check this option.

Permit Caret After EOL

When the caret is moved up/down and caret is located at the after the end of the line,let the caret stay at the same column position.It doesn't mean Free Caret Mode because even if the caret is seen after the EOL,the logical position of the caret is at the EOL.

Free Caret:	You can move the caret at any position you like,even after the EOL,and input characters exactly there.

Padding by Tab:	When you input a character after the EOL,from the EOL to the caret position is normally filled by whitespaces(0x20).If this option is checked,it is filled by tab(0x09)codes instead.

Clear Undo Buffer When Saved

When you save a text,the undo buffer is cleared.

Initial New Window is Maximized

When Dana is started,the initial "Untitled"window is maximized in the MDI frame.

Restore Caret Position

Restore the caret position when the file you have opened previously is opened.

Save Window Position on Exit

The next time Dana is started,the size and the position of the application window is restored as the last time Dana exit.

Fix Window Position

If checked,Dana always starts up at the same position and size.To save the current position and size as the default,click "Save Current"button.


Values property page

You can configure the following parameters in "Values"property page.

For Each File Type

File Type	Select the target file type you want to configure.

Extension	Specify the extension for the selected file type.

Comment	A brief description about the selected file type.

Tab Columns	Specify the number of tab columns.

Columns	Specify the maximum columns.

Auto Indent:	Set auto indent mode for the selected file type.

Soft Tab:	When tab key is pressed,whitespaces are input instead of a tab code.

Inhibit Auto Format

Check if you do not want "Auto Formatting"mode to work on this file type.Auto Formatting mode is convenient if you are writing something,but it annoys if you are editing text data or program sources.

No Word Wrap

Check if you do not want this type of text 'wrapped'.

Common

Auto Format Column

Specify the column position you want Dana to format text.

Undo Buffer Size Limit

To save memory consumption,you can give a limit on the size of the undo buffer.


Design property page

You can configure the following parameters in "Design"property page.

Font

Screen/Print	Select the target which you want to change the font.

Font Name	Select the font name from the combo box below.

Size	Specify the font size.If TrueType font is selected,you can specify the font size inputting a value in the text box directly.

Color

Object	Select the target you want to change the color.

Color	Select the color you want to assign.

Custom	You can choose the special color for each target.


Find in Files dialog

String to Find	A string you want to find.

File Type	Specify the mask pattern of files in which you want to find a string.

Folder	Select the current folder by selecting in the list box or typing in the text box.

Match Whole Word	Match a string whose before and after character is a whitespace or one of the delimiters.

Match Top of Line	Match a string which is at the top of the line.

Ignore Case	Search with no upper/lower case sensitivity.

Regular Expression	Use regular expressionfor searching.

Search Sub Folders	The file in sub folders can be a target for searching.

Output Full Path	Output results with full path names.


Appearances property page

You can configure the following parameters in "Appearances"property page.

Line Number	Display line number at the left of the edit window.

Logical/Physical	Set the line number mode.

Function Keys	Display the function keys at the bottom of the main window.

By 4/By 5:	The way of displaying function keys.You should select "By 4"if you are using a standard PC keyboard.Some weird looking 'ergonomic'keyboard has function keys by 5.;-)

Ruler	Display a ruler at the top of the client window.

Tab	Display tab characters to be recognizable.

CRLF	Display return characters to be recognizable.

End of File	Display a end of the file to be recognizable.

Vertical Scroll	Display a vertical scroll bar.

Horz Scroll	Display a horizontal scroll bar.

Line Pointer	Display a line pointer leftside of the client window.

Box Caret	Display a DOS like box type caret.

Under Line	Display an under line at the focused line.

Edit Mark	Display edit marks at each editted line.

Status bar	Display a status bar at the bottom of the main window.

Line Spacing	Specify the pixels of extra spaces between lines.

Tool Bar	Select the target tool bar you want to configure in the combo box.You can select one of five and specify if it can be seen or not.You can see buttons of each tool bar in the list box.Click them to make each button of the toolbar appear or disapper.

Large Button	Make all the buttons of the toolbars little bigger.

Reset Position	Locate all the tool bars at the default position.


Keywords property page

You can configure the following parameters in "Keywords"property page.

Group	Select the keywords group from 0 to F (16 group).

Color	Specify the color for the selected keywords group.

Colored	Make keywords show up in a specified color.

Bold	Make keywords show up in a bold font.

File Types	Specify file extensions for the selected keywords group.

Add	Add new keyword.

Delete	Delete selected keyword.

Keyword to Add	Input a string to add.

Case Insensitive	Recognize keywords case insensitively.

Caption Character	Specify caption characters which are used by the title marking command.

Delimiters	Specify delimiter characters.These are referred by many functions:moving caret by word,matching whole word in find command and so on.

Comment Blocks	Define comment blocks.


Comment Blocks dialog

Beginning String	Specify the beginning of the comment block.Comment block must begin with a non-alphanumerical character

End String	Specify the end of the comment block.If you leave it blank,the end of line is assumed as the end of the comment

Color	Specify the color of the comment block

Keywords in Block	Indicate how keywords should be shown in the comment block.

Add	Add above definition to the end of the list

Replace	Replace with the definition you are currently selecting in the list

Delete	Delete the definition in the list


Select Window dialog

Select the window to edit.

If you select "Open File ",you can open a new file here.

The blue icon which is seen at the left of the item represents the current file(focused window),gray icon means the reference file(previously focused window).These two window is tiled when you call the "Tile Two Windows"command.


Stop Undo/Redo dialog
Step Undo/Redo dialog

Steps	Specify the number of steps you want to undo or redo.

Undo	undo by the specified steps.

Redo	redo by the specified steps.


Run dialog

Command Line	Input the command line you want to run.

Minimized	Run program with minimized window.

Get Console Output	Get the console output into the editor.You also can specify that output text will be inserted into the "Output"screen or the caret position of the current edit window.

via Command Shell	Execute via the command shell of your operating system.Usually it should be COMMAND.COM(for Windows)or CMD.EXE(for NT).If you are running a DOS program,it is better to check this option sometimes.This option is absolutely needed if you are executing the internal commands like "DIR".

Folder	Change the current folder.

Browse	Search the program file on your disk.


Program Launcher dialog

A-Z	Run the program which is assigned to this button.

Reg.	If checked,you will register the program by clicking buttons.

ChgDir	Change the current folder.


Register Program dialog

Position	Select the button you want to register a program from A to Z

Command Line	Input the command line of the program.And it may contain following macro symbols

%F	The file name of the current work file

%N	The file name without file extension of the current work file

%P	The full path name of the current work file

%D	The folder name of the current work file

%E{Env}	A string which is indicated by a environment string described in {}.

%T	The file name of the temporary file which contains the current selection

%I	A string which is input by user when it is executed

%%	'%'itself

Start In	Specify the initial folder

Comment	A brief description for this program

Minimized	Execute program with minimized window

via Command Shell	Execute via the command shell of your operating system:usually it may be COMMAND.COM(for Windows)or CMD.EXE(for NT).If you want to run a DOS based program,it's better to check this option.If you are executing the internal commands like "DIR",you must check this option.

Get Console Output	Get the console output into the editor.You can also specify that output text will be inserted into the "Output"screen or the caret position of the current edit window

Save Current File	Save current work file before executing

Save All Files	Save all the files currently opened and modified before executing


Menu property page

You can configure the following parameters in "Menu"property page.

Select the target to be configured in the combo box.

You can define user menu (up to five)and user help (up to ten).

User Menu

Insert	Add an empty item to the current menu.

Delete	Delete the item which is selected.

Add To MenuBar

Check this if you want this menu appear on the menu bar.

(textbox)	This will be a menu bar item.You can add "&"character before the character which you want to make mnemonic key.

Menu Item	Describe a menu item string.If you want a mnemonic key,add "&"before the character you like.

Command	Select a Dana's command which you want to add to the menu.

Shortcut Key	Specify a shortcut key to execute this command.You can assign up to two key strokes in "ShortCuts"property page.

User Defined Help

Menu Item	Describe a menu item string to be added to the "Help"menu.

File Name	Specify the file name of the help file.If it doesn't contain a path description,it is assumed to be in the same folder Dana.EXE is installed.

File Type for Keyword Searching

When you are editing a file whose file type is specified here,F1 key can be used to open a keyword help for the caret word.


Convert dialog

Case

No Conversion	No operation.

UPPER ALL	All the characters in the selection to be upper case.

lower all	All the characters in the selection to be lower case.

Upper top of line	A character at the top of the line to be upper case.

Upper Top Of Word	A character at the top of the word to be upper case.

Tab and Space

No Conversion	No operation.

Tab to Space	All the tab characters in the selection to be whitespaces regarding tab columns.

Space to Tab	All the whitespaces in the selection to be tab characters regarding tab columns as long as possible.


Compare dialog

Current File	It shows the file name of the current work file.

Target File	Select the file to be compared to the current file in the combo box.

Range of Scanning Next Start Point

This parameter specifies the range of seeking the next matched line in both of the files when the different line is found.If your file to be compared is drastically changed from the original file,you should specify this parameter bigger.

Lines to Decide as Matched

This parameter specifies how many lines which are matched are assumed the next starting point of scanning.If your file has a lot of same text blocks,you should specify this parameter bigger.


Dummy

It's dummy.Sorry.;-)


Dana Script Library dialog

You can run,register and edit the script files in this dialog box which can contain up to 260 ((A to Z)*10 group)scripts.

Script files should be in the folder where Dana.EXE is installed.

A-Z	Run,register or edit the script in this button.

Browse	Run the script file which is not registered.

Run/Register/Edit	Choose the action for A-Z button


Addin Script dialog
Addin Script property page

You can configure the following parameters in "Addin Script"property page.

Command Script

You can register up to 16 permanent script of Dana.A script which is registered as a permanent script can be added to the "Tool"menu and be assigned to shortcut keys.

Script Name	Specify the script name.You don't have to add ".DAS"extension.You can add ".DAX"extension optionally.That means Dana compiles this script only when the source file (*.DAS)is modified or the Dana itself is updated.

Register as the Item of Tool Menu

Add this command to "Tool"menu.

Menu Item	Specify the menu item string for "Tool"menu.

Shortcut Key	Specify the shortcut key for this command.Hit an *actual*key stroke on the text box.(Tab,CR or ESC can be input by clicking the button)

Startup Script

Scirpt Name	Specify the default script which is to be loaded and executed when Dana is started.You can add ".DAX"extention.

(List box)	Residential scripts which is currently alive are listed.You can release a selected script by hitting "Delete"key.


Register Script dialog

Scirpt Name	Input name of a script to be registered.you don't have to add the ".DAS"extension.You can add ".DAX"extension optionally.That means Dana compiles this script only when the source file (*.DAS)is modified or the Dana itself is updated.Script files should be in the folder which Dana.EXE is installed.

Comment	Input a brief description about this script.


Print Layout property page

You can configure the following parameters in "Layout"property page.

Header	Specify a format string to be used as the page header.

Footer	Specify a format string to be used as the page footer.

You can use the following macro symbols for a format string.

&p The page number.

&f The full path name of the file.

&n The file name.

&w The title of the window.

&d The current date.

&t The current time.

&&"&"itself.

Packed print	Print two pages in one sheet.

Line Number	Print line numbers

Margin	Specify the top,bottom,left and right margin in millimeter coordination.


Escape characters

\t	Tab

\n	Line feed

\b	Bell

\f	Form feed

\e	Escape

\r	Carriage return

\0	Null

\xXX	Control code represented by XX (0x01 to 0x1f)

\\	'\'itself


Regular expressions

Dana's regular expressions are quite primitive,but usable enough.

The following expressions are supported.

^	Match the top of a line.

$	Match the end of a line.

X|Y	Match X or Y�iX,Y is a regular expression)

[A-Z]	Match a character between A and Z.(A,Z is a certain character)

[^A-Z]	Match a character which is not included between A and Z.

[ABC]	Match a character one of the characters "ABC".(A,B,C is a certain character)

[^ABC]	Match a character not one of the characters "ABC".

.	Match any one character.

X*	Match zero or more repeat of X.(X is a regular expression)

X+	Match one or more repeat of X.

X?	Match X or empty string.

A regular expression between ()has higher priority of operation.


Edit Text with Dana

Dana has basic text editing function like cut,copy,paste,undo,redo,and so on.Other than that,you will find many unique and useful features.

Auto Formatting

Auto formatting mode is really useful when you are writing text for sending e-mail or uploading BBS because those kind of text must have return code every about 80 columns.You don't want to worry about inputting return code at each end of line,right?Dana does that automatically.

Around the column which you have specified as "Auto Format Column"in "Values"property,Dana input return code while you are editing text.

Dana's auto formatting mode supports the following features.

Real time Indent

If you write this text without auto formatting mode,Dana doesn't insert any of return code of course.Then toggle auto formatting mode on and try to input spaces at the beginning of this text.The result will be...

If you write this text without auto formatting mode,Dana doesn't

insert any of return code of course.Then toggle auto formatting

mode on and try to input spaces at the beginning of this text.The

result will be...

If you write this text without auto formatting mode,

Dana doesn't insert any of return code of course.Then

toggle auto formatting mode on and try to input spaces

at the beginning of this text.The result will be...

Caption Characters

*Dana also consider about caption characters.If you continue writing in the line which begin with the caption character and one whitespace like this,the result will be...

*Dana also consider about caption characters.If you continue writing in the line which begin with the caption character and a whitespace like this,the result will be...

Caption String Dana assumes that the word followed by two or more whitespaces or a tab as a caption string.So the result will be...

Caption String	Dana assumes that the word followed by two or more whitespaces or a tab as a caption string.So the result will be...

These features are kind of popular in word processor,but very unlikely to be found in text editor.Because text editor must create plain text which everyone in any platform can read.So if you would like to do like this,you must deal with these "return codes".This unique technology really set Dana apart from others.

This feature is very convenient but not perfect,however.Sometimes you will find some lines doesn't look nice especially when you edit middle of the text many times.In this case,you can use "Edit"->"Paragraph"->"Format"command.

Conversion

You can convert the selection by using "Convert"command

For example,if you are editting a text and it includes a part of program source code which contains tab codes.Some BBS host doesn't permit that uploaded text to include tab codes.You can use the Tab-Space conversion command to get rid of it.

The other case,IF SOMEHOW YOU HAVE TO READ HUNDREDS LINES OF CAPITAL TEXT.YOU CAN USE THE CASE CONVersion command to make it easy to read.

You can go back to the not-converted text by undo command,so don't worry about using these function.

c.f.Convert dialog

Paragraph

Left,Right and Centered are the most popular formatting commands.They are simple but useful.These commands assume that the right side of the text is "Auto Format Column"which is defined in "Value"property page when auto formatting mode is on.

Otherwise,"Columns"value is used as the right side of the text.

Indent and UnIndent are also the useful when you are editting program sources.

This command can be done by hitting Tab or Shift+Tab key when you are selecting text.(This usage should be more convenient.:-))

Add String is used when you want to add a certain string at each top or end of lines.

For example:

-When you paste text copied from the other file to quote,

and you want to add ">"at each top of line.

-When you are editing a HTML text and you want to add "<BR>"

at each end of line.

Sort is sometimes useful.

If you are writing C programs and you've already written many prototypes in chaotic order.You cannot find a particular prototype immediately,so you want to sort them in alphabetical order.By hand?Well,it may be very good for killing time.But I bet you are short on time.Use sorting command of Dana.:-)

When you are selecting text with box mode,text in the box region is sorted unless you check "Sort Entire Lines"option.

Use external filter program

Dana can pass the current selection to other applications for its input file.Using this capability,you can use a DOS based robust filter program just like as one of the functions of Dana.

The way to do is as follows.

1)Bring up the "Program Launcher"in "Tool"menu.

2)Check "Reg."check box.

3)Click a certain button you want to assign a program.

4)Write like "Filter.EXE %T"for "Command Line".

5)Check "Minimized"and "via Command Shell"check box.

If Filter.EXE writes its output to the same file for input,that's all.

But the most kinds of filter programs write their output to "stdout".If so,check "Get Console Output"check box and select "Cursor Position"radio button.

c.f.Register programs

HTML Support

When you read files whose extensions are "HTML"or "HTM",inside of HTML tag is shown in different color.Keywords only inside the HTML tags will be colored.(between "<"and ">")

The trick is in "Keywords"property.

I have added popular HTML tags as the default keywords of Dana.If you would like more tags for colored keywords,add them at "Keywords"page in "Preferences".

I also defined "<"and ">"as the "Block Comment",and configured only inside of this block comment to be colored.

Ctrl+]command (brace matching)enables to match HTML tags.For example,if you locate the caret on "BODY"and hit Ctrl+],then the caret is moved to the corresponding "/BODY".

If you are using Dana for NetScape's View Source,specify "/Thtml"option after the "Dana.EXE"command in the NetScape's configuration because NetScape pass the HTML source as "*.txt"file.

Use Bookmarks

One of the most powerful functions of Dana is the bookmark feature.

You can mark any line in a text:A line including a string which is found by Find or Replace function,A line including a caption character.

You can see all the marked lines in the bookmark list and those mark information can be saved on your disk as attribute files.

You can use Dana like as an outline processor with this bookmark capability.

c.f.Bookmark List

Mark any lines you want

Locate the caret on a certain line and select "Find"->"Toggle Bookmark"in menu or click the tool button.

This function toggles on/off a bookmark of the current line.

If you want to mark multiple lines,you can do this function after selecting the text.

Mark Found Lines

If you want to add a bookmark on a line in which a particular string is found,check "Mark Found Line"in "Find"dialog box.Or if you click "Mark All"button instead of clicking OK button,all the found lines are marked immediately.

Of course,you can also use this capability in "Replace"dialog.

Mark Caption Lines

Sometimes you want to mark lines which begins with a particular character.

Of course,you can do this by "Find"function,but Dana supports this function separately as "Bookmark on Caption Line"command.

Once you have specified "Caption Characters"in "Keyword"property page,you can mark all the lines which begins with those caption characters.

List Bookmarks

To list all the bookmarked lines,select "Find"->"List Bookmarks"command.

This list initially hides indented marked lines.Clicking ">>"button make the folded lines visible,and clicking "<<"button fold indented lines again.

The icon with "+"mark means indented lines are folded.Double-clicking this icon make following folded lines open,and vice versa.

Erase bookmarks

You can erase all the bookmark in the current text by "Find"->"Clear Bookmarks".If you are selecting text,bookmarks in the selection are only erased.

Mark when open a file

To add bookmark on particular lines when you open a file,there are two ways.

One is to edit the Dana's initial script.

See this part of Dana.DAS (Dana.DAS is in the directory Dana.EXE exists.)

'///////////////////////////////

'After open file

Proc OnAfterOpen()

Command("MarkCaption")

Dim L%,M%

L%=GetTopLine()

M%=GetNextMark(L%)

If M%And .MarkListOn =False Then

Command("MarkList")

End If

End Proc

It means that when a file is opened,the "MarkCaption"command is executed and if at least one marked line is found,bring up the bookmark list dialog.

It is just one of examples.

If you want,you can use regular expression to find lines instead of title mark command.

The other way is to use the Dana's "Open and Execute"capability.When a file is opened and the word begins with "@S"is found at the top of the text,Dana assume that the following word after "@S"is a name of a script and execute it.

For example,you can describe like this in your C source code.

/*@SFuncList */

Dana runs "FuncList"script when this source is opened.

Usually,Dana searches a script in the folder Dana.EXE is installed.But in this case,Dana search it in the folder the opened text file exists at first.

So,you can distribute text files with some script files for the other users of Dana.

For more information on Dana Script,see DanaScr.HLP


About the registration

Dana is a shareware:distribution and trial are free of charge.

If you want to continue to use this software,you must purchase a license.

Trial period is up to 30 days.

If you register ...

-You will not see the shareware notification dialog on startup.

-You will be notified the major version up of Dana via E-mail.

-You will be qualified to upgrade Dana without any additional fee when new version is released.

Please check before the registration

-You MUSThave an E-mail address.

Without an E-mail address,you will not receive a registration pass code.

"E-mail address"here means one which can receive Internet mail.

If you are a member of a network service which provides Internet mail address,your E-mail address would be

YOURID@blahblah.net

YOURID@blahblah.com

...

-You MUST have one of the payment methods which are supported by Kagi.

Credit Card:Visa,Mastercard,American Express.

Check or Money Order

Cash (It,however,is not a good idea because of the security reason and sending cash is prohibited in some country's law.)

First Virtual:see http://www.fv.com

Invoice

-Please make sure Dana works fine on your machine.

Dana is programmed to work with most of machines.But sometimes it might not work well for some reasons;the problem of your display driver,etc.

PLEASE MAKE SURE DANA WORKS FINE ON YOUR MACHINE BEFORE YOU SEND MONEY.

Of course,we will do the best to fix the problem if you report to us.But your registration is not refundable in any way.

Price

30 US$ for one license.

Volume discount

Volume discount will be applied according to the number of licenses.

Please read below carefully if you want to purchase multiple licenses.Once your payment is processed,it is not refundable even if you specified inappropriate number of licenses.

minimum number	unit price(US$)

10	20

20	15

40	10

60	9

80	8

100	7

200	6

300	5

1000	3

The price for 20 licenses is 15$*20 =$300,for 40 licenses is 10$*40 =$400.

Selecting minimum number is most reasonable.for example,if you want 18 licenses,it is not a good idea to purchase exactly 18.Because 18 is greater than 10 but less than 20,so $20 unit price is applied.It is paradoxical but total amount is $360 which is more expensive than $300 for 20 licenses!

How to register

-Run REGISTER.EXE.(REGISTER.EXE is included in the Dana's package.)

You can also run REGISTER.EXE from the startup dialog clicking "Order To Kagi"button.

-Fill out the information such as your name,E-mail address,number of licenses you are purchasing,and payment method.

For more details,see REGISTER.HLP.

-Send the output of REGISTER.EXE to Kagi (sales@kagi.com).

via E-mail,postal mail or fax.

Please do NOT send it to me.Only "Kagi <sales@kagi.com>"can process the payment.

-You will receive a confirmation of the payment and a registration pass code via E-mail.Generally,It takes less than a week to receive it.

Fax order takes a few days more.

Long weekend,heavy network traffic,etc.,may cause a several days delay.

If you do not receive a reply in two weeks,please contact me.(carty@rimarts.co.jp)

-Run Dana and click "I have paid and got a pass code."button on the startup dialog.

You can also register from "User Registration"in the "Help"menu.

-Fill out the information:your name,registration pass code and E-mail address,and click "OK".

For more information about the registration through Kagi,

see "http://www.kagi.com/".

And if you have any problem through the registration procedure,feel

free to contact me.(carty@rimarts.co.jp)

KAGI IS A PAYMENT PROCESSING SERVICE.THEY DO NOT DO ANY TECHNICAL SUPPORT FOR OUR PRODUCT.PLEASE DO NOT SEND ANY MAIL REGARDING OUR PRODUCT TO KAGI,BUT TO <carty@rimarts.co.jp>.

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

-Kagi is the secure and convenient shareware payment processing service."http://www.kagi.com/".

-Register for Windows (REGISTER.EXE)is written by Grzegorz Kochaniak.


User Registration dialog

Your Name

Input your name.

If this copy is licensed to your company,input the name of your company.

Pass Code

Input the pass code which will be sent when you register.

The pass code is at the end of the "Thanks for your registration"mail.

E-mail

Input your or your company's e-mail address.


Misc.property page

You can configure the following settings in "Misc."property.

Scroll

Accelerate	Check this if you want to accelerate scrolling after certain key repeats.

Smooth	Scroll smoothly.If you are lucky enough to have fast video card,choose this.

Skip	Skip some lines instead of scrolling.This make scrolling faster but less beautiful.

Key Repeats to Accelerate

Specify the number of key repeats before it starts acceleration.

Cursor Movement

Accelerate	Check this if you want to accelerate cursor key.You can specify delay time and repeat interval.

Startup

Permit Multiple Instances

Open multiple instances of Dana.

Number of MRU files	Specify the maximum number of MRU files which will show up if you open "File"menu.Bigger is better,but sometimes you won't see entire menu if you are using VGA display.


Tools property page
Tools proerty page

You can configure following settings in "Tools"property page.

Archiving programs

ZIP,LZH Inflate	Specify the command line of the program which you will use in "Open"dialog to archive files.

In the command line,%1 will be substituted with the archive file name and %2 will be the 'response file' name.

ZIP,LZH Deflate	Specify the command line of the program which you will use in "Open"dialog.

In the command line,%1 will be substituted with the archive file name and %2,if specified,will be the destination folder to extract files.

DOS program	If the archive program is a DOS application,check this.

Spell Check	You have American and British spelling check option.

Open E-mail by	Specify the command of program which you want to open the e-mail address in the text.%1 will be substituted actual e-mail address.If nothing is specified,the program which is associated with URL:MailTo file type will be invoked.

Open URL by	Specify the command of program which you want to open the URL address in the text.%1 will be substituted actual URL.If nothing is specified,the program which is associated with URL:HyperText Transfer Protoco will be invoked.

Double Clicking e-mail or URL means "Open"

If not checked,the address will be highlighted when you double click it.In that case,you can "Open"in the right button menu.


Sort

Sort the selection by ascendant or descendant order.

You can choose the following option.

Compare After This String

You can specify certain string which you want to use to sort comparing after this string.

For example,if you would like to sort the text which contains e-mail addresses into domain order,you can specify "@"here.

Case Insensitive	Comparing string ignoring upper/lower case.'A'and 'a'are treated as the same.

Sort Entire Lines	This option is available when you are selecting text in 'box mode'.If this option is not checked,only inside of the block is sorted.If checked,the box selection is treated as sort keys and entire lines are sorted.

e.g.

1000	Jane

1001	Michael

1002	Hayley

1003	Peter

1004	Billy

1005	Amanda

If you select the names in box mode,the result of sorting should be the following.

1005	Amanda

1004	Billy

1002	Hayley

1000	Jane

1001	Michael

1003	Peter


Format

Format the selection or one text block which ends with an empty line.

If you want the text without return codes formatted,use this function.


DeFormat

Remove return codes from the selection or one text block which ends with an empty line.