Update docs

This commit is contained in:
Tom Willemsen 2012-08-23 00:05:12 +02:00
parent a9d0b80d81
commit bc17d87497

View file

@ -84,6 +84,12 @@ complete url to the api, for example
avandu won't be able to do anything. avandu won't be able to do anything.
@end defopt @end defopt
Other than this, it is possible, but unnecessary to set the following
variables. These are unnecessary because Avandu also supports the use
of @ref{Top,Auth-source,Aut-source,auth,Auth-source}, which supersedes
these variables. When using auth source be sure to use the
@code{avandu-tt-rss-api-url} as the @code{machine} value.
@defopt avandu-user @defopt avandu-user
This option should contain a string. It is the username that is used This option should contain a string. It is the username that is used
to log in to your Tiny Tiny RSS instance. If it is @code{nil} it will to log in to your Tiny Tiny RSS instance. If it is @code{nil} it will
@ -91,9 +97,6 @@ get asked for when avandu tries to connect, and once a succesful
connection has been made it will remember it until you log out. connection has been made it will remember it until you log out.
@end defopt @end defopt
Other than this, it is possible, but unnecessary to set the following
variables.
@defvar avandu-password @defvar avandu-password
The password to use to log in to your Tiny Tiny RSS instance. This The password to use to log in to your Tiny Tiny RSS instance. This
option shouldn't really be set, it is mostly used to remember the option shouldn't really be set, it is mostly used to remember the
@ -115,10 +118,11 @@ unread articles there are.
@menu @menu
* Article overview:: A list of all unread articles * Article overview:: A list of all unread articles
* Article view:: One or more articles in a buffer
* Other commands:: Anything else * Other commands:: Anything else
@end menu @end menu
@node Article overview, Other commands, Usage, Usage @node Article overview, Article view, Usage, Usage
@section Viewing unread articles @section Viewing unread articles
The avandu overview lets you see a list of all the unread articles in The avandu overview lets you see a list of all the unread articles in
@ -214,7 +218,55 @@ In @code{avandu-overview} this command gets bound to the @kbd{P} key
in the major-mode's keymap. in the major-mode's keymap.
@end deffn @end deffn
@node Other commands, , Article overview, Usage @node Article view, Other commands, Article overview, Usage
@section Viewing one or more articles
The avandu article view lets you read one or more articles with all
their content.
@deffn Command avandu-view-article id
Shows one or more articles with their content, possibly with its
content rendered by an external application, emacs' w3m mode or
anything you can think of/write yourself.
Although there is no real obstacle to calling this command yourself,
you will need an article id number, these are collected automatically
when using @ref{Article overview}.
@end deffn
In order to have the articles rendered at all you would need to set
@code{avandu-article-render-function}.
@defopt avandu-article-render-function
This setting should point to a function that takes two arguments, the
start and end of the region to render.
@end defopt
Two functions come with Avandu to enable rendering.
@defun avandu-view-possibly-external start end
Call a shell command on the region between @var{start} and @var{end}.
Which shell command should be called should be specified in
@code{avandu-html2text-command}.
@end defun
@defopt avandu-html2text-command
A string with a shell command. This command will be called by
@code{avandu-view-possibly-external} to render the region given to
it. One example could be:
@example
w3m -dump -T text/HTML -cols 72
@end example
@end defopt
@defun avandu-view-w3m
This function requires the @code{w3m} module for emacs. It sends the
region on to @code{w3m-region} and then start @code{w3m-minor-mode} to
give it the usual w3m viewing commands.
@end defun
@node Other commands, , Article view, Usage
@section All the others @section All the others
Apart from viewing unread articles there are a number of other things Apart from viewing unread articles there are a number of other things