180401

   This dir is new, although its contents came from $sam_distro/tips.

   First I copied the contents of $sam_distro/tips to this dir.  Then I
   made many updates to many things in this dir over a period of
   time--perhaps twelve months.  Recently, prior to making several
   uploads to SAM.current.tar.gz on SourceForge, I made some more
   updates.  The dir in its current state reflects a new organization
   of SAM characterized by these features:

      -I now refer to the different parts of SAM as modules, not
      packages.  As a result dir SAM_pkgs became SAM_modules. 
      Corresondingly, I no longer treat SAM as consisting of multiple
      packages.  I upload it as a single archive that has the b-files
      dir at its root ($sam_root) and the balance of SAM at
      $sam_root/opt/SAM.

      SAM has long lived in a dir called SAM, so that is not new. 
      Likewise the SAM dir has for a long time been a symlink that
      pointed to a dir called main which contained symlinks pointing to
      other parts of SAM (example, kernel, pkg_tool, tool).  So this is
      not new either.

      What is different is that the b-files dir now lives at the root
      of the SAM distribution, and it replaces the previous use of dir
      main/tips (which has been retained for reference).

      -I have changed the way the b-files (of the b-files dir) work, so
      that the b-files dir is now relocatable.  This was done thru the
      use of "`dirname $0`" and the exporting of a new variable called
      sam_root.

      -With a relocatable b-files dir it became possible to make all
      SAM plus the b-files dir relocatable.  Thus it can be run from a
      flash drive (mounted at any location) without re-configuring.

      -One odd result of this very helpful set of changes is that the
      SAM distribution has a gap in it.  The b-files dir is part of SAM
      and lives at $sam_root.  The balance of SAM lives at
      $sam_root/opt/SAM (which as I described above is actually a
      symlink).  This leaves room for other things, which may or may
      not be a part of SAM, to occupy $sam_root/opt.

180402

   breekit:

      I made an update.  I switched the order of invocation of brc and
      bprofile, because brc is now dependent on bprofile (due to a
      change in brc).

180406

   README:

      Edits.

180407

   bree, breeze:

      I edited each of these $sam_add from the SAM invocation.  I think
      it was a mistake to have $sam_add in the invocations.  It caused
      extra references to the $sam_add in the PATH.

180414

   bdegin:

      I put invocation of bprofile before that of brc.

180420

   sam-start/super.sam:

      I fixed it.  It wasn't working due to recent dir structure
      changes.

180922

   bprofile:

      I added vostro-home to the set of boxes which now includes:

         jimel
         jimel-sw
         prodesk
         vostro
         vostro-home

181007

   I updated README with a new "Current State of changlog.txt files". 
   However, don't expect anymore entries like this one.  In the future
   I'll not log a change to README if it is no more than a "Current
   State..." update.

190112

   buser:

         I changed SuperDisplay to ZombieDisplay so this script would
         be compatible with $sam_root/opt/SAM/tool/dog.

190204

   bashrc:

      I removed this file after first putting this into bprofile (less
      the alias definitions).  I did this, because I don't like that
      the aliases are not inherited by shells and that
      .bashrc is not run in all shell types.

      Note that I solved the the alias problem by writing equivalent
      tools for the aliases I was using.  I put them in example/handy. 
      The other things that were in bashrc are now available through
      bprofile.

190216

   opt/f_lib/script_tools:

      I added an important note to script_tools explaining how to
      reference it.

190324

   opt/f_lib/script_tools:

      bad():

         It was implemented incorrectly using

            '= "1"' and '!= "1".

         I changed it to

            '!= "0"' and '= "0".

190609

   I'm not sure where to put this note:

      I revised file include that is part of my install script.  I use
      that script for installing SAM from my 150605aa2 parition into
      ZombieSlak.  I need to check.  I think I already have install
      instructions that are part of SAM.  Are they up to date and
      compatible with 150605aa2?

      It seems that I have no need of the above install script in SAM. 
      It seems it belongs to ZombieSlak.  If so, then I need to
      document it there, especially the change to the include file that
      I mentioned above.

   begin2

      I made this from begin to try out some ideas.  It calls bstart2.

   bstart2

      I made this from bstart to try out some ideas.

      I wanted to try a modified invocation of $sam_distro/go/sam1. 
      Before the invocation passed these arguments to sam1:

         5 $sam_root/sam-start - "final; $more; $*"

      where

         more="export sam_bye_command=exit"

      After the change the invocation passed these arguments to sam1:

         5 $sam_root/sam-start "; $*"

      I need to check to see if my assumptions were right--although the
      results seem to support my assumptions.  I assumed that sam-start
      works like (or invokes) bound.  Thus "-" is a place holder for
      the field that specifies what is added to the path and "final"
      (in more) becomes the third argument which then triggers a
      behavior that is supposed to cause the use of

         export sam_bye_command=exit

      Ha.  I was already using the above explicitly in two places:
      bstart and begin.  This made for a lot of wasted code.  Based on
      my assumptions about what was happening, and some trial and
      error, I cleaned up bstart2 and begin2.

      It seems to work the same as before, with less clutter.  More
      investigation is needed.  After begin2 and bstart2 are fully
      vetted I will likely move them to begin and bstart.

   opt/SAM_modules/main:

      bstart:

         I didn't do anything to this, but I looked at it.  It seems to
         be unused in the current configuration.  It is different from
         the bstart that is at $sam_root.

         It seems I need to investigate, and perhaps do some cleaning
         up.

190704

   sam_env:

      I changed

         echo "in $0/sam_env"

      to

         echo "in $BASH_SOURCE"

      I did this, because the first version didn't work correctly.

   TIPS:

      I made updates.

190721

   bprofile:

      I replaced the old "echo in ..." with

         echo "in $BASH_SOURCE"

      I removed, by commenting-out, both instances of

         stty erase ...

      It is odd that I had two of them, but neither worked well.  I've
      decided to use only "stty erase ..." in .bashrc.  See my lessons

         /mnt/joresorc/lessons/backspace

190831

   opt/f_lib/script_tools:

      I took a leap and commented out the line at the end which exports
      the functions that it contains.  This might cause errors until I
      get all needed references to script_tools installed.

      I did this, because it was a bad idea to have it.  I thought it
      would allow me to be lazy:  reference it once and have it
      inherited by all.  That worked well enough, but caused troubles
      when I wanted to invoke a script directly.  I had to remember to
      first source script_tools.  I think this new way is better.

190902

   opt/f_lib/script_tools:

      I revised the note in script_tools which explains how to
      reference it.  In this revision I provide two ways to reference
      it.  One way is for scripts that belong to ZombieSlak and the
      other is for scripts that belong to RS.

191103

   begin, begin2:

      I revised begin it to include the features of begin2, and I put
      begin2 in junk.

   bstart, bstart2:

      I revised bstart to include the features of bstart2, and I put
      bstart2 in junk.

      I also changed bstart to have a limit of 12 hosts instead of 5.

191202

   opt/f_lib/script_tools:

      I added these functions:

         bob:

            This function outputs its arguments one per line.

         dnumb:
      
            I made this function defintion for function dnumb.  This
            function outputs what I call the date number of a file. 
            This is a numerical representation of the date of a file
            gotten from "ls $1 -l --time-style +%s".
      
            Or when $1 is "", then the date number of the current date
            (date +%s) is output.
      
            I wrote this, because I wanted to use the biggest of the
            set of dnumbs for all the changlog.txt files of SAM as the
            version number of SAM.

         sortbob:

            This function uses function bob, "sort -n" and "tail -n1"
            to output the largest of its arguments.

191227

   opt/h_tool:

      I moved this dir here from
      /mnt/joresorc/project/_160226aa where it was also called handy.

      It contains stuff that used to live in /boot/tool of each
      Zombie Drive.  I decided that that was a bad idea.  As a result I
      moved it here and made it part of the RS install.

   opt/install:

      I moved this here from

        /mnt/joresorc/software/mine/install

      where it was called RS.  (Dir install contained only RS, so when
      I moved RS here I called it install.)

      This dir contains the code and instructions for installing the RS
      collection.  I thought it was better to have it here.


200322

   bxauth and bxadd:

      This pair of scripts work together to allow you to extend
      authorization to a different user to run things in X.

      For example, say that user joe as an X session with $DISPLAY=:0.

      And user joe wants extend to user student permission to run
      things in :0.  User student's $DISPLAY is :1.

      This is how to do it:

         1.  Change to the X session for user joe.  Run as user joe in
         SAM:

            $sam_root/bxauth <0> <170520aa>

         You will see the authorization string echoed to the screen. 
         It is also written to /tmp/xauth.

         2.  Change to the X session for user student.  Run as user
         student (in SAM or not):

            $sam_root/bxadd <0>

      Note that in the above:

         <0>		is the index for the value of $DISPLAY for the
         X session to which you are giving permission.  In this case it
         is the index for :0 wich is the value of $DISPLAY for the X
         session that belongs go user joe.

         <170520aa>	is an identifying string.  It can be part or
         all of the hostname for the user (in this case, joe) to which
         the X session to which you are giving permission belongs.

      Don't enter the "<" or ">".  I used those to show the parts of
      the example that were changeable.

   ENV-NOTE:

      I made some edits.

   TIPS:

      I made some edits.

   opt:

      f_lib/script_tools:

         I added this file to SAM.  It contains function definitions.

      h_tool:

         I added this menu to SAM.  It is a menu of commands for
         ZombieSlak.


200415

   exclude:

      I removed "opt/h_tool", because it is needed to run at least one
      tool in /boot/tool, uptask-stc.  By removing this line from
      exclude h_tool will be installed to /RS/opt/h_tool by

         "other; software; sam_soft; upload; current"

      which is the tool currently in place to populate /RS.  This is
      needed, because uptask-stc (and hopefully any other tools of
      /boot/tool) references h_tool through this symlink:

         /boot/tool/handy

200425

   bree:

      bree now invokes bclean.

   bclean:

      I wrote this function definition.  It is a long awaited update which
      removes repeated path instances from variables pold and PATH.  This is
      helpful as part of the invocation of bree, as otherwise bree, and
      anything downstream from bree, will it seems contain some duplicated
      path instances.

   breeze:

      I put this in junk.  I don't think it is needed.

   exclude:

      I removed the exclusion of breeze, as breeze itself has been
      removed.

   GUIDE:

      I removed the reference to breeze.

   TIPS:

      I added mention of bclean.

200514

   bree:

      I fixed an error.  I had left out the semicolon after the
      invocation of bclean.

      I also added "2020" to the copyright statement.

      And I edited the code for readability.

200516

   bxadd:

      I changed the invocation of the shell.  Before it used xterm. 
      Now it invokes begin.

200522

   bxauth:

      I made edits for readability.

      And I removed the un-needed quotes around ":$1".

      And I replaced $2 with $two where two is either $2 (when it is
      not "") or `uname -n` when $2 is "".  This allows execution of
      bxauth with only one argument.  Or use two arguments when you
      want to specify a hostname other than `uname -n`.  This also
      gives backwards compatibility.

210215

   bree:

      I edited the comments for readability.

      I put $sam_add back into the bound invocation.  Now bree creates
      a root shell that has a PATH that includes $sam_add.  This was
      missing.

   bclean:

      I added sam_add to the list of variables cleaned.  This change
      was prompted by the above change to bree.  Without this change
      the new bree produced duplicate strings in sam_add.

210330

   misc/joresorc/pmenu:

      mdefault: I made this script.  It sets the default printer.

      a2pdf:  I made this script.  It makes a pdf file from a text
      file.

      prename:  I made this script.  Use this before running an
      application that can print to printer "printername" (a special
      printer allows printing raw data to a file).

      postname: I made this script.  Use this after running the
      application referred to above.  It makes a pdf from the ps that
      was generated, and then it runs prename to prepare for the next
      use of the application.

210406

   lite:

      This dir is new.  It will be the "sam_root" for a light version
      of SAM (SAM Lite).

210801

   bclean:

      I removed this script.  It is no longer needed.  See
      $sam_distro/sam/lean.f.

   bree:

      I removed the invocation of bclean.

220104

   opt:

      scr_tool:

         At some point in the past I moved scr_tool to this location.

220423

   opt:

      scr_tool:

         I recursively changed the ownership of this dir to
         "sam:users".

220425

   opt/scr_tool/confirm_mount.sam:

      I made some changes so this function can handle the case of /mnt
      being a symlink.
