tutes-dump/site-tutorials/bboard-tutorial.html

330 lines
13 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>bboard</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
</head>
<body>
<h1>bboard</h1>
<p>
The <code>bboard</code> is a threaded multi discussion bulletin board. It goes back when the original SDF was just a BBS. You may think of it as a corkboard at a community center where members post notes with thumb tacks. It is, along with commode, one of the best ways to get help and news from SDF-EU. Voting of new features and changes on SDF-EU policies also take place at the bboard (ARPA membership or above required)
</p>
<h2><a name="some_relevant_bboards" id="some_relevant_bboards">Some relevant bboards</a></h2>
<ul>
<li> To ask for help, use <strong><code>&lt;HELPDESK&gt;</code></strong>
to have your query answered by another user
</li>
<li> All system notices are posted on <strong><code>&lt;ANNOUNCE&gt;</code></strong>
</li>
<li> Current discussions about SDF-EU happen on <strong><code>&lt;SDFEU&gt;</code></strong>
</li>
<li> You can make requests for new software and discuss account
issues at <strong><code>&lt;REQUESTS&gt;</code></strong>
</li>
<li> <strong><code>&lt;ARPA&gt;</code></strong> and <strong><code>&lt;META&gt;</code></strong> boards are used for ARPA and MetaARPA related questions.
</li>
<li> Member services (such as VPN or VOIP) have their own board for questions and support.
</li>
</ul>
<h2><a name="getting_around" id="getting_around">Getting around</a></h2>
<h3><a name="listing_boards" id="listing_boards">Listing boards</a></h3>
<p>
Type <code>bboard</code> on your shell. You will be presented with a list of current bboards (Boards Listing), sorted by most recent activity.
</p>
<pre>S D F - 1 Bulletin Board
================================================================================
[BBOARD] [POSTS] [TOPIC]
================================================================================
SDFEU [0066] SDF-EU User discussions
META [0022] No Description
HELPDESK [0690] Users Helping Users
NETWORKING [0008] No Description
ARPA [0148] ARPA members helping ARPA members
REQUESTS [0534] Software Updates and Installs for SDF and SDF-EU
[ SCROLL (F)ORWARD, (B)ACKWARD - (G)OTO or (Q)UIT ]</pre>
<p>
To navigate the boards listings, use <code>F</code> (Forward) and <code>B</code> (Backward) keys to go up and down. When you reach the end of the list (or you press <code>Q</code>), you will enter in Command Mode, and a prompt will be presented to you. Every time you run <code>bboard</code> you are placed in the <strong><code>&lt;GENERAL&gt;</code></strong> board by default, hence the prompt <code>&lt;GENERAL&gt; Command: </code>.
</p>
<h3><a name="browsing_messages" id="browsing_messages">Browsing messages</a></h3>
<p>
Say you want to review the <strong><code>&lt;SDFEU&gt;</code></strong> bboard for news about SDF-EU. On the Command Mode, type <code>G</code> (GOTO) followed of the name of the bboard (in this case <code>G → SDFEU</code>) You will enter in Posts Listing, with all entries at the <strong><code>&lt;SDFEU&gt;</code></strong> bboard sorted by activity (most recent first)
</p>
<pre>================================================================================
[ID] [DATE] [AUTHOR] [REP] [SUBJECT]
================================================================================
[1] 03-May-12 [john] [0] New feature: SDF-EU intertubes
--------------------------------------------------------------------------------
[2] 02-May-12 [jane] [0] SSH Port Forwarding question
02-May-12 [jim] [1]
02-May-12 [james] [2]
--------------------------------------------------------------------------------
[3] 02-May-12 [jess] [0] Meetup at EuroBSDcon
02-May-12 [joshua] [1]
02-May-12 [jack] [2]
[ SCROLL (F)ORWARD, (B)ACKWARD - (T)YPE, (R)EPLY or (Q)UIT ]</pre>
<p>
Like in the Boards Listing, you can navigate the Posts Listing with keys <code>F</code> and <code>B</code>. Pressing <code>Q</code> will return you to Command Mode.
</p>
<h3><a name="read_a_message" id="read_a_message">Read a message</a></h3>
<p>
Post #3 “Meetup at EuroBSCcon” caught your attention. To read it, press <code>T</code> (TYPE), followed by the post number (in this case <code>T → 3</code>) This will put you on Reading Mode at the first message from the thread. You could also start reading the thread from a specific message; simply enter <code>T → 3.2</code> if you want to start reading the thread #3 from the second reply.
</p>
<pre>TACKER: jess (Jessica G. Doe)
SUBJECT: Meetup at EuroBSDcon
DATE: 02-May-12 21:44:05
HOST: odin
Anybody wanting to organize a meetup @EuroBSDcon?
&lt;SDF.3.0&gt;(3)[ &lt;ENTER&gt; to follow thread, (R)EPLY or (Q)UIT ] </pre>
<h3><a name="post_a_message_reply" id="post_a_message_reply">Post a message/reply</a></h3>
<p>
To post a new thread on the bboard you are currently in, press <code>P</code> (POST) and enter a subject. To publicly reply to a post, press <code>R</code> (REPLY) If you are in Reading Mode, you will reply to the thread you are currently in. If you are in Posts Listing, you will be asked for the post number you want to reply. Either way you will end up in the pico editor <sup><a href="#fn__1" name="fnt__1" id="fnt__1"></a></sup>. Write down your reply and press <code>CTRL-x</code> to finish you post.
</p>
<table>
<tr>
<th> New Post </th>
</tr>
<tr>
<td> <pre>&lt;SDFEU.1&gt; Command: POST
Subject: Timezone?
You have written:
-----------------------------------------------------------
In which timezone(s) SDF-EU servers are?
This BULLETIN contains 40 characters in 6 words of 2 lines.
-----------------------------------------------------------
POST your BULLETIN? (y/n)
% Rebuilding symbol table for BBOARD:&lt;SDFEU&gt; [QUEUED]
Would you like to add a READERS POLL? (y/n)</pre>
</td>
</tr>
<tr>
<th> Reply </th>
</tr>
<tr>
<td> <pre>&lt;SDFEU.1&gt; Command: REPLY (A NUMBER) 3
REPLY to &quot;Meetup at EuroBSDcon&quot; ? (y/n)
You have replied:
-----------------------------------------------------------
I would love to!
This BULLETIN contains 16 characters in 4 words of 2 lines.
-----------------------------------------------------------
POST your REPLY? (y/n)</pre>
</td>
</tr>
</table>
<h3><a name="and_much_more" id="and_much_more">...and much more</a></h3>
<p>
Now that you are confortable with the bboard, try exploring additional features:
</p>
<ul>
<li> Post (<code>P</code>), reply (<code>R</code>) and depost (<code>D</code>) a message (use the <strong><code>&lt;TEST&gt;</code></strong> board for that)
</li>
<li> Review current voting polls (<code>V</code>) or propose your own.
</li>
<li> Explore the archives (<code>A</code>) and acquire ancient wisdom.
</li>
<li> See how many people are reading the bboard (<code>W</code>) and get amazed by their idle times.
</li>
<li> Read the the intro (<code>?</code>) and the list of commands (<code>H</code>).
</li>
<li> Check the man page (type <code>man bboard</code> at your shell) for a complete reference of settings at startup.
</li>
</ul>
<h2><a name="command_reference" id="command_reference">Command Reference</a></h2>
<table>
<tr>
<th align="left"> <code>(?)</code> </th><td> What is the BBOARD? </td>
</tr>
<tr>
<th align="left"> <code>(L)IST</code> </th><td> List bulletin summaries </td>
</tr>
<tr>
<th align="left"> <code>(G)OTO</code> </th><td> View another BBOARD (“GOTO” lists boards) </td>
</tr>
<tr>
<th align="left"> <code>(T)YPE</code> </th><td> Displays the selected bulletin </td>
</tr>
<tr>
<th align="left"> <code>(S)EARCH</code> </th><td> SEARCH the entire BBOARD on a KEYWORD </td>
</tr>
<tr>
<th align="left"> <code>(N)EW SCAN</code> </th><td> SCAN the current BBOARD for NEW messages </td>
</tr>
<tr>
<th align="left"> <code>(n)EW SCAN</code> </th><td> SCAN all BBOARDs for NEW messages </td>
</tr>
<tr>
<th align="left"> <code>(V)IEW POLLS</code> </th><td> SCAN the entire BBOARD for READER POLLS </td>
</tr>
<tr>
<th align="left"> <code>(F)ORWARD</code> </th><td> View the next thread within the current BBOARD </td>
</tr>
<tr>
<th align="left"> <code>(B)ACKWARD</code> </th><td> View the previous thread within the current BBOARD </td>
</tr>
<tr>
<th align="left"> <code>(P)OST</code> </th><td> POST a new bulletin (bulletins live 30 days) </td>
</tr>
<tr>
<th align="left"> <code>(D)EPOST</code> </th><td> DEPOST a bulletin you have posted </td>
</tr>
<tr>
<th align="left"> <code>(R)EPLY</code> </th><td> Respond to a bulletin </td>
</tr>
<tr>
<th align="left"> <code>(M)KBOARD</code> </th><td> Create a new BBOARD </td>
</tr>
<tr>
<th align="left"> <code>(K)ILL</code> </th><td> Toggle a BBOARD to and from your KILL list </td>
</tr>
<tr>
<th align="left"> <code>(A)RCHIVE</code> </th><td> Enter/Exit the BBOARD archives </td>
</tr>
<tr>
<th align="left"> <code>(C)OLORS</code> </th><td> Enable/disable colors </td>
</tr>
<tr>
<th align="left"> <code>(W)HO</code> </th><td> Who is reading the bboard </td>
</tr>
<tr>
<th align="left"> <code>(I)GNORE</code> </th><td> Manage your user ignore list </td>
</tr>
<tr>
<th align="left"> <code>(Q)UIT</code> </th><td> QUIT the BBOARD </td>
</tr>
</table>
<br />
<sup><a href="#fnt__1" id="fn__1" name="fn__1"></a></sup>
If you want to change your default editor, check the <code>bboard</code> man page via the <b>man bboard</b> command at the shell prompt.
<br /><br />
<h2><a name="customizing" id="customizing">Customizing bboard(1)</a></h2>
<p>Many SDF users find the lack of word-wrap and spell-checking when
posting in bboard(1) frustrating. If a Vi editor is acceptable, some
rudimentary auto-wrapping and spell-checking can be accomplished in
<i>bboard(1)</i> with the following configuration files in your HOME
(~$USER/) directory:</p>
<blockquote><pre><code>
#<b> ~$USER/.exrc</b>
" set auto-wrap width:"
set textwidth=78
" set RH margin guide:"
set guidewidth=79
" set elvis spellcheck stuff:"
set spell
set spelldict=/usr/share/dict/words
set spellautoload
#<b> ~$USER/.bboardrc</b>
# set editor to vi (will use elvis(1) editor):
EDITOR=vi
</code></pre></blockquote>
<p>Once these files are in place your bboard(1) post editing environment
will be elvis(1) based (a Vi editor clone; see <b>man elvis</b>) and should
display a highlighted right-hand margin guide at 79 characters over, with
text wrapping at 78 characters over. Note that these <i>~/.exrc</i>
settings may adversely affect other Vi-style editors like nvi(1) or
vim(1).</p>
<h3>Running Spell-check on a bboard(1) Post:</h3>
<p>Words deemed misspelled by the elvis(1) editor should appear in a
different color. To spell-check the entire post, first move to position
1,1 with <em>'1G'</em> (or use the arrow keys, or <em>'h,j,k,l'</em> keys
to navigate) then use <em>'gs'</em> to move to the first misspelled word.
If spelling suggestions are available they'll appear numbered at the bottom
of editing screen; to select, use <em>'#gs'</em>, where "#" is suggested
word number. If no spelling suggestions are available, look the word up
elsewhere, use <em>'cw'+[corrected word]+ESC</em> to correct, then
<em>'gs'</em> to move to next misspelled word.</p>
<p>When finished editing your bboard(1) post use <em>'ZZ'</em> to quit. If
you wish to cancel your post use <em>':q!'</em> to quit without saving.</p>
<h3>Learning to use Vi-style Editors:</h3>
<p>If you've never used a Vi-style editor you may wish to run the <i>vilearn(1)</i>
command within your SDF shell session to get some practice. The Vi editor
is <i>*modal*</i> - entering a Vi command such as <em>'i'</em> puts the editor in 'input'
mode; pressing the <em>Esc</em> key puts the editor it back in 'command' mode.
Within Vi, typing ':viusage' should display a summary of most Vi commands.</p>
<p>A free WikiBooks resource:
<a href="https://en.wikibooks.org/wiki/Learning_the_vi_Editor">Learning the Vi Editor</a></p>
<p>If you decide to practice with elvis(1), the <em>':help'</em> command
should provide an info(1)-like documentation environment (use
<em>':q'</em> to close it). Keep in mind that this :help documentation
is not available within bboard(1) as elvis(1) is run in a restricted
command mode. More extensive elvis(1) documentation is on the main SDF
hosts at <i>/usr/pkg/share/doc/elvis/elvis.html</i> .</p>
<h3>If you would rather use a pico-like editor with a bit more power:</h3>
<p>If you want to use an editor with in-program help and simple interface like the default <i>pico</i>, but slightly more powerful
than the default <b>bboard</b> editor, you may wish to instead set your editor to <i>nano</i>, which is the default editor
integrated into the Alpine mail program. It's the same as <i>pico</i>, but has additional commands, like regex searching.
<p>To do this, instead of setting up your <i>.bboardrc</i> as above, set it as follows (you can do this with <i>nano ~/.bboardrc</i>!):
<p>
<blockquote><pre><code>
#<b> ~$USER/.bboardrc</b>
# set editor to nano:
EDITOR=nano
</code></pre></blockquote>
<i>$Id: bboard-tutorial.html,v 1.12 2016/12/09 20:09:00 peteyboy Exp $</i>
</body>
</html>