~ubuntu-branches/ubuntu/saucy/manpages/saucy

« back to all changes in this revision

Viewing changes to Changes.old

  • Committer: Package Import Robot
  • Author(s): Loïc Minier
  • Date: 2011-10-17 13:06:22 UTC
  • mfrom: (1.1.46 upstream) (2.2.11 sid)
  • Revision ID: package-import@ubuntu.com-20111017130622-rbdw3julnma2baqu
Tags: 3.32-0.2ubuntu1
* Merge from Debian testing/unstable; remaining changes:
  - ptrace.2, prctl.2: document Ubuntu-specific PTRACE_ATTACH,
    PR_SET_PTRACER behavior.
* Keep Debian's glibc-doc version in the Replaces as it's satisfactory for
  upgrades from natty and lucid.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1530
1530
 
1531
1531
remap_file_pages.2
1532
1532
    mtk
1533
 
        Added text to note that start and size are both rounded downwards.
 
1533
        Added text to note that start and size are both rounded downward.
1534
1534
 
1535
1535
sched_setparam.2
1536
1536
    mtk
19123
19123
    Michael Kerrisk
19124
19124
        s/non-/non/
19125
19125
            The tendency in English, as prescribed in style guides like
19126
 
            Chicago MoS, is towards removing hyphens after prefixes
 
19126
            Chicago MoS, is toward removing hyphens after prefixes
19127
19127
            like "non-" etc.
19128
19128
 
19129
19129
Various pages
19130
19130
    Michael Kerrisk
19131
19131
        Global fix: s/re-/re/
19132
19132
            The tendency in English, as prescribed in style guides like
19133
 
            Chicago MoS, is towards removing hyphens after prefixes
 
19133
            Chicago MoS, is toward removing hyphens after prefixes
19134
19134
            like "re-" etc.
19135
19135
 
19136
19136
Various pages
19137
19137
    Michael Kerrisk
19138
19138
        Global fix: s/multi-/multi/
19139
19139
            The tendency in English, as prescribed in style guides like
19140
 
            Chicago MoS, is towards removing hyphens after prefixes
 
19140
            Chicago MoS, is toward removing hyphens after prefixes
19141
19141
            like "multi-" etc.
19142
19142
 
19143
19143
Various pages
19144
19144
    Michael Kerrisk
19145
19145
        Global fix: s/pre-/pre/
19146
19146
            The tendency in English, as prescribed in style guides like
19147
 
            Chicago MoS, is towards removing hyphens after prefixes
 
19147
            Chicago MoS, is toward removing hyphens after prefixes
19148
19148
            like "pre-" etc.
19149
19149
 
19150
19150
Various pages
19151
19151
    Michael Kerrisk
19152
19152
        Global fix: s/sub-/sub/
19153
19153
            The tendency in English, as prescribed in style guides like
19154
 
            Chicago MoS, is towards removing hyphens after prefixes
 
19154
            Chicago MoS, is toward removing hyphens after prefixes
19155
19155
            like "sub-" etc.
19156
19156
 
19157
19157
stime.2
20043
20043
            by continuing to maintain a separate copy in man-pages.)
20044
20044
 
20045
20045
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219
 
20046
 
 
20047
 
 
20048
==================== Changes in man-pages-3.27 ====================
 
20049
 
 
20050
Released: 2010-09-22, Nuernberg
 
20051
 
 
20052
 
 
20053
Contributors
 
20054
------------
 
20055
 
 
20056
The following people contributed notes, ideas, or patches that have
 
20057
been incorporated in changes in this release:
 
20058
 
 
20059
caishuxian@gmail.com
 
20060
Denis Barbier <bouzim@gmail.com>
 
20061
Denis Silakov <silakov@ispras.ru>
 
20062
der Mouse <mouse@rodents-montreal.org>
 
20063
Jan Kratochvil  <jan.kratochvil@redhat.com>
 
20064
Jim Belton <jim.belton@gmail.com>
 
20065
Jiri Olsa <jolsa@redhat.com>
 
20066
KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
 
20067
Mark Hills <mark@pogo.org.uk>
 
20068
Matthew Flaschen <matthew.flaschen@gatech.edu>
 
20069
Michael Kerrisk <mtk.manpages@gmail.com>
 
20070
Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr>
 
20071
Petr Baudis <pasky@suse.cz>
 
20072
Remi Denis-Courmont <remi@remlab.net>
 
20073
Tanaka Akira <akr@fsij.org>
 
20074
Tim Stoakes <tim@stoakes.net>
 
20075
W. Trevor King <wking@drexel.edu>
 
20076
Yuri Kozlov <yuray@komyakino.ru>
 
20077
 
 
20078
Apologies if I missed anyone!
 
20079
 
 
20080
 
 
20081
New and rewritten pages
 
20082
-----------------------
 
20083
 
 
20084
sigevent.7
 
20085
    Petr Baudis, Michael Kerrisk
 
20086
        New page to centralize description of sigevent structure
 
20087
            Several interfaces use this structure. Best to centralize the
 
20088
            common details in one place. Content taken from the existing
 
20089
            timerfd_create.2 and mq_open.3 pages, with additions by
 
20090
            Petr Baudis and Michael Kerrisk.
 
20091
 
 
20092
 
 
20093
Newly documented interfaces in existing pages
 
20094
---------------------------------------------
 
20095
 
 
20096
ip.7
 
20097
    Jiri Olsa
 
20098
        Document IP_NODEFRAG
 
20099
            This option is new in Linux 2.6.36
 
20100
 
 
20101
unix.7
 
20102
    Michael Kerrisk
 
20103
        Document SIOCINQ ioctl() operation
 
20104
 
 
20105
 
 
20106
Global changes
 
20107
--------------
 
20108
 
 
20109
_exit.2
 
20110
brk.2
 
20111
chdir.2
 
20112
chmod.2
 
20113
chown.2
 
20114
chroot.2
 
20115
clock_nanosleep.2
 
20116
getdtablesize.2
 
20117
gethostname.2
 
20118
getpagesize.2
 
20119
getsid.2
 
20120
killpg.2
 
20121
mknod.2
 
20122
mknodat.2
 
20123
posix_fadvise.2
 
20124
pread.2
 
20125
readlink.2
 
20126
setpgid.2
 
20127
setreuid.2
 
20128
sigaltstack.2
 
20129
stat.2
 
20130
symlink.2
 
20131
sync.2
 
20132
truncate.2
 
20133
vfork.2
 
20134
wait.2
 
20135
wait4.2
 
20136
a64l.3
 
20137
abs.3
 
20138
acos.3
 
20139
acosh.3
 
20140
asin.3
 
20141
asinh.3
 
20142
atan.3
 
20143
atan2.3
 
20144
atanh.3
 
20145
atoi.3
 
20146
cbrt.3
 
20147
ceil.3
 
20148
clock_getcpuclockid.3
 
20149
copysign.3
 
20150
cos.3
 
20151
cosh.3
 
20152
dirfd.3
 
20153
div.3
 
20154
dprintf.3
 
20155
ecvt.3
 
20156
erf.3
 
20157
erfc.3
 
20158
exp.3
 
20159
exp2.3
 
20160
expm1.3
 
20161
fabs.3
 
20162
fdim.3
 
20163
fexecve.3
 
20164
ffs.3
 
20165
floor.3
 
20166
fma.3
 
20167
fmax.3
 
20168
fmemopen.3
 
20169
fmin.3
 
20170
fmod.3
 
20171
fpclassify.3
 
20172
frexp.3
 
20173
fwide.3
 
20174
gamma.3
 
20175
gcvt.3
 
20176
getcwd.3
 
20177
getdate.3
 
20178
getgrent.3
 
20179
gethostid.3
 
20180
getpass.3
 
20181
getpwent.3
 
20182
getsubopt.3
 
20183
getw.3
 
20184
hypot.3
 
20185
ilogb.3
 
20186
insque.3
 
20187
isalpha.3
 
20188
isgreater.3
 
20189
iswblank.3
 
20190
j0.3
 
20191
j0.3
 
20192
ldexp.3
 
20193
lockf.3
 
20194
log.3
 
20195
log10.3
 
20196
log1p.3
 
20197
log2.3
 
20198
logb.3
 
20199
lrint.3
 
20200
lround.3
 
20201
mbsnrtowcs.3
 
20202
mkdtemp.3
 
20203
mkstemp.3
 
20204
mktemp.3
 
20205
modf.3
 
20206
mq_receive.3
 
20207
mq_send.3
 
20208
nan.3
 
20209
nextafter.3
 
20210
posix_fallocate.3
 
20211
posix_memalign.3
 
20212
pow.3
 
20213
printf.3
 
20214
qecvt.3
 
20215
random.3
 
20216
realpath.3
 
20217
remainder.3
 
20218
remquo.3
 
20219
rint.3
 
20220
rint.3
 
20221
round.3
 
20222
scalb.3
 
20223
scalbln.3
 
20224
scanf.3
 
20225
siginterrupt.3
 
20226
signbit.3
 
20227
sigset.3
 
20228
sin.3
 
20229
sinh.3
 
20230
sqrt.3
 
20231
stpcpy.3
 
20232
stpncpy.3
 
20233
strdup.3
 
20234
strdup.3
 
20235
strnlen.3
 
20236
strsignal.3
 
20237
strtod.3
 
20238
strtol.3
 
20239
strtoul.3
 
20240
tan.3
 
20241
tanh.3
 
20242
tgamma.3
 
20243
trunc.3
 
20244
ttyslot.3
 
20245
ualarm.3
 
20246
usleep.3
 
20247
wcpcpy.3
 
20248
wcpncpy.3
 
20249
wcscasecmp.3
 
20250
wcsdup.3
 
20251
wcsncasecmp.3
 
20252
wcsnlen.3
 
20253
wcsnrtombs.3
 
20254
wprintf.3
 
20255
    Michael Kerrisk
 
20256
        Add/fix/update feature test macro requirements in SYNOPSIS
 
20257
            Various changes to:
 
20258
            * Update feature test requirements to note changes in
 
20259
              recent glibc releases
 
20260
            * Correct errors in feature test macro requirements
 
20261
            * Add feature test macro requirements to pages where
 
20262
              the requirements were not previously stated.
 
20263
 
 
20264
accept.2
 
20265
clone.2
 
20266
dup.2
 
20267
fallocate.2
 
20268
pipe.2
 
20269
readahead.2
 
20270
sched_setaffinity.2
 
20271
unshare.2
 
20272
CPU_SET.3
 
20273
endian.3
 
20274
euidaccess.3
 
20275
fexecve.3
 
20276
getpt.3
 
20277
getpw.3
 
20278
getumask.3
 
20279
getutmp.3
 
20280
gnu_get_libc_version.3
 
20281
makedev.3
 
20282
matherr.3
 
20283
mbsnrtowcs.3
 
20284
memfrob.3
 
20285
pthread_attr_setaffinity_np.3
 
20286
pthread_getattr_np.3
 
20287
pthread_setaffinity_np.3
 
20288
pthread_tryjoin_np.3
 
20289
tcgetsid.3
 
20290
wcscasecmp.3
 
20291
wcsncasecmp.3
 
20292
wcsnlen.3
 
20293
wcsnrtombs.3
 
20294
wcswidth.3
 
20295
rtld-audit.7
 
20296
    Michael Kerrisk
 
20297
        SYNOPSIS: Add reference to feature_test_macros(7)
 
20298
            These pages specify feature test macros in the function
 
20299
            prototypes. Add a reference to feature_test_macros(7),
 
20300
            so that readers are pointed to the information that
 
20301
            feature test macros must be defined before including
 
20302
            *any* header file.
 
20303
 
 
20304
clock_nanosleep.2
 
20305
clock_getcpuclockid.3
 
20306
getnetent_r.3
 
20307
getprotoent_r.3
 
20308
getrpcent_r.3
 
20309
getservent_r.3
 
20310
sigwait.3
 
20311
    Michael Kerrisk
 
20312
        RETURN VALUE: Note that "positive error numbers" are listed in ERRORS
 
20313
 
 
20314
fcntl.2
 
20315
intro.2
 
20316
open.2
 
20317
poll.2
 
20318
ftw.3
 
20319
intro.3
 
20320
matherr.3
 
20321
system.3
 
20322
tmpnam.3
 
20323
unix.7
 
20324
    Michael Kerrisk
 
20325
        Note that feature test macros must be defined before *any* includes
 
20326
            Programmers often make the mistake of including a feature test
 
20327
            macro only after having already included some header files.
 
20328
            This patch adds some text at opportune places to remind
 
20329
            programmers to do things the right way.
 
20330
 
 
20331
index.3
 
20332
stpcpy.3
 
20333
strcasecmp.3
 
20334
strcat.3
 
20335
strchr.3
 
20336
strcmp.3
 
20337
strcoll.3
 
20338
strcpy.3
 
20339
strdup.3
 
20340
strfry.3
 
20341
strpbrk.3
 
20342
strsep.3
 
20343
strspn.3
 
20344
strstr.3
 
20345
strtok.3
 
20346
strxfrm.3
 
20347
    Michael Kerrisk
 
20348
        SEE ALSO: Add reference to string(3)
 
20349
            The idea here is to provide a route to discover other
 
20350
            string functions.
 
20351
 
 
20352
armscii-8.7
 
20353
cp1251.7
 
20354
iso_8859-3.7
 
20355
iso_8859-5.7
 
20356
iso_8859-6.7
 
20357
iso_8859-8.7
 
20358
iso_8859-10.7
 
20359
iso_8859-11.7
 
20360
iso_8859-13.7
 
20361
iso_8859-14.7
 
20362
koi8-u.7
 
20363
    Denis Barbier
 
20364
        Fix decimal values in encoding tables
 
20365
            Octal and hexadecimal values are right, but there are some
 
20366
            off-by one errors in decimal values.  Correct values are
 
20367
            printed by this command:
 
20368
 
 
20369
              perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//)
 
20370
                {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7
 
20371
 
 
20372
 
 
20373
Changes to individual pages
 
20374
---------------------------
 
20375
 
 
20376
capget.2
 
20377
    Michael Kerrisk
 
20378
        SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE"
 
20379
 
 
20380
fcntl.2
 
20381
    Michael Kerrisk
 
20382
        Add feature test macro requirements for F_GETOWN and F_SETOWN
 
20383
 
 
20384
fcntl.2
 
20385
    Michael Kerrisk
 
20386
        Note feature test macro requirements for F_DUPFD_CLOEXEC
 
20387
 
 
20388
getrlimit.2
 
20389
    Michael Kerrisk
 
20390
        Document units for RLIMIT_RTTIME limit
 
20391
            This limit is in microseconds
 
20392
 
 
20393
            http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492
 
20394
 
 
20395
lseek.2
 
20396
    Michael Kerrisk
 
20397
        Removed note about return type on ancient systems
 
20398
 
 
20399
mount.2
 
20400
    Michael Kerrisk
 
20401
        Definitions of various MS_* constants only appeared in glibc 2.12
 
20402
            See http://sourceware.org/bugzilla/show_bug.cgi?id=11235
 
20403
 
 
20404
stat.2
 
20405
    Michael Kerrisk
 
20406
        Update information on nanosecond timestamp fields
 
20407
            Update feature test macro requirements for exposing these fields.
 
20408
            Note that these fields are specified in POSIX.1-2008.
 
20409
 
 
20410
timer_create.2
 
20411
    Michael Kerrisk
 
20412
        Factor out generic material that was moved to new sigevent(7) page
 
20413
 
 
20414
aio_fsync.3
 
20415
    Michael Kerrisk
 
20416
        Add reference to new sigevent(7) page
 
20417
 
 
20418
atanh.3
 
20419
    Michael Kerrisk
 
20420
        glibc 2.10 fixed pole error bug
 
20421
            http://sourceware.org/bugzilla/show_bug.cgi?id=6759
 
20422
            was resolved.
 
20423
 
 
20424
cerf.3
 
20425
    Michael Kerrisk
 
20426
        Make it clearer that this function is unimplemented
 
20427
 
 
20428
cos.3
 
20429
    Michael Kerrisk
 
20430
        errno is now correctly set to EDOM on a domain error
 
20431
            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780
 
20432
            was (silently) resolved.
 
20433
 
 
20434
expm1.3
 
20435
    Michael Kerrisk
 
20436
        errno is now correctly set to ERANGE on a range error
 
20437
            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788
 
20438
            was (silently) resolved.
 
20439
 
 
20440
fmod.3
 
20441
    Michael Kerrisk
 
20442
        errno is now correctly set to EDOM for the x==inf domain error
 
20443
            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
 
20444
            was (silently) resolved.
 
20445
 
 
20446
insque.3
 
20447
    Michael Kerrisk
 
20448
        Noted prev == NULL bug in glibc 2.4 and earlier
 
20449
            As noted by Remi Denis-Courmont, glibc nowadays allows
 
20450
            'prev' to be NULL, as required by POSIX for initializing
 
20451
            a linear list. But in glibc 2.4 and earlier, 'prev' could
 
20452
            not be NULL. Add a BUGS section noting this.
 
20453
 
 
20454
            See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201
 
20455
    Michael Kerrisk
 
20456
        Added info on circular lists, and initializing circular lists
 
20457
    Michael Kerrisk
 
20458
        Added example program
 
20459
 
 
20460
lgamma.3
 
20461
    Michael Kerrisk
 
20462
        glibc 2.10 fixed pole error bug
 
20463
            http://sourceware.org/bugzilla/show_bug.cgi?id=6777
 
20464
            was (silently) resolved.
 
20465
 
 
20466
log2.3
 
20467
    Matthew Flaschen
 
20468
        log2() function does not conform to C89
 
20469
            log2(), log2f(), and log2l() do not conform to C89.
 
20470
            They are defined in C99.  See http://flash-gordon.me.uk/ansi.c.txt
 
20471
            and http://www.schweikhardt.net/identifiers.html
 
20472
 
 
20473
mq_notify.3
 
20474
    Michael Kerrisk
 
20475
        Factor out generic material that was moved to new sigevent(7) page
 
20476
 
 
20477
pow.3
 
20478
    Michael Kerrisk
 
20479
        errno is now correctly set to ERANGE on a pole error
 
20480
            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776
 
20481
            was (silently) resolved.
 
20482
 
 
20483
pthread_kill_other_threads_np.3
 
20484
    Michael Kerrisk
 
20485
        CONFORMING TO: Note meaning of "_np" suffix
 
20486
 
 
20487
rand.3
 
20488
    Michael Kerrisk
 
20489
        Clarify description of range of returned value
 
20490
    Michael Kerrisk
 
20491
        Add an example program
 
20492
    Michael Kerrisk
 
20493
        Expand description of rand_r()
 
20494
 
 
20495
random.3
 
20496
    W. Trevor King
 
20497
        Update initstate() return value description to match glibc
 
20498
 
 
20499
readdir.3
 
20500
    Michael Kerrisk
 
20501
        Clarify that "positive error numbers" are listed in ERRORS
 
20502
            Reported-by fkater@googlemail.com
 
20503
 
 
20504
rexec.3
 
20505
    Michael Kerrisk
 
20506
        SYNOPSIS: Add header file and feature test macro requirements
 
20507
 
 
20508
sigpause.3
 
20509
    Michael Kerrisk
 
20510
        Correct discussion of when BSD vs SysV version is used in glibc
 
20511
 
 
20512
sin.3
 
20513
    Michael Kerrisk
 
20514
        errno is now correctly set to EDOM on a domain error
 
20515
            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781
 
20516
            was (silently) resolved.
 
20517
 
 
20518
tan.3
 
20519
    Michael Kerrisk
 
20520
        errno is now correctly set to EDOM on a domain error
 
20521
            http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782
 
20522
            was (silently) resolved.
 
20523
 
 
20524
wcscasecmp.3
 
20525
wcsncasecmp.3
 
20526
wcsnlen.3
 
20527
    Michael Kerrisk
 
20528
        Added VERSIONS section
 
20529
 
 
20530
boot.7
 
20531
    Yuri Kozlov
 
20532
        Update list of major Linux distributions
 
20533
 
 
20534
feature_test_macros.7
 
20535
    Michael Kerrisk
 
20536
        Make text on required placement of macros more prominent
 
20537
            Move the text that notes the requirement that feature test macros
 
20538
            must be defined before including any header files to the top of
 
20539
            the page, and highlight the text further, so that the reader will
 
20540
            not miss this point.
 
20541
 
 
20542
pthreads.7
 
20543
signal.7
 
20544
    Michael Kerrisk
 
20545
        Add SEE ALSO reference to new sigevent(7) page
 
20546
 
 
20547
tcp.7
 
20548
    Michael Kerrisk
 
20549
        Clarify header file details for SIOCINQ and SIOCOUTQ
 
20550
            Also note synonymous FIONREAD and TIOCOUTQ.
 
20551
 
 
20552
 
 
20553
==================== Changes in man-pages-3.28 ====================
 
20554
 
 
20555
Released: 2010-10-04, Munich
 
20556
 
 
20557
 
 
20558
Contributors
 
20559
------------
 
20560
 
 
20561
The following people contributed notes, ideas, or patches that have
 
20562
been incorporated in changes in this release:
 
20563
 
 
20564
Andries E. Brouwer <Andries.Brouwer@cwi.nl>
 
20565
Denis Barbier <bouzim@gmail.com>
 
20566
Jan Kara <jack@suse.cz>
 
20567
Landijk <landijk-user@yahoo.com>
 
20568
Lennart Poettering <mzjro@0pointer.net>
 
20569
Michael Haardt <michael@moria.de>
 
20570
Michael Kerrisk <mtk.manpages@gmail.com>
 
20571
Petr Baudis <pasky@suse.cz>
 
20572
Sam Varshavchik <mrsam@courier-mta.com>
 
20573
 
 
20574
Apologies if I missed anyone!
 
20575
 
 
20576
 
 
20577
New and rewritten pages
 
20578
-----------------------
 
20579
 
 
20580
getaddrinfo_a.3
 
20581
    Petr Baudis
 
20582
        New page documenting getaddrinfo_a()
 
20583
            The page also documents gai_suspend(), gai_cancel(),
 
20584
            and gai_error().
 
20585
 
 
20586
aio.7
 
20587
    Michael Kerrisk
 
20588
        New page providing an overview of POSIX asynchronous I/O
 
20589
 
 
20590
 
 
20591
Newly documented interfaces in existing pages
 
20592
---------------------------------------------
 
20593
 
 
20594
exec.3
 
20595
    Michael Kerrisk
 
20596
        Document execvpe()
 
20597
            This function was added to glibc in version 2.11.
 
20598
            Also various other small rewrites in the page.
 
20599
 
 
20600
 
 
20601
New and changed links
 
20602
---------------------
 
20603
 
 
20604
gai_cancel.3
 
20605
gai_error.3
 
20606
gai_suspend.3
 
20607
    Petr Baudis
 
20608
        New links to new getaddrinfo_a.3 page
 
20609
 
 
20610
error_one_per_line.3
 
20611
    Michael Kerrisk
 
20612
         Fix misnamed link file (was error_on_per_line.3)
 
20613
 
 
20614
execvpe.3
 
20615
    Michael Kerrisk
 
20616
        New link to exec.3
 
20617
 
 
20618
sigstack.3
 
20619
    Michael Kerrisk
 
20620
        New link to sigaltstack.2
 
20621
            No new programs should use sigstack(3). Point the user to the
 
20622
            better sigalstack(2), whose man page briefly mentions sigstack(3).
 
20623
 
 
20624
vlimit.3
 
20625
    Michael Kerrisk
 
20626
        New link to getrlimit.2
 
20627
            No new programs should use vlimit(3). Point the user to the
 
20628
            better setrlimit(2), whose man page briefly mentions vlimit(3).
 
20629
 
 
20630
vtimes.3
 
20631
    Michael Kerrisk
 
20632
        New link to getrusage.2
 
20633
            No new programs should use vtimes(3). Point the user to the
 
20634
            better getrusage(2), whose man page briefly mentions vtimes(3).
 
20635
 
 
20636
 
 
20637
Global changes
 
20638
--------------
 
20639
 
 
20640
Various pages
 
20641
    Michael Kerrisk
 
20642
        Switch to American usage: "-wards" ==> "-ward"
 
20643
            American English uses "afterward" in preference to "afterwards",
 
20644
            and so on
 
20645
 
 
20646
chdir.2
 
20647
chmod.2
 
20648
chown.2
 
20649
gethostname.2
 
20650
getsid.2
 
20651
pread.2
 
20652
setpgid.2
 
20653
sigaltstack.2
 
20654
stat.2
 
20655
truncate.2
 
20656
wait.2
 
20657
dirfd.3
 
20658
getsubopt.3
 
20659
mkdtemp.3
 
20660
mkstemp.3
 
20661
siginterrupt.3
 
20662
strdup.3
 
20663
    Michael Kerrisk
 
20664
        Simplify feature test macro requirements
 
20665
 
 
20666
 
 
20667
Changes to individual pages
 
20668
---------------------------
 
20669
 
 
20670
getrlimit.2
 
20671
    Michael Kerrisk
 
20672
        Add mention of the ancient vlimit() function
 
20673
 
 
20674
getrusage.2
 
20675
    Michael Kerrisk
 
20676
        Add mention of the ancient vtimes() function
 
20677
 
 
20678
io_cancel.2
 
20679
io_destroy.2
 
20680
io_getevents.2
 
20681
io_setup.2
 
20682
io_submit.2
 
20683
    Michael Kerrisk
 
20684
        SEE ALSO: add aio(7)
 
20685
 
 
20686
sched_setscheduler.2
 
20687
    Michael Kerrisk
 
20688
        ERRORS: note that NULL 'param' yields EINVAL
 
20689
 
 
20690
stat.2
 
20691
    Michael Kerrisk
 
20692
        Note feature test macro requirements for blkcnt_t and blksize_t
 
20693
 
 
20694
timer_create.2
 
20695
    Michael Kerrisk
 
20696
        Standardize on name 'sevp' for sigevent argument
 
20697
 
 
20698
truncate.2
 
20699
    Michael Kerrisk
 
20700
        Correct and simplify ftruncate() feature test macro requirements
 
20701
            The glibc 2.12 feature test macro requirements for ftruncate() are
 
20702
            buggy; see http://sourceware.org/bugzilla/show_bug.cgi?id=12037.
 
20703
            Corrected the requirements in the SYNOPSIS, and added a BUGS
 
20704
            section describing the problem in glibc 2.12.
 
20705
 
 
20706
aio_cancel.3
 
20707
    Michael Kerrisk
 
20708
        Add pointer to aio(7) for example program
 
20709
        Refer the reader to aio(7) for a description of the aiocb structure
 
20710
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20711
 
 
20712
aio_error.3
 
20713
    Michael Kerrisk
 
20714
        Wording improvements in RETURN VALUE
 
20715
        Add pointer to aio(7) for example program
 
20716
        Refer the reader to aio(7) for a description of the aiocb structure
 
20717
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20718
 
 
20719
aio_fsync.3
 
20720
    Michael Kerrisk
 
20721
        Refer the reader to aio(7) for a description of the aiocb structure
 
20722
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20723
 
 
20724
aio_read.3
 
20725
    Michael Kerrisk
 
20726
        Various minor rewordings and additions
 
20727
        Add pointer to sigevent(7) for details of notification of I/O completion
 
20728
        Add pointer to aio(7) for example program
 
20729
        Refer the reader to aio(7) for a description of the aiocb structure
 
20730
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20731
 
 
20732
aio_return.3
 
20733
    Michael Kerrisk
 
20734
        Improve description in RETURN VALUE
 
20735
        Add pointer to aio(7) for example program
 
20736
        Refer the reader to aio(7) for a description of the aiocb structure
 
20737
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20738
 
 
20739
aio_suspend.3
 
20740
    Michael Kerrisk
 
20741
        Various additions and rewordings.
 
20742
            Give some arguments more meaningful names.
 
20743
            More explicitly describe the 'nitems' argument.
 
20744
            Explicitly note that return is immediate if an I/O operation
 
20745
            has already completed.
 
20746
            Note that aio_error(3) should be used to scan the aiocb list
 
20747
            after a successful return.
 
20748
            Add references to other relevant pages.
 
20749
            Various other pieces rewritten.
 
20750
        Refer the reader to aio(7) for a description of the aiocb structure
 
20751
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20752
 
 
20753
aio_write.3
 
20754
    Michael Kerrisk
 
20755
        Add pointer to sigevent(7) for details of notification of I/O completion
 
20756
        Various minor rewordings and additions
 
20757
        Refer the reader to aio(7) for a description of the aiocb structure
 
20758
        CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
 
20759
 
 
20760
clearenv.3
 
20761
    Michael Kerrisk
 
20762
        Fix error in feature test macro requirements
 
20763
 
 
20764
dysize.3
 
20765
    Michael Kerrisk
 
20766
        Remove crufty statement about old SCO bug
 
20767
 
 
20768
exec.3
 
20769
    Michael Kerrisk
 
20770
        Add feature test macro requirements for execvpe()
 
20771
        Rewrite description of PATH and mention _CS_PATH
 
20772
        Note execvp() and execlp() behavior for filename containing a slash
 
20773
 
 
20774
getaddrinfo.3
 
20775
    Michael Kerrisk
 
20776
        Add SEE ALSO reference to new getaddrinfo_a.3 page
 
20777
 
 
20778
gethostbyname.3
 
20779
    Michael Kerrisk
 
20780
        Fix formatting of feature test macros
 
20781
 
 
20782
getw.3
 
20783
    Michael Kerrisk
 
20784
        Fix feature test macros
 
20785
 
 
20786
malloc.3
 
20787
    Landijk
 
20788
        Remove editorializing comments on memory overcommitting
 
20789
            See https://bugzilla.kernel.org/show_bug.cgi?id=19332
 
20790
    Michael Kerrisk
 
20791
        Various minor reorganizations and wording fix-ups
 
20792
 
 
20793
mq_notify.3
 
20794
    Michael Kerrisk
 
20795
        Standardize on name 'sevp' for sigevent argument
 
20796
 
 
20797
nl_langinfo.3
 
20798
    Michael Haardt
 
20799
        Make it clear that nl_langinfo() interacts with setlocale()
 
20800
        Add an example program
 
20801
 
 
20802
posix_openpt.3
 
20803
    Michael Kerrisk
 
20804
        Fix feature test macro requirements
 
20805
 
 
20806
rand.3
 
20807
    Michael Kerrisk
 
20808
        Remove duplicate #include in example program
 
20809
 
 
20810
strtok.3
 
20811
    Petr Baudis
 
20812
        Add reference to strtok() example in getaddrinfo(3)
 
20813
 
 
20814
inotify.7
 
20815
    Michael Kerrisk
 
20816
        Added section noting limitations and caveats of inotify
 
20817
 
 
20818
sigevent.7
 
20819
    Michael Kerrisk
 
20820
        Add SEE ALSO reference to new getaddrinfo_a.3 page
 
20821
        Add SEE ALSO referring to new aio(7) page
 
20822
 
 
20823
suffixes.7
 
20824
    Michael Kerrisk
 
20825
        Change explanation of ".rpm" to "RPM software package"
 
20826
 
 
20827
 
 
20828
==================== Changes in man-pages-3.29 ====================
 
20829
 
 
20830
Released: 2010-10-19, Detroit
 
20831
 
 
20832
 
 
20833
Contributors
 
20834
------------
 
20835
 
 
20836
The following people contributed notes, ideas, or patches that have
 
20837
been incorporated in changes in this release:
 
20838
 
 
20839
Balazs Scheidler <bazsi@balabit.hu>
 
20840
David Prevot <davidp@altern.org>
 
20841
Denis Barbier <bouzim@gmail.com>
 
20842
Guillem Jover <guillem@hadrons.org>
 
20843
Ivana Varekova <varekova@redhat.com>
 
20844
Lennart Poettering <mzxreary@0pointer.de>
 
20845
Michael Kerrisk <mtk.manpages@gmail.com>
 
20846
Sam Varshavchik <mrsam@courier-mta.com>
 
20847
Simon Paillard <simon.paillard@resel.enst-bretagne.fr>
 
20848
Stephan Mueller <stephan.mueller@atsec.com>
 
20849
Thomas Jarosch <thomas.jarosch@intra2net.com>
 
20850
Yuri Kozlov <yuray@komyakino.ru>
 
20851
 
 
20852
Apologies if I missed anyone!
 
20853
 
 
20854
 
 
20855
New and rewritten pages
 
20856
-----------------------
 
20857
 
 
20858
subpage_prot.2
 
20859
    Michael Kerrisk
 
20860
        New page documenting the PowerPC-specific subpage_prot(2)
 
20861
 
 
20862
aio_init.3
 
20863
    Michael Kerrisk
 
20864
        New page documenting aio_init(3)
 
20865
 
 
20866
 
 
20867
Newly documented interfaces in existing pages
 
20868
---------------------------------------------
 
20869
 
 
20870
posix_fadvise.2
 
20871
    Michael Kerrisk
 
20872
        Document the architecture-specific arm_fadvise64_64() system call
 
20873
            This ARM-specific system call fixes the argument ordering
 
20874
            for that architecture. Since Linux 2.6.14.
 
20875
 
 
20876
sync_file_range.2
 
20877
    Michael Kerrisk
 
20878
        Document the architecture-specific sync_file_range2() system call
 
20879
            As described in commit edd5cd4a9424f22b0fa08bef5e299d41befd5622,
 
20880
            the sync_file_range() argument order is broken for some
 
20881
            architectures (PowerPC, ARM, tile). The remedy was a different
 
20882
            system call using the right argument order on those architectures.
 
20883
 
 
20884
psignal.3
 
20885
    Guillem Jover
 
20886
        Document psiginfo()
 
20887
            psiginfo() was added to glibc in version 2.10.
 
20888
    Michael Kerrisk
 
20889
        Add details, VERSIONS, and BUGS for psiginfo()
 
20890
 
 
20891
ip.7
 
20892
    Balazs Scheidler
 
20893
        Document IP_RECVORIGDSTADDR
 
20894
        Document IP_TRANSPARENT
 
20895
    Michael Kerrisk
 
20896
        Document IP_FREEBIND
 
20897
            Text based on input from Lennart Poettering and Balazs Scheidler.
 
20898
            See https://bugzilla.kernel.org/show_bug.cgi?id=20082
 
20899
 
 
20900
 
 
20901
New and changed links
 
20902
---------------------
 
20903
 
 
20904
arm_fadvise64_64.2
 
20905
    Michael Kerrisk
 
20906
        New link to posix_fadvise.2
 
20907
 
 
20908
arm_sync_file_range.2, sync_file_range2.2
 
20909
    Michael Kerrisk
 
20910
        New links to sync_file_range.2
 
20911
 
 
20912
arrm_fadvise.2
 
20913
    Michael Kerrisk
 
20914
        New link to posix_fadvise.2
 
20915
 
 
20916
psiginfo.3
 
20917
    Guillem Jover
 
20918
        New link to psignal.3
 
20919
 
 
20920
 
 
20921
Global changes
 
20922
--------------
 
20923
 
 
20924
Many pages
 
20925
    Michael Kerrisk
 
20926
        global fix: s/Unix/UNIX/
 
20927
            The man pages were rather inconsistent in the use of "Unix"
 
20928
            versus "UNIX". Let's go with the trademark usage.
 
20929
 
 
20930
Various pages
 
20931
    Michael Kerrisk
 
20932
        Global fix: s/pseudo-terminal/pseudoterminal/
 
20933
 
 
20934
grantpt.3, ptsname.3, unlockpt.3, pts.4
 
20935
    Michael Kerrisk
 
20936
        Global fix: s/pty/pseudoterminal/
 
20937
 
 
20938
recv.2, cmsg.3, unix.7
 
20939
    Michael Kerrisk
 
20940
        global fix: s/UNIX socket/UNIX domain socket/
 
20941
 
 
20942
fmtmsg.3, gethostbyname.3, termios.3
 
20943
    Michael Kerrisk
 
20944
        Global fix: s/Unixware/UnixWare/
 
20945
 
 
20946
 
 
20947
Changes to individual pages
 
20948
---------------------------
 
20949
 
 
20950
inotify_rm_watch.2
 
20951
    Michael Kerrisk
 
20952
        SYNOPSIS: fix type of 'wd' argument
 
20953
 
 
20954
posix_fadvise.2
 
20955
    Michael Kerrisk
 
20956
        Rewrite VERSIONS, noting that the system call is fadvise64()
 
20957
 
 
20958
syscalls.2
 
20959
    Michael Kerrisk
 
20960
        Add the PowerPC-specific subpage_prot() system call
 
20961
        Add sync_file_range2()
 
20962
 
 
20963
truncate.2
 
20964
    Michael Kerrisk
 
20965
        Fix feature test macros
 
20966
 
 
20967
aio_cancel.3
 
20968
aio_error.3
 
20969
aio_fsync.3
 
20970
aio_read.3
 
20971
aio_return.3
 
20972
aio_suspend.3
 
20973
aio_write.3
 
20974
    Michael Kerrisk
 
20975
        SEE ALSO: Add lio_listio(3)
 
20976
 
 
20977
gai_cancel.3
 
20978
gai_error.3
 
20979
gai_suspend.3
 
20980
    Michael Kerrisk
 
20981
        Make these into links
 
20982
            In the previous release, these files were accidentally made copies
 
20983
            of getaddrinfo_a.3, instead of being made as link files.
 
20984
 
 
20985
getifaddrs.3
 
20986
    Thomas Jarosch
 
20987
        Prevent possible NULL pointer access in example program
 
20988
 
 
20989
malloc.3
 
20990
    Michael Kerrisk
 
20991
        Emphasize that malloc() and realloc() do not initialize allocated memory
 
20992
 
 
20993
malloc_hook.3
 
20994
    Ivana Varekova
 
20995
        Warn that these functions are deprecated
 
20996
 
 
20997
strcpy.3
 
20998
    Michael Kerrisk
 
20999
        Formatting fixes in strncpy() example implementation code
 
21000
 
 
21001
ip.7
 
21002
    Michael Kerrisk
 
21003
        Reword NOTES on Linux-specific options
 
21004
 
 
21005
sigevent.7
 
21006
    Michael Kerrisk
 
21007
        SEE ALSO: Add aio_read(3), aio_write(3), and lio_listio(3)
 
21008
 
 
21009
unix.7
 
21010
    Michael Kerrisk
 
21011
        Document the autobind feature
 
21012
    Michael Kerrisk
 
21013
        Fix description of abstract socket names
 
21014
            As reported by Lennart Poettering:
 
21015
                The part about "abstract" sockets is misleading as it suggests
 
21016
                that the sockaddr returned by getsockname() would necessarily
 
21017
                have the size of sizeof(struct sockaddr), which however is not
 
21018
                the case: getsockname() returns exactly the sockaddr size that
 
21019
                was passed in on bind(). In particular, two sockets that are
 
21020
                bound to the same sockaddr but different sizes are completely
 
21021
                independent.
 
21022
            See https://bugzilla.kernel.org/show_bug.cgi?id=19812
 
21023
    Michael Kerrisk
 
21024
        Fix description of "pathname" sockets
 
21025
            As reported by Lennart Poettering:
 
21026
               The part about "pathname" sockets suggests usage of
 
21027
               sizeof(sa_family_t) + strlen(sun_path) + 1
 
21028
               for calculating the sockaddr size. Due to alignment/padding
 
21029
               this is probably not a good idea. Instead, one should use
 
21030
               offsetof(struct sockaddr_un, sun_path) + strlen() + 1
 
21031
               or something like that.
 
21032
            See https://bugzilla.kernel.org/show_bug.cgi?id=19812
 
21033
 
 
21034
 
 
21035
==================== Changes in man-pages-3.30 ====================
 
21036
 
 
21037
Released: 2010-11-01, Munich
 
21038
 
 
21039
 
 
21040
Contributors
 
21041
------------
 
21042
 
 
21043
The following people contributed notes, ideas, or patches that have
 
21044
been incorporated in changes in this release:
 
21045
 
 
21046
Andi Kleen <andi@firstfloor.org>
 
21047
Bernhard Walle <bernhard@bwalle.de>
 
21048
David Prevot <davidp@altern.org>
 
21049
Eric W. Biederman <ebiederm@xmission.com>
 
21050
Florian Lehmann <flo.lehmann@googlemail.com>
 
21051
Jan Engelhardt <jengelh@medozas.de>
 
21052
Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
 
21053
Michael Kerrisk <mtk.manpages@gmail.com>
 
21054
Paul Mackerras <paulus@samba.org>
 
21055
Pádraig Brady <P@draigbrady.com>
 
21056
Reuben Thomas <rrt@sc3d.org>
 
21057
scarlettsp <scarlettsp@gmail.com>
 
21058
Yuri Kozlov <yuray@komyakino.ru>
 
21059
 
 
21060
Apologies if I missed anyone!
 
21061
 
 
21062
 
 
21063
New and rewritten pages
 
21064
-----------------------
 
21065
 
 
21066
kexec_load.2
 
21067
    Andi Kleen
 
21068
        New page documenting kexec_load(2)
 
21069
    Michael Kerrisk
 
21070
        Add license
 
21071
    Michael Kerrisk
 
21072
        Incorporate fixes from Eric W. Biederman
 
21073
            Eric noted that a few instances of "virtual" should
 
21074
            be "physical" and noted:
 
21075
 
 
21076
                There is an expectation that at hand off from sys_kexec that
 
21077
                virtual and physical addresses will be identity mapped. But
 
21078
                this isn't the old Alpha booting convention where you have
 
21079
                a virtual address and then you have to parse the page table
 
21080
                to figure out where your kernel was actually loaded.
 
21081
    Michael Kerrisk
 
21082
        Additions and edits by mtk
 
21083
            Various wording and layout improvements.
 
21084
            Fixed the name of a constant: s/KEXEC_ARCH_I386/KEXEC_ARCH_386/.
 
21085
            Added RETURN VALUE and ERRORS sections.
 
21086
            Added VERSIONS section
 
21087
            Note that CONFIG_KEXEC is needed
 
21088
            Removed details of using syscall; the reader can find them in
 
21089
            syscall(2).
 
21090
            Added some details for KEXEC_PRESERVE_CONTEXT.
 
21091
            Revised the text mentioning the kernel header, since it is
 
21092
            not yet exported, and it's not certain that it will be.
 
21093
 
 
21094
lio_listio.3
 
21095
    Michael Kerrisk
 
21096
        New page documenting lio_listio(3)
 
21097
 
 
21098
 
 
21099
Newly documented interfaces in existing pages
 
21100
---------------------------------------------
 
21101
 
 
21102
reboot.2
 
21103
    Andi Kleen
 
21104
        Document LINUX_REBOOT_KEXEC
 
21105
            Some fix-ups by Michael Kerrisk
 
21106
    Michael Kerrisk
 
21107
        Place 'cmd' values in alphabetical order.
 
21108
 
 
21109
unshare.2
 
21110
    Michael Kerrisk
 
21111
        Document CLONE_NEWIPC
 
21112
    Michael Kerrisk
 
21113
        Document CLONE_NEWNET
 
21114
    Lucian Adrian Grijincu
 
21115
        Improve description of CLONE_NEWNET
 
21116
            CLONE_NEWNET creates a new network namespace from scratch.
 
21117
            You don't have anything from the old network namespace in
 
21118
            the new one. Even the loopback device is new.
 
21119
    Michael Kerrisk
 
21120
        Document CLONE_SYSVSEM
 
21121
    Michael Kerrisk
 
21122
        Document CLONE_NEWUTS
 
21123
    Michael Kerrisk
 
21124
        Relocate discussion of CAP_SYS_ADMIN to CLONE_NEWNS section
 
21125
            And rewrite the EPERM description to be more general in
 
21126
            preparation for the new flags to be documented.
 
21127
 
 
21128
 
 
21129
Global changes
 
21130
--------------
 
21131
 
 
21132
Various pages
 
21133
    Michael Kerrisk
 
21134
        Add reference to feature_test_macros(7)
 
21135
            Some pages simply list feature test macro requirements in
 
21136
            the form:
 
21137
 
 
21138
                #define #GNU_SOURCE
 
21139
                #include <someheader.h>
 
21140
 
 
21141
            For these pages, add a "See feature_test_macros(7)" comment
 
21142
            on the "#define" line.
 
21143
 
 
21144
Various pages
 
21145
    Michael Kerrisk
 
21146
        SEE ALSO: Remove redundant reference to feature_test_macros(7)
 
21147
 
 
21148
Various pages
 
21149
    David Prevot
 
21150
        Use greater consistency in NAME line
 
21151
        (Remove definite article at start of descriptive clause.)
 
21152
 
 
21153
Various pages
 
21154
    Michael Kerrisk
 
21155
        SEE ALSO: Place entries in correct order
 
21156
 
 
21157
Various pages
 
21158
    Michael Kerrisk
 
21159
        ERRORS: Place entries in correct order
 
21160
 
 
21161
Various pages
 
21162
    Michael Kerrisk
 
21163
        Add section number to references to functions documented in other pages
 
21164
 
 
21165
Various pages
 
21166
    Michael Kerrisk
 
21167
        Remove redundant section number in page references
 
21168
            Remove section number in function references that are for
 
21169
            functions documented on this page.
 
21170
 
 
21171
armscii-8.7
 
21172
iso_8859-3.7
 
21173
iso_8859-4.7
 
21174
iso_8859-5.7
 
21175
iso_8859-6.7
 
21176
iso_8859-10.7
 
21177
iso_8859-11.7
 
21178
iso_8859-13.7
 
21179
iso_8859-14.7
 
21180
koi8-u.7
 
21181
    David Prevot
 
21182
        Capitalize hexadecimal numbers
 
21183
 
 
21184
 
 
21185
Changes to individual pages
 
21186
---------------------------
 
21187
 
 
21188
access.2
 
21189
    Michael Kerrisk
 
21190
        Note use of faccessat(2) for checking symbolic link permissions
 
21191
    Michael Kerrisk
 
21192
        Give an example of a safer alternative to using access()
 
21193
 
 
21194
clone.2
 
21195
    Michael Kerrisk
 
21196
        Clarify when CLONE_NEWNET implementation was completed
 
21197
 
 
21198
faccessat.2
 
21199
    Michael Kerrisk
 
21200
        Note that faccessat() is racy
 
21201
 
 
21202
fcntl.2
 
21203
    Michael Kerrisk
 
21204
        RETURN VALUE: Improve description of F_GETFD and F_GETFL
 
21205
 
 
21206
inotify_add_watch.2
 
21207
    Michael Kerrisk
 
21208
        Document ENOENT error
 
21209
 
 
21210
mlock.2
 
21211
    Michael Kerrisk
 
21212
        Improve wording describing /proc/PID/status /VmLck field
 
21213
    Michael Kerrisk
 
21214
        shmctl() SHM_LOCKed memory is not included in VmLck
 
21215
 
 
21216
reboot.2
 
21217
    Michael Kerrisk
 
21218
        Place 'cmd' values in alphabetical order
 
21219
 
 
21220
subpage_prot.2
 
21221
    Michael Kerrisk
 
21222
        Change 1-line page description
 
21223
    Michael Kerrisk
 
21224
        Improvements after review by Paul Mackerras
 
21225
 
 
21226
timer_settime.3
 
21227
    Michael Kerrisk
 
21228
        Remove redundant SEE ALSO reference
 
21229
 
 
21230
euidaccess.3
 
21231
    Michael Kerrisk
 
21232
        Note the use of faccessat(2) to operate on symbolic links
 
21233
    Michael Kerrisk
 
21234
        Note that the use of euidaccess() is racy
 
21235
 
 
21236
fenv.3
 
21237
    Michael Kerrisk
 
21238
        Clarify wording relating to glibc version
 
21239
 
 
21240
getgrent.3
 
21241
getgrent_r.3
 
21242
getgrnam.3
 
21243
    Michael Kerrisk
 
21244
        Refer reader for group(5) for more info on group structure
 
21245
 
 
21246
getopt.3
 
21247
    Bernhard Walle
 
21248
        Use constants in getopt_long() example
 
21249
            The description of getopt_long() mentions the constants
 
21250
            required_argument, no_argument and optional_argument.
 
21251
            Use them in the example to make the code easier to understand.
 
21252
 
 
21253
getpw.3
 
21254
    Michael Kerrisk
 
21255
        Change comment describing pw_gecos
 
21256
 
 
21257
getpw.3
 
21258
getpwent.3
 
21259
getpwent_r.3
 
21260
    Michael Kerrisk
 
21261
        Refer reader to passwd(5) for more info on the passwd structure
 
21262
 
 
21263
getpwent.3
 
21264
getpwnam.3
 
21265
    Michael Kerrisk
 
21266
        Note that pw_gecos is not in POSIX
 
21267
            And change the comment describing this field
 
21268
 
 
21269
getpwent_r.3
 
21270
    Michael Kerrisk
 
21271
        Change comment describing pw_gecos
 
21272
 
 
21273
getpwnam.3
 
21274
    Michael Kerrisk
 
21275
        Some rewording and restructuring
 
21276
 
 
21277
sched_getcpu.3
 
21278
    Michael Kerrisk
 
21279
        Fix feature test macro requirements
 
21280
 
 
21281
strnlen.3
 
21282
    Michael Kerrisk
 
21283
        Fix feature test macro requirements
 
21284
 
 
21285
group.5
 
21286
    Michael Kerrisk
 
21287
        Various minor rewordings
 
21288
 
 
21289
hosts.5
 
21290
protocols.5
 
21291
spufs.7
 
21292
termio.7
 
21293
    David Prevot
 
21294
        Remove definite article from NAME section
 
21295
            Please find inline another tiny patch in order to shrink
 
21296
            the definite article from some other pages (found with
 
21297
            "rgrep -i ' \\\- the' man*").
 
21298
 
 
21299
passwd.5
 
21300
    Michael Kerrisk
 
21301
        Various minor rewordings
 
21302
 
 
21303
proc.5
 
21304
    Michael Kerrisk
 
21305
        Add reference to mlock(2) for further info on /proc/PID/status VmLck
 
21306
 
 
21307
armscii-8.7
 
21308
    David Prevot
 
21309
        Write the character set name as ArmSCII
 
21310
 
 
21311
cp1251.7
 
21312
    David Prevot
 
21313
        Capitalize hexadecimal numbers
 
21314
 
 
21315
ip.7
 
21316
    David Prevot
 
21317
        Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/
 
21318
    David Prevot
 
21319
        Place socket options in alphabetical order
 
21320
 
 
21321
koi8-r.7
 
21322
    David Prevot
 
21323
        Fix special character names
 
21324
            Comparing to koi8-u.7, I noticed some inconsistencies in special
 
21325
            character names. After checking with the following Unicode related
 
21326
            pages, please find inline (and gzipped attached, hopefully not
 
21327
            messing with encoding), a patch in order to make it right, on an
 
21328
            Unicode point of view.
 
21329
 
 
21330
            http://www.unicode.org/charts/PDF/U2500.pdf
 
21331
            http://www.unicode.org/charts/PDF/U25A0.pdf
 
21332
            http://www.unicode.org/charts/PDF/U0080.pdf
 
21333
            http://www.unicode.org/charts/PDF/U1D400.pdf
 
21334
    David Prevot
 
21335
        Fix SEE ALSO reference and letter names
 
21336
            The koi8-r(7) (Russian Net Character Set) manual page refers
 
21337
            to iso-8859-7(7) manual page, which is the Latin/Greek one.
 
21338
            I guess it should refer instead to the iso-8859-5(7)
 
21339
            (Latin/Cyrillic) one. This is addressed at the end of the patch.
 
21340
 
 
21341
            It has also been spotted that letter names are different in
 
21342
            this manual page and in the Unicode related page [0], the
 
21343
            first part of the page address this.
 
21344
 
 
21345
                    0: http://www.unicode.org/charts/PDF/U0400.pdf
 
21346
 
 
21347
man-pages.7
 
21348
    Michael Kerrisk
 
21349
        Update example
 
21350
            The old example used the chmod(2) man page, but the
 
21351
            feature test macro requirements on that page had changed.
 
21352
            Update to use an example from a different page (acct(2),
 
21353
            whose feature test macro requirements are probably unlikely
 
21354
            to change in the future).
 
21355
 
 
21356
 
 
21357
==================== Changes in man-pages-3.31 ====================
 
21358
 
 
21359
Released: 2010-11-12, Munich
 
21360
 
 
21361
 
 
21362
Contributors
 
21363
------------
 
21364
 
 
21365
The following people contributed notes, ideas, or patches that have
 
21366
been incorporated in changes in this release:
 
21367
 
 
21368
Andi Kleen <andi@firstfloor.org>
 
21369
David Prevot <davidp@altern.org>
 
21370
Denis Barbier <bouzim@gmail.com>
 
21371
Krzysztof Żelechowski <giecrilj@stegny.2a.pl>
 
21372
Michael Kerrisk <mtk.manpages@gmail.com>
 
21373
Yuri Kozlov <yuray@komyakino.ru>
 
21374
 
 
21375
Apologies if I missed anyone!
 
21376
 
 
21377
 
 
21378
Newly documented interfaces in existing pages
 
21379
---------------------------------------------
 
21380
 
 
21381
getrlimit.2
 
21382
    Michael Kerrisk
 
21383
        Added documentation of prlimit()
 
21384
            prlimit() is new in kernel 2.6.36.
 
21385
 
 
21386
inotify.7
 
21387
    Michael Kerrisk
 
21388
        Document IN_EXCL_UNLINK
 
21389
            This flag was added in Linux 2.6.36.
 
21390
            See kernel commit 8c1934c8d70b22ca8333b216aec6c7d09fdbd6a6.
 
21391
 
 
21392
 
 
21393
New and changed links
 
21394
---------------------
 
21395
 
 
21396
prlimit.2
 
21397
    Michael Kerrisk
 
21398
        New link to getrlimit.2
 
21399
 
 
21400
 
 
21401
Changes to individual pages
 
21402
---------------------------
 
21403
 
 
21404
getrlimit.2
 
21405
    Michael Kerrisk
 
21406
        Remove unneeded text in DESCRIPTION
 
21407
 
 
21408
intro.2
 
21409
    Michael Kerrisk
 
21410
        Added various pages to SEE ALSO
 
21411
 
 
21412
kexec_load.2
 
21413
    Michael Kerrisk
 
21414
        Add kernel version where KEXEC_PRESERVE_CONTEXT first appeared
 
21415
        Added kernel version number where KEXEC_ON_CRASH first appeared
 
21416
        Fix copyright
 
21417
            Make copyright in the name of Intel corporation
 
21418
        VERSIONS: Fix version number
 
21419
            kexec_load() was first implemented in 2.6.13, though the entry
 
21420
            in the system call table was reserved starting in 2.6.7.
 
21421
 
 
21422
migrate_pages.2
 
21423
    Michael Kerrisk
 
21424
        SEE ALSO: Add reference to Documentation/vm/page_migration
 
21425
 
 
21426
sched_setaffinity.2
 
21427
    Michael Kerrisk
 
21428
        Add missing word "real" to "user ID"
 
21429
 
 
21430
syscalls.2
 
21431
    Michael Kerrisk
 
21432
        Fix kernel version number for kexec_load
 
21433
            kexec_load() was first implemented in 2.6.13, though the entry
 
21434
            in the system call table was reserved starting in 2.6.7.
 
21435
    Michael Kerrisk
 
21436
        Add prlimit() to list
 
21437
 
 
21438
intro.3
 
21439
    Michael Kerrisk
 
21440
        Added various pages to SEE ALSO
 
21441
 
 
21442
printf.3
 
21443
    Michael Kerrisk
 
21444
        Formatting fixes in example code
 
21445
 
 
21446
hostname.7
 
21447
    Michael Kerrisk
 
21448
        Small improvement to description of domains
 
21449
            See: https://bugzilla.novell.com/show_bug.cgi?id=651900