readme

Berkely的学生写的

	     Teach Yourself Shell Programming in 24 Hours
		      By Sriranga Veeraraghavan
		      <[e-mail]>

### Introduction ###

This is the REAMDE file for the example from the SAMS book Teach
Yourself Shell Programming in 24 Hours.

The URL for this tar.Z file is:

http://www.csua.berkeley.edu/~ranga/downloads/tysp1.tar.Z

### Downloading and Decompressing ### 

Once you have downloaded this file, change to the directory where the
file was saved and execute the following commands:

$ uncompress tysp1.tar.Z
$ tar Pxvf tysp1.tar

This will create a directory named tysp1 that contains the examples
from this book.
 
The examples are stored in separate directories, based on the chapter
in which the example occurs. Some chapters do not have any examples,
thus there are no directories for them.

Once you have uncompressed and untar'ed the examples, the tysp1
directory should look something like the following (/bin/ls -l):

total 24
-rw-r--r--   1 ranga    users        3286 Mar 31 14:26 README
drwxr-xr-x   2 ranga    users        1024 Mar 15 22:57 ch02
drwxr-xr-x   2 ranga    users        1024 Mar 17 08:16 ch07
drwxr-xr-x   2 ranga    users        1024 Mar 31 13:42 ch08
drwxr-xr-x   2 ranga    users        1024 Mar 17 08:31 ch10
drwxr-xr-x   2 ranga    users        1024 Mar 29 00:16 ch11
drwxr-xr-x   3 ranga    users        1024 Mar 29 00:35 ch12
drwxr-xr-x   3 ranga    users        1024 Mar 29 01:05 ch13
drwxr-xr-x   2 ranga    users        1024 Mar 31 13:42 ch14
drwxr-xr-x   2 ranga    users        1024 Mar 31 13:42 ch15
drwxr-xr-x   2 ranga    users        1024 Mar 30 13:52 ch16
drwxr-xr-x   2 ranga    users        1024 Mar 31 13:42 ch17
drwxr-xr-x   2 ranga    users        1024 Mar 30 15:20 ch19
drwxr-xr-x   2 ranga    users        1024 Mar 31 13:42 ch20
drwxr-xr-x   2 ranga    users        1024 Mar 31 13:50 ch21
drwxr-xr-x   2 ranga    users        1024 Mar 31 14:15 ch22
drwxr-xr-x   2 ranga    users        1024 Mar 31 14:24 ch23
drwxr-xr-x   2 ranga    users        1024 Mar 31 14:31 extras

If your tysp1 directory looks different, try to extract the contents
of the compressed tar file again. If your directory looks the same,
you are ready to go.

### Naming convention for examples/solutions ###

The examples in directory are numbered according to the following
convention:

ex-xx-yy_name.sh

Where:

xx   -> The chapter in which the example occurs (ex. 07)
yy   -> The relative position of the example in the chapter. The 
        first example script is 01, the second is 02 and so on. 
name -> The name of the example. Most of the examples do not
        have names in the book, so these are short descriptive
        strings that are useful for quickly identifying a script,
        based on its function.
     
Some examples that are explicitly named in the book do not follow this
convention and stored with the name given in the book. 

The directories for some of the chapters also include solutions for the
Questions from that chapter. In general the solutions are named as follows;

qu-xx-yy.sh

Where :

xx   -> The chapter in which the question occurs (ex. 07)
yy   -> The question number in the chapter

Many of the examples are started using the following line:

#!/bin/sh -v

in order to printout the commands as the shell reads them. This is to
help you determine what the examples are doing. To turn the off just
edit the first line of the script.

### Supported Systems and Contact Information ###

There is no warranty of any kind on these examples. I have tried to
make the examples as portable as possible, and to this end I have
tested each example on the following versions of UNIX:

	* Sun Solaris versions 2.5.1, 2.6, 2.7
	* Hewlett-Packard HP-UX versions 10.10, 10.20, 11.0
	* Red Hat Linux versions 4.2, 5.1, 5.2
	* FreeBSD version 2.2.6

It is possible that some of the examples may not work on other
versions of UNIX. If you encounter a problem or have a suggestion
about improvements to the examples or the content of the book, please
feel free to contact me at the following email address:

[e-mail] 

I appreciate any suggestions and feedback you have regarding this
book.

Thanks,

----ranga <[e-mail]>

$Id: README,v 1.2 1999/03/29 09:11:40 ranga Exp ranga $