------------------------------- Page    i -------------------------------

                Documents for the UTS Time-Sharing System

                         Annotated Bibliography

------------------------------- Page   ii -------------------------------

                            TABLE OF CONTENTS


1.    Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .   1

2.    Introductory Information  . . . . . . . . . . . . . . . . . . .   1

2.1      UTS for Beginners  . . . . . . . . . . . . . . . . . . . . .   1
2.2      UTS Programmer's Manual  . . . . . . . . . . . . . . . . . .   1
2.3      An Introduction to the UTS Shell . . . . . . . . . . . . . .   1
2.4      Learn - Computer-Aided Instruction on UTS  . . . . . . . . .   1

3.    Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1

3.1      Ned Tutorial . . . . . . . . . . . . . . . . . . . . . . . .   2
3.2      Ned Reference Manual . . . . . . . . . . . . . . . . . . . .   2
3.3      A Tutorial Introduction to the UTS Line Editor . . . . . . .   2
3.4      Sed - A Non-interactive Text Editor  . . . . . . . . . . . .   2
3.5      Advanced Editing on UTS  . . . . . . . . . . . . . . . . . .   2

4.    Text Formatting . . . . . . . . . . . . . . . . . . . . . . . .   2

4.1      Formatting Documents on UTS  . . . . . . . . . . . . . . . .   2
4.2      Formatting Memoranda on UTS  . . . . . . . . . . . . . . . .   2
4.3      Formatting Tables on UTS . . . . . . . . . . . . . . . . . .   3
4.4      Writing Tools, the Style and Diction Programs  . . . . . . .   3
4.5      Nroff User's Manual  . . . . . . . . . . . . . . . . . . . .   3
4.6      Formatting Manual Entries on UTS . . . . . . . . . . . . . .   3
4.7      Putting UTS Documents On-line  . . . . . . . . . . . . . . .   3

5.    C Programming . . . . . . . . . . . . . . . . . . . . . . . . .   3

5.1      The C Programming Language . . . . . . . . . . . . . . . . .   3
5.2      Notes on UTS C . . . . . . . . . . . . . . . . . . . . . . .   3
5.3      C Quickscreen User's Guide . . . . . . . . . . . . . . . . .   4
5.4      UTS Programming  . . . . . . . . . . . . . . . . . . . . . .   4
5.5      A Dcon Tutorial  . . . . . . . . . . . . . . . . . . . . . .   4
5.6      Tube Control Language User's Guide . . . . . . . . . . . . .   4

6.    General Tools . . . . . . . . . . . . . . . . . . . . . . . . .   4

6.1      Make - A Program for Maintaining Computer Programs . . . . .   4
6.2      Lint - a C Program Checker . . . . . . . . . . . . . . . . .   4
6.3      Awk - A Pattern Scanning and Processing Language . . . . . .   4
6.4      Yacc - Yet Another Compiler-Compiler . . . . . . . . . . . .   5
6.5      Lex - A Lexical Analyzer Generator . . . . . . . . . . . . .   5
6.6      An Interactive Desk Calculator . . . . . . . . . . . . . . .   5
6.7      An Arbitrary Precision Desk Calculator Language  . . . . . .   5

------------------------------- Page  iii -------------------------------

7.    Miscellaneous . . . . . . . . . . . . . . . . . . . . . . . . .   5

7.1      UTS Assembler Reference Manual . . . . . . . . . . . . . . .   5
7.2      The M4 Macro Processor . . . . . . . . . . . . . . . . . . .   5
7.3      How to Create or Update the UTS Programmer's Manual  . . . .   5
7.4      A Tour Through the UTS C Compiler  . . . . . . . . . . . . .   6

8.    UNIX Information  . . . . . . . . . . . . . . . . . . . . . . .   6

8.1      The UNIX Time-Sharing System . . . . . . . . . . . . . . . .   6
8.2      The Bell System Technical Journal  . . . . . . . . . . . . .   6

9.    System Information  . . . . . . . . . . . . . . . . . . . . . .   6

9.1      UTS Programmer's Manual, Volume 3  . . . . . . . . . . . . .   6
9.2      The UTS I/O System . . . . . . . . . . . . . . . . . . . . .   6
9.3      The UTS Accounting System  . . . . . . . . . . . . . . . . .   6
9.4      UTS Disk Expansion and Shuffling . . . . . . . . . . . . . .   7
9.5      UTS Tape Backup and Restore System . . . . . . . . . . . . .   7


                                                            Last Page   7

-------------------------------- Page  1 --------------------------------

1.    INTRODUCTION

This document lists and describes documents related to the UTS  operating
system.




2.    INTRODUCTORY INFORMATION


2.1      UTS FOR BEGINNERS

A tutorial introduction  designed to  teach the use  of UTS  to a  novice
user.


2.2      UTS PROGRAMMER'S MANUAL

Volume 1 describes the commands that are entered from the keyboard.  This
is the primary reference  manual for all  UTS users.  Volume 2  describes
the functions and  system calls  which can  be used  by programs  running
under UTS.  This is the  primary reference manual for users writing  pro-
grams to run under UTS.


2.3      AN INTRODUCTION TO THE UTS SHELL

The shell provides the interface between  the user and the UTS  operating
system.   This  document  describes  redirection  of  input  and  output,
"pipes", filename pattern matching, and many other features of the shell.


2.4      LEARN - COMPUTER-AIDED INSTRUCTION ON UTS

Learn is a program that  teaches a novice about topics  such as the  file
system or use of the editor.




3.    EDITORS

-------------------------------- Page  2 --------------------------------

3.1      NED TUTORIAL

A tutorial introduction to the UTS 3270 full-screen editor ned.  Contains
examples of how to use ned and highlights problems users may encounter.


3.2      NED REFERENCE MANUAL

The complete reference  manual for  ned.  This manual  describes the  ned
features in detail.


3.3      A TUTORIAL INTRODUCTION TO THE UTS LINE EDITOR

A tutorial teaching the use of ed, a line oriented text editor.


3.4      SED - A NON-INTERACTIVE TEXT EDITOR

User's manual  for  sed,  a non-interactive  context  editor  useful  for
sequences of  complicated editing  commands and  multiple global  editing
commands.


3.5      ADVANCED EDITING ON UTS

This documents describes some  of the  more advanced features  of ed  not
described in A Tutorial Introduction to the UTS Line Editor.




4.    TEXT FORMATTING


4.1      FORMATTING DOCUMENTS ON UTS

Ms is a set of commands and an  nroff macro package for formatting  docu-
ments.


4.2      FORMATTING MEMORANDA ON UTS

Mm is  a set  of  commands and  an  nroff macro  package  for  formatting
memoranda and other documents.

-------------------------------- Page  3 --------------------------------

4.3      FORMATTING TABLES ON UTS

Tbl is a text formatting preprocessor which makes tables easy to  specify
and enter.


4.4      WRITING TOOLS, THE STYLE AND DICTION PROGRAMS

Style evaluates a written documents style.  It measures readability, sen-
tence and word length, verb usage, etc.  Diction examines a  document for
wordy phrasing and bad  diction.  The suggest  program suggests  replace-
ments for phrases caught by diction.


4.5      NROFF USER'S MANUAL

Reference manual for nroff, the  text formatting program  used by ms,  mm
and manual entries.  Because of its complexity, nroff should be used only
when absolutely necessary.  Ms and mm provide nice interfaces to nroff.


4.6      FORMATTING MANUAL ENTRIES ON UTS

Directions for creating entries in the UTS Programmer's Manual.


4.7      PUTTING UTS DOCUMENTS ON-LINE

Describes how to update or  create a new  on-line document.  These  docu-
ments can be viewed with the doc command.




5.    C PROGRAMMING


5.1      THE C PROGRAMMING LANGUAGE

By B.  W. Kernighan  and D.  M. Ritchie,  Prentice-Hall, Inc.,  Englewood
Cliffs, NJ, 1978.  The complete  tutorial and reference manual for the  C
programming language.


5.2      NOTES ON UTS C

This document describes the differences between the C language on UTS and
the version of C described by The C Programming Language.

-------------------------------- Page  4 --------------------------------

5.3      C QUICKSCREEN USER'S GUIDE

Quickscreen is an extension to  C for doing full-screen  I/O to the  3270
terminal on UTS.  This document describes the use of quickscreen.


5.4      UTS PROGRAMMING

This document describes the  programming interface to  the UTS  operating
system and the standard I/O library.


5.5      A DCON TUTORIAL

Dcon is a debugger.  It has some  symbolic capabilities and is useful  in
debugging C programs.


5.6      TUBE CONTROL LANGUAGE USER'S GUIDE

The Tube Control Language (TCL) allows a UTS program to communicate  with
other systems by simulating a 3270 device.




6.    GENERAL TOOLS


6.1      MAKE - A PROGRAM FOR MAINTAINING COMPUTER PROGRAMS

Make provides a simple mechanism for creating and maintaining  up-to-date
versions of  programs that  result from  many operations on  a number  of
files.


6.2      LINT - A C PROGRAM CHECKER

Lint examines  C source  programs,  enforcing the  type rules  of  C  and
detecting a number of bugs and questionable usages.


6.3      AWK - A PATTERN SCANNING AND PROCESSING LANGUAGE

Awk searches input for  patterns and performs  user specified actions  on
each line of input that satisfies the pattern.

-------------------------------- Page  5 --------------------------------

6.4      YACC - YET ANOTHER COMPILER-COMPILER

The parser generator yacc provides a general tool for imposing  structure
on the input to a computer program.


6.5      LEX - A LEXICAL ANALYZER GENERATOR

Lex is a program generator  designed for lexical processing of  character
input streams.


6.6      AN INTERACTIVE DESK CALCULATOR

Dc is a reverse polish notation interactive calculator.


6.7      AN ARBITRARY PRECISION DESK CALCULATOR LANGUAGE

Bc is a language and compiler for doing arbitrary precision arithmetic on
UTS.




7.    MISCELLANEOUS


7.1      UTS ASSEMBLER REFERENCE MANUAL

Describes the UTS assembler.  The  UTS assembler is designed to  assemble
code generated by compilers and does not support all the  features of 370
Assembler.


7.2      THE M4 MACRO PROCESSOR

User's manual for m4, a general purpose macro processor.


7.3      HOW TO CREATE OR UPDATE THE UTS PROGRAMMER'S MANUAL

Directions for releasing a new revision or update of the UTS Programmer's
Manual.

-------------------------------- Page  6 --------------------------------

7.4      A TOUR THROUGH THE UTS C COMPILER

Describes the internals of the UTS C compiler.




8.    UNIX INFORMATION


8.1      THE UNIX TIME-SHARING SYSTEM

The original UNIX- paper by D. M. Ritchie  and K. Thompson.  It gives  an
overview of the organization and philosophy of UNIX.



8.2      THE BELL SYSTEM TECHNICAL JOURNAL

July-August 1978, Vol. 57, No. 6, Part 2.
Contains a number of articles describing the UNIX Timesharing System  and
the Programmer's Workbench.




9.    SYSTEM INFORMATION


9.1      UTS PROGRAMMER'S MANUAL, VOLUME 3

Volume 3 describes commands  and other information  needed by UTS  system
programmers.


9.2      THE UTS I/O SYSTEM

Describes how to write device drivers for UTS.


9.3      THE UTS ACCOUNTING SYSTEM

Describes the accounting  system implemented  on UTS  and the  accounting
reports generated.
_______________
  -UNIX is a trademark of Bell Laboratories.

-------------------------------- Page  7 --------------------------------

9.4      UTS DISK EXPANSION AND SHUFFLING

Describes how to expand and rearrange filesystems (minidisks).


9.5      UTS TAPE BACKUP AND RESTORE SYSTEM

Describes how to copy the system to tape and  how to restore a file  from
tape.
