aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md32
-rw-r--r--lib/App/RunForPid.pm630
2 files changed, 26 insertions, 36 deletions
diff --git a/README.md b/README.md
index e76e338..c9e2e48 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,45 @@
NAME
====
-App::RunForPid - blah blah blah
+App::RunForPid - Given a X Window, attach a process for debug (gdb, tail, etc)
SYNOPSIS
========
-```perl6
-use App::RunForPid;
+```sh
+run-for-pid -h
+Usage:
+ ./bin/run-for-pid -- Find a pid for a window
+ ./bin/run-for-pid <pid> -- Execute a command for a child process of $pid
```
DESCRIPTION
===========
-App::RunForPid is ...
+App::RunForPid is a program to attach different tools to a given
+running process.
+
+The idea is to quickly attach or get information about that process
+only from the window that's running it. There's a fallback for
+background process with the `pid` parameter.
+
+DEPENDENCIES
+============
+
+* `xprop` — to get properties for a X Window
+* `pstree`
+
+OPTIONAL DEPENDENCIES
+---------------------
+
+* `gdb` — Attach a gdb to a given process
+* `strace` — Read stdout and stderr of a given process
+* `tail` — Keep logging a file
AUTHOR
======
-Matias Linares <matiaslina@gmail.com>
+Matias Linares <matiaslina@deprecated.org>
COPYRIGHT AND LICENSE
=====================
@@ -26,4 +47,3 @@ COPYRIGHT AND LICENSE
Copyright 2020 Matias Linares
This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
-
diff --git a/lib/App/RunForPid.pm6 b/lib/App/RunForPid.pm6
index 69c8c6a..7d45941 100644
--- a/lib/App/RunForPid.pm6
+++ b/lib/App/RunForPid.pm6
@@ -124,33 +124,3 @@ multi sub MAIN() is export {
multi sub MAIN(Int $pid) is export {
say "Running for $pid";
}
-
-=begin pod
-
-=head1 NAME
-
-App::RunForPid - blah blah blah
-
-=head1 SYNOPSIS
-
-=begin code :lang<perl6>
-
-use App::RunForPid;
-
-=end code
-
-=head1 DESCRIPTION
-
-App::RunForPid is ...
-
-=head1 AUTHOR
-
-Matias Linares <matiaslina@gmail.com>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2020 Matias Linares
-
-This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
-
-=end pod