empserver/info/telegram.t
Markus Armbruster a109de948b Remove option TREATIES
TREATIES has issues:

* Treaties can cover attack, assault, paradrop, board, lboard, fire,
  build (s|p|l|n) and enlist, but not bomb, launch, torpedo and
  enlistment centers.

* Usability is very poor.  While a treaty is in effect, every player
  action that violates a treaty condition triggers a prompt like this:

    This action is in contravention of  treaty #0 (with Curmudgeon)
    Do you wish to go ahead anyway? [yn]

  If you decline, the action is not executed.  If you accept, it is.
  In both cases, your decision is reported in the news.

  You cannot get rid of these prompts until the treaty expires.

* Virtually nobody uses them.

* Virtually unused code is buggy code.  There is at least one race
  condition: multifire() reads the firing sector, ship or land unit
  before the treaty prompt, and writes it back after, triggering a
  generation oops.  Any updates made by other threads while trechk()
  waits for input are wiped out, triggering a seqno mismatch oops.

* The treaty prompts could confuse smart clients that aren't prepared
  for them.  WinACE isn't, but is reported to work anyway at least
  common usage.  Ron Koenderink (the WinACE maintainer) suspects there
  could be a few situations where it will fail.

This feature is not earning its keep.  Remove it.  Drop command
treaty, consider treaty, offer treaty, xdump treaty, reject treaties.
Output of accept changed, obviously.

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
2014-02-16 11:44:14 +01:00

46 lines
1.7 KiB
Perl

.TH Command TELEGRAM
.NA telegram "Send \*Qdiplomatic\*U communique to another country"
.LV Basic
.SY "telegram <CNUM/CNAME>..."
The telegram command allows communication
to take place between representatives. Currently you
are given only 1024 characters per telegram.
.s1
The <CNUM/CNAME> argument is either the number or name of
the recipient nation. You may specify as many recipients on the
command line as you wish.
Telegrams sent to country #0 appear as prayers,
(favors are best obtained in this manner.)
.s1
While entering your telegram the system tells you how many characters
you have left. You end the telegram by by entering a line with a '.'
on a line by itself. A line containing
only '~q' will abort the telegram.
.s1
For example:
.EX tel 7 8
.NF
Enter telegram for multiple recipients
undo last line with ~u, print with ~p, abort with ~q, end with .
1024 left:
1023 left: B.F.D. Pouncetrifle
1003 left: Groonland Embassy
984 left:
983 left: Dear Ambassador Pouncetrifle,
953 left:
952 left: Just a little note to express the friendly wishes that all of us
887 left: in Curmudgeon feel toward you backward savages in Groonland. As
822 left: to the matter of the treaty you've proposed please remember that
757 left: if we wished we could TRASH your capital.
715 left:
714 left: As always I remain,
688 left: Your humble and obedient servant, etc, etc
638 left: E. D. Amen Dada
616 left: Under Asst. West Coast Promo.
580 left: the Sovereign State of Curmudgeon
540 left: .
.FI
.s1
Note that others can reject your telegrams, using \*Qreject\*U.
.s1
.SA "flash, toggle, announce, read, reject, Communication, Diplomacy"