void owl_variable_add_defaults(owl_vardict *vd)
{
OWLVAR_STRING( "personalbell" /* %OwlVarStub */, "off",
"ring the terminal bell when personal messages are received",
"Can be set to 'on', 'off', or the name of a filter which\n"
"messages need to match in order to ring the bell");
OWLVAR_BOOL( "bell" /* %OwlVarStub */, 1,
"enable / disable the terminal bell", "" );
OWLVAR_BOOL_FULL( "debug" /* %OwlVarStub */, OWL_DEBUG,
"whether debugging is enabled",
"If set to 'on', debugging messages are logged to the\n"
"file specified by the debugfile variable.\n",
NULL, owl_variable_debug_set, NULL);
OWLVAR_BOOL( "startuplogin" /* %OwlVarStub */, 1,
"send a login message when BarnOwl starts", "" );
OWLVAR_BOOL( "shutdownlogout" /* %OwlVarStub */, 1,
"send a logout message when BarnOwl exits", "" );
OWLVAR_BOOL( "rxping" /* %OwlVarStub */, 0,
"display received pings", "" );
OWLVAR_BOOL( "txping" /* %OwlVarStub */, 1,
"send pings", "" );
OWLVAR_BOOL( "sepbar_disable" /* %OwlVarStub */, 0,
"disable printing information in the separator bar", "" );
OWLVAR_BOOL( "smartstrip" /* %OwlVarStub */, 1,
"strip kerberos instance for reply", "");
OWLVAR_BOOL( "newlinestrip" /* %OwlVarStub */, 1,
"strip leading and trailing newlines", "");
OWLVAR_BOOL( "displayoutgoing" /* %OwlVarStub */, 1,
"display outgoing messages", "" );
OWLVAR_BOOL( "loginsubs" /* %OwlVarStub */, 1,
"load logins from .anyone on startup", "" );
OWLVAR_BOOL_FULL( "colorztext" /* %OwlVarStub */, 1,
"allow @color() in zephyrs to change color",
"", NULL, owl_variable_colorztext_set, NULL);
OWLVAR_BOOL( "fancylines" /* %OwlVarStub */, 1,
"Use 'nice' line drawing on the terminal.",
"If turned off, dashes, pipes and pluses will be used\n"
"to draw lines on the screen. Useful when the terminal\n"
"is causing problems" );
OWLVAR_BOOL( "zcrypt" /* %OwlVarStub */, 1,
"Do automatic zcrypt processing",
"" );
OWLVAR_BOOL_FULL( "pseudologins" /* %OwlVarStub */, 0,
"Enable zephyr pseudo logins",
"When this is enabled, BarnOwl will periodically check the zephyr\n"
"location of users in your .anyone file. If a user is present\n"
"but sent no login message, or a user is not present that sent no\n"
"logout message, a pseudo login or logout message will be created\n",
NULL, owl_variable_pseudologins_set, NULL);
OWLVAR_BOOL( "ignorelogins" /* %OwlVarStub */, 0,
"Enable printing of login notifications",
"When this is enabled, BarnOwl will print login and logout notifications\n"
"for zephyr or other protocols. If disabled BarnOwl will not print\n"
"login or logout notifications.\n");
OWLVAR_ENUM_FULL( "disable-ctrl-d" /* %OwlVarStub:lockout_ctrld */, 1,
"don't send zephyrs on C-d",
"If set to 'on', C-d won't send a zephyr from the edit\n"
"window. If set to 'off', C-d will always send a zephyr\n"
"being composed in the edit window. If set to 'middle',\n"
"C-d will only ever send a zephyr if the cursor is at\n"
"the end of the message being composed.\n\n"
"Note that this works by changing the C-d keybinding\n"
"in the editmulti keymap.\n",
"off,middle,on",
NULL, owl_variable_disable_ctrl_d_set, NULL);
OWLVAR_PATH( "debug_file" /* %OwlVarStub */, OWL_DEBUG_FILE,
"path for logging debug messages when debugging is enabled",
"This file will be logged to if 'debug' is set to 'on'.\n"
"BarnOwl will append a dot and the current process's pid to the filename.");
OWLVAR_PATH( "zsigproc" /* %OwlVarStub:zsigproc */, NULL,
"name of a program to run that will generate zsigs",
"This program should produce a zsig on stdout when run.\n"
"Note that it is important that this program not block.\n\n"
"See the documentation for 'zsig' for more information about\n"
"how the outgoing zsig is chosen."
);
OWLVAR_PATH( "newmsgproc" /* %OwlVarStub:newmsgproc */, NULL,
"name of a program to run when new messages are present",
"The named program will be run when BarnOwl receives new\n"
"messages. It will not be run again until the first\n"
"instance exits");
OWLVAR_STRING( "zsender" /* %OwlVarStub */, "",
"zephyr sender name",
"Allows you to customize the outgoing username in\n"
"zephyrs. If this is unset, it will use your Kerberos\n"
"principal. Note that customizing the sender name will\n"
"cause your zephyrs to be sent unauthenticated.");
OWLVAR_STRING( "zsigfunc" /* %OwlVarStub */, "BarnOwl::default_zephyr_signature()",
"zsig perl function",
"Called every time you start a zephyrgram without an\n"
"explicit zsig. The default setting implements the policy\n"
"described in the documentation for the 'zsig' variable.\n"
"See also BarnOwl::random_zephyr_signature().\n");
OWLVAR_STRING( "zsig" /* %OwlVarStub */, "",
"zephyr signature",
"The zsig to get on outgoing messages. If this variable is\n"
"unset, 'zsigproc' will be run to generate a zsig. If that is\n"
"also unset, the 'zwrite-signature' zephyr variable will be\n"
"used instead.\n");
OWLVAR_STRING( "appendtosepbar" /* %OwlVarStub */, "",
"string to append to the end of the sepbar",
"The sepbar is the bar separating the top and bottom\n"
"of the BarnOwl screen. Any string specified here will\n"
"be displayed on the right of the sepbar\n");
OWLVAR_BOOL( "zaway" /* %OwlVarStub */, 0,
"turn zaway on or off", "" );
OWLVAR_STRING( "zaway_msg" /* %OwlVarStub */,
OWL_DEFAULT_ZAWAYMSG,
"zaway msg for responding to zephyrs when away", "" );
OWLVAR_STRING( "zaway_msg_default" /* %OwlVarStub */,
OWL_DEFAULT_ZAWAYMSG,
"default zaway message", "" );
OWLVAR_STRING( "view_home" /* %OwlVarStub */, "all",
"home view to switch to after 'X' and 'V'",
"SEE ALSO: view, filter\n" );
OWLVAR_STRING( "alert_filter" /* %OwlVarStub */, "none",
"filter on which to trigger alert actions",
"" );
OWLVAR_STRING( "alert_action" /* %OwlVarStub */, "nop",
"BarnOwl command to execute for alert actions",
"" );
OWLVAR_STRING_FULL( "tty" /* %OwlVarStub */, "", "<string>", "tty name for zephyr location", "",
NULL, owl_variable_tty_set, NULL);
OWLVAR_STRING( "default_style" /* %OwlVarStub */, "default",
"name of the default formatting style",
"This sets the default message formatting style.\n"
"Styles may be created with the 'style' command.\n"
"Some built-in styles include:\n"
" default - the default BarnOwl formatting\n"
" oneline - one line per-message\n"
" perl - legacy perl interface\n"
"\nSEE ALSO: style, show styles, view -s <style>\n"
);
OWLVAR_INT( "edit:maxfillcols" /* %OwlVarStub:edit_maxfillcols */, 70,
"maximum number of columns for M-q (edit:fill-paragraph) to fill text to",
"This specifies the maximum number of columns for M-q to fill text\n"
"to. If set to 0, M-q will wrap to the width of the window, and\n"
"values less than 0 disable M-q entirely.\n");
OWLVAR_INT( "edit:maxwrapcols" /* %OwlVarStub:edit_maxwrapcols */, 70,
"maximum number of columns for line-wrapping",
"This specifies the maximum number of columns for\n"
"auto-line-wrapping. If set to 0, text will be wrapped at the\n"
"window width. Values less than 0 disable automatic wrapping.\n"
"\n"
"As a courtesy to recipients, it is recommended that outgoing\n"
"Zephyr messages be no wider than 70 columns.\n");
OWLVAR_INT_FULL( "typewinsize" /* %OwlVarStub:typwin_lines */,
OWL_TYPWIN_SIZE,
"number of lines in the typing window",
"This specifies the height of the window at the\n"
"bottom of the screen where commands are entered\n"
"and where messages are composed.\n",
"int > 0",
owl_variable_int_validate_gt0,
owl_variable_typewinsize_set,
NULL /* use default for get */
);
OWLVAR_INT( "typewindelta" /* %OwlVarStub */, 0,
"number of lines to add to the typing window when in use",
"On small screens you may want the typing window to\n"
"auto-hide when not entering a command or message.\n"
"This variable is the number of lines to add to the\n"
"typing window when it is in use; you can then set\n"
"typewinsize to 1.\n\n"
"This works a lot better with a non-default scrollmode;\n"
"try :set scrollmode pagedcenter.\n");
OWLVAR_ENUM( "scrollmode" /* %OwlVarStub */, OWL_SCROLLMODE_NORMAL,
"how to scroll up and down",
"This controls how the screen is scrolled as the\n"
"cursor moves between messages being displayed.\n"
"The following modes are supported:\n\n"
" normal - This is the BarnOwl default. Scrolling happens\n"
" when it needs to, and an attempt is made to\n"
" keep the current message roughly near\n"
" the middle of the screen.\n"
" top - The current message will always be the\n"
" the top message displayed.\n"
" neartop - The current message will be one down\n"
" from the top message displayed,\n"
" where possible.\n"
" center - An attempt is made to keep the current\n"
" message near the center of the screen.\n"
" paged - The top message displayed only changes\n"
" when user moves the cursor to the top\n"
" or bottom of the screen. When it moves,\n"
" the screen will be paged up or down and\n"
" the cursor will be near the top or\n"
" the bottom.\n"
" pagedcenter - The top message displayed only changes\n"
" when user moves the cursor to the top\n"
" or bottom of the screen. When it moves,\n"
" the screen will be paged up or down and\n"
" the cursor will be near the center.\n",
"normal,top,neartop,center,paged,pagedcenter" );
OWLVAR_BOOL( "narrow-related" /* %OwlVarStub:narrow_related */, 1,
"Make smartnarrow use broader filters",
"Causes smartfilter to narrow to messages \"related\" to \n"
"the current message, as well as ones to the same place.\n\n"
"for Zephyr, this controls whether to narrow to e.g. class-help or\n"
"class-help.d alone, or to related-class-help, which includes\n"
"help, unhelp, help.d, etc.\n\nDefault is true (include unclasses, etc.).\n" );
OWLVAR_BOOL( "_followlast" /* %OwlVarStub */, 0,
"enable automatic following of the last zephyr",
"If the cursor is at the last message, it will\n"
"continue to follow the last message if this is set.\n"
"Note that this is currently risky as you might accidentally\n"
"delete a message right as it came in.\n" );
OWLVAR_STRING_FULL( "default_exposure" /* %OwlVarStub */, "",
"none,opstaff,realm-visible,realm-announced,net-visible,net-announced",
"controls the persistent value for exposure",
"The default exposure level corresponds to the Zephyr exposure value\n"
"in ~/.zephyr.vars. Defaults to realm-visible if there is no value in\n"
"~/.zephyr.vars.\n"
"See the description of exposure for the values this can be.",
NULL, owl_variable_default_exposure_set, owl_variable_default_exposure_get );
OWLVAR_STRING_FULL( "exposure" /* %OwlVarStub */, "",
"none,opstaff,realm-visible,realm-announced,net-visible,net-announced",
"controls who can zlocate you",
"The exposure level, defaulting to the value of default_exposure,\n"
"can be one of the following (from least exposure to widest exposure,\n"
"as listed in zctl(1)):\n"
"\n"
" none - This completely disables Zephyr for the user. \n"
" The user is not registered with Zephyr. No user\n"
" location information is retained by Zephyr. No\n"
" login or logout announcements will be sent. No\n"
" subscriptions will be entered for the user, and\n"
" no notices will be displayed by zwgc(1).\n"
" opstaff - The user is registered with Zephyr. No login or\n"
" logout announcements will be sent, and location\n"
" information will only be visible to Operations\n"
" staff. Default subscriptions and any additional\n"
" personal subscriptions will be entered for the\n"
" user.\n"
" realm-visible - The user is registered with Zephyr. User\n"
" location information is retained by Zephyr and\n"
" made available only to users within the user’s\n"
" Kerberos realm. No login or logout\n"
" announcements will be sent. This is the system\n"
" default. Default subscriptions and any\n"
" additional personal subscriptions will be\n"
" entered for the user.\n"
" realm-announced - The user is registered with Zephyr. User\n"
" location information is retained by Zephyr and\n"
" made available only to users authenticated\n"
" within the user’s Kerberos realm. Login and\n"
" logout announcements will be sent, but only to\n"
" users within the user’s Kerberos realm who have\n"
" explicitly requested such via subscriptions. \n"
" Default subscriptions and any additional\n"
" personal subscriptions will be entered for the\n"
" user.\n"
" net-visible - The user is registered with Zephyr. User\n"
" location information is retained by Zephyr and\n"
" made available to any authenticated user who\n"
" requests such. Login and logout announcements\n"
" will be sent only to users within the user’s\n"
" Kerberos realm who have explicitly requested\n"
" such via subscriptions. Default subscriptions\n"
" and any additional personal subscriptions will\n"
" be entered for the user.\n"
" net-announced - The user is registered with Zephyr. User\n"
" location information is retained by Zephyr and\n"
" made available to any authenticated user who\n"
" requests such. Login and logout announcements\n"
" will be sent to any user has requested such. \n"
" Default subscriptions and any additional\n"
" personal subscriptions will be entered for the\n"
" user.\n",
NULL, owl_variable_exposure_set, NULL /* use default for get */ );
}
owl_variable_enum_validate, \
NULL, owl_variable_enum_set_fromstring, \
NULL, owl_variable_enum_get_tostring, \
NULL }
#define OWLVAR_ENUM_FULL(name,default,summary,description,validset,validate, set, get) \
{ name, OWL_VARIABLE_INT, NULL, default, validset, summary,description, NULL, \
validate, \
set, owl_variable_enum_set_fromstring, \
get, owl_variable_enum_get_tostring, \
NULL }
static owl_variable variables_to_init[] = {
OWLVAR_STRING( "personalbell" /* %OwlVarStub */, "off",
"ring the terminal bell when personal messages are received",
"Can be set to 'on', 'off', or the name of a filter which\n"
"messages need to match in order to ring the bell"),
OWLVAR_BOOL( "bell" /* %OwlVarStub */, 1,
"enable / disable the terminal bell", "" ),
OWLVAR_BOOL_FULL( "debug" /* %OwlVarStub */, OWL_DEBUG,
"whether debugging is enabled",
"If set to 'on', debugging messages are logged to the\n"
"file specified by the debugfile variable.\n",
NULL, owl_variable_debug_set, NULL),
OWLVAR_BOOL( "startuplogin" /* %OwlVarStub */, 1,
"send a login message when owl starts", "" ),
OWLVAR_BOOL( "shutdownlogout" /* %OwlVarStub */, 1,