Bug 1244: changes to description pospopcount
[libreriscv.git] / HDL_workflow / devscripts.mdwn
index 188f11d4866a39395950e4838427350a8a3cdce1..2ec96bef61e564ee2e4cf551f8639a40cd7dab08 100644 (file)
@@ -14,27 +14,33 @@ 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**.
+to use archlinux but you are **on your own if you do so, and should only
+consider the option of using your own preferred host OS if you are an
+advanced expert**.  We do **NOT** provide "personal end-user support"
+for Host OS problems.
 
 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
 different it risks creating non-reproducible HDL. It's not about
 "what's the favurite OS", it's about making sure that two developers
-can produce the **exact** same GDS-II files.
+can produce the **exact** same GDS-II files, which is kinda important
+if you are going to drop USD 16 million on 7nm Mask Charges.
 
     $ git clone https://git.libre-soc.org/git/dev-env-setup.git
     $ cd dev-env-setup
     $ sudo bash
+    (optional: # export CHROOT_DEBIAN_MIRROR=http://ftp.<mirror>.debian.org/debian)
     # ./mk-deb-chroot libresoc
+    # ./cp-scripts-to-chroot libresoc # copies dev-env-setup to chroot
     # exit
     $ schroot -c libresoc
-    (libresoc)$ git clone https://git.libre-soc.org/git/dev-env-setup.git
-    (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)# ./binutils-gdb-install    # needed for binutils-svp64
     (libresoc)# exit
     (libresoc)$
 
@@ -50,6 +56,12 @@ 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