Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

relates to issue #60 #62

Merged
merged 2 commits into from
Nov 30, 2024
Merged

relates to issue #60 #62

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1174ca1
relates to issue #60
finanalyst Nov 29, 2024
365dd96
re-order sequence
finanalyst Nov 30, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions rakudoc_draft_3.rakudoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
=begin rakudoc :kind("Language") :subkind("Language") :category("reference")
=TITLE RakuDoc
=SUBTITLE A Raku slang for documenting Raku software to aid development and use.
=VERSION 2.10.1
=VERSION 2.10.2

RakuDoc is a markup language with simple instructions for simple tasks and more
complex structures to suit larger projects. There is a clear distinction between
Expand Down Expand Up @@ -1256,7 +1256,8 @@ emphasize a particular keyword in an example (using a C<B<>> code). Or you may w
part of the example is metasyntactic (using the C<R<>> code). Or you might need to insert a non-ASCII
character (using the C<E<>> code).

You can specify a list of markup instructions that should still be recognized within a code block using
You can specify a list of L<display only|#Display only codes> markup instructions (B C H I J K N O R S T U V)
that should still be recognized within a code block using
the C<:allow> option. The value of the C<:allow> option must be a list of the (single-letter)
names of one or more markup instructions. Those codes will then remain active inside the code block.
For example:
Expand Down Expand Up @@ -3731,20 +3732,20 @@ specified as an entity (C«E<VERTICAL LINE>»).

The following codes may I<only> contain display text:
=begin nested
=begin code :allow<B I V> :lang<RakuDoc>
=begin code :allow<B I V> :lang<RakuDoc>B C H I J K N O R S T U V
BV«< » I<DISPLAY-TEXT> V« >»
CV«< » I<DISPLAY-TEXT> V« >»
HV«< » I<DISPLAY-TEXT> V« >»
IV«< » I<DISPLAY-TEXT> V« >»
JV«< » I<DISPLAY-TEXT> V« >»
KV«< » I<DISPLAY-TEXT> V« >»
NV«< » I<DISPLAY-TEXT> V« >»
OV«< » I<DISPLAY-TEXT> V« >»
RV«< » I<DISPLAY-TEXT> V« >»
SV«< » I<DISPLAY-TEXT> V« >»
TV«< » I<DISPLAY-TEXT> V« >»
UV«< » I<DISPLAY-TEXT> V« >»
VV«< » I<DISPLAY-TEXT> V« >»
NV«< » I<DISPLAY-TEXT> V« >»
OV«< » I<DISPLAY-TEXT> V« >»
=end code
=end nested

Expand Down