Re: [PATCH v4 2/6] Update terminology and specification tables


Anup Patel
 

Hi Peter,

 

I think the links are malformed if we directly click from

this email because these links are in asciidoc syntax.

 

The link syntax for asciidoc is:

link:<url>[<display_text>]

 

Based on above syntax <display_text> will be part

of generated HTML or PDF which will hyperlinked

to the <url>

 

Regards,

Anup

 

From: Peter Glaskowsky <peter.glaskowsky@...>
Date: Sunday, 8 August 2021 at 12:25 PM
To: Greg Favor <gfavor@...>
Cc: Anup Patel <Anup.Patel@...>, "tech-unixplatformspec@..." <tech-unixplatformspec@...>, Kumar Sankaran <ksankaran@...>, Atish Patra <Atish.Patra@...>, Abner Chang <abner.chang@...>
Subject: Re: [RISC-V] [tech-unixplatformspec] [PATCH v4 2/6] Update terminology and specification tables

 

Greg and Anup,

 

I think the links are mostly just malformed.

 

For example, the first one was presumably meant to go to

 

 

and that URL does work for me, but the lack of a space at the end of the URL means that just clicking on it sends me to

 

 

which does produce a 404.

 

Best,

 

.                  png



On Aug 6, 2021, at 11:27 PM, Greg Favor <gfavor@...> wrote:

 

On Fri, Aug 6, 2021 at 11:13 PM Anup Patel <anup.patel@...> wrote:

This patch updates terminology and specification table in
following ways:

 

When I try some of the added links, I end up at "404" pages.

 

Many of these links are to revs of spec's that are current but only temporary - until superseded by a later rev.

 

Ultimately these links should all be to ratified/approved documents - which by definition won't materially change.  But in the meantime the current links are quickly going to become stale over the next couple of months.  And a couple have already been superseded by more recent revs.  These links should instead be to the github pages from which one can then find the PDF and/or adoc of the latest draft of the document.

 

Greg

 

2) Add links to unprivileged and privileged specifications
3) Add link to legacy PLIC specification
4) Add links to AIA and ACLINT specifications

 

 |SPECIFICATION      | VERSION
 |link:https://uefi.org/sites/default/files/resources/UEFI_Spec_2_9_2021_03_18.pdf[UEFI Specification]         | v2.9   
 |link:https://github.com/devicetree-org/devicetree-specification/releases/tag/v0.3[Devicetree Specification]  | v0.3
-|link:https://github.com/riscv/riscv-sbi-doc/blob/master/riscv-sbi.adoc[SBI Specification]                    | v0.3
-|link:[RVA22 Specification]                                                                                   | TBD
+|link:https://github.com/riscv/riscv-isa-manual/releases/download/draft-20210726-2026469/riscv-spec.pdf[RISC-V Unprivileged Architecture Specification] | 20191214-draft
+|link:https://github.com/riscv/riscv-isa-manual/releases/download/draft-20210726-2026469/riscv-privileged.pdf[RISC-V Privileged Architecture Specification] | v1.12-draft
+|link:https://github.com/riscv/riscv-sbi-doc/blob/master/riscv-sbi.adoc[RISC-V SBI Specification] | v0.3
+|link:https://github.com/riscv/riscv-plic-spec/blob/master/riscv-plic.adoc[RISC-V PLIC Specification] | v1.0
+|link:https://github.com/riscv/riscv-aclint/releases/download/v1.0-draft2/riscv-aclint-1.0-draft2.pdf[RISC-V ACLINT Specification] | v1.0-draft2
+|link:https://github.com/riscv/riscv-aia/releases/download/0.2-draft.24/riscv-interrupts-024.pdf[RISC-V AIA Specification] | v0.2-draft.24
+|link:https://github.com/riscv/riscv-profiles/blob/master/profiles.adoc[RISC-V Profiles Specification]| Draft
 |link:https://arm-software.github.io/ebbr/[EBBR Specification]                                                | v2.0.0   
 |link:https://uefi.org/sites/default/files/resources/ACPI_Spec_6_4_Jan22.pdf[ACPI Specification]              | v6.4
 |link:https://uefi.org/specs/ACPI/6.4/18_ACPI_Platform_Error_Interfaces/ACPI_PLatform_Error_Interfaces.html[APEI Specification]              | v6.4
 |link:https://www.dmtf.org/sites/default/files/standards/documents/DSP0134_3.4.0.pdf[SMBIOS Specification]    | v3.4.0
-|link:[Platform Policy]                                                                                       | TBD

 

Join tech-unixplatformspec@lists.riscv.org to automatically receive all group messages.