A
          / \      _             Play Now                         Nemesis on 
          | |     | |  _______   _        _   _______    _______   _    _______
          | |\    | | |   ____| |  \    /  | |   ____|  /   ____| | |  /   ____|
 /-------/-------------------------------------------------------------------,
O= Home <=XX|  About  News  Pics  Adventurers  Wizards  Download  Connect     >
 \-------\-------------------------------------------------------------------'
          | |   \   | |  |____  | |      | | |  |____   ___ \  \  | |  ___ \  \
          | |     \_| |_______| |_|      |_| |_______| |_______/  |_| |_______/
          \ /
           V  

Documentation Area

Document Path: /doc/helpdir/ansi

Command: set ansi - changes your colour setup
 
Description:
	Via 'set ansi' you can change and control your individual setup
	for colours and other control sequences of your Nemesis session.
	For more details about 'set' see 'help set'.

	As these escape sequences might ruin your Nemesis session if your
	(MUD) client or your terminal does not support them and/or if it
	"misunderstands" them, you can disable them separately.

	'set ansi on' respectively 'set ansi off' turns the support for
	ANSI control sequences of colours and others on and off (default
	is 'on').

	'set ansi' shows the available ANSI settings in detail.

	These ANSI settings are available and can be adjusted to your
	individual needs:
	- 'set ansi colours off' disables colouring completely in Nemesis
	  and 'set ansi colours on' enables it again.
	- 'set ansi bold off' (or 'set ansi underline off' or 'set ansi
	  bold/underline off') turns off both underlining and bold support
	  as most (MUD) clients and terminals support both or none of
	  these. 'set ansi bold on' etc. enables both again. Default: on.
	- 'set ansi blink off' disables blinking but most MUD clients do
	  not support it at all and ignore the control sequence for it.
	  Default is on.
	- 'set ansi exits <list-of-attributes>' sets a sequence of ANSI
	  escape sequences for the "obvious exits" in the description of
	  a room ('brief' mode or not) when you enter it or when you just
	  'look'. "<list-of-attributes>" can be expressions like these:
	  "green-bold", "blue-underline", "bold-blink-yellow" etc. Default
	  is "green-bold". Disabled attributes e.g. via 'set ansi colours
	  off' (see above) will not be used for displaying the exits as
	  long as the attributes are disabled. But they are stored! You
	  can disable coloured exits etc. via 'set ansi exits off' or via
	  'set ansi exits normal'.
	- 'set ansi alert <list-of-attributes>' sets a sequence of ANSI
	  escape sequences for important messages. "<list-of-attributes>"
	  is an expression like described above at 'set ansi exits <attr>'.
	  "red-bold" is the default. Again disabled attributes are not
	  used/displayed but are stored. 'set ansi alert off' or 'set ansi
	  alert normal' turns colouring etc. off for important messages.

	The supported (ANSI) colours are:
		black
		red
		green
		yellow (might appear brown depending on your system)
		blue
		purple
		cyan
		white

	Currently the other supported (ANSI) control sequences are these:
		bold
		underline
		blink

	If you discover problems while using another terminal or MUD client
	different from your standard one (e.g. "strange" characters or other
	misbehaviour in your session), you can simply turn off the complete
	ANSI escape code support via 'set ansi off' or disable parts of it,
	e.g. via 'set ansi colours off' or 'set ansi bold off'. So you can
	keep your individual default setting for "exits" and "alert".

Examples:
	set ansi
	ANSI is switched on.
	Settings:
	colours       : on
	bold/underline: on
	blink         : on
	exits         : green-bold
	alert         : red-bold
	
	set ansi colours on
	ANSI variable colours turned on.

	set ansi alert blink-red-underline-bold
	ANSI variable alert set to blink-red-underline-bold.

Note:
	If you have any ideas related to Nemesis' support for ANSI escape
	sequences, don't hesitate to contact us! :-)

	There might still be a few rooms in Nemesis that do not show
	coloured exits. Please tell us when you find one!

	The support for the ANSI control sequences was brought to you by
	Wastl ('whois wastl' or https://nemesis.de/lpc/bin/finger/wastl )
	in August 2016 after long discussions about it with Kiri ('whois
	kiri' or https://nemesis.de/lpc/bin/finger/kiri ). It is based on
	old ideas and fragments of code by lynX ('whois lynx' or
	https://nemesis.de/lpc/bin/finger/lynx ).

	See https://en.wikipedia.org/wiki/ANSI_escape_code about ANSI
	control sequences.

See also:
helpdir/set
helpdir/brief
helpdir/look