Files
rtems/doc/posix_users/posix_users.texi
Joel Sherrill 110445cba5 Patch rtems-rc-4.5.0-21.diff from Ralf Corsepius <corsepiu@faw.uni-ulm.de>
which splits the current monolithic specs files into a sequence of
subparts.  These can be concatenated togather to make a the whole .spec
file.  This cleans up the maintenance problem of having "all languages"
and a "C/C++ only" gccnewlib spec files.  Plus it should make it easier
to produce variants like the gdb-m68k-bdm which require special hackery. :)
Ralf's comments:

  It addresses the way *.spec.in get composed inside of the source
  tree.

  Changes:
    * Each spec.in is broken into several files (*.add), one *.add file
      per sub-package.
    * Each Makefile.am composes spec.ins from the *.add files
    * Removal of redundant automake support files.
    * Default value for BuildRoot changed to /tmp/<spec-file-name>
    * %clean stage added to *specs

  Advantages (IMHO).
    * The *.add files are easier to adminstrate and more flexible in
      comparison to the former *.specs.ins.
    * gccnewlib_c_only.spec.in now is composed from the same sources as
      gccnewlib.spec.in (less errors)
    * If using the default BuildRoot --clean now deletes all files that
      were generated while building.

  Notes:
    * rtems.spec.in has not yet been adapted to the scheme used for the
      other *spec.ins
    * Except for cosmetical changes the internals of the  *.spec files
      should not have changed.

  To Apply:
    cvs rm -f scripts/binutils/binutils.spec.in
    cvs rm -f scripts/gccnewlib/gccnewlib.spec.in
    cvs rm -f scripts/gccnewlib/gccnewlib_c_only.spec.in
    cvs rm -f scripts/gdb/gdb.spec.in
    cvs rm -f scripts/config.sub
    cvs rm -f scripts/config.guess
    cvs rm -f scripts/install-sh
    cvs rm -f scripts/mkinstalldirs
    cvs rm -f scripts/missing

    patch -p1 < rtems-rc-4.5.0-21.diff

    cvs add scripts/*/*.add
    cvs add scripts/*/README
2000-06-10 19:41:09 +00:00

160 lines
3.5 KiB
Plaintext

\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename posix_users
@syncodeindex vr fn
@synindex ky cp
@paragraphindent 0
@c @smallbook
@c %**end of header
@c
@c COPYRIGHT (c) 1988-1999.
@c On-Line Applications Research Corporation (OAR).
@c All rights reserved.
@c
@c $Id$
@c
@c
@c Master file for the C User's Guide
@c
@c Joel's Questions
@c
@c 1. Why does paragraphindent only impact makeinfo?
@c 2. Why does paragraphindent show up in HTML?
@c
@include version.texi
@include common/setup.texi
@ifset use-ascii
@dircategory RTEMS On-Line Manual
@direntry
* RTEMS Posix API User's Guide: (posix_users).
Posix API User's Guide Plan
@end direntry
@end ifset
@c variable substitution info:
@c
@c Note: At the moment we do not document the Ada interface but by building
@c in the infrastructure Florist support should be simple to add.
@set is-C
@clear is-Ada
@set LANGUAGE C
@set STRUCTURE structure
@set ROUTINE function
@set OR |
@set RPREFIX RTEMS_
@set DIRPREFIX rtems_
@c the language is @value{LANGUAGE}
@c NOTE: don't use underscore in the name
@c
@c
@c Title Page Stuff
@c
@c
@c I don't really like having a short title page. --joel
@c
@c @shorttitlepage RTEMS POSIX API User's Guide
@setchapternewpage odd
@settitle RTEMS POSIX API User's Guide
@titlepage
@finalout
@title RTEMS POSIX API User's Guide
@subtitle Edition @value{EDITION}, for RTEMS @value{VERSION}
@sp 1
@subtitle @value{UPDATED}
@author On-Line Applications Research Corporation
@page
@include common/cpright.texi
@end titlepage
@c This prevents a black box from being printed on "overflow" lines.
@c The alternative is to rework a sentence to avoid this problem.
@include preface.texi
@include process.texi
@include signal.texi
@include procenv.texi
@include files.texi
@include io.texi
@include device.texi
@include cspecific.texi
@include systemdb.texi
@include semaphores.texi
@include mutex.texi
@include cond.texi
@include memorymgmt.texi
@include sched.texi
@include clock.texi
@include timer.texi
@include message.texi
@include thread.texi
@include key.texi
@include cancel.texi
@include libc.texi
@include libm.texi
@include status.texi
@ifinfo
@node Top, Preface, (dir), (dir)
@top posix_users
This is the online version of the RTEMS POSIX API User's Guide
@menu
* Preface::
* Process Creation and Execution Manager::
* Signal Manager::
* Process Environment Manager::
* Files and Directories Manager::
* Input and Output Primitives Manager::
* Device- and Class- Specific Functions Manager::
* Language-Specific Services for the C Programming Language Manager::
* System Databases Manager::
* Semaphore Manager::
* Mutex Manager::
* Condition Variable Manager::
* Memory Management Manager::
* Scheduler Manager::
* Clock Manager::
* Timer Manager::
* Message Passing Manager::
* Thread Manager::
* Key Manager::
* Thread Cancellation Manager::
* Services Provided by C Library (libc)::
* Services Provided by the Math Library (libm)::
* Status of Implementation::
* Command and Variable Index::
* Concept Index::
@end menu
@end ifinfo
@c
@c
@c Need to copy the emacs stuff and "trailer stuff" (index, toc) into here
@c
@node Command and Variable Index, Concept Index, , Top
@unnumbered Command and Variable Index
@c There are currently no Command and Variable Index entries.
@printindex fn
@node Concept Index, , Command and Variable Index, Top
@unnumbered Concept Index
@c There are currently no Concept Index entries.
@printindex cp
@contents
@bye