@DATABASE help.guide
@WORDWRAP
@NODE MAIN
@TITLE "DreamTerm V1.3 Help"

This is ONLINE-HELP, not manual.

@ENDNODE

@NODE Charset

@{b}Listview@{ub}
Select which charset to edit. There is always ISO set which is hardcoded to DTerm, due that it cannot be edited. Also only txd/rxd can be edited if set is currently in use. Below this is string gadget which is used to change charset name. However keep in mind that sets are identified using this name, if some phone-entry is using set which name is changed then ISO is used as fallback.

@{b}Disk gadget ...font:@{ub}
This will open font requester where you can select which font to use in this set. Any fixed size font can be used and scaling is also possible.
Hint: MagicWB users should try XEN font here. IMHO console will look great in at least 640x480x5 workbench screen with console size about 80x50... Unfortunately there is no XEN.ibm set so conversion table SF8->ISO.ct must be used in pc-boards. (Well, append ISO.XEN or SF8->ISO.XEN;-)

@{b}TXD conversion@{ub}
Load conversion table which is used when chars are sended from DTerm, mostly means ISO -> something conversion. With this it is simple task change char A to Z. There are some commands (Send noconv) which can pass this to allow send already converted text.

@{b}RXD conversion@{ub}
Load conversion table which is used for received chars. With this it is possible convert pc etc. charset to ISO in realtime (SF8->ISO). Conversion is not needed if font is already right, for example SF8 uses DT_IBM01 font which is 8-bit finnish set and thus DO NOT NEED that received ibm-chars are converted.

How to make conversion table?

Prepare 256 bytes long index file which is used like this:

Char x is converted to char Table[x], if Table[x] = 0 then char is stripped. Can it be any simpler?

@{b}Add new@{ub}

Add new set.

@{b}Delete@{ub}

Delete currently selected set. However keep in mind that sets are identified using name, if some phone-entry is using set which is deleted then ISO is used as fallback.

@ENDNODE

@NODE Dialer

@{b}Name@{ub}
Name of the system.

@{b}Phone@{ub}
Current number where dterm tries to dial.

@{b}Comment@{ub}
Some comment text which may have been entered for this entry.

@{b}Modem@{ub}
Last msg which modem sent back.

@{b}DTerm@{ub}
Additional message to inform about dialing process.

@{b}Add time@{ub}
When modem is not finished handsaking and time is running out this will add more time so dialer will not hangup modem. I suggest that you set modem's wait somewhere near two minutes. (ZyXEL: ATS7=120)

@{b}Skip@{ub}
Skip to next entry.

@{b}Abort@{ub}
Abort dialing.

@ENDNODE

@NODE Drop

@{b}Add@{ub}
Add new droplist number. (Only ONE number, no xxx|xxx etc.)

@{b}Delete@{ub}
Delete droplist number, after that there is no warning if you add phone entry with that number.

@ENDNODE

@NODE FileID

@{b}Clear@{ub}
Clear fileid entries.

@{b}Send@{ub}
Send fileid comment text (Normal char conversion is done, due that you must use ISO in fileid for this to work correctly).

@{b}Send raw@{ub}
Send fileid comment text (only $a -> $d conversion is done).

@ENDNODE

@NODE IEMSI

User will show who you are and bbs will show where you have called...

@ENDNODE

@NODE Entry "PhoneBook entry, pick table and current settings"

Due the fact that DreamTerm allows changing every individual setting in every phonebook entry this window is used for multiple purposes. First it can be used to change current settings if you don't want to use menu 'shortcuts'. It is also used to change Pick Table (global) settings and finally for normal Phonebook entry editing. Gadget actions are always same only 'Set pick' and 'Clear pick' will act differently. (Note: CloseWindow is same as cancel)

@{b}Current settings@{ub}
Set pick & Clear pick are disabled.

@{b}Pick table@{ub}
Set pick    - option is placed to default pick table profile.
Clear pick  - option is placed to default pick local profile.

Pick table settings are copied to new entry when creating it and default pick table profile is used. Settings which appear 'ghosted' here will be 'ghosted' also in newly created entry.

@{b}Creating/Editing entry@{ub}
Set pick    - option will be copied from pick table. 
Clear pick  - option will be copied from local (here).

Options which are copied from pick table will appear 'ghosted' and of course you cannot edit them. Remember that every option which is picked from table can be changed only from pick table. Example: you have set of phonebook entries which all pick dte from table (ghosted), now if you change dte in pick table then all entries will change too! (I hope you understand the idea)
BTW, in elsewhere this help manual I will refer option which is picked from table as global and option which is used directly as local.

@{b}Good to know@{ub}
When you use Set/Clear pick then you must always change gadgets state in order something to happen, for example is not enough to press return in string gadget you must write to it! Option will always go to disabled state when you change it to desired state. (Well... option == setting:^)

  @{" BBS/Serial   " Link bbs       } 
  @{" Screen       " Link screen    } 
  @{" Transfer     " Link transfer  } 
  @{" Emulation    " Link emulation } 

  @{" String codes " Link strings   } 

@ENDNODE

@NODE bbs "BBS/Serial settings"

@{b}Phone@{ub}
First string is prefix which is added top of phonenumber when dialing. If actual phonenumber is long distance then best choice is propably set this to be global option and if number is local then this shoul be local option. (This is handy for us finnish users because we have 3 companies for long distance calls)
Second string is actual phonenumber, use | to separete numbers if there is more than one number to dial. This is also the number(s) which used to compare against droplist when adding new entry. So if you enter number like 90-1234 and there is number 901234 in droplist then there will be warning.
(I also added menu option which directly changes pick table phoneprefix so it is easy to change company if rates change:-)

@{b}Password@{ub}
Password used in this system (Do not add \\r (return) at the end). Do not confuse this password to IEMSI one.

@{b}Comment@{ub}
Some comment which you want to see when dialing.

@{b}Dial@{ub}
Dial prefix (ZyXEL owner could use something like this AT&K4 &N0 DT).

@{b}Call@{ub}
Connection cost.

@{b}Minute@{ub}
Cost per minute. Well, how should I code this? Finnish companies are now competive and cost varies greatly.

@{b}Logfile@{ub}
File where to log this entry's calls (without path programdir is used).

@{b}Wait between dials@{ub}
How many seconds to wait before dialing again.

@{b}Wait dialing@{ub}
How many seconds to wait succesful connection.

@{b}Hardware serial@{ub}
Use custom made routines to handle serial port, if you normally use serial.device then put this option on! This always uses external port and if you previously were using something like modem0.device then you cannot use this.

@{b}Drop DTR to hangup@{ub}
Will drop DTR for about 40000ms instead for sending +++ATH string. This will cause hangup if your modem is setted right. (ZyXEL: AT&D2)

@ENDNODE

@NODE Screen

@{b}Hardware screen@{ub}
Use custom made super fast screen (only 8x8 fonts can be used). Because this is hardware 'hack' your actions are somewhat limited, DreamTerm tries to be smart and pop normal screen on and off when needed but I still strongly suggest you NOT to play with Amiga-M (screen swap) etc. Use Amiga-T to disable screen temporaly (rxdpop also off) if you want to use other programs same time.

@{b}Enable AGA bandwith@{ub}
Switch 2x bandwith mode in hardware screen (USE ONLY IF YOU HAVE AGA CHIPSET).

@{b}Automatic RXD popup@{ub}
Pop hardware screen on when receiving chars from serial.

@{b}Workbench screen@{ub}
Open console to workbench screen. If you want all colors to be right then use at least 32 colors in workbench screen (if some other program uses palette sharing then it may not be enough).

@{b}Keep Workbench colors@{ub}
Do not override system colors in custom screen. Useful if you use 4-16 colors screens and still want all window colors to be exact. Unfortunately means that some emulation pen colors may be incorrect.

@{b}RTS blit@{ub}
Tell modem stop to send data when blitting (this may reduce overruns). You must set RTS handshaking on in modem.

@{b}Screen mode@{ub}
Open requester to select which screenmode to use. If you own A1200/A4000 I advice you to use at least 32 colors, it has very little effect on console speed/scrolling and MUI windows etc. will look better.

@ENDNODE

@NODE Transfer

@{b}Automatical up/dnload@{ub}
Invoke upload/dnload when selected protocol's auto up/dn string is received.

@{b}Minimal status display@{ub}
Show upload/dnload status in status line (Use Amiga-A to abort), this could be useful when using hardware screen.

@{b}Double buffer@{ub}
Buffer protocols serial write (xpr_swrite) and return immediately. This will speed upload but may not work with some protocols. If you use xpr2.001 protocol (dmodem:-) you should set this off because they use special flag to enable buffering if needed.

@ENDNODE

@NODE Emulation

@{b}Default@{ub}
Reset to default ansi palette.

@{b}Brighter@{ub}
Brighten bright colors.

@{b}Copy 8@{ub}
Copy normal colors over bright colors.

Due MUI limitation you must click palette edit before any of changes are visible. Also if you use set/clear pick table you must click these gadgets not palette editor.

@{b}Strip bold@{ub}
Change bold text to normal if PC Ansi is off.

@{b}Esc[2J homes cursor@{ub}
For some reason bbs's expect this ansi-sequence to home cursor.

@{b}CR or LF to CR/LF@{ub}
Treats both cr and lf as they were cr's. (What the heck?-)

@{b}PC Ansi@{ub}
Display bold character using bright color.

@ENDNODE

@NODE strings "String codes"

You can use these to add control codes to protocol auto up/dn strings or function keys

\\n  - linefeed
\\r  - return
\\t  - tab
\\b  - backspace(del)
\\e  - escape
\\\\   - \\
\\p  - current password
^X   - Control, ^C or ^c is same as CTRL-C (Only A-Z are possible)
^^   - ^
@ENDNODE

@NODE phone "PhoneBook directory window"

@{b}Listview@{ub}
This will show all phonebook entries with name, phonenumber, last call date, total cost, calls and total time. Click to select entry for editing or deleting, doubleclick to select it for dialing.

NOTE: If you want to keep last call etc. information up to date then set 'auto phonebook save' on in project menu. It will save phonebook automatically after you have disconnected from bbs. (Well, in small safe measure it will also backup phonebook (DT_config.pb.old/DT_config.dl.old) when DreamTerm is started.)

@{b}Dial@{ub}
Start to dial selected entries (one's with xxx>).

@{b}Edit@{ub}
Edit currently selected entry.

@{b}Add New@{ub}
Add new entry to phonebook.

@{b}Clone@{ub}
Clone currently selected entry and start to edit it.

@{b}Clear@{ub}
Clear all selections (one's with xxx>).

@{b}Delete@{ub}
Delete selected entry.

@{b}Drop away@{ub}
Delete selected entry and add its phonenumber's to special list which is saved along default phonebook. If you in future create new phonebook entry with same phonenumber DTerm will warn you. Handy if you have tried some bbs which you don't want to call again.

@{b}Reset@{ub}
Remove call info from selected entry.

NOTE:  You can save over default phonebook (DT_config.pb) but 'droplist' will not be saved.

@ENDNODE

@NODE Protocol

@{b}Listview@{ub}
With this you select which protocol to edit. There is always ZPriv which is hardcoded to DTerm, due that you cannot edit it. Also you cannot edit name if protocol is currently in use. Below this is string gadget which you can use to change protocol name. However keep in mind that protocols are identified using this name, if some phone-entry is using set which name is changed then ZPriv is used as fallback.

@{b}Xpr library@{ub}
This will tell which xpr library to use.

@{b}Init string@{ub}
This is protocols init string, read library's docs to learn about these. Note that DreamTerm DO NOT support interactive option setting, I think it is quite useless because normal user don't understand those questions more than XN etc. shortcuts...

@{b}Auto upload@{ub}
String which will wake up automatic upload. (Equivalent for menu upload)

@{b}Auto dnload@{ub}
String which will wake up automatic download. (Equivalent for menu download)

@{b}Add new@{ub}
Add new set.

@{b}Delete@{ub}
Delete currently selected protocol. However keep in mind that protocols are identified using name, if some phone-entry is using protocol which is deleted then ZPriv is used as fallback.

@ENDNODE

@ENDNODE