From b343bfba0773f6193c0c4e9f07cf75d00d119e32 Mon Sep 17 00:00:00 2001
From: Mohamed Ibrahim <mibrahim@mibrahim.net>
Date: Fri, 28 Aug 2015 23:18:00 -0400
Subject: [PATCH] Fix file names and links
---
doc/HSAEnablementOfLambdaBranch.md | 32 +++++++++++++++++++
doc/HSAEnablementOfLambdaBranchSidebar.md | 4 +--
doc/README.md | 8 ++---
... => SettingUpLinuxHSAMachineForAparapi.md} | 8 +++++
...ttingUpLinuxHSAMachineForAparapiSidebar.md | 0
...ingAparapiLambdaBranchWithHSASimulator.md} | 0
6 files changed, 46 insertions(+), 6 deletions(-)
create mode 100644 doc/HSAEnablementOfLambdaBranch.md
rename doc/{HowtosetupaHSAsimulatoronaLinuxPlatform.md => SettingUpLinuxHSAMachineForAparapi.md} (95%)
create mode 100644 doc/SettingUpLinuxHSAMachineForAparapiSidebar.md
rename doc/{HowtosetupaHSAenabledLinuxPlatform.md => UsingAparapiLambdaBranchWithHSASimulator.md} (100%)
diff --git a/doc/HSAEnablementOfLambdaBranch.md b/doc/HSAEnablementOfLambdaBranch.md
new file mode 100644
index 00000000..15e7fe9c
--- /dev/null
+++ b/doc/HSAEnablementOfLambdaBranch.md
@@ -0,0 +1,32 @@
+#HSAEnablementOfLambdaBranch
+*Adding HSA Support to Aparapi lambda branch Updated Feb 28, 2014 by frost.g...@gmail.com*
+
+* [How to setup a HSA enabled Linux Platform](SettingUpLinuxHSAMachineForAparapi.md)
+* [How to setup a HSA simulator on a Linux Platform](UsingAparapiLambdaBranchWithHSASimulator.md)
+
+Recently the HSA Foundation released their ‘Programmers Reference Manual’. This manual is for developers wishing to write code for upcoming HSA compatible devices, it describes the HSA Intermediate Language (HSAIL) along with its binary form (BRIG) and describes how code is expected to execute on a HSA enabled devices.
+
+In many ways we can think of HSAIL as we do Java bytecode. It is a common intermediate form that can be optimized at runtime to execute across a variety of future heterogeneous platforms. HSAIL will greatly simplify the development of software taking advantage of both sequential and parallel compute solutions.
+
+Now that the spec is out, we have started adding HSA support to the Aparapi lambda branch. We believe that HSA combined with the upcoming Java 8 feature lambda will be a natural way to express parallel algorithms which can be executed on the GPU via HSA.
+
+A HSA+Lambda enabled Aparapi will remove many of Aparapi's constraints. HSA allows all of the CPU's memory to be accessed directly from code running on the GPU. This means
+
+* We no longer need to move data from the host CPU to the GPU.
+* We are no longer limited to the memory addressable from the GPU
+* We can access multi-dim arrays efficiently
+* We can access Java objects directly from the GPU.
+These are all substantial benefits.
+
+In the existing code (early prototype) we provide access to HSA as a specific device type.
+
+So our ubiquitous 'squares' example will initially be written as:
+
+ int in[] = ..//
+ int out[] = .../
+ Device.hsa().forEach(in.length, (i)->{
+ out[i] = in[i]*in[i];
+ });
+You will obviously need a Java 8 compatible JDK ([https://jdk8.java.net/download.html](https://jdk8.java.net/download.html)) in your path.
+
+We also recommend using IntelliJ which has preliminary support for Java 8 lambda features. You can download the community edition of IntelliJ from [http://www.jetbrains.com/idea/](http://www.jetbrains.com/idea/)
\ No newline at end of file
diff --git a/doc/HSAEnablementOfLambdaBranchSidebar.md b/doc/HSAEnablementOfLambdaBranchSidebar.md
index e8b2147b..32754522 100644
--- a/doc/HSAEnablementOfLambdaBranchSidebar.md
+++ b/doc/HSAEnablementOfLambdaBranchSidebar.md
@@ -1,6 +1,6 @@
#HSAEnablementOfLambdaBranchSidebar
*Sidebar for HSAEnablementOfLambdaBranchAparapi*
-[How to setup a HSA enabled Linux Platform](HowtosetupaHSAenabledLinuxPlatform.md)
+[How to setup a HSA enabled Linux Platform](SettingUpLinuxHSAMachineForAparapi.md)
-[How to setup a HSA simulator on a Linux Platform](HowtosetupaHSAsimulatoronaLinuxPlatform.md)
+[How to setup a HSA simulator on a Linux Platform](UsingAparapiLambdaBranchWithHSASimulator.md)
diff --git a/doc/README.md b/doc/README.md
index 77a8d891..280f1866 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -4,12 +4,12 @@ APARAPI Documentation
| | |
|----------------|------|
| [PrivateMemorySpace](privatememoryspace.md)| Using `__private` memory space in Aparapi kernels. |
-| [SettingUpLinuxHSAMachineForAparapi](settinguplinuxhsamachineforaparapi.md) | How to setup a Linux HSA machine for testing HSA enabled Aparapi |
+| [SettingUpLinuxHSAMachineForAparapi](SettingUpLinuxHSAMachineForAparapi.md) | How to setup a Linux HSA machine for testing HSA enabled Aparapi |
| [PossibleAparapiLambdaSyntaxOptions](PossibleAparapiLambdaSyntaxOptions.md) | Syntax suggestions for HSA enabled Aparapi |
| [HSAEnablementOfLambdaBranchSidebar](HSAEnablementOfLambdaBranchSidebar.md)| Sidebar for HSAEnablementOfLambdaBranchAparapi|
-| HSAEnablementOfLambdaBranch | Adding HSA Support to Aparapi lambda branch |
-| UsingAparapiLambdaBranchWithHSASimulator | One-sentence summary of this page. |
-| SettingUpLinuxHSAMachineForAparapiSidebar | Sidebar for SettingUpLinuxHSAMachineForAparapi |
+| [HSAEnablementOfLambdaBranch](HSAEnablementOfLambdaBranch.md) | Adding HSA Support to Aparapi lambda branch |
+| [UsingAparapiLambdaBranchWithHSASimulator](UsingAparapiLambdaBranchWithHSASimulator.md) | One-sentence summary of this page. |
+| [SettingUpLinuxHSAMachineForAparapiSidebar](SettingUpLinuxHSAMachineForAparapiSidebar.md) | Sidebar for SettingUpLinuxHSAMachineForAparapi |
| HSASidebar | |
| AddingLambdasToAparapi | Adding Java 8 Lambda Support to Aparapi |
| ProfilingKernelExecution | Using Aparapi's built in profiling APIs |
diff --git a/doc/HowtosetupaHSAsimulatoronaLinuxPlatform.md b/doc/SettingUpLinuxHSAMachineForAparapi.md
similarity index 95%
rename from doc/HowtosetupaHSAsimulatoronaLinuxPlatform.md
rename to doc/SettingUpLinuxHSAMachineForAparapi.md
index ccf7a4de..edf564be 100644
--- a/doc/HowtosetupaHSAsimulatoronaLinuxPlatform.md
+++ b/doc/SettingUpLinuxHSAMachineForAparapi.md
@@ -1,6 +1,14 @@
#SettingUpLinuxHSAMachineForAparapi
*How to setup a Linux HSA machine for testing HSA enabled Aparapi Updated May 22, 2014 by frost.g...@gmail.com*
+* HSA Videos
+ * [http://www.youtube.com/watch?v=5ntILiXTuhE](http://www.youtube.com/watch?v=5ntILiXTuhE)
+ * [http://www.youtube.com/watch?v=caEPq4KvTTA](http://www.youtube.com/watch?v=caEPq4KvTTA)
+* HSA Articles
+ * [http://developer.amd.com/resources/heterogeneous-computing/what-is-heterogeneous-computing/](http://developer.amd.com/resources/heterogeneous-computing/what-is-heterogeneous-computing/)
+* HSA Foundation
+ * [https://github.com/HSAFoundation](https://github.com/HSAFoundation)
+
##Introduction
Now that HSA hardware is generally available I figured it was time to describe how to setup a HSA enabled Linux platform so that it can run Aparapi.
diff --git a/doc/SettingUpLinuxHSAMachineForAparapiSidebar.md b/doc/SettingUpLinuxHSAMachineForAparapiSidebar.md
new file mode 100644
index 00000000..e69de29b
diff --git a/doc/HowtosetupaHSAenabledLinuxPlatform.md b/doc/UsingAparapiLambdaBranchWithHSASimulator.md
similarity index 100%
rename from doc/HowtosetupaHSAenabledLinuxPlatform.md
rename to doc/UsingAparapiLambdaBranchWithHSASimulator.md
--
GitLab