Empowering Amiga(tm) Developers
Official AmigaONE X1000 Beta Test Member
Contributor to A1200.NET new Amiga 1200 Cases, and new Compatible Keycaps projects
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
|