From 35c47cd0e7361d5f4c19339a8143c74417d21402 Mon Sep 17 00:00:00 2001 From: Adam Spragg Date: Wed, 29 Jun 2022 12:43:15 +0100 Subject: doc: Generate the man page from markdown Because who wants to hand-write groff markup these days? This adds pandoc(1) as a build-dependency. The man page output isn't great, but it's the best I can do with standard markdown --- metastore.txt | 90 ----------------------------------------------------------- 1 file changed, 90 deletions(-) delete mode 100644 metastore.txt (limited to 'metastore.txt') diff --git a/metastore.txt b/metastore.txt deleted file mode 100644 index 7edb5a8..0000000 --- a/metastore.txt +++ /dev/null @@ -1,90 +0,0 @@ -metastore(1) General Commands Manual metastore(1) - - - -NAME - metastore - stores and restores filesystem metadata - -SYNOPSIS - metastore ACTION [OPTION...] [PATH...] - -DESCRIPTION - Stores or restores metadata (owner, group, permissions, xattrs and - optionally mtime) for a filesystem tree. This can be used to preserve - the metadata in situations where it is usually not stored (git and tar - for example) or as a tripwire like mechanism to detect any changes to - metadata. Note that e.g. SELinux stores its labels in xattrs so care - should be taken when applying stored metadata to make sure that system - security is not compromised. - -ACTIONS - -c, --compare - Shows the difference between the stored and real metadata. - - -s, --save - Saves the current metadata to ./.metadata or to the specified - file (see --file option below). - - -a, --apply - Attempts to apply the stored metadata to the file system. - - -d, --dump - Dumps stored (if no PATH is given) or real metadata (if PATH is - present, e.g. ./) in human-readable form. - - This action is meant only as a helpful debugging facility or - merge conflict helper. Do not ever compare its output generated - using different metastore version. Do not rely on current output - format (especially in batch scripts), because it may change in - future without prior notice. - - -h, --help - Prints a help message and exits. - -OPTIONS - -v, --verbose - Causes metastore to print more verbose messages. Can be repeated - more than once for even more verbosity. - - -q, --quiet - Causes metastore to print less verbose messages. Can be repeated - more than once for even less verbosity. - - -m, --mtime - Causes metastore to also take mtime into account for the compare - or apply actions. - - -e, --empty-dirs - Also attempts to recreate missing empty directories. May be use‐ - ful where empty directories are not tracked (e.g. by git or - cvs). Only works in combination with the apply option. - - -E, --remove-empty-dirs - Also attempts to remove empty directories missing from the meta‐ - data. May be useful where empty directories are not tracked - (e.g. by git or cvs). Only works in combination with the apply - option. - - -g, --git - Prevents metastore from omitting .git directories. - - -f , --file - Causes the metadata to be saved, read from the specified file - rather than ./.metadata. - -PATHS - If no path is specified, metastore will use the current directory as - the basis for the actions. This is the recommended way of executing - metastore. Alternatively, one or more paths can be specified and they - will each be examined. Later invocations should be made using the exact - same paths to ensure that the stored metadata is interpreted correctly. - -AUTHORS - metastore was created by David Härdeman in 2007-2008. Now it is main‐ - tained by Przemysław Pawełczyk. All source code contributors are - listed in the AUTHORS file. - - - - - January 2016 metastore(1) -- cgit v1.2.1