From 762c5736042994a4bdb73a29e5bb227aecf9f7f6 Mon Sep 17 00:00:00 2001
From: Philip Sargent <philip.sargent@gmail.com>
Date: Sun, 15 Dec 2024 21:16:17 +0000
Subject: [PATCH] rsync updates - online edit of
 handbook/computing/winlaptop.html
 [PosixPath('/home/philip/expo/expoweb/handbook/computing/winlaptop.html')]

---
 handbook/computing/winlaptop.html | 35 +++++++++++++++++++++----------
 1 file changed, 24 insertions(+), 11 deletions(-)

diff --git a/handbook/computing/winlaptop.html b/handbook/computing/winlaptop.html
index 32d15b90e..9cfb0cefc 100644
--- a/handbook/computing/winlaptop.html
+++ b/handbook/computing/winlaptop.html
@@ -20,9 +20,10 @@
 <p>Unlike a Linux machine, on Windows there are two distinct levels of 'bulk update laptop' capability:
 <ol style="list-style-type:decimal-leading-zero; line-height:130%">
 <li> <a href="#keys">Keys and key management</a>, simple file transfer, <em>scp, ftp</em>
-<li> <a href="#rsync">Synchronisation of entire file heirarchies</a>: installation and use of <em>rsync</em>
+  <li> <a href="#rsync">Synchronisation of entire file heirarchies</a>: installation and use of <em>rsync</em><br />
+    TLDR; While it can be done, just don't do this in Windows. It's too fiddly and prone to error. If you really want to synchronise a large file heirarchy, use a Linux machine.
 </ol>
-<h2 id="keys">Level 1 - Windows Bulk Update</h2>
+<h2 id="keys">Level 01 - Windows Bulk Update</h2>
 <ul>
 <li><a href="#well">Things that already work well with any Windows laptop</a><br />
  - Editing the handbook webpages, typing up SVX files and transcribing the logbook, <br />
@@ -168,23 +169,26 @@ it downloads a <em>copy</em> of the contents of essentials.gpx  and not a link.
 <li>A possible fix in the future might be to keep all your expo files in a separate partition of your hard disc which is formatted with a linux filesystem (such as ext4) and run  the <a href="https://www.ext2fsd.com/">ext2ntfs</a> driver to mount this fielsystem read-write from Windows. Probably not a good idea as the driver is a bit flaky in read-write mode and you could lose everything.
 
 </ul>
-<h2 id="rsync">Level 2 - Windows Bulk Synchronisation with rsync</h2>
 
 
+<h2 id="rsync">Level 02 - Windows Bulk Synchronisation with rsync</h2>
 
-<p>When using Windows please, please
+<p>TLDR just don't do this: please.
+  <p>When using Windows please, please
 <ul>
 <li>be <a href="../survey/getin.htm#filenames">excessively careful when naming files and survex names</a> and 
 <li>be <a href="qstart-rsync.html">exceptionally careful when using rsync</a>.
 </ul>
 <p><a href="https://rsync.samba.org/">rsync</a> is a Linux command-line application, so we need a terminal window to run it and a Windows client executable.
-None of the packaged software (Filezilla, puTTY) includes a Windows rsync client.
+None of the packaged software already documented (Filezilla, PuTTY) includes a Windows rsync client.
 <p>Windows comes with a terminal window (cmd.exe) so we 'just' need a native Windows rsync executable <var>rsync.exe</var>.
 <ul>
-<li>The only direct port of rsync to Windows is Cygwin: <a href="https://stackoverflow.com/questions/23517023/rsync-from-windows-to-linux-using-puttys-pagent-authentication">this</a> . <br>- You just need the following files: rsync.exe, cygwin1.dll and cygz.dll . 
+
+    <li>Install <a href="https://www.itefix.net/cwrsync">cwRsync</a> which comes with <em>no documentation</em> so you have to already know how to use rsync in some detail.
+<li><a href="https://stackoverflow.com/questions/23517023/rsync-from-windows-to-linux-using-puttys-pagent-authentication">Cygwin</a> . <br>- You just need the following files: rsync.exe, cygwin1.dll and cygz.dll . 
 Read the  <a href="https://ccm.net/computing/windows/3877-rsync-under-windows/">instructions</a><br>
 - You will also have to install OpenSSH and configure the Cygwin system to use the OpenSSH ssh key.
-<li>bash window - a different terminal window. This is installed by default when you install <A href="https://gitforwindows.org/">gitforwindows</a>. Unfortunately while this <a 
+<li>Install <a href="https://gitforwindows.org/">Git for Windows</a> which includes an rsync executable, but you have to use its own bash terminal window. This may be something you don't want to do. This bash window is installed by default when you install <A href="https://gitforwindows.org/">gitforwindows</a>. Unfortunately while this <a 
 href="https://en.wikipedia.org/wiki/MinGW">MINGW32</a> setup includes a command-line git executable it doesn't include rsync: you have 
 to excavate it yourself, see <a href="https://prasaz.medium.com/add-rsync-to-windows-git-bash-f42736bae1b3">a 2020 script</a>, alternatively <a 
 href="https://blog.tiger-workshop.com/add-rsync-to-git-bash-for-windows/">a 2017 recipe</a> or <a 
@@ -195,7 +199,7 @@ href="https://gist.github.com/radleta/0b337a2b14f761951cf2aab0578512b9">recent e
 <li> This effectively installs a whole copy of Linux
 <li>Unfortunately this does not integrate with PuTTY <em>at all</em>
 <li>You will need to do the key management setup <em>again</em>, within the WSL environment.
-<li> You want WSL1 not WSL2. WSL1 is 20x faster for Windows NTFS filesystems.
+<li> WSL1 is much faster for Windows NTFS filesystems than WSL2, but is now deprecated.
 <li> WSL on anything other than drive C:\ may involve you with <a href="wsllaptop.html#bold">hard to diagnose file permissions problems</a>
 
 <li>See our own expo page about <a href="../computing/wsllaptop.html">setting up a WSL Expo Laptop</a>.
@@ -215,8 +219,17 @@ If you struggle with Cygwin, then you are unlikely to get any of the other metho
 
 
 <hr />
-Go back to: <a href="basiclaptop.html">Basic laptop</a><br />
-Go back to: <a href="surveylaptop.html">Survey laptop</a><br />
-Go on to: <a href="wsllaptop.html">Windows WSL laptop</a><br />
+<!-- absolute addressing so that this fragment can be copied eveywhere and still work -->
+Go on to: <a href="/handbook/troggle/trogarch.html">Troggle architecture</a><br />
+
+Return to: <a href="/handbook/troggle/trognotes.html">Troggle programmers' guide</a><br />
+Troggle index: 
+<a href="/handbook/troggle/trogindex.html">Index of all troggle documents</a><br />
+Go  to:  &#8251; <a href="/handbook/computing/basiclaptop.html">Basic laptop</a><br />
+Go  to: &#8258; <a href="/handbook/computing/surveylaptop.html">Survey laptop</a><br />
+Go  to: &#9734; <a href="/handbook/computing/bulkupdatelaptop.html"> Bulk Update laptop</a>
+&#9728; <a href="/handbook/computing/winlaptop.html">Windows Bulk Update laptop</a><br />
+Go  to: &#9874; <a href="/handbook/troggle/troglaptop.html">Troggle development laptop</a>
+&#9775; <a href="/handbook/computing/wsllaptop.html">Troggle development WSL laptop</a><br />
 <hr /></body>
 </html>