home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / telecomm / conn210i.lzh / CONNECT.HLP < prev    next >
Text File  |  1993-07-24  |  109KB  |  4,449 lines
  1. §§Menue-Term§
  2. §Character Set§_Zeichensatz§
  3. §Compatibility§_Kompatibilität§
  4. §Funktion Keys§_Funktionstasten§
  5. §Display§_Darstellung§
  6. §Capture§_Protokoll§
  7. §Emulation§_Emulation§
  8. §ASCII-Upload§_Asciiupload§
  9. §Answering Machine§_Anrufbeantworter§
  10. §Learn a Script§_Lernen§
  11. §TEK Parameters§_Teksetup§
  12. §File Transfer§_Transfer§
  13. §Tabulator§_Tabulator§
  14. §Status Line§_Statuszeile§
  15. §Terminal Size§_Size§
  16. §Port§_Port§
  17. §Dial§_Wahl§
  18. §Send Break§T\BREAK§
  19. §Terminal Reset§T\RESET§
  20. §Commun. Reset§T\KRESET§
  21. §Hangup§T\HANGUP§
  22. §Fix Setup§T\FIXSET§
  23. §Load Setup§T\LOASET§
  24. §Save Setup§T\SAVSET§
  25. §Clear Screen§T\CLRSCR§
  26. §Clear Buffer§T\CLRPUF§
  27. §Save Buffer§T\SAVPUF§
  28. §TOS-Shell§T\TOSSHELL§
  29. §TEK 4014 Window§Tektronixfenster§
  30. §CoSHy§CoSHy§
  31. §Script§CoSHy§
  32. §Upload§T\UPLOAD§
  33. §Download§T\DOWNLOAD§
  34. §Replay§T\REPLAY§
  35. §Copy Buffer§_Puffer§
  36. §
  37. Terminal Menu
  38.  
  39. The terminal menu includes the following 
  40. items:
  41. ---------------------------------------...
  42.    Terminal           Setup
  43. ---------------------------------------...
  44.    File Transfer      Emulation
  45.    Terminal Size      Character Set
  46.    Terminal Reset     Display
  47.    Commun. Reset      Capture
  48.    Hangup             Tabulator
  49.    Clear Screen       Port
  50.    Clear Buffer       Function Keys
  51.    Save Buffer        Compatibility
  52.    Copy Buffer        Status Line
  53.    Send Break         TEK Parameters
  54.                       Fix Setup
  55.                       Load Setup
  56.                       Save Setup
  57.  
  58. ...------------
  59.    Misc
  60. ...------------
  61.    CoSHy
  62.    Script
  63.    Learn a Script
  64.    TOS-Shell
  65.    TEK 4014 Window
  66.    Answering Machine
  67.    Dial
  68.    ASCII-Upload
  69.    Upload
  70.    Download
  71.    Replay
  72.  
  73. §§T\UPLOAD§
  74. §file transfer dialog§_Transfer§
  75. §
  76. Upload
  77.  
  78. Using the menu item Upload... you can send
  79. a file with the parameters specified in the
  80. file transfer dialog.
  81.  
  82. §§T\DOWNLOAD§
  83. §file transfer dialog§_Transfer§
  84. §
  85. Download
  86.  
  87. Using the menu item Upload... you can receive
  88. a file with the parameters specified in the
  89. file transfer dialog.
  90.  
  91. §§T\REPLAY§
  92. §emulation§_Emulation§
  93. §Upload§T\UPLOAD§
  94. §ASCII-Upload§_Asciiupload§
  95. §
  96. Replay
  97.  
  98. A file from disk will be displayed using
  99. the current emulation.
  100.  
  101. ATTENTION: No characters of the file will
  102.          be sent to the modem. If you
  103.          want to do this, use the commands
  104.          Upload or ASCII-Upload.
  105.  
  106. §§T\TOSSHELL§
  107. §SHELL§Environment§
  108. §
  109. TOS-Shell (Terminal Menu)
  110.  
  111. Start the TOS shell in the current window if 
  112. one is installed. Use the environment variable 
  113. $SHELL or the _shell_p pointer to install one.
  114.  
  115. §§T\SAVPUF§
  116. §
  117. Save Buffer.
  118.  
  119. All data in the current history buffer will
  120. be saved to a disk file.
  121.  
  122. §§T\CLRPUF§
  123. §
  124. Clear Buffer
  125.  
  126. All data in the current history buffer will
  127. be cleared.
  128.  
  129. §§T\BREAK§
  130. §sendbreak§COSHYHLP\SENDBREA§
  131. §
  132. Send a Break.
  133.  
  134. CoNnect sends the so called Break Signal
  135. to the modem.
  136.  
  137. See also sendbreak (CoSHy command).
  138.  
  139. §§T\RESET§
  140. §Fix Setup§T\FIXSET§
  141. §Save Setup§T\SAVSET§
  142. §Load Setup§T\LOASET§
  143. §
  144. Terminal Reset.
  145.  
  146. The terminal will be reset to the values
  147. of last Fix Setup, Save Setup or Load Setup.
  148.  
  149. §§T\CLRSCR§
  150. §
  151. Clear Screen
  152.  
  153. The current window will be cleared.
  154.  
  155. §§T\KRESET§
  156. §holdscreen§holdscreen-aktiv§
  157. §
  158. Communication Reset.
  159.  
  160. All characters pending in the IO-queue
  161. will be discarded. A possible state of
  162. holdscreen will be cleared.
  163.  
  164. §§T\HANGUP§
  165. §Dial§_Wahl§
  166. §hangup§COSHYHLP\HANGUP§
  167. §
  168. Hangup.
  169.  
  170. The modem will be forced to hang up the phone.
  171. The way this  is done can be set up in the
  172. Dial dialog. 
  173.  
  174. See also: hangup (CoSHy command)
  175.  
  176. §§T\FIXSET§
  177. §terminal reset§T\RESET§
  178. §
  179. Fix Setup
  180.  
  181. All current setup settings will be fixed for
  182. a later terminal reset.
  183.  
  184. §§T\LOASET§
  185. §Save Setup§T\SAVSET§
  186. §
  187. Load Setup
  188.  
  189. will load a terminal setup, saved by
  190. Save Setup, from disk.
  191.  
  192.  
  193. §§T\SAVSET§
  194. §terminal menu§Menue-Term§
  195. §Load Setup§T\LOASET§
  196. §Fix Setup§T\FIXSET§
  197. §Dial§_Wahl§
  198. §
  199. Save Setup
  200.  
  201. The current terminal settings will be
  202. saved to disk. Terminal settings
  203. are all possible settings that can be
  204. done within the terminal menu. There
  205. is one exception to this rule: Telephone
  206. numbers in the Dial dialog are stored 
  207. in the telephone-book. Only the name of
  208. this telephone file will be stored in
  209. setup.
  210.  
  211. Using Load Setup, you can reload a
  212. saved setup.
  213.  
  214. Before a Save Setup is executed, CoNnect
  215. will automatically do a Fix Setup.
  216.  
  217. §§_Puffer§
  218. §selecting, sending,§Markieren§
  219. §
  220. The buffer window
  221.  
  222. The buffer window is opened by the menu
  223. item Copy Buffer in the terminal menu.
  224.  
  225. The buffer window enables you to have the
  226. history buffer in an extra window while
  227. your dataflow in the terminal window is
  228. running.
  229.  
  230. Using the buffer window you can have all
  231. the possibilities in selecting, sending,
  232. ... like in the terminal window. Sending
  233. text will send them to the buffers port.
  234.  
  235. §§_Wahl§
  236. §clipboard§Klemmbrett§
  237. §trash can§Papierkorb§
  238. §modem parameter§Modemparameter§
  239. §phone editor§T-Editor§
  240. §load numbers§T-Laden§
  241. §save numbers§T-Laden§
  242. §
  243. In the dialing dialog you find the 
  244. 'telephone book' on the right hand side and 
  245. the 'repeated dial memory' on the left hand 
  246. side. Dragging numbers from the telephone 
  247. book to the dial memory will repeatedly 
  248. dial all the numbers in this memory after the 
  249. telephone icon has been clicked on.
  250.  
  251. Inbetween there are many icons to manipulate the
  252. telephone book or modem settings. On top there is the
  253. phone editor, followed by load numbers, save numbers
  254. and the sorter icon. In the bottom line there are the
  255. trash can, the clipboard and two modem parameter icons.
  256. Finally above the 'repeated dial memory' there is  
  257. the telephone icon.
  258.  
  259. Using the mouse.
  260. ----------------
  261.  
  262. By clicking on items in the telephone book, you may
  263. select these items. Doing this while pressing the
  264. SHIFT key will append the new item to a selection.
  265. On the left hand side of the telephone book you also
  266. may create a rubber box to select several items at once.
  267. Clicking on the left hand side will deselect all
  268. entries. The handling of the 'memory' box is 
  269. identical.
  270.  
  271. Adding items to the memory is done by dragging these
  272. from the telephone book to the memory (dragging:
  273. moving the mouse with the left button pressed).
  274.  
  275. Deleting items in the telephone book or in the memory
  276. is done by dragging them to the trash can. In the 
  277. memory a double click on an item will cause the number 
  278. to be dialed and then delete it from the list after a
  279. connection is made.
  280.  
  281. By dragging items within the telephone book or the 
  282. memory you may change the order.
  283.  
  284. The most important icon: The telephone.
  285.  
  286. Clicking on the telephone will cause CoNnect to start
  287. dialing the numbers within the memory. This dialing
  288. will be continued until a connection can be established
  289. or a user definable event (see modem parameter) occurs.
  290.  
  291. Dragging an item onto the the telephone icon will
  292. cause CoNnect to start a single dial-in attempt.
  293.  
  294. Double-Clicking an item in the telephone book while 
  295. pressing SHIFT will start dial attempts to this number
  296. until a connection is established.
  297.  
  298. §§T-Laden§
  299. §
  300. The two disk-like icons are used to save and load
  301. telephone books.
  302.  
  303. Loading a telephone book will replace the old one
  304. if the SHIFT key is not pressed. If you hold the SHIFT 
  305. key then the new book will be appended to the old one.
  306.  
  307. The same applies for saving. Saving the book will 
  308. delete a file. If the SHIFT key is pressed then the 
  309. book will be appended to this file.
  310.  
  311. §§T-Editor§
  312. §
  313. The Phone Editor
  314.  
  315. In this editor you may change the data in your 
  316. telephone book.
  317.  
  318. Clicking on the editor icon without any telephone
  319. book item selected will allow you to create 
  320. a new entry to your telephone book.
  321.  
  322. Dragging one or more already available entries to 
  323. this icon will allow you to modify these items.
  324.  
  325. The telephone number is the number you have to dial
  326. to get a line to a given bbs. The reset and the init
  327. string are of similar meaning. They contain strings
  328. to setup your modem before dialing starts. The dial
  329. string itself (normally ATD#|) starts the dialing
  330. sequence.
  331.  
  332. All three strings my contain 3 special characters:
  333.  
  334. | to produce a carriage return
  335. ~ to wait for 0.5 second
  336. ^ to pull DTR to low for 0.5 seconds
  337.  
  338. You may also enter a login script to run an automatic
  339. login script to your bbs if the connection is
  340. established.
  341.  
  342. The info button enables you to add some 
  343. information to an entry in the phone editor.
  344.  
  345. §§Modemparameter§
  346. §
  347. Setup of the modem's reactions
  348.  
  349. By clicking on the first modem icon you can setup
  350. the way connect reacts on modem return code while
  351. dialing. In the first row you enter the modem
  352. messages. Right of them you can specify CoNnect's
  353. reaction. If you don't want CoNnect to act on a 
  354. specific modem response just remove this response
  355. from the response list. Normally CoNnect reacts
  356. on any modem response BEGINNING with the entered
  357. characters. If you want CoNnect only to react on
  358. identical responses append a CONTROL-M (a CR sign)
  359. to this string.
  360. There are also waiting parameters. You can specify
  361. how long CoNnect waits until it dials the next 
  362. number in the dialing list (1st parameter) and how
  363. long it waits until redialing the first number in
  364. the list again.
  365.  
  366. By clicking on the second modem icon you can 
  367. specify the delay between the characters sent to the
  368. modem when dialing. Some low-quality modems need
  369. long delays like 100ms. You can also enter the 
  370. default dialing sequence strings used when you 
  371. enter new numbers in the phone editor or when
  372. reading in a scrap.txt file from the clipboard.
  373.  
  374. §§Klemmbrett§
  375. §
  376. Clipboard:
  377.  
  378. CoNnect's clipboard is compatible with the GEM-Clipboard.
  379. CoNnect will ask you to install a Clipboard, if this
  380. hasn't been done on your system so far (there are 
  381. many PD programs to do this) or if CoNnect cannot
  382. find the folder c:\clipbrd. A full clipboard has
  383. a written peace of paper on it. Its content (if it's
  384. containing phone book information) can be dragged
  385. to the phonebook. You can drag numbers from the 
  386. phone book or the dialing memory to the clipboard.
  387. (Pressing SHIFT during this action means: Appending)
  388.  
  389. §§Papierkorb§
  390. §
  391. The wastebasket.
  392.  
  393. Everything you drag onto the wastebasket will be
  394. lost. An UNDO is only possible if you leave the
  395. dialing dialog by CANCEL in which case all 
  396. changes to this dialog will be discarded. 
  397. When dragging the clipboard onto the wastebasket
  398. the contents of this clipboard will definitely be
  399. lost. No UNDO is possible.
  400.  
  401. §§_Vorschreibzeile§
  402. §
  403. The Type Ahead Buffer
  404.  
  405. You can activate the type ahead buffer by pression
  406. CONTROL+INSERT in a terminal window.
  407. Everything you type inside this window will be
  408. sent to the modem if you end this input with an
  409. ENTER or RETURN. An UNDO will cancel your input.
  410.  
  411. Pressing Cursor UP/DOWN will let you use a 20
  412. lines history for the type ahead buffer.
  413.  
  414. §§_DerTransfer§
  415. §
  416. The transfer is in progress.
  417.  
  418. To abort press the CANCEL button or the
  419. UNDO key.
  420.  
  421. You can see:
  422.   The name and the path of the file.
  423.   And a bar displaying the progress of
  424.   the transfer. 
  425.  
  426. Below:
  427.   Transmitted data size.
  428.   Whole data size.
  429.   
  430.   Current cps rates.
  431.   Average cps rates.
  432.  
  433.   Elapsed time.
  434.   Estimated complete transmission time.
  435.  
  436. Below:
  437.   There you can read messages about
  438.   possible errors or other messages from
  439.   the protocol.
  440.  
  441. §§Zmodemparameter§
  442. §
  443. Here you get a short listing of the options
  444. configurable for the internal Z-Modem.
  445.  
  446. Popup1: Protocol:
  447. -----------------
  448.  ∙ Z-Modem: This is the best choice if your
  449.       host supports this protocol.
  450.  
  451.  ∙ Y-Modem: and
  452.  
  453.  ∙ X-Modem: should only be used if your host
  454.       does not support Z-modem. Y-Modem is 
  455.       not safe and X-Modem is very slow.
  456.  
  457.  ∙ X-Modem7: A protocol, used at least at
  458.       Compuserve. This implementation here
  459.       is not tested at all.
  460.  
  461.  ∙ Compuserve B and
  462.  ∙ Compuserve B+: a two protocols used in 
  463.       compuserve only. They may be a little
  464.       buggy in this verion of CoNnect.
  465.  
  466. Popup2: Buffersize:
  467. -------------------
  468.  You may choose between 128, 256, 512 and 1024
  469.  bytes. The resulting buffersize will be your
  470.  chosen one or below this depending on the 
  471.  host's parameters. For X-Modem only 128 or 1024
  472.  bytes are useful. Y-Modem will always use
  473.  1024 Bytes regardless of your settings here.
  474.  
  475. Popup3: Data Protection:
  476. ------------------------
  477.  ∙ Overwrite will always overwrite existing 
  478.       files.
  479.  ∙ Protect will cause an error condition when
  480.       receiving a filename which exists already
  481.       on your file system.
  482.  ∙ Resume: Will try to do an error recovery.
  483.       In fact it will append missing parts to
  484.       already existing files.
  485.  ∙ Ask User: If a file already exists, the
  486.       user is asked if he/she wants to over-
  487.       write, to resume or to skip this file.
  488.  ∙ Rename: If a file already exists, CoNnect
  489.       will create a unique filename (by
  490.       changing the extension to 001, 002 ...)
  491.      
  492. Popup4: Escapes:
  493. ----------------
  494.  ∙ No Escapes is normally used on lines which
  495.       will not filter any of the possible 256
  496.       8-Bit characters
  497.  ∙ Escapes on has to be used if you are working
  498.       on certain unix systems which ttys will
  499.       filter control characters. Transmission is
  500.       much slower when using escapes.
  501.  
  502. Popup5: Data Type:
  503. ------------------
  504.   You may select here if you are transferring
  505.   Binary data (no conversion performed) or 
  506.   Ascii data (Linefeed have to be changed).
  507.  
  508.   Automatic data type detections will try to 
  509.   guess the data type by the filename's ex-
  510.   tension. This is not always safe. CoNnect
  511.   assumes the following extensions to be 
  512.   extensions of Ascii Files:
  513.   
  514.   TXT, ASC, RTF, C  , CPP, C++, H  ,
  515.   PAS, F  , FOR, F77, CAR, PS , EPS,
  516.   XBM, TEX, STY
  517.  
  518. Popup6: Checksums:
  519. ------------------
  520.   You may select either CHECKSUM (XY-Modem),
  521.   CRC-16 (XYZ-MODEM) or the standard CRC-32
  522.   (Z-Modem) which gives most security.
  523.  
  524. Full paths:
  525. -----------
  526.   Only a few hosts allow this option to be
  527.   switched on. It will send full pathnames
  528.   and try to create directories on your file-
  529.   systems if full pathnames are received.
  530.  
  531. Force acknowlegde:
  532. ------------------
  533.   Normally CoNnect's Zmodem runs in Stream-
  534.   mode. If this switch is on, CoNnect wants
  535.   an acknowledge from the host after each
  536.   transmitted block. This will decrease
  537.   transmission speed.
  538.   
  539. No multitasking:
  540. ----------------
  541.   If you need really high speed transfers
  542.   this option will disable all multitasking
  543.   within CoNnect and the system. To stop a
  544.   running transfer you'll have to press ^C.
  545.  
  546. Concerning transmission speed:
  547.   You will obtain good and high transmission
  548.   rates when you set a large io-buffer in 
  549.   the port dialog. A value of 8192 bytes
  550.   is a good choice.
  551.  
  552. §§_Transfer§
  553. §binary files§Binärdateien§
  554. §Michael Zieglers§Ziegler§
  555. §GSZRZACC§Ziegler§
  556. §paths§pathsel§
  557. §path§pathsel§
  558. §here§Zmodemparameter§
  559. §
  560. The File Transfer Dialog.
  561.  
  562. Here you make all the necessary settings for
  563. the transfer of binary files. You may either
  564. use CoNnect's internal Z-Modem or external
  565. programs like the famous GSZRZACC.
  566.  
  567. The internal Zmodem can be chosen when you 
  568. set the transfer program popup to XYZ-Modem(int.)
  569. Click here for the 'Internal Zmodem Parameters'.
  570.  
  571. If you are using the registrated version of
  572. Michael Ziegler's ZModem, which will be faster
  573. than the internal protocol you may put this
  574. ACC to your boot drive and CoNnect will start
  575. corresponding with it. Please read the 
  576. Zmodem instructions carefully and don't forget
  577. to put a $ as the last sending parameter in
  578. all external protocols. Chose GEMRZSZ.ACC in
  579. the transfer program popup and press the button
  580. Search Accessory.
  581.  
  582. Using an external XYZ-Modem you may choose
  583. XYZ-Modem (ext) and select the program
  584. paths of this protocol.
  585.  
  586. Standard parameters for several external 
  587. programs are:
  588.  
  589.   GEMSZRZ.GTP:
  590.     receive: -rz
  591.     send   : -sz $
  592.  
  593.   XYZ.TTP
  594.     receive:
  595.     send   : -u $
  596.  
  597.   SRZ:
  598.     receive:
  599.     send   : -a $
  600.  
  601. The $ sign is expanded to a fileselector box
  602. which opens when the Transfer is started. The
  603. file (with Selectric even several files) which
  604. you then select will replace the $ in the command
  605. line. 
  606.  
  607. If you activate the Z-Modem auto start Z-Modem
  608. reception will start automatically.
  609.  
  610. With SLOT you may setup up to 8 different proto-
  611. col settings which may be predefined and just
  612. selected when used for a special kind of transfer.
  613.  
  614. §§Binärdateien§
  615. §
  616. For the transfer of binary files so called
  617. transfer protocols are used to allow error
  618. free and/or fast transfers. Z-Modem is error 
  619. free and fast. Error free but not so fast
  620. is Kermit. Nearly error free but not fast at
  621. all is X-Modem. Without error checking
  622. and very fast is Y-Modem.
  623.  
  624. Normaly Z-Modem is the best choice if it's
  625. available.
  626.  
  627. §§Ziegler§
  628. §
  629. You'll get a highly recommended Z-Modem program
  630. for DM 30,- from
  631.  
  632. XENIA Software         XENIA Software
  633. Michael Ziegler        Michael Ziegler
  634. Jagdfeldring 16        Kreissparkasse Muenchen
  635. D-8013 Haar            BLZ 702 501 50
  636.                        Kto: 420354680
  637.  
  638. You may contact the author in the Maus-Net:
  639.    Michael_Ziegler@M
  640. (The internet supports a gateway using
  641. the domain @m.maus.de)
  642.  
  643. §§_Tabulator§
  644. §
  645. Tabulator
  646.  
  647. You may specify your own tabulator setup here.
  648. However it's a good idea to set the tab 
  649. distance to 8.
  650.  
  651. The other possible settings are:
  652.   left and right border in the ANSI-Emulation
  653.  
  654.   a margin bell (vt100)
  655.  
  656.   the scroll region. touch this only if you
  657.     know vt100 and if you know what you are
  658.     doing.
  659.  
  660. §§_Statuszeile§
  661. §
  662. The Status Line.
  663.  
  664. Below the terminal menu you may install the vt100
  665. status line. Do this by activating the check box
  666. on top of this dialog.
  667.  
  668. What you will see in this line is up to the other
  669. settings in this dialogue.
  670.  
  671. §§_Size§
  672. §holdscreen§holdscreen-aktiv§
  673. §
  674. Terminal Size
  675.  
  676. You may set the terminal size here (but remember
  677. most hosts want you to use an 80x24 display)
  678.  
  679. The buffer lines are lines for your history 
  680. scrollback buffer. If you want to scrollback
  681. it's highly recommended to activate holdscreen
  682. before, because otherwise CoNnect will always
  683. scroll to the bottom of the window if it receives
  684. new characters.
  685.  
  686. When you are using the fastscroll option you
  687. should install at least 50 buffer lines here
  688. and enable at least the vertical scrollbar.
  689.  
  690. Cursor coupling will keep track of the cursor
  691. and if it's outside the visible part of your
  692. window, the window will be scrolled to make
  693. the cursor visible again. For speed reasons
  694. this coupling is only done vertically.
  695.  
  696. §§holdscreen-aktiv§
  697. §
  698. Normally the function key F1 is set to holdscreen.
  699. Then - if you press F1 holdscreen gets active as
  700. long as F1 is not pressed again. (Active holdscreen
  701. will light the rightmost LED in the terminal window)
  702. This will allow you to scroll back in your history
  703. buffer without being disturbed by CoNnect's scrolling
  704. to the bottom when receiving new characters.
  705.  
  706. With the following trick you may install F1 as the
  707. holdscreen key in CoNnect.
  708.  
  709. Open the function key dialog. Set the text of
  710. F1 to 'holdscreen' (without the quotes!) and enable
  711. the left check box behind this entry.
  712. F1 will then toggle holdscreen status.
  713.  
  714. §§_Registrierung§
  715. §Shareware§Shareware§
  716. §manual§Handbuch§
  717. §programmer§Programmierer§
  718. §distributors§Wo Registrieren§
  719. §
  720. The Registration Dialog.
  721.  
  722. In this dialog you should enter your user data.
  723. (Name, Address, favorite Baseball player ;-)
  724.  
  725. At least your name should be placed here to
  726. allow CoNnect to create a unique user id for
  727. you. Entering your address will enable CoNnect
  728. to create a registration letter which is
  729. highly recommended as it will eliminate lots
  730. of possible registration problems.
  731.  
  732. If the programmer (that's me) has received 
  733. your registration fee AND the registration
  734. letter you'll get the key for an unlimited
  735. version and a printed manual.
  736.  
  737. The registration key has to be entered 
  738. in this dialog in one of the 6 possible slots.
  739. Six - because you'll need a special key for
  740. each TOS-Version you are using as the user id
  741. is dependent on this.
  742.  
  743. For some countries local distributors will
  744. handle your registration.
  745.  
  746. §§Programmierer§
  747. §distributors§Wo Registrieren§
  748. §
  749. You can access the programmer of CoNnect at
  750.  
  751.     Wolfgang Wander
  752.     Rudolf-Breitscheid-Str. 63a
  753.     D-22880 Wedel
  754.     Germany
  755.  
  756. or by email:
  757.  
  758.     Wolfgang Wander @ HH2  (Mausnet)
  759.     wwc@dxhra1.desy.de     (Internet)
  760.  
  761. the bank to send lots of money to:
  762.  
  763.     Wolfgang Wander
  764.     Konto-Nummer: 1373482932
  765.     Hamburger Sparkasse
  766.     Bankleitzahl: 20050550
  767.     
  768. If you are not living in Germany you might 
  769. find it convenient to contact the local 
  770. distributors.
  771.  
  772. §§_Port§
  773. §baud§Baudrate§
  774. §port§Port§
  775. §data and stopbits§Datenbit§
  776. §echo§Echo§
  777. §handshake§Handshake§
  778. §parity§Parität§
  779. §io-buffer§Schnittstellenpuffer§
  780. §
  781. Port parameters
  782.  
  783. here you can specify the port parameters.
  784.  
  785. Port parameters are: port, baud rate, 
  786. handshake, data and stopbits, parity
  787. and size of the io-buffer.
  788.  
  789. §§Handshake§
  790. §io-buffer§Schnittstellenpuffer§
  791. §
  792. Possible settings for handshake are:
  793. No handshake, rts/cts, xon/xoff.
  794.  
  795. Handshake is used between two computers (or
  796. a computer and a modem) to tell each other 
  797. that they are able to receive data or not.
  798. Without handshake lots of data would be lost,
  799. if the receiving computer is slower in taking
  800. the data then the other one sends it.
  801.  
  802. Without handshake (because your modem or
  803. host does not support it) you should
  804. try to install a large io-buffer.
  805.  
  806. The different forms of handshake are:
  807.  
  808.  ∙ software handshake: XON/XOFF
  809.    As soon as one of the partners is ready
  810.    to receive data it sends an XON (^Q). When
  811.    it wants to stop transmission it will send
  812.    an XOFF (^S).
  813.  
  814.  ∙ hardware handshake: RTS/CTS
  815.    is quite similar to the software
  816.    handshake. In contrast no characters are
  817.    sent only voltages on hard wired lines are
  818.    set. Hardware handshake will give you
  819.    better transmission speed.
  820.  
  821. It is important, that both sides use the same
  822. form of handshake. Otherwise the connection
  823. would be equivalent to no handshake at all
  824. or in the worst case, transmission will block.
  825.  
  826. §§Schnittstellenpuffer§
  827. §handshake§Handshake§
  828. §
  829. The size of the io-buffer can be set to
  830. values between 256 and 32767 bytes.
  831.  
  832. If your host or your modem supports handshake
  833. a value of 4096 or 8192 will be reasonable
  834. (for fast Z-Modem transfers).
  835.  
  836. Otherwise the largest value might still not
  837. be large enough. Set it to 32767 bytes.
  838.  
  839. §§Echo§
  840. §
  841. Possible settings for echo are:
  842.   echo on, echo off, local
  843.  
  844. Echo on: Every character, typed by you on the
  845.   keyboard will be send to the host and will also 
  846.   be displayed in the terminal window. If your host 
  847.   will have a built-in echo, your display will look 
  848.   like oohh  wwhhaatt  nniiccee  ddoouubbllee
  849.   cchhaarraacctteerrss. A better choice would
  850.   be echo off then.
  851.  
  852. Echo off: Working in mailboxes or on unix
  853.   computers this is the right choice. Typed
  854.   characters are sent to the host only and
  855.   the host is supposed to echo them. (if you
  856.   should see them).
  857.  
  858. Echo Local: Here no characters are sent to
  859.   the host. Everything you type will be
  860.   displayed on screen only.
  861.  
  862. §§Parität§
  863. §
  864. Possible settings for parity are:
  865.  no, even , odd.
  866.  
  867. No parity will neither send nor receive an
  868. additional parity bit.
  869.  
  870. If the sent character has a even number of
  871. set bits, the parity bit will be set/unset if
  872. even/odd parity is enabled and vice versa.
  873.  
  874. §§Datenbit§
  875. §parity§Parität§
  876. §
  877. Possible settings for databits are 5, 6, 7,
  878. or 8.
  879.  
  880. Each character sent consist of 1 start bit,
  881. a configurable number of data bits, an
  882. optional parity bit and a configurable 
  883. number
  884. of stop bits.
  885.  
  886. To send with 8 data bits, no parity and 1
  887. stop bit (which is default on most hosts) 10
  888. bits per character are sent.
  889.  
  890. §§Baudrate§
  891. §port§Port§
  892. §
  893. The baud rate is the number of bits which can
  894. be transmitted per second on the serial line
  895. of your atari.
  896.  
  897. On a simple ST you can specify the following
  898. rates:
  899.   19200, 9600, 4800, 3600, 2400, 2000, 1800,
  900.   1200, 600, 300, 200, 150, 134, 110, 75, 50
  901.  
  902. You may speed up you ST by a hardware
  903. enhancement (RS-Speed of Stephan Skrodzki or
  904. RSVE of Harun Scheutzow) to get 38400, 57600
  905. and 115200 bps. Those enhancers can install
  906. a cookie so that CoNnect knows of their
  907. existence and displays the right baudrates.
  908.  
  909. On a TT, a MegaSTE and on the Falcon030 you
  910. have some additional and high baudrates.
  911. -> port.
  912.  
  913. §§Port§
  914. §baudrate§Baudrate§
  915. §
  916. On all ATARI-Computers you can use the MIDI
  917. Port in addition to the normal serial ports.
  918. Transmission parameters on midi are fixed to
  919. 8N1 (8 Databits, No parity, 1 Stopbit), 
  920. No(!) handshake and 31250 baud.
  921.  
  922. On a Falcon you are able to select some
  923. higher rates also:
  924.  
  925.   153600, 125000, 115200, 83333, 76800, 62500,
  926.   57600, 50000, 38400, 31250
  927.  
  928. The Mega STE has 3 serial ports.
  929.  
  930. MODEM1 - is identical to the ST-Port
  931. MODEM2 - is identical to the Falcon port
  932. SERIEL2- has the following additional
  933.          baudrates: 125000, 115200, 83333,
  934.          62500, 57600, 38400, 31250 and
  935.          14400.
  936.  
  937. The MegaSTE's Ports have some  hardware defects
  938. by definition and only MODEM2 and MODEM1 can
  939. give satisfying results.
  940.  
  941. On a TT there are 4 serial ports.
  942.  
  943. MODEM1 - is identical to the ST-Port
  944. MODEM2 - Is similar to the Falcon port but not
  945.          able to do 57600 and 115200 baud.
  946. SERIEL1- is similar to the ST-Port but has less
  947.          lines and is therefore almost unusable.
  948. SERIEL2- Is identical to SERIAL2 on the MEGASTE,
  949.          but bug free. Has no Ring-Indicator.
  950.  
  951. Only if you are using a high speed modem the
  952. high baud rates will be of interest for you.
  953. The telebit worldblazer is able to receive
  954. and send at 115200 baud but this is quite
  955. hypothetical.
  956.  
  957. §§Scantabelle§
  958. §scantable§COSHYHLP\SCANTABLE§
  959. §character set§_Zeichensatz§
  960. §
  961. The Scantable
  962.  
  963. is a file with certain commands for connect
  964. how to handle any pressed key.
  965.  
  966. It can either be loaded in the dialog
  967. character set or by the coshy command scantable.
  968.  
  969. For example you can use the table to map some
  970. country specific keys ( the German umlaute )
  971. to its equivalent ae, ue, oe ...
  972. A Scantable example:
  973.  
  974. 'ä'  'ae'
  975. 'ö'  'oe'
  976. 'ü'  'ue'
  977. 'Ä'  'Ae'
  978. 'Ö'  'Oe'
  979. 'Ü'  'Ue'
  980. 'ß'  'ss'
  981.  
  982. The first row contains the pressed key, the
  983. second its replacement. ('' have to be used
  984. here).
  985.  
  986. You can also give an ASCII-Value for the
  987. pressed key. If you want to replace ^A you
  988. type: 
  989.  
  990. 1 'this' 32 'was' $20 'key' 0x20 '^A'
  991.  
  992. Note that the Space character may not be
  993. included in quotes ('') and has to be
  994. specified as 32.
  995.  
  996. Negative numbers in the first row refer to
  997. the (positive) Scancode number.
  998. You'll find a complete overview of the
  999. scancode in the Profibuch. (app. C)
  1000.  
  1001.  
  1002. By
  1003.  
  1004. -1 'Escape'
  1005.  
  1006. you'll get the String Escape when pressing 
  1007. Escape.
  1008.  
  1009. -72 0x1b '[B'
  1010.  
  1011. will send the vt100-Sequence Cursor Down when
  1012. you press cursor up. This is fun ;-)
  1013.  
  1014. An important application of this scantables
  1015. is the doorway-mode, where you can define
  1016. your ATARI sending DOS-Scancodes to allow
  1017. remote control of a PC running the DOORWAY
  1018. program.
  1019.  
  1020. Following the scancode entry, you may specify
  1021. a special SHIFT-State of your keyboard
  1022.  
  1023. Example
  1024.  
  1025.  -1 Sca 'escape shift'
  1026.  
  1027. will react on a pressed Escape key if the
  1028. Shift key is pressed but Control and
  1029. Alternate are unpressed.
  1030.  
  1031. s means Shift not pressed
  1032. S means Shift pressed
  1033. c means Control not pressed
  1034. C means Control pressed
  1035. a means Alternate not pressed
  1036. A means Alternate pressed
  1037.  
  1038. If this information is missing, the status of
  1039. the shift keys will not contribute to the
  1040. selection of replacements.
  1041.  
  1042. §§_Zeichensatz§
  1043. §manual§Handbuch§
  1044. §scan table§Scantabelle§
  1045. §
  1046. Character Set.
  1047.  
  1048. Character sets can be defined here. This may
  1049. either be the ATARI character set or the ISO
  1050. character set. The latter allows to choose 
  1051. between several different national replacement
  1052. character sets.
  1053.  
  1054. National special keys (the Umlaute) and the
  1055. way CoNnect sends them can be defined here.
  1056. This could also be done in the scan tables
  1057. but its easier this way.
  1058.  
  1059. The scan table is a file where you can
  1060. specify which characters shall be sent if a
  1061. certain key is pressed by the user.
  1062.  
  1063. A better description will be found in the manual. 
  1064. §§_Kompatibilität§
  1065. §
  1066. Compatibility.
  1067.  
  1068. As some hosts have problems with correct
  1069. vt100 emulations like CoNnect's one you may
  1070. use this dialog to reduce the vt100
  1071. correctness of CoNnect.
  1072.  
  1073. If there are problems with your host, play
  1074. around with this setup and search for
  1075. improvements.
  1076.  
  1077. §§_Funktionstasten§
  1078. §
  1079. Function keys
  1080.  
  1081. In this dialog you can setup up to 80
  1082. function keys (using combinations of SHIFT,
  1083. ALT and CONTROL).
  1084.  
  1085. Normally any text placed on a function key
  1086. will be sent to the host when the key is
  1087. pressed. By activating one of the two CoSHy
  1088. Buttons of a key you may place their CoSHy
  1089. Commands which will be executed when a key is
  1090. pressed. If the left button is on, the
  1091. command will be executed in the terminal
  1092. window, if the right button is on, the
  1093. command will be executed without windows.
  1094.  
  1095. §§_Darstellung§
  1096. §
  1097. Display:
  1098.  
  1099. In the 'font'-box you can specify the used
  1100. fonts for wide and small terminals.
  1101.  
  1102. CoNnect uses GDOS fonts but even without GDOS
  1103. you may use these fonts by just putting them
  1104. into the directory GEMSYS (in your CoNnect
  1105. directory). CoNnect will load this fonts at
  1106. startup time if no GDOS is installed.
  1107.  
  1108. Other options are: the cursor type, the kind
  1109. of scrolling (smooth scrolling is nice to
  1110. read scrolling texts but is very boring after
  1111. a while - it's so slow ;-), fast scrolling
  1112. is very fast and you can't read incoming
  1113. texts)
  1114.  
  1115. §§_Protokoll§
  1116. §
  1117. Capture.
  1118.  
  1119. Here you may specify the file for capturing
  1120. your online session. The filename may 
  1121. contain the following characters:
  1122.  
  1123.     %a short: day of week
  1124.     %b short: name of month
  1125.     %d day in month (1-31)
  1126.     %H hour (0-23)
  1127.     %I hour (0-12)
  1128.     %j day in year (1-366)
  1129.     %m month (1-12)
  1130.     %M minute (00-59)
  1131.     %p AM/PM
  1132.     %S second (00-59)
  1133.     %w day in week (0-6)
  1134.     %W week in year (0-52)
  1135.     %y short: year (0-99)
  1136.     %Y year (0-9999;-)
  1137.     %Z Timezone (eg. MEZ)
  1138.     %% the %-sign
  1139.  
  1140. You may also specify the way of capturing
  1141. (complete or ASCII-only) and may set a switch
  1142. that CoNnect will ask you at logoff what you
  1143. want to do with a captured file (distribute
  1144. after logoff).
  1145.  
  1146. §§_Emulation§
  1147. §
  1148. Emulations.
  1149.  
  1150. Here you may select the desired emulation.
  1151. CoNnect offers you vt52, vt100, vt102 and 
  1152. vt220.
  1153.  
  1154. For working in mailboxes vt102 can be
  1155. recommended. The other parameters are used to
  1156. define the meaning of backspace and delete
  1157. and the meaning of incoming and outgoing
  1158. linefeed. Normally these values need not
  1159. be changed.
  1160.  
  1161. §§_Asciiupload§
  1162. §manual§
  1163. §
  1164. With Ascii Upload you send an ascii-file
  1165. without any special protocol.
  1166.  
  1167. This is useful to enter short pretyped texts
  1168. into a mailbox editor.
  1169.  
  1170. Please don't get confused by the large number 
  1171. of options. Normally they don't need to be
  1172. changed. You'll find further explanation in
  1173. the manual.
  1174.  
  1175. §§_Statistik§
  1176. §
  1177. Charge Statistics
  1178.  
  1179. To keep track of your telephone charges
  1180. CoNnect keeps a logfile containing
  1181. information of the dialed-in box, the
  1182. duration of the connection and the money you
  1183. spent there. This dialog offers you a
  1184. comfortable way to create statistics out of
  1185. this logfile.
  1186.  
  1187. Play around with it.
  1188.  
  1189. §§_Lernen§
  1190. §
  1191. Learn a Script.
  1192.  
  1193. CoNnect is able to keep tack of the user
  1194. activity in a host and create a CoSHy script
  1195. which will repeat all the actions the user
  1196. performed.
  1197.  
  1198. This is especially useful when you want to
  1199. create automatic login scripts or automatic
  1200. poll scripts.
  1201.  
  1202. Here you can activate this learning mode and
  1203. select the actions connect shall keep track
  1204. of. 
  1205.  
  1206.  
  1207. §§_Teksetup§
  1208. §manual§Handbuch§
  1209. §
  1210.  
  1211. In the TEK-Setup dialog you can configure
  1212. your TEK 4014 emulation. As most mailboxes
  1213. don't offer this emulation just leave
  1214. everything as it is. Help concerning the
  1215. TEK-Mode can be found in the manual. Also
  1216. your system administrator (Machines that
  1217. offer Tek, normally have one ;-) will be able
  1218. to help you.
  1219.  
  1220. §§_Sound§
  1221. §
  1222. Sounds.
  1223.  
  1224. CoNnect has a built-in facility to cooperate
  1225. with the shareware product PAULA, which is
  1226. able to play so called MOD Files. You may
  1227. also specify other sound files - CoNnect will
  1228. try its best to play it itself.
  1229.  
  1230. Here you can setup the sound reaction of
  1231. CoNnect to certain system events. Just select
  1232. the appropriate files by double clicking on
  1233. the path entries for the events...
  1234.  
  1235. §§_Hotkeys§
  1236. §
  1237. Hotkeys.
  1238.  
  1239. Hotkeys normally are used to allow access to
  1240. menu items without selecting it by mouse but
  1241. just by pressing a key combination.
  1242.  
  1243. Here you can select a certain menu item and
  1244. press your desired hotkey for this item.
  1245.  
  1246. CoNnect's default hotkey table can be
  1247. activated by pressing the Default button.
  1248.  
  1249. §§_Farben§
  1250. §
  1251. Colors.
  1252.  
  1253. CoNnect uses the first 16 VDI-Colors and
  1254. assumes they are installed in the default
  1255. manner. If this is not true you may use this
  1256. dialog to create a connect internal color
  1257. table. 
  1258.  
  1259. §§_Anrufbeantworter§
  1260. §parameters§_Anrufparameter§
  1261. §manual§Handbuch§
  1262. §
  1263. The Answering Machine
  1264.  
  1265. This is the automatic answering machine of
  1266. CoNnect which enables you to use a ZyXEL
  1267. Modem as a private answering machine.
  1268. Using the CoSHy Script language you are able
  1269. to configure this machine to a more powerful
  1270. one than the best commercial hard wired ones
  1271. available. 
  1272.  
  1273. Pressing the parameters button you can
  1274. configure the answering machines setup.
  1275.  
  1276. Detailed information on the answering machine
  1277. can be obtained in the manual.
  1278.  
  1279. §§_Anrufparameter§
  1280. §manual§Handbuch§
  1281. §
  1282. Parameters for the answering machine.
  1283.  
  1284. Here you can configure the name of the
  1285. greeting message a caller gets. Also the path
  1286. for new messages which callers leave should
  1287. be setup here.
  1288.  
  1289. CoSHy commands that are activated when
  1290. certain types of calls come in can be
  1291. installed here.
  1292.  
  1293. Detailed information can be found in the
  1294. manual.
  1295.  
  1296. §§Fenster§
  1297. §window dialogs§Fensterdialoge§
  1298. §terminal windows§Terminalfenster§
  1299. §tektronix windows§Tektronixfenster§
  1300. §help windows§Onlinehilfe§
  1301. §window menus§Fenstermenü§
  1302. §misc§_Allgemeines§
  1303. §
  1304. CoNnect offers currently four different 
  1305. kinds of windows to the user. There are
  1306.  
  1307.  ∙ terminal windows
  1308.  ∙ tektronix windows
  1309.  ∙ help windows
  1310.  ∙ window dialogs
  1311.  
  1312. The first two types have another menu bar in 
  1313. their top region. These are so called window 
  1314. menus which allow user actions belonging to 
  1315. this certain window locally.
  1316.  
  1317. The user interface for window menus and 
  1318. window dialogs can be configured in the misc 
  1319. dialog.
  1320.  
  1321. §§Fensterdialoge§
  1322. §misc§_Allgemeines§
  1323. §sending§Paste§
  1324. §selected§Markieren§
  1325. §
  1326. Window Dialogs
  1327.  
  1328. CoNnect's window dialogs are an enhancement 
  1329. of the normal dialogs offered by the GEM 
  1330. since Atari has released their first ST-
  1331. Computers. The main difference is the fact, 
  1332. that window dialogs are placed in windows.
  1333.  
  1334. But there are some other advantages. They 
  1335. allow real multitasking under MultiTos or 
  1336. Mag!x even when dialogs are edited. The 
  1337. windows can be placed anywhere. The menu bar 
  1338. of CoNnect stays accessible even when a 
  1339. dialog is open. You may edit several dialogs 
  1340. at one time. This dialogs have some special 
  1341. object type, like popups, check- and radio-
  1342. buttons and hotkeys: you may press ALT+plus 
  1343. one of the underlined characters to select a 
  1344. button as if it was clicked-on by the mouse.
  1345.  
  1346. You may close the dialog by clicking on the 
  1347. window closer or pressing the UNDO key. This 
  1348. is equivalent to pressing the CANCEL Button 
  1349. - your changes will be lost.
  1350.  
  1351. Help can be obtained in any window dialog by 
  1352. simply pressing the HELP key. A new window 
  1353. will open to provide the needed information.
  1354.  
  1355. Using the sending mechanism of CoNnect you 
  1356. may paste selected text parts (or the 
  1357. contents of the GEM-clipboard - see misc) of 
  1358. the terminal window to edit fields of the 
  1359. dialog. This is useful if you want to enter 
  1360. new telephone numbers to the phone editor.
  1361.  
  1362. ASCII-Characters that cannot be accessed from
  1363. the keyboard may be entered using the ALT key 
  1364. and the numeric keypad. Press the 2 4 9 while 
  1365. pushing the ALT key down will give you a '∙'.
  1366.  
  1367. §§Emulation-Einf§
  1368. §emulation§_Emulation§
  1369. §
  1370. CoNnect emulates all incoming characters. 
  1371. i.e it scans the incoming datastream for 
  1372. special characters which will not be 
  1373. printable but give information about the 
  1374. display of the following printable 
  1375. characters. The data stream involves 
  1376. information on
  1377.  
  1378.   - in what size
  1379.   - in what color
  1380.   - where
  1381.   - ...
  1382.  
  1383. new characters will be displayed.
  1384.  
  1385. You may set the emulation mode to suit 
  1386. the command set (the emulation) of your 
  1387. host.
  1388.  
  1389. §§TastenVersenden§
  1390. §manual§Handbuch§
  1391. §CoSHy§CoSHy§
  1392. §type ahead buffer§_Vorschreibzeile§
  1393. §scan table§Scantabelle§
  1394. §function keys§_Funktionstasten§
  1395. §hotkey§_Hotkeys§
  1396. §
  1397. To send characters to the host, CoNnect 
  1398. offers many (too many) possibilities.
  1399.  
  1400. ∙ Pressing a normal key
  1401.    Letters, numbers, space- and special 
  1402.    characters will be sent without 
  1403.    translation to the host (if no scan table 
  1404.    is installed)
  1405.  
  1406. ∙ Pressing a key together with CONTROL:
  1407.    (if there is not hotkey for this 
  1408.    combination)
  1409.  
  1410.    ^ <space> sends   0
  1411.    ^A        sends   1
  1412.    ^B        sends   2
  1413.    ...
  1414.    ^Z        sends  26
  1415.    ^[        sends  27
  1416.    ^\        sends  28
  1417.    ^]        sends  29
  1418.    ^^        sends  30
  1419.    ^_        sends  31
  1420.  
  1421. ∙ Pressing a key together with ALTERNATE:
  1422.    (if there is not hotkey for this 
  1423.    combination)
  1424.  
  1425.    will send the corresponding character 
  1426.    with the highest bit set.
  1427.  
  1428.    ALT+A sends 193 ($C1)
  1429.  
  1430.    The numeric keypad has another meaning 
  1431.    in conjunction with ALTERNATE:
  1432.    The pressed numbers are combined to at 
  1433.    most 3 digits and their decimal ASCII 
  1434.    value is sent.
  1435.  
  1436.     ALT+131 (ALT stays press) sends
  1437.             â
  1438.  
  1439. ∙ Pressing of a function key:
  1440.    If you have entered a text for this key 
  1441.    in the function keys dialog and none of 
  1442.    the corresponding CoSHy-Buttons is set, 
  1443.    the corresponding text will be sent.
  1444.  
  1445. ∙ Pressing Backspace, Delete, UNDO, 
  1446.    Cursorkeys, Insert or Home.
  1447.    The corresponding vt100/vt52/vt220
  1448.    meaning will be sent (see manual).
  1449.  
  1450. ∙ Pressing CONTROL+INSERT:
  1451.    The type ahead buffer will show up to
  1452.    let you enter a line which will be sent 
  1453.    to the host.
  1454.  
  1455. With several CoSHy functions you may also 
  1456. send text and characters to the modem.
  1457.  
  1458. §§Terminalfenster§
  1459. §terminal menu§Menue-Term§
  1460. §main menu§Hauptmenü§
  1461. §emulation§Emulation-Einf§
  1462. §pressing keys§TastenVersenden§
  1463. §holdscreen§holdscreen-aktiv§
  1464. §select§Markieren§
  1465. §
  1466. Terminal window.
  1467.  
  1468. The terminal window is the user interface 
  1469. for the communication with the host. By 
  1470. pressing keys, these will be sent to the 
  1471. host and received characters from the host 
  1472. will be displayed according to the used 
  1473. emulation.
  1474.  
  1475. If you have enabled scrollbars and the 
  1476. history buffer you may use this scrollbars 
  1477. to read again text that has scrolled out of 
  1478. the current terminal window. (see also 
  1479. holdscreen)
  1480.  
  1481. With the terminal menu you can configure 
  1482. all terminal specific parameters of that 
  1483. specific window.
  1484.  
  1485. The main menu will be used to configure 
  1486. global settings of CoNnect.
  1487.  
  1488. A text in the terminal window can be 
  1489. manipulated in several ways. You should 
  1490. select the disired text region first.
  1491.  
  1492. §§Menue-Tek§
  1493. §manual§Handbuch§
  1494. §
  1495. The tektronix window menu is used for 
  1496. manipulating the displayed graphic. You may 
  1497. save these graphics, print them or chose 
  1498. another zoom factor. See the manual for more 
  1499. details.
  1500.  
  1501. If you are interested in the tektronix mode 
  1502. please be aware of the fact that nearly all 
  1503. software being able to create tektronix 
  1504. graphics is installed on workstations or 
  1505. main frames. If you have access to tektronix 
  1506. software please ask your system 
  1507. administrator for advice. She/He will be 
  1508. able to configure CoNnect for your hosts 
  1509. specific requests.
  1510.  
  1511. §§Tektronixfenster§
  1512. §tektronix menu§Menue-Tek§
  1513. §
  1514. Here you may open a tektronix 4014 window 
  1515. where your host can send you vector 
  1516. graphics and you may also create drawings 
  1517. with the mouse, if your host has the 
  1518. necessary software installed.
  1519.  
  1520. In the upper region of the tektronix 
  1521. window there is another menu, the 
  1522. tektronix menu.
  1523.  
  1524. Using the mouse you may zoom into the 
  1525. displayed graphics by selecting the 
  1526. desired part of the window. To get back to 
  1527. normal resolution use the menu item 
  1528. 'normal resolution'
  1529.  
  1530. §§Fenstermenü§
  1531. §main menue§Hauptmenü§
  1532. §terminal window§Menue-Term§
  1533. §tektronix window§Menue-Tek§
  1534. §
  1535. Window Menus.
  1536.  
  1537. Window menus are menus where you can 
  1538. configure local parameters belonging to a 
  1539. specific window. See terminal window, 
  1540. tektronix window.
  1541.  
  1542. In contrast to this, global parameters can be 
  1543. accessed in the main menu.
  1544.  
  1545. §§gl_Beenden§
  1546. §
  1547. Quit.
  1548.  
  1549. This function may cause the immediate exit 
  1550. from CoNnect. No warranty is given.
  1551. Be careful.
  1552.  
  1553. §§gl_Öffnen§
  1554. §terminal window§Terminalfenster§
  1555. §
  1556. Open.
  1557.  
  1558. Using this main menu item a new window is 
  1559. opened. If CONN0.SET is available the 
  1560. information in this file is used for the 
  1561. terminals setup. Otherwise default 
  1562. parameters are used.
  1563.  
  1564. §§gl_Rotieren§
  1565. §
  1566. Rotate.
  1567.  
  1568. Using the menu item rotate, the current 
  1569. window will become inactive and the next 
  1570. one in the window queue will be topped.
  1571.  
  1572. §§gl_Schließen§
  1573. §window dialog§Fensterdialoge§
  1574. §
  1575. Close.
  1576.  
  1577. The current window will be closed. If the 
  1578. current window is a window dialog changes 
  1579. made to its parameters will be lost.
  1580.  
  1581. This function is equivalent to clicking 
  1582. on the closer of the current window.
  1583.  
  1584. §§gl_Volle_Größe§
  1585. §
  1586. Full Size.
  1587.  
  1588. The current window will be set to full size or
  1589. if it's already at full size it will be reset
  1590. to its old size. This function is equivalent
  1591. to the FULLER button of the windows.
  1592.  
  1593. §§gl_Fensternamen§
  1594. §
  1595. Window names.
  1596.  
  1597. The names of the 10 last opened windows are
  1598. displayed here. Selecting an item will top
  1599. the corresponding window.
  1600.  
  1601. §§gl_Optionen§
  1602. §
  1603. Load Options / Save Options
  1604.  
  1605. All settings of the main menu as well as the
  1606. positions and setup files of the opened
  1607. terminal windows will be saved / loaded from
  1608. the OPTions file.
  1609.  
  1610. Starting CoNnect will normally cause it to
  1611. read the CONNECT.OPT file.
  1612.  
  1613. §§Hauptmenü§
  1614. §window menus§Fenstermenü§
  1615. §about CoNnect§_Info§
  1616. §Start a Shell§gl_Shellstart§
  1617. §Start a Program§Programmstart§
  1618. §Start CoSHy§gl_Coshystart§
  1619. §Start a Script§gl_Scriptstart§
  1620. §Quit§gl_Beenden§
  1621. §Open§gl_Öffnen§
  1622. §Rotate§gl_Rotieren§
  1623. §Close§gl_Schließen§
  1624. §Full Size§gl_Volle_Größe§
  1625. §Window Names§gl_Fensternamen§
  1626. §Registration§_Registrierung§
  1627. §Misc§_Allgemeines§
  1628. §Hotkeys§_Hotkeys§
  1629. §Colors§_Farben§
  1630. §Charge Statistics§_Statistik§
  1631. §Sound§_Sound§
  1632. §Load Options§gl_Optionen§
  1633. §Save Options§gl_Optionen§
  1634. §Help§General§
  1635. §
  1636. The Main Menu
  1637.  
  1638. The main menu in CoNnect is the standard
  1639. GEM menu bar. Global settings and global
  1640. information can be accessed there.
  1641.  
  1642. Local parameters of windows can be accessed
  1643. in the corresponding window menus.
  1644.  
  1645. In the main menu you will find the following
  1646. items.
  1647.  
  1648.  ∙ CoNnect
  1649.       ° about CoNnect
  1650.  
  1651.  ∙ File
  1652.       ° Start a Shell
  1653.       ° Start a Program
  1654.       ° Start CoSHy
  1655.       ° Start a Script
  1656.       --------------
  1657.       ° Quit
  1658.  
  1659.  ∙ Windows
  1660.       ° Open
  1661.       ° Close
  1662.       ° Rotate
  1663.       ° Full Size
  1664.       --------------
  1665.       ° 'Window Names'
  1666.         ...
  1667.  
  1668.  ∙ Options
  1669.       ° Registration
  1670.       ° Misc
  1671.       ° Hotkeys
  1672.       ° Colors
  1673.       ° Charge Statistics
  1674.       ° Sound
  1675.       --------------
  1676.       ° Load Options
  1677.       ° Save Options
  1678.  
  1679.  ∙ HELP
  1680.       ° Help
  1681.  
  1682. §§gl_Coshystart§
  1683. §CoSHy§CoSHy§
  1684. §
  1685. CoNnect's internal Shell can only be
  1686. started on the so called TOS-Screen (i.e.
  1687. without windows) when running a single
  1688. tasking TOS. If you are running Mag!X or
  1689. Multitos, this feature is disabled.
  1690.  
  1691. The user will be able to enter commands to
  1692. CoSHys commandline and CoNnect will try to
  1693. execute them. To exit type exit+RETURN on 
  1694. the command line.
  1695.  
  1696. §§gl_Scriptstart§
  1697. §CoSHy§CoSHy§
  1698. §
  1699. CoNnect's internal Shell can only be
  1700. started on the so called TOS-Screen (i.e.
  1701. without windows) when running a single
  1702. tasking TOS. If you are running Mag!X or
  1703. MTOS this item will be disabled.
  1704.  
  1705. Before starting a script CoNnect will open a
  1706. fileselector to let you chose the script
  1707. file.
  1708.  
  1709. §§Programmstart§
  1710. §
  1711. To start an external program this menu item
  1712. will open a fileselector where the user is
  1713. able to select the program she/he wants to
  1714. start.
  1715.  
  1716. After the started program has exited you can
  1717. continue working in CoNnect.
  1718.  
  1719. §§gl_Shellstart§
  1720. §manual§Handbuch§
  1721. §
  1722. Starting a TOS Shell out of the main menu.
  1723.  
  1724. CoNnect tries to start a program that has
  1725. been installed as a shell. (Either by using
  1726. the _shell_p pointer or the environment
  1727. variable SHELL).
  1728.  
  1729. If no shell is installed nothing will
  1730. happen.
  1731.  
  1732. Normally the Shell will be started with all
  1733. CoNnect windows closed on the TOS-Screen.
  1734.  
  1735. Under MTOS CoNnect will ask TOSRUN to start
  1736. the shell.
  1737.  
  1738. (If this help was no help to you due to the
  1739. hundreds of misspelled computer words, you
  1740. will probably find the manual more helpful, 
  1741. it has less spelling mistakes.) 
  1742.  
  1743. §§Handbuch§
  1744. §
  1745. Every registrated CoNnect user will receive a
  1746. printed manual automatically. Normally this
  1747. won't take more than 4 days (in Germany)
  1748. after the money has arrived. Due to problems
  1749. with the printing and new versions of CoNnect
  1750. this may take longer than even 8 weeks.
  1751. Please be patient. We won't forget you. Mail
  1752. us to make sure that we haven't forgot you
  1753. after about 4 weeks.
  1754.  
  1755. If you are using an older manual, because you
  1756. are a long term CoNnect user, you can obtain
  1757. an newer version at 
  1758.  
  1759. Philipp Oelwein
  1760. Ringelsgasse 22a
  1761. 69226 Nußloch
  1762.  
  1763. Email:
  1764. Philipp Oelwein @ LU                
  1765. (MausNet)
  1766. op@uphys1.uphysn.uni-heidelberg.de  
  1767. (Internet)
  1768.  
  1769. The current price is DM 25,- plus postage and 
  1770. packing.
  1771.  
  1772. §§Onlinehilfe§
  1773. §example§Online-Fett§
  1774. §window§Fenster§
  1775. §selecting§Markieren§
  1776. §
  1777. In this window you can find help for the
  1778. handling of help windows
  1779.  
  1780. The online help can be activated by simply
  1781. pressing the HELP button whenever (nearly
  1782. always) you think a little help could be
  1783. useful. CoNnect's help is context sensitive.
  1784. It will always provide the information you
  1785. need at the moment (when working in a certain
  1786. dialog, in the terminal window or on the
  1787. command line of CoSHy). There is a difference
  1788. between pressing the HELP key and activating
  1789. help in the main menu. The former one is the
  1790. context sensitive help whereas the latter
  1791. will always give you the help home page.
  1792.  
  1793. In the help text you get in the help windows
  1794. there may be some underlined phrases or words
  1795. written in bold phrases where you can follow 
  1796. the 'links' by double-clicking on them. Try 
  1797. this now with this example.
  1798.  
  1799. Another useful feature is selecting of help
  1800. texts. Get information on this item by
  1801. double-clicking the highlighted word above.
  1802.  
  1803. You may either use the mouse to follow the
  1804. links in the help window or use the keyboard
  1805. to get around.
  1806.  
  1807. The following keys have a special meaning in
  1808. CoNnect's help window:
  1809.  
  1810.    TAB
  1811.       Moves the cursor to the next help item. 
  1812.    RETURN or HELP
  1813.       will open a help item if the cursor is
  1814.       currently positioned on one.
  1815.    UNDO
  1816.       Will go back to the previous help
  1817.       window, or - if there was non - close
  1818.       the current help window.
  1819.    -------------------------------------
  1820.    Cursor keys
  1821.       Will move the cursor in the standard
  1822.       manner. 
  1823.    SHIFT Cursor left or right
  1824.       Will move to the beginning or end of
  1825.       the current line.
  1826.    CONTROL Cursor left or right
  1827.       Will move the the previous or next word
  1828.       of the help text.
  1829.    SHIFT Cursor up or down
  1830.       Will move the cursor one page up or
  1831.       down. 
  1832.    HOME
  1833.       Will move the cursor to the first line.
  1834.    SHIFT HOME
  1835.       Will move the cursor to the last line.
  1836.  
  1837. §§Markieren§
  1838. §send§Paste§
  1839. §misc§_Allgemeines§
  1840. §quote§quoten§
  1841. §;-)§smiley§
  1842. §
  1843. In the text window of CoNnect, i.e. the
  1844. terminal window or the help window, you can
  1845. select parts of the text using the mouse. You
  1846. also may want to send the selections to the
  1847. host, quote it or ask the printer to print 
  1848. it.
  1849.  
  1850. All this is possible in CoNnect, but you
  1851. might need to teach your fingers how to do 
  1852. it.
  1853.  
  1854.  ∙ Selecting character by character
  1855.     Move the mouse pointer to the beginning
  1856.     of the text part you want to select. Then
  1857.     press down the left button and don't lift it
  1858.     again. Now move the mouse pointer, while
  1859.     keeping the left button pressed to the
  1860.     end of the text you want to select. To
  1861.     finish selection, you now may lift the
  1862.     mouse button again.
  1863.  ∙ Selecting word by word
  1864.     Move the mouse pointer to the word, where
  1865.     you want to start selecting. Now do a
  1866.     double click - or a single click (while
  1867.     pressing the CONTROL key) and keep the
  1868.     mouse button pressed. Now moving the
  1869.     mouse pointer while keeping the mouse
  1870.     button pressed will select text word by
  1871.     word. 
  1872.  ∙ Selecting line by line
  1873.     Is similiar to the word-by-word selection.
  1874.     Just do a triple click (very fast) or
  1875.     keep the ALTERNATE key pressed while
  1876.     performing the first click and continue
  1877.     as described above.
  1878.  
  1879. To extend a marked portion of text, you may
  1880. press the SHIFT key while clicking into the
  1881. terminal window. The marked part of the text
  1882. will be extended up to the clicked-on 
  1883. position.
  1884.     
  1885. Now having selected a portion of text, you
  1886. may send this text in a certain window
  1887. (either a window dialog or a terminal window)
  1888. by 'just' clicking in this window with the
  1889. left button, while pressing the right button
  1890. down.
  1891.  
  1892. If you are using the GEM-Clipboard for
  1893. selecting (see the misc dialog) you may also
  1894. use your selections in other applications or
  1895. may send the clipboards contents filled by
  1896. other applications to the host.
  1897.  
  1898. Extended functions, like sending, quoting,
  1899. file saving, printing, etc. are available if
  1900. you (ATTENTION) press the right mouse button
  1901. down before lifting the left button to end
  1902. the selection. Then lift the left button and
  1903. afterwards the right. A little exercise for
  1904. your fingers ;-)
  1905.  
  1906. §§Paste§
  1907. §
  1908. Sending of selected text parts.
  1909.  
  1910. Having selected a portion of text, you
  1911. may send this text in a certain window
  1912. (either a window dialog or a terminal window)
  1913. by 'just' clicking in this window with the
  1914. left button, while pressing the right button
  1915. down.
  1916.  
  1917. §§quoten§
  1918. §selected§Markieren§
  1919. §
  1920. Quoting
  1921.  
  1922. Quoting means sending a selected text to the
  1923. host with the slight change, that every new
  1924. line starts with an > sign.
  1925.  
  1926. Quoting is normally used when answering mails. 
  1927.  
  1928. For example:
  1929.  
  1930.    > Do you know the current version number
  1931.    > of CoNnect?
  1932.  
  1933.    Sure. But when you will get this letter
  1934.    this information will be void.
  1935.  
  1936. §§Mike§
  1937. §
  1938. If you are in North America, it might be more 
  1939. convenient if you send shareware payments to:
  1940.  
  1941.      Michael Baffoni
  1942.      2493 Beechwood Dr.
  1943.      Paso Robles, CA
  1944.      93446
  1945.  
  1946. who will then send along the payments to me 
  1947. (checks or cashiers' cheque preferred; make 
  1948. them out to Michael Baffoni).
  1949.  
  1950. §§Solutions§
  1951. §
  1952. If you live in Great Britain you should 
  1953. contact
  1954.  
  1955.     System Solutions
  1956.     Windsor Business Centre
  1957.     Vansittart Estate
  1958.     Windsor Berks SL4 1SE
  1959.     Tel. 0753 832212
  1960.     Fax  0753 830344
  1961.  
  1962. for your registration.
  1963.  
  1964. §§Wo Registrieren§
  1965. §Michael Baffoni§Mike§
  1966. §System Solutions§Solutions§
  1967. §author§Programmierer§
  1968. §
  1969. The number of local CoNnect distributors 
  1970. all over the world is increasing rapidly.
  1971. As there have been none last year, now
  1972. there are two (an increase of more than
  1973. 1000% ;-).
  1974.  
  1975. For Northern America contact 
  1976.        Michael Baffoni
  1977.        
  1978. For Great Britain contact
  1979.        System Solutions
  1980.        
  1981. Otherwise you should contact the author
  1982. of CoNnect.
  1983.        
  1984. (A distributor for New Sealand and 
  1985.  Australia is on his way to there ,-)
  1986.  
  1987. §§_Info§
  1988. §country§Wo Registrieren§
  1989. §US§Mike§
  1990. §Great Britain§Solutions§
  1991. §registrations§_Registrierung§
  1992. §shareware§Shareware§
  1993. §
  1994.  
  1995. The info window of CoNnect provides
  1996. information about the program CoNnect and its
  1997. software status (CoNnect is shareware!), it
  1998. also will show the non-registrated user a
  1999. wonderful nice looking bar to show him
  2000. elapsed testing time.
  2001.  
  2002. If you want to register for CoNnect you
  2003. should open the registrations dialog.
  2004.  
  2005. To get information where to register check
  2006. for your country here. Local distributors
  2007. are available in the US and Great Britain.
  2008.  
  2009. §§Lächeln§
  2010. §;-)§Smiley§
  2011. §
  2012.  
  2013. CoNnect does not smile at the moment. You
  2014. will see this by looking at byte 0x11341
  2015. relative to the basepage. This byte should
  2016. contain 0x00 when connect is smiling ;-)
  2017.  
  2018. §§Witz§
  2019. §author§Programmierer§
  2020. §;-)§Smiley§
  2021. §
  2022. Adam in paradise. He walks around and seems
  2023. to be a little unhappy. The lord recognizes
  2024. this and asks him:
  2025.  
  2026.    Hi Ad, what's up? Seems to be not your
  2027.    best day...
  2028.  
  2029. Adam, quite annoyed answers:
  2030.  
  2031.    You! You can talk nonsense like this. You
  2032.    don't have to bother about the daily
  2033.    boring work like cleaning the clothes,
  2034.    cooking, dishes, cleaning the paradise,
  2035.    brushing your tooth, feeding the cat and
  2036.    the crocodile. All this is done by your
  2037.    angels. But me? I'm not that happy with
  2038.    this status...
  2039.  
  2040. The lord, always having been a kind of
  2041. bargainer:
  2042.  
  2043.    Let's see. I think I could help you and
  2044.    give you someone to help you with all this
  2045.    jobs and who will give you love and
  2046.    warmth. But this will certainly be not for
  2047.    free. 
  2048.  
  2049. Adam, who is suddenly very interested in a
  2050. good relationship to his lord:
  2051.  
  2052.    How much! ?
  2053.  
  2054. The lord:
  2055.  
  2056.    Not that much. Two legs and two arms only.
  2057.  
  2058. Adam, shocked:
  2059.  
  2060.    No no no! Thats too much. But - what could
  2061.    I get for one rib, only?
  2062.  
  2063. -----------------------------------------------
  2064. OK. CoNnect excuses itself since it only has 5 
  2065. female users. They are hereby asked to send a 
  2066. nasty joke about men to the author and he will 
  2067. then add this one to the next release of 
  2068. CoNnect. :-)
  2069.  
  2070. §§Erinnerungshilfe§
  2071. §gentle smile§Lächeln§
  2072. §joke§Witz§
  2073. §
  2074. Remember.
  2075.  
  2076. This text is intended to remind the user about
  2077. something. 
  2078.  
  2079. I just don't know. Let me think.
  2080.  
  2081. Just a second ...
  2082.  
  2083. Right! Always remember that telecommunication
  2084. is a non-humorous thing. No one would ever
  2085. think of making jokes. Some
  2086. telecommunications programs even react in a
  2087. very harmful manner to jokes made about or
  2088. with them.
  2089.  
  2090. Once a user of a concurrent program tried to
  2091. fool his system by telling a joke in French.
  2092. He didn't know the system was able to under-
  2093. stand French - they still haven't found
  2094. him - well, all of him that is.
  2095.  
  2096. CoNnect nevertheless will try to react with a
  2097. gentle smile on jokes made by you, if and only
  2098. if it doesn't know the joke so far and if its
  2099. humor index is above 0.0001%. But be aware of
  2100. the fact, that computers have another kind of
  2101. humor than humans have.
  2102.  
  2103. §§Shareware§
  2104. §police§Polizei§
  2105. §author§Programmierer§
  2106. §to remember§Erinnerungshilfe§
  2107. §user§Anwender§
  2108. §manual§Handbuch§
  2109. §where to register§Wo Registrieren§
  2110. §
  2111. CoNnect is shareware, which means you may
  2112. test and distribute the program but have to
  2113. register after a certain amount of testing
  2114. time. CoNnect and the author agree on the
  2115. fact that 30 hours of using CoNnect is enough
  2116. to make the user dependent on CoNnect and so
  2117. you should think about registering quickly.
  2118. After the 30 hours the work with CoNnect will
  2119. be not that easy any more if you didn't
  2120. register.
  2121.  
  2122. For the user's benefit CoNnect disables some
  2123. of its functions. Otherwise there might be
  2124. the danger that the user will work for 2
  2125. years with an illegal copy of CoNnect and
  2126. will then notice it. He then would go the the
  2127. police and would want to go to jail - this is
  2128. avoidable. CoNnect helps you to remember the
  2129. shareware status, which most users think to
  2130. be one of the best features of the program 
  2131. ;-).
  2132.  
  2133. The registration fee is DM 60,- for
  2134. non-commercial use and DM 150,- for
  2135. commercial use. On multiuser systems (like
  2136. Universities, etc.) a multiuser license for
  2137. DM 399,- is due. For this fee you'll
  2138. receive a printed manual and a registration
  2139. key to make your CoNnect a registrated and
  2140. unlimited version.
  2141.  
  2142. How do you know, if you need a commercial
  2143. version or not? Thats quite easy. If you are
  2144. using CoNnect with the aim to make any kind
  2145. of profit for yourself or your company you
  2146. will need a commercial registration (the
  2147. profit made by the telephone company from
  2148. CoNnect's use is of course excluded). The
  2149. author of CoNnect himself has a commercial
  2150. registration, too.
  2151.  
  2152. If you are using a non-commercial
  2153. registration you should check, if the above
  2154. lines now apply to you. In this case you have
  2155. to upgrade to a commercial one.
  2156.  
  2157. If you live in Northern America or in Great
  2158. Britain you will find information on
  2159. where to register here.
  2160.  
  2161. §§Anwender§
  2162. §;-)§Smiley§
  2163. §
  2164.  
  2165. The user is the one sitting in front of this
  2166. help text at the moment. This will be in most
  2167. instances you. Some users don't even know
  2168. they are users and this text is intended to
  2169. help them to get several problems solved with
  2170. their lifes and with their user-status.
  2171. Only those users who really are aware of
  2172. their user status will be able to pay for
  2173. CoNnect - so remember - YOU ARE A USER ;-)
  2174.  
  2175. §§Smiley§
  2176. §
  2177.  
  2178. Wow. You just found a smiley in the help
  2179. text. Congratulations, this was the first
  2180. time, a user has found this item.
  2181.  
  2182. To look at smileys (and frownies) you have to
  2183. turn your head 90 degrees left:
  2184.  
  2185.   :-)  a smiling smiley
  2186.   :-(  a frowning frowny
  2187.   :'-( a frowny with tears in his eyes
  2188.   ;-)  a sarcastic smiley
  2189.      ...
  2190.  
  2191. §§Polizei§
  2192. §green dot§Grünen§
  2193. §
  2194. Police:
  2195.  
  2196. Men and women with more or less nice
  2197. uniforms, sometimes without uniforms but 
  2198. never (!) without clothes (as this is illegal 
  2199. in most parts of the world, even where its 
  2200. not illegal a police officer will never be 
  2201. seen without clothes). Usually they drive 
  2202. around in nice and fast cars and have much fun
  2203. in making criminals angry. In Germany 
  2204. licemen wear green uniforms but without a 
  2205. green dot on them.
  2206.  
  2207. §§Grünen§
  2208. §
  2209. The green dot.
  2210.  
  2211. CoNnect's cover is totally recyclable.
  2212. It consists of 80% recycled bits and 90%
  2213. pizza. So, you may put a green dot on
  2214. CoNnect. 
  2215.  
  2216. As the green dot is a German-only joke
  2217. you are not supposed to understand this
  2218. help page ;-)
  2219.  
  2220. §§_Misc§
  2221. §CoSHy§CoSHy-Allg§
  2222. §terminal windows§Term-Allg§
  2223. §window dialogs§Fens-Allg§
  2224. §GEM-clipboard§Klemm-Allg§
  2225. §
  2226. The Misc Dialog.
  2227.  
  2228. In this dialog you can set global parameters
  2229. concerning the terminal windows, window
  2230. dialogs the GEM-clipboard and the CoSHy.
  2231.  
  2232. §§CoSHy-Allg§
  2233. §selected§pathsel§
  2234. §manual§Handbuch§
  2235. §
  2236. Parameters concerning the CoSHy in the misc 
  2237. dialog.
  2238.  
  2239.   ∙ The CoSHy start-up file (normally
  2240.     coshy.rc) can be selected here
  2241.    
  2242.   ∙ The start-up directory can also be
  2243.     selected. (see the manual for further
  2244.     information)
  2245.     
  2246. §§Term-Allg§
  2247. §
  2248. Parameters concerning the terminal windows in
  2249. the misc dialog.
  2250.  
  2251. Here you can determine, if text windows are
  2252. always placed on by 8 divideable horizontal
  2253. position of the screen (this will speed up
  2254. display if you don't own NVDI). You may also
  2255. configure the window menus to be either
  2256. atari-like drop-down or mac-like pull-down.
  2257.  
  2258. §§Fens-Allg§
  2259. §
  2260. Parameters concerning window dialogs in the
  2261. misc dialog. 
  2262.  
  2263. You can configure if dialogs open in the
  2264. center of the screen, at the last position or
  2265. centered according to the current mouse
  2266. position. 
  2267.  
  2268. Frames around certain elements of the dialogs
  2269. do almost have titles. You may specify here
  2270. how you want them to look like.
  2271.  
  2272. In a common GEM-Dialog, RETURN and ENTER are
  2273. used to leave the dialog like clicking on the
  2274. default button. CoNnect may also use this key 
  2275. like in an editor to jump to the next dialog
  2276. text input field.
  2277.  
  2278. Finally you can select the background pattern
  2279. and color. But be aware of the fact, that an
  2280. arbitrary color will look like white when no
  2281. pattern is selected ;-)
  2282.  
  2283. §§Klemm-Allg§
  2284. §select§Markieren§
  2285. §paste§Paste§
  2286. §
  2287. Parameters concerning the GEM-clipboard in
  2288. the misc dialog.
  2289.  
  2290. You can specify here if all selected texts
  2291. will automaticly be placed in the
  2292. GEM-clipboard and if the clipboard will be
  2293. read if you try to paste a text to the host.
  2294.  
  2295. §§pathsel§
  2296. §
  2297. Input of pathnames and filenames:
  2298.  
  2299. In all dialogs where CoNnect wants to have a
  2300. filename in an editable input field you may
  2301. double-click on this line to use the
  2302. fileselector for searching and selecting the
  2303. lines content.
  2304.  
  2305.  
  2306. §§Online-Fett§
  2307. §
  2308.  
  2309. Now you are reading the text page for
  2310. highlighted text. This test page does not
  2311. provide any useful information (only spelling
  2312. mistakes), so leave it by pressing the UNDO
  2313. key. 
  2314.  
  2315. §§CoSHy§
  2316. §about this help§COSHYHLP\ABOUTME§
  2317. §general usage§COSHYHLP\A§
  2318. §searching errors§COSHYHLP\DEBUG§
  2319. §meta characters§COSHYHLP\METAS§
  2320. §words§COSHYHLP\WORTE§
  2321. §command delimiters§COSHYHLP\KMDTR§
  2322. §input/output redirection§COSHYHLP\IOREDIR§
  2323. §quotes§COSHYHLP\QUOTES§
  2324. §actions on a commandline§COSHYHLP\INPWORK§
  2325. §misc§COSHYHLP\OVERALL§
  2326. §[ expression ]§COSHYHLP\AUSDRUCK§
  2327. §§ ...§COSHYHLP\TRUE§
  2328. §! ...§COSHYHLP\NOT§
  2329. §. ...§COSHYHLP\SCRIPT§
  2330. §alert§COSHYHLP\ALERT§
  2331. §alias§COSHYHLP\ALIAS§
  2332. §baud§COSHYHLP\BAUD§
  2333. §bell§COSHYHLP\BELL§
  2334. §blitmode§COSHYHLP\BLITMODE§
  2335. §break§COSHYHLP\BREAK§
  2336. §cd§COSHYHLP\CD§
  2337. §carrier§COSHYHLP\CARRIER§
  2338. §ctty§COSHYHLP\CTTY§
  2339. §dial§COSHYHLP\DIAL§
  2340. §download§COSHYHLP\DOWNLOAD§
  2341. §echo§COSHYHLP\ECHO§
  2342. §env§COSHYHLP\ENV§
  2343. §eval§COSHYHLP\EVAL§
  2344. §exit§COSHYHLP\EXIT§
  2345. §expr§COSHYHLP\EXPR§
  2346. §false§COSHYHLP\FALSE§
  2347. §fileselect§COSHYHLP\FILESEL§
  2348. §fky§COSHYHLP\FKY§
  2349. §flush§COSHYHLP\FLUSH§
  2350. §for§COSHYHLP\FOR§
  2351. §function§COSHYHLP\FUNCTION§
  2352. §get§COSHYHLP\GET§
  2353. §getkey§COSHYHLP\GETKEY§
  2354. §gettone§COSHYHLP\GETTONE§
  2355. §hangup§COSHYHLP\HANGUP§
  2356. §holdscreen§COSHYHLP\HOLDSCRN§
  2357. §if§COSHYHLP\IF§
  2358. §log§COSHYHLP\LOG§
  2359. §noise§COSHYHLP\NOISE§
  2360. §play§COSHYHLP\PLAY§
  2361. §prot§COSHYHLP\PROT§
  2362. §quit§COSHYHLP\QUIT§
  2363. §read§COSHYHLP\READ§
  2364. §readkey§COSHYHLP\READKEY§
  2365. §record§COSHYHLP\RECORD§
  2366. §redraw§COSHYHLP\REDRAW§
  2367. §savebuf§COSHYHLP\SAVEBUF§
  2368. §scantable§COSHYHLP\SCANTABLE§
  2369. §send§COSHYHLP\SEND§
  2370. §sendbreak§COSHYHLP\SENDBREA§
  2371. §set§COSHYHLP\SET§
  2372. §setenv§COSHYHLP\SETENV§
  2373. §shift§COSHYHLP\SHIFT§
  2374. §sleep§COSHYHLP\SLEEP§
  2375. §slot§COSHYHLP\SLOT§
  2376. §test§COSHYHLP\TEST§
  2377. §true§COSHYHLP\TRUE1§
  2378. §unalias§COSHYHLP\UNALIAS§
  2379. §unset§COSHYHLP\UNSET§
  2380. §upload§COSHYHLP\UPLOAD§
  2381. §version§COSHYHLP\VERSION§
  2382. §waitfor§COSHYHLP\WAITFOR§
  2383. §while§COSHYHLP\WHILE§
  2384. §
  2385. CoSHy
  2386.  
  2387. you get into CoSHy either by activating the
  2388. interactive mode (the menu items CoSHy) or
  2389. by activating the script mode where CoSHy
  2390. will start to run a script file.
  2391.  
  2392. This help mainly shall be helpful for you in
  2393. creating scripts. The largest part of this
  2394. help consists of the description of the
  2395. several available internal commands. To get
  2396. an overview on CoSHy it will be either a good
  2397. idea to look into the manual but also some
  2398. unix shell programming experience will help
  2399. you a lot. CoSHy is a unix like shell
  2400. environment. 
  2401.  
  2402.  
  2403. 0.0 about this help
  2404.  
  2405. 1.1 general usage
  2406.  
  2407.  1.1.1 meta characters
  2408.  1.1.2 words
  2409.  1.1.3 command delimiters
  2410.  1.1.4 input/output redirection
  2411.  1.1.5 quotes
  2412.  1.1.6 searching errors
  2413.  
  2414. 1.2 actions on a commandline
  2415.  
  2416. 1.3 overview on the commands
  2417.  
  2418.   1.3.1 misc
  2419.   1.3.2 CoSHy commands
  2420.  
  2421.    [ expression ]
  2422.    § ...
  2423.    ! ...
  2424.    . ...
  2425.    alert
  2426.    alias
  2427.    baud
  2428.    bell
  2429.    blitmode
  2430.    break
  2431.    cd
  2432.    carrier
  2433.    ctty
  2434.    dial
  2435.    download
  2436.    echo
  2437.    env
  2438.    eval
  2439.    exit
  2440.    expr
  2441.    false
  2442.    fileselect
  2443.    fky
  2444.    flush
  2445.    for
  2446.    function
  2447.    get
  2448.    getkey
  2449.    gettone
  2450.    hangup
  2451.    holdscreen
  2452.    if
  2453.    log
  2454.    noise
  2455.    play
  2456.    prot
  2457.    quit
  2458.    read
  2459.    readkey
  2460.    record
  2461.    redraw
  2462.    savebuf
  2463.    scantable
  2464.    send
  2465.    sendbreak
  2466.    set
  2467.    setenv
  2468.    shift
  2469.    sleep
  2470.    slot
  2471.    test
  2472.    true
  2473.    unalias
  2474.    unset
  2475.    upload
  2476.    version
  2477.    waitfor
  2478.    while
  2479.  
  2480. §§COSHYHLP\A§
  2481. §quote§COSHYHLP\QUOTES§
  2482. §meta characters§COSHYHLP\METAS§
  2483. §
  2484. 1.1  general usage
  2485.  
  2486. After starting CoSHy in interactive mode you
  2487. will get a command line where you can enter
  2488. commands in the command language of CoSHy.
  2489. In addition to CoSHy internal commands you
  2490. may want to use external tools:
  2491. Starting of external programs is quite easy:
  2492. just type their names (paths) and append
  2493. parameters delimited by spaces. If you are
  2494. using the environment variable PATH CoSHy
  2495. will evaluate its content to search for
  2496. external programs.
  2497.  
  2498. If you want an unix like environment it's
  2499. recommended to install the tools like, ls,
  2500. echo, cat, mkdir, cp ... on your binaries
  2501. directory and set a PATH pointer to this
  2502. directory. 
  2503.  
  2504. Attention. In contrast to TOS pathname
  2505. delimiter is not the \ but the /. If your
  2506. external programs need \ in their arguments,
  2507. you'll have to quote the \.
  2508.  
  2509. CoShy is able to do the widely used TAB
  2510. expansion. The first word on a command line
  2511. is tried to be expanded as a command. The
  2512. PATH variable is searched for matching
  2513. executables.
  2514. For example type lha <TAB> and if you have an
  2515. lharc.ttp installed on your system and PATH
  2516. points to it you'll get lharc. If there are
  2517. several possible expansions CoSHy will expand
  2518. up to the first difference in the names.
  2519. Lets say you have printenv and printall on
  2520. your system and type in pri<TAB> you'll get
  2521. print<BEEP>. A second <TAB> will then show
  2522. you all possible expansions in the next line:
  2523. printall printenv
  2524.  
  2525. If you try to expand a parameter to a
  2526. command, CoSHy will do this in the same way,
  2527. but not search in PATH and not for
  2528. executables only but all files.
  2529.  
  2530. Next chapter:
  2531.  
  2532.  1.1.1 meta characters
  2533.  
  2534. §§COSHYHLP\ABOUTME§
  2535. §general usage§COSHYHLP\A§
  2536. §
  2537. 0.0 About this help
  2538.  
  2539. The help text to COSHY have been made by
  2540. Stephan Skrodzki and me, the author of CoNnect
  2541. and (bad) translator of the help texts, wants
  2542. to thank him a lot for his work. 
  2543.  
  2544. If you didn't understand his German (see in the
  2545. German online help texts) , you may
  2546. at least want to thank him for his work. His
  2547. internet mail adress is
  2548.  
  2549.    stephan_skrodzki@ka.maus.de
  2550.  
  2551. next chapter:
  2552.  
  2553.    1.1 general usage
  2554.  
  2555. §§COSHYHLP\ALERT§
  2556. §
  2557.   alert <defaultbutton> <alertstring>
  2558.  
  2559. displays a GEM - alert box. The parameters are
  2560. the parameters of the gem function form_alert.
  2561.  
  2562. §§COSHYHLP\ALIAS§
  2563. §
  2564.   alias cmd replace
  2565.  
  2566. will replace <cmd> in all commands beginning
  2567. with <cmd> by <replace>.
  2568.  
  2569.  alias cmd
  2570.   or
  2571.  unalias cmd
  2572.  
  2573. will delete an defined alias.
  2574.  
  2575. example:
  2576.  
  2577.  alias l 'ls -l'
  2578.  
  2579.   will execute an ls -l if l is entered to
  2580.   the command line.
  2581.  
  2582. §§COSHYHLP\AUSDRUCK§
  2583. §test§COSHYHLP\TEST§
  2584. §
  2585.   [ expression ]
  2586.  
  2587. The expression is evaluated like in the test
  2588. command. In fact coshy will replace this
  2589. construction by
  2590.  
  2591.   test expression.
  2592.  
  2593. example:
  2594.  
  2595. [ $v -gt $w ]  test if the value of $v is
  2596.                higher than the value of $w.
  2597.                The return code will be 0 for
  2598.                true or not 0 for false.
  2599.  
  2600. §§COSHYHLP\BAUD§
  2601. §port dialog§_Port§
  2602. §
  2603.   baud [rate] [options]
  2604.  
  2605. will display the current baud rate. 
  2606.  
  2607. if rate is given the current port will be set
  2608. to this rate.
  2609.  
  2610. options:
  2611.  
  2612.  echo   : Echo on
  2613.  noecho : Echo off
  2614.  local  : Echo local
  2615.  
  2616.  rts    : rts/cts  Hardware-Handshake
  2617.  xon    : xon/xoff Software-Handshake
  2618.  none   : no Handshake
  2619.  
  2620.  8N1    : 8 data bits, no
  2621.           parity, 1 stop bit
  2622.  7E1    : 7 data bits, even
  2623.           parity, 1 stop bit
  2624.  6O2    : 6 data bits, odd
  2625.           parity, 2 stop bits
  2626.  5N3    : 5 data bits, no
  2627.           parity, 1.5 stop bits
  2628.  
  2629.           etc...
  2630.  
  2631. example:
  2632.  
  2633.  baud 38400     will set the rate to 38400
  2634.                 baud.
  2635.  
  2636.  
  2637. see also:
  2638.     port dialog
  2639.  
  2640. §§COSHYHLP\BELL§
  2641. §sound dialog§_Sound§
  2642. §noise§COSHYHLP\NOISE§
  2643. §
  2644.   bell n
  2645.  
  2646. will create very beautiful sounds ;-)
  2647.  
  2648. the following values for n are available
  2649.  
  2650.  1  : Bing               2  : Bang
  2651.  3  : Crash              4  : Ring
  2652.  5  : Call               6  : Accord
  2653.  
  2654. Why? To tease your cat or to let you know if
  2655. a transmission has finished or a script is
  2656. now waiting for user input or ...
  2657.  
  2658. example:
  2659.  
  2660.  bell 3    makes  crash   ;-)
  2661.  
  2662. See also: noise, sound dialog
  2663.  
  2664. §§COSHYHLP\BLITMODE§
  2665. §
  2666.   blitmode [option]
  2667.  
  2668. displays the current blitter status
  2669.  
  2670.  y  - Blitter is on
  2671.  n  - Blitter is off
  2672.  u  - Blitter is unavailable
  2673.  
  2674. Options:
  2675.  
  2676.  y    switches the blitter on
  2677.  n    switches the blitter off.
  2678.  
  2679.  
  2680. §§COSHYHLP\BREAK§
  2681. §
  2682.   break n
  2683.  
  2684. Will break out of n nested if, for or while
  2685. structures. If n is omitted n will be set to
  2686. 1.
  2687.  
  2688.  
  2689. example:
  2690.  
  2691.  if [expr1]; then      
  2692.   if [expr2]; then     
  2693.    cmd1                
  2694.   else                 
  2695.    cmd2                
  2696.    break 2             
  2697.   fi                   
  2698.    cmd3                
  2699.  fi                   
  2700.  
  2701. A break level of 2 is needed because both
  2702. if structure shall be left.
  2703.  
  2704. §§COSHYHLP\CARRIER§
  2705. §
  2706.   carrier
  2707.  
  2708. returns 0 (true) if the modems sends the
  2709. carrier signal, 1 (false) otherwise.
  2710.  
  2711. example:
  2712.  
  2713.  if carrier; then
  2714.   hangup            
  2715.  fi
  2716.  
  2717. hangup, if there is a carrier.    
  2718.  
  2719. §§COSHYHLP\CD§
  2720. §$CDPATH§Environment§
  2721. §$HOME§Environment§
  2722. §
  2723.   cd path
  2724.  
  2725. Change the current directory to path. The
  2726. variable $HOME is the default dir.  The
  2727. variable $CDPATH defines the search path for
  2728. the directory containing dir. Alternative
  2729. directory names are separated by a comma or a
  2730. semicolon.
  2731.  
  2732. If dir begins with a slash (/), then $CDPATH
  2733. is not used. The variable $OLDPWD is set to
  2734. the name of the current working directory
  2735. before the change.
  2736.  
  2737. example:
  2738.  
  2739.  cd connect   changes to the directory
  2740.               connect 
  2741.  
  2742. §§COSHYHLP\CTTY§
  2743. §emulation dialog§_Emulation§
  2744. §character set dialog§_Zeichensatz§
  2745. §compatibility dialog§_Kompatibilität§
  2746. §
  2747.   ctty [options]
  2748.  
  2749. changes several terminal parameters
  2750.  
  2751. options:
  2752.  
  2753.  vt52
  2754.  vt100
  2755.  vt102
  2756.  vt220-7  switches to the corresponding
  2757.  vt200-8  terminal emulation.
  2758.  
  2759.  vt52id
  2760.  vt100id
  2761.  vt101id
  2762.  vt102id
  2763.  vt220id  the same for the terminal id.
  2764.  
  2765.  cursnum  normal cursor keys
  2766.  cursappl application cursor keys
  2767.           
  2768.  keypadnum  numeric keypad
  2769.  keypadappl application keypad
  2770.  
  2771.  crlflf  incoming <lf>s are expanded to
  2772.          <cr><lf> 
  2773.  lflf    no expansion of <lf>
  2774.  
  2775.  crcrlf  outgoing <cr>s are expanded to
  2776.          <cr><lf> 
  2777.  crcr    no expansion of <cr>
  2778.  
  2779.  bsdel   del (delete) will be sent
  2780.          as bs (backspace) and bs
  2781.          will be sent as del.
  2782.  bsbs    bs and del have their original
  2783.          meaning.
  2784.  
  2785.  atari   atari character set and 'umlaute'
  2786.  iso     iso character set and 'umlaute'
  2787.  
  2788.  autowrap   auto wrap is active
  2789.  -autowrap  auto wrap is diabled
  2790.  
  2791.  smooth     use smooth scrolling
  2792.  -smooth    use fast scrolling
  2793.  
  2794.  colour     display ansi colors
  2795.  -colour    don't use ansi colors
  2796.  
  2797.  strip8     strip the highest bit
  2798.  -strip8    use all 8 bits.
  2799.  
  2800.  destructive   destructive backspace
  2801.  -destructive  normal backspace
  2802.  
  2803. see also: emulation dialog,
  2804.           character set dialog,
  2805.           compatibility dialog
  2806.  
  2807. §§COSHYHLP\DIAL§
  2808. §time format§COSHYHLP\TIMEFORM§
  2809. §dialing dialog§_Wahl§
  2810. §
  2811.   dial [opt] number
  2812.  
  2813. Dials a given phone number. Normally this
  2814. will be a text (the text of a phonebook
  2815. entry in the dialing dialog). If there is no
  2816. matching text, the number is dialed as it is
  2817. (containing all symbols in it).
  2818. Take care: If the text in the phonebook entry
  2819. contains spaces, you should put the <number>
  2820. argument in quotes ' '. You may also just
  2821. give the first few letters of the telephone
  2822. book entry. CoSHy searches for matching 
  2823. ones.
  2824.  
  2825. options:
  2826.  
  2827.  -z seq    <seq> becomes the reset string
  2828.  -r n      <n> is the number of tries CoSHy
  2829.            will do to get a carrier. n=0
  2830.            is used for infinite tries.
  2831.  -s tim    <tim> is the time between conse-
  2832.            cutive tries (time format)
  2833.  -i ini    <ini> becomes the init string
  2834.  -d dia    <dia> becomes the dial string
  2835.  -v        Verbose
  2836.  -n        will display the real number for
  2837.            a given phonebook entry. But will
  2838.            not dial.
  2839.  
  2840.  number    either phonebook entry or real
  2841.            number.
  2842.  
  2843.  
  2844. returns:
  2845.  
  2846.  0  Connect
  2847.  3  Busy
  2848.  4  reserved
  2849.  5  No Carrier
  2850.  6  No Answer
  2851.  7  No Dialtone
  2852.  8  Error
  2853.  9  Ring
  2854.  10 Userdef
  2855.  11 Timeout
  2856.  
  2857. example:
  2858.  
  2859.  dial -s 10s -r 5 0623760897
  2860.  
  2861. see also: dialing dialog
  2862.  
  2863. §§COSHYHLP\DOWNLOAD§
  2864. §transfer§_Transfer§
  2865. §
  2866.   download [-p path]  [filename]
  2867.  
  2868. A file will be received with the options 
  2869. set up in the transfer dialog. A filename 
  2870. may be given if you want to override the 
  2871. incoming files filename or if you are 
  2872. using a protocol where the filename itself 
  2873. is not transmitted (like Xmodem). The 
  2874. option -p path is used to specify a 
  2875. certain path where the incoming file 
  2876. should be placed.
  2877.  
  2878. example:
  2879.  
  2880.  download -p 'f:\dfue\'
  2881.  
  2882. §§COSHYHLP\ECHO§
  2883. §
  2884.   echo [-n] arg1 ...
  2885.  
  2886. Will write all its arguments separated by 
  2887. spaces to standard out. If -n is omitted a 
  2888. linefeed is appended.
  2889.  
  2890. example:
  2891.  
  2892.  echo "hallo"
  2893.  
  2894. §§COSHYHLP\ENV§
  2895. §environment§Environment§
  2896. §setenv§COSHYHLP\SETENV§
  2897. §
  2898.   env  [arg1 ...]
  2899.  
  2900. Without arguments the environment 
  2901. variables will be displayed. If arguments 
  2902. are given, env is equivalent to setenv.
  2903.  
  2904. §§COSHYHLP\EVAL§
  2905. §
  2906.   eval  command
  2907.  
  2908. will execute the given command in coshy 
  2909. and will NOT stop the execution of a 
  2910. running script, if an error in execution 
  2911. of command should occur.
  2912.  
  2913. Using eval you may write a 'remote' script 
  2914. to run on your computer and you may dial 
  2915. in from outside to work on coshy's 
  2916. commandline.
  2917.  
  2918. example:
  2919.  
  2920.  while true; do
  2921.    while true; do
  2922.      send 'Remote Script'
  2923.      send -n 'please enter password :'
  2924.      get -n pass
  2925.      if [ $pass = 'joshua' ]; then
  2926.        break 2
  2927.      fi
  2928.    done
  2929.    while true; do
  2930.      send -n 'Your Input >'
  2931.      get a;
  2932.      if ! carrier; then
  2933.        break 2
  2934.      fi
  2935.      echo "$a";
  2936.      eval "$a" > AUX:
  2937.    done
  2938.  done
  2939.  
  2940. §§COSHYHLP\EXIT§
  2941. §
  2942.   exit n
  2943.  
  2944. The current shell level is left. Shell 
  2945. level might also be script files which 
  2946. execution will be stopped if an exit is 
  2947. executed. The return value of the source or 
  2948. . command, that executed the script will 
  2949. be n or 0 if n is omitted
  2950.  
  2951. §§COSHYHLP\SCANTABLE§
  2952. §scan table§Scantabelle§
  2953. §
  2954.   scantable [filename]
  2955.  
  2956. will read in and execute a scan table file 
  2957. if filename if given. Else a loaded scan 
  2958. table will be deleted.
  2959.  
  2960. §§COSHYHLP\EXPR§
  2961. §
  2962.   expr  expression
  2963.  
  2964. will evaluate an expression and put the 
  2965. result to standard out. If you put the 
  2966. command in $( ) or in ` ` (backquotes)  
  2967. you may use the result to fill other 
  2968. variables (see example below). The 
  2969. return value of expr is true (0) if the 
  2970. result is not 0 and false (1) if the 
  2971. result is 0 or the expression contains 
  2972. errors.
  2973.  
  2974. Each part of expression has to be a single
  2975. argument.
  2976.  
  2977. There are the following operations (in 
  2978. order of hierachy)
  2979.  
  2980. | or: the result is the result of its first 
  2981.     argument if this is not zero. Otherwise 
  2982.     and only otherwise the second argument 
  2983.     is evaluated and the result of the 
  2984.     expression is set to the one of the 
  2985.     second argument.
  2986.  
  2987. & and: the result is the result of its first 
  2988.     argument if this is zero. Otherwise and 
  2989.     only otherwise the second argument is 
  2990.     evaluated and the result of the 
  2991.     expression is set to the one of the 
  2992.     second argument.
  2993.  
  2994. < <= != => > compare its arguments and 
  2995.    return 1 if the relation is true, 0 
  2996.    otherwise (don't mix this up with the 
  2997.    shell value for true(0) and false(1))
  2998.  
  2999.    If the arguments are non-numeric the 
  3000.    comparison is done for alphabetical 
  3001.    order.
  3002.  
  3003. + - plus and minus: both arguments have to 
  3004.    be numeric. The result is the result of 
  3005.    the corresponding numeric operation.
  3006.  
  3007. *  /  % time, divide by and mod: Both 
  3008.    arguments have to be numeric and the 
  3009.    result is again the result of the 
  3010.    corresponding numeric operation.
  3011.  
  3012. In all operations brackets may be used to 
  3013. change operators hierachy. Take care to 
  3014. quote them correctly as  ( ) are shell 
  3015. symbols also.
  3016.  
  3017. expr:
  3018.  
  3019.  expr \( 3 + 2 \) \* 2
  3020.              writes 10 to stdout.
  3021.  
  3022.  `expr 3 + 2`
  3023.              will replace the result of 
  3024.              the expression ` ... ` by 5 
  3025.              and trys to execute the 
  3026.              command 5. This normally will 
  3027.              fail ,-)
  3028.  
  3029.  a=`expr 3 + 2`
  3030.     or
  3031.  a=$(expr 3 + 2)
  3032.              a will be set to the value of 5.
  3033.  
  3034.  a=$(expr $a + 1)
  3035.              A will be increased by 1.
  3036.  
  3037.  b=`expr \($a +1 \) \* $a`
  3038.              b will be set to the value of 
  3039.              (a+1)*a
  3040.  
  3041. §§COSHYHLP\FALSE§
  3042. §true§COSHYHLP\TRUE§
  3043. §
  3044.   false
  3045.  
  3046. Will return false (1) as return value. It's 
  3047. equivalent to
  3048.   ! true
  3049.  
  3050. example:
  3051.  
  3052.  false
  3053.  echo $?
  3054.  
  3055. §§COSHYHLP\FILESEL§
  3056. §
  3057.   fileselect <pfad> <default name>
  3058.            <extension> <message>
  3059.  
  3060. Calls the gem file selector.
  3061. Return value is true(0), if the user has 
  3062. pressed OK to leave the selector. The 
  3063. chosen filename will be found in the 
  3064. variable $FILESELECT
  3065.  
  3066. §§COSHYHLP\FKY§
  3067. §function key dialog§_Funktionstasten§
  3068. §
  3069.   fky [opt] num [value]
  3070.  
  3071. Displays or sets function keys.
  3072.  
  3073. Options:
  3074.  
  3075.  -c CoSHy script key (the left coshy button)
  3076.  -n CoSHy script key (the right coshy button)
  3077.  -o Will display the old content to stdout.
  3078.  
  3079. if value is given, the specified key will 
  3080. be set to the value. num is the same as 
  3081. in the function key dialog.
  3082.  
  3083. example:
  3084.  
  3085.  send `fky -o 1`
  3086.     Sends the contents of function key F1.
  3087.  
  3088. §§COSHYHLP\FLUSH§
  3089. §
  3090.   flush
  3091.  
  3092. Will remove all pending characters in the 
  3093. io-buffer of the serial/midi device.
  3094.  
  3095. §§COSHYHLP\FOR§
  3096. §
  3097.   for  name in list;
  3098.     do cmd1; cmd2; ...
  3099.   done
  3100.  
  3101. for every word in list the value of $name 
  3102. is set to this word and the commands cmd1, 
  3103. cmd2, ... between do and done are executed.
  3104.  
  3105. example:
  3106.  
  3107.  for a in 1 2 3 4 5 6 7 8 9
  3108.   do
  3109.    echo $a
  3110.   done
  3111.  
  3112.  will display the numbers 1 to 9.
  3113.  
  3114. §§COSHYHLP\FUNCTION§
  3115. §
  3116.   function name { commands }
  3117.  
  3118. defines a function named name. The 
  3119. commands will be executed always when name 
  3120. is executed. Arguments to name may be 
  3121. given and will be found in $1, $2 ...
  3122.  
  3123. example:
  3124.  
  3125.  function doubleecho {
  3126.                       echo $1 ;
  3127.                       echo $1
  3128.  }
  3129.  
  3130.  doubleecho HALLO
  3131.  
  3132.   will result in
  3133.  
  3134.   HALLO
  3135.   HALLO
  3136.  
  3137. function name
  3138.  
  3139.  deletes the function named name.
  3140.  
  3141. function
  3142.  
  3143.  will display all defined functions.
  3144.  
  3145. §§COSHYHLP\GET§
  3146. §read§COSHYHLP\READ§
  3147. §waitfor§COSHYHLP\WAITFOR§
  3148. §eval§COSHYHLP\EVAL§
  3149. §time format§COSHYHLP\TIMEFORM§
  3150. §
  3151.   get <opt> <timoutval> <var1> <var2> ..
  3152.  
  3153. Equivalent to the read command. The input 
  3154. is not typed in on the keyboard but is 
  3155. taken from the serial port. There you will 
  3156. have the possibility to get input from the 
  3157. host (or remote) side. (See example to the
  3158. eval command).
  3159.  
  3160. The first parameter may be -n which will 
  3161. force get not to send an echo of the typed 
  3162. in text (useful for password inputs).
  3163.  
  3164. With -v (verbose) the typed in text will 
  3165. be displayed in CoNnect's terminal window.
  3166.  
  3167. A numerical value <timeoutval> may follow 
  3168. to limit the user's response time. If a 
  3169. timeout occurs get will result in false 
  3170. (1). (see time format)
  3171.  
  3172. The variables var1, var2,... will be 
  3173. filled like in read.
  3174.  
  3175. §§COSHYHLP\GETKEY§
  3176. §(time format)§COSHYHLP\TIMEFORM§
  3177. §
  3178.   getkey [-n] [-v] [timeout]  var1
  3179.                          [ var2 ...   ]
  3180.  
  3181. will read as many characters from the 
  3182. serial port as variables (var1 ...) are 
  3183. given. If -v is set, this characters will 
  3184. be displayed on CoNnect's screen. If -n is 
  3185. set this characters are not echoed to the 
  3186. remote side.
  3187.  
  3188. A given timeout value will cause getkey to 
  3189. return false if the remote user did not 
  3190. enter the disired number of keys in the 
  3191. time timeout val. (time format)
  3192.  
  3193. §§COSHYHLP\GETTONE§
  3194. §answering machine§_Anrufbeantworter§
  3195. §
  3196.   gettone <timeoutval> <var>
  3197.  
  3198. Reads in a touchtone sequence while being 
  3199. in the answering machine mode. The 
  3200. sequence has to be ended by # by the user.
  3201.  
  3202. see answering machine.
  3203.  
  3204. §§COSHYHLP\HANGUP§
  3205. §dialing dialog§_Wahl§
  3206. §item hangup§T\HANGUP§
  3207. §
  3208.   hangup
  3209.  
  3210. Will force the modem to hangup. How this 
  3211. is done has to be specified by the user in 
  3212. the dialing dialog.
  3213.  
  3214. example:
  3215.  
  3216.  if carrier; then
  3217.   hangup
  3218.  fi
  3219.  
  3220. hangup is equivalent to the terminal menu 
  3221. item hangup.
  3222.  
  3223. §§COSHYHLP\HOLDSCRN§
  3224. §function key§holdscreen-aktiv§
  3225. §
  3226.   holdscreen [parameters]
  3227.  
  3228. toggles - if no parameters are given - 
  3229. between holdscreen on and off. Watch the 
  3230. holdscreen LED in the terminal menu.
  3231.  
  3232. Set on the function key F1, F1 will 
  3233. satisfy the vt100/220 standard.
  3234.  
  3235. Possible parameters are 1 ot activate 
  3236. holdscreen or 0 to deactivate it.
  3237.  
  3238. §§COSHYHLP\IF§
  3239. §
  3240.   if  cmd1; cmd2; ...; then
  3241.     cmd3; ...;
  3242.   [else
  3243.     cmd4; ...;]
  3244.   fi
  3245.  
  3246. the commands between if and then are 
  3247. executed, where the return value of the 
  3248. last command is important for the further 
  3249. proceeding. If this is true(0) the 
  3250. commands between then and else (or fi if 
  3251. else is omitted) will be executed. If it 
  3252. is false(1) the commands between else and
  3253. fi are executed. (The else branch may be 
  3254. omitted.)
  3255.  
  3256. example:
  3257.  
  3258.  if cmd1;  then    if the return value of
  3259.   echo "Yeah! ;-)" cmd1 is 0, a message of
  3260.  else              success is printed.
  3261.    echo "shit ;-(" if not the script won't
  3262.  fi                be happy.
  3263.  
  3264. §§COSHYHLP\INPWORK§
  3265. §expr§COSHYHLP\EXPR§
  3266. §overview of the commands§COSHYHLP\OVERALL§
  3267. §
  3268. 1.2  Actions on a commandline
  3269.  
  3270. Each commandline evaluated by CoSHy 
  3271. undergoes a special sequence of steps.
  3272.  
  3273.  * Separation in words
  3274.  * Bracket expansion
  3275.  * Parameter and variable substitution
  3276.  * Command substitution
  3277.  * Arithmetic substitution
  3278.  * Separation in words (again)
  3279.  * Path expansion
  3280.  * Quote removal
  3281.  
  3282. A more detailed description follows below:
  3283.  
  3284.  Separation in words.
  3285.  
  3286. words are consequent characters which are 
  3287. separated by non quoted meta characters. As 
  3288. long as a command is not completely read in, 
  3289. CoSHy will read the next line or prompt the 
  3290. user to input another line.
  3291.  
  3292. example:
  3293.  
  3294.  ls -l /usr  consist of 3 words 'ls', '-l' 
  3295.              and '/usr'
  3296.  
  3297. Bracket expansion
  3298.  
  3299. Each word of a complete command will be 
  3300. searched for pairs of brackets {}. Single
  3301. non-quoted { will not be tolerated on a 
  3302. command line.
  3303.  
  3304. Those words then will consist of prefix, 
  3305. bracket and postfix.
  3306.  
  3307. example:
  3308.  
  3309.  abc{defgh,ij}klmno
  3310.  
  3311.  abc                  is prefix
  3312.     {defgh,ij}        is bracket
  3313.               klmno   is postfix
  3314.  
  3315. The words in brackets are separated by 
  3316. commas and for all of this words z1 to zn 
  3317. all words
  3318.  
  3319.   prefix'z1'postfix
  3320.   prefix'z2'postfix
  3321.          :
  3322.   prefix'zn'postfix
  3323.  
  3324. will be generated and inserted in the 
  3325. commandline instead of the bracket 
  3326. expression.
  3327.  
  3328. example:
  3329.  
  3330.  bla{bli,blo}bla  will produce the words
  3331.                   blablibla  and
  3332.                   blablobla.
  3333.  
  3334.  {Britta,Sonya}' and '{Pet{er,ra}}
  3335.  
  3336.  will be:  Britta and Peter
  3337.            Britta and Petra
  3338.            Sonya and Peter
  3339.            Sonya and Petra
  3340.  
  3341. Parameter and variable substitutions
  3342.  
  3343. Each word will be searched for $name or 
  3344. ${name}. If name is a shell variable, its 
  3345. content will be replaced for $name or 
  3346. ${name}. Else this expression will be 
  3347. deleted.
  3348.  
  3349. The second form is used to separate name 
  3350. from possibly following characters: $names 
  3351. won't bring the wanted results, whereas 
  3352. ${name}s does. ${n} will also allow larger 
  3353. numbers than 9 for n.
  3354.  
  3355. Special CoSHy variables
  3356.  
  3357.  $n    where n is a value between 0 and 9
  3358.     or
  3359.  ${n}  where n is a value between 0 and 
  3360.        32767.
  3361.        is the n-th parameter given to a 
  3362.        function or a script. $0 is the 
  3363.        name of the function or the script. 
  3364.  
  3365.  $#    Number of parameters given to a 
  3366.        function or a script.
  3367.  $?    Status/Return value of the last 
  3368.        called process/command.
  3369.  
  3370. Command substitution.
  3371.  
  3372. Each word is searched for $(cmd) or 
  3373. `cmd`.The command cmd is executed and its 
  3374. output will replace the above expressions. 
  3375. $()expressions may be nested, `` expressions 
  3376. not.
  3377.  
  3378. example:
  3379.  
  3380.  editor $(grep -l double *.c)
  3381.  
  3382.   calls an editor with the parameters 
  3383.   being all .C-Files containing the word 
  3384.   double. (grep is an external file 
  3385.   utility).
  3386.  
  3387.  a=$(expr $a + 1)
  3388.  
  3389.   increments the value of a by one.
  3390.  
  3391. Arithmetic substitution.
  3392.  
  3393. Each word is searched for $[ expression ]. 
  3394. expression is passed to the expr command 
  3395. and its output will replace the 
  3396. $[ expression ].
  3397.  
  3398. example:
  3399.  
  3400.  a=$[ $a + 1 ]  is equivalent to
  3401.  
  3402.  a=$(expr $a + 1) and increments a by one.
  3403.  
  3404. Separation words (again)
  3405.  
  3406.  
  3407. All new inserted text parts are subject to 
  3408. an additional separation into words.
  3409.  
  3410. example:
  3411.  
  3412.   a='ls -l /usr'  contains only one word.
  3413.  
  3414.   $a              will consist of 3 words 
  3415.                   after this step.
  3416.  
  3417. Path expansion
  3418.  
  3419.   Valid filenames containing wildcard 
  3420.   characters will be expanded
  3421.  
  3422.  *.c          expands to all .C filenames in 
  3423.               the current directory.
  3424.  *o*          expands to all filenames 
  3425.               containing the letter o in the
  3426.               current directory.
  3427.  *[ch]        expands to all filenames that
  3428.               end with c or h in the current
  3429.               directory.
  3430.  [a-d]*       expands to all files that start
  3431.               with a, b, c or d in the 
  3432.               current directory.
  3433.  [^a-d]*      expands to all files that 
  3434.               don't start with a, b, c, 
  3435.               and d in the current 
  3436. directory.
  3437.  /*/*.c       expands to all .C filenames 
  3438.               one directory level away from 
  3439.               the root directory of the 
  3440.               current drive.
  3441.  *a*/*b*/*c*  ;-) just a joke but working:
  3442.               Expands to all filenames 
  3443.               that are 2 levels above the 
  3444.               current working directory, 
  3445.               where the first directory 
  3446.               name has the letter a in it, 
  3447.               the second has the letter b 
  3448.               in it and the filename 
  3449.               contains a c.
  3450.  
  3451. Next chapter:
  3452.  
  3453.  1.3 overview of the commands
  3454.  
  3455. §§COSHYHLP\IOREDIR§
  3456. §quotes§COSHYHLP\QUOTES§
  3457. §
  3458. 1.1.4 input output redirection
  3459.  
  3460.  cmd   < file  the command cmd will get its
  3461.                input from the file 'file' 
  3462.                and not from the keyboard.
  3463.  cmd   > file  the command cmd writes its 
  3464.                output to file. The 
  3465.                previous contents of a 
  3466.                possibly existing file file 
  3467.                will be lost.
  3468.  cmd   >> file the command cmd appends its
  3469.                output to file.
  3470.  
  3471. Next chapter:
  3472.  
  3473.  1.1.5. quotes
  3474.  
  3475. §§COSHYHLP\KMDTR§
  3476. §input / output redirection§COSHYHLP\IOREDIR§
  3477. §
  3478. 1.1.3 Command separators
  3479.  
  3480. The following characters do separate 
  3481. commands if they are not quoted.
  3482.  
  3483. Character:  Meaning:
  3484.  
  3485.  ;          normal
  3486.  <newline>  normal
  3487.  &          like  ;  (no backgroundtasks,
  3488.             sorry)
  3489.  |          PIPE.  example
  3490.                cmd1    |   cmd2.
  3491.             the output of cmd1 will become
  3492.             the input of cmd2. Return value
  3493.             is the one of cmd2
  3494.  &&         AND. example
  3495.               cmd1 && cmd2
  3496.             cmd2 is executed if and only 
  3497.             if cmd1 has a return value 
  3498.             of true (0). Returns false(1) or 
  3499.             the return code of cmd2.
  3500.  ||         OR. example:
  3501.               cmd1   || cmd2.
  3502.             cmd2 is executed if and only 
  3503.             if cmd1 has a return value of 
  3504.             false(1). Returns true or the 
  3505.             return code of cmd2
  3506.  
  3507. Next chapter:
  3508.  
  3509.  1.1.4 input / output redirection
  3510.  
  3511. §§COSHYHLP\LOG§
  3512. §prot§COSHYHLP\PROT§
  3513. §echo§COSHYHLP\ECHO§
  3514. §capture dialog§_Protokoll§
  3515. §
  3516.   log [-n] text
  3517.  
  3518.  write a text to the capture files (if 
  3519.  such a file is opened by the 
  3520.  terminals capture dialog or the prot 
  3521.  command).
  3522.  
  3523.  The syntax is equivalent to echo.
  3524.  
  3525. see also: prot, Protokolldialog
  3526.  
  3527. §§COSHYHLP\METAS§
  3528. §Words§COSHYHLP\WORTE§
  3529. §
  3530. 1.1.1 Meta characters
  3531.  
  3532. Meta characters are characters, that 
  3533. separate words on a commandline when 
  3534. unquoted. They are: <space>, <tab>, 
  3535. <newline>, &, |, ;, < and >.
  3536.  
  3537. next chapter:
  3538.  
  3539.  1.1.2 Words
  3540.  
  3541. §§COSHYHLP\NOISE§
  3542. §bell§COSHYHLP\BELL§
  3543. §
  3544.    noise filename ...
  3545.  
  3546. plays a filename by activating the MOD-file-
  3547. player Paula or using DMA-Sound.
  3548.  
  3549. If neither Paula is installed nor DMA 
  3550. available you may use bell as a last 
  3551. chance to produce noise.
  3552.  
  3553. §§COSHYHLP\NOT§
  3554. §
  3555.   !  cmd ...
  3556.  
  3557. Executes cmd and negates the return code.
  3558. True becomes false and vica versa.
  3559.  
  3560. In contrast to unix shells the argument to 
  3561. | may not be a pipe.
  3562.  
  3563. example:
  3564.  
  3565.  if ! cmd1 | cmd2; then    UNIX
  3566.  
  3567.  if cmd1 | ! cmd2; then    CoSHy
  3568.  
  3569. §§COSHYHLP\OVERALL§
  3570. §Listing of the commands§CoSHy§
  3571. §
  3572. 1.3 Overview of the commands.
  3573. 1.3.1 General
  3574.  
  3575. To have it mentioned: All internal 
  3576. commands concerning a certain terminal 
  3577. window or the serial port are not 
  3578. available while running CoSHy on the TOS 
  3579. Screen.
  3580.  
  3581. Assigning variables
  3582.  
  3583. A special internal command hast the 
  3584. structure name=value. The value will be 
  3585. assigned to the shell variabe name.
  3586.  
  3587. Internal and external commands
  3588.  
  3589. If internal and external commands of the 
  3590. same name are available CoShy will prefer 
  3591. the internal command. To access the 
  3592. external one please use the form /path/cmd
  3593. to access the external one.
  3594.  
  3595. If a command is not available as internal 
  3596. command CoSHy scans the environment (not 
  3597. the shell) variable $PATH where it should 
  3598. find directories to access external 
  3599. commands. To change the value of PATH 
  3600. you'll also have to export this value to 
  3601. the environment.
  3602.  
  3603.   PATH='c:/,c:/bin/'
  3604.   export PATH
  3605.  
  3606. next chapter:
  3607.            1.3.1 Listing of the commands.
  3608.  
  3609. §§COSHYHLP\PLAY§
  3610. §answering machine§_Anrufbeantworter§
  3611. §
  3612.   play name
  3613.  
  3614. plays a zyxel voice file. Output device 
  3615. and voice mode have to be set first.
  3616.  
  3617.  Return value:
  3618.   0 Successful
  3619.   1 Successful but message was truncated
  3620.   2 Modem is not a ZyXEL
  3621.   3 Timeout
  3622.   4 Fax call
  3623.   5 DTMF-Code received
  3624.   6 Data call
  3625.  10 Modem is an old ZyXEL
  3626.  11 Connect is not registered (record only)
  3627.  12 Voice-Mode not active
  3628.  -1 File write protected
  3629.  -2 File not found
  3630.  -5 Output error
  3631. -12 Out of heap
  3632. -13 No File Access
  3633. -28 Disk full.
  3634.  
  3635.  The value of $DTMF will be set to the 
  3636.  received digit in case a DTMF code
  3637.  was received.
  3638.  
  3639. see also: answering machine
  3640.  
  3641. §§COSHYHLP\PROT§
  3642. §capture dialog§_Protokoll§
  3643. §
  3644.   prot [options] [filename]
  3645.  
  3646. Options:
  3647.  
  3648.  -on    : Capture on, Ascii-Mode
  3649.  -asc   : Capture on, Ascii-Mode
  3650.  -bin   : Capture op, Binary-Mode
  3651.  -off   : Capture off.
  3652.           (Default -on)
  3653.  
  3654.  -dist  : Select the capture file after
  3655.           carrier loss.
  3656.  -nodist: Write always to the specified
  3657.           file.
  3658.  
  3659.  filename : name of the capture file
  3660.            (only -on, -asc, -bin)
  3661.  
  3662. See also: capture dialog
  3663.  
  3664. §§COSHYHLP\QUIT§
  3665. §
  3666.   quit <val>
  3667.  
  3668. Quits CoNnect. CoSHy is terminated and all 
  3669. windows are closed. <val> is the return 
  3670. code CoNnect will return to the calling 
  3671. process. Default val is 0.
  3672.  
  3673. §§COSHYHLP\DEBUG§
  3674. §Actions on a commandline§COSHYHLP\INPWORK§
  3675. §
  3676. 1.1.6 Debugging
  3677.  
  3678. To active CoSHys debug mode, use the command
  3679.  
  3680.    set -x
  3681.  
  3682. All commands passed to CoSHy will then be 
  3683. displayed in completely expanded form 
  3684. before execution.
  3685.  
  3686. To switch debugging off just enter
  3687.  
  3688.     unset -x
  3689.  
  3690. example:
  3691.  
  3692.    c:\> set -x
  3693.    c:\> echo *.acc
  3694.    + echo gszrz.acc xcontrol.acc
  3695.    gszrz.acc xcontrol.acc
  3696.    c:\> unset -x
  3697.    + unset -x
  3698.    c:\>
  3699.  
  3700. next chapter:
  3701.  
  3702.  1.2 Actions on a commandline
  3703.  
  3704. §§COSHYHLP\QUOTES§
  3705. §debugging§COSHYHLP\DEBUG§
  3706. §
  3707. 1.1.5 Quotes
  3708.  
  3709.   To remove the special meaning of characters
  3710. you may quote them:
  3711.  
  3712.  
  3713.  \ (Backslash): \ is the escape character of
  3714. the shell and removes a special meaning from
  3715. any directly following character. To obtain 
  3716. a
  3717. \ you'll have to enter \\.
  3718.  
  3719.  ' (Single Quote): All characters, even all
  3720. other quote characters loose their special
  3721. meaning when found between single quotes.
  3722. Inbetween '...' no expansion is performed.
  3723. The single quote cannot be found in between
  3724. '...' as it always ends a single quotation.
  3725.  
  3726.  
  3727.  " (Double-Quote): All characters but `
  3728. (backquote),  ' (single quote), $ (dollar
  3729. sign) and \ (back slash) loose their special
  3730. meaning. Whereas `, ' and $ always keep their
  3731. special meaning this is true for \ only if the
  3732. following char is a $, ', " or <newline>.
  3733. You may enter a " in between "..." by placing
  3734. a \ in front of it: "here it is \"."
  3735.  
  3736. next chapter:
  3737.  
  3738.  1.1.6 debugging
  3739.  
  3740. §§COSHYHLP\READ§
  3741. §
  3742.   read name [name2 ...]
  3743.  
  3744. Uses stdin (normally the keyboard) to read in
  3745. a string and divides it (regardless of
  3746. quoting!) into parts containing no spaces or
  3747. tabs. This parts are then assigned to the
  3748. variables name, name2, ... If there are less
  3749. parts then variables the last variable will
  3750. be assigned all missing parts.
  3751.  
  3752. example:
  3753.  
  3754.  read bbs; dial $"bbs"
  3755.  
  3756.  reads is a bbsname and starts dialing in.
  3757.  
  3758. §§COSHYHLP\READKEY§
  3759. §timeout value§COSHYHLP\TIMEFORM§
  3760. §
  3761.   readkey [-v] [timeout] var1 [var2...]
  3762.  
  3763. Reads as many characters as there are
  3764. variable names (var1, var2,...) from the
  3765. keyboard and assigns the keystrokes to the
  3766. given variable. If a timeout value is given
  3767. readkey will return false(1) if the user
  3768. needs too long to enter the keys.
  3769.  
  3770. If the option -v is set, readkey will echo
  3771. its input on the terminal screen.
  3772.  
  3773. §§COSHYHLP\RECORD§
  3774. §answering machine§_Anrufbeantworter§
  3775. §
  3776.   record filename
  3777.  
  3778. Gets a voice file from a ZyXel Modem and
  3779. writes it to filename.
  3780.  
  3781. Return values:
  3782.  
  3783.  0   Successful.
  3784.  1   Successful: but message was to long
  3785.      got truncated
  3786.  2   Modem is no ZyXEL
  3787.  3   Timeout
  3788.  4   Fax-Call
  3789.  6   Data Call
  3790.  10  Modem is an old ZyXEL
  3791.  11  Connect is not registered
  3792.  -1  File is read only
  3793.  -2  File not found
  3794.  -5  Write error
  3795.  -13 File access refused
  3796.  -28 Disk full
  3797.  
  3798. see also:
  3799.    answering machine
  3800.  
  3801. §§COSHYHLP\REDRAW§
  3802. §
  3803.   redraw
  3804.  
  3805. redraws the whole screen before the next
  3806. interactive entered command or if the script
  3807. exits. 
  3808.  
  3809.  
  3810. §§COSHYHLP\SAVEBUF§
  3811. §save buffer§T\SAVPUF§
  3812. §
  3813.   savebuf [-a]  filename
  3814.  
  3815. Saves the history buffer to a file filename.
  3816. If option -a is set, the buffer is appended
  3817. to a possibly existing file.
  3818.  
  3819. This command is useful before starting an
  3820. external editor:
  3821.  
  3822. example:
  3823.  
  3824. Set a function key to
  3825.  
  3826.   savebuf d:/s.txt; cd c:/edit; edit
  3827.   d:\\s.txt
  3828.  
  3829. and select the left coshy button. 
  3830.  
  3831. Savebuf is similar to the terminal menu
  3832. function save buffer.
  3833.  
  3834. §§COSHYHLP\SCRIPT§
  3835. §
  3836.   .  file arg1 arg2 ...
  3837.  
  3838. Runs a file as a CoSHy Script. The command 
  3839. is  the Dot, so between . and file there 
  3840. has to be a space. Following arguments are 
  3841. assigned to the values $1 to $n. $0 is 
  3842. always set to the name of file.
  3843.  
  3844. example:
  3845.  
  3846.  . maus   Runs a script maus or if the is 
  3847.           not available the script maus.scr.
  3848.  
  3849. §§COSHYHLP\SEND§
  3850. §echo§COSHYHLP\ECHO§
  3851. §
  3852.   send [-n]  arg1 arg2 ....
  3853.  
  3854. Is similar to echo but write its arguments 
  3855. to the serial device.
  3856.  
  3857. example:
  3858.  
  3859.  send "at z1"   Send Hayes command for 
  3860.                 modem reset to profile 1.
  3861.  
  3862. §§COSHYHLP\SENDBREA§
  3863. §Send break§T\BREAK§
  3864. §
  3865.   sendbreak
  3866.  
  3867. On the current Port a 'break' will be sent
  3868. (0.7s $00 without start- or stopbit).
  3869.  
  3870. This command is equivalent to the action 
  3871. Send break in the terminal menu.
  3872.  
  3873. §§COSHYHLP\SET§
  3874. §
  3875.   set  arg1 val1 arg2 val2 ...
  3876.  
  3877. Without arguments the shellvariables are 
  3878. shown. Else identical to arg1=val1; 
  3879. arg2=val2; ... (this is not a good unix 
  3880. set)
  3881.  
  3882. example:
  3883.  
  3884.  set HLP 'C:\'  Sets the Shellvariable
  3885.                  HLP to 'C:\'.
  3886.  
  3887. §§Environment§
  3888. §cd§COSHYHLP\CD§
  3889. §
  3890. Here you find a list of environment
  3891. variables used by CoNnect:
  3892.  
  3893. ∙ PATH
  3894.   The access path for CoSHy program calls. 
  3895.   The paths are separated by , or ;
  3896.   example:
  3897.         PATH=c:/usr/bin,c:/bin,c:/etc
  3898.  
  3899. ∙ PROMPT
  3900.   The default prompt for CoSHy.
  3901.   %p%g will give you a dos like command 
  3902.   prompt.
  3903.   Possible elements:
  3904.  
  3905.   ∙ %p the current directory
  3906.   ∙ %g the sign >
  3907.   ∙ %t the current time
  3908.   ∙ else
  3909.        the given character
  3910.  
  3911. ∙ COLUMNS
  3912.   The number of columns for a default 
  3913.   terminal. CoNnect also sets this variable 
  3914.   when calling external programs running 
  3915.   in a CoNnect window.
  3916.  
  3917. ∙ LINES
  3918.   The number of rows for a default terminal. 
  3919.   CoNnect also sets this variable when 
  3920.   calling external programs running in a 
  3921.   CoNnect window. If lines is not available
  3922.   CoNnect will try to evaluate ROWS
  3923.  
  3924. ∙ SHELL
  3925.   A pathname for an external TOS-Shell.
  3926.  
  3927. ∙ HOME
  3928.   The home-path will be branched to, when 
  3929.   calling cd without arguments.
  3930.  
  3931.     c:/connect> HOME='c:/home'
  3932.     c:/connect> export HOME
  3933.     c:/connect> cd
  3934.     c:/home>
  3935.  
  3936. ∙ CDPATH
  3937.   The syntax is equivalent to PATHs one. 
  3938.   cd will search the given pathnames for 
  3939.   possibilities to branch to if a given 
  3940.   directory name can not be found in the 
  3941.   current directory:
  3942.  
  3943.     c:/connect> CDPATH='c:/usr;c:/'
  3944.     c:/connect> cd bin
  3945.     c:/usr/bin> cd usr
  3946.     c:/usr>
  3947.  
  3948. ∙ CLIPBRD
  3949.   CoNnect trys in several ways to 
  3950.   determine the GEM-clipboards name. First 
  3951.   it'll try scrp_read(), if this fails 
  3952.   CLIPBRD is evaluated. If this still
  3953.   fails CoNnect trys to open C:\CLIPBRD.
  3954.   In the next step it will ask the user.
  3955.  
  3956. §§COSHYHLP\SETENV§
  3957. §Environment variables§Environment§
  3958. §
  3959.   setenv  arg1 val1 arg2 val2 ...
  3960.  
  3961. The environment variables arg1, arg2 ... 
  3962. are assigned to the values val1, val2 ...
  3963. Shellvariables are not changed in any way 
  3964. by this operation. Only $?.
  3965.  
  3966. example:
  3967.  
  3968.  setenv ROWS 24
  3969.  
  3970. see also: Environment variables
  3971.  
  3972. §§COSHYHLP\SHIFT§
  3973. §
  3974.   shift  m
  3975.  
  3976. moves the values of the shell variables
  3977. $1, ... $n to the left. m determines the 
  3978. number of moves. It defaults to one if 
  3979. omitted. The return code is false(1) if
  3980. m > n.
  3981.  
  3982. example:
  3983.  
  3984.  shift 3
  3985.  
  3986. §§COSHYHLP\SLEEP§
  3987. §time format§COSHYHLP\TIMEFORM§
  3988. §
  3989.   sleep [-t] n
  3990.  
  3991. waits a give time n. n is in the CoSHy 
  3992. time format.
  3993.  
  3994. If option -t is used n is the time of day to 
  3995. wait for.
  3996.  
  3997. example
  3998.  
  3999.  sleep 120          Waits 120 sec.
  4000.  sleep 2H           Waits   2 h
  4001.  sleep -t 730       Waits until 7:30am
  4002.  
  4003. §§COSHYHLP\SLOT§
  4004. §Transfer dialog§_Transfer§
  4005. §
  4006.   slot
  4007.  
  4008. without arguments:
  4009. prints the current transferslot
  4010.  
  4011. using slot n (n between 1 and 8) can be 
  4012. used to set the current transfer slot.
  4013.  
  4014. See also: Transfer dialog
  4015.  
  4016. §§COSHYHLP\TEST§
  4017. §[ expr ]§COSHYHLP\AUSDRUCK§
  4018. §if§COSHYHLP\IF§
  4019. §while§COSHYHLP\WHILE§
  4020. §
  4021.   test  expression
  4022.  
  4023. Returns either true(0) or false(1) 
  4024. depending of the evaluation of the 
  4025. relations in expression.
  4026.  
  4027. Possible relations are:
  4028.  
  4029. Expression: returns true if:
  4030.  
  4031. -d file    file exists and is a directory.
  4032.  
  4033. -f file    file exists and is a normal file.
  4034.  
  4035. -r file    file exists and is readable.
  4036.  
  4037. -s file    file length is not zero.
  4038.  
  4039. -t  fd     fd is opened on a tty. If fd is 
  4040.            omitted it defaults to 1 (stdout)
  4041.  
  4042. -w file    file exists and is writable.
  4043.  
  4044. -z string  length of string is 0
  4045.  
  4046. -n string  length of string is > 0.
  4047.  
  4048. str1=str2  str1 and str2 are identical.
  4049.  
  4050. str1!=str2 str1 and str2 not identical.
  4051.  
  4052. !expr1     expr1 is false.
  4053.  
  4054. expr1 -a expr2
  4055.            expr1 and expr are true
  4056.  
  4057. expr1 -o expr2
  4058.            expr1 or expr2 are true
  4059.  
  4060. arg1 OP arg2
  4061.            an arithmetical comparison 
  4062.            between arg1 and arg2.
  4063.            Values for OP:
  4064.            -eq equal
  4065.            -ne not equal
  4066.            -lt less than
  4067.            -le less or equal
  4068.            -gt greater than
  4069.            -ge greater or equal
  4070.            arg1 and arg2 should be integers.
  4071.  
  4072. test can use brackets to set operator 
  4073. hierarchy.
  4074.  
  4075. test is called, if the command [ expr ] is 
  4076. found.
  4077.  
  4078. The result of test, normaly is used in if 
  4079. or while statements. It can also be found 
  4080. in $?.
  4081.  
  4082. example:
  4083.  
  4084.  test 1 -gt 4  returns false
  4085.  
  4086.  [-f connect.prg] should return true in 
  4087.                   CoNnect's directory.
  4088.  
  4089.  test -z ""    returns 0 (true).
  4090.  
  4091. §§COSHYHLP\TIMEFORM§
  4092. §
  4093. The time format in CoSHy
  4094.  
  4095. You can specify the following units in 
  4096. timeformat.
  4097.  
  4098.  s = second
  4099.  m = millisecond
  4100.  M = minute
  4101.  H = hour
  4102.  h = centisecond
  4103.  
  4104. example:
  4105.  
  4106.    sleep  42H    waits 42 hours.
  4107.  
  4108. §§COSHYHLP\TRUE§
  4109. §
  4110.   # text
  4111.  
  4112. Returns always true. Can be used as a 
  4113. comment.
  4114.  
  4115. example:
  4116.  
  4117.  # quit   quit will not be executed as
  4118.           its a comment.
  4119.  
  4120. §§COSHYHLP\TRUE1§
  4121. §false§COSHYHLP\FALSE§
  4122. §
  4123.   true
  4124.  
  4125. Returns always true. Identical to !false.
  4126.  
  4127. example:
  4128.  
  4129.  true           Returns '0'
  4130.  echo $?
  4131.  
  4132. §§COSHYHLP\UNALIAS§
  4133. §alias§COSHYHLP\ALIAS§
  4134. §
  4135.  
  4136.   unalias cmd
  4137.  
  4138. removes an alias definition.
  4139.  
  4140. §§COSHYHLP\UNSET§
  4141. §
  4142.   unset arg1 arg2 ...
  4143.  
  4144. All variables in the commandline will be 
  4145. unset (deleted).
  4146.  
  4147. example:
  4148.  
  4149.  unset a PATH
  4150.  
  4151.   a and PATH will be deleted. The 
  4152.   environment variables PATH and a will
  4153.   stay untouched.
  4154.  
  4155. §§COSHYHLP\UPLOAD§
  4156. §Transfer dialog§_Transfer§
  4157. §
  4158.   upload [-p path]  filename
  4159.  
  4160. A file will be uploaded with the parameters
  4161. of the transfer dialog. If filename is
  4162. missing a fileselector will be opened to let
  4163. you chose your selection. If you are using an
  4164. external protocol a given filename will
  4165. replace the $ sign in the commandline to this
  4166. programs. 
  4167.  
  4168. The Option -p will allow you to setup a
  4169. default uploadpath.
  4170.  
  4171. example:
  4172.  
  4173.  upload 'c:\test\infile.txt'
  4174.  
  4175. see also: Transfer dialog.
  4176.  
  4177. §§COSHYHLP\VERSION§
  4178. §
  4179.   version
  4180.  
  4181.  will display connects current version
  4182. number. Normally this function will not get
  4183. in trouble, if the version number changes
  4184. while the command is executed.
  4185.  
  4186. §§COSHYHLP\WAITFOR§
  4187. §time§COSHYHLP\TIMEFORM§
  4188. §
  4189.   waitfor [-s -i -o file -t time] string1
  4190.         string2 ... string20
  4191.  
  4192. waits until one of the strings appended as
  4193. parameters to waitfor occurs in the incoming
  4194. data stream or the timeout is reached.
  4195.  
  4196. If no timeout occurs waitfor returns true(0).
  4197. In addition the variable WAITID is set to the
  4198. string number received (1 - ...) and
  4199. WAITSTR is set to the string received. While
  4200. waiting all characters received will be
  4201. displayed on the terminal screen unless the
  4202. parameter -s (silent) is set. 
  4203.  
  4204. The following options are known to waitfor.
  4205.  
  4206.  -s       silent - just waiting - not output
  4207.  -i       Incoming data is scanned regardless
  4208.           of upper- and lower case
  4209.  -t time  timeout value          
  4210.  -o file  appends all incoming data to file
  4211.  
  4212. example:
  4213.  
  4214.  if waitfor -t 60 'CONNECT' 'BUSY'
  4215.                   'NO CARRIER'; then
  4216.   if [ $WAITID = 1 ] ; then
  4217.    echo 'we got CoNnected'
  4218.   else if [ $WAITSTR = 'BUSY' ]; then
  4219.     echo 'Busy'
  4220.    else
  4221.     echo 'something very funny'
  4222.    fi
  4223.   fi
  4224.  fi
  4225.  
  4226. §§COSHYHLP\WHILE§
  4227. §
  4228.   while  cmd1; cmd2; ...; do
  4229.     cmd3; ...;
  4230.   done
  4231.  
  4232. All commands between while and do are
  4233. executed and if the return code of the last
  4234. command is true (0) the commands between do
  4235. and done are executed. Then proceeding starts
  4236. again until the last command between while
  4237. and do returns false.
  4238.  
  4239. example:
  4240.  
  4241.  while [$a -ne 0]
  4242.   do             
  4243.    a='expr $a - 1'
  4244.    b='expr $b + 2'
  4245.   done            
  4246.  
  4247.  
  4248. §§COSHYHLP\WORTE§
  4249. §Command separators§COSHYHLP\KMDTR§
  4250. §
  4251. 1.1.2 Worte
  4252.  
  4253. A word is a string between to non-quoted
  4254. spaces. Metacharacters may also be contents
  4255. of a word but only if quoted.
  4256.  
  4257. the examples below have all one word per line.
  4258.  
  4259.  
  4260.  hello        
  4261.  
  4262.  hello\ Pete
  4263.  
  4264.  hello\       two lines, but 1 word 
  4265.  you           
  4266.  
  4267.  'Hello You'
  4268.  
  4269.  Hello' 'You
  4270.  
  4271.  hello" You"   
  4272.  
  4273.  "Hello\"\ \"You"
  4274.  
  4275. next chapter:
  4276.  
  4277.  1.1.3 Command separators
  4278.  
  4279. §§Edithelp§
  4280. §
  4281. Editing of CoNnect-Online-Help
  4282.  
  4283. Online help in CoNnect need two files:
  4284. CONNECT.HLP and CONNECT.IDX. If you want to
  4285. edit help texts (e.g. to remove the lots of
  4286. spelling and grammar mistakes) you'll have to
  4287. change CONNECT.HLP only. CoNnect will fix the
  4288. index file itself.
  4289.  
  4290. If you have corrected parts of the help file
  4291. I really ask you to send them to me. I will
  4292. then apply them to the next release.
  4293.  
  4294. Help entrys start with the line (a help marker)
  4295.  
  4296.  §§Help entry§
  4297.  
  4298. where Help entry is an arbitrary marker and
  4299. can be used for referencing this help text.
  4300. Below this line this references can be 
  4301. found.
  4302.  
  4303.  §Test§Help-Test§
  4304.  §Test2§Help-Test2§
  4305.  §
  4306.  
  4307. The end of the references is marked by a
  4308. single § at a line.
  4309.  
  4310. Below the help text can be found where all
  4311. phrases which are equal to the first string in
  4312. a reference will be bold and underlined to
  4313. show the user that this phase is linked to
  4314. another help text which can be reached by
  4315. double-clicking on it. Selecting such an item
  4316. will cause CoNnect to show the suitable help
  4317. text that has a help marker equal to the
  4318. second string in the reference.
  4319.  
  4320. §§History§
  4321. §scantable§COSHYHLP\SCANTABLE§
  4322. §Character Set§_Zeichensatz§
  4323. §history buffer§_Puffer§
  4324. §
  4325. We hope you are using CoNnect 2.0 or higher
  4326. because otherwise reading this history will
  4327. not be much fun for you.
  4328.  
  4329. Regarding version 1.96, CoNnect 2.0 has got a
  4330. lot of improvements.
  4331.  
  4332. New stuff:
  4333. ----------
  4334.  
  4335.  ∙ CoNnect got a hypertext-like context
  4336.    sensitive online help. This will be
  4337.    helpful for all the beginners in using
  4338.    this program as most complains concern the
  4339.    huge number of possible settings.
  4340.      
  4341.  ∙ CoNnect got an internal X-, Y-, Z-Modem
  4342.    protocol. Get more information, by opening
  4343.    the transfer dialog and pressing HELP
  4344.    there.
  4345.    Compuserve B and B+ are also supported
  4346.    internally
  4347.    
  4348.  ∙ Finally you are now enabled to see the 
  4349.    history buffer in an extra window. All
  4350.    selecting and clipping stuff works fine
  4351.    there too.
  4352.    
  4353.  ∙ CoNnect got so called scan tables. They
  4354.    may be used to define any key of the
  4355.    ataris keyboard. Using this feature you
  4356.    can easily implement the doorway mode to
  4357.    have remote control over a PC running the
  4358.    doorway program.
  4359.  
  4360.    A doorway scan table can be found in this
  4361.    archive. 
  4362.  
  4363.  ∙ The Type Ahead Buffer (CONTROL+INSERT)
  4364.    will now stay open till its window is
  4365.    closed.
  4366.  
  4367.  ∙ Redrawing TEK-windows became lots of
  4368.    faster. (due to the fact i needed it
  4369.    myself ;-) 
  4370.  
  4371.  ∙ Statusreports of the TEK-mode are now
  4372.    suppressible. This will be a useful
  4373.    feature for VMS-users.
  4374.      
  4375.  ∙ 115200 Baud on TTs Serial2, on the
  4376.    Falcon and MSTEs MODEM2 and SERIAL2
  4377.         
  4378.  ∙ Preparations for Mag!X (1.11 and 2.0)
  4379.  
  4380.  ∙ The dialing dialog got color icons.
  4381.  
  4382.  ∙ Pressing shift an double-clicking an phonebook
  4383.    entry will activate a continuous dial for one
  4384.    specific number
  4385.  
  4386.  ∙ ^ in the dialing sequence will pull down DTR for
  4387.    700 ms
  4388.  
  4389.  ∙ + Entrys in CONNECT.NUM
  4390.        
  4391.    +t 15.0  time the modem needs to get a carrier
  4392.       after the other side has taken up the phone
  4393.       
  4394.    +T 5.0   Time a carrier must be present to make
  4395.       connect think - this was a real carrier ,)
  4396.  
  4397.    +u DM    Unit of your money - probably $ or £
  4398.    
  4399.    NUM.DOC provides lots of useful information about
  4400.    the programming of CONNECT.NUM
  4401.            
  4402.  ∙ Using the compatibility dialog you can now set
  4403.    <lf> to clear screen.
  4404.  
  4405.  ∙ MTOS:
  4406.     Drag and Drop: CoNnect will start uploading when
  4407.       you drag Files on its windows.
  4408.  
  4409.  ∙ Money (Philipps request) can be found in the 
  4410.    terminal menu.
  4411.  
  4412.  ∙ A new special character for dialling strings
  4413.      @  escapes the next character.
  4414.      @~ does not delay but sends ~
  4415.      @@ sends @
  4416.  
  4417.  ∙ Realtime Slider in the dialing dialog 
  4418.  
  4419. §§General§
  4420. §here§Onlinehilfe§
  4421. §CoSHy§CoSHy§
  4422. §main menu§Hauptmenü§
  4423. §terminal menu§Menue-Term§
  4424. §tektronix menu§Menue-Tek§
  4425. §creating help files§Edithelp§
  4426. §shareware§Shareware§
  4427. §new stuff in 2.10§History§
  4428. §
  4429.  This is the online help for CoNnect.
  4430.  
  4431.  Don't forget that CoNnect is a shareware 
  4432. product. It is not freeware or public domain - 
  4433. you have to pay for its usage.
  4434.  
  4435.  If you want to learn something about the
  4436. help system - please double-click here.
  4437.  
  4438. Other help may be obtained for
  4439.  
  4440.     main menu
  4441.     terminal menu
  4442.     tektronix menu
  4443.     CoSHy
  4444.  
  4445.     new stuff in 2.10
  4446.     
  4447.     creating help files
  4448.  
  4449.