0007-man-Fix-period-formatting.patch 6.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213
  1. From 0319efeeea3dbd4b53b81934b4f24bba96d77959 Mon Sep 17 00:00:00 2001
  2. From: Guillem Jover <guillem@hadrons.org>
  3. Date: Sat, 20 Jul 2019 21:18:05 +0200
  4. Subject: [PATCH libaio 07/28] man: Fix period formatting
  5. Signed-off-by: Guillem Jover <guillem@hadrons.org>
  6. Signed-off-by: Jeff Moyer <jmoyer@redhat.com>
  7. ---
  8. man/io.3 | 13 +++++--------
  9. man/io_fsync.3 | 2 +-
  10. man/io_getevents.3 | 3 +--
  11. man/io_prep_fsync.3 | 2 +-
  12. man/io_prep_pread.3 | 5 ++---
  13. man/io_prep_pwrite.3 | 5 ++---
  14. man/io_queue_release.3 | 2 +-
  15. man/io_queue_run.3 | 2 +-
  16. man/io_queue_wait.3 | 2 +-
  17. man/io_submit.3 | 8 ++++----
  18. 10 files changed, 19 insertions(+), 25 deletions(-)
  19. diff --git a/man/io.3 b/man/io.3
  20. index e4fe108..7b8ab5e 100644
  21. --- a/man/io.3
  22. +++ b/man/io.3
  23. @@ -17,8 +17,8 @@ then immediately resume normal work while the I/O operations are
  24. executed in parallel.
  25. These functions are part of the library with realtime functions named
  26. -.IR "libaio"
  27. -. They are not actually part of the
  28. +.IR libaio .
  29. +They are not actually part of the
  30. .IR "libc"
  31. binary.
  32. The implementation of these functions can be done using support in the
  33. @@ -98,8 +98,7 @@ where the read data is stored.
  34. .TP
  35. .IR "long u.c.nbytes"
  36. This element specifies the length of the buffer pointed to by
  37. -.IR "io_buf"
  38. -.
  39. +.IR io_buf .
  40. .TP
  41. .IR "int aio_reqprio"
  42. Is not currently used.
  43. @@ -111,8 +110,7 @@ and store the next
  44. .IR "u.c.nbytes"
  45. bytes in the
  46. buffer pointed to by
  47. -.IR "buf"
  48. -.
  49. +.IR buf .
  50. .TP
  51. .B "IO_CMD_PWRITE"
  52. Start a write operation. Write
  53. @@ -120,8 +118,7 @@ Start a write operation. Write
  54. bytes starting at
  55. .IR "buf"
  56. into the file starting at position
  57. -.IR "u.c.offset"
  58. -.
  59. +.IR u.c.offset .
  60. .TP
  61. .B "IO_CMD_NOP"
  62. Do nothing for this control block. This value is useful sometimes when
  63. diff --git a/man/io_fsync.3 b/man/io_fsync.3
  64. index 77a62ff..03c81bc 100644
  65. --- a/man/io_fsync.3
  66. +++ b/man/io_fsync.3
  67. @@ -39,7 +39,7 @@ resources (mainly computation time).
  68. Calling this function forces all I/O operations operating queued at the
  69. time of the function call operating on the file descriptor
  70. .IR "iocb->io_fildes"
  71. -into the synchronized I/O completion state . The
  72. +into the synchronized I/O completion state. The
  73. .IR "io_fsync"
  74. function returns
  75. immediately but the notification through the method described in
  76. diff --git a/man/io_getevents.3 b/man/io_getevents.3
  77. index c8f2676..24c07c3 100644
  78. --- a/man/io_getevents.3
  79. +++ b/man/io_getevents.3
  80. @@ -107,8 +107,7 @@ argument is specified as NULL, then no signal mask manipulation is
  81. performed (and thus
  82. .BR io_pgetevents ()
  83. behaves the same as
  84. -.BR io_getevents()
  85. -) .
  86. +.BR io_getevents() ).
  87. .SH ERRORS
  88. .TP
  89. .B EINVAL
  90. diff --git a/man/io_prep_fsync.3 b/man/io_prep_fsync.3
  91. index 3a5f952..cf4ecff 100644
  92. --- a/man/io_prep_fsync.3
  93. +++ b/man/io_prep_fsync.3
  94. @@ -62,7 +62,7 @@ forced to the relevant completion state. The completion of
  95. subsequent I/O on the file descriptor is not guaranteed to be
  96. completed in a synchronized fashion.
  97. .PP
  98. -This function returns immediately . To schedule the operation, the
  99. +This function returns immediately. To schedule the operation, the
  100. function
  101. .IR io_submit
  102. must be called.
  103. diff --git a/man/io_prep_pread.3 b/man/io_prep_pread.3
  104. index a4df182..6d66c0f 100644
  105. --- a/man/io_prep_pread.3
  106. +++ b/man/io_prep_pread.3
  107. @@ -44,15 +44,14 @@ bytes of the file for which
  108. is a descriptor are written to the buffer
  109. starting at
  110. .TP
  111. -.IR "iocb->u.c.buf = buf"
  112. -.
  113. +.IR "iocb->u.c.buf = buf" .
  114. .br
  115. Reading starts at the absolute position
  116. .TP
  117. .IR "ioc->u.c.offset = offset"
  118. in the file.
  119. .PP
  120. -This function returns immediately . To schedule the operation, the
  121. +This function returns immediately. To schedule the operation, the
  122. function
  123. .IR io_submit
  124. must be called.
  125. diff --git a/man/io_prep_pwrite.3 b/man/io_prep_pwrite.3
  126. index 73c62c7..98b3a65 100644
  127. --- a/man/io_prep_pwrite.3
  128. +++ b/man/io_prep_pwrite.3
  129. @@ -42,15 +42,14 @@ bytes of the file for which
  130. is a descriptor are written from the buffer
  131. starting at
  132. .TP
  133. -.IR "iocb->u.c.buf = buf"
  134. -.
  135. +.IR "iocb->u.c.buf = buf" .
  136. .br
  137. Writing starts at the absolute position
  138. .TP
  139. .IR "ioc->u.c.offset = offset"
  140. in the file.
  141. .PP
  142. -This function returns immediately . To schedule the operation, the
  143. +This function returns immediately. To schedule the operation, the
  144. function
  145. .IR io_submit
  146. must be called.
  147. diff --git a/man/io_queue_release.3 b/man/io_queue_release.3
  148. index f927562..db91bad 100644
  149. --- a/man/io_queue_release.3
  150. +++ b/man/io_queue_release.3
  151. @@ -12,7 +12,7 @@ io_queue_release \- Release the context associated with the userspace handle
  152. .sp
  153. .SH DESCRIPTION
  154. .B io_queue_release
  155. -destroys the context associated with the userspace handle. May cancel any outstanding
  156. +destroys the context associated with the userspace handle. May cancel any outstanding
  157. AIOs and block on completion.
  158. .B cts.
  159. diff --git a/man/io_queue_run.3 b/man/io_queue_run.3
  160. index 35f385b..018257f 100644
  161. --- a/man/io_queue_run.3
  162. +++ b/man/io_queue_run.3
  163. @@ -30,7 +30,7 @@ referenced data outside of the program's accessible address space.
  164. .I ctx
  165. refers to an unitialized aio context, the iocb pointed to by
  166. .I iocbs
  167. -contains an improperly initialized iocb,
  168. +contains an improperly initialized iocb.
  169. .TP
  170. .B ENOSYS
  171. Not implemented.
  172. diff --git a/man/io_queue_wait.3 b/man/io_queue_wait.3
  173. index eb6db83..e3598d9 100644
  174. --- a/man/io_queue_wait.3
  175. +++ b/man/io_queue_wait.3
  176. @@ -36,7 +36,7 @@ referenced data outside of the program's accessible address space.
  177. .I ctx
  178. refers to an unitialized aio context, the iocb pointed to by
  179. .I iocbs
  180. -contains an improperly initialized iocb,
  181. +contains an improperly initialized iocb.
  182. .TP
  183. .B ENOSYS
  184. Not implemented.
  185. diff --git a/man/io_submit.3 b/man/io_submit.3
  186. index a810b3f..76e68d1 100644
  187. --- a/man/io_submit.3
  188. +++ b/man/io_submit.3
  189. @@ -49,12 +49,12 @@ gets the
  190. .IR "nr"
  191. requests from the array pointed to
  192. by
  193. -.IR "iocbs"
  194. -. The operation to be performed is determined by the
  195. +.IR "iocbs" .
  196. +The operation to be performed is determined by the
  197. .IR "aio_lio_opcode"
  198. member in each element of
  199. -.IR "iocbs"
  200. -. If this
  201. +.IR "iocbs" .
  202. +If this
  203. field is
  204. .B "IO_CMD_PREAD"
  205. a read operation is enqueued, similar to a call
  206. --
  207. 2.26.0.292.g33ef6b2f38