[eit] add "eit files" man page

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] <package> [<package> ...]
+
+
+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>*::
+    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)

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)
     

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: