X-Git-Url: https://iankelling.org/git/?a=blobdiff_plain;f=README;h=357ea46fbd82cd3b3cde480cc7c78c7efd7d34ac;hb=HEAD;hp=b3829e2fd029748742db8d8360579ce2e911aaed;hpb=126ac3e0bc51962003e6a539dee03e928f68efe4;p=small-misc-bash diff --git a/README b/README index b3829e2..357ea46 100644 --- a/README +++ b/README @@ -1,12 +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, bugs, and any feedback is very welcome via gitorious or email to -Ian Kelling . +# 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 -This program is also part of a collection of programs, -https://gitorious.org/bash-programs-by-ian, which are unrelated except -having the same author and being being bash programs. +# http://www.apache.org/licenses/LICENSE-2.0 + +# 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 +. + +There are no known bugs. Any bugs will be added to the individual +documentation of each file.