summaryrefslogtreecommitdiffstats
path: root/source-builder/sb/asciidoc/examples/website/newlists.txt
diff options
context:
space:
mode:
authorChris Johns <chrisj@rtems.org>2013-03-03 15:58:11 +1100
committerChris Johns <chrisj@rtems.org>2013-03-03 15:58:11 +1100
commit0464153b36015012c5a2ff14d6d3f65fe04f476b (patch)
treec877a69503720afce35ee9fc111eb83d3a219c27 /source-builder/sb/asciidoc/examples/website/newlists.txt
parentImport more of asciidoc. (diff)
downloadrtems-source-builder-0464153b36015012c5a2ff14d6d3f65fe04f476b.tar.bz2
Change asciidoc to the 8.6.4 release package because Windows was broken.
Diffstat (limited to 'source-builder/sb/asciidoc/examples/website/newlists.txt')
-rw-r--r--source-builder/sb/asciidoc/examples/website/newlists.txt40
1 files changed, 40 insertions, 0 deletions
diff --git a/source-builder/sb/asciidoc/examples/website/newlists.txt b/source-builder/sb/asciidoc/examples/website/newlists.txt
new file mode 100644
index 0000000..3edc3a7
--- /dev/null
+++ b/source-builder/sb/asciidoc/examples/website/newlists.txt
@@ -0,0 +1,40 @@
+AsciiDoc New Lists
+==================
+
+*New in version 8.3.0*
+
+Lists can now be styled like other block elements, this allows the
+normal bulleted and labeled list syntax to be used for 'glossary',
+'qanda' (Question and Answer) and 'bibliography' lists instead of
+having to remember a different syntax for each one. In the same vein
+there is only one labeled list syntax, horizontal labeled lists are
+rendered by applying the 'horizontal' style. Examples:
+
+---------------------------------------------------------------------
+[glossary]
+A glossary term::
+ The corresponding definition.
+A second glossary term::
+ The corresponding definition.
+
+[horizontal]
+Lorem:: Fusce euismod commodo velit.
+Ipsum:: Vivamus fringilla mi eu lacus.
+---------------------------------------------------------------------
+
+The list related stuff in the configuration files has been
+rationalized with separate 'listtags-\*' sections (c.f. table
+'tabletags-*' sections). The old list tags are no longer supported so
+you'll need to update your custom configuration file list definitions.
+
+These changes necessitated the following backward incompatibilities:
+
+. You have to explicitly precede horizontal labeled lists with the
+ `[horizontal]` style attribute -- if you do nothing the existing
+ horizontal labeled lists will be rendered vertically.
+. The old 'compact' list style is now implemented as a list option, to
+ update replace `[compact]` with `[options="compact"]`. You can now
+ apply the 'compact' option globally by setting the `compact-option`
+ document attribute.
+. You'll need to update any customized configuration file list
+ definitions that have been made.