Skip to content

lustre: move DocBook comments to sphinix format

NeilBrown lustre-devel 1 version New

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest0 of 7 patches 0 repliesNew

Patches in v1 No applies recorded yet

None of the 7 patches the cover letter announces are in this archive.

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [lustre-devel] [PATCH 0/7] lustre: move DocBook comments to sphinix format
Quoted 4 lines · James Simmons

The Linux kernel deprecated DocBook so update Lustre to using sphinix instead. I'm no Sphinix expert so things might be missed but the major has been ported over. This should get the lustre in shape to move out of staging.

Thanks.
This is a really good start - I've applied them all.
I suspect there is still a lot of work to do.
Any comment that starts "/**" but don't a Sphinix comment should be changed to "/*", and we should link all of this into the Documentation tree, at least for test (I don't want to include any patches that aren't in driver/staging, but having the patch available would be good).

Thanks,
NeilBrown

Quoted 90 lines

James Simmons (7):
lnet: move comments to sphinix format
lustre: move header file comments to sphinix format
ptlrpc: move comments to sphinix format
ldlm: move comments to sphinix format
llite: move comments to sphinix format
obdclass: move comments to sphinix format
lustre: move remaining comments to sphinix format

 .../lustre/include/linux/libcfs/libcfs_cpu.h       |  50 ++--
 .../lustre/include/linux/libcfs/libcfs_crypto.h    |  20 +-
 .../lustre/include/uapi/linux/lnet/lnetctl.h       |   2 +-
 .../lustre/include/uapi/linux/lustre/lustre_fid.h  |  20 +-
 .../lustre/include/uapi/linux/lustre/lustre_idl.h  |   2 +-
 .../lustre/include/uapi/linux/lustre/lustre_user.h |  13 +-
 .../staging/lustre/lnet/klnds/o2iblnd/o2iblnd.h    |   2 +-
 drivers/staging/lustre/lnet/libcfs/debug.c         |   2 +-
 drivers/staging/lustre/lnet/libcfs/libcfs_cpu.c    |   2 +-
 drivers/staging/lustre/lnet/libcfs/libcfs_lock.c   |   8 +-
 drivers/staging/lustre/lnet/libcfs/libcfs_string.c |  67 +++--
 drivers/staging/lustre/lnet/libcfs/linux-crypto.c  | 131 ++++-----
 drivers/staging/lustre/lnet/lnet/api-ni.c          |  34 +--
 drivers/staging/lustre/lnet/lnet/lib-eq.c          | 100 +++----
 drivers/staging/lustre/lnet/lnet/lib-md.c          |  67 ++---
 drivers/staging/lustre/lnet/lnet/lib-me.c          |  76 ++---
 drivers/staging/lustre/lnet/lnet/lib-move.c        | 113 ++++----
 drivers/staging/lustre/lnet/lnet/lib-ptl.c         |  12 +-
 drivers/staging/lustre/lnet/lnet/net_fault.c       |  30 +-
 drivers/staging/lustre/lnet/lnet/nidstrings.c      | 125 ++++-----
 drivers/staging/lustre/lustre/fld/fld_cache.c      |   4 +-
 drivers/staging/lustre/lustre/fld/fld_internal.h   |   2 +-
 drivers/staging/lustre/lustre/include/cl_object.h  |  91 +++---
 drivers/staging/lustre/lustre/include/lu_object.h  |   8 +-
 drivers/staging/lustre/lustre/include/lustre_dlm.h |  10 +-
 .../staging/lustre/lustre/include/lustre_import.h  |   4 +-
 drivers/staging/lustre/lustre/include/lustre_mdc.h |   4 +-
 drivers/staging/lustre/lustre/include/lustre_net.h |  76 ++---
 drivers/staging/lustre/lustre/include/lustre_nrs.h | 118 ++++----
 drivers/staging/lustre/lustre/include/lustre_sec.h |  83 +++---
 drivers/staging/lustre/lustre/include/obd_class.h  |   9 +-
 drivers/staging/lustre/lustre/include/seq_range.h  |  32 +--
 drivers/staging/lustre/lustre/ldlm/ldlm_flock.c    |  14 +-
 drivers/staging/lustre/lustre/ldlm/ldlm_lib.c      |   8 +-
 drivers/staging/lustre/lustre/ldlm/ldlm_lock.c     |  90 +++---
 drivers/staging/lustre/lustre/ldlm/ldlm_lockd.c    |   6 +-
 drivers/staging/lustre/lustre/ldlm/ldlm_pool.c     |  22 +-
 drivers/staging/lustre/lustre/ldlm/ldlm_request.c  |  99 ++++---
 drivers/staging/lustre/lustre/ldlm/ldlm_resource.c |  18 +-
 drivers/staging/lustre/lustre/llite/dir.c          |  14 +-
 drivers/staging/lustre/lustre/llite/file.c         |  62 +++--
 drivers/staging/lustre/lustre/llite/glimpse.c      |   4 +-
 drivers/staging/lustre/lustre/llite/lcommon_cl.c   |   5 +-
 drivers/staging/lustre/lustre/llite/llite_lib.c    |  48 ++--
 drivers/staging/lustre/lustre/llite/llite_mmap.c   |  19 +-
 drivers/staging/lustre/lustre/llite/llite_nfs.c    |   4 +-
 drivers/staging/lustre/lustre/llite/lproc_llite.c  |  22 +-
 drivers/staging/lustre/lustre/llite/range_lock.c   |  20 +-
 drivers/staging/lustre/lustre/llite/rw.c           |  14 +-
 drivers/staging/lustre/lustre/llite/statahead.c    |  59 ++--
 drivers/staging/lustre/lustre/llite/super25.c      |   3 +-
 drivers/staging/lustre/lustre/llite/vvp_io.c       |   2 +-
 drivers/staging/lustre/lustre/llite/vvp_page.c     |   8 +-
 drivers/staging/lustre/lustre/llite/xattr_cache.c  |  44 +--
 .../staging/lustre/lustre/llite/xattr_security.c   |  12 +-
 drivers/staging/lustre/lustre/lmv/lmv_obd.c        | 119 ++++----
 drivers/staging/lustre/lustre/lov/lov_io.c         |   2 +-
 drivers/staging/lustre/lustre/lov/lov_object.c     |  47 ++--
 drivers/staging/lustre/lustre/lov/lov_pack.c       |   4 +-
 drivers/staging/lustre/lustre/mdc/mdc_changelog.c  |  91 +++---
 drivers/staging/lustre/lustre/mdc/mdc_lib.c        |  12 +-
 drivers/staging/lustre/lustre/mdc/mdc_request.c    |  34 +--
 drivers/staging/lustre/lustre/mgc/mgc_request.c    |   8 +-
 drivers/staging/lustre/lustre/obdclass/cl_io.c     |  12 +-
 drivers/staging/lustre/lustre/obdclass/cl_lock.c   |  11 +-
 drivers/staging/lustre/lustre/obdclass/cl_object.c |  44 +--
 drivers/staging/lustre/lustre/obdclass/cl_page.c   |  30 +-
 drivers/staging/lustre/lustre/obdclass/genops.c    |  22 +-
 .../staging/lustre/lustre/obdclass/kernelcomm.c    |  23 +-
 drivers/staging/lustre/lustre/obdclass/linkea.c    |  15 +-
 .../lustre/lustre/obdclass/lprocfs_status.c        |  30 +-
 drivers/staging/lustre/lustre/obdclass/lu_object.c |  44 +--
 drivers/staging/lustre/lustre/obdclass/obd_mount.c |  47 ++--
 drivers/staging/lustre/lustre/osc/osc_cache.c      |  12 +-
 drivers/staging/lustre/lustre/osc/osc_lock.c       |  10 +-
 drivers/staging/lustre/lustre/osc/osc_request.c    |   4 +-
 drivers/staging/lustre/lustre/ptlrpc/client.c      |  72 ++---
 drivers/staging/lustre/lustre/ptlrpc/import.c      |   6 +-
 drivers/staging/lustre/lustre/ptlrpc/layout.c      | 102 +++----
 .../staging/lustre/lustre/ptlrpc/lproc_ptlrpc.c    |  10 +-
Quoted 11 lines
 drivers/staging/lustre/lustre/ptlrpc/niobuf.c      |  14 +-
 drivers/staging/lustre/lustre/ptlrpc/nrs.c         | 305 +++++++++++----------
 drivers/staging/lustre/lustre/ptlrpc/nrs_fifo.c    |  68 ++---
 .../staging/lustre/lustre/ptlrpc/pack_generic.c    |   8 +-
 drivers/staging/lustre/lustre/ptlrpc/sec.c         | 104 +++----
 drivers/staging/lustre/lustre/ptlrpc/sec_config.c  |   2 +-
 drivers/staging/lustre/lustre/ptlrpc/service.c     |   4 +-
 87 files changed, 1641 insertions(+), 1589 deletions(-)
Signature · 1 line
1.8.3.1

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 832 bytes
Desc: not available
URL: <http://lists.lustre.org/pipermail/lustre-devel-lustre.org/attachments/20190304/fbd59d4d/attachment.sig>