Myrddin's BBS v4.0.6 ASCII help files

Help files for Myrddin's BBS v4.0.6. Use these if you have a hard coded, indexed +help. They are straight ascii and are good for sucking straight into your .txt file.

Author: Myrddin
Category: Bulletin Board
Compatibility: PennMUSH.

Instructions

Copy and paste the below code into a compatible MUSH or MUX.

MUSHCode for Myrddin's BBS v4.0.6 ASCII help files

@@ These are the raw help files for Myrddin's BBS v4.0.6
@@ The code for the Bulletin Board is available at: http://www.mushcode.com/ViewFile.aspx?Id=15

& bboard
==============================================================================
Commands for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
Requiem's BBS is a global, multi-threaded board with a rich set of
features. To see help on a particular topic, type '+help <topic>'
(Example: +help bbread).

TOPIC DESCRIPTION
~~~~~ ~~~~~~~~~~~
bbread Reading bulletin board messages.
bbpost Posting bulletin board messages.
bbmisc Other commands (removing messages, unsubscribing
groups, resubscribing to groups, etc)

bbtimeout Expanded help on the topic of message timeouts.
==============================================================================

& bbread
==============================================================================
Commands for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
+bbread Scans joined bulletin board groups.
+bbread <#> Scans messages in group <#>.
+bbread <#>/<list> Reads message(s). <list> can be a single
number, multiple numbers, or a range
of numbers (ie. 1-6), or any combo.
+bbread <#>/u Reads all unread messages in group <#>.
+bbcatchup <#> Marks all messages in group <#> as read.
You can use multiple group #'s/names
or may use the word 'all' to catchup
on all messages on all boards.

+bbscan Totals unread postings (if any) in each joined group. You
can place this command in your @aconnect, and it's
recommended you do so.

Note: You can use the boards name (or abbreviation) in place of it's number.
------------------------------------------------------------------------------
See also: +help bbpost, +help bbmisc
==============================================================================

& bbpost
==============================================================================
Commands for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
+bbpost <#>/<title> This starts a post to group <#>.
+bbwrite <text> This adds text to an already started post.
+bb <text> Same as +bbwrite.
+bbedit <area>=<old>/<new> Edits your post in progress. Valid areas
are: text, title
+bbproof Displays your current post in progress.
+bbtoss Discards your current post in progress.
+bbpost This will post your current post in
progress.

+bbpost <#>/<subject>=<body> Posts a message to group <#>. This is a
quick way of posting a message with
one command.
+bbedit <#>/<#>=<old>/<new> Edits one of your posted messages.

Note: You can use the boards name (or abbreviation) in place of it's number.
------------------------------------------------------------------------------
See also: +help bbread, +help bbmisc
==============================================================================

& bbmisc
==============================================================================
Commands for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
+bbremove <#>/<list> Removes a message by you. <list> can be a
single number, a group of numbers, or a
range (10-14).
+bbmove <#>/<#> to <#> Moves one of your messages to a new group.
+bbleave <#> Unsubscribe from group <#>.
+bbjoin <#> Joins a group you've previously 'left'.
+bblist Listing of all groups available to you
along with their timeout values.
+bbsearch <#>/<name> Shows you a list of <name>'s postings on
group <#>.
+bbtimeout <#>/<#>=<days> Changes timeout for a message to <days>.
+bbnotify <#>=<on|off> Turn post notification for group <#> on
or off.


For a '.sig', set an attribute on you called BB_SIG, and place your
signature in that.

Note: You can use the board's name (or abbreviation) in place of its number.
------------------------------------------------------------------------------
See also: +help bbread, +help bbpost, +help bbtimeout, +help bbchanges
==============================================================================

& bbtimeout
==============================================================================
Expanded Help on Message Timeouts for Myrddin's Bulletin Board (1 of 2)
------------------------------------------------------------------------------
There's only a couple of things that need to be understood in order to take
full advantage of message timeouts.

1: Once a day, the TR_TIMEOUT attribute on the bbpocket should be triggered.
Some games already have a way of accomplishing this. For games that do not,
simply have a wizard execute set the 'autotimeout' global parameter:
+bbconfig autotimeout=on
Turning that parameter on sets up the board to take care of its own daily
triggering. Setting the paramenter to 'off' turns off the BBS's internal
triggering.

------------------------------------------------------------------------------
Concluded in: +help bbtimeout2
==============================================================================

& bbtimeout2
==============================================================================
Expanded Help on Message Timeouts for Myrddin's Bulletin Board (2 of 2)
------------------------------------------------------------------------------

2: There are 3 different timeout values:

The global parameter 'timeout' (set via the '+bbconfig timeout=<days>'
command) sets a default timeout that will be set on any new bb groups
created after the execution of this command.

The group parameter 'timeout' (set via the '+bbconfig <#>/timeout=<days>'
command) sets a default timeout for the group <#>. Any new messages
posted to this group will inherit that timeout.

The user command '+bbtimeout <group>/<message list>=<days>' will set the
specified timeout on individual messages. Players can only modify their
own messages, wizards can modify any messages. Players can only set
timeouts equal to or less than the default timeout for the board, wizards
can set any timeout.

In all cases, a timeout of '0' indicates no timeout.
==============================================================================

& bbchanges
==============================================================================
Changes to Myrddin's Bulletin Board
------------------------------------------------------------------------------
The most recent version of this code, bug fixes, and patches can be found at:
www.firstmagic.com/~merlin/mushcode

4.0.6:
BugFix: Patched a security hole (thanks to Alierak for pointing it out)
PennFix: Minor tweak to +bbremove that will keep Penn's cleaner and
prevent odd behavior
Feature: Message headers internal to the bbs now store dbref of the owner
of the poster.

4.0.5:
Improved +bbscan (Amberyl)
Improved number range error handling (Kareila@ChaoticMUX)
BugFix: +bbmove - better error handling, and replaced missing '}'
BugFix: FN_SETR behaves better for those that need it.

4.0.4:
BugFix: +bbsearch now checks permissions properly
BugFix: base 36 to base 10 conversion tweaked to be friendlier to Penn
(added a base case of '0' to fold()).
BugFix: Posting to an anonymous board no longer appends your BB_SIG.
BugFix: BBS is now aware of the 8k MUX buffer limit. This affects the
'percentage' full meter.
PennFix: +bbmove tweaked to be friendlier to PennMUSH.
PennFix: Various other PennMUSH fixes, most involving flags. Should help
the BBS run correctly on PennMUSH's.
Feature: Post notification now includes [board]/[#]
Help: Help files have been expanded in the areas of message timeouts and
locking groups.

4.0.3:
BugFix: +bbcleargroup now checks permissions properly
BugFix: +bbcleargroup will no longer re-order remaining groups
BugFix: Automatic post notification for anonymous boards now uses
the anonymous 'title' instead of the poster's name.

4.0.2:
BugFix: +bbsearch will now work properly on all servers
Some attribute cleanup

4.0.1:
BugFix: Message ID's no longer improperly sorted by certain commands
BugFix: Update-Installer should no longer scramble message ID's

4.0.0:
Misc. security enhancements.
Up to 25% increase in storage capacity.
Support for message timeouts. Fully configurable.
Support for anonymous boards. Configurable 'From' field title. Obviously,
MUSH staff can determine original poster.
Post notification: online players are notified of new posts. Configurable
New Command: +bbsearch. Allows user to search a group for posts by a
specific author.
New Command: +bbnotify. Allows user to toggle post notification for
boards.
New Staff Command: +bbconfig. For setting global/group timeout values,
anonymous boards, built-in timeout monitor.
==============================================================================


& bbwiz
==============================================================================
Wizard Commands for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
+bbnewgroup <title> Creates a new group.
+bbcleargroup <#> Clears group <#> and all it's messages.
+bblock <#>=<lock>/<key> Locks group <#>. Lock can be 'flag' or
an attribute name.
Examples: +bblock 4=flag/wizard
+bblock 5=race/were
+bbwritelock <#>=<lock>/<key> Same as above, but controls who may write
to the group.
+bbconfig Shows values of all config parameters.
See '+shelp bbconfig' for help on
config parameters and how to set them.
------------------------------------------------------------------------------
See also: +shelp bbconfig, +shelp bblock (contains expanded help for locks)
==============================================================================

& bblock
==============================================================================
Expanded Help on Group Locks for Myrddin's Bulletin Board
------------------------------------------------------------------------------
A few notes about locking BB Groups.

The +bblock/+bbwritelock commands are only meant to take care of the simplest
of locks. There is simply no way to write one bblock'ing command that can
deal with all the different ways people want to lock their BB Groups, and it
certainly isn't practical to keep adding different locking commands for each
locking method I come across.

Coders can set up locks on Groups that are as customized or exotic as you like
quite easily, however. Each Group has its own object. If you look inside
the global BBS object, you'll see them. Each Group object has a pair of
attributes that control who may read and who may write to that Group. The
attributes are named CANREAD and CANWRITE, respectively. The dbref of the
player attempting to read/write is passed to the appropriate attribute as %0.
As long as the attribute returns a non-zero result, the player can read/write.

CANREAD Examples:
CANREAD: 1 Anyone can read
CANREAD: hasflag(%0,wizard) Only wizards can read
CANREAD: strmatch(name(%0),*z*) Only characters with a 'z' in
their name can read
==============================================================================

& bbconfig
==============================================================================
Configuration Parameters for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
There are two types of configuration parameters: global and group. Global
configuration parameters affect the BB system as a whole, while group
configuration parameters affect a single Group.
To set a global parameter:

+bbconfig <param>=<value> Sets global config parameter.

Global Parameters:

timeout This sets the default timeout (in days) for any new
groups created. A timeout of '0' means messages
won't timeout. (ex. +bbconfig timeout=30)
autotimeout If you don't have a way to trigger the TR_TIMEOUT
attribute on the bbpocket (daily) to clean out
expired messages, you can use the autotimeout param
instead. Setting this param 'on' enables the BB's
built in timer. Set this param to 'off' to disable.
------------------------------------------------------------------------------
See '+shelp bbconfig2' for info on Group parameters
==============================================================================

& bbconfig2
==============================================================================
Configuration Parameters for Myrddin's Bulletin Board 4.0.6
------------------------------------------------------------------------------
To set a Group parameter:

+bbconfig <#>/<param>=<value> Sets config parameter for board <#>.

Group Parameters:

anonymous Setting this value turns the Group 'anonymous'. This
means that any future posting's 'Author' field will
have the value of this param instead of the name of
the author. Wizards will also see the actual name of
author. (examples:
+bbconfig newspaper/anonymous=NewsPaper Staff,
+bbconfig house rules/anonymous=The Staff)
timeout Sets the default timeout value for the Group. Any new
messages will have this new value. A value of '0'
means messages won't timeout.
==============================================================================