Shopper: slightly improve plugin and manual

* improve manual (hopefully fixes fs#11988). Parts of the
  description are taken from fs#10820.
* move ACTION_STD_CONTEXT from alternate select to alternate
  menu action, as not all targets have ACTION_STD_MENU
* add menu entries for "Quit" and "Quit without saving"

Change-Id: Iec86a1608756a899f9f9d7ec7d479838dfd1d95f
This commit is contained in:
Sebastian Leonhardt 2015-07-14 01:52:56 +02:00 committed by Gerrit Rockbox
parent 399904a916
commit 59928e6cf5
2 changed files with 82 additions and 4 deletions

View file

@ -320,13 +320,13 @@ enum plugin_status plugin_start(const void* parameter)
continue;
switch (button)
{
case ACTION_STD_CONTEXT:
case ACTION_STD_OK:
{
changed |= toggle(cur_sel);
break;
}
case ACTION_STD_MENU:
case ACTION_STD_CONTEXT:
{
switch(view)
{
@ -338,7 +338,9 @@ enum plugin_status plugin_start(const void* parameter)
"Mark all items",
category_string,
"Revert to saved",
"Show Playback Menu",);
"Show Playback Menu",
"Quit without saving",
"Quit");
switch (rb->do_menu(&menu, NULL, NULL, false))
{
@ -394,6 +396,20 @@ enum plugin_status plugin_start(const void* parameter)
playback_control(NULL);
break;
}
case 6:
{
/* Quit without saving */
exit = 1;
break;
}
case 7:
{
/* Save and quit */
if (changed)
save_changes();
exit = 1;
break;
}
default:
{
break;
@ -409,7 +425,9 @@ enum plugin_status plugin_start(const void* parameter)
"Reset list",
category_string,
"Revert to saved",
"Show Playback Menu",);
"Show Playback Menu",
"Quit without saving",
"Quit");
switch (rb->do_menu(&menu, NULL, NULL, false))
{
@ -454,6 +472,20 @@ enum plugin_status plugin_start(const void* parameter)
playback_control(NULL);
break;
}
case 5:
{
/* Quit without saving */
exit = 1;
break;
}
case 6:
{
/* Save and quit */
if (changed)
save_changes();
exit = 1;
break;
}
default:
{
break;

View file

@ -2,4 +2,50 @@
\subsection{Shopper}
\label{ref:Shopperplugin}
Shopper is a shopping list plugin which allows you to maintain reusable shopping lists.
Shopper is a plugin which allows you to maintain reusable shopping lists.
To create a list, use a text editor to write down a list of items (one per
line; note that the line length should not exceed 40 characters) and save the
file as \fname{<name>.shopper}. If you want to separate the items you can do
so by creating categories, which are prepended with `\#'. To open a
\fname{.shopper} file just ``play'' it from the file browser.
\begin{example}
#groceries
bananas
cucumber
4 apples
6 apples
#dairy
milk
cheese
\end{example}
Note that it isn't possible to choose exact quantities, but you can create a
number of entries with different quantities in the name of the item, such as
for the apples in the above example.
There are two modes, \emph{edit mode} and \emph{view mode}. The edit mode
shows all the items, and it allows you to select which of the items you want
to buy. When you have finished selecting the items, use the menu to go to the
view mode, and you will see only the items you wish to buy. If you `select'
an item in view mode then that item will be removed from the list.
When you exit Shopper the last view is saved, including which items you have
selected, so if you re-open the shopping list it will be as you left it. There
are additional menu options for clearing the list, selecting all items, showing
and hiding the categories, toggling the categories, and displaying the playback
menu.
\subsubsection{Shopper Keys}
\begin{btnmap}
\ActionStdOk{}
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdOk}
& Select or clear an item\\
\ActionStdMenu{} or \ActionStdContext{}
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdMenu{} or \ActionRCStdContext}
& Show menu\\
\ActionStdCancel{}
\opt{HAVEREMOTEKEYMAP}{& \ActionRCStdCancel}
& Exit\\
\end{btnmap}