From 80e5ebff1126f523b4ee6d00b7494c1a559bbaa0 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Mon, 12 Oct 2015 03:21:05 +0200 Subject: info: intro MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/info/chap/introduction.texinfo | 42 ++++++++++++++++++++++++++++++++++++++ doc/info/slibc.texinfo | 8 +++----- 2 files changed, 45 insertions(+), 5 deletions(-) create mode 100644 doc/info/chap/introduction.texinfo (limited to 'doc/info') diff --git a/doc/info/chap/introduction.texinfo b/doc/info/chap/introduction.texinfo new file mode 100644 index 0000000..e846bda --- /dev/null +++ b/doc/info/chap/introduction.texinfo @@ -0,0 +1,42 @@ +@node Introduction +@chapter Introduction + +@cpindex Hosted environment +@cpindex Unhosted environment +The C programming language does not provide +an built-in functions or constant values. +It only, provides a few basic numerical +data types. In fact, it does not even call +the function @code{main}. All of these +facilities are provided by the C standard +library. A C environment with a C standard +library is called a hosted environment; one +without it is called an unhosted environment. +Almost all software written in C are written +in hosted C. There are practically only two +types of software not written in an unhosted +environment, the C standard library (commonly +called @command{libc}) implementations +themself, and operating system kernels and +programs started before it. + +The Stockholm C Standard Library, or simply +@command{slibc}, described in this document, +is an implementaton of a C standard library for +@sc{POSIX} systems. It is aimed at supporting +@sc{C99} and newer dialects of @sc{ISO}@tie{}C, +and no other programming languages. @command{slibc} +is not aimed to replace an existing @command{libc} +implementation or suiting a particular niche. +Rather, @command{slibc} is intended as a learning +experiences for its developer. It does however, +add extensions (features) that are not defined +by the standards it covers or even existing +@command{libc} implementations. + +@command{slibc}'s header files document all +features it implements. This manual is intended +as a more extensive documentation. It is written +with the assumption that you are familiar with +the C programming language. + diff --git a/doc/info/slibc.texinfo b/doc/info/slibc.texinfo index d25a956..7979142 100644 --- a/doc/info/slibc.texinfo +++ b/doc/info/slibc.texinfo @@ -213,7 +213,7 @@ Stockholm C Standard Library. @titlepage @title Stockholm C Standard Library -@subtitle The @sc{slibc} reference manual +@subtitle The @command{slibc} reference manual @ifset DATE @ifset VERSION @@ -308,10 +308,7 @@ Stockholm C Standard Library. -@node Introduction -@chapter Introduction - -Lorem ipsum +@include chap/introduction.texinfo @@ -323,6 +320,7 @@ Lorem ipsum @appendix GNU Free Documentation License @include fdl.texinfo + @node Concept index @unnumbered Concept index Index of concepts. -- cgit v1.2.3-70-g09d2