Radio UserLand Kick Start: Finding Documentation

This is part of Chapter 1 of the book Radio UserLand Kick Start by Rogers Cadenhead, published by Sams Publishing

Because there's no official manual for the product, the first question most technical-minded Radio users are likely to ask is where to find documentation for the software's features.

The best answer, I hope, is this book.

However, UserLand continues to offer new features for Radio, which can be upgraded automatically each night as the application runs.

Also, one of the truisms of computer book publishing applies here: There's no better way to spur revolutionary changes in technology than to document the current version extensively in print.

There are several sources for information I check regularly for information about UserTalk programming and new Radio functionality:

  • DocServer, online documentation for hundreds of verbs, scripts in the object database that you can call in your own programs. Although the site says the documentation is for Frontier, it covers many features of Radio as well because the same scripts are available in both products. Here's an example of a short script that makes use of the clock.now() verb and several date verbs to display the current date in month/day/year format:

    local (w = clock.now());
    local (mdy = date.month (w) + "/" + date.day (w) + "/" + date.year (w));
    dialog.notify ("Date: " + mdy)

    This script opens a small dialog box with a message such as "Date: 7/30/2003".
  • UserLand weblogs: Because each of these offers an RSS newsfeed, you can read them using Radio's aggregator.
  • UserLand discussion sites and mailing lists:
  • Radio.root Updates, an RSS newsfeed documenting bug fixes and additions to the object database, which occur as often as several times a week. This URL can be read only with the news aggregator.
  • Frontier: The Definitive Guide (ISBN 1-56592-383-9), a 1998 book by Matt Neuberg that covers Frontier. You can read it online. Although the book doesn't cover Radio and is out-of-date in some areas, it offers coverage of the UserTalk scripting language and the object database that is extremely useful.
  • Workbench -- Last but not least, my own weblog extensively covers new developments in Radio.

The biggest source for documentation about Radio is the Google search engine. UserLand's Web site contains more than 199,000 pages, and by limiting a search using the term site:userland.com along with the keywords you are seeking, you can often find pages by UserLand developers or users describing a particular feature of Radio or Frontier.

Chapter 1:

  1. Introduction
  2. Using Radio UserLand
  3. Starting the Application
  4. Reading XML Information Sources
  5. Extending Radio's Capabilities
  6. Finding Documentation
  7. Extending Radio with Tools
  8. Publishing Files Automatically
  9. Summary

Radio UserLand Kick Start home page