Product Info


About AmigaOS4!
Empowering Amiga(tm) Developers
Official AmigaONE X1000 Beta Test Member
Official AmigaONE X1000 Beta Test Member
Contributor to A1200.NET new Amiga 1200 Cases, and new compatible keycaps projects
Contributor to A1200.NET new Amiga 1200 Cases, and new Compatible Keycaps projects
Amiga On The Lake - Retail Amiga Store for the US and Canada
New Amiga retailer serving the US and Canada
AOTL Donations
Donations
The SDK Browser - README / ABOUT

SDK Browser v2.1.5.0 [Special FREEWARE Release]
Copyright (c)2004-2018 by BITbyBIT Software Group LLC

Please visit www.bitbybitsoftwaregroup.com for more information on
The SDK Browser or AVD itself. Or email me at:
jamie@bitbybitsoftwaregroup.com

**********************************************************************
* SDK Browser (c)2018 BITbyBIT Software Group LLC
* ---------------------------------------------
* Copyright (c)2018 BITbyBIT Software Group, All Rights Reserved.
*
* SDK Browser v2.1.5.0 is a FREEWARE product from BITbyBIT Software Group LLC
* It can be posted on any Amiga site or other file area as long as the
* original archive is provided complete and without modification, and
* that this README file remain part of the archive(distribution).
*
* BITbyBIT Software Group LLC retains all rights to each distribution
* of the SDK Browser software and further reserves the right to request
* that older distributions be removed from any given web site or file
* area at any time.
*
* If you find The SDK Browser useful, and would like to see improvements and
* new software, and or simply want to support FULL TIME Professional software
* development for the AmigaONE(tm) and AmigaOS4(tm), then please consider
* purchasing the commercial version of this software. THANK YOU!
*
* The commercial version of the SDK Browser is available as a purchased
* product either on its own (US $24.95) or included as a component of the
* Advanced Visual Developer (AVD) Suite. Several powerful new features
* are still planned for the SDK Browser component and free upgrades are
* always included to the next major release number (in this case v3.0.0.0).
*
* Some features scheduled for the commercial release of version 3
* include, but are not limited to, Hex Dump display for binary files,
* AmigaGuide and "simple" HTML support, more cross-reference hot link
* support for all function and structure names within the AutoDocs and
* Include files. Locale support, a full GUI for all preference settings,
* seamless integration with AVD and much more.
*
* Please visit www.bitbybitsoftwaregroup.com to register your copy today!:-)
* Email: jamie@bitbybitsoftwaregroup.com
*
* BITbyBIT Software Group LLC MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT
* THE SUITABILITY OF THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING
* FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. BITbyBIT Software
* Group LLC SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY
* LICENSEE AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THIS
* SOFTWARE OR ITS DERIVATIVES.
**********************************************************************

About the SDK Browser:

Maintenance Updates:

  • v2.1.5.0 - Fixed a bug in the rarely used "Clear Text" method for
    the main text display area. The method call to the TEXTEDITOR
    object was formed incorrectly. Fixed.

  • v2.1.4.0 - Fixed a bug which where the selection of "Find Files (in dir):"
    on the Search line would disable parts of the interface
    as expected, but failed to restore them for the other
    search functions. This would effectively lock you out of
    being able to do other search functions. Fixed.

  • v2.1.3.0 - Fixed a bug which was preventing the SDK Browser from being
    launched from the CLI, due to a failure to register itself
    with the system, *if* the SDK Browser binary was not in the
    same directory it was being launched from.
    Bug reported by: James Jacobs (Amigan Software).
    The SDK paths for the MUI development files (SDK:MUI/...)
    have now been updated in this version to match their new
    location in AmigaOS SDK (53.31). All paths can still be set
    or overridden using their respective Tool Types.
    (See "Commands and Tooltypes" section below.)

  • v2.1.2.0 - Fixed a bug in the FREEWARE version which resulted in causing
    AmiDock to quit/crash when the SDK Browser itself was quit.
    Bug reported by: "imagodespira (Thomas)" on amigaworld.net forum.

  • v2.1.1.0 - Added exception code to find the "xenares.doc" file for the
    xena.resource library, which was expected to be named "xena.doc".
    Bug reported by: "Kamelito" on amiga.org forum.

New Features in v2.1.0.0:

  • The SDK Browser is now updated to build under the latest AmigaOS SDK (53.30)
    for AmigaOS 4.1 FE, and any older style API calls (now deprecated under 4.1
    FE), have been updated to use their modern equivalents.

  • All file scan and Grep Search functions within the SDK Browser have
    now been updated to use the newer AmigaDOS API calls, which support
    64-BIT filesystems. This means, not only faster file access, better
    memory management, but also full support for searching and reading
    files on very large drives.

  • (STRUCT)ure browsing has now been added to the pre-parsed navigation lists,
    allowing for live browsing and quick look-ups on the hundreds of
    struct { ... } declarations found within the AmigaOS SDK include files.

    As with the displayed content from the other lists, you may be able to
    navigate to the definition of another struct just by double clicking on its
    name in the main display. For example, let's say you were looking for the
    definition of the "List" structure (from exec/lists.h).

    1.) Under the "SDK" tab you select "Structures" from the pull-down list. (you
    can also use ALT+TAB to make the "SDK" tab active (if needed) and press
    "5" or "CTRL + 5" to choose "Structures")

    2.) Now either scroll down, or start typing the first few letters in "List"
    until you are viewing the struct List { ... } definition.

    3.) Looking at struct List { ... } you see it contains references to the
    "Node" structure. To quickly examine the definition of the Node structure,
    simply double click on the word "Node" in any "struct Node ..." reference
    and it should jump right to it (under exec/nodes.h).

  • User settable Fonts and displayed Tab lengths - The Fonts to be used in both
    the main Display and navigation Lists is now settable under the "View -> Set
    Fonts" menu. You can also quickly switch back to the system defaults font in
    the same menu as well. - The displayed Tab Length (for the main Display) is
    also settable under the "View -> Set Tab Size" menu. - Both of these new
    settings (and others) can be saved. (see"Enhanced user preference settings"
    below)

  • Dynamic target screen selector - Under the "View" menu there are two
    selections for immediately moving the SDK Browser window to another target
    screen; "Use AVD Workbench", which will attempt to open/move to the main
    screen for AVD (if available), and "Move to public screen..." which will open
    a quick selection list of all currently open public screens, allowing you to
    pick one where the SDK Browser window should move to. You can of course still
    set the default screen to open on using the PUBSCREEN tooltype (see below).

  • Mouse Wheel Variable Acceleration Mode This new dynamic accelerator for
    Mouse Wheel events allows for much faster movement through either the active
    list or body of text being displayed in the main window. It works by watching
    how fast *you* move the scroll wheel on the mouse, and accelerates or
    decelerates the amount of the display that is scrolled with every "step" in
    the wheel based on how quickly or slowly you move the mouse wheel.

    Normal mouse wheel movements only scroll one line of the display for every
    "step" of the wheel, no matter how quickly you move the wheel. However, when
    "Mouse Wheel Acceleration" mode is on (default), one "step" of the wheel may
    move half-way down a page of text in a single go. The effect builds the
    longer you continue to move the mouse wheel at the same or quicker rate,
    and slows back down as you slow down the movement of the scroll wheel.

    So for example, if you are viewing about a six page document, say about 250
    lines, under normal mouse wheel mode, it would take around 26 "rolls" of the
    mouse wheel to reach the last page of the file. However, under the new Mouse
    Wheel Acceleration mode, you could reach the last page of the document in as
    little as 2 or 3 *quick* rolls of the mouse wheel.

    Just try it out on a few different sized file views, and then turn off the
    accelerator by unchecking the "Enable Mouse Wheel Acceleration" menu option
    under "View -> Enable Mouse Wheel Acceleration" to see the difference.

    The goal of this mode is to give you the "best of both worlds"; single,
    controlled steps of movement when you need to carefully read through a
    section, and much faster "quick scan movement" when you want it.

  • Enhanced user preference settings. The following user settings will now be
    saved to ENVARC:BITbyBIT/AVD/ and restored the next time the program is
    loaded, (whenever you select the "SDK BROWSER -> Save Settings" menu option):
    - Target screen to open on; Workbench, selected Public screen or the
    AVD Workbench screen
    - Use System default or custom Font selections for both the navigation
    list and the main display - User settable Tab lengths (for the main
    display)
    - Mouse Wheel Variable Acceleration mode (Enabled/Disabled)
    - The SDK Browser's window position and size (both normal and Zoomed)
    - Pen value for the text color of the main display
    - Background Transparent mode (Enabled/Disabled) for the main display

  • Two new Search Modes have been added:
    - "Find Files (in dir)" which allows you to select a starting directory path
    (say SYS:), and a file pattern (say "#?.xml"), and the SDK Browser will
    assemble a list of all files it finds in that path that match the file
    pattern.

    - "Search (in Search Results)" which allows you to perform further "grep"
    searches within every file listed in the current Search Results. When run
    all files in the Search Results list which do *not* contain the text you
    are looking for will be removed from the results list, leaving only the
    files which do contain a match for the text in question.

    This action can be performed as many times as you like as long as there
    is at least one item still left in the search results list. Using this
    feature can allow you to "filter down" within a set of results to find
    some specific text. Take the above example for "Find Files (in dir)" to
    build a list of all files with an .xml extension on the SYS: volume, then
    use "Search (in Search Results)" to further find just the .xml files which
    contain say, the text "". Then when you select any of those entries
    in the Search Results list, it will open that file and jump to the first
    reference to that text ("") that is finds.

    As with all other actions run from the "Search bar" these new search
    actions are performed as a separate process, allowing you to continue
    to browse to any other area of the software (even the Search Results as
    they come in), while the search is being performed.

  • Two new "Open In.." options for locating the currently viewed file on the
    system have been added:
    - "Open in File Browser" sets the path to the current
    file in the "File Browser" tab of the SDK Browser itself.

    - "Open in Workbench window..." will open a window on the Workbench where
    the currently viewed file can be found.

  • New application Icon donated by Martin "Mason" Merz (www.masonicons.info)
    -- Thanks Mason!

  • Three new Tool Types have been added to allow for the remaining
    "Send File To" menu actions to be set externally, just like could already
    be done with "Editor" and "Web Browser". So the complete set of Tool Types
    for setting which programs are run for these actions are
    (shown with internal defaults):
    EDITOR = SYS:Utilities/NotePad
    MULTIVIEW = SYS:Utilities/MultiView
    WEBBROWSER = SYS:Internet/IBrowse/IBrowse
    PDFVIEWER = SYS:Utilities/AmiPDF/AmiPDF
    UNARC = SYS:Utilities/UnArc

    If none of this Tool Types are present when you launch the SDK Browser, then
    the above set of internal defaults are used. So, if for example you want to
    use the new MultiEdit and MultiViewer from A-EON's "Enhancer" package,
    simply set the EDITOR and MULTIVIEW Tool Types like this:

    EDITOR = SYS:Utilities/MultiEdit/MultiEdit
    MULTIVIEW = SYS:Utilities/MultiViewer/MultiViewer

  • A touch of Color - Two new menu actions have been added to allow some
    control of the background mode and text color of the main display area.
    - "View -> Set Display Color Pen..." menu action gives you the ability to
    set the text color of the Display Area to any Color Pen value (0 - 15).
    These represent using the system palette colors, as set with the
    preference tool SYS:Prefs/Palette.
    The default Color Pen is "1" (normally Black).

    - "View -> Set Background Transparent" menu action allows the user to
    enable or disable "Transparent" mode for the background color in the
    main Display Area (now on by default).

    This mode allow a possible background image texture to be displayed for
    the main text area, instead of rendering the solid background color. See
    SYS:Prefs/GUI, under the "Gadgets" Subsystem, General Tab -> Background
    texture.

    Please note that, unlike changes to the Color Pen value, changing the
    transparent background mode does not take effect on-the-fly. To see a
    change of this mode, first use "SDK BROWSER -> Save Settings", then
    "SDK BROWSER -> Quit SDK BROWSER", and run the program again. You will
    see a reminder of this in the status bar text at the bottom of the
    window, whenever this menu selection is made.

Features introduced in v1.6.0.0:

  • Critical long standing bug fix, which would often leave a garbage character
    or two at the very end of a displayed file under AmigaOS4(tm) - Update 4 and
    would cause a complete system lock under the OS4 Beta, has been fixed.

  • There were cases in v1.5.0.0 (and possibly earlier versions) where a public
    screen lock that was used to obtain information about the screen to open up
    on, was not being released. This would often cause Workbench screen changes
    (like with the ScreenMode prefs) to be blocked and unable to make live
    changes without rebooting and *not* running the SDK Browser. Happily,
    this too has been resolved.

  • Some improved filtering was added to help prevent duplicate entries from
    being added to the History browser. In v1.5.0.0 a new History item was added
    to the list every time you selected an item from the listbrowser, even if you
    were just expanding a collapsed tree-view item (like a library or function).
    So if you clicked 20 times on the same item you would end up with a list of
    20 identical items in the History list. Now, in version 1.6.0.0 only one
    entry will be added to the end of the list for that displayed file, no matter
    how many times you may reselect it.

Features introduced in v1.5.0.0:

  • Fully multitasking search bar with start/stop and pause/resume. File pattern
    filter added to search bar, and maintained separately for each search type.
    Interact with results as they are found, or continue to use all other parts
    of the SDK Browser as the search continues in the background. Search will
    continue even when hidden or iconified, and is controllable from the
    commodity exchange as well.

  • New History Bar added. Quickly return to any of the last 20 items that have
    been viewed previously. Browse forward or back with the arrow buttons, or
    pull down and select a new position within the browser history. The history
    bar works like a combination of a web browser forward and back buttons and a
    rotating 20 item tabbed display. Giving you the flexibility to quickly work
    with the last 20 items that have been referenced already.

  • Support for more than one interface(API) found within the same library.
    If the XML file for a given library contains more than one interface for
    accessing that library, then the SDK Browser will create a new browsable
    Library tree for each interface and name them with their respective
    interface name. This is also why the Interface name was added to each
    library entry under the Library list.

  • Many new improvements too numerous to list here.

Some other features found in this release:

  • Mouse-Wheel support using the new OS4 standard mouse-wheel events.
    Use Mouse-Wheel with qualifiers for even more browsing controls:
    Mouse-Wheel only = Vertical Scrolling(move up/down)
    Mouse-Wheel w/Shift = Horizontal Scrolling(shift left/right)
    Mouse-Wheel w/Alt = Vertical Scrolling(page up/page down)
    Mouse-Wheel w/Ctrl = Vertical Scrolling(home/end)

  • AppWindow/AppIcon support: Drag-n-Drop text files onto the SDK Browser
    window or Icon for quick viewing.

  • Faster than ever before using newly optimized viewing routines and
    less disk access.

  • Quick find ANY item in the active list just by typing the first few
    letters of its name.

  • "Includes" browsing. Live browse the system includes using the new embedded
    directory scanner.

  • Convenient "Send File To" menu for launching a helpful set of external
    viewers right from the SDK Browser. Quickly open source files into the editor
    of your choice, or open HTML files directly into your web browser of choice.
    You can also launch the currently selected file with "MultiView", "AmiPDF",
    or even "Unarc" those archives.

  • New keyboard controls to enhance the existing "mouse-over" focused movement
    keys and "mouse-wheel" support. (TAB rotates the main chooser under the
    SDK tab, while a-z "urgent" keys can be used for quick find indexing.
    Also "," "." "/" are now "Parent", "Enter", and "Root", respectively.)
    Alt+Tab now switches between "SDK" and "File Browser" tabs.
    Ctrl+Tab now rotates through the Search Types chooser.

  • Programmable SDK Paths. You can now specify up to 10 XML Interface paths,
    10 AutoDoc paths, and 10 Include file search paths, as well as a default
    "Project" path.

  • Programmable EDITOR and WEBBROWSER tooltypes (see below) for use by the
    "Send File To" menu.

Commands and Tooltypes:(Default Settings)
-----------------------------------------
CX_POPUP = YES
CX_PRIORITY = 0
CX_POPKEY = f1
PUBSCREEN =
HIDEKEY = esc
LEFT =
TOP =
WIDTH =
HEIGHT =
CENTERED = <-- This option overrides the LEFT and TOP values
(if specified)

You can set all of the "Send File To" external programs using:
EDITOR = SYS:Utilities/MultiEdit/MultiEdit
MULTIVIEW = SYS:Utilities/MultiViewer/MultiViewer
WEBBROWSER = SYS:Internet/IBrowse/IBrowse
PDFVIEWER = SYS:Utilities/AmiPDF/AmiPDF
UNARC = SYS:Utilities/UnArc

Each XML path listed below will be scanned for IDL (Interface Library
Descriptor) files and decoded to build the "Library" and "Commands" lists.
Do not override XML_PATH1 unless you know what you are doing.
(Default values are listed below as well)

XML_PATH1 = "SDK:Include/interfaces/"
XML_PATH2 = "SDK:Local/Documentation/MUI-3.9/xml/"
XML_PATH3 =
XML_PATH4 =
XML_PATH5 =
XML_PATH6 =
XML_PATH7 =
XML_PATH8 =
XML_PATH9 =
XML_PATH10 =

Each AutoDoc path listed below will be scanned in to build the "AutoDocs"
list. All files found under these paths will be added to the list as an
AutoDoc (this is so we do not filter out any normal text files like
"bootstrap.txt" or "rad.txt" that we actually want to keep).
Do not override AUTODOC_PATH1 unless you know what you are doing.
(Default values are listed below)

AUTODOC_PATH1 = "SDK:Documentation/AutoDocs/"
AUTODOC_PATH2 = "SDK:Local/Documentation/AutoDocs/"
AUTODOC_PATH3 = "SDK:Local/Documentation/MUI-3.9/AutoDocs/"
AUTODOC_PATH4 =
AUTODOC_PATH5 =
AUTODOC_PATH6 =
AUTODOC_PATH7 =
AUTODOC_PATH8 =
AUTODOC_PATH9 =
AUTODOC_PATH10 =

Each Include path listed here will be searched in order when The SDK Browser
needs to find a specific header file. The first two paths should only be
changed to the correct system header location (like if your SDK is not found
under SDK:). The first path also provides the "root" location for the
"Includes" directory scan lister. You are allowed to "parent" above it to
browse other areas of the SDK, and the "Root" button or keyboard "/" key will
provide an easy way to get back again.

INCLUDE_PATH1 = "SDK:Include/include_h/"
INCLUDE_PATH2 = "SDK:Include/netinclude/"
INCLUDE_PATH3 = "SDK:Local/common/include/"
INCLUDE_PATH4 = "SDK:newlib/include/"
INCLUDE_PATH5 = "SDK:Local/newlib/include/"
INCLUDE_PATH6 = "SDK:clib2/include/"
INCLUDE_PATH7 = "SDK:Local/clib2/include/"
INCLUDE_PATH8 =
INCLUDE_PATH9 =
INCLUDE_PATH10 =

The FILEBROWSER_PATH is the default path for the "File Browser" tab's
directory list. This is strictly for your own use, so set it to anywhere you
want. Like the first path of the "Includes", the path you specify here can be
returned to at any time using the "Root" button or "/" keyboard command. This
"root" location is reset every time you use the GetFile gadget under the
"Project" tab to select a new path location.

FILEBROWSER_PATH = SDK:

The next two tooltypes are used to specify what editor and web browser are to
be used by the "Send File To" menu. Make sure to use a full path here to your
program of choice. The full path and filename of the selected file is added
after the values defined below for each program. For example the default for
EDITOR is: "SYS:Utilities/NotePad ".

EDITOR = SYS:Utilities/NotePad
WEBBROWSER = SYS:Internet/IBrowse/IBrowse

  • NOTE: If your are programming using MUI for AmigaOS4(tm) and would like
    to live browse the MUI library using the SDK Browser, make
    sure the following Tooltypes are set in the SDK Browser icon
    (Assuming MUI is installed at SDK:MUI):

    XML_PATH2 = SDK:MUI/xml/
    AUTODOC_PATH3 = SDK:MUI/AutoDocs/MCC
    AUTODOC_PATH4 = SDK:MUI/AutoDocs/MUI
    INCLUDE_PATH8 = SDK:MUI/C/include/

*** About BITbyBIT: ***

BITbyBIT Software Group LLC was formed in November of 2003 by Jamie Krueger
as a new software development company dedicated to producing high quality
software for the latest release of the AmigaOS4(tm) operating system,
AmigaOS4(tm). The primary focus of the company is to bring a new level of
professional software development tools, in an easy to use graphical
environment, to the AmigaOS4(tm) platform. This software development suite
is called AVD (Advanced Visual Developer).

It is only through the outstanding support of the Amiga Community itself that
the AVD project and software like the SDK Browser, AVD Template Project and
others can be brought to AmigaOS4(tm). Please do your part to ensure the
success of this great platform by purchasing commercial AmigaOS4(tm) software
today, or make a direct monetary donation to support efforts such as this.
THANK YOU!

BITbyBIT Software Group LLC is located in Janesville Wisconsin in the USA.

BITbyBIT Software Group LLC
1617 Kensington Street
Janesville, WI 53546-5833
USA
jamie@bitbybitsoftwaregroup.com
www.bitbybitsoftwaregroup.com

ENJOY!

view / download the plain text version here: README in Plain Text
© BITbyBIT Software Group LLC and Jamie Krueger, 1617 Kensington Street, Janesville, WI 53546-5833
Original Site design, html and css by David Doyle, site engine by Björn Hagström - Hosted by AbuckAmegAyear