Mostly typos/omissions/markup errors, more remarkable e. g. changing
'b' to 'B' in tutorial reflecting a change from 1.2.
Also uncommented [macros] section in asciidoc.conf (is that right?).
Signed-off-by: Doug Kearns <dougkearns@gmail.com>
This reverts commit a401e3ebf34c964ca508c189e1daf9b0b18e57b9.
Explicit numbering is easier to read, and will likely be required if and when
we switch to Vim's help format.
At the moment, only "syntax=asciidoc" was specified. The
asciidoc_filetype.vim that is distributed with Asciidoc gives the
installer two options -- to either associate every *.txt file with
asciidoc or to try to decipher whether or not the file is an asciidoc
using the first 50 lines.
So it's not given that a developer will open the *.txt files with
ft=asciidoc, and so it's helpful to have it explicitly in the modeline.
Automatic numbering exists for a reason. It's more elegant and easy to
manage. Additionally, because numbering rules can be specified centrally,
it adds consistency to the final look of the documents. An editor shouldn't
have to think about the current numbering level or number. That should be
handled by asciidoc as it builds the final doc.
[ However, added explicit first number to make list source code look a
little better. ]
Also moved $VIMPERATOR_INIT keyword to its correct location in
starting.txt.
This change partially reverts changeset a1f264639f27d7d5b87e5fbccf54d6890a03ca7d.
Most of the special case asciidoc replacements were also removed since
they're a bit confusing and doing so results in a 60% improvement in the
time taken by asciidoc to process the help pages. Unfortunately, I'm
now limited to preparing a three course menu for my guests while it runs
rather than the degustation extravaganzas of the past but such is life.
It's still a bit of a mess but since we're almost certainly moving to
something else in the near future it's probably not worth cleaning it up
before 2.0 is released.
Doug Kearns