diff --git a/cmd/gendocs/gendocs.go b/cmd/gendocs/gendocs.go index 458de5515..295eef595 100644 --- a/cmd/gendocs/gendocs.go +++ b/cmd/gendocs/gendocs.go @@ -109,7 +109,13 @@ rclone.org website.`, Title: strings.ReplaceAll(base, "_", " "), Description: commands[name].Short, Source: strings.ReplaceAll(strings.ReplaceAll(base, "rclone", "cmd"), "_", "/") + "/", - Annotations: commands[name].Annotations, + Annotations: map[string]string{}, + } + // Filter out annotations that confuse hugo from the frontmatter + for k, v := range commands[name].Annotations { + if k != "groups" { + data.Annotations[k] = v + } } var buf bytes.Buffer err := frontmatterTemplate.Execute(&buf, data) diff --git a/docs/content/commands/rclone_backend.md b/docs/content/commands/rclone_backend.md index 701609832..def1f8bba 100644 --- a/docs/content/commands/rclone_backend.md +++ b/docs/content/commands/rclone_backend.md @@ -1,7 +1,6 @@ --- title: "rclone backend" description: "Run a backend-specific command." -groups: Important versionIntroduced: v1.52 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/backend/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_bisync.md b/docs/content/commands/rclone_bisync.md index e728e573d..838d3501c 100644 --- a/docs/content/commands/rclone_bisync.md +++ b/docs/content/commands/rclone_bisync.md @@ -1,7 +1,6 @@ --- title: "rclone bisync" description: "Perform bidirectional synchronization between two paths." -groups: Filter,Copy,Important status: Beta versionIntroduced: v1.58 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/bisync/ and as part of making a release run "make commanddocs" diff --git a/docs/content/commands/rclone_cat.md b/docs/content/commands/rclone_cat.md index 0be9eed20..3f194f108 100644 --- a/docs/content/commands/rclone_cat.md +++ b/docs/content/commands/rclone_cat.md @@ -1,7 +1,6 @@ --- title: "rclone cat" description: "Concatenates any files and sends them to stdout." -groups: Filter,Listing versionIntroduced: v1.33 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cat/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_check.md b/docs/content/commands/rclone_check.md index 6aebd4aad..66f517ef9 100644 --- a/docs/content/commands/rclone_check.md +++ b/docs/content/commands/rclone_check.md @@ -1,7 +1,6 @@ --- title: "rclone check" description: "Checks the files in the source and destination match." -groups: Filter,Listing,Check # autogenerated - DO NOT EDIT, instead edit the source code in cmd/check/ and as part of making a release run "make commanddocs" --- # rclone check diff --git a/docs/content/commands/rclone_checksum.md b/docs/content/commands/rclone_checksum.md index 31e6d9988..0bb9963fe 100644 --- a/docs/content/commands/rclone_checksum.md +++ b/docs/content/commands/rclone_checksum.md @@ -1,7 +1,6 @@ --- title: "rclone checksum" description: "Checks the files in the destination against a SUM file." -groups: Filter,Listing versionIntroduced: v1.56 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/checksum/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_cleanup.md b/docs/content/commands/rclone_cleanup.md index 2412a0bf5..e4a8b9e8b 100644 --- a/docs/content/commands/rclone_cleanup.md +++ b/docs/content/commands/rclone_cleanup.md @@ -1,7 +1,6 @@ --- title: "rclone cleanup" description: "Clean up the remote if possible." -groups: Important versionIntroduced: v1.31 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cleanup/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_copy.md b/docs/content/commands/rclone_copy.md index b8633cb35..ccb85397a 100644 --- a/docs/content/commands/rclone_copy.md +++ b/docs/content/commands/rclone_copy.md @@ -1,7 +1,6 @@ --- title: "rclone copy" description: "Copy files from source to dest, skipping identical files." -groups: Copy,Filter,Listing,Important # autogenerated - DO NOT EDIT, instead edit the source code in cmd/copy/ and as part of making a release run "make commanddocs" --- # rclone copy diff --git a/docs/content/commands/rclone_copyto.md b/docs/content/commands/rclone_copyto.md index af25d213d..22479d13f 100644 --- a/docs/content/commands/rclone_copyto.md +++ b/docs/content/commands/rclone_copyto.md @@ -1,7 +1,6 @@ --- title: "rclone copyto" description: "Copy files from source to dest, skipping identical files." -groups: Copy,Filter,Listing,Important versionIntroduced: v1.35 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/copyto/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_copyurl.md b/docs/content/commands/rclone_copyurl.md index c205be914..78d4bc6b7 100644 --- a/docs/content/commands/rclone_copyurl.md +++ b/docs/content/commands/rclone_copyurl.md @@ -1,7 +1,6 @@ --- title: "rclone copyurl" description: "Copy the contents of the URL supplied content to dest:path." -groups: Important versionIntroduced: v1.43 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/copyurl/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_cryptcheck.md b/docs/content/commands/rclone_cryptcheck.md index 8bc1c755d..bbc961449 100644 --- a/docs/content/commands/rclone_cryptcheck.md +++ b/docs/content/commands/rclone_cryptcheck.md @@ -1,7 +1,6 @@ --- title: "rclone cryptcheck" description: "Cryptcheck checks the integrity of an encrypted remote." -groups: Filter,Listing,Check versionIntroduced: v1.36 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/cryptcheck/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_dedupe.md b/docs/content/commands/rclone_dedupe.md index 391100380..8126fb600 100644 --- a/docs/content/commands/rclone_dedupe.md +++ b/docs/content/commands/rclone_dedupe.md @@ -1,7 +1,6 @@ --- title: "rclone dedupe" description: "Interactively find duplicate filenames and delete/rename them." -groups: Important versionIntroduced: v1.27 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/dedupe/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_delete.md b/docs/content/commands/rclone_delete.md index 3b6cfa839..17a326e53 100644 --- a/docs/content/commands/rclone_delete.md +++ b/docs/content/commands/rclone_delete.md @@ -1,7 +1,6 @@ --- title: "rclone delete" description: "Remove the files in path." -groups: Important,Filter,Listing versionIntroduced: v1.27 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/delete/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_deletefile.md b/docs/content/commands/rclone_deletefile.md index 59d49e524..37ffc0d11 100644 --- a/docs/content/commands/rclone_deletefile.md +++ b/docs/content/commands/rclone_deletefile.md @@ -1,7 +1,6 @@ --- title: "rclone deletefile" description: "Remove a single file from remote." -groups: Important versionIntroduced: v1.42 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/deletefile/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_hashsum.md b/docs/content/commands/rclone_hashsum.md index 7092bfa19..440e7b57d 100644 --- a/docs/content/commands/rclone_hashsum.md +++ b/docs/content/commands/rclone_hashsum.md @@ -1,7 +1,6 @@ --- title: "rclone hashsum" description: "Produces a hashsum file for all the objects in the path." -groups: Filter,Listing versionIntroduced: v1.41 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/hashsum/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_ls.md b/docs/content/commands/rclone_ls.md index 352c000cd..cf1ee9de6 100644 --- a/docs/content/commands/rclone_ls.md +++ b/docs/content/commands/rclone_ls.md @@ -1,7 +1,6 @@ --- title: "rclone ls" description: "List the objects in the path with size and path." -groups: Filter,Listing # autogenerated - DO NOT EDIT, instead edit the source code in cmd/ls/ and as part of making a release run "make commanddocs" --- # rclone ls diff --git a/docs/content/commands/rclone_lsd.md b/docs/content/commands/rclone_lsd.md index 670342e2e..60a79b6dd 100644 --- a/docs/content/commands/rclone_lsd.md +++ b/docs/content/commands/rclone_lsd.md @@ -1,7 +1,6 @@ --- title: "rclone lsd" description: "List all directories/containers/buckets in the path." -groups: Filter,Listing # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsd/ and as part of making a release run "make commanddocs" --- # rclone lsd diff --git a/docs/content/commands/rclone_lsf.md b/docs/content/commands/rclone_lsf.md index 525bca3ca..c7311af01 100644 --- a/docs/content/commands/rclone_lsf.md +++ b/docs/content/commands/rclone_lsf.md @@ -1,7 +1,6 @@ --- title: "rclone lsf" description: "List directories and objects in remote:path formatted for parsing." -groups: Filter,Listing versionIntroduced: v1.40 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsf/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_lsjson.md b/docs/content/commands/rclone_lsjson.md index b15441244..f63e76b15 100644 --- a/docs/content/commands/rclone_lsjson.md +++ b/docs/content/commands/rclone_lsjson.md @@ -1,7 +1,6 @@ --- title: "rclone lsjson" description: "List directories and objects in the path in JSON format." -groups: Filter,Listing versionIntroduced: v1.37 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsjson/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_lsl.md b/docs/content/commands/rclone_lsl.md index 8b8dba6d9..1fca5a44a 100644 --- a/docs/content/commands/rclone_lsl.md +++ b/docs/content/commands/rclone_lsl.md @@ -1,7 +1,6 @@ --- title: "rclone lsl" description: "List the objects in path with modification time, size and path." -groups: Filter,Listing versionIntroduced: v1.02 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/lsl/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_md5sum.md b/docs/content/commands/rclone_md5sum.md index 8089e554f..76160249b 100644 --- a/docs/content/commands/rclone_md5sum.md +++ b/docs/content/commands/rclone_md5sum.md @@ -1,7 +1,6 @@ --- title: "rclone md5sum" description: "Produces an md5sum file for all the objects in the path." -groups: Filter,Listing versionIntroduced: v1.02 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/md5sum/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_mkdir.md b/docs/content/commands/rclone_mkdir.md index a3184480e..292fa8a0e 100644 --- a/docs/content/commands/rclone_mkdir.md +++ b/docs/content/commands/rclone_mkdir.md @@ -1,7 +1,6 @@ --- title: "rclone mkdir" description: "Make the path if it doesn't already exist." -groups: Important # autogenerated - DO NOT EDIT, instead edit the source code in cmd/mkdir/ and as part of making a release run "make commanddocs" --- # rclone mkdir diff --git a/docs/content/commands/rclone_mount.md b/docs/content/commands/rclone_mount.md index 1ac036173..9da0e7213 100644 --- a/docs/content/commands/rclone_mount.md +++ b/docs/content/commands/rclone_mount.md @@ -1,7 +1,6 @@ --- title: "rclone mount" description: "Mount the remote as file system on a mountpoint." -groups: Filter versionIntroduced: v1.33 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/mount/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_move.md b/docs/content/commands/rclone_move.md index f7aea1b05..79a1d3986 100644 --- a/docs/content/commands/rclone_move.md +++ b/docs/content/commands/rclone_move.md @@ -1,7 +1,6 @@ --- title: "rclone move" description: "Move files from source to dest." -groups: Filter,Listing,Important,Copy versionIntroduced: v1.19 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/move/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_moveto.md b/docs/content/commands/rclone_moveto.md index dd86c3f2c..4df6e05f3 100644 --- a/docs/content/commands/rclone_moveto.md +++ b/docs/content/commands/rclone_moveto.md @@ -1,7 +1,6 @@ --- title: "rclone moveto" description: "Move file or directory from source to dest." -groups: Filter,Listing,Important,Copy versionIntroduced: v1.35 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/moveto/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_ncdu.md b/docs/content/commands/rclone_ncdu.md index 2d1680079..f182aa82a 100644 --- a/docs/content/commands/rclone_ncdu.md +++ b/docs/content/commands/rclone_ncdu.md @@ -1,7 +1,6 @@ --- title: "rclone ncdu" description: "Explore a remote with a text based user interface." -groups: Filter,Listing versionIntroduced: v1.37 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/ncdu/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_nfsmount.md b/docs/content/commands/rclone_nfsmount.md index 72145e259..3c53e6fd2 100644 --- a/docs/content/commands/rclone_nfsmount.md +++ b/docs/content/commands/rclone_nfsmount.md @@ -1,7 +1,6 @@ --- title: "rclone nfsmount" description: "Mount the remote as file system on a mountpoint." -groups: Filter status: Experimental versionIntroduced: v1.65 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/nfsmount/ and as part of making a release run "make commanddocs" diff --git a/docs/content/commands/rclone_purge.md b/docs/content/commands/rclone_purge.md index cfb47707e..84413f168 100644 --- a/docs/content/commands/rclone_purge.md +++ b/docs/content/commands/rclone_purge.md @@ -1,7 +1,6 @@ --- title: "rclone purge" description: "Remove the path and all of its contents." -groups: Important # autogenerated - DO NOT EDIT, instead edit the source code in cmd/purge/ and as part of making a release run "make commanddocs" --- # rclone purge diff --git a/docs/content/commands/rclone_rcat.md b/docs/content/commands/rclone_rcat.md index 8434c72d1..959ca3d14 100644 --- a/docs/content/commands/rclone_rcat.md +++ b/docs/content/commands/rclone_rcat.md @@ -1,7 +1,6 @@ --- title: "rclone rcat" description: "Copies standard input to file on remote." -groups: Important versionIntroduced: v1.38 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcat/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_rcd.md b/docs/content/commands/rclone_rcd.md index 6df6603b4..6c64bbb0f 100644 --- a/docs/content/commands/rclone_rcd.md +++ b/docs/content/commands/rclone_rcd.md @@ -1,7 +1,6 @@ --- title: "rclone rcd" description: "Run rclone listening to remote control commands only." -groups: RC versionIntroduced: v1.45 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rcd/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_rmdir.md b/docs/content/commands/rclone_rmdir.md index bd5ae2e5b..ed5047176 100644 --- a/docs/content/commands/rclone_rmdir.md +++ b/docs/content/commands/rclone_rmdir.md @@ -1,7 +1,6 @@ --- title: "rclone rmdir" description: "Remove the empty directory at path." -groups: Important # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rmdir/ and as part of making a release run "make commanddocs" --- # rclone rmdir diff --git a/docs/content/commands/rclone_rmdirs.md b/docs/content/commands/rclone_rmdirs.md index 65e32af11..d7132f756 100644 --- a/docs/content/commands/rclone_rmdirs.md +++ b/docs/content/commands/rclone_rmdirs.md @@ -1,7 +1,6 @@ --- title: "rclone rmdirs" description: "Remove empty directories under the path." -groups: Important versionIntroduced: v1.35 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/rmdirs/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_serve_dlna.md b/docs/content/commands/rclone_serve_dlna.md index 956692464..a121d76ac 100644 --- a/docs/content/commands/rclone_serve_dlna.md +++ b/docs/content/commands/rclone_serve_dlna.md @@ -1,7 +1,6 @@ --- title: "rclone serve dlna" description: "Serve remote:path over DLNA" -groups: Filter versionIntroduced: v1.46 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/dlna/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_serve_docker.md b/docs/content/commands/rclone_serve_docker.md index 35580fd76..a5147058d 100644 --- a/docs/content/commands/rclone_serve_docker.md +++ b/docs/content/commands/rclone_serve_docker.md @@ -1,7 +1,6 @@ --- title: "rclone serve docker" description: "Serve any remote on docker's volume plugin API." -groups: Filter versionIntroduced: v1.56 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/docker/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_serve_ftp.md b/docs/content/commands/rclone_serve_ftp.md index cfa0ddd5c..7c8bfa6f6 100644 --- a/docs/content/commands/rclone_serve_ftp.md +++ b/docs/content/commands/rclone_serve_ftp.md @@ -1,7 +1,6 @@ --- title: "rclone serve ftp" description: "Serve remote:path over FTP." -groups: Filter versionIntroduced: v1.44 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/ftp/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_serve_http.md b/docs/content/commands/rclone_serve_http.md index ac52a7267..dc45363c2 100644 --- a/docs/content/commands/rclone_serve_http.md +++ b/docs/content/commands/rclone_serve_http.md @@ -1,7 +1,6 @@ --- title: "rclone serve http" description: "Serve the remote over HTTP." -groups: Filter versionIntroduced: v1.39 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/http/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_serve_nfs.md b/docs/content/commands/rclone_serve_nfs.md index 73e8d5ea0..6d3a264dc 100644 --- a/docs/content/commands/rclone_serve_nfs.md +++ b/docs/content/commands/rclone_serve_nfs.md @@ -1,7 +1,6 @@ --- title: "rclone serve nfs" description: "Serve the remote as an NFS mount" -groups: Filter status: Experimental versionIntroduced: v1.65 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/nfs/ and as part of making a release run "make commanddocs" diff --git a/docs/content/commands/rclone_serve_s3.md b/docs/content/commands/rclone_serve_s3.md index c55ffd6f7..89f769d07 100644 --- a/docs/content/commands/rclone_serve_s3.md +++ b/docs/content/commands/rclone_serve_s3.md @@ -1,7 +1,6 @@ --- title: "rclone serve s3" description: "Serve remote:path over s3." -groups: Filter status: Experimental versionIntroduced: v1.65 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/s3/ and as part of making a release run "make commanddocs" diff --git a/docs/content/commands/rclone_serve_sftp.md b/docs/content/commands/rclone_serve_sftp.md index 40acc461c..2dc502dd4 100644 --- a/docs/content/commands/rclone_serve_sftp.md +++ b/docs/content/commands/rclone_serve_sftp.md @@ -1,7 +1,6 @@ --- title: "rclone serve sftp" description: "Serve the remote over SFTP." -groups: Filter versionIntroduced: v1.48 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/sftp/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_serve_webdav.md b/docs/content/commands/rclone_serve_webdav.md index 15f60bf23..9ec439e7f 100644 --- a/docs/content/commands/rclone_serve_webdav.md +++ b/docs/content/commands/rclone_serve_webdav.md @@ -1,7 +1,6 @@ --- title: "rclone serve webdav" description: "Serve remote:path over WebDAV." -groups: Filter versionIntroduced: v1.39 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/serve/webdav/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_sha1sum.md b/docs/content/commands/rclone_sha1sum.md index b70f603a2..db05eb2fa 100644 --- a/docs/content/commands/rclone_sha1sum.md +++ b/docs/content/commands/rclone_sha1sum.md @@ -1,7 +1,6 @@ --- title: "rclone sha1sum" description: "Produces an sha1sum file for all the objects in the path." -groups: Filter,Listing versionIntroduced: v1.27 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/sha1sum/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_size.md b/docs/content/commands/rclone_size.md index f29b33129..c853316d9 100644 --- a/docs/content/commands/rclone_size.md +++ b/docs/content/commands/rclone_size.md @@ -1,7 +1,6 @@ --- title: "rclone size" description: "Prints the total size and number of objects in remote:path." -groups: Filter,Listing versionIntroduced: v1.23 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/size/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_sync.md b/docs/content/commands/rclone_sync.md index 68be15e3d..10da45199 100644 --- a/docs/content/commands/rclone_sync.md +++ b/docs/content/commands/rclone_sync.md @@ -1,7 +1,6 @@ --- title: "rclone sync" description: "Make source and dest identical, modifying destination only." -groups: Sync,Copy,Filter,Listing,Important # autogenerated - DO NOT EDIT, instead edit the source code in cmd/sync/ and as part of making a release run "make commanddocs" --- # rclone sync diff --git a/docs/content/commands/rclone_touch.md b/docs/content/commands/rclone_touch.md index b47ebd1bc..1368ad294 100644 --- a/docs/content/commands/rclone_touch.md +++ b/docs/content/commands/rclone_touch.md @@ -1,7 +1,6 @@ --- title: "rclone touch" description: "Create new file or change file modification time." -groups: Filter,Listing,Important versionIntroduced: v1.39 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/touch/ and as part of making a release run "make commanddocs" --- diff --git a/docs/content/commands/rclone_tree.md b/docs/content/commands/rclone_tree.md index eb891a448..43bb3a087 100644 --- a/docs/content/commands/rclone_tree.md +++ b/docs/content/commands/rclone_tree.md @@ -1,7 +1,6 @@ --- title: "rclone tree" description: "List the contents of the remote in a tree like fashion." -groups: Filter,Listing versionIntroduced: v1.38 # autogenerated - DO NOT EDIT, instead edit the source code in cmd/tree/ and as part of making a release run "make commanddocs" ---