From 36cd4e7cd52cb18b086c490a352eda8a1919b5ea Mon Sep 17 00:00:00 2001
From: Luke Kenneth Casson Leighton <lkcl@lkcl.net>
Date: Sun, 29 Oct 2023 16:55:16 +0000
Subject: [PATCH] add transcendentals draft rfc ls017.transcendentals
 https://bugs.libre-soc.org/show_bug.cgi?id=1196 this is a placeholder

---
 openpower/sv/rfc/ls017.transcendentals.mdwn | 101 ++++++++++++++++++++
 1 file changed, 101 insertions(+)
 create mode 100644 openpower/sv/rfc/ls017.transcendentals.mdwn

diff --git a/openpower/sv/rfc/ls017.transcendentals.mdwn b/openpower/sv/rfc/ls017.transcendentals.mdwn
new file mode 100644
index 000000000..3056194a1
--- /dev/null
+++ b/openpower/sv/rfc/ls017.transcendentals.mdwn
@@ -0,0 +1,101 @@
+# RFC ls017 Transcendental instructions for 3D and 
+
+* Funded by NLnet under the Privacy and Enhanced Trust Programme, EU
+  Horizon2020 Grant 825310, and NGI0 Entrust No 101069594
+* <https://libre-soc.org/openpower/sv/rfc/ls017.transcendentals/>
+* <https://bugs.libre-soc.org/show_bug.cgi?id=1196>
+
+**Severity**: Major
+
+**Status**: New
+
+**Date**: 29 Apr 2023
+
+**Target**: v3.2B
+
+**Source**: v3.1B
+
+**Books and Section affected**:
+
+```
+    Book I Floating-Point Instructions
+    Appendix E Power ISA sorted by opcode
+    Appendix F Power ISA sorted by version
+    Appendix G Power ISA sorted by Compliancy Subset
+    Appendix H Power ISA sorted by mnemonic
+```
+
+**Summary**
+
+```
+    Instructions added: 43 transcendental mathematical to SFFS
+```
+
+**Submitter**: Luke Leighton (Libre-SOC)
+
+**Requester**: Libre-SOC
+
+**Impact on processor**:
+
+```
+    Addition of new Transcendental instructions
+```
+
+**Impact on software**:
+
+```
+    Requires support for new instructions in assembler, debuggers, and
+    related tools.  Greatly decreases instruction count in 3D and HPC.
+```
+
+**Keywords**:
+
+```
+    Scientific Computing, HPC, 3D, OpenCL,
+```
+
+**Motivation**
+
+Allows 3D GPU Products to be commercially viable.
+
+**Changes**
+
+Add the following entries to:
+
+* the Appendices of Book I
+* Book I 4.6.6.4 Transcendental Instructions
+* Book I 1.6.1 and 1.6.2
+
+----------
+
+\newpage{}
+
+[[!inline pages="openpower/power_trans_ops" raw=yes ]]
+
+----------
+
+\newpage{}
+
+# Appendices
+
+    Appendix E Power ISA sorted by opcode
+    Appendix F Power ISA sorted by version
+    Appendix G Power ISA sorted by Compliancy Subset
+    Appendix H Power ISA sorted by mnemonic
+
+| Form | Book | Page | Version | Mnemonic | Description |
+|------|------|------|---------|----------|-------------|
+| A    | I    | #    | 3.2B    |maddsubrs | Integer DCT/FFT Twin-Butterfly |
+| X    | I    | #    | 3.2B    |fdmadds   | FP DCT Twin-Butterfly Single |
+| X    | I    | #    | 3.2B    |ffmadds   | FP FFT Twin-Butterfly Single |
+| X    | I    | #    | 3.2B    |fdmadds   | FP DCT Twin-Butterfly Double |
+| X    | I    | #    | 3.2B    |ffmadds   | FP FFT Twin-Butterfly Double |
+| X    | I    | #    | 3.2B    |ffadds    | FP FFT Twin-Butterfly Single |
+| X    | I    | #    | 3.2B    |ffadd     | FP FFT Twin-Butterfly Double |
+| X    | I    | #    | 3.2B    |ffsubs    | FP FFT Twin-Butterfly Single |
+| X    | I    | #    | 3.2B    |ffsub     | FP FFT Twin-Butterfly Double |
+
+[[!tag opf_rfc]]
+
+----------
+
-- 
2.30.2