From 7d9de9ab9f04c763b3c46a5ec2aff4b0769817fa Mon Sep 17 00:00:00 2001 From: Timothy Day Date: Sat, 29 Mar 2025 19:18:54 -0400 Subject: [PATCH] LU-18687 doc: move man *.1 pages to Documentation/man1 Consolidate all of the man pages into the top level Documentation directory. Move all of the Lustre man pages (from 1) to Docmentation/. Test-Parameters: trivial Signed-off-by: Timothy Day Change-Id: Ied472c7612996cfd04670f5b2803bfb48d2bf74a Reviewed-on: https://review.whamcloud.com/c/fs/lustre-release/+/58587 Reviewed-by: Arshad Hussain Reviewed-by: Andreas Dilger Reviewed-by: James Simmons Reviewed-by: Oleg Drokin Tested-by: jenkins Tested-by: Maloo --- Documentation/man1/Makefile.am | 43 +++++++++++++++++++++- {lustre/doc => Documentation/man1}/lfs-changelog.1 | 0 .../man1}/lfs-changelog_clear.1 | 0 {lustre/doc => Documentation/man1}/lfs-df.1 | 0 {lustre/doc => Documentation/man1}/lfs-fid2path.1 | 0 {lustre/doc => Documentation/man1}/lfs-find.1 | 0 {lustre/doc => Documentation/man1}/lfs-flushctx.1 | 0 .../doc => Documentation/man1}/lfs-getdirstripe.1 | 0 {lustre/doc => Documentation/man1}/lfs-getname.1 | 0 {lustre/doc => Documentation/man1}/lfs-getsom.1 | 0 {lustre/doc => Documentation/man1}/lfs-getstripe.1 | 0 {lustre/doc => Documentation/man1}/lfs-heat_get.1 | 0 {lustre/doc => Documentation/man1}/lfs-heat_set.1 | 0 {lustre/doc => Documentation/man1}/lfs-hsm.1 | 0 .../doc => Documentation/man1}/lfs-hsm_action.1 | 0 {lustre/doc => Documentation/man1}/lfs-hsm_clear.1 | 0 {lustre/doc => Documentation/man1}/lfs-hsm_set.1 | 0 {lustre/doc => Documentation/man1}/lfs-hsm_state.1 | 0 {lustre/doc => Documentation/man1}/lfs-ladvise.1 | 0 {lustre/doc => Documentation/man1}/lfs-migrate.1 | 0 .../doc => Documentation/man1}/lfs-mirror-copy.1 | 0 .../doc => Documentation/man1}/lfs-mirror-create.1 | 0 .../doc => Documentation/man1}/lfs-mirror-delete.1 | 0 .../doc => Documentation/man1}/lfs-mirror-extend.1 | 0 .../doc => Documentation/man1}/lfs-mirror-read.1 | 0 .../doc => Documentation/man1}/lfs-mirror-resync.1 | 0 .../doc => Documentation/man1}/lfs-mirror-split.1 | 0 .../doc => Documentation/man1}/lfs-mirror-verify.1 | 0 .../doc => Documentation/man1}/lfs-mirror-write.1 | 0 {lustre/doc => Documentation/man1}/lfs-mkdir.1 | 0 {lustre/doc => Documentation/man1}/lfs-path2fid.1 | 0 .../doc => Documentation/man1}/lfs-pcc-attach.1 | 0 .../man1}/lfs-pcc-attach_fid.1 | 0 .../doc => Documentation/man1}/lfs-pcc-delete.1 | 0 .../doc => Documentation/man1}/lfs-pcc-detach.1 | 0 .../man1}/lfs-pcc-detach_fid.1 | 0 {lustre/doc => Documentation/man1}/lfs-pcc-pin.1 | 0 {lustre/doc => Documentation/man1}/lfs-pcc-state.1 | 0 {lustre/doc => Documentation/man1}/lfs-pcc-unpin.1 | 0 {lustre/doc => Documentation/man1}/lfs-pcc.1 | 0 {lustre/doc => Documentation/man1}/lfs-project.1 | 0 {lustre/doc => Documentation/man1}/lfs-quota.1 | 0 {lustre/doc => Documentation/man1}/lfs-rmfid.1 | 0 .../doc => Documentation/man1}/lfs-setdirstripe.1 | 0 {lustre/doc => Documentation/man1}/lfs-setquota.1 | 0 {lustre/doc => Documentation/man1}/lfs-setstripe.1 | 0 {lustre/doc => Documentation/man1}/lfs-somsync.1 | 0 {lustre/doc => Documentation/man1}/lfs.1 | 0 {lustre/doc => Documentation/man1}/lfs_migrate.1 | 0 lustre/doc/Makefile.am | 41 --------------------- 50 files changed, 42 insertions(+), 42 deletions(-) rename {lustre/doc => Documentation/man1}/lfs-changelog.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-changelog_clear.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-df.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-fid2path.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-find.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-flushctx.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-getdirstripe.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-getname.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-getsom.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-getstripe.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-heat_get.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-heat_set.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-hsm.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-hsm_action.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-hsm_clear.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-hsm_set.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-hsm_state.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-ladvise.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-migrate.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-copy.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-create.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-delete.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-extend.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-read.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-resync.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-split.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-verify.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mirror-write.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-mkdir.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-path2fid.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-attach.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-attach_fid.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-delete.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-detach.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-detach_fid.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-pin.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-state.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc-unpin.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-pcc.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-project.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-quota.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-rmfid.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-setdirstripe.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-setquota.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-setstripe.1 (100%) rename {lustre/doc => Documentation/man1}/lfs-somsync.1 (100%) rename {lustre/doc => Documentation/man1}/lfs.1 (100%) rename {lustre/doc => Documentation/man1}/lfs_migrate.1 (100%) diff --git a/Documentation/man1/Makefile.am b/Documentation/man1/Makefile.am index 6e53ab5..31c4c1b 100644 --- a/Documentation/man1/Makefile.am +++ b/Documentation/man1/Makefile.am @@ -4,7 +4,48 @@ # This file is part of Lustre, http://www.lustre.org/ # -MANFILES = +MANFILES = \ + lfs.1 \ + lfs-changelog.1 \ + lfs-changelog_clear.1 \ + lfs-df.1 \ + lfs-fid2path.1 \ + lfs-find.1 \ + lfs-flushctx.1 \ + lfs-getdirstripe.1 \ + lfs-getname.1 \ + lfs-getsom.1 \ + lfs-getstripe.1 \ + lfs-heat_get.1 \ + lfs-heat_set.1 \ + lfs-hsm.1 \ + lfs-hsm_action.1 \ + lfs-hsm_clear.1 \ + lfs-hsm_set.1 \ + lfs-hsm_state.1 \ + lfs-ladvise.1 \ + lfs_migrate.1 \ + lfs-migrate.1 \ + lfs-mirror-copy.1 \ + lfs-mirror-create.1 \ + lfs-mirror-delete.1 \ + lfs-mirror-extend.1 \ + lfs-mirror-read.1 \ + lfs-mirror-resync.1 \ + lfs-mirror-split.1 \ + lfs-mirror-verify.1 \ + lfs-mirror-write.1 \ + lfs-mkdir.1 \ + lfs-path2fid.1 \ + lfs-pcc-detach.1 \ + lfs-pcc-state.1 \ + lfs-pcc.1 \ + lfs-project.1 \ + lfs-quota.1 \ + lfs-rmfid.1 \ + lfs-setdirstripe.1 \ + lfs-setquota.1 \ + lfs-setstripe.1 if MANPAGES if UTILS diff --git a/lustre/doc/lfs-changelog.1 b/Documentation/man1/lfs-changelog.1 similarity index 100% rename from lustre/doc/lfs-changelog.1 rename to Documentation/man1/lfs-changelog.1 diff --git a/lustre/doc/lfs-changelog_clear.1 b/Documentation/man1/lfs-changelog_clear.1 similarity index 100% rename from lustre/doc/lfs-changelog_clear.1 rename to Documentation/man1/lfs-changelog_clear.1 diff --git a/lustre/doc/lfs-df.1 b/Documentation/man1/lfs-df.1 similarity index 100% rename from lustre/doc/lfs-df.1 rename to Documentation/man1/lfs-df.1 diff --git a/lustre/doc/lfs-fid2path.1 b/Documentation/man1/lfs-fid2path.1 similarity index 100% rename from lustre/doc/lfs-fid2path.1 rename to Documentation/man1/lfs-fid2path.1 diff --git a/lustre/doc/lfs-find.1 b/Documentation/man1/lfs-find.1 similarity index 100% rename from lustre/doc/lfs-find.1 rename to Documentation/man1/lfs-find.1 diff --git a/lustre/doc/lfs-flushctx.1 b/Documentation/man1/lfs-flushctx.1 similarity index 100% rename from lustre/doc/lfs-flushctx.1 rename to Documentation/man1/lfs-flushctx.1 diff --git a/lustre/doc/lfs-getdirstripe.1 b/Documentation/man1/lfs-getdirstripe.1 similarity index 100% rename from lustre/doc/lfs-getdirstripe.1 rename to Documentation/man1/lfs-getdirstripe.1 diff --git a/lustre/doc/lfs-getname.1 b/Documentation/man1/lfs-getname.1 similarity index 100% rename from lustre/doc/lfs-getname.1 rename to Documentation/man1/lfs-getname.1 diff --git a/lustre/doc/lfs-getsom.1 b/Documentation/man1/lfs-getsom.1 similarity index 100% rename from lustre/doc/lfs-getsom.1 rename to Documentation/man1/lfs-getsom.1 diff --git a/lustre/doc/lfs-getstripe.1 b/Documentation/man1/lfs-getstripe.1 similarity index 100% rename from lustre/doc/lfs-getstripe.1 rename to Documentation/man1/lfs-getstripe.1 diff --git a/lustre/doc/lfs-heat_get.1 b/Documentation/man1/lfs-heat_get.1 similarity index 100% rename from lustre/doc/lfs-heat_get.1 rename to Documentation/man1/lfs-heat_get.1 diff --git a/lustre/doc/lfs-heat_set.1 b/Documentation/man1/lfs-heat_set.1 similarity index 100% rename from lustre/doc/lfs-heat_set.1 rename to Documentation/man1/lfs-heat_set.1 diff --git a/lustre/doc/lfs-hsm.1 b/Documentation/man1/lfs-hsm.1 similarity index 100% rename from lustre/doc/lfs-hsm.1 rename to Documentation/man1/lfs-hsm.1 diff --git a/lustre/doc/lfs-hsm_action.1 b/Documentation/man1/lfs-hsm_action.1 similarity index 100% rename from lustre/doc/lfs-hsm_action.1 rename to Documentation/man1/lfs-hsm_action.1 diff --git a/lustre/doc/lfs-hsm_clear.1 b/Documentation/man1/lfs-hsm_clear.1 similarity index 100% rename from lustre/doc/lfs-hsm_clear.1 rename to Documentation/man1/lfs-hsm_clear.1 diff --git a/lustre/doc/lfs-hsm_set.1 b/Documentation/man1/lfs-hsm_set.1 similarity index 100% rename from lustre/doc/lfs-hsm_set.1 rename to Documentation/man1/lfs-hsm_set.1 diff --git a/lustre/doc/lfs-hsm_state.1 b/Documentation/man1/lfs-hsm_state.1 similarity index 100% rename from lustre/doc/lfs-hsm_state.1 rename to Documentation/man1/lfs-hsm_state.1 diff --git a/lustre/doc/lfs-ladvise.1 b/Documentation/man1/lfs-ladvise.1 similarity index 100% rename from lustre/doc/lfs-ladvise.1 rename to Documentation/man1/lfs-ladvise.1 diff --git a/lustre/doc/lfs-migrate.1 b/Documentation/man1/lfs-migrate.1 similarity index 100% rename from lustre/doc/lfs-migrate.1 rename to Documentation/man1/lfs-migrate.1 diff --git a/lustre/doc/lfs-mirror-copy.1 b/Documentation/man1/lfs-mirror-copy.1 similarity index 100% rename from lustre/doc/lfs-mirror-copy.1 rename to Documentation/man1/lfs-mirror-copy.1 diff --git a/lustre/doc/lfs-mirror-create.1 b/Documentation/man1/lfs-mirror-create.1 similarity index 100% rename from lustre/doc/lfs-mirror-create.1 rename to Documentation/man1/lfs-mirror-create.1 diff --git a/lustre/doc/lfs-mirror-delete.1 b/Documentation/man1/lfs-mirror-delete.1 similarity index 100% rename from lustre/doc/lfs-mirror-delete.1 rename to Documentation/man1/lfs-mirror-delete.1 diff --git a/lustre/doc/lfs-mirror-extend.1 b/Documentation/man1/lfs-mirror-extend.1 similarity index 100% rename from lustre/doc/lfs-mirror-extend.1 rename to Documentation/man1/lfs-mirror-extend.1 diff --git a/lustre/doc/lfs-mirror-read.1 b/Documentation/man1/lfs-mirror-read.1 similarity index 100% rename from lustre/doc/lfs-mirror-read.1 rename to Documentation/man1/lfs-mirror-read.1 diff --git a/lustre/doc/lfs-mirror-resync.1 b/Documentation/man1/lfs-mirror-resync.1 similarity index 100% rename from lustre/doc/lfs-mirror-resync.1 rename to Documentation/man1/lfs-mirror-resync.1 diff --git a/lustre/doc/lfs-mirror-split.1 b/Documentation/man1/lfs-mirror-split.1 similarity index 100% rename from lustre/doc/lfs-mirror-split.1 rename to Documentation/man1/lfs-mirror-split.1 diff --git a/lustre/doc/lfs-mirror-verify.1 b/Documentation/man1/lfs-mirror-verify.1 similarity index 100% rename from lustre/doc/lfs-mirror-verify.1 rename to Documentation/man1/lfs-mirror-verify.1 diff --git a/lustre/doc/lfs-mirror-write.1 b/Documentation/man1/lfs-mirror-write.1 similarity index 100% rename from lustre/doc/lfs-mirror-write.1 rename to Documentation/man1/lfs-mirror-write.1 diff --git a/lustre/doc/lfs-mkdir.1 b/Documentation/man1/lfs-mkdir.1 similarity index 100% rename from lustre/doc/lfs-mkdir.1 rename to Documentation/man1/lfs-mkdir.1 diff --git a/lustre/doc/lfs-path2fid.1 b/Documentation/man1/lfs-path2fid.1 similarity index 100% rename from lustre/doc/lfs-path2fid.1 rename to Documentation/man1/lfs-path2fid.1 diff --git a/lustre/doc/lfs-pcc-attach.1 b/Documentation/man1/lfs-pcc-attach.1 similarity index 100% rename from lustre/doc/lfs-pcc-attach.1 rename to Documentation/man1/lfs-pcc-attach.1 diff --git a/lustre/doc/lfs-pcc-attach_fid.1 b/Documentation/man1/lfs-pcc-attach_fid.1 similarity index 100% rename from lustre/doc/lfs-pcc-attach_fid.1 rename to Documentation/man1/lfs-pcc-attach_fid.1 diff --git a/lustre/doc/lfs-pcc-delete.1 b/Documentation/man1/lfs-pcc-delete.1 similarity index 100% rename from lustre/doc/lfs-pcc-delete.1 rename to Documentation/man1/lfs-pcc-delete.1 diff --git a/lustre/doc/lfs-pcc-detach.1 b/Documentation/man1/lfs-pcc-detach.1 similarity index 100% rename from lustre/doc/lfs-pcc-detach.1 rename to Documentation/man1/lfs-pcc-detach.1 diff --git a/lustre/doc/lfs-pcc-detach_fid.1 b/Documentation/man1/lfs-pcc-detach_fid.1 similarity index 100% rename from lustre/doc/lfs-pcc-detach_fid.1 rename to Documentation/man1/lfs-pcc-detach_fid.1 diff --git a/lustre/doc/lfs-pcc-pin.1 b/Documentation/man1/lfs-pcc-pin.1 similarity index 100% rename from lustre/doc/lfs-pcc-pin.1 rename to Documentation/man1/lfs-pcc-pin.1 diff --git a/lustre/doc/lfs-pcc-state.1 b/Documentation/man1/lfs-pcc-state.1 similarity index 100% rename from lustre/doc/lfs-pcc-state.1 rename to Documentation/man1/lfs-pcc-state.1 diff --git a/lustre/doc/lfs-pcc-unpin.1 b/Documentation/man1/lfs-pcc-unpin.1 similarity index 100% rename from lustre/doc/lfs-pcc-unpin.1 rename to Documentation/man1/lfs-pcc-unpin.1 diff --git a/lustre/doc/lfs-pcc.1 b/Documentation/man1/lfs-pcc.1 similarity index 100% rename from lustre/doc/lfs-pcc.1 rename to Documentation/man1/lfs-pcc.1 diff --git a/lustre/doc/lfs-project.1 b/Documentation/man1/lfs-project.1 similarity index 100% rename from lustre/doc/lfs-project.1 rename to Documentation/man1/lfs-project.1 diff --git a/lustre/doc/lfs-quota.1 b/Documentation/man1/lfs-quota.1 similarity index 100% rename from lustre/doc/lfs-quota.1 rename to Documentation/man1/lfs-quota.1 diff --git a/lustre/doc/lfs-rmfid.1 b/Documentation/man1/lfs-rmfid.1 similarity index 100% rename from lustre/doc/lfs-rmfid.1 rename to Documentation/man1/lfs-rmfid.1 diff --git a/lustre/doc/lfs-setdirstripe.1 b/Documentation/man1/lfs-setdirstripe.1 similarity index 100% rename from lustre/doc/lfs-setdirstripe.1 rename to Documentation/man1/lfs-setdirstripe.1 diff --git a/lustre/doc/lfs-setquota.1 b/Documentation/man1/lfs-setquota.1 similarity index 100% rename from lustre/doc/lfs-setquota.1 rename to Documentation/man1/lfs-setquota.1 diff --git a/lustre/doc/lfs-setstripe.1 b/Documentation/man1/lfs-setstripe.1 similarity index 100% rename from lustre/doc/lfs-setstripe.1 rename to Documentation/man1/lfs-setstripe.1 diff --git a/lustre/doc/lfs-somsync.1 b/Documentation/man1/lfs-somsync.1 similarity index 100% rename from lustre/doc/lfs-somsync.1 rename to Documentation/man1/lfs-somsync.1 diff --git a/lustre/doc/lfs.1 b/Documentation/man1/lfs.1 similarity index 100% rename from lustre/doc/lfs.1 rename to Documentation/man1/lfs.1 diff --git a/lustre/doc/lfs_migrate.1 b/Documentation/man1/lfs_migrate.1 similarity index 100% rename from lustre/doc/lfs_migrate.1 rename to Documentation/man1/lfs_migrate.1 diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am index 1470328..a2b6a79 100644 --- a/lustre/doc/Makefile.am +++ b/lustre/doc/Makefile.am @@ -44,49 +44,8 @@ MANFILES = \ lctl-set_param.8 \ ldev.8 \ ldev.conf.5 \ - lfs.1 \ - lfs-changelog.1 \ - lfs-changelog_clear.1 \ - lfs-df.1 \ - lfs-fid2path.1 \ - lfs-find.1 \ - lfs-flushctx.1 \ - lfs-getdirstripe.1 \ - lfs-getname.1 \ - lfs-getsom.1 \ - lfs-getstripe.1 \ - lfs-heat_get.1 \ - lfs-heat_set.1 \ - lfs-hsm.1 \ - lfs-hsm_action.1 \ - lfs-hsm_clear.1 \ - lfs-hsm_set.1 \ - lfs-hsm_state.1 \ - lfs-ladvise.1 \ - lfs_migrate.1 \ - lfs-migrate.1 \ - lfs-mirror-copy.1 \ - lfs-mirror-create.1 \ - lfs-mirror-delete.1 \ - lfs-mirror-extend.1 \ - lfs-mirror-read.1 \ - lfs-mirror-resync.1 \ - lfs-mirror-split.1 \ - lfs-mirror-verify.1 \ - lfs-mirror-write.1 \ - lfs-mkdir.1 \ - lfs-path2fid.1 \ - lfs-pcc-detach.1 \ - lfs-pcc-state.1 \ - lfs-pcc.1 \ - lfs-project.1 \ - lfs-quota.1 \ lfs-rm_entry.8 \ lfs-rmentry.8 \ - lfs-rmfid.1 \ - lfs-setdirstripe.1 \ - lfs-setquota.1 \ - lfs-setstripe.1 \ lgss_sk.8 \ lhbadm.8 \ ll_decode_linkea.8 \ -- 1.8.3.1