summaryrefslogtreecommitdiff
path: root/examples
diff options
context:
space:
mode:
Diffstat (limited to 'examples')
-rw-r--r--examples/loadables/README33
-rw-r--r--examples/scripts.noah/README32
-rw-r--r--examples/scripts.v2/README46
-rw-r--r--examples/startup-files/README16
-rw-r--r--examples/startup-files/apple/README9
5 files changed, 100 insertions, 36 deletions
diff --git a/examples/loadables/README b/examples/loadables/README
index 4c36898..8a2ac81 100644
--- a/examples/loadables/README
+++ b/examples/loadables/README
@@ -34,3 +34,36 @@ new loadable builtins.
On Debian GNU/Linux systems, the bash headers are in /usr/include/bash.
The appropriate options are already set in the example Makefile.
+
+basename.c Return non-directory portion of pathname.
+cat.c cat(1) replacement with no options - the way cat was intended.
+cut.c cut(1) replacement.
+dirname.c Return directory portion of pathname.
+finfo.c Print file info.
+getconf.c POSIX.2 getconf utility.
+getconf.h Replacement definitions for ones the system doesn't provide.
+head.c Copy first part of files.
+hello.c Obligatory "Hello World" / sample loadable.
+id.c POSIX.2 user identity.
+ln.c Make links.
+logname.c Print login name of current user.
+Makefile.in Simple makefile for the sample loadable builtins.
+mkdir.c Make directories.
+necho.c echo without options or argument interpretation.
+pathchk.c Check pathnames for validity and portability.
+print.c Loadable ksh-93 style print builtin.
+printenv.c Minimal builtin clone of BSD printenv(1).
+push.c Anyone remember TOPS-20?
+README README
+realpath.c Canonicalize pathnames, resolving symlinks.
+rmdir.c Remove directory.
+sleep.c sleep for fractions of a second.
+strftime.c Loadable builtin interface to strftime(3).
+sync.c Sync the disks by forcing pending filesystem writes to complete.
+tee.c Duplicate standard input.
+template.c Example template for loadable builtin.
+truefalse.c True and false builtins.
+tty.c Return terminal name.
+uname.c Print system information.
+unlink.c Remove a directory entry.
+whoami.c Print out username of current user.
diff --git a/examples/scripts.noah/README b/examples/scripts.noah/README
index a33860b..95272d7 100644
--- a/examples/scripts.noah/README
+++ b/examples/scripts.noah/README
@@ -7,18 +7,20 @@ any of them. They exist simply as examples of bash scripting.
Here's a description of what's in this directory:
-aref.bash pseudo-arrays and substring indexing examples
-bash.sub.bash library functions used by require.bash
-bash_version.bash a function to slice up $BASH_VERSION
-meta.bash enable and disable eight-bit readline input
-mktmp.bash make a temporary file with a unique name
-number.bash a fun hack to translate numerals into english
-prompt.bash a way to set PS1 to some predefined strings
-remap_keys.bash a front end to `bind' to redo readline bindings
-require.bash lisp-like require/provide library functions for bash
-send_mail.bash replacement smtp client written in bash
-shcat.bash bash replacement for `cat'
-source.bash replacement for source that uses current directory
-string.bash the string(3) functions at the shell level
-stty.bash front-end to stty that changes readline bindings too
-y_or_n_p.bash prompt for a yes/no/quit answer
+aref.bash Pseudo-arrays and substring indexing examples.
+bash.sub.bash Library functions used by require.bash.
+bash_version.bash A function to slice up $BASH_VERSION.
+meta.bash Enable and disable eight-bit readline input.
+mktmp.bash Make a temporary file with a unique name.
+number.bash A fun hack to translate numerals into English.
+PERMISSION Permissions to use the scripts in this directory.
+prompt.bash A way to set PS1 to some predefined strings.
+README README
+remap_keys.bash A front end to 'bind' to redo readline bindings.
+require.bash Lisp-like require/provide library functions for bash.
+send_mail.bash Replacement SMTP client written in bash.
+shcat.bash Bash replacement for 'cat(1)'.
+source.bash Replacement for source that uses current directory.
+string.bash The string(3) functions at the shell level.
+stty.bash Front-end to stty(1) that changes readline bindings too.
+y_or_n_p.bash Prompt for a yes/no/quit answer.
diff --git a/examples/scripts.v2/README b/examples/scripts.v2/README
index b3d0559..74f27c5 100644
--- a/examples/scripts.v2/README
+++ b/examples/scripts.v2/README
@@ -7,27 +7,31 @@ any of them. They exist simply as examples of bash scripting.
Here's a description of what's in this directory:
-arc2tarz Convert an "arc" archive to a compressed tar archive.
-corename Tell what produced a core file.
-fman Fast man replacement.
-frcp Copy files using ftp but with rcp-type command line syntax.
-lowercase Change filenames to lower case.
-ncp A nicer front end for cp (has -i, etc.).
-newext Change the extension of a group of files.
-nmv A nicer front end for mv (has -i, etc.).
-pages Print specified pages from files.
-pf A pager front end that handles compressed files.
-rename Change the names of files that match a pattern.
-repeat Execute a command multiple times.
-untar Unarchive a (possibly compressed) tarfile into a directory.
-uudec Carefully uudecode multiple files.
-uuenc uuencode multiple files.
-vtree Print a visual display of a directory tree.
-where Show where commands that match a pattern are.
+arc2tarz Convert an "arc" archive to a compressed tar archive.
+cal2day.bash Convert a day number to a name.
+corename Tell what produced a core file.
+fman Fast man(1) replacement.
+frcp Copy files using ftp(1) but with rcp-type command line syntax.
+lowercase Change filenames to lower case.
+ncp A nicer front end for cp(1) (has -i, etc.).
+newext Change the extension of a group of files.
+nmv A nicer front end for mv(1) (has -i, etc.).
+pages Print specified pages from files.
+PERMISSION Permissions to use the scripts in this directory.
+pf A pager front end that handles compressed files.
+README README
+ren Rename files by changing parts of filenames that match a pattern.
+rename Change the names of files that match a pattern.
+repeat Execute a command multiple times.
+untar Unarchive a (possibly compressed) tarfile into a directory.
+uudec Carefully uudecode(1) multiple files.
+uuenc uuencode(1) multiple files.
+vtree Print a visual display of a directory tree.
+where Show where commands that match a pattern are.
The following scripts were written or converted by Chet Ramey:
-bashrand Random number generator with upper and lower bounds and optional seed
-cdhist cd replacement with a directory stack added
-pmtop Poor man's `top' for SunOS 4.x and BSD/OS
-shprof Line profiler for bash scripts
+bashrand Random number generator with upper and lower bounds and optional seed.
+cdhist.bash cd replacement with a directory stack added.
+pmtop Poor man's 'top(1)' for SunOS 4.x and BSD/OS.
+shprof Line profiler for bash scripts.
diff --git a/examples/startup-files/README b/examples/startup-files/README
index bdbfd90..92667a6 100644
--- a/examples/startup-files/README
+++ b/examples/startup-files/README
@@ -3,3 +3,19 @@ are originally from Brian Fox. The ones starting with lowercase
letters are from Chet Ramey.
They will require changes for your environment.
+
+Bash_aliases Some useful aliases (Fox).
+Bash_profile Sample startup file for bash login shells (Fox).
+bash-profile Sample startup file for bash login shells (Ramey).
+bashrc Sample Bourne Again SHell init file (Ramey).
+Bashrc.bfox Sample Bourne Again SHell init file (Fox).
+README README
+
+apple Example Start-up files for Mac OS X.
+apple/aliases Sample aliases for Mac OS X.
+apple/bash.defaults Sample User preferences file.
+apple/environment Sample Bourne Again Shell environment file.
+apple/login Sample login wrapper.
+apple/logout Sample logout wrapper.
+apple/rc Sample Bourne Again Shell config file.
+apple/README README
diff --git a/examples/startup-files/apple/README b/examples/startup-files/apple/README
index 07005cb..67ad14a 100644
--- a/examples/startup-files/apple/README
+++ b/examples/startup-files/apple/README
@@ -22,3 +22,12 @@ See the corresponding file in /usr/share/init/bash for more information about th
-Fred
tritan@mit.edu
+
+
+aliases Sample aliases for Mac OS X.
+bash.defaults Sample User preferences file.
+environment Sample Bourne Again Shell environment file.
+login Sample login wrapper.
+logout Sample logout wrapper.
+rc Sample Bourne Again Shell config file.
+README README