Commit Graph

68 Commits

Author SHA1 Message Date
Michael Kerrisk c634028ab5 intro.1, time.1, _syscall.2, accept.2, brk.2, capget.2, faccessat.2, futimesat.2, gethostname.2, intro.2, ioprio_set.2, kill.2, madvise.2, mlock.2, mount.2, msgget.2, perf_event_open.2, poll.2, readv.2, sched_rr_get_interval.2, sched_setscheduler.2, select.2, select_tut.2, shmget.2, stat.2, timer_create.2, ustat.2, vfork.2, wait.2, alloca.3, atexit.3, catopen.3, crypt.3, dbopen.3, fenv.3, fopen.3, getaddrinfo_a.3, gethostbyname.3, getutent.3, intro.3, login.3, mallopt.3, queue.3, regex.3, sigpause.3, sigsetops.3, stdio.3, strftime.3, strptime.3, sysconf.3, ttyslot.3, undocumented.3, cciss.4, console_codes.4, hpsa.4, initrd.4, intro.4, rtc.4, st.4, tty_ioctl.4, wavelan.4, acct.5, charmap.5, dir_colors.5, hosts.5, intro.5, termcap.5, utmp.5, intro.6, armscii-8.7, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, ddp.7, epoll.7, glob.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, man-pages.7, man.7, math_error.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, pthreads.7, raw.7, rtnetlink.7, signal.7, socket.7, spufs.7, svipc.7, tcp.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, intro.8: Global fix: use consistent capitalization in .SS headings
Capitalization in .SS sections across pages (and sometimes even
within a single page) is wildly inconsistent. Make it consistent.
Capitalize first word in heading, but otherwise use lower case,
except where English usage (e.g., proper nouns) or programming
language requirements (e.g., identifier names) dictate otherwise.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 15:08:38 +01:00
Michael Kerrisk eae2dfceab futimesat.2, mount.2, confstr.3, iconv.3, makedev.3, malloc.3, strcasecmp.3, strcat.3, strcmp.3, strcpy.3, strdup.3, strftime.3, strnlen.3, strpbrk.3, strspn.3, strtok.3, strxfrm.3, sk98lin.4, icmp.7, ipv6.7, packet.7, raw.7, rtnetlink.7, unix.7, x25.7, ldconfig.8, nscd.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-11 08:09:28 +12:00
Michael Kerrisk 4175f99924 add_key.2, query_module.2, request_key.2, resolver.3, stpcpy.3, strftime.3, elf.5, proc.5, mdoc.samples.7: srcfix: Wrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
Michael Kerrisk a00b7454b8 confstr.3, strcasecmp.3, strcat.3, strcmp.3, strcpy.3, strdup.3, strftime.3, strlen.3, strnlen.3, strpbrk.3, strspn.3, strtok.3, strxfrm.3: Clarify that these functions operate on bytes, not (wide) characters
Change 'character(s)' to 'byte(s)' to make clear that these
functions operate on bytes, not wide / UTF8 characters.
(POSIX uses 'byte(s)' similarly, to make this point.)

Reported-by: Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:16 +12:00
Michael Kerrisk 44a720e388 sigwait.3, strftime.3: Minor fix to heading
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-13 04:08:12 +13:00
Michael Kerrisk 5503c85ea4 intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash
Normal English typographical convention is not to have
spaces around em dashes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:47:35 +02:00
Michael Kerrisk 008f1ecc43 intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getpriority.2, getuid.2, intro.2, ioctl.2, mincore.2, mknod.2, personality.2, ptrace.2, read.2, recv.2, select_tut.2, send.2, sendfile.2, shmctl.2, sigaction.2, signal.2, stat.2, times.2, truncate.2, umask.2, wait.2, MB_CUR_MAX.3, MB_LEN_MAX.3, argz_add.3, btowc.3, clearenv.3, clock.3, cmsg.3, end.3, endian.3, errno.3, exit.3, fgetwc.3, fgetws.3, fopen.3, fputwc.3, fputws.3, fseek.3, fwide.3, getfsent.3, getgrnam.3, gethostid.3, getipnodebyname.3, getmntent.3, getpwnam.3, getwchar.3, grantpt.3, iconv.3, iconv_close.3, iconv_open.3, insque.3, intro.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mkstemp.3, mktemp.3, nl_langinfo.3, openpty.3, posix_openpt.3, printf.3, ptsname.3, putwchar.3, qecvt.3, rcmd.3, readdir.3, rexec.3, rpc.3, setnetgrent.3, shm_open.3, sigpause.3, stdin.3, stpcpy.3, strftime.3, strptime.3, syslog.3, towctrans.3, towlower.3, towupper.3, ttyslot.3, ungetwc.3, unlocked_stdio.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wprintf.3, console_ioctl.4, pts.4, elf.5, filesystems.5, hosts.5, proc.5, ttytype.5, boot.7, capabilities.7, credentials.7, epoll.7, glob.7, koi8-r.7, path_resolution.7, pty.7, signal.7, suffixes.7, time.7, unicode.7, unix.7, uri.7, utf-8.7: global fix: s/Unix/UNIX/
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:17 +02:00
Michael Witten a0c811713d strftime.3: Move 822-compliant date format example to EXAMPLES section
The RFC 822-compliant date format given in the description
of `%z' is now moved to the `EXAMPLES' section (note: `EXAMPLE'
has been renamed `EXAMPLES').

Furthermore, that format example is now actually
RFC 822-compliant (using `%y' instead of `%Y') and has been
qualified as being correct only when in the context of at least
an English locale. Also, `%T' is used in place of `%H:%M:%S'.

For completeness, an RFC 2822-compliant format example has been
similarly added.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-17 05:28:13 +01:00
Michael Witten db74fcddde strftime.3: Expand introductory text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-17 05:02:38 +01:00
Michael Witten f49c451a62 stime.2, time.2, utimensat.2, ctime.3, difftime.3, ftime.3, getspnam.3, mq_receive.3, mq_send.3, rtime.3, sem_wait.3, strftime.3, strptime.3, timeradd.3, rtc.4, core.5, proc.5, icmp.7, time.7: Global fix: Consistently define the Epoch
All definitions of the Epoch have been refactored to the following:

  1970-01-01 00:00:00 +0000 (UTC)

That form is more consistent, logical, precise, and internationally
recognizable than the other variants.

Also, some wording has been altered as well.

Signed-off-by: Michael Witten <mfwitten@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-17 04:55:05 +01:00
Michael Kerrisk 884266b8f1 strftime.3: %z is defined in SUSv3
So, substitute "GNU" tag in man page by "SU".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 19:26:57 +01:00
Michael Witten f37678fe33 strftime.3: Clarification of %z specifier
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 19:23:49 +01:00
Michael Witten 750d65df7d stime.2, strftime.3, tzset.3, zic.8: GMT -> UTC (where appropriate)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 19:17:39 +01:00
Michael Kerrisk 6f60ee752d strftime.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 19:08:33 +01:00
Nicolas François e46256a48c strftime.3: Fix error in description: s/Monday/Thursday/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:31 +02:00
Michael Kerrisk 590d0346d9 strftime.3: Add details on ISO 8601 week-based dates
ISO 8602 week-based dates are relevant for %G, %g, and %V,
and the existing details on these dates are a little thin.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 16:05:49 +13:00
Michael Kerrisk 894765f0e5 strftime.3: Remove mention of year from ISO 8601 standard
The text mentioned the 1988 8601 standard, but there have
already been two revisions of the standard since then, so
simply remove mention of the year.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 14:02:37 +13:00
Michael Kerrisk 3d78d77891 strftime.3: Small fix to description of %G
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677

Reported-by: Reuben Thomas <rrt@femur.dyndns.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-24 14:02:36 +13:00
Michael Kerrisk d84d0300a5 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getaddrinfo.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5: srcfix
s/\.R " "/\\\&/ as a way of getting a blank line after a .SS heading.
(Suggested by Sam Varshavchik <mrsam@courier-mta.com>)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 20:42:45 -05:00
Michael Kerrisk 08c9b488f4 timerfd_create.2, ctime.3, frexp.3, strftime.3, strtok.3, tty_ioctl.4, iso_8859-7.7: tstamp 2008-10-29 15:36:12 -05:00
Michael Kerrisk a831ef971d frexp.3, strftime.3, strtok.3: Global fix: relocate shell session above example program
Move the shell session text that demonstrates the use of
the example program so that it precedes the actual
example program.  This makes the page consistent with the
majority of other pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:24 -05:00
Michael Kerrisk b43a3b301e eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk a173b8c674 strftime.3: ffix 2008-10-29 14:54:22 -05:00
Michael Kerrisk e6068f213e strftime.3: srcfix: Added FIXME 2008-10-29 14:54:13 -05:00
Nicolas François 69cb728c2f wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 13:24:36 +02:00
Michael Kerrisk 5b0dc1baed s/time zone/timezone/ for consistency across pages and with POSIX.1. 2008-09-07 04:17:25 +00:00
Michael Kerrisk 6387216bb2 Wrap lines at sentence breaks. 2008-06-28 04:57:20 +00:00
Michael Kerrisk f81fb4445b s/\\'/\\(aq/ 2008-06-09 15:49:35 +00:00
Michael Kerrisk f8a07a2154 s/'/\\'/ to improve rendering in UTF-8. 2008-06-05 17:52:37 +00:00
Michael Kerrisk 22a10f256f ffix 2007-12-23 13:08:47 +00:00
Michael Kerrisk f3ae4e7d1c grfix 2007-12-23 13:03:22 +00:00
Michael Kerrisk dfad8c611e ffix 2007-12-23 13:02:05 +00:00
Michael Kerrisk a08ea57c20 Make the standard indent for code samples, shell session
logs, etc. to be ".in +4n".
2007-12-19 05:53:30 +00:00
Michael Kerrisk ec5a588f8d ffix 2007-12-16 13:39:24 +00:00
Michael Kerrisk 53f2273621 ffix 2007-12-10 14:49:55 +00:00
Michael Kerrisk 0daa9e92d0 Fix redundant formatting macros 2007-09-20 16:26:31 +00:00
Michael Kerrisk 5adafd6d79 ffix 2007-07-09 21:02:59 +00:00
Michael Kerrisk d089e7b597 spfix 2007-07-09 20:47:54 +00:00
Michael Kerrisk 097585edcb ffix 2007-06-22 20:40:07 +00:00
Michael Kerrisk 492562689a Note use of "gcc -Wno-format-y2k" to avoid the "`%c'yields only
last 2 digits of year in some locales" warning.
2007-06-15 05:59:35 +00:00
Michael Kerrisk 928410b493 s/`/'/ when the thing being quoted is a character. 2007-06-12 21:40:00 +00:00
Michael Kerrisk 1c6503cd4a Small wording fix 2007-06-12 04:17:57 +00:00
Michael Kerrisk 75b94dc35c Change "e.g. " to "e.g., ", or in some cases, "for example, ".
Change "i.e. " to i.e.., ", or in some cases, "that is, ".
2007-06-08 11:56:22 +00:00
Michael Kerrisk d9bfdb9c21 Convert to American spelling conventions 2007-06-08 09:56:56 +00:00
Michael Kerrisk d597239cbd Relocated GLIBC NOTES as subsection under NOTES 2007-05-18 10:30:02 +00:00
Michael Kerrisk 60a90ecdae Convert function formatting of the form "\fBname\fP()" to ".BR name ()". 2007-05-12 09:06:04 +00:00
Michael Kerrisk c13182efa3 Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
2007-04-12 22:42:49 +00:00
Michael Kerrisk 7295b7eda0 Replaced tabs with spaces 2007-04-05 13:29:41 +00:00
Michael Kerrisk b9f027105c ffix 2007-04-03 15:32:52 +00:00
Michael Kerrisk 68e1685c25 Updated CONFORMING TO section 2006-08-03 13:57:30 +00:00