Changes

   1 ==================== Changes in man-pages-3.30 ====================
   2
   3 Released: 2010-11-01, Munich
   4
   5
   6 Contributors
   7 ------------
   8
   9 The following people contributed notes, ideas, or patches that have
  10 been incorporated in changes in this release:
  11
  12 Andi Kleen <andi@firstfloor.org>
  13 Bernhard Walle <bernhard@bwalle.de>
  14 David Prevot <davidp@altern.org>
  15 Eric W. Biederman <ebiederm@xmission.com>
  16 Florian Lehmann <flo.lehmann@googlemail.com>
  17 Jan Engelhardt <jengelh@medozas.de>
  18 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
  19 Michael Kerrisk <mtk.manpages@gmail.com>
  20 Paul Mackerras <paulus@samba.org>
  21 Pádraig Brady <P@draigbrady.com>
  22 Reuben Thomas <rrt@sc3d.org>
  23 scarlettsp <scarlettsp@gmail.com>
  24 Yuri Kozlov <yuray@komyakino.ru>
  25
  26 Apologies if I missed anyone!
  27
  28
  29 New and rewritten pages
  30 -----------------------
  31
  32 lio_listio.3
  33     Michael Kerrisk
  34         New page documenting lio_listio(3)
  35
  36 kexec_load.2
  37     Andi Kleen
  38         New page documenting kexec_load(2)
  39     Michael Kerrisk
  40         Add license
  41     Michael Kerrisk
  42         Incorporate fixes from Eric W. Biederman
  43             Eric noted that a few instances of "virtual" should
  44             be "physical" and noted:
  45
  46                 There is an expectation that at hand off from sys_kexec that
  47                 virtual and physical addresses will be identity mapped. But
  48                 this isn't the old Alpha booting convention where you have
  49                 a virtual address and then you have to parse the page table
  50                 to figure out where your kernel was actually loaded.
  51     Michael Kerrisk
  52         Additions and edits by mtk
  53             Various wording and layout improvements.
  54             Fixed the name of a constant: s/KEXEC_ARCH_I386/KEXEC_ARCH_386/.
  55             Added RETURN VALUE and ERRORS sections.
  56             Added VERSIONS section
  57             Note that CONFIG_KEXEC is needed
  58             Removed details of using syscall; the reader can find them in
  59             syscall(2).
  60             Added some details for KEXEC_PRESERVE_CONTEXT.
  61             Revised the text mentioning the kernel header, since it is
  62             not yet exported, and it's not certain that it will be.
  63
  64
  65 Newly documented interfaces in existing pages
  66 ---------------------------------------------
  67
  68 reboot.2
  69     Andi Kleen
  70         Document LINUX_REBOOT_KEXEC
  71             Some fix-ups by Michael Kerrisk
  72     Michael Kerrisk
  73         Place 'cmd' values in alphabetical order.
  74
  75 unshare.2
  76     Michael Kerrisk
  77         Document CLONE_NEWIPC
  78     Michael Kerrisk
  79         Document CLONE_NEWNET
  80     Lucian Adrian Grijincu
  81         Improve description of CLONE_NEWNET
  82             CLONE_NEWNET creates a new network namespace from scratch.
  83             You don't have anything from the old network namespace in
  84             the new one. Even the loopback device is new.
  85     Michael Kerrisk
  86         Document CLONE_SYSVSEM
  87     Michael Kerrisk
  88         Document CLONE_NEWUTS
  89     Michael Kerrisk
  90         Relocate discussion of CAP_SYS_ADMIN to CLONE_NEWNS section
  91             And rewrite the EPERM description to be more general in
  92             preparation for the new flags to be documented.
  93
  94
  95 Global changes
  96 --------------
  97
  98 Various pages
  99     Michael Kerrisk
 100         Add reference to feature_test_macros(7)
 101             Some pages simply list feature test macro requirements in
 102             the form:
 103
 104                 #define #GNU_SOURCE
 105                 #include <someheader.h>
 106
 107             For these pages, add a "See feature_test_macros(7)" comment
 108             on the "#define" line.
 109
 110 Various pages
 111     Michael Kerrisk
 112         SEE ALSO: Remove redundant reference to feature_test_macros(7)
 113
 114 Various pages
 115     David Prevot
 116         Use greater consistency in NAME line
 117         (Remove definite article at start of descriptiive clause.)
 118
 119 Various pages
 120     Michael Kerrisk
 121         SEE ALSO: Place entries in correct order
 122
 123 Various pages
 124     Michael Kerrisk
 125         SEE ALSO: Place entries in correct order
 126
 127 Various pages
 128     Michael Kerrisk
 129         Add section number to references to functions documented in other pages
 130
 131 Various pages
 132     Michael Kerrisk
 133         Remove redundant section number in page references
 134             Remove section number in function references that are for
 135             functions documented on this page.
 136
 137 armscii-8.7
 138 iso_8859-3.7
 139 iso_8859-4.7
 140 iso_8859-5.7
 141 iso_8859-6.7
 142 iso_8859-10.7
 143 iso_8859-11.7
 144 iso_8859-13.7
 145 iso_8859-14.7
 146 koi8-u.7
 147     David Prevot
 148         Capitalize hexadecimal numbers
 149
 150
 151 Changes to individual pages
 152 ---------------------------
 153
 154 access.2
 155     Michael Kerrisk
 156         Note use of faccessat(2) for checking symbolic link permissions
 157     Michael Kerrisk
 158         Give an example of a safer alternative to using access()
 159
 160 clone.2
 161     Michael Kerrisk
 162         Clarify when CLONE_NEWNET implementation was completed
 163
 164 faccessat.2
 165     Michael Kerrisk
 166         Note that faccessat() is racy
 167
 168 fcntl.2
 169     Michael Kerrisk
 170         RETURN VALUE: Improve description of F_GETFD and F_GETFL
 171
 172 inotify_add_watch.2
 173     Michael Kerrisk
 174         Document ENOENT error
 175
 176 mlock.2
 177     Michael Kerrisk
 178         Improve wording describing /proc/PID/status /VmLck field
 179     Michael Kerrisk
 180         shmctl() SHM_LOCKed memory is not included in VmLck
 181
 182 reboot.2
 183     Michael Kerrisk
 184         Place 'cmd' values in alphabetical order
 185
 186 subpage_prot.2
 187     Michael Kerrisk
 188         Change 1-line page description
 189     Michael Kerrisk
 190         Improvements after review by Paul Mackerras
 191
 192 timer_settime.3
 193     Michael Kerrisk
 194         Remove redundant SEE ALSO reference
 195
 196 euidaccess.3
 197     Michael Kerrisk
 198         Note the use of faccessat(2) to operate on symbolic links
 199     Michael Kerrisk
 200         Note that the use of euidaccess() is racy
 201
 202 fenv.3
 203     Michael Kerrisk
 204         Clarify wording relating to glibc version
 205
 206 getgrent.3
 207 getgrent_r.3
 208 getgrnam.3
 209     Michael Kerrisk
 210         Refer reader for group(5) for more info on group structure
 211
 212 getopt.3
 213     Bernhard Walle
 214         Use constants in getopt_long() example
 215             The description of getopt_long() mentions the constants
 216             required_argument, no_argument and optional_argument.
 217             Use them in the example to make the code easier to understand.
 218
 219 getpw.3
 220     Michael Kerrisk
 221         Change comment describing pw_gecos
 222
 223 getpw.3
 224 getpwent.3
 225 getpwent_r.3
 226     Michael Kerrisk
 227         Refer reader to passwd(5) for more info on the passwd structure
 228
 229 getpwent.3
 230 getpwnam.3
 231     Michael Kerrisk
 232         Note that pw_gecos is not in POSIX
 233             And change the comment describing this field
 234
 235 getpwent_r.3
 236     Michael Kerrisk
 237         Change comment describing pw_gecos
 238
 239 getpwnam.3
 240     Michael Kerrisk
 241         Some rewording and restructuring
 242
 243 sched_getcpu.3
 244     Michael Kerrisk
 245         Fix feature test macro requirements
 246
 247 strnlen.3
 248     Michael Kerrisk
 249         Fix feature test macro requirements
 250
 251 group.5
 252     Michael Kerrisk
 253         Various minor rewordings
 254
 255 hosts.5
 256 protocols.5
 257 spufs.7
 258 termio.7
 259     David Prevot
 260         Remove definite article from NAME section
 261             Please find inline another tiny patch in order to shrink
 262             the definite article from some other pages (found with
 263             "rgrep -i ' \\\- the' man*").
 264
 265 passwd.5
 266     Michael Kerrisk
 267         Various minor rewordings
 268
 269 proc.5
 270     Michael Kerrisk
 271         Add reference to mlock(2) for further info on /proc/PID/status VmLck
 272
 273 armscii-8.7
 274     David Prevot
 275         Write the character set name as ArmSCII
 276
 277 cp1251.7
 278     David Prevot
 279         Capitalize hexadecimal numbers
 280
 281 ip.7
 282     David Prevot
 283         Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/
 284     David Prevot
 285         Place socket options in alphabetical order
 286
 287 koi8-r.7
 288     David Prevot
 289         Fix special character names
 290             Comparing to koi8-u.7, I noticed some inconsistencies in special
 291             character names. After checking with the following Unicode related
 292             pages, please find inline (and gzipped attached, hopefully not
 293             messing with encoding), a patch in order to make it right, on an
 294             Unicode point of view.
 295
 296             http://www.unicode.org/charts/PDF/U2500.pdf
 297             http://www.unicode.org/charts/PDF/U25A0.pdf
 298             http://www.unicode.org/charts/PDF/U0080.pdf
 299             http://www.unicode.org/charts/PDF/U1D400.pdf
 300     David Prevot
 301         Fix SEE ALSO reference and letter names
 302             The koi8-r(7) (Russian Net Character Set) manual page refers
 303             to iso-8859-7(7) manual page, which is the Latin/Greek one.
 304             I guess it should refer instead to the iso-8859-5(7)
 305             (Latin/Cyrillic) one. This is addressed at the end of the patch.
 306
 307             It has also been spotted that letter names are different in
 308             this manual page and in the Unicode related page [0], the
 309             first part of the page address this.
 310
 311                     0: http://www.unicode.org/charts/PDF/U0400.pdf
 312
 313 man-pages.7
 314     Michael Kerrisk
 315         Update example
 316             The old example used the chmod(2) man page, but the
 317             feature test macro requirements on that page had changed.
 318             Update to use an example from a different page (acct(2),
 319             whose feature test macro requirements are probably unlikely
 320             to change in the future).