documentation fixes

add README.txt to bash.bashrc.d and make sure it doesn't get deleted

document tree management, and deprecate hass-debian

Author: spacelama

hosts.yml

@@ -154,6 +154,8 @@ all:
           smtp_relay_to_gmail: true
 #        homeassistant:
 #          host_is_container: true # not strictly, but we don't want to go buggering around with the installation more than necessary
+#          (in fact, at the current point, we don't manage this machine at all through Ansible;
+#           if it's ever converted to a debian machine, it'll be done through hass-debian, which has been deprecated as of end of 2025)
     desktops:
       hosts:
         dirac-new:
@@ -334,9 +336,9 @@ all:
           # need for nfsroot, I wonder if we can talk to the
           # framebuffer there.  framebuffer comes up on pi 4, but
           # maybe not pi 3
-        hass-debian:
-          not_active: true
-          host_is_virtual: true
+#        hass-debian:
+#          not_active: true
+#          host_is_virtual: true
         fs-new:
           not_active: true
           host_is_virtual: true

vars/main.yml

@@ -282,7 +282,9 @@
   # things deliberately added to /usr/local/bin to make sure we dont
   # have stale copies around, but that's a bit of work...
   # For now, just remember to do:
-  # `cd files/tree/usr/local/bin ; find -type f | while read i ; do l -d ~/bin/$i ; done` and remove those files it finds
+  #   cdrun files/tree/usr/local/bin find -type f | while read i ; do l -d ~/bin/$i ; done
+  #   cdrun files/tree.Linux-x86_64/usr/local/bin find -type f | while read i ; do l -d ~/bin/Linux-x86_64/$i ; done
+  # and remove those files it finds
   usr_local_bin_files_to_remove:
     - "{{ lookup('fileglob', \"homes/bin/*\", wantlist=True) }}"
     - "{{ lookup('fileglob', \"homes.Linux-{{ arch | default ('x86_64') }}/bin/Linux-{{ arch | default ('x86_64') }}/*\", wantlist=True) }}"
@@ -292,6 +294,7 @@
   # excess files later)
   bashrc_files:
     - "{{ lookup('fileglob', 'tree/etc/bash.bashrc.d/*.sh', wantlist=True) }}"
+    - "{{ lookup('fileglob', 'tree/etc/bash.bashrc.d/*.txt', wantlist=True) }}"
 
     # "simple-sync" - let's just transfer a whole bunch of files,
     # according to simple criteria, with possible event triggering:
@@ -320,7 +323,7 @@
       # customisation, unless perhaps that directory already exists in
       # the files/ area because it's relevant to a whole bunch of
       # hosts and you have a further customisation here.
-    - name: /
+    - name: / # tree/
     - name: /
       source: tree.Linux-{{ arch | default ('x86_64') }}/
     - name: /