X-Git-Url: https://iankelling.org/git/?a=blobdiff_plain;f=README;h=357ea46fbd82cd3b3cde480cc7c78c7efd7d34ac;hb=HEAD;hp=a960550c97db9dacb19c2a9ad9d82387010871fd;hpb=d8b62eab42b79e9a3ea68008d7fc67802e93948a;p=small-misc-bash

diff --git a/README b/README
index a960550..357ea46 100644
--- a/README
+++ b/README
@@ -1,15 +1,49 @@
-The main documentation is availiable via --help and near the top of any bash
-script files which sit next to this file.
+# I, Ian Kelling, follow the GNU license recommendations at
+# https://www.gnu.org/licenses/license-recommendations.en.html. They
+# recommend that small programs, < 300 lines, be licensed under the
+# Apache License 2.0. This file contains or is part of one or more small
+# programs. If a small program grows beyond 300 lines, I plan to switch
+# its license to GPL.
 
-Files ending in -function are for sourcing then calling as a function. Files
-without -function are exactly the same except they are for calling as a script.
+# Copyright 2024 Ian Kelling
 
-Patches and bugs are very welcome via gitlab.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 
-Questions, feedback, etc are very welcome via email to Ian Kelling
-<ian@iankelling.org>. I will add any useful questions, answers, etc. to this
-file. If a mailing list / forum is ever called for, I will start one.
+#     http://www.apache.org/licenses/LICENSE-2.0
 
-This program is also part of a collection of programs,
-https://gitlab.com/iankelling/bash-programs-by-ian, which are unrelated except
-having the same author and being being bash programs.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+Utility bash programs
+
+dircp              Copy a directory structure
+directory-browser  better cd with forward, backward, and history
+ex                 Extract many types of files
+gitget             Idempotent git clone/pull
+hostmac            Get a host's mac address
+isdiff             Test if FILE1 and FILE2 have the same contents
+ll-function        ls -lA with enhanced output
+psg-function       ps grep. Grep output of ps.
+rmln               wrap rm, recursively expanding symlink arguments
+wpm-game           Typing speed game
+
+The main documentation is availiable via --help and near the top of the
+script files next to this file. Each file is completely self contained,
+and generally unrelated except they are small so it's convenient to put
+them in the same repo.
+
+Files with -function are meant to be sourced and used as a function. The
+other script file can be stripped of the last line and used as a
+function instead of a script.
+
+Please email me if you have a patches (patch file or git repo are fine),
+bugs, feedback, or republish this somewhere else: Ian Kelling
+<ian@iankelling.org>.
+
+There are no known bugs. Any bugs will be added to the individual
+documentation of each file.