update docs about double installation of syslinux
[fsf-member-card-builder.git] / README.mdwn
index f6f6bcbb50abbf2de2e6d1c6b063d71238a88745..ab176ed6ad6b9799b9c92340e0c8910b5f818c3b 100644 (file)
@@ -6,42 +6,53 @@ This script assumes that you are starting with the special ISO from the
 following URL. It already contains video files that the script in this repo
 will not try to download.
 
-<http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0-fsf_i686.iso>
+<https://cdbuilds.trisquel.org/fsf/trisquel_11.0-fsf_amd64.iso>
 
-The corresponding source code ISO can be found here:
+The corresponding source code tar can be found here:
 
-<http://jenkins.trisquel.info/makeiso-etiona/iso/trisquel_9.0fsf_sources.iso>
+<https://cdbuilds.trisquel.org/fsf/trisquel_11.0_sources.tar>
 
 Feel free to test your download with the `trisquel_9.0-fsf_i686.iso.sha256`
 file in this repo:
 
-    sha2565sum -c trisquel_9.0-fsf_i686.iso.sha256
-    sha2565sum -c trisquel_9.0fsf_sources.iso.sha256
+    sha2565sum -c trisquel_11.0-fsf_amd64.iso.sha256
+    sha2565sum -c trisquel_11.0_sources.tar.sha256
+
+If you don't have access to the FSF version of the Trisquel images, refer to
+the following script and files:
+
+<https://gitlab.trisquel.org/trisquel/makeiso/-/blob/master/makeiso.sh>
+<https://gitlab.trisquel.org/trisquel/makeiso/-/tree/master/files/fsf/GNUAV>
 
 ## Making a bootable USB drive
 
 This should work on an external USB drive, ideally one that is 12 GB or greater
-in size. Note that using a loop device will probably not work, partly due to
-the way syslinux behaves with loop devices. If you get that working, feel free
-to submit a patch to <sysadmin@gnu.org>. : )
+in size, if you want to intsall all of the media files onto it. Note that using
+a loop device will probably not work, partly due to the way syslinux behaves
+with loop devices. If you get that working, feel free to submit a patch to
+<sysadmin@gnu.org>. : )
+
+This script has been tested on GNU/Linux with syslinux version 6.04.
 
-You'll need to download and install old versions of syslinux:
+You should wipe at least the start of the drive you want to install onto. Note
+that this is a destructive operation, and if you choose the wrong drive, you
+will lose data. Replace the 'X' in /dev/sdX with the letter of the drive you
+want to install to:
 
-* <https://mirror.fsf.org/trisquel/pool/main/s/syslinux/syslinux-common_4.05+dfsg-6+deb8u1_all.deb>
-* <https://mirror.fsf.org/trisquel/pool/main/s/syslinux/syslinux_4.05+dfsg-6+deb8u1_amd64.deb>
+    lsblk
 
-Check files, install them, and run the script:
+    # if you want to wipe /dev/sdX
+    dd if=/dev/zero of=/dev/sdX bs=4M count=25
 
-    sha256sum -c syslinux.deb.sha256
+Then run the script on the same drive:
 
-    dpkg -i syslinux-common_4.05+dfsg-6+deb8u1_all.deb
-    dpkg -i syslinux_4.05+dfsg-6+deb8u1_amd64.deb
+    sudo ./live-usb-loader.sh trisquel_11.0-fsf_amd64.iso /dev/sdX
 
-    sudo ./live-usb-loader.sh trisquel_9.0-fsf_i686.iso /dev/sdb
+## Installing extra media, including Trisquel 11 source code
 
-## Installing extra media, including Trisquel 9 source code
+This command also updates the Web page that shows up on boot.
 
-    sudo ./install-extras.sh trisquel_9.0fsf_sources.iso /dev/sdb
+    sudo ./install-extras.sh trisquel_11.0_sources.tar /dev/sdX
 
 ## Notes about video files and free space