diff --git a/server/doc/mansrc/eit-files.1.txt b/server/doc/mansrc/eit-files.1.txt new file mode 100644 index 000000000..d5c0da4d7 --- /dev/null +++ b/server/doc/mansrc/eit-files.1.txt @@ -0,0 +1,63 @@ +eit-files(1) +============ +:man source: eit {eitversion} +:man manual: eit {eitversion} + + +NAME +---- +eit-files - show files owned by packages + + +SYNOPSIS +-------- +eit files [-h] [--quiet] [ ...] + + +INTRODUCTION +------------ +List files owned by given package dependencies. The same, are matched against +the repositories. +For example: *>=app-foo/bar-1.2.3::repo* is asking the *bar* package, which +version at least *1.2.3*, available inside the *repo* repository. +If you want to do the inverse operation (matching a file searching for +package owners), please use *eit own*. + + + +OPTIONS +------- +"eit files" supports the following options which alters its behaviour. + + +POSITIONAL ARGUMENTS +~~~~~~~~~~~~~~~~~~~~ +**:: + package names + +OPTIONAL ARGUMENTS +~~~~~~~~~~~~~~~~~~ +*--help*:: + show this help message and exit + +*-q*:: + quiet output, for scripting purposes + + + +AUTHORS +------- +Eit has been accidentally prototyped during a rainy Sunday by Fabio +Erculiani who was looking for innovative ways of handling package +bumps in Sabayon Entropy repositories. +A few months later, Eit saw the light. + + +REPORTING BUGS +-------------- +Report bugs to https://bugs.sabayon.org or directly to the author at +lxnay@sabayon.org. + +SEE ALSO +-------- + eit(1), eit-own(1) diff --git a/server/doc/mansrc/eit.1.txt b/server/doc/mansrc/eit.1.txt index ea92072d4..c38f56424 100644 --- a/server/doc/mansrc/eit.1.txt +++ b/server/doc/mansrc/eit.1.txt @@ -162,6 +162,6 @@ lxnay@sabayon.org. SEE ALSO -------- eit-add(1), eit-branch(1), eit-bump(1), eit-checkout(1), eit-cleanup(1) - eit-commit(1), eit-cp(1), eit-log(1), eit-mv(1), eit-notice(1) - eit-repack(1) + eit-commit(1), eit-cp(1), eit-files(1), eit-log(1), eit-mv(1) + eit-notice(1), eit-repack(1) diff --git a/server/eit/commands/files.py b/server/eit/commands/files.py index 4c79ed376..78cbfdaaf 100644 --- a/server/eit/commands/files.py +++ b/server/eit/commands/files.py @@ -50,6 +50,22 @@ class EitFiles(EitCommand): return parser + INTRODUCTION = """\ +List files owned by given package dependencies. The same, are matched against +the repositories. +For example: *>=app-foo/bar-1.2.3::repo* is asking the *bar* package, which +version at least *1.2.3*, available inside the *repo* repository. +If you want to do the inverse operation (matching a file searching for +package owners), please use *eit own*. +""" + SEE_ALSO = "eit-own(1)" + + def man(self): + """ + Overridden from EitCommand. + """ + return self._man() + def parse(self): parser = self._get_parser() try: