diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/libc.texinfo | 4 | ||||
-rw-r--r-- | manual/nss.texi | 23 | ||||
-rw-r--r-- | manual/time.texi | 92 |
3 files changed, 109 insertions, 10 deletions
diff --git a/manual/libc.texinfo b/manual/libc.texinfo index 8622e04fcb..a6553d617e 100644 --- a/manual/libc.texinfo +++ b/manual/libc.texinfo @@ -12,8 +12,8 @@ @c sold 0.06/1.09, print run out 21may96 @set EDITION 0.07 DRAFT -@set VERSION 1.09 Beta -@set UPDATED 21 May 1996 +@set VERSION 2.00 Beta +@set UPDATED 16 Aug 1996 @set ISBN 1-882114-53-1 @ifinfo diff --git a/manual/nss.texi b/manual/nss.texi index cd1f4af0ec..45cbf46110 100644 --- a/manual/nss.texi +++ b/manual/nss.texi @@ -17,7 +17,7 @@ scheme @dfn{Name Service Switch} (NSS). Though the interface might be similar to Sun's version there is no common code. We never saw any source code of Sun's implementation and -so the internal interface are incompatible. This is also manifest in the +so the internal interface is incompatible. This is also manifests in the file names we use as we will see later. @@ -158,9 +158,9 @@ The second item in the specification gives the user much finer control on the lookup process. Action items are placed between two service names and are written within brackets. The general form is -@smallexample -[ @r{(}!@r{?} @var{status} = @var{action}@r{)+} ] -@end smallexample +@display +@t{[} ( @t{!}? @var{status} @t{=} @var{action} )+ @t{]} +@end display @noindent where @@ -331,6 +331,21 @@ access them. If a function is not available it is simply treated as if the function would return @code{unavail} (@pxref{Actions in the NSS configuration}). +The file name @file{libnss_files.so.1} would be on a @w{Solaris 2} +system @file{nss_files.so.1}. This is the difference mentioned above. +Sun's NSS modules are usable as modules which get indirectly loaded +only. + +The NSS modules in the GNU C Library are prepared to be used as normal +libraries itself. +@comment Fix me if necessary. +This is @emph{not} true in the moment, though. But the different +organization of the name space in the modules does not make it +impossible like it is for Solaris. Now you can see why the modules are +still libraries.@footnote{There is a second explanation: we were too +lazy to change the Makefiles to allow the generation of shared objects +not starting with @file{lib} but do not tell this anybody.} + @node NSS Modules Interface, , NSS Module Names, NSS Module Internals @subsection The Interface of the Function in NSS Modules diff --git a/manual/time.texi b/manual/time.texi index c8ca7e8118..f439840170 100644 --- a/manual/time.texi +++ b/manual/time.texi @@ -624,7 +624,20 @@ time conversion (@pxref{Locales}). Ordinary characters appearing in the @var{template} are copied to the output string @var{s}; this can include multibyte character sequences. -Conversion specifiers are introduced by a @samp{%} character, and are +Conversion specifiers are introduced by a @samp{%} character. Now can +follow an optional flag which can be one of the following. These flags +only affect the output of numbers: + +@table @code +@item _ +The number is padded with spaces. + +@item - +The number is not padded at all. +@end table + +The default action is to pad the number with zeros. Following to the +flag comes the format specifier. The whole @samp{%} sequence is replaced in the output string as follows: @table @code @@ -643,9 +656,29 @@ The full month name according to the current locale. @item %c The preferred date and time representation for the current locale. +@item %C +The century of the year. + @item %d The day of the month as a decimal number (range @code{01} to @code{31}). +@item %D +The date using the format @code{%m/%d/%y}. + +This format is a GNU extension. + +@item %d +The day of the month like with @code{%d}, but padded with blank (range +@code{ 1} to @code{31}). + +This format is a GNU extension. + +@item %h +The abbreviated month name according to the current locale. The action +is the same as for @code{%b}. + +This format is a GNU extension. + @item %H The hour as a decimal number, using a 24-hour clock (range @code{00} to @code{23}). @@ -657,19 +690,64 @@ The hour as a decimal number, using a 12-hour clock (range @code{01} to @item %j The day of the year as a decimal number (range @code{001} to @code{366}). +@item %k +The hour as a decimal number, using a 24-hour clock like @code{%H}, but +padded with blank (range @code{ 0} to @code{23}). + +This format is a GNU extension. + +@item %l +The hour as a decimal number, using a 12-hour clock like @code{%I}, but +padded with blank (range @code{ 0} to @code{12}). + +This format is a GNU extension. + @item %m The month as a decimal number (range @code{01} to @code{12}). @item %M The minute as a decimal number. +@item %n +A single @samp{\n} (newline) character. + +This format is a GNU extension. + @item %p Either @samp{am} or @samp{pm}, according to the given time value; or the corresponding strings for the current locale. +@item %r +The time in decinal numbers using the format @code{%I:%M:%S %p}. + +This format is a GNU extension. + +@item %R +The hour and minute in decimal numbers using the format @code{%H:%M}. + +This format is a GNU extension. + +@item %s +The seconds since the epoch, i.e., 1 January 1970 00:00:00 UTC. Note +that this value is the number of seconds between the epoch and the +current date as defined by the @code{localtime} system call. It is not +changed by the @code{--date} option. + +This format is a GNU extension. + @item %S The second as a decimal number. +@item %t +A single @samp{\t} (tabulator) character. + +This format is a GNU extension. + +@item %T +The time using decimal numbers using the format @code{%H:%M:%S}. + +This format is a GNU extension. + @item %U The week number of the current year as a decimal number, starting with the first Sunday as the first day of the first week. All days preceding @@ -682,14 +760,14 @@ containing January 1 has four or more days in the new year it is considered to be week @code{1}. Otherwise it is week @code{53} of the previous year. This is standardized in @w{ISO 8601:1988}. +@item %w +The day of the week as a decimal number, Sunday being @code{0}. + @item %W The week number of the current year as a decimal number, starting with the first Monday as the first day of the first week. All days preceding the first Monday in the year are considered to be in week @code{0}. -@item %w -The day of the week as a decimal number, Sunday being @code{0}. - @item %x The preferred date representation for the current locale, but without the time. @@ -704,6 +782,12 @@ The year as a decimal number, but without a century (range @code{00} to @item %Y The year as a decimal number, including the century. +@item %z +@w{RFC 822}/@w{ISO 8601:1988} style numeric time zone (e.g., -0600 or ++0100), or nothing if no time zone is determinable. This value reflects +the @emph{current} time zone. It is not changed by the @code{--date} +option. + @item %Z The time zone or name or abbreviation (empty if the time zone can't be determined). |