Python Gutenberg E-text Project

---

1. Introduction

PyGERS is a free cross-platform program for reading e-texts from Project Gutenberg. Users interact with the program through its graphical interface. This and accompanying documentation sections explain how various operations can be performed with the various controls found in PyGERS.

1.1. Notations

For this and all accompanying documentation sections for PyGERS, the following notational conventions will be observed.

1.1.1. Menu commands

Menu commands are invoked by selecting menu items from the menubar located at the top of application window. Menu items may be hierarchically arranged, with submenus under each menu item. Menu items may be selected by left clicking on an item with the mouse, or entering an optional keyboard accelerator key combination on the keyboard.

The top level menu commands are shown on the menubar. In PyGERS, the top level menu commands are: File, Edit, View, and Help. An example view of a PyGERS menubar is shown in the figure below.

Menu commands will be shown in this documentation as an italicized path, representing a series of menu commands. An example menu path is File->Save, representing the sequential selection of the File menu item from the menubar and the Save menu item from a submenu that appears underneath File when it is active.

1.1.2. Button commands

Buttons are another common graphical control used in PyGERS. They are activated by moving the mouse cursor on top and clicking with the left mouse button.

Button controls will be shown in this documentation as dark text inside a gray box. An example button illustration is OK, representing a button often used for continuing an operation.

1.2. Basic Operations

This section describes the bare essential commands for starting and stopping the program; along with calling up help to explain how to perform other, more interesting, things.

1.2.1. Starting

PyGERS may be started in a variety of ways, depending on what is customary for other applications on the machine it is installed on and specific installation options. Common methods could include clicking on a desktop icon, picking from a Start program list, clicking on the executable file name within a file browser, or entering the executable path on a command line.

1.2.2. Stopping

Invoking the File->Exit menu command will halt the program and close its application window.

1.2.3. Help

Invoking the Help->Contents menu command will result in the display of a help viewing window containing usage documentation for the program.

1.2.4. About

Invoking the Help->About menu command will result in the display of a small informative message box containing a brief description of the program.