add set only first demo

[libreriscv.git] / HDL_workflow / devscripts.mdwn

diff --git a/HDL_workflow/devscripts.mdwn b/HDL_workflow/devscripts.mdwn
index c01c003a1bc1c5c9b909d1c2aea5fd3befda1365..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,8 +48,15 @@ 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.
 
+**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. 
 These instructions are based on information taken from here:
@@ -131,3 +143,4 @@ as *root*, you run this:
 and you will see this as a result:
 
     (libresoc)lkcl@fizzy:~#
+