| # BottomFeeder User's Guide Version 4.4 July 1, 2007

© 2007, Richard A. Demers | Contents

| ## Contents

Introduction | |- Notice | |- Related Documents | |- New Features | |- Credits | BottomFeeder |- Main Window | |- Views | | |- Tree View | | |- Item List View | | |- Item Zoom View | | |- Newspaper View | |- Panes | | |- Tree Pane | | | |- Tree Icons | | | |- Folders | | | |- Feeds | | |- Item List Pane | | |- Item Pane | | |- Status Line | |- Main Menu | | |- File Menu | | |- System Menu | | |- Browse Menu | | |- Stylesheets Menu | | |- Feeds Menu | | |- Items Menu | | | |- Network Menu | | |- View Menu | | |- Plugins Menu | | |- Help Menu | |- Toolbars | | |- Main Toolbar | | |- Item Toolbar | |- Keyboard Shortcuts | | |- Tree Pane Shortcuts | | |- Item List Pane Shortcuts | | |- Item Pane Shortcuts | | |- Other Shortcuts |- Auxiliary Windows | |- About | |- Add Feed | |- Amazon Feed Builder | |- BottomFeeder Search | |- Bug Report | |- Comment Poster | | |- File Menu | | |- View Menu | | |- Help Menu | | |- Toolbar | |- Del.icio.us Tagger | |- Enclosure Manager | |- Enclosure Manager Settings | |- Exception | |- Feed Auto-Discovery | | |- Feed Maintenance | |- Feed Properties | |- Filter Definitions | |- Internet Feed Builder | |- Internet Search | |- Item Properties | |- Named Font Selector | |- News Feed Builder | |- Restore Host File | |- Runtime Errors Report | |- Save to Host File | |- Search Wizard | |- Settings Window | | |- Browsing Settings | | |- Caching Settings | | |- Del.Icio.Us Settings | | |- Feed Settings | | |- Memory Settings | | |- Network Settings | | |- Newspaper Settings | | |- Unix/Linux Settings | | |- User Interface Settings | | |- User Settings | |- Slim Mode | |- Tear Off | |- Upgrade Manager | |- Workspace (continued)

#### Contents (continued)

Blogging |- Blog Poster Window | |- Menus | | |- File | | |- Post | | |- Settings | | |- Site | | |- View | | |- Help | |- Toolbar |- Auxiliary Windows | |- About | |- Blogroll Editor | | |- Enclosure Editor | |- File Upload Editor | |- Open Draft | |- Open Item | |- Select CSS Style | |- Settings | | |- Basic | | |- Blogger | | |- CST | | |- Meta Weblog | | |- Movable Type | | |- Network | |- Technorati Tags | |- Trackback Request Editor | | Browsing |- Browsing Window | |- Menus | | |- File | | |- View | Editing | Editing Pane | |- Wiki-style Markups | |- WYSIWYG Toolbar | |- Checking Your Spelling

Contents

| ## Introduction

Congratulations on selecting BottomFeeder as your Internet aggregator. It's a great way to keep up with whatever is happening in rapidly changing websites that publish feeds. BottomFeeder is more than "yet another RSS reader;" it is a tool to help you make the Internet better serve your needs. If you are familiar with Internet browsers and e-mail readers, you will be right at home with BottomFeeder.

Oh, if you're curious about the name BottomFeeder, think about what bottom feeders, like crabs, eat - whatever falls to the bottom of the sea from all the fish swimming above them. Not a pretty picture, but they sure taste good!

Contents

### Notice

BottomFeeder has been released as an Open Source program, under the Artistic License. When you download it, you agree to abide by this license.

Contents

### Related Documents

The following documents are available to help you get the most benefit from BottomFeeder:

- Quick Start Guide -- a brief introduction to BottomFeeder for new users.
- Tutorial -- explains why you need a tool like BottomFeeder, and helps you learn how to do specific tasks using BottomFeeder.
- Technology Guide -- provides detailed technical information about BottomFeeder.

Contents

### New Features

The major changes in BottomFeeder version 4.4 from version 4.3 are the following:

1. LibTidy, which corrects coding errors in feed items, can now be turned on or off at the feed level. If LibTidy seems to damage the items of a given feed, you can disable it for that feed. (Select `Feed Properties` in the feed's popup menu.)
2. When you update from version 4.3 to 4.4, you may well see duplicate items for the first few days. The way BottomFeeder assigns item identifiers (guids) when a feed doesn't have them has been changed to fix a persistent problem. The duplicates will go away over time, but if you want to eliminate duplicate items for a specific feed right away, you can regenerate the feed (Select `Update > Regenerate Feed` in the feed's popup menu).
3. The BottomFeeder `Settings Window` has been simplified. A lot of the settings were confusing and rarely used, and really did not belong in a user interface. However, these options still exist, and can be changed via the BottomFeeder initialization file.
4. When defining filters, you can now define them as positive (to include matches and exclude non matches) or negative (to exclude matches and keep all else). See the `Use to filter out` check box in the `Filter Definitions Window`.
5. A `Show persistent items` option has been added to the `View Menu`. This option allows you to easily view all items in all feeds that you previously marked as being persistent.
6. Seldom used options were removed from the `Main Window` menus and toolbar.
7. Options were removed from the `Item List` and `Item` popup menus corresponding tools were added to a new items toolbar above the `Item List` pane.

Contents

### Credits

- Cincom VisualWorks Smalltalk is a super-productive and elegant programming language, development environment and tool set for rapidly producing reliable software. Smalltalk makes it possible for small teams to quickly explore new ideas and build high quality open-source products like BottomFeeder.
- James Robertson, the Cincom, Inc. Smalltalk product manager, works with sales, engineering, and marketing to drive the direction of the VisualWorks and ObjectStudio products. He is responsible for initiating the BottomFeeder project and for much of the coding of BottomFeeder.
- Dave Murphy, a Smalltalk programmer, is responsible for the XML parsing, the identification of feed types, and the graphical user interfaces of BottomFeeder.
- Holger Kleinsorgen, a Smalltalk programmer, is responsible for the TwoFlower browser. This Smalltalk program was used in earlier versions of BottomFeeder to display HTML web pages.
- Michael Lucas-Smith, a Smalltalk programmer, is responsible for the WithStyle browser. This Smalltalk program is now used by BottomFeeder to display HTML web pages.
- Rich Demers, a software architect and occasional Smalltalk programmer, is responsible for writing BottomFeeder documents, for minor bits of coding, and for lots of usability testing.
- Denis Johson provided new logo artwork.
- Martin Kobetic, Bob Westergaard, Michael Lucas-Smith, Troy Brumley, Mark Derricutt, Eric Winger, and many others have helped with code, suggestions, and testing.

Contents

| ## BottomFeeder Main Window

### Main Window Views

When you start BottomFeeder, you see the `Main` window. The actual appearance of the Main window depends on what you are doing. BottomFeeder shows you one of four different views:

- A Tree View.
- An Item List View.
- An Item Zoom View.
- A Newspaper View.

Contents

#### Tree View

The Tree View shows a tree of folders and their feeds in the left pane, a table of items from a selected folder or feed at top-right, and selected items at bottom-right.

To see this view, select the `View > Show all items` command.

###### Window Controls

- `Main Menu` - menus of commands to BottomFeeder.
- `Main Toolbar` - displays the icons of frequently used commands to BottomFeeder.
- `Tree` pane - a tree view of your folders and their contents.
- `Item Toolbar` - displays the icons of commands for working with the item displayed in the current tab page of the `Item` pane.
- `Item List` pane - displays the date, title and category of items from the folder or feed selected in the `Tree` pane.
- `Item` pane - displays the contents of the items selected the `Item List` pane. Each tabbed page contains a description of an item, but it may be a link to a web page, or even the complete item. If it is a link and you click it, a separate browser window opens to show you the linked web page.
- `Status` output area - displays the current status of BottomFeeder operations.

Contents

#### Item List View

The Item List View shows a table of items at top and selected items at the bottom. This view is used to show all items in all feeds that meet a specific criteria.

To see this view, select:

- The `View > Show new items` command.
- The `View > Show alerts` command.
- The `View > Show flagged` command.
- The `View > Show permanent` command.
- The `View > Show hidden` command.
- The `View > Show related items` command.
- The `Items > Search BottomFeeder` command.

###### Window Controls

- `Main Menu` - menus of commands to BottomFeeder.
- `Main Toolbar` - displays the icons of frequently used commands to BottomFeeder.
- `Item Toolbar` - displays the icons of commands for working with the item displayed in the current tab page of the `Item` pane.
- `Item List` pane - displays the feed title and the date, title and category of items from one or more feeds.
- `Item` pane - displays the contents of selected items in tabbed pages. Each tabbed page contains a description of an item, but it may be a link to a web page, or even the complete item. If it is a link and you click it, a separate browser window opens to show you the linked web page.
- `Status` output area - displays the current status of BottomFeeder operations.

Contents

#### Item Zoom View

This view expands the `Item` pane to include the entire view area. This provides more area for viewing the contents of items.

To obtain a zoomed view, use the `Toggle zoom` item tool. You can also use the `ctrl-n` and `ctrl-p` shortcut keys to go to the next or previous new item.

###### Window Controls

- `Main Menu` - menus of commands to BottomFeeder.
- `Main Toolbar` - displays the icons of frequently used commands to BottomFeeder.
- `Tree` pane - a tree view of your folders and their contents.
- `Item Toolbar` - displays the icons of commands for working with the item displayed in the current tab page of the `Item` pane.
- `Item` pane - displays the contents of the selected item; a description of the item, a link to a web page, or even the complete item. If it is a link and you click it, a separate browser window opens to show you the linked web page.
- `Status` output area - displays the current status of BottomFeeder operations.

Contents

#### Newspaper View

This view shows a newspaper-like summary of multiple items from one or more feeds. The advantage of using this view is that you only have to scroll down to see additional items; you don't have to individually select items from a list. If you subscribe to a lot of feeds, this can be a real convenience.

To obtain a newspaper view, select a feed or folder in the `Tree` pane, and BottomFeeder shows you its new items; or if there are no new items, it shows the top five items (new or old) instead.

For each item, the newspaper view shows:

- The title, date and category of the item.
- A link to the full story. Click it to launch a browser on the full item.
- A summary of the Item.

###### Window Controls

- `Main Menu` - menus of commands to BottomFeeder.
- `Main Toolbar` - displays the icons of frequently used commands to BottomFeeder.
- `Tree` pane - a tree view of your folders and their contents.
- `Item Toolbar` - displays the icons of commands for working with the item displayed in the current tab page of the `Item` pane. This toolbar is disabled because there is no way to select an item in the newspaper view.
- `Item` pane - displays the contents of the items of the selected feed or folder.
- `Status` output area - displays the current status of BottomFeeder operations.

Contents

### Main Window Panes

Contents

#### The Tree Pane

The Tree pane provides a hierarchical view of your folders and the feeds they contain. The root of the tree is the `My Feeds` folder. All of your feeds are contained in this folder or in one of its sub-folders, including:

- The feeds from various web sites to which you subscribe. BottomFeeder automatically updates these feeds every N minutes. N defaults to 60 minutes; to change it, go to the `Settings - Network` window and change the `Update frequency` setting.
- The feeds produced by "build feed" requests you perform on Internet web sites such as Feedster and Google. BottomFeeder rebuilds these feeds as part of its feed update cycle.
- The feeds produced by searches you perform on the items in your subscribed feeds. BottomFeeder updates these feeds from the current content of your subscribed feeds whenever you select the feed.

Contents

##### Tree Icons

Tree objects are displayed with the following icons:

BottomFeeder helps you to keep track of which feeds have new items that you have not yet read. In the `Tree` pane, it displays a Red Feed Icon or a Red Bell Feed Icon for feeds with new items, and in the `Item List` pane, it displays the titles of new items in bold red text.

Clicking on an item in the `Item List` pane tells BottomFeeder that you have read it; that it is to be considered old. BottomFeeder immediately changes its title to normal black text. When all items of a feed are old, BottomFeeder displays a Blue Feed Icon or a Blue Bell Feed Icon for the feed.

You can tell BottomFeeder that all items of a feed are old. In the `Tree` pane, select the feed and click the `Mark feed > Mark all feed items old` command of its popup menu. You can also select an item and click the `Mark all feed items old` tool. If you decide you want the item to contine to be identified as new, click the `Mark item as new` tool.

BottomFeeder changes the color of a feed's icon according to the following rules:

- It shows a red icon for a feed with any new items.
- It shows a red icon for a feed that is newly loaded from its website.
- It shows a blue icon for a feed with no new items - all old items.
- It changes the color of a feed icon as soon as the new/old status of the items in the feed changes - any new (red) or all old (blue).
- It shows a black icon for a feed that has not been updated by its website for more than N days. N defaults to 30 days; to change it, go to the `Settings - Feeds` window, checkmark the `Keep track of feeds without updates?` setting, and change the `Days to mark a feed bad` setting.
- It shows a black icon for a feed if you select the `Mark feed >Mark Feed Inactive` feed popup menu option.

You can ask BottomFeeder to alert you to the arrival of new items in a subscribed feed. Select the feed and click the `Alerts > Add Feed Alert` command of its popup menu. BottomFeeder changes the feed's icon to a Red Bell Feed Icon or a Blue Bell Feed Icon. When feeds are updated by new items, and there is an alert on at least one of them, BottomFeeder enables the `View > Show Alerts` command and the `View All Alerts` tool.

Contents

##### Folders

A folder is a named collection of sub-folders and feeds. You can create folders in a folder to organize your feeds. For example, you can put all of your Genealogy feeds in one folder and all of your Star Trek feeds in another.

Following the name of each folder is a pair of numbers in parentheses, for example; "(3/43)". The first number is the number of feeds in the folder with new content, and the second number is the total number of feeds in the folder. You can tell if there is anything in a folder by looking at these numbers.

With your mouse, you can do the following with folders:

- You can expand or collapse a folder by clicking the + or - icon.
- You can move a folder to a different folder in the tree by drag-and-drop.
- You can left-click the folder to select it. BottomFeeder presents all items of all feeds in the folder in the `Item List` pane.

Contents

###### Folder Popup Menus

When you right-click a folder in the tree, the following menu pops up:

Contents

##### Feeds

With your mouse, you can do the following with a feed:

- You can select a feed by clicking it. BottomFeeder displays the feed title in the window header and in the current tab of the `Item` pane, and it presents the items of the feed in the `Item List` pane.
- You can browse the home page of the website that generates the feed by double-clicking the feed. BottomFeeder opens a separate browser window.
- You can move a feed to a different folder in the tree by drag-and-drop.

Contents

###### Feed Popup Menu

When you right-click a feed, the following menu pops up:

Contents

#### Item List Pane

When you select a feed in the `Tree` view, BottomFeeder presents the items in the feed in the `Item List` pane of the `Main` window. The `Item List` pane is a table of item dates, item titles and item categories. You can sort items in ascending or descending sequence by any column - just toggle the header bars above each column.

When BottomFeeder presents a `Item List` view, the name of the feed that contains each item is presented in a feed title column of the table.

BottomFeeder helps you to keep track of the items you have already read. If an item is new, BottomFeeder displays it in bold red text. When you select the item, BottomFeeder considers it to be old and displays it in normal black text.

When you right-click an item, the following menu pops up:

Contents

#### Item Pane

When you select an item in the `Item List` pane, BottomFeeder presents the item in the current tab page of the bottom-right pane of the `Main` window. Often this is a description of the item, but it may be a link to a web page, or even the complete item. If it is a link and you click it, a separate browser window opens to show you the linked web page.

###### Pane Controls

`Item` tabs - BottomFeeder presents items in tabbed pages. The label of each tab is the name of the item's feed. You can have as many tabbed pages as you want, but only one of them is highighted as the current page. When you right-click within a tab, the following pop-up menu is presented:

`Item` pages - BottomFeeder present items in tab pages. When you right-click within an item, the following pop-up menu is presented:

Contents

#### The Status Line

BottomFeeder tells you its operational status in the bottom line of the `Main` window. Between the times that it is updating the feeds, it tells you how many minutes until the next update. During updates, it tells you which feed is being updated and what percent of the updates are done. In the status area, you can find and select text, and copy text to the clipboard through its popup menu.

Contents

#### Main Menu

##### File Menu

Contents

##### System Menu

Contents

##### Browse Menu

Contents

##### Stylesheets Menu

Contents

##### Feeds Menu

Contents

##### Items Menu

Contents

##### Network Menu

Contents

##### View Menu

Contents

##### Plugins Menu

Contents

##### Help Menu

Contents

### Toolbars

Toolbars are collections of icons that each represent a command to BottomFeeder. Typically, they are provided only for frequently used commands.

Contents

#### Main Toolbar

The Main Toolbar is located below the Main Menu. It provides single-click execution of a number of frequently used BottomFeeder tools. All of these tools are also available through the Main Menu or through one or more popup menus. Toolbar icons are enabled only when they can be validly used; for example, when a feed has been selected.

Tool Icon | Action
--- | ---
| Toggle between the full BottomFeeder `Main` window and the `Ticker` window.
| Add a new feed to the selected folder.
| Check for upgrades and plug-ins to BottomFeeder.
| View all new items in all folders.
| View all alerts; that is, all new items in feeds with notifiers.
| View all folders in the `Tree` pane.
| Open a new tab page in the `Item` pane. BottomFeeder creates a new page, copies the contents of the currently selected page to it, and highlights the new tab as the current tab.
| Mark all items in the selected folder or feed as old.
| Mark all items in the selected folder or feed as old.
| Restores to a feed items previously deleted but not yet replaced by new items.
| Stop the downloading of a webpage by the BottomFeeder browser.
| Pause or resume the updating of feeds. When feeds are being updated, BottomFeeder routinely checks the update process to make sure it completes its work. If that process unexpectedly terminates, BottomFeeder tries to restart it. However, if the update process appears to stall you can use this tool to restart it.
| Toggle whether BottomFeeder is online or offline.
| Exit BottomFeeder.

Contents

#### Item Toolbar

The Item Toolbar is located above the `Item List` pane or the `Item` pane, depending on which view is in use. It provides single-click execution of a number of frequently used BottomFeeder tools related to individual items. Toolbar icons are enabled only when they can be validly used; for example, when an item has been selected.

Tool Icon | Action
--- | ---
| Switch to the Item Zoom View for the currently selected item.
| Print the item as presented in the current tab page of the `Item` pane. BottomFeeder opens a `Print` window so you can specify how you want it printed.
| Save the item as a local file. BottomFeeder opens a `Save As` window so you can specify the path, name, and type of the file.
| Send a comment on the selected item. BottomFeeder presents the `Comment Poster` window in which you can enter a comment. This option is enabled only for feeds that accept item comments.
| Send the item as an E-mail message. BottomFeeder opens the `New Mail` window with the title of the item as the subject of the message. You can further edit the message. BottomFeeder does not support gmail as an smtp server or any mail server that uses ttls).
| Flag (or unflag) the item as one requiring your further consideration. To see all items that you have flagged, in all of your feeds, select the `View > Show flagged` menu option.
| Toggle the persistence of the item in the feed's item cache. In the Item List, BottomFeeder indicates that an item is persistent by displaying its title in italics. The item is not replaced when the feed is updated to include new items. If an item is both persistent and deleted, it remains available in the feed's item cache, but visible only when viewing hidden items.
| Post an entry to a blog for the item. BottomFeeder presents the `BlogPoster` window, in which you can add a blog entry. This tool is enabled only if the BottomLine plug-in has been installed. BottomFeeder copies any text that has been selected in the item to the blog entry.
| Add tags to the item in your account in the del.icio.us social bookmarking service, along with your own keywords. BottomFeeder opens the `Del.icio.us Tagger` window.
| Delete the item from the feed. BottomFeeder removes the item from the Item List. You can also delete a selected item by pressing the `delete` key. Deleted items remain available in the feed's item cache until they are replaced by the arrival of new items. Use the `Filters > Restore all deleted items` selection in the feed popup menu to restore all the available deleted items of a feed. Use the `Filters > View hidden items` command in the feed menu to see all the available deleted items (and filtered items) of a feed.
| Remove tags to the item in your account in the del.icio.us social bookmarking service. BottomFeeder opens the `Del.icio.us Tagger` window.
| Mark the item as new. BottomFeeder displays it in bold red text.
| Open a browser window. BottomFeeder opens a browser on the web page associated with the item.

Contents

### Keyboard Shortcuts

Each of the panes of the main BottomFeeder window responds to commands entered via key combinations; otherwise known as keyboard shortcuts. The pane that currently has focus determines how Bottomfeeder handles each shortcut.

Contents

#### Tree Pane Shortcuts

When focus is in the `Tree` pane, the following keyboard shortcuts are enabled:

Shortcut Key | Action
--- | ---
`Tab` | Shift focus to the `Item List` pane.
`Shift-Tab` | Shift focus to the current tab page of the `Item` pane.
`Up Arrow` | Go up by one tree node.
`Down Arrow` | Go down by one tree node.
`Page Up` | Go up by 1 page, where a page is defined by the number of lines available for display in the Tree pane.
`Page Down` | Go down by 1 page, where a page is defined by the number of lines available for display in the Tree pane.
`Ctrl-Home` | Go to top node of tree.
`Ctrl-End` | Go to bottom node of tree.
`+` | Expand the currently selected tree.
`-` | Collapse the currently selected tree.
`*` | Fully expand the currently selected tree.
`Ctrl-Shift-a` | Add feeds to the currently selected folder.
`Ctrl-b` | Launch a browser on the currently selected feed link.
`Ctrl-c` | If a feed is selected, copy the feed's title to the clipboard.
`Ctrl-g` | Fully expand the tree.
`Ctrl-h` | Fully contract the tree.
`Ctrl-r` | Mark as old all items in the currently selected feed or folder.
`Ctrl-u` | Mark as new all items in the currently selected feed or folder.
`Ctrl-z` | Toggle zoom mode.
`Space` | Toggles the display of the items of the currently selected feed or folder.

Contents

#### Item List Pane Shortcuts

When focus is in the `Item List` pane:

Shortcut Key | Action
--- | ---
`Tab` | Shift focus to the current tab page of the `Item` pane.
`Shift-Tab` | Shift focus to the `Tree` pane.
`Up Arrow` | Go up by one item.
`Down Arrow` | Go down by one item.
`Page Up` | Go up one page, which is defined to be five items if five are available.
`Page Down` | Go down one page, which is defined to be five items if five are available.
`Ctrl-Home` | Go to top item.
`Ctrl-End` | Go to bottom item.
`Ctrl-b` | Launch a browser on currently selected item.
`Ctrl-c` | If an item is selected, copy the item's title.
`Ctrl-l` | Flag (or unflag) the item as one requiring your further consideration.
`Ctrl-m` | Send a comment on the item. BottomFeeder presents the `Comment Poster` window in which you can enter a comment. This option is enabled only for feeds that accept item comments.
`Ctrl-n` | Go to the next new item in the item list.
`Ctrl-o` | Post an entry to a blog for the item. BottomFeeder presents the `Blog Poster` window, in which you can add a blog entry. This shortcut is enabled only if the BottomLine plug-in has been installed. BottomFeeder copies any text that has been selected in the item to the blog entry.
`Ctrl-p` | Go to the previous new item in the item list.
`Ctrl-r` | Mark as old all items in the currently selected feed.
`Ctrl-u` | Mark as new all items in the currently selected feed.
`Ctrl-z` | Toggle zoom mode.
`Space` | Go to next new item in the list but keep focus in the list.

Contents

#### Item Pane Shortcuts

When focus is in the `Item` pane:

Shortcut Key | Action
--- | ---
`Tab` | Shift focus to the `Tree` pane.
`Shift-Tab` | Shift focus to the `Item List` pane.
`Up Arrow` | Go up by three lines.
`Down Arrow` | Go down by three lines.
`Page Up` | Go up one page, where a page is defined by the number of lines available for display in the tab page.
`Page Down` | Go down by one page, where a page is defined by the number of lines available for display in the tab page.
`Ctrl-Home` | Go to top line.
`Ctrl-End` | Go to bottom line.
`Ctrl-b` | Launch a browser on currently selected item.
`Ctrl-c` | Copy the currently selected text of the item to the clipboard.
`Ctrl-l` | Flag (or unflag) the item as one requiring your further consideration.
`Ctrl-m` | Send a comment on the item. BottomFeeder presents the `Comment Poster` window in which you can enter a comment. This option is enabled only for feeds that accept item comments.
`Ctrl-o` | Post an entry to a blog for the item. BottomFeeder presents the `Blog Poster` window, in which you can add a blog entry. This shortcut is enabled only if the BottomLine plug-in has been installed. BottomFeeder copies any text that has been selected in the item to the blog entry.
`Ctrl-n` | Go to the next new item in the item list.
`Ctrl-p` | Go to the previous new item in the item list.
`Ctrl-r` | Mark as old all items in the currently selected feed.
`Ctrl-u` | Mark as new all items in the currently selected feed.
`Ctrl-z` | Toggle zoom mode.
`Space` | Do down one page.
`Shift-Space` | Do up one page.

Contents

#### Other Shortcuts

Shortcut Key | Action
--- | ---
`F1` | Browse the Users Guide.
`F4` | Toggle slim mode.
`Ctrl-f` | Open the BottomFeeder Search tool.
`Ctrl-s` | Save all settings.
`Ctrl-t` | Open the BottomFeeder settings window.

Contents

| ## BottomFeeder's Auxiliary Windows

Most of the time you are using BottomFeeder, you interact with the views and panes of its `Main` window; however, auxiliary Windows appear for many supporting functions.

Contents

### About Window

Open this window by selecting the `Help > About` command.

You can find out about the BottomFeeder program and its compnents in this window.

###### Window Controls

- details area - displays detailed information about BottomFeeder.
- `OK` button - click to close this window.

When you right-click within the details area, the following pop-up menu is presented:

Contents

### Add Feed Window

Open this window by selecting the `Add Feed...` command in the folder popup menu or the `Add Feed...` tool.

You can add feeds to a folder in this window.

###### Window Controls

- Feed address input area - enter the addresses (URL's) of one or more feeds, separated by carriage returns, in this area.
- `OK` button - click to add the feeds and close this window. BottomFeeder immediately gets the feed files at the specified addresses.
- `Cancel` button - click to close this window without adding any feeds.

Contents

### Amazon Feed Builder Window

Open this window by selecting the `Feeds > Amazon Feed Builder...` command in the main menu.

You can define a feed that you want from `Amazon.com` with this window. BottomFeeder adds the new feed to your `My Feeds` folder.

Every update cycle, BottomFeeder sends the query that defines your feed to Amazon, which generates a feed file on-the-fly.

###### Window Controls

- `Search for:` radio buttons - specify the type of entry to be searched: books, DVD's, or CD's.
- `Search modifier:` list - select the type of entry to be searched: Keyword, Author or Power (see below).
- `Sort by:` radio buttons - specify how results are to be sorted: by publication date or by sales records.
- `Search String` input area - specify key words Amazon is to use in building your feed; for example, a word that should appear in book titles.
- `What is a Power search?` button - click to browse an Amazon webpage that explains how to do what they call "power" searches.
- `Search by category:` list - select a category of entries in Amazon. Note that this selection is instead of a search specified by the other controls in this window.
- `Add Feed` button - click to add the generated feed to the `My Feeds` folder.
- `Cancel` button - click to cancel this process and close this window.

Contents

### BottomFeeder Search Window

Open this dialog window by selecting the `Items > Search BottomFeeder...` command.

You can search for a text string in the feeds BottomFeeder has already saved in your local system. The results of the search are presented in a new tab page of an `Item List` view.

###### Window Controls

- `Search for` input area - the text string you want to find.
- `In` dropdown menu - select one of the following to specify where to search:
  - Titles - in titles of feed items.
  - Categories - in categories of feed items.
  - Bodies - in contents of feed items.
  - Titles and bodies - in titles and contents of feed items.
  - Titles, bodies and categories - in titles, contents and categories of feed items.
- `Find by feed name` check box - check if you want to turn off all other search options, search for the first feed name that matches, and select it if found.
- `Search Backwards` check box - check if you want to search backwards from the position of the last text string found.
- `Regex` check box - check if the `Search for` input area contains a Regular Expression.
- `Save as Feed` check box - check if you want to save the results of the search as a separate feed. If so, the new feed is added to the Searches folder.
- `Find Next` button - BottomFeeder searches for the text string in the specified locations, or it resumes the search.
- `Close` button - BottomFeeder closes the search window.

Contents

### Bug Report Window

Open this dialog window by selecting the `Help > Bug Report` command.

You can report bugs you find in the operation of BottomFeeder.

###### Window Controls

- `Email Address` input area - your incoming email address.
- `Email Password` input area - the password expected by your outgoing email server (as in your mail client).
- `Email Server` input area - the IP address or name of your outgoing SMTP mail server (as in your mail client).
- `CC Yourself?` check box - check if you want a Carbon Copy of the bug report e-mailed to you.
- `Bug Description` Text input area - your description of the bug.
- `Attach the Error Log?` check box- check if you want the error log attached to the bug report.
- `Delete Error Log after sending?` check box - check if you want to delete the error log.
- `Mail it` button - BottomFeeder sends a message containing the Bug Report to the BottomFeeder development team.
- `Cancel` button - BottomFeeder closes this window.

Contents

#### Comment Poster Window

Some feeds allow you to send comments to the website that publishes the feed. BottomFeeder supports two types of comments:

1. Feed comments. Select a feed in the BottomFeeder `Tree` pane and click on the `Feedback > Send comment on feed...` command in the feed's popup menu. For example, the feed may allow you to query the website that publishes the feed. If a response to the comment is returned by the website it is displayed in a new tab page of the `Item` pane. An example of a response could be the results of a query.
2. Item comments. Select an item in the BottomFeeder `Item List` pane and click on the `Send comment on item...` tool in the item toolbar. This allows you to send a comment about the item to the website that publishes the feed. If a response to the comment is returned by the website, it is displayed in a new tab page of the `Item` pane. An example of a response could be your comment appended to the original item.

To identify yourself in your comments, change the `Comment user name` setting in the BottomFeeder `User Interface Settings` window.

The Comment Poster works with any server that supports the Well Formed Web Comment API Module. This is an Internet standard for sending comments about a feed or item. BottomFeeder only supports comments to feeds that accept them. Few feeds support feed-level comments, and few feeds provide immediate responses to item comments.

###### Window Controls

- `Subject` input area - specify the subject of your comment. This is simple text; use no markups.
- `Comment` input area - enter your comment here. See Editing for the ways in which you can format a comment for presentation.
- Status output area - specifies the status of your blog site
- `Status` output area - specifies the status of your comment when you have posted it to the feed's server.

###### File Menu

Contents

###### View Menu

Contents

###### Help Menu

Contents

###### Commenting Toolbar

This toolbar is located below the menus. It provides single-click execution of a number of frequently used commenting tools. All of these tools are also available through the Main Menu or through one or more popup menus. Toolbar icons are enabled only when they can be validly used.

Tool Icon | Action
--- | ---
| Preview. Opens the `Preview` window with your comment formatted as you specified.
| Post. Sends your comment to the feed's server to post it with the item you are commenting on.
| Help. Opens the `Markup Help` window, which provides help for wiki-style markups.

Contents

### Del.icio.us Tagger Window

Open this window by selecting the `Add del.icio.us tags...` tool in the item toolbar.

Use the Del.icio.us tagger to add or remove tags to a selected item at the Del.icio.us social bookmarking website.

###### Window Controls

- `Description` input area - a description of your list of tags.
- `Tag` input area - enter new tag words separated by spaces. Enclose tags consisting of multiple words in quotes.
- `Tags` list area - lists the tags you have defined.
- `Add Tag` button - press to add a new tag to the list.
- `Remove Tag` button - press to remove the selected tags from the list.
- `Send` button - press to send your tags to the Del.icio.us website.

Contents

### Enclosure Manager Window

Open this window by selecting the `Plugins > Enclosure Manager` command.

Use the Enclosure Manager to find out about the enclosures that are available in the items of various feeds that BottomFeeder handles for you.

###### Window Controls

- `Saved Enclosures` list area - a list of enclosures that have been received by BottomFeeder in the items of various feeds. This is a multi-selection list.
- `Remove selection` button - press to remove the selected enclosures from the list and from your system.
- `Exit` button - press to close this window.

###### File Menu

###### Saved Enclosures Popup Menu

Contents

### Enclosure Manager Settings

You can control how the Enclosure Manager works by changing various settings. Open this window by selecting the `File > Enclosure Settings...` command in the Enclosure Manager window menu.

###### Window Controls

- Settings Tree Pane - This is a tree of named pages of related settings.
- Settings Page Pane - This pane presents the page currently selected in the Settings tree.
- `OK` button - BottomFeeder applies all changes that have been made to settings and closes the `Settings` window.
- `Cancel` button - BottomFeeder cancels all changes that have been made but not applied and closes the `Settings` window.
- `Apply` button - BottomFeeder applies all changes to settings that have been made in the currently selected page, and leaves the `Settings` window open.
- `Help` button - BottomFeeder presents explanations of the settings on the currently selected page.

###### Enclosure Settings Tree Popup Menu

When you right-click in the Settings Tree pane, the following menu pops up:

###### Enclosure Settings

- `After this many days, remove` input area -- Specify how long to keep an enclosure. Set this to zero in order to never delete enclosures.
- `Download directory` input area -- The directory in which to download enclosures.
- `Time to download?` input area -- The time of day that BottomFeeder should start downloading enclosures.
- `Types to download?` input area -- The types of enclosure files that BottomFeeder should download. Enter a comma delimited list of file extensions.

Contents

### Exception Window

BottomFeeder opens this window when it encounters an exceptional condition it is not programmed to handle.

###### Window Controls

- Messages area - BottomFeeder provides a message about the exceptional condition it detected. This message is intended for the BottomFeeder development team.
- `Send email to the developers` check box - check if you want to sent a message about this exception to the BottomFeeder development team. When you click either the `Quit BottomFeeder` button or the `Ignore and Continue` button, BottomFeeder opens the `Bug Report` window and includes the exception debugging information (the Smalltalk walkback stack) in its description area.
- `Quit BottomFeeder` button - BottomFeeder closes all of its windows.
- `Ignore and Continue` button - BottomFeeder attempts to recover to a known processing state and continue operation.

Contents

### Feed Auto-Discovery Window

Open this window by selecting

- `Discover feeds...` command in a folder popup menu.
- `Feeds > Feed Auto-Discovery` command.

The Syndic8 website is a directory of RSS feeds on a wide variety of topics. You can search it for feeds to add to a folder. If you select a folder in the tree, the feeds are added to that folder; otherwise, they are added to a new folder whose name is derived from your query string.

###### Window Controls

- `Query` input area - specify a string that identifies the feeds you want to discover.
- `Find Feeds` button - BottomFeeder submits the query string to the Syndic8 website for a search for matching feeds.
- Feed List - Displays the list of feeds that match your query string. You can select one or more of these feeds to add.
- `Add Selected` button - BottomFeeder adds the feeds you selected in the Feed List to the specified folder.
- `Add All` button - BottomFeeder adds all of the feeds in the Feed List to the specified folder.
- `Dismiss Window` button - BottomFeeder closes the window without adding any further feeds to the specified folder.

Contents

### Feed Maintenance Window

Open this window by selecting the `Feeds > Feed maintenance...` command.

Over time, some feeds can become inactive, receiving no new items from their source web site. This command enables you to easily identify and remove these trees from your feed tree.

###### Window Controls

- `Cutoff date:` input area - specify the date before which inactive feeds were last updated or marked inactive.
- `Get old` button - BottomFeeder selects the feeds that have not been updated since the cutoff date and lists their names.
- `Feed names` multi-selection list area - lists the feeds that have not been updated since the cutoff date. Select the feeds that you want to remove from your feed tree.
- `Remove selected` button - BottomFeder removes the selected feeds from your feed tree.
- `Cancel` button - BottomFeeder cancels any changes and closes this window.

Contents

### Feed Properties Window

(See window pages, below.)

Open this window by selecting the `Feed properties...` command in the pop-up menu of a feed in the `Tree` pane.

You can view the properties of a feed in the Feed Properties window, and change some of them.

###### Window Controls

- `General` tab - shows the `Feed Properties General` page.
- `Settings` tab - shows the `Feed Property Settings` page.
- `Details` tab - shows the `Feed Properties Detail` page.
- `Encoding` tab - shows the `Feed Properties Encoding` page.
- `Browse Feed Source...` button - BottomFeeder opens a browser on the RSS source of the feed.
- `OK` button - BottomFeeder applies any changes and closes this window.
- `Cancel` button - BottomFeeder cancels any changes and closes this window.

Contents

#### Feed Properties General Page

This tab page presents properties common to all feeds.

###### Page Controls

- `Title` output area - the title provided by the feed.
- `Format` output area - the standard under which the feed is formatted (one of the variations of the RSS or Atom standards).
- `Has Notifier` output area - whether the feed currently has a notifier for new items.

Contents

#### Feed Property Settings Page

This tab page presents properties that can be individually set for each feed.

###### Page Controls

- `Link` output area - the Internet address of the feed's source.
  - If you change the link of a feed, it is the same as removing the feed and adding a new feed.
- `Display Title` input area - the title to display or the feed in BottomFeeder. This defaults to the feed's title, but you can change it to whatever you want.
  - This defaults to the feed's title, but you can change it to whatever you want.
- `Cache Size` input area - the number of items to keep for display for this feed.
- `Should massage image display?` check box - check if images in items of this feed overlay text.
  - This option forces images to display separately; however, it damages tables, so it is normally not used.
  - This check box is enabled only when the `auto-browse` check box is checked.
- `Should save enclosures?` check box - check if you want BottomFeeder to save any enclosures that accompany feed items.
- `Translate CR's to breaks` check box - check if you want BottomFeeder to convert Carriage Return characters in an item into line breaks.
  - Some items come have no HTML formatting, and some browsers treats CR's like spaces. This option converts CR's to HTML <br> tags.
- `Apply additional decoding rules` check box - check if you want BottomFeeder to correct items with characters your browser does not display properly.
  - Some items are badly encoded. This option can be used to get rid of black boxes and to get appropriate quote marks.
- `Use LibTidy?` check box - check if you want BottomFeeder to cleanup the encoding of items received from the feed.
  - This option is normally checked, but you can uncheck it if the LibTidy processing is causing problems for a particular feed.
- `Should aggregate referenced comments` check box - check if you want BottomFeeder to get comments that are linked to the items of the feed from their websites, and to add them to other comments of each item.
- `Should auto-browse items for this feed` check box - check if you want to browse the items of this feed, instead of just seeing a link to the item.
  - BottomFeeder gets the linked item, and both displays it and caches it for later use.

Contents

#### Feed Properties Details Page

This tab page presents the detailed properties of the selected feed. The properties presented in the list varies from feed to feed, depending on which properties were provided by the generator of the feed. Some of the properties are links that you can click to browse the linked webpage or to send mail to a linked mailbox.

###### Page Controls

- output area - the detailed properties of the feed.

When you right-click within the Details tab, the following pop-up menu is presented:

Contents

#### Feed Properties Encoding Page

This tab page presents radio buttons that allow you to specify the encoding standard used by the feed.

###### Page Controls

- radio buttons - select the encoding standard used by the feed. `Default` specifies that the feed itself identifies its encoding standard.

Contents

### Filter Definitions Window

Open this window by selecting

- `Items > Define Global Filters...` command.
- `Define Filters...` command in the pop-up menu of a selected feed in the `Tree` pane.

You can identify the items of a selected feed or of all feeds that you do not want to see. Filters that operate on all feeds are called global filters.

Feed items are filtered at the following times:

- When you dismiss the Filter Definitions window.
- During a feed update cycle.
- When a feed is regenerated.

Feed items are not filtered when the items of a feed are displayed.

###### Window Controls

- `Current Filters` output area - specifies the filters that have already been defined.
- `Filter Definition` radio buttons - specify the type of filter: item title, item category or item content. For example, a category-type filter could be defined to filter out items with the category of "sports".
- `Filter Definition` input area - specify the word or phrase to be used in filtering items; for example, filter out items whose title contains the word "Java" or the oxymoronic phrase "Java productivity".
- `Use as Global Filter` check box - BottomFeeder adds the currently selected filter in the Current Filters area to its list of global filters to be applied to items of all feeds. This control is enabled only when defining filters for a specific feed; it is always checked when defining global filters.
- `Use to filter out` check box - if checked, BottomFeeder excludes items that match the filter from the feed; accepting all other items. If not checked, BottomFeeder includes only items that match the filter in the feed; excluding all other items. The order in which filters are specified is important.
- `Add Filter` button - BottomFeeder add the defined filter to the list of filters displayed in the Current Filters area.
- `Remove Filter` button - BottomFeeder removes the currently selected filter from the list of filters displayed in the Current Filters area.
- `Save Filters` button - BottomFeeder saves the list of filters displayed in the Current Filters area for latter application to items.
- `Dismiss` button - BottomFeeder applies the saved filters to items and closes the Filter Definitions window.

Contents

### Internet Feed Builder Window

Open this window by selecting the `Feeds > Internet Feed builder...` command.

A number of websites allow you to send them a query. Use this window to identify the website and specify a query. BottomFeeder adds the new feed to the `My Feeds` folder. The website returns the results of the query formatted as a feed.

Every update cycle, BottomFeeder sends your query to the website, which generates and returns a feed file on-the-fly. The website does not keep a feed file up-to-date.

###### Window Controls

- `Feed Builder` dropdown menu - select the feed builder you want to use. BottomFeeder provides a collection of predefined feed builders for your selection. You can define additional feed builders by clicking the `Define Builder` button.
- `Query` input area - specify the text string that you want to search for.
- `Modifiers` radio buttons - specify how you want the results of the search to be presented: by relevance, by date or by Blog rank.
- `Build Feed` button - BottomFeeder sends the query to Feedster and adds the returned feed to the `My Feeds` folder. You can then mode it to a different folder.
- `Define Builder` button - BottomFeeder opens the `Search Wizard` window, in which you can identify the address of the website in which you want to build feeds.
- `Get Key` button - get a key from Google that allows you to do searches in Google.
- `Cancel` button - BottomFeeder cancels the query and closes the window.

Contents

### Internet Search Window

Open this dialog window by selecting the `Items > Internet search...` command.

You can search for a text string in one of several Internet websites. A browser is launched on a results page produced by the searched website.

###### Window Controls

- `Search for` input area - the text string you want to find.
- `In` dropdown menu - select one of the following to specify where to search:
  - Amazon(A9) - in the feed files searched by the Amazon search engine.
  - BlogDigger - in the blog pages indexed by the BlogDigger search engine.
  - Feedster - in the feed files searched by the Feedster search engine.
  - MSN - in the feed files searched by the MSN search engine.
- `Find Next` button - BottomFeeder performs the search.
- `Close` button - BottomFeeder closes the search window.

Contents

### Item Properties Window

(See window pages, below.)

Open this window by selecting `Item Properties...` command in the pop-up menu of an item in the `Item List` pane.

You can view the properties of an item in the `Item Properties` window.

###### Window Controls

- `General` tab - shows the `General Item Properties` page.
- `Details` tab - shows the `Detail Item Properties` page.
- `OK` button - BottomFeeder closes this window.

Contents

#### Item Properties General Page

This tab page presents properties common to all items.

###### Page Controls

- `Title` output area - the title of the item.
- `Link` output area - the Internet address of the item's source.
- `Identifier` output area - a unique identifier for the item in its feed.
- `Is Deleted` output area - specifies if the item has been deleted. The item is only displayed by BottomFeeder in a view of the deleted items of the feed.
- `Is Persistent` output area - specifies if the item has been made persistent. The item is never replaced by the BottomFeeder feed update process.

Contents

#### Item Properties Details Page

This tab page presents the detailed properties of the selected item. The properties presented in the list varies from item to item, depending on which properties were provided by the generator of the item. Some of the properties are links that you can click to browse a linked webpage or to send mail to a linked mailbox.

###### Page Controls

- output area - the detailed properties of the item.

When you right-click within the Details tab, the following pop-up menu is presented:

Contents

### Named Font Selector

Open this window by selecting the `System > DefineFonts...` command.

BottomFeeder uses of a variety of font styles for the text it displays in trees, lists, and other window controls. Use the `Named Font Selector` window to change the appearance of these font styles. The font family, pixel size, color, boldness, italic, underline, strikeout options of a font style can be edited and viewed.

This is a reuse of an existing VisualWorks Smalltalk window. While this window supports the definition of new font styles, there is no way to use new font styles in BottomFeeder. Think of this as a promise of things to come in a future release of BottomFeeder.

###### Window Controls

- `Font Styles` list - BottomFeeder displays the names of the currently defined font styles.
- Sample of selected font style - BottomFeeder presents a sample of text formatted according to the currently selected font style.
- Font family of selected font style - BottomFeeder presents the name of the font family of the currently selected font style.
- `Font Families` list - BottomFeeder displays the names of the font families that are available. It highlights the family of the currently selected font style.
- `Color` dropdown - BottomFeeder presents the available colors of the currently selected font style.
- Text appearance check boxes - Select appearance options for the currently selected font style.
- Sample of selected font family - BottomFeeder presents a sample of text formatted according to the currently selected font family.
- Font family of selected font style - BottomFeeder presents the name of the font family of the currently selected font style.
- `Add New Named Font` button - BottomFeeder prompts you for the name of the new named font style. After it has been added to the `Font Styles` list, you can change its properties.
  Disabled in this release of BottomFeeder.
- `Remove Named Font` button - BottomFeeder removes the currently selected font style from the `Font Styles` list.
- `Assign to Named Font` button - BottomFeeder assigns the selected properties to the currently selected font style from the `Font Styles` list.
- `Close` button - BottomFeeder closes the `Named Font Selector` window.

The `File` menu of the `Named Font Selector` window has the following commands:

Contents

### News Feed Builder Window

Open this window by selecting the `Feeds > Headline News Builder...` command.

Various websites support searches of news feed files. You can ask them to search for a text string and build a new feed from the results of the search. BottomFeeder adds the new feed to the `My Feeds` folder.

Every update cycle, BottomFeeder sends the query that defines your feed to the news service, which generates a feed file on-the-fly. The news service does not keep a feed file up-to-date.

###### Window Controls

- `Query` input area - specify the text string that you want to search for.
- radio buttons - specify which news service you want to use: Yahoo, Headline News or NewsTrove.
- `Build Feed` button - BottomFeeder sends the query to the news service and adds the returned feed to the `My Feeds` folder. You can then mode it to a different folder.
- `Cancel` button - BottomFeeder cancels the query and closes the window.

Contents

### Restore Host File Window

Open this dialog window by selecting the `Network > Restore all via FTP...` command.

You can restore feeds saved in a network host file.

###### Window Controls

- `Username` input area - your user name on the host system.
- `Password` input area - your password on the host system.
- `Host` input area - the IP address of the host system.
- `Remote File` input area - the name of the file in the host system to be restored.
- `Restore` button - BottomFeeder gets the specified network file and loads it's contents as feeds.
- `Help` button - BottomFeeder presents a window containing information about saving and restoring files to network systems.
- `Cancel` button - BottomFeeder ignores any changes made to the input fields and closes this window..

Contents

### Runtime Errors Report Window

Open this dialog window by selecting the `Help > View Current Error Log` command.

You can report bugs you find in the operation of BottomFeeder.

###### Window Controls

- Error log area - a log of runtime errors detected by BottomFeeder..
- `Save to File` button - your email address.
- `Clear` button - BottomFeeder clear its error log.
- `Dismiss` button - BottomFeeder closes this window.

Contents

### Save to Host File Window

Open this dialog window by selecting the `Network > Save all via FTP...` command.

You can save your current feeds to a network host file.

###### Window Controls

- `Username` input area - your user name on the host system.
- `Password` input area - your password on the host system.
- `Host` input area - the IP address of the host system.
- `Remote File` input area - the name of the file to be saved in the host system.
- `Send` button - BottomFeeder sends the current feeds to the specified network file.
- `Help` button - BottomFeeder presents a window containing information about saving files to network systems.
- `Cancel` button - BottomFeeder ignores any changes made to the input fields and closes this window.

Contents

### Search Wizard Window

Open this dialog window by pressing the `Define Builder...` button in the `Feed Builder` window. You can define a feed builder query to be sent to a website of your choice.

This window is not used to request searches, only to define the searches that can be requested in the `Feed Builder` window.

###### Window Controls

- `Description` input area - the name for the new feed that is to appear in the `Searches` folder.
- `Base URL` input area - the Internet address of the website to be searched -- after the "http://".
- `Query Part` input area - the query string to be sent to the website to be searched -- after the "&q=". You will have to obtain the format of the query string from the website.
- `Save` button - save the new feed builder under the name specified by the `Description`. This name will appear in the `Website` dropdown list of the `Feed Builder` window.
- `Clear` button - clear the input areas of the window.
- `Cancel` button - cancel the creation of a feed builder.

Contents

### Settings Window

Open this window by selecting the `System > BottomFeeder Settings...` command.

You can control how BottomFeeder works by changing various settings. The settings are arranged in a set of pages identified by name in the tree on the left. Individual settings are presented on the right in the selected page.

###### Window Controls

- Settings Tree Pane - This is a tree of named pages of related settings.
- Settings Pane - This pane presents the page currently selected in the Settings tree.
- `OK` button - BottomFeeder applies all changes that have been made to settings and closes the `Settings` window.
- `Cancel` button - BottomFeeder cancels all changes that have been made but not applied and closes the `Settings` window.
- `Apply` button - BottomFeeder applies all changes to settings that have been made in the currently selected page, and leaves the `Settings` window open.
- `Help` button - BottomFeeder presents explanations of the settings on the currently selected page.

###### Settings Tree Popup Menu

When you right-click in the Settings Tree, the following menu pops up:

Contents

#### Browsing Settings

###### Page Controls

- `All browsing done in BottomFeeder` check box - if checked, all browsing occurs in a tabbed page of the `Item` pane, instead of in an external browser.
- `Auto-browse empty descriptions` check box - If checked, BottomFeeder browses the feed's link page when encountering empty descriptions. Otherwise, it displays the URL of that page in the `Item` pane.
- `Browsing History` input area - the number of items to save per tab page for forward and back navigation.
- `External browser` input area - the directory path to the external browser that BottomFeeder should use. On Windows, this setting is ignored - the default browser is used instead.
- `Launch new browser on links` - If checked, BottomFeeder launches a new browser window for all links. This works on Windows, or with Mozilla/Netscape on any platform.

Contents

#### Caching Settings

###### Page Controls

- `Number of items to cache` input area - the number of items to hold for each feed during execution. This is also referred to as the cache size.
- `Should truncate items to cache size on updates` check box - If checked, after each update of a feed, BottomFeeder truncates the number of items in the cache for the feed to the cache size.

Contents

#### Del.Icio.Us Settings

###### Page Controls

- `Del.Icio.Us API Base` input area - The Base url to post to for del.icio.us.
- `Del.Icio.Us Username` input area - Username for the del.icio.us service.
- `Del.Icio.Us Password` input area - Password for the del.icio.us service.

Contents

#### Feed Settings

###### Page Controls

- `Do item cross referencing?` check box - check if you want BottomFeeder to cross reference each item of a feed with items in other feeds cached in your system.
  - If any such cross references to an item exist, the `View Related Items` option is enabled in the `Item List` menu for that item.
- `Days to mark a feed bad` input area - specify how many days should elapse without an update before a feed is marked bad.
- `Save files after each update?` check box - if checked, BottomFeeder saves its application state (including cached feeds) to files after each update cycle.
- `Item new if new comments?` check box - if checked, BottomFeeder marks an item as being new whenever a comment arrives for the item.
- `Aggregate comments with feeds (if possible)?` check box - if checked, BottomFeeder requests item comments that are separately linked to their websites, and adds them to the item.
- `Keep track of feeds without updates` check box - If checked, BottomFeeder keeps track of the number of days that have elapsed since the last update of each subscribed feed.
- `Use TidyHTML` check box - If checked, BottomFeeder converts the items received from each feed into a form (XHTML) that can be more easily displayed.
  - BottomFeeder only includes TidyHTML libraries for x86 Linux and Windows. Technically oriented users could build a shared library for their platform if they want to download the C sources. If the TidyHTML dll/shared library is not available, this setting is ignored.

Contents

#### Memory Settings

###### Page Controls

- `Don't limit memory growth` check box - If checked, BottomFeeder is free to increase the amount of memory it uses.
- `Maximum memory` input area - specifies the absolute maximum number of bytes of memory BottomFeeder can use.
- `Soft memory limit` input area - specifies the maximum number of bytes of memory BottomFeeder can use before it must scavenge memory it previously released.

Contents

#### Network Settings

###### Page Controls

- `Is online` check box - If checked, BottomFeeder is online for updates.
- `Run threaded updates` check box - If checked, BottomFeeder runs each request to update a feed as a separate processing thread. This allows it to handle multiple update requests concurrently; otherwise, they are handled one at a time.
- `Limit the number of threads during updates?` check box - if checked, BottomFeeder uses a limited number of independent update threads instead of a thread per feed. To do this you must also uncheck `Run threaded updates`.
- `Update frequency (minutes)` input area - the time (in minutes) to wait before checking for updates to subscribed feeds.

Contents

#### Newspaper Settings

###### Page Controls

- `Comments in newspaper?` check box - If checked, BottomFeeder includes the comments on an item in the newspaper view.
- `Show shorter newspaper summary` check box - If checked, BottomFeeder shows only a short summary of each item in the newspaper view.

Contents

#### Unix/Linux Settings

###### Page Controls

- `Unix shell` input area - specify the name of the Unix shell to use (bash, sh, csh, etc). An arbitrary script name can be specified since the launching expression is not checked as a valid path.

Contents

#### User Interface Settings

###### Page Controls

- `Should save backup XML file on exit` check box - If checked, on exit BottomFeeder saves an XML file without items, but with all the rest of the structure. This file is used for automatic recovery if the file BottomFeeder normally saves is damaged.
- `User interface look` dropdown menu - the default appearance and behavior of the BottomFeeder user interface.
- `Should save file on exit?` check box - If checked, BottomFeeder saves all settings and feed states on exit.
- `Show Expanded Description?` check box - If checked, BottomFeeder presents title information for each item, including the feed title and the item's title, category and timestamp.
- `New View in Tree?` check box - If checked, BottomFeeder responds to the `New Items` view button by displaying a Tree View whose tree contains only feeds with new items, along with their containing folders.
- `Text size` dropdown menu - the size at which BottomFeeder should display text.
- `Use XHTML editor for comments?` check box - if checked, BottomFeeder uses its WYSIWYG editor in the `Commenting` window.
- `Comment user name` input area - enter the name by which you want to be known in your comments. This name defaults to anonymous.

Contents

#### User Settings

###### Page Controls

Specify the following if you are connected to the Internet through a proxy server:

- `Proxy Server Username` input area - the username for the proxy server. Specify a username if required by the Proxy Server.
- `Proxy Server Password` input area - the password for the proxy server. Specify a password if required by the Proxy Server.
- `Proxy Server Port Number` input area - the port for the proxy server.
- `Proxy Domain` input area - the domain of the proxy server.
- `Proxy Server Hostname` input area - the hostname for the proxy server.
- `Proxy Exceptions (by comma)` input area - specifies the names of the proxy exceptions (separated by commas) that BottomFeeder should ignore.

Specify the following for your Email SMTP server. This is the same information that is required for an Email account by your Email program (such as Outlook Express). BottomFeeder version 2.9 requires it only if you send in bug reports.

- `Email Address` input area - the email address to use when sending mail from BottomFeeder.
- `Email Password` input area - the email password to use when sending mail from BottomFeeder.
- `Email Server` input area - the email server to use when sending mail from BottomFeeder. Must be an SMTP server.

Specify the following if you intend to do Save and Restore to a FTP Server:

- `Default FTP Server` input area - the FTP host to transfer files to when using the Remote Save feature.
- `Default FTP Password` input area - the FTP password to transfer files with when using the Remote Save feature.
- `Default FTP Username` input area - the FTP username to transfer files with when using the Remote Save feature.

BottomFeeder only uses the proxy settings if you are accessing the Internet through a proxy server.

- `Use Proxy Settings` check box - check if you want BottomFeeder to use the proxy settings.

Contents

### Slim Mode Window

Open this window by selecting the `Toggle Slim Mode` tool in the main toolbar.

The Slim Mode window is an alternative to the BottomFeeder main window. It is a cycling display of the titles of new items. BottomFeeder closes the `Main` window and displays the Slim Mode window.

To return to the `Main` window, close the Slim Mode window, and then restore BottomFeeder.

Contents

### Tear Off Window

You can tear off a tab page from the `Item` pane of the `Main` window by using the `Tear Off` command of a tab's popup menu.

###### Window Controls

- `Toolbar` - See the `Item Toolbar`.
- `Item` area - BottomFeeder presents the text of an item.

###### Popup Menu

When you right-click within the item area, the following pop-up menu is presented:

###### Keyboard Shortcuts

When focus is in the item area, the following keyboard shortcuts are available:

Shortcut Key | Action
--- | ---
`Up Arrow` | Go up by three lines.
`Down Arrow` | Go down by three lines.
`Page Up` | Go up one page, where a page is defined by the number of lines available for display in the tab page.
`Page Down` | Go down by one page, where a page is defined by the number of lines available for display in the tab page.
`Ctrl-Home` | Go to top line.
`Ctrl-End` | Go to bottom line.
`Ctrl-c` | Copy the selected text to the clipboard.
`Space` | Go down one page.
`Shift-Space` | Go up one page.

Contents

### Upgrade Manager Window

Open this window by selecting the `Check for upgrades...` tool in the main toolbar.

You can upgrade your version of the BottomFeeder program and load plug-ins. The current version of the upgraded components are copied to `btfSave/backup` in your BottomFeeder Home Directory before being replaced. If you need to back out the updated components, do the following:

1. Go to the User Interface Settings, and turn off `Should save files on exit`.
2. Quit BottomFeeder.
3. Copy the components you just updated from `btfSave/backup` to the appropriate directory (either `plugins` or `app`, depending on the file).
4. Restart BottomFeeder.

###### Window Controls

- `Available Upgrades` table - identifies all of the upgrades and plug-ins that are available. Select the ones you want to install.
- `Upgrade Selected` button - installs the selected upgrades or plug-ins.
- `Upgrade All` button - installs all upgrades and plug-ins.
- `Close` button - close the window.
- `Load changes without restarting` check box - check if you want BottomFeeder to immediately load the updates, instead of waiting until BottomFeeder is restarted.

Contents

### Workspace Window

Open this window by selecting the `System > Execute Smalltalk Code...` command.

You can enter and execute Smalltalk statements and scripts using this window. It can be used to enter, edit, save to file, read from a file, execute, debug and inspect any sequence of Smalltalk statements.

- BottomFeeder includes a Workspace window for writing screen-scraper scripts. See the BottomFeeder Scripting wiki page for more information on this.
- A Workspace window can also be used to enter, edit, save to file, read from a file, execute, debug and inspect any sequence of Smalltalk statements. It is suitable for experimenting with the basic syntax and features of Smalltalk, but it is only one part of the full VisualWorks Interactive Development Environment.
- It is not feasible to document either the Smalltalk programming language or the VisualWorks Interactive Development Environment (IDE) in this document. Full documentation can be obtained at Cincom VisualWorks Smalltalk.

Contents

| ## Blogging

Web logs ("blogs") are an increasingly popular way for people to express their views on whatever interests them. Each blog is an Internet website in which a person enters items. The most recent item of a blog is presented at the top of a webpage, followed by earlier items.

Many blogs also include an RSS feed that identifies the latest items in the blog. An aggregator, such as BottomFeeder, periodically reads the RSS file, and keeps its client up-to-date as items are added to the blog. This is a great way to keep up with a possibly large number of blogs.

As a convenience for users who have their own blogs, BottomFeeder includes a blog poster for creating and updating the items in a blog. This plugin communicates with the blog's server in support of the following tasks that the owner of a blog might want to accomplish:

- Creating and editing new items for the blog.
- Sending (a.k.a. posting) items to the blog.
- Retrieving an existing item from the blog so that it can be updated.
- Managing drafts of items that have not yet been posted to the blog.
- Uploading files, such as images and documents, to the blog server so they can be linked by blog items.
- Retrieving and updating the categories associated with items in the blog.
- Managing trackbacks to an item.
- Retrieving and managing the blog's blogroll -- a list of links to other blogs and websites recommended by the owner of the blog.
- Managing enclosures -- links to resources attached to an item of the blog.

The BottomFeeder blog poster works with any server that supports the following Internet standards for working with the items to a blog:

1. Blogger API
2. MetaWebLog API
3. Movable Type API
4. CST API. This API was designed specifically for working with the Cincom Smalltalk blog server.

Contents

### Blog Poster Window

Open this window in the following ways:

1. While using BottomFeeder to read an item of a feed (perhaps a blog feed), you may want to enter an item in your own blog about the same subject. Select the `Blog It!` tool and BottomFeeder opens the `Blog Poster` window, in which you can enter and post an item to your own blog. The title of the feed item becomes the subject of your new blog item, and a link to the original blog item is added to the top of your new blog item.

   An alternative is to send a comment on the item to the originating feed by using the BottomFeeder `Comment Poster` window. However, you may prefer to keep your opinions in your own blog where you can more easily edit them. Whether you comment on an item or `Blog It!` is largely a matter of preference. For example you may send short comments to the originating feed, while posting longer opinions to your own blog.

2. You can also use the blog poster to add a new item to your blog -- without reference to any other feed item. Select `Plugins > Bottom Line` command.

###### Window Controls

- `Main menu` - menus of commands to the blog poster.
- `Main toolbar` - the icons of frequently used commands to the blog poster.
- `Subject` input area - specify the subject of your blog item. This is simple text; use no markup tags.
- `Category` dropdown - select the category of your blog item or enter a new one. The categories available in this dropdown are those that have already been used in your blog.
- `Editing toolbar` - the icons of commands for editing andd formating a blog item.
- `Item` input area - enter your blog item here. See Editing for the ways in which you can format an item for presentation.
- `Status` output area - specifies the status of your blog item when you have posted it to your blog's server.

Contents

#### Blog Poster Menus

##### File Menu

Contents

##### Post Menu

Contents

##### Settings Menu

Contents

##### Site Menu

Contents

##### View Menu

Contents

##### Help Menu

Contents

#### Blog Poster Toolbar

This toolbar is located below the Blog Poster menu. It provides single-click execution of a number of frequently used blog poster tools. All of these tools are also available through the Main Menu or through one or more popup menus. Toolbar icons are enabled only when they can be validly used; for example, when a feed has been selected.

Tool Icon | Action
--- | ---
| BottomFeeder opens the `Browsing` window with the current item formatted as you specified.
| BottomFeeder sends the current item to the blog server.
| BottomFeeder sends the files in its current upload list to your blog server.
| BottomFeeder saves a draft of the current item in your local system. Be sure to provide a subject for the item before saving it; BottomFeeder identifies each item in the `Open Draft` window by its subject.
| Toggle the spellchecker tool.
| Clear the input area for the creation of a different item. Only one item can be open at a time, either one selected from the `File > Open` command, or a new one created by the `File > New` command. If there is currently an item open, it is discarded.
| BottomFeeder opens the `Open...` window so you can select a file from your system to upload to the blog server. It adds the selected file to a list of files to be uploaded as a group by the `Post / Upload files` command.
| BottomFeeder retrieves the titles of the active items in your blog (but not those in an archive)and displays them as a tree in the `Open Item` window. Expanding an item provides a list of the item's comments. When you select an item or a comment, BottomFeeder retrieves it from your blog.
| BottomFeeder presents the `Open Draft` window. When you select a deferred item, BottomFeeder retrieves that item.
| Clear the currently open item of the blog poster. This command does not delete either an existing item of your blog or a draft that you have saved.
| BottomFeeder retrieves the blog roll from your blog, and opens the `Blog Roll Editor` window so you can edit it.
| Display help for wiki-style markups.

Contents

### Blog Poster - Auxiliary Windows

Most of the time when you are using the blog poster, you interact with the views and panes of its main window; however, auxiliary windows appear for many supporting functions.

Contents

#### About Window

Open this window by selecting `Help > About` in the blog poster menu.

You can find out about the blog poster in this window.

###### Window Controls

- `OK` button - click to close this window.

Contents

#### Blogroll Editor Window

Open it by selecting `Post / Blogroll tool...` in the blog poster menu.

A blogroll is a list of links to other blogs and websites that the owner of a blog wants to recommend to the readers of the blog. Use this tool to update the blogroll of your blog.

###### Window Controls

- `Blog Roll For:` output area - specifies the name of the blog server.
- `Entries` list area - specifies the working blogroll list. When you select a link, its description and URL are copied into the input areas below the list so you can edit them.
- `Description` input area - simple text that identifies a blogroll link.
- `URL` input area - the URL of a blogroll link.
- `Update Entry` button - press to update the selected link of the blogroll as specified by the `Description` and `URL` input areas.
- `Add Entry` button - press to add a new link to the blogroll, as specified by the `Description` and `URL` input areas.
- `Remove Entry` button - press to remove the selected link from the blogroll.
- `Load` button - press to load the current blogroll list from the blog server.
- `Save` button - press to save the working blogroll list to the blog server.
- `Status` output area - specifies the status of communications with the blog server.

Contents

#### Enclosure Editor Window

Open it by selecting `Post / View/define enclosures...` in the blog poster menu.

An item posted to a blog can have one or more enclosures; Use this window to update the enclosures of the current item.

###### Window Controls

- `Enclosure URL/File` input area - the URL of an enclosure to be added to the enclosures list.
- `Enclosures` list area - specifies the current list of enclosures. When you select an enclosure, it is copied into the input area so you can edit it.
- `Add Specified URL` button - press to add the URL of the enclosure in the input area to the enclosures list.
- `Remove Selection` button - press to remove the selected enclosure from the enclosures list.
- `Add to Next Post?` check box - If checked, the list of enclosures is attached to the next item that is sent to the blog.

Contents

#### File Upload Editor Window

Open it by selecting `Post / Edit files to upload...` in the blog poster menu.

Use this tool to manage the list of files to be uploaded to your blog.

###### Window Controls

- `File list` list area - specifies the files to be uploaded.
- `Add...` button - press to obtain a prompt in which a file name can be entered.
- `Remove File` button - press to remove the currently selected file from the file list.
- `Exit` button - press to close this window.

Contents

#### Open Draft Window

Open this window by selecting `File > Open / Drafts` in the blog poster menu.

When you enter items, you do not have to post them to the blog server right away. You can save drafts of items in your local system. If you have drafts for more than one server, each server appears as a separate node in the tree, along with its drafts.

###### Window Controls

- `Drafts list` tree - specifies the available drafts.
- `Open` button - press to open the currently selected draft. The selected draft is opened in the blog poster's editor pane.
- `Refresh` button - press to refresh the tree of available drafts.
- `Cancel` button - press to close this window.

Contents

#### Open Item Window

Open this window by selecting `File > Open / From Server` in the blog poster menu.

This window retrieves the titles of the available items in your blog and presents them as a tree. The comments associated with each item are also available in the tree.

###### Window Controls

- `Items list` tree - specifies the available items in your blog.
- `Open` button - press to open the currently selected item. The selected item is opened in the blog poster's editor pane.
- `Refresh` button - press to refresh the tree of available items.
- `Cancel` button - press to close this window.

Contents

#### Select CSS Style Window

Open this window by selecting `File > Open / Styles` in the blog poster menu.

This window presents the CSS stylesheets available in your blog server. Select one of them.

###### Window Controls

- `Available Styles` list - specifies the CSS stylesheets available in your blog.
- `Update Sever` button - sends your selection to your blog server.
- `Cancel` list - cancels the selection process.

Contents

#### Settings Window

Open this window by selecting `Settings / Posting Settings...` in the blog poster menu.

You can control how the blog poster works by changing various settings. The settings are arranged in a set of pages identified by name in the tree on the left. Individual settings are presented on the right in the selected page.

###### Posting Profiles Menu

###### Window Controls

- Settings Tree Pane - This is a tree of named pages of related settings.
- Settings Page Pane - This pane presents the page currently selected in the Settings tree.
- `OK` button - BottomFeeder applies all changes that have been made to settings and closes the `Settings` window.
- `Cancel` button - BottomFeeder cancels all changes that have been made but not applied and closes the `Settings` window.
- `Apply` button - BottomFeeder applies all changes to settings that have been made in the currently selected page, and leaves the `Settings` window open.
- `Help` button - BottomFeeder presents explanations of the settings on the currently selected page.

Contents

##### Basic Settings

###### Page Controls

- `Blog API` dropdown -- select the API to use for posting and querying the blog.
- `Username` input area -- specify the username to be used for posting and querying the blog.
- `Password` input area -- specify the password to be used for posting and querying the blog.
- `Upload directory` input area -- specify the blog directory in which files are to be uploaded (CST and MetaWebLog only).
- `Do client side markup?` check box -- If checked, BottomFeeder transforms certain wiki-style markups into HTML before sending an item to the blog server.
- `Profile name` input area -- specify the name to be used for this profile.
- `Posts to retrieve` input area -- specify the number of items to retrieve when querying the blog.
- `Use spell checker?` check box -- If checked, use check spelling while an item is being entered or updated.
- `View mode` input area -- select whether the XHTML editor, or Plain Text Editor is to be used when an item is being entered or updated.
- `Blog ID` input area -- specify the unique identifier of the blog within the blog server.

Contents

##### Blogger Settings

###### Page Controls

- `Add title tags to post?` check box -- If checked, <title>Title Here</title> is added to the top of the item being entered or updated.
- `App Key` input area -- specifies an application key used by the Blogger API.
- `Blogger URL` input area -- specifies the URL of a blog that supports the Blogger API.

Contents

##### CST Settings

###### Page Controls

- `App Key` input area -- an application key used by the CST API.
- `Base CST URL` input area -- the base URL of the CST blog server.
- `Encryption key` input area -- the key used to encrypt blog access.
- `Apply markup on server?` checkbox -- if checked, certain wiki-style markups are transformed into HTML by the blog server.

Contents

##### MetaWeblog Settings

###### Page Controls

- `MetaWeblog URL` input area -- specifies the URL of a blog that supports the MetaWeblog API.

Contents

##### Movable Type Settings

###### Page Controls

- `Movable Type URL` input area -- specifies the URL of a blog that supports the Movable Type API.

Contents

##### Network Settings

###### Page Controls

- `Proxy server user name` input area -- specifies the user name to be used by the proxy server.
- `Proxy server password` input area -- specifies the password to be used by the proxy server.
- `Proxy server port number` input area -- specifies the port number to be used by the proxy server.
- `Proxy server host name` input area -- specifies the host name to be used by the proxy server.
- `Use proxy settings` check box -- if checked, use the proxy settings.

Contents

#### Technorati Tags Window

Use this tool to manage Technorati tags for the blog item. Open it by selecting `Post / Technorati Tags` in the blog poster menu.

###### Window Controls

- `Tag` input area - enter a new tag.
- `Tags` list area - the list of tags to be associated with the blog item.
- `Add Tag` button - press to add a new tag to the list.
- `Remove Tag` button - press to remove a selected tag from the list.
- `OK` button - press to accept the tags in the list and close the window.

Contents

#### Trackback Request Editor Window

Use this tool to manage trackbacks to the currently item. Open it by selecting `Post / Trackback request editor...` in the blog poster menu.

###### Window Controls

- Trackback list - the list of feed items currently known to BottomFeeder for which trackbacks have been requested.
- `Add` button - press to be prompted for a trackback URL to add to the list.
- `Remove` button - press to remove the currently selected trackback from the list.
- `Exit` button - press to close this window.

Contents

| ## Browsing

#### Browsing Window

Open this window by

- Selecting the`Plugins > With Style...` command in the BottomFeeder main window .
- Selecting the `Post / Preview` command in the Blog Poster window.
- Selecting the `Preview` tool of the Blog Poster window.
- Selecting the `Preview` tool of the Comment Poster window.

You can find out how an item or comment that you have entered or updated will appear in a browser after its markup tags have been applied. This is a limited function browser. It requires a valid XHTML source to function properly. It does not always render HTML web pages correctly. This will improve over time as it is further developed.

###### Window Controls

- `<` button - press to go back to the previously displayed page.
- `>` button - press to go forward to the next page. This is enabled only after a request to page back.
- `Refresh` button - press to refresh the page from its source file.
- `Stop` button - press to stop the current attempt to retrieve a page from its source.
- `Address` input area - enter the URL of a page. Press the `ENTER` key to retrieve the page and display it.
- `Tabs` - press a tab to display a previously retrieved and saved page.
- `Page` output area - displays a webpage.
- `Status` output area - specifies the status of a request to the Internet.

Contents

#### Browsing Menus

##### File Menu

Contents

##### View Menu

Contents

| ## Editing

The `Comment Poster` window and the `Blog Poster` window support text editing in the same way, by means of a common editing pane and its associated tools.

Contents

### Editing Pane

###### Controls

- Editing toolbar - available only for WYSIWYG-style editing; toolbar icons are enabled only when they can be validly used.
- Text input area.

The Blog Tool and the Comment Tool support a number of markup options for your comments:

- Plain text, which you can roughly format by means of spaces, carriage returns and tabs.
- XHTML formatted text. This is text that includes elements with XHTML tags, such as the <b>text</b> for bold text. In general, you can use any XHTML tags that affect the presentation of text and images, and that can appear within an XHTML <body> element. XHTML is the lingua franca of the Internet and there are many available books and online references if you want to learn to use HTML.
- Wiki-style markup, which is converted to XHTML for you by BottomFeeder.
- WYSIWYG-style editing, in which the text you enter or select is formatted as specified by tools you choose in the WYSIWYG toolbar.

Contents

#### Wiki-style Markups

If you do not need the capabilities and complexities of XHTML, you can use simpler wiki-style markups.BottomFeeder transforms these markups into the equivalent XHTML tags. Here are the markup options:

!text!
  Enclose text in ! (exclamation) marks to make it bold.
_text_
  Enclose text in _ (underscores) marks to underscore it.
^text^
  Enclose text in ^ (caret) marks to make it italics.
`text`
  Enclose text in ` (backquote) marks to preserve its formatting.
/text\
  Enclose text in ` (forward and reverse slashes) to format it as an indented block quote.
-
  Starting a line with a dash character gives you a horizontal line.
*
  Starting a line with an asterisk gives you a bullet point in a list. Starting new lines with an asterisk gives you more bullet points in the same list. Starting a new line with something other than an asterisk ends the bullet list. You can also nest a list within a list by starting a new line with more asterisks.
#
  Starting a line with a hash gives you a numbered point in a list. Starting new lines with a hash gives you more numbered points in the same list. Starting a new line with something other than a hash ends the numbered list. You can also nest a list within a list by starting a new line with more hashes.
||
  Starting a line with two vertical bars starts a table, and each double bar starts a new cell. A carriage return indicates a new row. Starting the content with a { character aligns the cell to the left, while starting the content with a } aligns the cell to the right.
[Title of Link>http://www.blah.com]
  Text in this format gives you a link to the specified webpage.
  This is the same as an HTML anchor tag, of the form <a href="http://www.blah.com">Title of Link</a>
[img>http://www.blah.com/image.gif]
  Text in this format gives you an image in the displayed text.
  This is the same as an HTML image tag, of the form <img src="http://www.blah.com/image.gif>.

Two Carriage returns in sequence begins a paragraph.

Any text inside <pre></pre> tags is not transformed.

Contents

#### WYSIWYG Toolbar

This toolbar is located at the top of the editing area. It provides single-click execution of a number of frequently used editing tools.

Tool Icon | Action
--- | ---
| Cut the selected text after copying it to the clipboard.
| Copy selected text to the clipboard.
| Paste the contents of the clipboard at the current cursor position.
| Undo the last editing operation.
| Redo the last editing operation.
| Make the selected text bold.
| Italicize the selected text.
| Add a link at the current cursor position.
| Add a numbered item at the current cursor position.
| Add a bulletted item at the current cursor position.
| Add a table at the current cursor position.
| Select a paragraph style.

Contents

#### Checking Your Spelling

As you enter text into the `Editing` pane text input area, BottomFeeder marks any spelling errors in red and underlines them. You can fix them immediately or you can just keep typing and then go back to fix the errors. Right-click a spelling error and BottomFeeder gives you a menu of possible corrections. If you see the spelling you want, just select it; otherwise, position the cursor in the misspelled word and correct it yourself.

You will find that BottomFeeder does a good job of coming up with likely candidates for misspelled words, but this version of BottomFeeder does not allow you to say that a word marked as misspelled is really spelled the way you want. This can be important in technical documents that have a lot of special-purpose words and acronyms, so you can expect this feature in a future release of BottomFeeder.

Contents

| ## The End