0003-man-Use-the-correct-troff-macro-for-comments.patch 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205
  1. From 0cd5b9ea20e8bc315d43ba1e38ed113804e3c759 Mon Sep 17 00:00:00 2001
  2. From: Guillem Jover <guillem@hadrons.org>
  3. Date: Sat, 20 Jul 2019 21:18:01 +0200
  4. Subject: [PATCH libaio 03/28] man: Use the correct troff macro for comments
  5. Signed-off-by: Guillem Jover <guillem@hadrons.org>
  6. Signed-off-by: Jeff Moyer <jmoyer@redhat.com>
  7. ---
  8. man/io_fsync.3 | 12 ++++++------
  9. man/io_getevents.3 | 36 ++++++++++++++++++------------------
  10. man/io_prep_fsync.3 | 14 +++++++-------
  11. man/io_prep_pread.3 | 20 ++++++++++----------
  12. man/io_prep_pwrite.3 | 20 ++++++++++----------
  13. man/io_set_callback.3 | 2 +-
  14. man/io_submit.3 | 24 ++++++++++++------------
  15. 7 files changed, 64 insertions(+), 64 deletions(-)
  16. diff --git a/man/io_fsync.3 b/man/io_fsync.3
  17. index 859de1b..77a62ff 100644
  18. --- a/man/io_fsync.3
  19. +++ b/man/io_fsync.3
  20. @@ -1,9 +1,9 @@
  21. -./" static inline int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)
  22. -./" {
  23. -./" io_prep_fsync(iocb, fd);
  24. -./" io_set_callback(iocb, cb);
  25. -./" return io_submit(ctx, 1, &iocb);
  26. -./" }
  27. +.\" static inline int io_fsync(io_context_t ctx, struct iocb *iocb, io_callback_t cb, int fd)
  28. +.\" {
  29. +.\" io_prep_fsync(iocb, fd);
  30. +.\" io_set_callback(iocb, cb);
  31. +.\" return io_submit(ctx, 1, &iocb);
  32. +.\" }
  33. .TH io_fsync 3 2002-09-12 "Linux 2.4" Linux AIO"
  34. .SH NAME
  35. io_fsync \- Synchronize a file's complete in-core state with that on disk
  36. diff --git a/man/io_getevents.3 b/man/io_getevents.3
  37. index a4f8b57..1e643ac 100644
  38. --- a/man/io_getevents.3
  39. +++ b/man/io_getevents.3
  40. @@ -1,21 +1,21 @@
  41. -./"/* io_getevents:
  42. -./" * Attempts to read at least min_nr events and up to nr events from
  43. -./" * the completion queue for the aio_context specified by ctx_id. May
  44. -./" * fail with -EINVAL if ctx_id is invalid, if min_nr is out of range,
  45. -./" * if nr is out of range, if when is out of range. May fail with
  46. -./" * -EFAULT if any of the memory specified to is invalid. May return
  47. -./" * 0 or < min_nr if no events are available and the timeout specified
  48. -./" * by when has elapsed, where when == NULL specifies an infinite
  49. -./" * timeout. Note that the timeout pointed to by when is relative and
  50. -./" * will be updated if not NULL and the operation blocks. Will fail
  51. -./" * with -ENOSYS if not implemented.
  52. -./" */
  53. -./"asmlinkage long sys_io_getevents(io_context_t ctx_id,
  54. -./" long min_nr,
  55. -./" long nr,
  56. -./" struct io_event *events,
  57. -./" struct timespec *timeout)
  58. -./"
  59. +.\"/* io_getevents:
  60. +.\" * Attempts to read at least min_nr events and up to nr events from
  61. +.\" * the completion queue for the aio_context specified by ctx_id. May
  62. +.\" * fail with -EINVAL if ctx_id is invalid, if min_nr is out of range,
  63. +.\" * if nr is out of range, if when is out of range. May fail with
  64. +.\" * -EFAULT if any of the memory specified to is invalid. May return
  65. +.\" * 0 or < min_nr if no events are available and the timeout specified
  66. +.\" * by when has elapsed, where when == NULL specifies an infinite
  67. +.\" * timeout. Note that the timeout pointed to by when is relative and
  68. +.\" * will be updated if not NULL and the operation blocks. Will fail
  69. +.\" * with -ENOSYS if not implemented.
  70. +.\" */
  71. +.\"asmlinkage long sys_io_getevents(io_context_t ctx_id,
  72. +.\" long min_nr,
  73. +.\" long nr,
  74. +.\" struct io_event *events,
  75. +.\" struct timespec *timeout)
  76. +.\"
  77. .TH io_getevents 2 2002-09-03 "Linux 2.4" "Linux AIO"
  78. .SH NAME
  79. io_getevents, aio_pgetevents \- Read resulting events from io requests
  80. diff --git a/man/io_prep_fsync.3 b/man/io_prep_fsync.3
  81. index 1173e2a..2daddee 100644
  82. --- a/man/io_prep_fsync.3
  83. +++ b/man/io_prep_fsync.3
  84. @@ -1,10 +1,10 @@
  85. -./" static inline void io_prep_fsync(struct iocb *iocb, int fd)
  86. -./" {
  87. -./" memset(iocb, 0, sizeof(*iocb));
  88. -./" iocb->aio_fildes = fd;
  89. -./" iocb->aio_lio_opcode = IO_CMD_FSYNC;
  90. -./" iocb->aio_reqprio = 0;
  91. -./" }
  92. +.\" static inline void io_prep_fsync(struct iocb *iocb, int fd)
  93. +.\" {
  94. +.\" memset(iocb, 0, sizeof(*iocb));
  95. +.\" iocb->aio_fildes = fd;
  96. +.\" iocb->aio_lio_opcode = IO_CMD_FSYNC;
  97. +.\" iocb->aio_reqprio = 0;
  98. +.\" }
  99. .TH io_prep_fsync 3 2002-09-12 "Linux 2.4" Linux AIO"
  100. .SH NAME
  101. io_prep_fsync \- Synchronize a file's complete in-core state with that on disk
  102. diff --git a/man/io_prep_pread.3 b/man/io_prep_pread.3
  103. index 2c3b314..1ab28f5 100644
  104. --- a/man/io_prep_pread.3
  105. +++ b/man/io_prep_pread.3
  106. @@ -1,13 +1,13 @@
  107. -./" static inline void io_prep_pread(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
  108. -./" {
  109. -./" memset(iocb, 0, sizeof(*iocb));
  110. -./" iocb->aio_fildes = fd;
  111. -./" iocb->aio_lio_opcode = IO_CMD_PREAD;
  112. -./" iocb->aio_reqprio = 0;
  113. -./" iocb->u.c.buf = buf;
  114. -./" iocb->u.c.nbytes = count;
  115. -./" iocb->u.c.offset = offset;
  116. -./" }
  117. +.\" static inline void io_prep_pread(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
  118. +.\" {
  119. +.\" memset(iocb, 0, sizeof(*iocb));
  120. +.\" iocb->aio_fildes = fd;
  121. +.\" iocb->aio_lio_opcode = IO_CMD_PREAD;
  122. +.\" iocb->aio_reqprio = 0;
  123. +.\" iocb->u.c.buf = buf;
  124. +.\" iocb->u.c.nbytes = count;
  125. +.\" iocb->u.c.offset = offset;
  126. +.\" }
  127. .TH io_prep_pread 3 2002-09-12 "Linux 2.4" Linux AIO"
  128. .SH NAME
  129. io_prep_pread \- Set up asynchronous read
  130. diff --git a/man/io_prep_pwrite.3 b/man/io_prep_pwrite.3
  131. index 669b8c2..f8d7fac 100644
  132. --- a/man/io_prep_pwrite.3
  133. +++ b/man/io_prep_pwrite.3
  134. @@ -1,13 +1,13 @@
  135. -./" static inline void io_prep_pwrite(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
  136. -./" {
  137. -./" memset(iocb, 0, sizeof(*iocb));
  138. -./" iocb->aio_fildes = fd;
  139. -./" iocb->aio_lio_opcode = IO_CMD_PWRITE;
  140. -./" iocb->aio_reqprio = 0;
  141. -./" iocb->u.c.buf = buf;
  142. -./" iocb->u.c.nbytes = count;
  143. -./" iocb->u.c.offset = offset;
  144. -./" }
  145. +.\" static inline void io_prep_pwrite(struct iocb *iocb, int fd, void *buf, size_t count, long long offset)
  146. +.\" {
  147. +.\" memset(iocb, 0, sizeof(*iocb));
  148. +.\" iocb->aio_fildes = fd;
  149. +.\" iocb->aio_lio_opcode = IO_CMD_PWRITE;
  150. +.\" iocb->aio_reqprio = 0;
  151. +.\" iocb->u.c.buf = buf;
  152. +.\" iocb->u.c.nbytes = count;
  153. +.\" iocb->u.c.offset = offset;
  154. +.\" }
  155. .TH io_prep_pwrite 3 2002-09-12 "Linux 2.4" Linux AIO"
  156. .SH NAME
  157. io_prep_pwrite \- Set up iocb for asynchronous writes
  158. diff --git a/man/io_set_callback.3 b/man/io_set_callback.3
  159. index 3c7e43f..cc842f7 100644
  160. --- a/man/io_set_callback.3
  161. +++ b/man/io_set_callback.3
  162. @@ -1,4 +1,4 @@
  163. -./"static inline void io_set_callback(struct iocb *iocb, io_callback_t cb)
  164. +.\"static inline void io_set_callback(struct iocb *iocb, io_callback_t cb)
  165. .TH io_set_callback 3 2002-09-12 "Linux 2.4" Linux AIO"
  166. .SH NAME
  167. io_set_callback \- Set up io completion callback function
  168. diff --git a/man/io_submit.3 b/man/io_submit.3
  169. index 7281147..a810b3f 100644
  170. --- a/man/io_submit.3
  171. +++ b/man/io_submit.3
  172. @@ -1,15 +1,15 @@
  173. -./"/* sys_io_submit:
  174. -./" * Queue the nr iocbs pointed to by iocbpp for processing. Returns
  175. -./" * the number of iocbs queued. May return -EINVAL if the aio_context
  176. -./" * specified by ctx_id is invalid, if nr is < 0, if the iocb at
  177. -./" * *iocbpp[0] is not properly initialized, if the operation specified
  178. -./" * is invalid for the file descriptor in the iocb. May fail with
  179. -./" * -EFAULT if any of the data structures point to invalid data. May
  180. -./" * fail with -EBADF if the file descriptor specified in the first
  181. -./" * iocb is invalid. May fail with -EAGAIN if insufficient resources
  182. -./" * are available to queue any iocbs. Will return 0 if nr is 0. Will
  183. -./" * fail with -ENOSYS if not implemented.
  184. -./" */
  185. +.\"/* sys_io_submit:
  186. +.\" * Queue the nr iocbs pointed to by iocbpp for processing. Returns
  187. +.\" * the number of iocbs queued. May return -EINVAL if the aio_context
  188. +.\" * specified by ctx_id is invalid, if nr is < 0, if the iocb at
  189. +.\" * *iocbpp[0] is not properly initialized, if the operation specified
  190. +.\" * is invalid for the file descriptor in the iocb. May fail with
  191. +.\" * -EFAULT if any of the data structures point to invalid data. May
  192. +.\" * fail with -EBADF if the file descriptor specified in the first
  193. +.\" * iocb is invalid. May fail with -EAGAIN if insufficient resources
  194. +.\" * are available to queue any iocbs. Will return 0 if nr is 0. Will
  195. +.\" * fail with -ENOSYS if not implemented.
  196. +.\" */
  197. .TH io_submit 2 2002-09-02 "Linux 2.4" "Linux AIO"
  198. .SH NAME
  199. io_submit \- Submit io requests
  200. --
  201. 2.26.0.292.g33ef6b2f38