[lustre-devel] [PATCH 0/7] lustre: move DocBook comments to sphinix format
NeilBrown
neilb at suse.com
Sun Mar 3 15:24:53 PST 2019
On Sat, Mar 02 2019, James Simmons wrote:
> 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
>
> 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 +-
> 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(-)
>
> --
> 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>
More information about the lustre-devel
mailing list