Typographical Conventions
From DocBase
Typographical Conventions by Ladislav Mecir | ||
|
This is a Documentation Recipe |
Add your own Cookbook Recipe | |
|
[edit]
Suggested conventions for documenting REBOL
| Category | Style | How to do it in WikiText |
|---|---|---|
| emphasized text | emphasized text | ''emphasized text'' (double apostrophe) |
| REBOL words | bold-and-italic | '''''bold-and-italic''''' (quintuple apostrophe) |
| values of REBOL variables | bold | '''bold''' (triple apostrophe) |
| embedded REBOL expression | typewriter text | <tt>typewriter text</tt> |
Note: REBOL variables are REBOL words that are bound to a context, unbound words don't have values.
Use:
- do to represent the value of the do variable - in a fresh console this is a native that does not have a serialized form
- none to represent the value of the none variable - in a fresh console this is the value that can be literally represented as #[none] or #[none!]
- true to represent the value of the true variable - in a fresh console this is the value that can be literally represented as #[true]
- unset! to represent the value of the unset! variable - in a fresh console this is the value that can be literally represented as #[datatype! unset!]
- unset to represent the value of the unset variable - in a fresh console this is a native that does not have a serialized form
, etc.
The above rules mean, that the #[unset!] value should be represented using neither of unset (the word), unset (the native), unset! (the word), unset! (the datatype).
[edit]
Cookbook References
| Class | Documents |
|---|---|
| Usage | |
| Authoring | |
| See Also |
