//====//====//       “YAK”         //====//====//====//====//====//====//

{
Warning: R4 appears to have changed the characteristics
of yak somewhat..   At a guess, Terminal is now using
some sort of buffering... If you have some
time and want to track this down, please send me the
changes to include in the next release..

(∆)Addendum: Thanks to some pointers from those
out in IRC land,  these problems should have disappeared.)
}




	YAK stands for Yet Another Keyboard.  It's a way
	for more than one person to edit the same set of
	documents at the same time.  It can be a lot of fun
	but choose your tag-team partners carefully, it can
	also cause some friction :-)


QuickStart:
	First, You:
		• Launch YATE (e.g. double click a document)
		• Press Alt-N to open a new window.
		• Arrange the windows such that both are visible.
		• Click on the first window.
		• Start typing with the Black Cursor.

	Then, your Friend:
		• Opens a telnet session to your BeOS system.
		• Types “$ yak” from her telnet session.
		• «Esc» «w» «2» to target the second window.
		• Starts typing with the Red Cursor.

	Then, you Both:
		• Start typing abuse of Win95.
		• Try and ‘spell-check’ your ‘Friends’ abuse.
		• Whack each other over the head.

Recommended:
	You might want to rearrange your windows, a
	good setup might be:
		YATE 1 !Shell            (compiling window… )
		YATE 2 +local.h         (target local keyboard here)
		YATE 3 +firstyak.cpp   (target first YAK here)
		YATE 4 +secondyak.cpp   (target second YAK here)

	It's important that each keyboard targets a
	different window, or else you will both be typing
	with the same cursor.

	YAK users can Cut, Copy and Paste, use the Shell
	and Make, and even use Find with a bit of practise.
	However I can't get home/end to work, and the
	current version doesn't support ‘Goto-Line’

	It's recommended you view the online help in YAK,
	by pressing «Esc» «?».
	and of course, you're more than welcome to alter
	the source code to better suit your telnet client.

	(••)Try using yak through /dev/ports/serial1
	(†††)hint: I haven't had any luck :-)

Caveats:

		/*WARNING: THE CLIPBOARD IS GLOBAL*/

	Be sure to exit yak correctly: «Esc» «q» or ^C.
	if you don't, you may have to restart your telnet
	session.

	(∆) There was also some “noise” in previous yaks
	that meant the cursor keys weren't always
	processed correctly…  This has (hopefully) been fixed!

	Finally, due to variations in Telnet clients, Your
	mileage may vary as to what keys are supported.
	Try using the ASCII output mode and contact me
	if you would like some changes.

//====//====//====//====//====//====//====//====//====//====//

Be Brave,
Chris Blackbourn
blakatz@ihug.co.nz
http://www.geocities.com/TimesSquare/Arcade/1783
