Re: [PATCH 00/11] Clean up the asciidoc


On Wed, 2020-10-07 at 14:53 -0600, Al Stone wrote:
In order to make the specification easier to work on in the future,
and to start filling in some of the blanks such as title and
these patches rearrange what already exists.

The only substantive changes are to use additional asciidoc
add a table of contents, a changelog, and add a list of contributors.
The remainder of the content is unchanged from the original version,
though it may have been separated out into a new file. As proposals
are discussed and decided upon, then the content will start changing
-- but that's outside of these changes.

I also expect the structure of the spec to evolve over time, so these
changes are only a starting point until we learn more.

These patches are also being submitted as PR#7 on github. HOWEVER,
please provide commentary and discussion here on the mailing list,
github. Not everyone uses github, but everyone is on the mailing


Al Stone (11):
Rename the base file for the spec to riscv-platform-spec.adoc
Add a Makefile
Add a .gitignore file
Add some initial asciidoc structure
Add in a Table of Contents
Separate licensing information into a different file
Add a file that lists contributors
Introduce a changelog
Separate the introduction into a new file
Separate out platform sections from original document
Separate out the profile section from original document

.gitignore | 4 +++
Makefile | 41 +++++++++++++++++++++++
changelog.adoc | 14 ++++++++
contributors.adoc | 31 +++++++++++++++++
introduction.adoc | 23 +++++++++++++
licensing.adoc | 21 ++++++++++++
profiles.adoc | 13 ++++++++
riscv-platform-spec.adoc | 44 ++++++++++++++++++++++++
riscv-unix.adoc | 72 --------------------------------------
supervisor-level.adoc | 26 +++++++++++++++
user-level.adoc | 23 +++++++++++++
11 files changed, 240 insertions(+), 72 deletions(-)
create mode 100644 .gitignore
create mode 100644 Makefile
create mode 100644 changelog.adoc
create mode 100644 contributors.adoc
create mode 100644 introduction.adoc
create mode 100644 licensing.adoc
create mode 100644 profiles.adoc
create mode 100644 riscv-platform-spec.adoc
delete mode 100644 riscv-unix.adoc
create mode 100644 supervisor-level.adoc
create mode 100644 user-level.adoc
For the entire series:
Reviewed-by: Atish Patra <atish.patra@...>


Join to automatically receive all group messages.