SUMMARY
-------
Ranger is an Amiga OS diagnostic tool which displays all sorts of
Amiga OS resources.

Ranger will automatically update the list of processes and DOS
devices as they are added and removed. Refresh buttons are provided
for everything that is not automatically updated.

Any data which can be displayed without using Forbid() and/or Disable()
will not be displayed until you hit a refresh button. Everything else
will be automatically displayed. This is to avoid problems with starting
up Ranger when the system is in an indeterminate state.

Signals can be generated for processes which helps programmers when
those processes are stuck waiting.


UNDEFINED FIELDS
----------------
Please note that if you see a field that says "Undefined" it most
likely means Ranger is missing a definition. Email me describing
which field and the circumstances so that it can be fixed.


PCI DEVICE AND VENDOR DECODING
------------------------------
Automatic PCI device and vendor decoding is provided via the pci.ids file
which is maintained at official support site http://pciids.sf.net

A copy of the pci.ids file included in the archive for your convenience
and is refreshed directly from the source with each Ranger release.

Manually copy the pci.ids file to DEVS: and Ranger will be able to decode
the device and vendor codes into string labels. If the file is not present
Ranger will only display the codes in hex.


AUTHOR
------
Please feel free to contact me if you have any suggestions, comments
or questions:

Steven Solie
steven()solie.ca
http://www.solie.ca/

If you would like to support further development of Ranger for AmigaOS
or any of my other AmigaOS related projects please consider a donation
via PayPal to the email address listed above. Thanks!


HISTORY
-------
1.51 - Added symbol decoding to the stack trace. This is the same
       symbol decoding used by GrimReaper.
       (thanks Hyperion Entertainment & Hans-Joerg Frieden)
     - Fixed underscore handling in Network/Interface chooser.
       (thanks Rene W. Olsen)
     - Added resizing of the Window if it is 1 pixel or smaller to
       the "Make Visible" feature.
       (thanks Michael Merkel)

1.50 - Added Process stack trace display to the DOS/Processes tab.
       This feature only decodes PPC stack frames and displays the
       instruction pointer as the first line (in bold). A big thanks
       to Joerg Strohmayer for the example stack trace code!
       (thanks Sebastian Bauer)

1.49 - Added Window box information and "Make Visible" feature for
       Windows to GUI/Objects tab.
       (thanks Michael Merkel)

1.48 - Added support for Sam460ex and AmigaOne X1000 platforms in
       the Hardware/Machine tab.
     - Added DOS/General tab.

1.47 - Fixed bug which did not display the library interface version.
     - Fixed bug which did not display the correct mouse input device.
     - Split the Input tab into Input/General and Input/Keyboard tabs.
       The Input/Keyboard tab displays the current keyboard reset
       handlers installed (if any).
     - Added key repeat period and threshold to Input/General tab.

1.46 - Fixed bug which didn't display the device unit in the Network tab.
     - Added new Network tabs: General, Interfaces and Sockets.
     - Compacted Hardware/Gfx Boards tab to take less vertical space.
       (thanks Sebastian Bauer)
     - Moved open count and version fields to the main lists in the
       Exec/Libraries and Exec/Devices tabs.
       (thanks Sebastian Bauer)
     - Some minor changes to this file.
     - Compiled with SDK 53.20.

1.45 - Fixed incorrect year in the date string.
       (thanks Ken Wilde)

1.44 - Added read/write I/O request stats to the Network tab.
     - Fixed crash when running Ranger without the Roadshow TCP/IP stack.
       (thanks Alan Novak)
     - Ranger will no longer close when the TCP/IP stack shuts down.

1.43 - Updated to new AmigaOS standard icon size.
       (thanks Ken Lester)
     - Fixed bug in Hardware/BIOS tab which did not refresh the
       display properly after sorting the variables.
       (thanks Ken Wilde)
     - Added row striping to make it easier to read the read-only
       tables. Requires listbrowser.gadget 53.30 or higher.
     - Updated copyright notice.

1.42 - Added DOS/FileDirNotify tab which displays all the active
       file and directory notifications.
     - Changed several tabs to automatically refresh when the tab is
       clicked. Only tabs which require Forbid() or Disable() calls
       are not automatically refreshed now.

1.41 - Added home directory field to DOS/Processes tab.
       (thanks Michael Merkel)

1.40 - Added monitor DDC information to Hardware/Gfx Boards tab.
       Requires Picasso96API.library 2.354 or higher.
     - Added new effects fields to Screen and Window attributes
       in the GUI/Objects tab.
     - Bumped stack cookie to 80k.

1.39 - Added Exec/IntHandlers tab which displays information about the
       interrupt handlers.
     - Fixed problem with Exec/Semaphores tab column widths.

1.38 - Added GUI/Fonts tab which displays all the font types available.
     - All GUI tabs no longer scan until the Refresh button is pressed.
     - All clicktabs are now dynamic.

1.37 - Added Received Signals field to Exec/Tasks and DOS/Processes tabs.
     - Added Owner field to DOS/Processes tab.
     - Added Hardware Addr field to Network tab.
     - Fixed Gfx Boards tag refresh so it doesn't clobber the
       PCI device and vendor fields.
       (thanks Javier de las Rivas)
     - Updated copyright notice.

1.36 - Added support for new format types in Gfx Boards info.
     - Added PCI Device and Vendor fields to Gfx Boards info.
     - Added PCI Header Type field to PCI tab.
     - Added Pegasos 2 machine type decoding to the Machine tab.
     - Fixed problem with PCI tab not displaying all the devices
       on the Pegasos 2.
     - Corrected spelling of Sam440ep board.
     - Compiled with GCC 4.2.4 and latest SDK.

1.35 - Increased minimum stack cookie to avoid stack swapping.
     - Added new App tab which accesses some application info.
     - Fixed Exec/Port display which had priority as an unsigned value.
       (thanks Tjitte de Wolff)

1.34 - Fixed user error messages to display a requester instead of
       only outputting text to the shell
       (thanks Darren Eveland)
     - UBoot environment variables are now optional so Ranger will
       run on Classic PPC machines again
       (thanks Darren Eveland)
     - Fixed device global vector descriptions
       (thanks Colin Wenzel)

1.33 - Added SAM440ep support
     - Added frequencies display to Hardware/Machine tab

1.32 - Added Hardware/BIOS tab
     - Added DOS/GlobalVars tab
       (thanks Ken Wilde)
     - Refactored code to use SetPageGadgetAttrs() where appropriate

1.31 - Fixed build system problem which did not clean properly which
       caused the Hardware page to not refresh correctly
       (thanks Ken Wilde)
     - Added DOS/Assigns tab
     - Added more checks for the DOS/Devices and DOS/Volumes data scans

1.30 - Added DOS/Volumes tab with lock list
     - Fixed bug in DOS/Devices which did not refresh the displayed
       info. when the user pressed the refresh button
     - Refactored build system to use multiple directories due to
       source code base growth

1.29 - Added Exec/NamedMem tab
     - Fixed Exec/Devices query information command list so it displays
       as many entries as possible

1.28 - Added Exec/Resources tab

1.27 - Added Exec/ResetHandlers tab
     - Added font preferences option
       (thanks Ken Wilde)

1.26 - Added support for new V52 Process flags
     - Added new GUI/Objects tab which displays info. on the Screens,
       Windows and Gadgets

1.25 - Changed BOOPSI public class scanning code to avoid private
       function calls
     - Now sets the font to DejaVu Sans/12 to fit more info.
     - Added DIPF_IS_HWCOMPOSITE flag display to screen modes
     - Compiled with GCC 4.2.4

1.24 - Changed Exec/Ports to a list sorted by priority
     - Updated to use AllocVecTags()
     - Added new GUI tab
     - Moved ScreenModes to GUI tab
     - Added BOOPSI public class tree display to GUI tab
     - Renamed TCP/IP tab to Network
     - Added file system block size
       (thanks Ken Wilde)

1.23 - Added tc_UserData field display to Task info.
     - Added pr_Entry, pr_Exit and pr_Final fields to Process info.
     - Window location and size are now persistent and stored in the
       Ranger.prefs file
     - The pci.ids are now automatically updated each time an
       upload archive is created

1.22 - Added unit and flags fields to NSD query function so user can
       query the device using various parameters.
     - Added Exec Semaphores tab
     - Now sorts the list of Exec Tasks by name

1.21 - Now clears the exec device query results during refresh.
       (thanks Alex Carmona)

1.20 - Fixed broken pci.ids setting when device codes repeated.
       (thanks Alex Carmona)
     - Added display of missing libraries via GUI
     - Added missing prefixes for disk based BOOPSI classes

1.19 - Added Exec/Devices tab
     - Merged Ext. Flags into Flags for Libraries info.
     - Fixed broken pci.ids file parsing routine
       (thanks Alex Carmona)
     - Added DOS tab and moved in Processes and Devices
     - README.txt file now has w bit set
       (thanks number6)
     - Now refreshes the DOS Processes and Devices lists when the DOS
       tab is selected
     - Fixed Processes pause button to refresh the list when deselected

1.18 - Added DNS servers to TCP/IP tab
     - Added Exec tab and moved in Tasks, Ports and Libraries
     - Added low memory handlers display
     - Added appicon support so Ranger can be iconified

1.17 - Added several new fields to the DOS device file system
       information section
       (thanks Ken Wilde)
     - Added parsing of DEVS:pci.ids file if present to decode the
       PCI device and vendor codes (see http://pciids.sf.net)

1.16 - Added PCI tab with a PCI bus tree and device information
     - The minimum stack size is now retrieved only for the currently
       displayed process because it was crashing when called during
       the main scanning loop

1.15 - Refactored the process stack scanning code so Disable/Forbid is
       called for the currently selected process only
     - Device list is now automatically refreshed using the same
       timer used for the process list refreshing
     - Device list is now sorted alphabetically
     - Window now opens centred on the screen
     - Fixed problem with large strings causing graphics corruption
       (thanks Darren Eveland)
     - All the fields under the Hardware tab can now be copied & pasted

1.14 - Libraries are now sorted alphabetically
     - Added signalling so you can send signals to a process which is
       very helpful when you have a stuck process waiting on some signal

1.13 - Added a $STACK cookie to ensure the stack is large enough
     - Added minimum stack size display ($STACK cookie value)
     - Added board number and scanline info. to screen modes
     - Added new Hardware tab which contains Machine and Gfx Boards tabs
     - Added machine type, memory size and machine extensions

1.12 - Fixed missing WaitPort() in update timer restart
     - Added scan rates to screen modes display using double floating
       point math for maximum resolution

1.11 - Fixed crash in Process stack scanning code which was not protected
       by a Forbid()
     - The Process list now refreshes at most once per second instead of
       every time the Process list changes to avoid event flooding
     - Added pause button to Process list
     - Combined PID and PPID into one field for processes
     - Added display of pr_WindowPtr field for processes
     - Added Device listing with file system information

1.10 - Added Input tab with input.device information
     - Merged TCP/IP Device and Unit fields into one field
     - Changed some keyboard tab shortcuts

1.9  - Added TCP/IP tab with networking information
     - Lists that required a Forbid() are no longer created when starting
       up which helps when launching Ranger during heavy system loads
     - Fixed two MemGuard hits related to invalid memory pool use
       (thanks Rene W. Olsen)
     - Left and right arrow keys will now change the selected
       Library Interface when used in the Library tab

1.8  - Added Project menu with About and Quit options
     - Arrow keys will now activate the current list without using
       the mouse first
     - Fixed holes in updates which could try to access invalid Task
       or MsgPort data
     - Added Libraries page with Library and Interface information

1.7  - Window is now active when opened
     - Added ScreenModes tab with info. on each mode
     - Refresh button have unique keyboard shortcuts now
     - Adjusted default list widths
     - Disabled extra CON: process when run from Workbench

1.6  - Now uses pr_StackSize if dos.library 52.19+ is installed
       (thanks Colin Wenzel)
     - Changed Process scanning to avoid allocating memory during scan
     - Now allocates Hooks with AllocSysObject()
     - Added CPU tab with all sorts of info.
     - Port scan now disables interrupts
     - AutoInstall script was in the wrong place for AmiUpdate
     - Added PID and PPID for Process display

1.5  - Added task state display
     - Added task user allocated signals display
     - Changed Task scanning to use Forbid() and Disable()
       (thanks Colin Wenzel)
     - Added AmiUpdate support
       (thanks Simon Archer)

1.4  - Added brand new icons
       (thanks Kenneth Lester)
     - Added extension to README file
     - Added public MsgPort display tab
       (thanks Paul E. Bloedel)
     - Fixed a bug which caused crashes when Task list was refreshed
     - Now moves the cursor up and down with the arrow keys
       (thanks Alex Carmona)

1.3  - Added wait signals display
     - Added tabbed display of Tasks and Processes
     - Minor cosmetic changes
     - Disables weight bars if layout.gadget is 52.1 due to
       a bug in layout.gadget
       (thanks Joerg Strohmayer)

1.2  - Added stack usage display
       (thanks Colin Wenzel for the code)

1.1  - Added Command field with optional arguments
     - Changed Update button label to Refresh

1.0  - First public release