Add documentation for some more commands

All interactive commands should now be documented in the info
documentation.
This commit is contained in:
Tom Willemsen 2012-08-03 23:31:07 +02:00
parent 469df11333
commit 030cf8bc05

View file

@ -144,18 +144,90 @@ Anywhere in the buffer, pressing @kbd{n} or @kbd{p} will move the
cursor to the next or previous article title respectively, and @kbd{N} cursor to the next or previous article title respectively, and @kbd{N}
and @kbd{P} will do the same, but move to feed headings. and @kbd{P} will do the same, but move to feed headings.
Explanations of all the related commands:
@deffn Command avandu-browse-article
Call @code{browse-url} to try and open the URL at point in your
preferred browser. This only works when the cursor is placed on an
article title.
In @code{avandu-list} this command gets bound to the @kbd{o} key in
the article title's keymap, so pressing @kbd{o} on any article title
will try and browse to it.
@end deffn
@deffn Command avandu-mark-article-read &optional button
Ask Tiny Tiny RSS to mark the article associated with BUTTON as read.
If BUTTON is omitted or @code{nil} it will try to use whatever is at
@code{point}.
In @code{avandu-list} this command gets bound to the @kbd{r} key in
the article title's keymap.
@end deffn
@deffn Command avandu-next-article
Search through the buffer for the next article header and move point
to it. This command wraps around the buffer, so when using it at the
end of the buffer it will return to the top.
In @code{avandu-list} this command gets bound to the @kbd{n} key in
the major-mode's keymap, so pressing @kbd{n} anywhere in the buffer
will go to the next article title.
@end deffn
@deffn Command avandu-previous-article
Exactly like @code{avandu-next-article} except it looks for the
previous article title.
In @code{avandu-list} this command gets bound to the @kbd{p} key in
the major-mode's keymap.
@end deffn
@deffn Command avandu-feed-catchup
Ask the Tiny Tiny RSS instance to catch this feed up, meaning it will
mark all the articles in it as read. This command doesn't check
which articles are being shown, it only sends the request to catch up
and which feed to do that with, so if you leave your buffer open for a
while you might mark articles you wish to read as read. This only
works when the cursor is placed on a feed title.
In @code{avandu-list} this command gets bound to the @kbd{c} key in
the feed title's keymap, so pressing @kbd{c} on any feed title will
try and catch up the feed.
@end deffn
@deffn Command avandu-next-feed
Exactly like @code{avandu-next-article} except it looks for the next
feed title.
In @code{avandu-list} this command gets bound to the @kbd{N} key in
the major-mode's keymap.
@end deffn
@deffn Command avandu-previous-feed
Exactly like @code{avandu-next-article} except it looks for the
previous feed title.
In @code{avandu-list} this command gets bound to the @kbd{P} key in
the major-mode's keymap.
@end deffn
@node Other commands, , Article overview, Usage @node Other commands, , Article overview, Usage
@section All the others @section All the others
There is also the possibility to see how many unread articles there Apart from viewing unread articles there are a number of other things
are and to manually login and logout of your Tiny Tiny RSS session, that can be done.
though logging in is done whenever necessary as well.
@deffn Command avandu-new-articles-count @deffn Command avandu-new-articles-count
Shows the total number of unread articles in Tiny Tiny RSS in the echo Shows the total number of unread articles in Tiny Tiny RSS in the echo
area. area.
@end deffn @end deffn
@deffn Command avandu-logged-in-p
Asks Tiny Tiny RSS if the user with the currently known session id is
still logged in.
@end deffn
@deffn Command avandu-login @deffn Command avandu-login
Log in to the Tiny Tiny RSS instance specified by the user (with Log in to the Tiny Tiny RSS instance specified by the user (with
@code{avandu-tt-rss-api-url}, @pxref{Configuration}), ask for the @code{avandu-tt-rss-api-url}, @pxref{Configuration}), ask for the