add set only first demo

[libreriscv.git] / HDL_workflow / devscripts.mdwn

diff --git a/HDL_workflow/devscripts.mdwn b/HDL_workflow/devscripts.mdwn
index dce359b6865605ea1f36c3682d034d3070cc9a71..5b8742313b6a23ceb4b4f41b20f966488158c5e0 100644 (file)
--- a/HDL_workflow/devscripts.mdwn
+++ b/HDL_workflow/devscripts.mdwn
@@ -12,6 +12,10 @@ the dev-env-setup repository is cloned twice, once to get the chroot
 script and a second time to use scripts *inside* the chroot. Feel free
 to simply copy the repository into the chroot to save bandwidth.
 
+**no you do not need to blow away your system and install debian 10 native**
+you can e.g. use debian/11 at the "host" level and some people have managed
+to use archlinux but you are **on your own if you do so**.
+
 Note: these scripts assume that you are using debian/10 and that you
 understand and accept why we have standardised on that as an OS
 (reproduceability and minimising "support").  If you use anything
@@ -29,6 +33,7 @@ can produce the **exact** same GDS-II files.
     (libresoc)$ cd dev-env-setup
     (libresoc)$ sudo bash
     (libresoc)# ./install-hdl-apt-reqs
+    (libresoc)# ./hdl-tools-yosys
     (libresoc)# ./hdl-dev-repos
     (libresoc)# ./ppc64-gdb-gcc           # needed for compiling unit tests
     (libresoc)# exit
@@ -43,7 +48,14 @@ There is an accompanying walkthrough video which goes through the above
 <https://m.youtube.com/watch?v=1-4eJKTNrEk> and includes running some
 unit tests, explaining some of the background, and also files some bugs.
 
-## Script "mk-deb-chroot"
+**You are now done, you need only read the rest below if interested
+to see how we made the above scripts**
+
+# Notes about Script "mk-deb-chroot"
+
+This section is developer-notes **only** it documents the
+process by which mk-deb-chroot was established and explains
+its decisions and effect.
 
 The script sets up an schroot debootstrap jail with debian 10. 
 This chroot can then be used for nmigen, coriolis, or any other development. 
@@ -130,4 +142,5 @@ as *root*, you run this:
 
 and you will see this as a result:
 
-    (libresoc)lkcl@fizzy:~#
\ No newline at end of file
+    (libresoc)lkcl@fizzy:~#
+