LIBAST.3 revision da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968
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.nr ;G \\n(.f
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EX \" start example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ta 1i 2i 3i 4i 5i 6i
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EE \" end example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.TH LIBAST 3
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinlibast \- introduction to the ast library
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH DESCRIPTION
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThis section describes the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin(AT&T Software Technology) library functions of the
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).
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinrelated header files are installed in the directories
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinRoutines that do not advertize their own headers are prototyped in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis ANSI, K&R and C++ compatible and includes or defines the equivalent of
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinOther libraries that depend on
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinmay also have headers installed in the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindirectories.
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.SH "SEE ALSO"
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.