If you have any questions or comments, please post a note on the
<a href="https://garage.maemo.org/forum/?group_id=2286">Pierogi forum boards</a>
or send a message to
-<a href="mailto:jpietrzak8@gmail.com">jpietrzak8@gmail.com</a>.
-Thank you for your understanding.
+<a href="mailto:jpietrzak8@gmail.com">jpietrzak8@gmail.com</a>. Also, a thread
+has been set up on
+<a href="http://talk.maemo.org/showthread.php?t=82243">talk.maemo.org</a>,
+containing a great deal of information.
</p>
+<h3>A note on licensing and such</h3>
+<p>
+I have placed Pierogi under the GNU General Public License, version 2.0 or
+later. (Here is a
+<a href="http://www.gnu.org/licenses/gpl-2.0.html">link</a> to the terms of
+that license.) In short, this places certain restrictions on how you can use
+the source code for this program (which you can find
+<a href="https://garage.maemo.org/plugins/ggit/browse.php/?p=pierogi">here</a>;
+if that link is not working for you, please send me a note). The program
+itself is free for use, in whatever manner you wish to use it.
+</p>
+
+<p>
+However, some kind folks have asked about donations, and I've decided I will
+go ahead and set up a Paypal donation site. Any funds received will be put
+towards the purchase of a second N900 I can devote fully towards development
+work. Thank you for your support!
+</p>
+
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
+<input type="hidden" name="cmd" value="_s-xclick">
+<input type="hidden" name="hosted_button_id" value="K697WUWYDLNJA">
+<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+</form>
+
<h1>Pierogi Documentation</h1>
<p>
"favorites" tab for quick access.
</p>
-<h3>Main Tab</h3>
+<h3>Main Window</h3>
+
+<h4>Main Tab</h4>
<img src="MainTab.png">
-<p>The Main tab contains just the power, volume, and channel buttons. It is
-intended to be a quick way to get to the most important, commonly used
+<p>The Main tab contains just the power, volume, mute, and channel buttons.
+It is intended to be a quick way to get to the most important, commonly used
controls. The name of the current keyset is also provided in this tab.</p>
-<h3>Utility Tab</h3>
+<h4>Utility Tab</h4>
<img src="UtilityTab.png">
<p>The Utility tab contains a selection of commonly useful controls, such as
-"Mute", "Sleep", "Input", "Closed Captions / Subtitles", and the color buttons.
+"Sleep", "Input", "Closed Captions / Subtitles", and the color buttons.
This tab is intended to be a quick way to reach the most frequently used
buttons; as such, the selection may be updated in future versions of Pierogi.
</p>
-<h3>Keypad Tab</h3>
+<h4>Keypad Tab</h4>
<img src="KeypadTab.png">
channels to be represented by just a single digit; pressing this should
allow you to enter a second digit.</p>
-<h3>Menu Tab</h3>
+<h4>Menu Tab</h4>
<img src="MenuTab.png">
on many modern devices; and "Disc Menu" is used to access the menu interface
provided with DVD and Blu-Ray media.</p>
-<h3>Media Tab</h3>
+<h4>Media Tab</h4>
<img src="MediaTab.png">
(often called rewind) and "Fast Forward". A variety of other less common
navigation controls are included, along with the "Eject" command.</p>
-<h3>Media2 Tab</h3>
-
-<img src="Media2Tab.png">
-
-<p>This is another page of media buttons, containing a mix of commands useful
-for DVD players, VCRs, audio devices, and possibly other devices. The content
-of this page may change in the future.</p>
-
-<h3>TV Tab</h3>
-
-<img src="TVTab.png">
-
-<p>This page contains several more TV-oriented buttons, including controls for
-picture-in-picture, teletext, and some graphics and audio controls. The
-content of this page is subject to change.</p>
-
-<h3>Favorite Tab</h3>
+<h4>Favorite Tab</h4>
<img src="FavoriteTab.png">
<p>A keyset can be removed from the list by selecting it and pressing
"Remove Selected Keyset".</p>
+<p>
+Also note that the volume control keys on the top left side of the N900 can
+also be used to step through the list of favorite keysets, no matter what tab
+you are currently on.
+</p>
+
<h3>Select Keyset Window</h3>
<img src="SelectKeysetWindow.png">
simply select it from the list, and close the window (by pressing the
return arrow at the top right of the screen).</p>
+<h3>Secondary Buttons Window</h3>
+
+<h4>TV Tab</h4>
+
+<img src="TVTab.png">
+
+<p>This page contains several more TV-oriented buttons, including controls for
+picture-in-picture, teletext, and some graphics and audio controls. The
+content of this page is subject to change.</p>
+
+<h4>Media2 Tab</h4>
+
+<img src="Media2Tab.png">
+
+<p>This is another page of media buttons, containing a mix of commands useful
+for DVD players, VCRs, audio devices, and possibly other devices. The content
+of this page may change in the future.</p>
+
+<h4>Input Tab</h4>
+
+<img src="InputTab.png">
+
+<p>
+Many devices have multiple sources for their data, whether it be television
+signals piped in over the air or through a cable, or audio from a variety of
+stereo components. It is unlikely that Pierogi will ever be able to list all
+of the various possible input buttons, but this tab contains a few of them.
+</p>
+
+<h4>Adjust Tab</h4>
+
+<img src="AdjustTab.png">
+
+<p>
+A handful of the various audio and video adjustment buttons are placed on
+this tab. Actual volume controls will likely remain on the main window,
+however.
+</p>
+
<h2>Design Rationale</h2>
<p>Here I collect my thoughts on the how and why of creating Pierogi.</p>
projects / pierogi / blobdiff