Variant versions of manual pages

Olson, Arthur David (NIH/NCI) olsona at dc37a.nci.nih.gov
Mon Oct 20 13:26:18 UTC 2003


Would text of the sort shown below (for "newstrftime.3") meet the preceived
need for non-man versions of the manual pages?

				--ado

NAME
     strftime - format date and time

SYNOPSIS
     #include <sys/types.h>
     #include <time.h>

     size_t strftime(buf, maxsize, format, timeptr)
     char *buf;
     size_t maxsize;
     const char *format;
     const struct tm *timeptr

     cc ... -ltz

DESCRIPTION
     The strftime function formats the information  from  timeptr
     into  the  buffer  buf according to the string pointed to by
     format.

     The format  string  consists  of  zero  or  more  conversion
     specifications  and ordinary characters.  All ordinary char-
     acters are copied directly into the  buffer.   A  conversion
     specification consists of a percent sign and one other char-
     acter.

     No more than maxsize  characters  are  be  placed  into  the
     array.  If the total number of resulting characters, includ-
     ing the terminating null character, is not  more  than  max-
     size,  strftime  returns  the  number  of  characters in the
     array, not counting the terminating null.   Otherwise,  zero
     is returned.

     Each conversion specification is replaced by the  characters
     as follows which are then copied into the buffer.

     %A   is replaced by the locale's full weekday name.

     %a   is replaced by the locale's abbreviated weekday name.

     %B   is replaced by the locale's full month name.

     %b or %h
          is replaced by the locale's abbreviated month name.

     %C   is replaced by the century (a year divided by  100  and
          truncated to an integer) as a decimal number (00-99).

     %c   is replaced by the locale's appropriate date  and  time
          representation.

     %D   is replaced by the date in the format %m/%d/%y.
     %d   is replaced by the day of the month as a decimal number
          (01-31).

     %e   is replaced by the day of month  as  a  decimal  number
          (1-31); single digits are preceded by a blank.

     %F   is replaced by the date in the format %Y-%m-%d.

     %G   is replaced by the ISO 8601  year  with  century  as  a
          decimal number.

     %g   is replaced by the ISO 8601 year without century  as  a
          decimal number (00-99).

     %H   is replaced by the hour (24-hour clock)  as  a  decimal
          number (00-23).

     %I   is replaced by the hour (12-hour clock)  as  a  decimal
          number (01-12).

     %j   is replaced by the day of the year as a decimal  number
          (001-366).

     %k   is replaced by the hour (24-hour clock)  as  a  decimal
          number (0-23); single digits are preceded by a blank.

     %l   is replaced by the hour (12-hour clock)  as  a  decimal
          number (1-12); single digits are preceded by a blank.

     %M   is replaced by the minute as a decimal number (00-59).

     %m   is replaced by the month as a decimal number (01-12).

     %n   is replaced by a newline.

     %p   is replaced by the locale's equivalent of either AM  or
          PM.

     %R   is replaced by the time in the format %H:%M.

     %r   is replaced by the locale's representation  of  12-hour
          clock time using AM/PM notation.

     %S   is replaced by the second as a decimal number (00-60).

     %s   is replaced by the number of seconds since  the  Epoch,
          UTC (see mktime(3)).

     %T   is replaced by the time in the format %H:%M:%S.

     %t   is replaced by a tab.

     %U   is replaced by the week number of the year  (Sunday  as
          the first day of the week) as a decimal number (00-53).

     %u   is replaced by the weekday (Monday as the first day  of
          the week) as a decimal number (1-7).

     %V   is replaced by the week number of the year  (Monday  as
          the first day of the week) as a decimal number (01-53).
          If the week containing January 1 has four or more  days
          in  the  new  year,  then it is week 1; otherwise it is
          week 53 of the previous year, and the next week is week
          1.

     %W   is replaced by the week number of the year  (Monday  as
          the first day of the week) as a decimal number (00-53).

     %w   is replaced by the weekday (Sunday as the first day  of
          the week) as a decimal number (0-6).

     %X   is replaced by the locale's appropriate time  represen-
          tation.

     %x   is replaced by the locale's appropriate date  represen-
          tation.

     %Y   is replaced by the  year  with  century  as  a  decimal
          number.

     %y   is replaced by the year without century  as  a  decimal
          number (00-99).

     %Z   is replaced by the time zone  name,  or  by  the  empty
          string if this is not determinable.

     %z   is replaced by the offset from UTC in the format  +HHMM
          or   -HHMM   as   appropriate,   with  positive  values
          representing locations east of  Greenwich,  or  by  the
          empty string if this is not determinable.

     %%   is replaced by a single %.

     %+   is replaced by the date and time in date(1) format.

SEE ALSO
     date(1),  getenv(3),  newctime(3),   newtzset(3),   time(2),
     tzfile(5)



More information about the tz mailing list