From: Greg Kroah-Hartman <gregkh@suse.de>
Date: Tue, 24 Mar 2009 04:59:54 +0000 (-0700)
Subject: document the --page option
X-Git-Url: https://git.toastfreeware.priv.at/gregoa/bti.git/commitdiff_plain/a3654df61ff3f43becf83ac667e21b842c0c12c6

document the --page option
---

diff --git a/bti.1 b/bti.1
index fbe6e38..13fbeac 100644
--- a/bti.1
+++ b/bti.1
@@ -171,7 +171,7 @@ bti \- send a tweet to twitter\&.com or identi\&.ca from the command line
 .SH "Synopsis"
 .fam C
 .HP \w'\fBbti\fR\ 'u
-\fBbti\fR [\fB\-\-account\ account\fR] [\fB\-\-password\ password\fR] [\fB\-\-action\ action\fR] [\fB\-\-user\ screenname\fR] [\fB\-\-host\ HOST_NAME\fR] [\fB\-\-proxy\ PROXY:PORT\fR] [\fB\-\-logfile\ LOGFILE\fR] [\fB\-\-bash\fR] [\fB\-\-shrink\-urls\fR] [\fB\-\-debug\fR] [\fB\-\-dry\-run\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
+\fBbti\fR [\fB\-\-account\ account\fR] [\fB\-\-password\ password\fR] [\fB\-\-action\ action\fR] [\fB\-\-user\ screenname\fR] [\fB\-\-host\ HOST_NAME\fR] [\fB\-\-proxy\ PROXY:PORT\fR] [\fB\-\-logfile\ LOGFILE\fR] [\fB\-\-page\ PAGENUM\fR] [\fB\-\-bash\fR] [\fB\-\-shrink\-urls\fR] [\fB\-\-debug\fR] [\fB\-\-dry\-run\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
 .fam
 .SH "DESCRIPTION"
 .PP
@@ -229,6 +229,11 @@ Currently, only http://2tu\&.us/ is used as a URL shrinking service\&.
 Print a whole bunch of debugging messages to stdout\&.
 .RE
 .PP
+\fB\-\-page PAGENUMBER\fR
+.RS 4
+When the action is to retrieve updates, it usually retrieves only one page\&. If this option is used, the page number can be specified\&.
+.RE
+.PP
 \fB\-\-dry\-run\fR
 .RS 4
 Performs all steps that would normally be done for a given action, but will not connect to the service to post or retrieve data\&.
diff --git a/bti.c b/bti.c
index d0b8054..6fffef5 100644
--- a/bti.c
+++ b/bti.c
@@ -103,6 +103,7 @@ static void display_help(void)
 	fprintf(stdout, "  --host HOST\n");
 	fprintf(stdout, "  --logfile logfile\n");
 	fprintf(stdout, "  --shrink-urls\n");
+	fprintf(stdout, "  --page PAGENUMBER\n");
 	fprintf(stdout, "  --bash\n");
 	fprintf(stdout, "  --debug\n");
 	fprintf(stdout, "  --version\n");
diff --git a/bti.xml b/bti.xml
index 3b097d0..cfd0b1e 100644
--- a/bti.xml
+++ b/bti.xml
@@ -33,6 +33,7 @@
           <arg><option>--host HOST_NAME</option></arg>
           <arg><option>--proxy PROXY:PORT</option></arg>
           <arg><option>--logfile LOGFILE</option></arg>
+          <arg><option>--page PAGENUMBER</option></arg>
           <arg><option>--bash</option></arg>
           <arg><option>--shrink-urls</option></arg>
           <arg><option>--debug</option></arg>
@@ -142,6 +143,16 @@
               <para>Print a whole bunch of debugging messages to stdout.</para>
             </listitem>
           </varlistentry>
+          <varlistentry>
+            <term><option>--page PAGENUMBER</option></term>
+            <listitem>
+              <para>
+		When the action is to retrieve updates, it usually retrieves
+		only one page.  If this option is used, the page number can be
+		specified.
+              </para>
+            </listitem>
+          </varlistentry>
           <varlistentry>
             <term><option>--dry-run</option></term>
             <listitem>