HELP HELPFILES                                   Andrew Law, April, 1987
                                              Revised A.Sloman June 1990


    This help file describes some of overview files for POPLOG's on-line
documentation. It assumes some knowledge of how to use the VED editor.

         CONTENTS - (Use <ENTER> g to access required sections)

 -- Documentation - types of documentation and means of access
 -- VED - the Poplog editor
 -- Programming - General facilities
 -- POP-11 - a programming language
 -- List processing in POP-11
 -- LISP a programming language
 -- PROLOG a logic programming language
 -- PML an implementation of Standard ML
 -- FLAVOURS - an object oriented programming language
 -- The Poplog X Windows interface
 -- Initialisation - setting up and tailoring POPLOG
 -- Input/Output (via terminal, devices, or sub-processes)
 -- REF Files
 -- DOC Files
 -- TEACH Files
 -- LIBRARIES - system library files
 -- Information about recent changes to Poplog


-- Documentation - types of documentation and means of access ---------

    HELP *DOCUMENTATION
Contents:
 -- Introduction to POPLOG on-line documentation
 -- Searching for on line documentation files
 -- Searching within files
 -- Other sources of information
 -- Information on terminal keys and their associated functions
 -- Directory Structures
 -- RELATED DOCUMENTATION


-- VED - the Poplog editor --------------------------------------------

    HELP *VED
Contents:
 -- Introductions
 -- General Facilities
 -- Word processing and text formatting
 -- Programming in VED
 -- Running shell or DCL from a VED window
 -- VED input/output
 -- Information about files
 -- Altering VED's behaviour for different kinds of files
 -- Making VED emulate EMACS
 -- Making VED emulate WORDSTAR
 -- Customising VED
 -- Terminal setups for different terminals
 -- Information on key-bindings and terminals
 -- Interacting with VED under program control
 -- Graphics facilities in VED
 -- Using VED with mail and net news
 -- Associated Documentation


-- Programming - General facilities -----------------------------------

    HELP *PROGRAMMING
Contents:
 -- Overviews of the different languages
 -- Programming in VED (The POPLOG Visual EDitor)
 -- Mixed language programming
 -- ... General
 -- ... Prolog and POP-11
 -- ... Common LISP and Prolog
 -- ... Common LISP and POP-11
 -- ... ML and POP-11
 -- ... Using Non-POPLOG Languages
 -- Debugging aids
 -- ... General
 -- ... POP-11
 -- ... Prolog
 -- ... Lisp
 -- ... ML
 -- Timing Procedures and Efficiency
 -- Errors, Warning messages and Interrupts
 -- ... General
 -- ... ML
 -- ... LISP
 -- Saved Images
 -- Sections
 -- Virtual Machine
 -- Memory, Memory Limits, And Garbage Collection
 -- Datatypes
 -- ASSOCIATED DOCUMENTATION


-- POP-11 - a programming language ------------------------------------

    HELP *POP
Contents:
 -- POP Vmcode, Compilation, Itemisation, Input/Output
 -- POP Syntax, the Matcher & Recursion
 -- POP-11 syntax procedures
 -- List processing
 -- Mixed language programming
 -- Datatypes
 -- System global variables
 -- System procedures
 -- Procedures concerned with the POP-11 Database
 -- The POP-11 Turtle
 -- Debugging, Errors & Mishaps, Timing and Efficiency
 -- Identifiers
 -- Arithmetic
 -- Information about POP-11 libraries
 -- Closures
 -- Logical bit operations
 -- Updater
 -- Control facilities and co-routines
 -- Stack manipulation
 -- General POP-11 procedures
 -- ASSOCIATED DOCUMENTATION


-- List processing in POP-11 ------------------------------------------

    HELP *LISTS
Contents:
 -- Overviews of list processing.
 -- List syntax
 -- Pattern matching
 -- Accessing lists
 -- Examining characteristics of lists (e.g., membership,length)
 -- Processing elements of lists (e.g., sorting, deleting, reversing)
 -- Iteration over lists
 -- Copying lists
 -- Dynamic Lists
 -- List input and output (e.g., reading in printing out)
 -- Lists and pair manipulation
 -- Efficiency and Fast Procedures


-- LISP a programming language ----------------------------------------

    HELP *HELPFILES (invoked from the LISP subsystem)
Contents:
 -- Introduction, Relation to VED, Bugs, POPLOG Specifics
 -- Built in functions and Variables
 -- Mixed language Programming
 -- Debugging, Timing and Mishaps
 -- DIRECTORIES
 -- ASSOCIATED DOCUMENTATION


-- PROLOG a logic programming language --------------------------------

    PLOGHELP *HELPFILES
Contents:
 -- General
 -- The Prolog System and differences to other implementations
 -- Mishaps and Error handling and Bugs
 -- Prolog control facilities
 -- Efficiency, statistics, fast predicates
 -- Debugging, viewing spying Prolog programs
 -- PROLOG Input/Output
 -- Natural Language Processing in Prolog
 -- Numerical Operators
 -- Mixed Language Programming
 -- Other Builtin Predicates and Operators
 -- Other Libraries
 -- ASSOCIATED DOCUMENTATION

See also
    PLOGTEACH *TEACHFILES


-- PML an implementation of Standard ML -------------------------------

The overview file HELP * PML describes the Poplog implementation of
Standard ML

Contents:
 -- Note on reading PML HELP files
 -- Introduction
 -- Running PML
 -- Initialisation
 -- Command Line Arguments
 -- PML and POP-11
 -- Further Documentation
 -- References


-- FLAVOURS - an object oriented programming language -----------------

    HELP *FLAVOURS
Contents:
 -- Tutorial introduction
 -- General
 -- Browser for flavours
 -- Applications
 -- Changes to the flavour system
 -- A Different Object Oriented Package
 -- ASSOCIATED DOCUMENTATION


-- The Poplog X Windows interface -------------------------------------

HELP *X gives an overview. The following initial table of contents will
get out of date as the file is extended.

Contents:
 -- Introduction
 -- Note for experienced programmers
 -- Pre-requisites
 -- VED in X
 -- Accessing the Poplog/X libraries
 -- Finding what documentation is available
 -- Working through a simple Poplog/X demonstration
 -- Other TEACH files
 -- Important HELP files
 -- Acknowledgement


-- Initialisation - setting up and tailoring POPLOG -------------------

    HELP * INITIAL
Contents:
 -- Environment variables
 -- Setting up the environment
 -- Search paths used when POPLOG starts up
 -- Directories
 -- Running POPLOG
 -- Using initialisation files to tailor the system
 -- POPLOG Initialisation files
 -- Over-riding system-wide initialisation: changing $popsys
 -- Changing $poplib
 -- Tailoring POP11
 -- Tailoring Prolog
 -- Tailoring Common Lisp
 -- Tailoring PML
 -- Initialising VED
 -- VED Search lists
 -- Tailoring VED for Individual files
 -- Tailoring the way POPLOG manipulates files
 -- Examples of tailoring and initialisation files
 -- Running saved images
 -- Layered saved images
 -- Running Unix saved images with no abbreviation facility

See ALSO REF * SYSTEM


-- Input/Output (via terminal, devices, or sub-processes) -------------

    HELP *IO
Contents:
 -- General
 -- Input
 -- (From the terminal)
 -- (From storage devices)
 -- (From VED)
 -- Output
 -- (To a terminal/VED)
 -- (To storage devices)
 -- (Printing)
 -- Information about devices, changing devices
 -- Input from and output to sub-process (via pipes)
 -- Reading input from proglist
 -- Itemisation of text, item repeaters/consumers
 -- Formatting output
 -- Time outs
 -- Error output

See also HELP * INPUT, * OUTPUT
and on Unix Poplog: HELP * PIPEUTILS


-- REF Files ----------------------------------------------------------

    REF *REFFILES


-- DOC Files ----------------------------------------------------------

    DOC *DOCFILES


-- TEACH Files --------------------------------------------------------

    TEACH *TEACHFILES
Contents:
 -- Getting starting with the editor and files
 -- Basic overview of POP-11
 -- Some mini-projects - for beginners
 -- More detailed POP-11 exercises and explanations
 -- Introduction to grammars, parsing, sentence generation
 -- Teach files concerned with pictures or images
 -- Teach files concerned with Prolog
 -- Teach files concerned with Lisp
 -- Teach files concerned with AI techniques
 -- Miscellaneous


-- LIBRARIES - system library files -----------------------------------

    HELP *LIBFILES Contents:
 -- General Introduction
 -- Autoloadable libraries
 -- Data libraries
 -- Database libraries
 -- Demo libraries
 -- Flavours libraries
 -- Include libraries
 -- psv libraries
 -- sun libraries
 -- Turtle libraries
 -- VED libraries
 -- The general POP-11 libraries
 -- (Programming)
 -- (Debugging, Tracing, Programming Support)
 -- (Printing)
 -- (Input output control libraries)
 -- ("Classic" AI program demos)
 -- (Natural Language Processing (NLP))
 -- (Vision Processing Library Packages)
 -- (Event Simulation, Multi-Tasking)
 -- (Graphics Related libraries)
 -- (PROLOG)
 -- (FLAVOURS)
 -- Miscellaneous


-- Information about recent changes to Poplog -------------------------

HELP *NEWS
    This should be read whenever a new version of Poplog is acquired

HELP * XNEWS
    Changes to the Poplog X interface

HELP * LISPNEWS
    Changes to the LISP subsystem

HELP * PLOGNEWS
    Changes to Prolog


--- C.all/help/helpfiles
--- Copyright University of Sussex 1990. All rights reserved. ----------