#
-# citadel.rc
+# $Id$
#
# This file allows full customization of the user interface.
#
# The standard client looks for this file in:
# 1. $HOME/.citadelrc
-# 2. /usr/local/lib/citadel.rc
-# 3. <compiled BBSDIR>/citadel.rc
+# 2. <compiled BBSDIR>/citadel.rc
+# 3. /etc/citadel.rc
# 4. <current directory>/citadel.rc
+# Set ENCRYPT to yes to force SSL/TLS encryption when connecting to a
+# Citadel/UX server, even if the server is on the same machine as the
+# client. Set it to no to disable SSL/TLS encryption. The default is to
+# enable encryption for remote systems and to disable encryption for
+# systems on the same machine as the client.
+encrypt=default
+
+# Set FULLSCREEN to yes to (attempt to) use full-screen curses mode.
+# This mode presents a status line and a few other niceties. Some
+# people might not like this, so you can turn it off here or with the
+# -s command line option. The default is to use full screen if the
+# terminal supports it.
+fullscreen=no
+
# Set EDITOR to the name of an external editor to be used for entering
# messages. If you want the external editor to be used by default, be sure
# to reflect this in the command set below.
#
-editor=/usr/local/bin/safe-pico
+# editor=pico
+
+# Or, you could have multiple editors available, like this:
+# ("editor" and "editor0" are the same internally)
+# You can go up to MAX_EDITORS number of editors (5 by default)
+# editor0=pico
+# editor1=vi
+# editor2=nano
# If you define PRINTCMD, it will be a pipe through which messages are
# printed when the user hits the <P>rint key after a message.
# work for dialup connections. Generally you should set this to 1 for a
# private copy of the client or 0 for a shared copy of the client.
#
-local_screen_dimensions=0
+local_screen_dimensions=1
# ANSI_COLOR should be set to on/off/auto/user to control the use of
# color on the screen. If it is set to "auto" then an autodetect will be
#
ansi_color=user
+# USE_BACKGROUND controls Citadel's use of the background. If it is turned
+# off, then Citadel will set the background to black. When it is turned on,
+# the background will be unchanged. This is most useful with "transparent"
+# terminals. Color must be on (see above) or this option has no effect.
+#
+use_background=off
+
+# PROMPT_CONTROL should be set to on/off/user to control whether the <N>ext
+# and <S>top keys are active when displaying the paginator prompt. If it
+# is set to "user" then it's a user-configurable option.
+#
+prompt_control=user
+
# If DISPLAY_MESSAGE_NUMBERS is set to 1, then messages will be displayed
# with their message numbers in the header. This is ugly but some
# people seem to like it anyway...
#
allow_attachments=0
-# If you set the USERNAME variable, the value you set here will automatically
-# be passed to the "Enter your name:" prompt.
+# IDLE_THRESHOLD is the amount of time a user does nothing before being
+# listed as "idle" on the who list. The default is 900 seconds (15 minutes).
#
-#username=My User Name
+idle_threshold=900
+
+# If you set REMEMBER_PASSWORDS to 1, the Citadel client will offer to
+# remember your user name and password for every Citadel server you access,
+# automatically logging in with them on subsequent visits.
+# (DANGER: do NOT enable this for "safe" public clients!)
+#
+remember_passwords=0
-# If you set the PASSWORD variable, the value you set here will automatically
-# be passed to all prompts which request a password ... including the prompt
-# which asks for a password when creating a new user.
+# Optionally, you can force the same username and password everywhere. This
+# obviously isn't as robust as the password manager.
#
+#username=My User Name
#password=mypassword
+# If URLCMD is defined, users can hit 'U' after reading a message which
+# contains embedded URL's, and the command will be executed. Usually this
+# will be used to remote-control a web browser. (Do not enable this command
+# for 'safe' public clients.)
+#
+# This one works on Linux and most other X11-based Unices. Specify the full
+# path to Mozilla (or a Mozilla derivative like Netscape) if necessary.
+#urlcmd=mozilla -remote "openURL(%s)"
+#
+# This one works really well on a Macintosh -- it opens URL's in whatever
+# browser you have configured as the system default.
+#urlcmd=open "%s"
+
+# If GOTMAILCMD is defined, the specified command will be executed. This
+# might be nice for playing sounds or providing any other type of notification.
+#
+#gotmailcmd=play gotmail.wav
+
+
+# MESSAGE READING SEMANTICS (experimental)
+#
+# A new set of message reading semantics is now available. If you set
+# alternate_semantics, the following changes are made:
+#
+# * Messages are marked as read when you read them, rather than when you
+# leave the room. This means read <N>ew will display a new message
+# at most once, unless last old on new is turned on.
+# * Reading <F>orward or <R>everse does not mark messages as read.
+# * When you leave a room with <G>oto, <J>ump, etc., only messages that
+# were in the room when you arrived are marked as read. The original
+# semantics mark all messages read that were in the room at the time
+# you leave the room. This occasionally causes messages to be "lost."
+# * When you leave with <T>erminate, no additional messages are marked
+# as read.
+# * The <S>kip and <A>bandon commands are reversed.
+#
+# This set of semantics should make Citadel easier to use on very busy
+# systems, where many messages may be posted while reading. Users
+# accustomed to D.O.C. or its variants will want to set this option.
+#
+alternate_semantics=no
+
+
+# When the user hits the <R>eply key after reading a message, reply_with_editor
+# selects whether it uses the built-in editor (select 'no') or an external
+# editor (select 'yes').
+#
+reply_with_external_editor=no
+
# COMMAND SET CONFIGURATION
#
cmd=14,0,read &Directory
cmd=15,0,&Terminate
cmd=16,0,&Ungoto
+cmd=95,0,&.,&Ungoto:
cmd=17,0,&Who is online
cmd=47,0,&Abandon ^r^c goto...
+#cmd=90,0,&Abandon ^r^c goto:
cmd=50,0,toggle e&Xpert mode
cmd=49,0,read &Info file
cmd=18,2,&! <shell>
cmd=52,0,&.,&Skip ^r^c goto:
cmd=56,0,&Page a user
cmd=58,0,&Mail
+cmd=84,0,&Quiet mode
#
# We implement both <.G>oto and <J>ump commands which do the same thing, in
# order to please a wider audience of users. Remove one if you want to.
cmd=21,0,&.,&Help:
cmd=22,1,&.,&Aide,&Kill this room
cmd=23,1,&.,&Aide,&Edit this room
-cmd=24,1,&.,&Aide,&Who knows room
+cmd=24,0,&.,&Aide,&Who knows room
cmd=25,2,&.,&Aide,edit &User
cmd=26,2,&.,&Aide,&Validate new users
cmd=48,1,&.,&Aide,enter &Info file
-cmd=27,1,&.,&Aide,&Room,&Invite user
-cmd=28,1,&.,&Aide,&Room,&Kick out user
+cmd=27,0,&.,&Aide,&Room,&Invite user
+cmd=28,0,&.,&Aide,&Room,&Kick out user
cmd=51,1,&.,&Aide,&File,&Delete
cmd=53,1,&.,&Aide,&File,&Send over net
cmd=54,1,&.,&Aide,&File,&Move
cmd=70,2,&.,&Aide,&Message edit:
cmd=78,1,&.,&Aide,&Post
-cmd=80,2,&.,&Aide,&System configuration
+cmd=80,2,&.,&Aide,&System configuration,&General
+cmd=82,2,&.,&Aide,&System configuration,&Internet
+cmd=83,2,&.,&Aide,&System configuration,check &Message base
+cmd=88,2,&.,&Aide,&System configuration,&Network
+cmd=92,2,&.,&Aide,&System configuration,network &Filter list
+cmd=85,2,&.,&Aide,&Terminate server,&Now
+cmd=86,2,&.,&Aide,&Terminate server,&Scheduled
+cmd=87,1,&.,&Aide,mailing &List recipients
+cmd=94,1,&.,&Aide,mailing list &Digest recipients
+cmd=89,1,&.,&Aide,&Network room sharing
cmd=29,0,&.,&Terminate,and &Quit
cmd=30,0,&.,&Terminate,and &Stay online
+
+# The 'read user listing' command accepts two different formats. The one with
+# the trailing colon allows the user to enter a few characters to search for
+# users with a partial match.
+#
cmd=32,0,&.,&Read,&User listing
+cmd=32,0,&.,&Read,&User listing:
+
cmd=33,0,&.,&Read,&Textfile formatted
#
# Command 55 allows the user to save a downloaded file directly to the
#
cmd=41,0,&.,&Enter,re&Gistration
cmd=4,0,&.,&Enter,&Message
+
+# If you have an external editor defined, it will appear on command 46.
cmd=46,0,&.,&Enter,message with &Editor
-#
+
+# If you have multiple editors defined, they will appear on
+# commands 46, 101, 102, 103... up to MAX_EDITORS (5 by default)
+#cmd=101,0,&.,&Enter,message with &VI
+#cmd=102,0,&.,&Enter,message with &Nano
+
cmd=59,0,&;,&Configure floor mode
cmd=60,0,&;,&Goto floor:
cmd=61,0,&;,&Skip to floor:
cmd=62,0,&;,&Zap (forget) floor
cmd=63,2,&;,&Aide,&Create floor
-cmd=64,2,&;,&Aide,&Edit floor
-cmd=65,2,&;,&Aide,&Kill floor
+cmd=64,2,&;,&Aide,&Edit this floor
+cmd=65,2,&;,&Aide,&Kill this floor
cmd=68,0,&;,&Known rooms
cmd=66,0,&.,&Enter,&Bio
cmd=67,0,&.,&Read,&Bio
cmd=79,0,&.,&Wholist,&Long
cmd=75,0,&.,&Wholist,&Roomname
cmd=76,0,&.,&Wholist,&Hostname
+cmd=91,0,&.,&Wholist,&Active
+cmd=93,0,&.,&Wholist,&Stealth mode
#
# Command 69 allows the user to enter a server command directly. It is