da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.fp 5 CW
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de Af
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.if \\$2 .nr ;G \\$1
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ie !\\$3 \{\
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin\\f\\$1\\$3\\f\\$2
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.if !\\$4 .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin\}
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de aF
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nr ;G \\n(.f
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft \\n(;G
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de L
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de LR
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de RL
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EX \" start example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ta 1i 2i 3i 4i 5i 6i
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.RS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PD 0
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft 5
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nf
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EE \" end example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.fi
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PD
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.RE
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin..
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TH LIBAST 3
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.UC 4
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH NAME
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlibast \- introduction to the ast library
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH DESCRIPTION
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThis section describes the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.I AST
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin(AT&T Software Technology) library functions of the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B libast
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlibrary.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B libast
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinserves three major purposes.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFirst, it presents (a subset of) POSIX/ANSI standard headers and interfaces on
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinnon-compliant systems.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinSecond, it provides a portable base of routines that implement concepts
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincommon to all UNIX system variants.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFinally, it is a forum for
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinmodern implementations of features present (or lacking)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinin the standard C libraries.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFeatures better provided by separate libraries are omitted from
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.BR libast .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinFor example, most terminal driver interface issues are left for
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinspecial purpose libraries such as
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR curses (3).
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.PP
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B libast
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinrelated header files are installed in the directories
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR include/ast .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinRoutines that do not advertize their own headers are prototyped in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR <ast.h> .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L <ast.h>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis ANSI, K&R and C++ compatible and includes or defines the equivalent of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR <limits.h> ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR <stddef.h> ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR <stdlib.h> ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR <sys/types.h> ,
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L <string.h>
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinand
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR <unistd.h> .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinOther libraries that depend on
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.B libast
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinmay also have headers installed in the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L include/ast
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindirectories.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH FILES
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nf
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chininclude/ast the \fBast\fP package header directory
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlib/libast.a the \fBlibast\fP library
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlib/libast-g.a the \fBlibast\fP library compiled for debugging
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlib/libast-pg.a the \fBlibast\fP library compiled for profiling
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlib/libast.so.4.0 the \fBlibast\fP shared library
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.fi
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH "SEE ALSO"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinintro(3),
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinintro(2),
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chincc(1)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH CAVEATS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe library documentation is still under construction.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinYes, some of it has been in this state for 20 years.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThank goodness our commands self-document.