Revise formatting on the community page (=defn to multi-para lists).

Markup in =defn terms and definitions is currently ignored; the use of itemisation here is a workaround.
Raku · Nov 1, 2019 · d4c9b23 · d4c9b23 · tbrowder · Nov 3, 2019
1 parent 89c0418
commit d4c9b23
Showing 1 changed file with 121 additions and 38 deletions.
diff --git a/doc/Language/community.pod6 b/doc/Language/community.pod6
@@ -33,27 +33,41 @@ More resources can be found in the L<perl6.org community page|https://perl6.org/
 The IRC channel has some very interesting bots. This is a full list with the name of the bot, a link to more information
 and a short description.
 
-=defn benchable L<More detail|https://github.com/perl6/whateverable/wiki/Benchable>
+=begin item
+B<benchable> (L<details|https://github.com/perl6/whateverable/wiki/Benchable>)
+
 An IRC bot for benchmarking code at a given commit of Rakudo. It
 can be addressed by its full name ('benchable6') or its short name
 ('bench'). It will run the given code five times and return the
 minimum amount of time taken.
+=end item
+
+=begin item
+B<bisectable> (L<details|https://github.com/perl6/whateverable/wiki/Bisectable>)
 
-=defn bisectable L<More detail|https://github.com/perl6/whateverable/wiki/Bisectable>
 This bot is meant to help you find when something got broken. If
 you want to know if something has ever worked use Committable
 instead.
+=end item
+
+=begin item
+B<bloatable> (L<details|https://github.com/perl6/whateverable/wiki/Bloatable>)
 
-=defn bloatable L<More detail|https://github.com/perl6/whateverable/wiki/Bloatable>
 An IRC bot for running bloaty on libmoar.so files of MoarVM. It can
 be addressed by its full name ('bloatable6') or its short name
 ('bloat' or 'bloaty'). It will run bloaty and pass one or more
 libmoar.so files from different revisions of MoarVM.
+=end item
+
+=begin item
+B<buggable> (L<details|https://github.com/zoffixznet/perl6-buggable>)
 
-=defn buggable L<More detail|https://github.com/zoffixznet/perl6-buggable>
 RT queue search and utility bot.
+=end item
+
+=begin item
+B<camelia>
 
-=defn camelia
 Perl 6 code evaluation bot. We use this for live testing of code
 that may be of interest to others; it chats back to the channel.
 C<perl6: my $a>
@@ -62,126 +76,195 @@ C<nqp: say('foo')>
 will test nqp,
 C<std: my $a>
 will parse the expression using STD.pm6. For other compilers, try C<camelia: help>.
+=end item
+
+=begin item
+B<committable> (L<details|https://github.com/perl6/whateverable/wiki/Committable>)
 
-=defn committable L<More detail|https://github.com/perl6/whateverable/wiki/Committable>
 An IRC bot for running code at a given commit of Rakudo. It can be
 addressed by its full name ('committable6') or its short names
 ('commit', 'c').
+=end item
+
+=begin item
+B<coverable> (L<details|https://github.com/perl6/whateverable/wiki/Coverable>)
 
-=defn coverable L<More detail|https://github.com/perl6/whateverable/wiki/Coverable>
 An IRC bot for creating a coverage report of the Rakudo (and NQP)
 source lines that were hit while running the code you give it. The
 first option is the commit, the second (optional) option is the
 filter for what lines of the MoarVM-generated coverage log you
 want, the third is the code to run.
+=end item
+
+=begin item
+B<Geth> (L<details|https://github.com/perl6/geth>)
 
-=defn Geth L<More detail|https://github.com/perl6/geth>
 Announces commits made to various projects relevant to Raku, such
 as implementations of Raku and some of the
 L<repositories owned by Raku|https://github.com/perl6/>.
+=end item
+
+=begin item
+B<evalable> (L<details|https://github.com/perl6/whateverable/wiki/Evalable>)
 
-=defn evalable L<More detail|https://github.com/perl6/whateverable/wiki/Evalable>
-Evalable is just Committable that defaults to <code>HEAD</code>.
+Evalable is just Committable that defaults to C<HEAD>.
+=end item
+
+=begin item
+B<greppable> (L<details|https://github.com/perl6/whateverable/wiki/Greppable>)
 
-=defn greppable L<More detail|https://github.com/perl6/whateverable/wiki/Greppable>
 An IRC bot for grepping through the module ecosystem. It can be
 addressed by its full name ('greppable6') or its short name
 ('grep').
+=end item
+
+=begin item
+B<huggable> (L<details|https://github.com/zoffixznet/huggable>)
 
-=defn huggable L<More detail|https://github.com/zoffixznet/huggable>
-Let's you <code>.hug</code> people in the channel.
+Let's you C<.hug> people in the channel.
+=end item
+
+=begin item
+B<ilbot> (L<details|https://github.com/moritz/ilbot>)
 
-=defn ilbot L<More detail|https://github.com/moritz/ilbot>
 IRC logging bot.
+=end item
+
+=begin item
+B<nativecallable> (L<details|https://github.com/perl6/whateverable/wiki/Nativecallable>)
 
-=defn nativecallable L<More detail|https://github.com/perl6/whateverable/wiki/Nativecallable>
 an IRC bot for generating Perl 6 NativeCall code from C
 definitions. It can be addressed by its full name
 ('nativecallable6') or its short name ('nativecall'). The bot is
 using C<App::GPTrixie> to do the conversion.
+=end item
+
+=begin item
+B<notable> (L<details|https://github.com/perl6/whateverable/wiki/Notable>)
 
-=defn notable L<More detail|https://github.com/perl6/whateverable/wiki/Notable>
 an IRC bot for for noting things. It can be addressed by its full name ('notable6')
 or its short name ('note'). There is also a “weekly:” shortcut.
+=end item
 
-=defn quotable L<More detail|https://github.com/perl6/whateverable/wiki/Quotable>
+=begin item
+B<quotable> (L<details|https://github.com/perl6/whateverable/wiki/Quotable>)
  An IRC bot for searching messages in the IRC log. It can be
  addressed by its full name ('quotable6') or its short name
  ('quote').
+=end item
+
+=begin item
+B<releasable> (L<details|https://github.com/perl6/whateverable/wiki/Releasable>)
 
-=defn releasable L<More detail|https://github.com/perl6/whateverable/wiki/Releasable>
 An IRC bot for getting information about the upcoming release. It
 can be addressed by its full name ('releasable6') or its short name
 ('release').
 
 As a user, you are probably only interested in its only command
 “status”. It tells when the next release is going to happen and how
 many blockers are there.
+=end item
+
+=begin item
+B<reportable> (L<details|https://github.com/perl6/whateverable/wiki/Reportable>)
 
-=defn reportable L<More detail|https://github.com/perl6/whateverable/wiki/Reportable>
 An IRC bot for generating reports of changes in rakudo RT and GitHub issue trackers
 (which issues were resolved, updated, rejected, etc.). It can be addressed by its full name
 ('reportable6') or its short name ('report'). It takes snapshots of issue trackers
 periodically, and then you can ask it to generate a report for two given snapshots.
 
 See also: L<Weekly, Monthly and Yearly reports|https://github.com/rakudo/rakudo/wiki/Ticket-updates>
+=end item
+
+=begin item
+B<shareable> (L<details|https://github.com/perl6/whateverable/wiki/Shareable>)
+
+An IRC bot for making rakudo builds produced by Whateverable publicly available.
+It can be addressed by its full name ('shareable6').
 
-=defn shareable L<More detail|https://github.com/perl6/whateverable/wiki/Shareable>
- An IRC bot for making rakudo builds produced by Whateverable publicly available.
- It can be addressed by its full name ('shareable6').
+Note that the build will be located
+in C</tmp/whateverable/rakudo-moar/SOME-SHA/>. Also, as of today these files are only
+useful for you if you're on linux x86_64.
+=end item
 
- Note that the build will be located
-  in /tmp/whateverable/rakudo-moar/SOME-SHA/. Also, as of today these files are only
-  useful for you if you're on linux x86_64.
+=begin item
+B<SourceBaby> (L<details|https://github.com/zoffixznet/perl6-sourceable>)
 
-=defn SourceBaby L<More detail|https://github.com/zoffixznet/perl6-sourceable>
 Core source code locator
+=end item
+
+=begin item
+B<squashable> (L<details|https://github.com/perl6/whateverable/wiki/Squashable>)
 
-=defn squashable L<More detail|https://github.com/perl6/whateverable/wiki/Squashable>
 An IRC bot for the Monthly Bug Squash Day (a.k.a. Community Bug
 SQUASHathon). It can be addressed by its full name ('squashable6')
 or its short name ('squash'). It can tell you when the next even is
 going to happen and what's the current status of the active event.
 Also, it will also announce changes to the repo.
+=end item
+
+=begin item
+B<statisfiable> (L<details|https://github.com/perl6/whateverable/wiki/Statisfiable>)
 
-=defn statisfiable L<More detail|https://github.com/perl6/whateverable/wiki/Statisfiable>
 An IRC bot that can gather stats across rakudo builds. It can be
 addressed by its full name ('statisfiable6') or its short name
 ('stat'). For most commands it will reply with a gist that has a
 graph and the raw data. Note that stats are cached, but it takes
 some time for it to generate the graph, so be patient.
+=end item
+
+=begin item
+B<synopsebot6> (L<details|https://github.com/perl6/synopsebot>)
 
-=defn synopsebot6 L<More detail|https://github.com/perl6/synopsebot>
 Creates links to the synopses and turns mentions of RT ticket
 numbers into clickable RT links.
+=end item
+
+=begin item
+B<tellable> (L<details|https://github.com/perl6/whateverable/wiki/Tellable>)
 
-=defn tellable L<More detail|https://github.com/perl6/whateverable/wiki/Tellable>
 An IRC bot for passing messages to users who are currently offline.
 You can also use it to see when was the last time somebody talked.
+=end item
+
+=begin item
+B<Undercover> (L<details|https://github.com/zoffixznet/undercover>)
 
-=defn Undercover L<More detail|https://github.com/zoffixznet/undercover>
 Very similar to SourceBaby, except points to
 L<rakudo.party|https://wtf.rakudo.party/> indicating stress test coverage of code.
+=end item
+
+=begin item
+B<undersightable> (L<details|https://github.com/perl6/whateverable/wiki/Undersightable>)
 
-=defn undersightable L<More detail|https://github.com/perl6/whateverable/wiki/Undersightable>
- An IRC bot for checking that important things are operating correctly (websites are up,
- bots are online, released tarballs are correct, etc.). It can be addressed by its full name
- ('undersightable6').
+An IRC bot for checking that important things are operating correctly (websites are up,
+bots are online, released tarballs are correct, etc.). It can be addressed by its fullname
+('undersightable6').
+=end item
+
+=begin item
+B<unicodable> (L<details|https://github.com/perl6/whateverable/wiki/Unicodable>)
 
-=defn unicodable L<More detail|https://github.com/perl6/whateverable/wiki/Unicodable>
 An IRC bot for getting interesting information about Unicode
 characters. It can be addressed by its full name ('unicodable6') or
 its short name ('u').
+=end item
+
+=begin item
+B<PufferBot> (L<details|https://github.com/Kaiepi/p6-RakudoBot>)
 
-=defn PufferBot L<More detail|https://github.com/Kaiepi/p6-RakudoBot>
 An IRC bot for testing builds of Rakudo on OpenBSD. It can be
 addressed by its full name ('PufferBot'). Talks only in
 L<#perl6-dev|https://webchat.freenode.net/?channels=#perl6-dev>.
+=end item
+
+=begin item
+B<BeastieBot> (L<details|https://github.com/Kaiepi/p6-RakudoBot>)
 
-=defn BeastieBot L<More detail|https://github.com/Kaiepi/p6-RakudoBot>
 An IRC bot for testing builds of Rakudo on FreeBSD. It can be
 addressed by its full name ('BeastieBot'). Talks only in
 L<#perl6-dev|https://webchat.freenode.net/?channels=#perl6-dev>.
+=end item
 
 
 =head2 Offline communities