It has been several years since the last work to improve the yet
incomplete conversion to AsciiDoc. I originally wanted to have this in
the upstream repository to generate interest and involve more
contributors with the required manual fixes. However, I also lost the
focus on the guide conversion and did not continue the work.
At this point, having the unfinished conversion attempt in the
repository does more harm than it does good as it especially confuses
new contributors. Let's accept this is not happening and remove the
adoc/ directory.
Keeping track of all the version numbers will become cumbersome at some
point. Also it adds extra work to remove the audience="" tags after
a release.
I recommend we use normal git branches for this instead.
This reverts commit bf54d37442.
This makes use of DocBook profiling using the audience="" attribute.
Example:
<para audience="2.4">This is for users of MacPorts 2.4.x</para>
<para audience="2.5">This is for users of MacPorts 2.5.0 or later</para>
See the DocBook XSL guide for all details:
http://www.sagehill.net/docbookxsl/Profiling.html