]> code.citadel.org Git - citadel.git/blobdiff - citadel/citadel.rc
* Added a per-user client option to always compose messages using the
[citadel.git] / citadel / citadel.rc
index 1809a895b4f72f1a341e2c37291a2202e8589e96..39278f1cbcf104680344d6ccca6c3a7e4c53c3fa 100644 (file)
@@ -5,12 +5,12 @@
 #
 # The standard client looks for this file in:
 # 1. $HOME/.citadelrc
-# 2. <compiled BBSDIR>/citadel.rc
+# 2. <compiled CTDLDIR>/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
+# Citadel 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.
@@ -27,7 +27,14 @@ fullscreen=no
 # messages.  If you want the external editor to be used by default, be sure
 # to reflect this in the command set below.
 #
-editor=pico
+editor=vi
+
+# 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.
@@ -40,10 +47,10 @@ editor=pico
 
 # If LOCAL_SCREEN_DIMENSIONS is set to 1, then the screen dimensions will
 # be requested from the underlying operating system instead of asking the
-# user.  This works when the user has his/her own copy of the client, it
-# works for xterms, it sometimes works for telnet sessions, but it doesn't
-# 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.
+# user.  On modern networks this is almost always the case: telnet, SSH,
+# xterm, and Unix/Linux consoles all properly report the screen dimensions.
+# Set this option to 0 only if you are running the Citadel client on a
+# direct-dial modem or hardwired terminals.
 #
 local_screen_dimensions=1
 
@@ -53,6 +60,13 @@ local_screen_dimensions=1
 #
 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.
@@ -110,13 +124,45 @@ remember_passwords=0
 # will be used to remote-control a web browser.  (Do not enable this command
 # for 'safe' public clients.)
 #
-#urlcmd=netscape -remote "openURL(%s)"
+# 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
 
+# If IMAGECMD is defined, users can hit 'I' to view images attached to a
+# message.  (Do not enable this command for public clients.)
+#
+# Possible image viewers follow
+#
+# XV - This is an oldie but goodie, shareware with source code included, no
+# longer included with some Linux distributions due to licensing.
+#imagecmd=xv "%s"
+
+# The following 2 image viewers are included with KDE:
+# KuickShow has a brightness/gamma option and is simple and ubobtrusive
+#imagecmd=kuickshow "%s"
+
+# KView has no brightness/gamma but can do some minimal cropping and clipboard
+# operations
+#imagecmd=kview "%s"
+
+# Eye of Gnome, the Gnome/Nautilus image viewer component (bare bones
+# view/print):
+#imagecmd=eog "%s"
+
+# GIMP is a free-software attempt at a PhotoShop-like application.
+#imagecmd=gimp "%s"
+
+# Preview on Mac OS X
+#imagecmd=/Applications/Preview.app/Contents/MacOS/Preview "%s"
 
 # MESSAGE READING SEMANTICS (experimental)
 #
@@ -139,7 +185,8 @@ remember_passwords=0
 # 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=yes
+alternate_semantics=no
+
 
 
 # COMMAND SET CONFIGURATION
@@ -197,6 +244,7 @@ cmd=13,0,read &New
 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:
@@ -219,7 +267,8 @@ cmd=21,0,&.,&Help:
 cmd=22,1,&.,&Aide,&Kill this room
 cmd=23,1,&.,&Aide,&Edit this room
 cmd=24,0,&.,&Aide,&Who knows room
-cmd=25,2,&.,&Aide,edit &User
+cmd=25,2,&.,&Aide,&User,&Edit
+cmd=96,2,&.,&Aide,&User,&Delete
 cmd=26,2,&.,&Aide,&Validate new users
 cmd=48,1,&.,&Aide,enter &Info file
 cmd=27,0,&.,&Aide,&Room,&Invite user
@@ -247,7 +296,7 @@ cmd=30,0,&.,&Terminate,and &Stay online
 # 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=32,0,&.,&Read,&User listing:
 
 cmd=33,0,&.,&Read,&Textfile formatted
@@ -294,8 +343,15 @@ cmd=44,0,&.,&Enter,file using &Zmodem
 #
 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: