From: gregor herrmann <gregoa@debian.org>
Date: Sun, 2 Jul 2006 11:17:19 +0000 (-0000)
Subject: * Add examples to manpage (closes: #374838).
X-Git-Tag: debian/1.1-6
X-Git-Url: http://git.toastfreeware.priv.at/debian/cpulimit.git/commitdiff_plain/7b6fd090fb61948fca4704fb7f872874fe202349

* Add examples to manpage (closes: #374838).
---

diff --git a/debian/changelog b/debian/changelog
index b5ad756..bb4442c 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,8 +1,9 @@
 cpulimit (1.1-6) unstable; urgency=low
 
   * Add Tony Mancill to Uploaders.
+  * Add examples to manpage (closes: #374838).
 
- -- gregor herrmann <gregor+debian@comodo.priv.at>  Fri, 16 Jun 2006 13:17:28 +0200
+ -- gregor herrmann <gregor+debian@comodo.priv.at>  Sun,  2 Jul 2006 13:16:54 +0200
 
 cpulimit (1.1-5) unstable; urgency=low
 
diff --git a/debian/cpulimit.8 b/debian/cpulimit.8
index eedc0ba..8e6dcf9 100644
--- a/debian/cpulimit.8
+++ b/debian/cpulimit.8
@@ -1,6 +1,6 @@
-.TH CPULIMIT "8" "April 2006" "cpulimit" "System Management"
+.TH CPULIMIT "8" "July 2006" "cpulimit" "System Management"
 .SH NAME
-cpulimit -- limits the cpu usage of a process
+cpulimit -- limits the CPU usage of a process
 .SH SYNOPSIS
 .B cpulimit
 \fITARGET \fR[\fIOPTIONS\fR...]
@@ -20,7 +20,7 @@ absolute path name of the executable program file
 \fIOPTIONS\fR
 .TP
 \fB\-l\fR, \fB\-\-limit\fR=\fIN\fR
-percentage of cpu allowed from 0 to 100 (mandatory)
+percentage of CPU allowed from 0 to 100 (mandatory)
 .TP
 \fB\-v\fR, \fB\-\-verbose\fR
 show control statistics
@@ -30,6 +30,20 @@ exit if there is no suitable target process, or if it dies
 .TP
 \fB\-h\fR, \fB\-\-help\fR
 display this help and exit
+.SH EXAMPLES
+Assuming you have started \fB`foo \-\-bar`\fR and you find out with \fItop\fR(1) or
+\fIps\fR(1) that this process uses all your CPU time you can either
+.TP
+\[sh] \fBcpulimit \-e foo \-l 50\fR
+limits the CPU usage of the process by acting on the executable program file
+(note: the argument "\-\-bar" is omitted)
+.TP
+\[sh] \fBcpulimit \-p 1234 \-l 50\fR
+limits the CPU usage of the process by acting on its PID, as shown by
+\fIps\fR(1)
+.TP
+\[sh] \fBcpulimit \-P /usr/bin/foo \-l 50\fR
+same as \fI\-e\fR but uses the absolute path name 
 .SH AUTHOR
 This manpage was written for the Debian project by gregor herrmann
 <gregor+debian@comodo.priv.at> but may be used by others.