home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
prjbld.zip
/
PRJBLD.INF
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1999-02-15
|
2MB
|
1,595 lines
ΓòÉΓòÉΓòÉ 1. Overview ΓòÉΓòÉΓòÉ
PrjBld: OS/2 Programmers Project Folder Creation Tool
Copyright (c) 1998, IDK, Inc.
All Rights Reserved
Visit our Web site!
View IDK web site with Netscape
View IDK web site with Web Explorer (not recommended)
If you have problems with your browser, click here: Netscape and Explorer
Introduction
ΓòÉΓòÉΓòÉ 1.1. Disclaimer ΓòÉΓòÉΓòÉ
Use this software at your own risk!
This is a pre-release product, and has not been fully tested. While we have
made every attempt to ensure that the software is free from bugs, IDK, Inc. is
not responsible for any loss of data due to use of this program. Read the
complete license for details.
Please backup your desktop prior to using PrjBld!
All product names mentioned in this document are the property of the copyright
holders.
ΓòÉΓòÉΓòÉ 1.2. Introduction ΓòÉΓòÉΓòÉ
Introduction
PrjBld is a folder and application icon creation tool targeted to programmers
using OS/2 as a development platform. Project folders created by this program
are not compiler/language specific.
Folders created by this product compartmentalize your project into a single
folder. The folder contains all the tools you need to work on any aspect of
product development. Each application icon is preconfigured to work on files
within your main project directory. The command line parameters and DOS
Settings (if any) of each application icon are also preconfigured.
With a few mouse clicks you can be up and running on any project: All program
icons are automatically customized to work with your project! PrjBld will add
directory shadow icons for all the directories that are important to your
project. PrjBld will create any missing paths for you, if you are starting on
a brand new project.
PrjBld will instantly create a project folder for existing projects too.
PrjBld is easily configurable to support DOS, WinOS/2 and OS/2 hosted compilers
and development environments.
In seconds, you can create a folder like this:
Each icon in the folder shown above is preconfigured to open in the proper
project subdirectory, or act on the source code found in the main project
directory.
PrjBld has the following features:
Creates a new project directory if it does not already exist
Creates a project folder and populates it with tools
Adds directory shadows to important directories for quick access
Adds OS/2 and DOS window icons targeted to your project directory
User can specify individual DOS or WinOS/2 settings for each tool
Extensive drag & drop support for files and directories
Extensive help built in
See Usage Notes for tips, limitations, and a list of known bugs.
ΓòÉΓòÉΓòÉ 1.3. Requirements ΓòÉΓòÉΓòÉ
Requirements
PrjBld has the following requirements:
OS/2 Warp version 3 or greater (Tested on OS/2 Warp 4.0 only, but should
work on 3.0)
2.5 Mb hard drive space
32M memory recommended
ΓòÉΓòÉΓòÉ 1.4. Installation ΓòÉΓòÉΓòÉ
Installation
To install, simply unzip the contents of the prjbld release zip into an empty
directory; we recommend c:\prjbld, but any directory name is fine. Next, run
the enclosed INSTALL.CMD file to create the PrjBld icon on your desktop.
If you would like some free animated folder icons (about 550 of them) for use
with PrjBld, click on one of the links below:
Download fldico.zip (570k) using Netscape
Download fldico.zip (570k) using Web Explorer
If you have problems with your browser, click here: Netscape and Explorer
Note that the FLDICO.ZIP file contains some long file names and should be
unzipped on an HPFS drive if you want to see all of them. Unzip them into an
empty directory. Once you use one of the FLDICO.ZIP icons, PrjBld will
remember the path to this directory.
If you do not have a current VROBJ.DLL (rev D) in your LIBPATH, You will need
to manually install one. Note that VROBJ.DLL is used by all VXREXX programs.
Click on one of the links below to download the latest version of VROBJ.
Download VROBJ.DLL (400k) using Netscape
Download VROBJ.DLL (400k) using Web Explorer
To uninstall, please run the UNINSTAL.CMD file. It will remove most of the
files associated with PrjBld as well as the PrjBld desktop icon. Delete the
C:\PRJBLD directory and its contents to finish the uninstall process.
Uninstall leaves the PRJBLD.INI intact so that you can reinstall and retain
your old settings and registration information. You will probably want to keep
VROBJ.DLL, as this is used by all VXREXX applications - not just PrjBld.
ΓòÉΓòÉΓòÉ 1.5. Support ΓòÉΓòÉΓòÉ
Support
Support for this pre-release is handled only by email We would like to hear
from you about any questions, comments, suggestions or bug reports for PrjBld.
Please contact IDK via:
Email: prjbld@idk-inc.com
Thank you for trying PrjBld!
Visit our Web site!
View IDK web site with Netscape
View IDK web site with Web Explorer (not recommended)
Send mail to IDK, Inc. via Netscape
Send mail to IDK, Inc. via Web Explorer
If you have problems with your browser, click here: Netscape and Explorer
ΓòÉΓòÉΓòÉ 1.6. Usage Notes ΓòÉΓòÉΓòÉ
Usage Notes
These sections give tips, limitations, a list of known bugs and troubleshooting
information.
The top level window is usually the only one you will have to interact with
when creating a new project - after configuring PrjBld that is.
For each new project you will have to select a unique project name. If you
want to have a line break in the project name (on the Project folder icon), use
a caret (^) character like so:
My^Very Very Long^Project Name
The project name is used only for the folder Icon text.
Warning! If you use an existing project name, the old project folder will be
destroyed and replaced by a new one.
Normally this is not a big problem - your source code and other files are not
affected, but any customized object settings for the icons in the old folder
will be lost. Only folders created with PrjBld can be overwritten by PrjBld in
this way.
PrjBld uses special object IDs for project folders that you are unlikely to
have used. Note that the ability to overwrite folders is actually a feature.
You can fix a "broken" project folder in just a few seconds.
Next, enter a fully qualified path to your project directory. If the path does
not exist, it will be created for you. You may drag and drop a directory here,
click the browse button or right-click the field. PrjBld uses this path to
"point" all your tools to this directory. Normally this subdirectory contains
most or all of the source code for the current project.
Next, enter the location of the folder that contains all of your projects. If
you leave this field blank, the new project folder will be created on your
desktop. PrjBld remembers the loaction of the top level project folder. The
easiest way to enter the folder location is to drag/drop the top level project
folder on this field.
Insure that your configuration settings are correct, and then click the Create
button.
If the resulting project folder has Program or shadow icons that you don't
need, simply delete them with the Delete key or your shredder. Deleting a
PrjBld icon does not affect the associated application or subdirectory.
ΓòÉΓòÉΓòÉ 1.6.1. Tips ΓòÉΓòÉΓòÉ
Tips
This section contains hints and tips for using PrjBld effectively.
Make sure you go through all the Config notebook pages and set all the fields
appropriately before use.
Using PrjBld, create Program Objects for common tools like word processors. In
the command line settings, use a relative path like:
.\DOCS\MANUAL.DOC
Now you can double click on the Star Office program object in your project
folder and have it automatically open the manual for your project.
Make maximum use of Drag & Drop - it will save a lot of keystrokes and "mousing
around".
ΓòÉΓòÉΓòÉ 1.6.2. Limitations ΓòÉΓòÉΓòÉ
Limitations
PrjBld can not handle drag and drop of Program Objects. You can only drag and
drop executable file objects (*.EXE, *.CMD, *.COM) and directory folders.
ΓòÉΓòÉΓòÉ 1.6.3. Known Bugs ΓòÉΓòÉΓòÉ
Known Bugs
This section describes known bugs in the current (pre-release) version.
There are no known bugs
ΓòÉΓòÉΓòÉ 1.6.4. Troubleshooting ΓòÉΓòÉΓòÉ
Troubleshooting
This section will contain information on diagnosing problems or gathering
information for technical support.
The console window contains messages concerning the creation success or failure
of each new object. If something goes wrong, please inform Tech Support of the
exact failure message.
ΓòÉΓòÉΓòÉ 2. Register ΓòÉΓòÉΓòÉ
Register PrjBld!
PrjBld is Shareware. If you use it beyond a 30 day trial period, you should
either pay for it or delete it from your computer.
Paying for (Registering) PrjBld is very easy and inexpensive. After paying for
PrjBld, you will be sent a registration key that will remove the startup delay
and nag screen.
Click one of the options below to Register PrjBld
View BMT Micro web site online registration with Netscape.
View BMT Micro web site online registration with Web Explorer.
View Snail-Mail registration form.
If you have problems with your browser, click here: Netscape and Explorer
When you receive your registration number, click the About button on the main
PrjBld form. The following screen should appear:
Enter your name exactly as it was supplied in your registration paperwork or
Email. Next, enter your registration and serial numbers. Click the Ok button.
If you typed everything in correctly, the nag screen should no longer appear.
ΓòÉΓòÉΓòÉ 3. Actions ΓòÉΓòÉΓòÉ
How to use the PrjBld Interface
PrjBld accepts inputs using the Mouse, Keyboard and by dragging and droping of
file and directory icons.
All changes to data fields are saved immediately after the change has been
made.
ΓòÉΓòÉΓòÉ 3.1. Keyboard ΓòÉΓòÉΓòÉ
Keyboard Use
"Alt+" combinations are reserved for field and button movement. Each data
field or button with an associated accelerator key has an Underlined letter in
the caption. Hold the Alt key down and press the letter associated with the
field or button you want to jump to. The field will be given the input focus
or in the case of buttons,, activation of the button function will result.
In all windows and notebook pages, you may use the Tab key to move between
fields.
In multiline editor fields, use the Enter key to make line breaks between each
line of attribute information. It is not necessary to add trailing semicolons
(;) to attribute/settings lines.
In the text editor, you can use most standard movement and selection keys, plus
some additional, as follows:
Up, Down, Right, Left: basic movement
Home, End: beginning or end of line
Ctrl+Home, Ctrl+End: top or bottom of section
Ctrl+Right, Ctrl+Left: move right or left by one space delimited word
Ctrl-Insert save highlighted text to the clipboard
Shift-Insert inserts text in clipboard to the field with input focus
ΓòÉΓòÉΓòÉ 3.2. Mouse ΓòÉΓòÉΓòÉ
Mouse Use
Left-Click (LMB) on fields to give them the input focus.
Right-Click (RMB) on Path fields to pop up a path selector dialog box.
Left-Click notebook tabs to jump to the desired page. Note: Not all pages
have a tab.
Left-Click the small arrow icons at the lower right of the Config notebook to
scroll from page to page.
Left-Click buttons to activate them.
In text editor fields, click with the left button to move the keyboard cursor.
Double-click to move the keyboard cursor and then select the cursored word.
Drag after a click or double-click to extend the selection.
Moving the mouse over a control without clicking to see "hint" help on that
control.
ΓòÉΓòÉΓòÉ 3.3. Drag & Drop ΓòÉΓòÉΓòÉ
Drag & Drop
All Executable and Path fields support drag and drop of File or Directory
icons. If you attempt to drop an inappropriate object on a path field, the
"you can't do that" mouse cursor will appear.
To add a path using a drag and drop move, open your Drives object and select
the appropriate drive letter.
Next, find the directory folder you want to use for a project directory. Press
and hold the Right Mouse Button (RMB) on the desired directory. While holding
the RMB mouse button down, drag the mouse to the desired path field in PrjBld.
Release the RMB when the mouse cursor/folder icon is over the top of the PrjBld
field. The field will automatically fill in with the path of the folder you
just dragged and dropped.
Use the same technique on EXE, CMD and COM objects in the DOS, PM and WinOS/2
notebook pages.
Note: Unfortunately, you cannot drop Program objects on path fields. Find the
actual EXE associated with a Program object and drop it on the PrjBld field
instead.
ΓòÉΓòÉΓòÉ 3.4. Netscape and Explorer ΓòÉΓòÉΓòÉ
Netscape and Explorer
This help file (INF) contains several links to WWW and FTP sites. Clicking on
a Netscape or Explorer link will launch your browser and connect to the
appropriate site. We strongly recommend that you use Netscape, since several
of the links point to WWW sites that use HTML frames. They will look pretty
ugly when viewed with Explorer.
Note that on some workstations, it may be necessary to connect to the Internet
manually prior to using one of these INF links. This INF does not
automatically invoke the dialer via LINKUP.EXE.
Check out InJoy if you want to automatically connect to the Internet when an
application tries to access a WWW or FTP site... or get a cable modem.
ΓòÉΓòÉΓòÉ 4. PrjBld Program Windows ΓòÉΓòÉΓòÉ
PrjBld Windows
The Startup window appears when you first invoke PrjBld. It is used to select
the name of the new project and the top level directory of the project source
code.
The Main Folder window appears when you first click on the Config button. It
is the first page of the settings notebook.
The DOS Application notebook page appears when you click on one of the DOS
Application notebook tabs. You are allowed to specify up to 4 DOS applications
that PrjBld will create program objects for.
The PM Application Settings notebook page appears when you click on one of the
PM Application notebook tabs. You are allowed to specify up to 4 Presentation
Manager (PM) applications that PrjBld will create program objects for.
The Shadow Paths notebook page appears when you click on the second page of the
Main Folder notebook tab. There are seven paths for commonly used project
directories. You can use relative or fullly qualified paths.
There are 4 WinOS/2 Applications notebook pages that allow you to create up to
4 WinOS/2 application icons (Program objects)
The DOS Command Window notebook page allows you to create a DOS Command window
object targeted to your project. This object will automatically open up in
your project directory so that you can run DOS command line utilities or test
new DOS programs. The notebook page allows you to set special DOS Settings for
this DOS window only that override any global DOS settings you may have
specified during your initial Warp install. This allows you to use DPMI
memory, IDLE_SENSITIVITY, Etc. settings specific to your project development
environment. You may also select full screen or windowed VDM mode.
The OS/2 Command Window notebook page allows you to create a windowed or full
screen OS/2 command prompt window. The window will use the project path as the
default directory. Use this command prompt object to run text mode OS/2
applications and utiliites against your project source.
ΓòÉΓòÉΓòÉ 4.1. Startup Window ΓòÉΓòÉΓòÉ
Startup Window
The top level window is usually the only one you will have to interact with
when creating a new project - after configuring PrjBld that is. Use this
window to create new project folders.
For each new project you will have to select a unique project name. The
project name is used only for the folder Icon text.
Next, enter a fully qualified path to your project directory. Normally this
subdirectory contains most or all of the source code for the current project.
You can use the Browse button to assist you with path selection.
Next, enter the location of the main folder that contains all of your projects.
If you leave this field blank, the new project folder will be created on your
desktop.
PrjBld remembers the location of the main (top level) project folder. The
easiest way to enter the folder location is to drag/drop the top level project
folder on this field.
The two folder icon fields show the open and closed folder icons that will be
used to create the new project folder. If you want to change them, drag and
drop a new folder icon on the appropriate field. If you would rather use a
file selection dialog, right-click on the icon field to pop up an Icon
viewer/selector. Prjbld remembers the paths to each icon.
Insure that your configuration settings are correct by reviewing the settings
notebook found under the Config button, and then click the Create button.
If the resulting project folder has Program or shadow icons that you don't
need, simply delete them with the Delete key or your shredder. Deleting a
PrjBld icon does not affect the associated application or subdirectory.
Press the Quit button to exit PrjBld.
For fun, click on the picture.
ΓòÉΓòÉΓòÉ 4.1.1. Project Name ΓòÉΓòÉΓòÉ
Project Name
Enter the name of the project. This string will appear below the project
folder icon.
Warning! If you use an existing project name, the old project folder will be
destroyed and replaced by a new one. Normally this is not a big problem - your
source code and other files are not affected, but any customized object
settings for the icons in the old folder will be lost.
Only folders created with PrjBld can be overwritten by PrjBld in this way.
PrjBld uses special object IDs for project folders that you are unlikely to
have used. Note that the ability to overwrite folders is actually a feature.
You can fix a "broken" project folder in just a few seconds.
If you want to have a line break in the project name (on the Project folder
icon), use a caret (^) character like so:
My^Very Very Long^Project Name
ΓòÉΓòÉΓòÉ 4.1.2. Project Directory ΓòÉΓòÉΓòÉ
Project Directory
Use this field to enter the path to the main source code directory for your
project.
If the path you enter does not exist, it will be created for you. To enter a
path, you may drag and drop a directory folder icon here, click the Browse
button or right-click the field.
PrjBld uses this path to "point" all your tools to this directory.
ΓòÉΓòÉΓòÉ 4.1.3. Main Folder ΓòÉΓòÉΓòÉ
Main Folder
Enter the name of the top level project folder, if any. The top level folder
is the location of the folder you are about to create. The best way to
designate a folder location is to drag the destination folder and drop it on
this field.
The path to folders on your desktop is something like:
D:\Desktop\Projects
Your desktop path will undoubtedly differ, so don't type this in!
If you leave this field blank, the new project folder will appear on your
desktop.
ΓòÉΓòÉΓòÉ 4.1.4. Browse Button ΓòÉΓòÉΓòÉ
Browse Button
Click this button to open a directory browser dialog box. Either select an
existing directory, or type in a new one in the field under the Directories
caption.
If the directory you enter does not exist, PrjBld will create it for you.
Note: Prjbld can create multiple directory levels at a time.
Click Ok if you find the directory you want, click Cancel if you do not wish to
select/create a directory.
ΓòÉΓòÉΓòÉ 4.1.5. Create Button ΓòÉΓòÉΓòÉ
Create Button
Click this button to start the folder creation process. Insure that you have
previously set up PrjBld's settings notebook, found under the Config button.
PrjBld retains its config notebook settings, so normally you can reuse the
settings from the last time you used PrjBld.
Feel free to delete folders and application icons created by PrjBld. They are
shadows or deletable program objects - not the original subdirectory or EXE.
Note that PrjBld overwrites any folder previously created by PrjBld that uses
the exact same name (case insensitive) as entered in the Project Name field.
ΓòÉΓòÉΓòÉ 4.1.6. Quit Button ΓòÉΓòÉΓòÉ
Quit Button
Click this button to exit PrjBld.
You may also use Alt+Q.
ΓòÉΓòÉΓòÉ 4.1.7. Config Button ΓòÉΓòÉΓòÉ
Config Button
Click this button (or type Alt+g) to open up PrjBld's configuration notebook.
The folder contains tabs corresponding to:
Main Folder
DOS 1
DOS 2
DOS 3
PM 1
PM 2
PM 3
WinOS2 1
WinOS2 2
WinOS2 3
OS2 CMD
DOS CMD
ΓòÉΓòÉΓòÉ 4.1.8. Picture ΓòÉΓòÉΓòÉ
Picture
For some cheap thrills, click on the picture. Yes, its my ugly face. The
luxuriously appointed IDK world corporate headquarters is in the background.
ΓòÉΓòÉΓòÉ 4.1.9. Startup Folder Open Icon ΓòÉΓòÉΓòÉ
Startup Folder Open Icon
This field shows the folder open icon that will be used to adorn your new
project folder.
For more information, click here Folder Icons, Open
ΓòÉΓòÉΓòÉ 4.1.10. Startup Folder Closed Icon ΓòÉΓòÉΓòÉ
Startup Folder Closed Icon
This field shows the folder closed icon that will be used to adorn your new
project folder.
For more information, click here Folder Icons, Closed
ΓòÉΓòÉΓòÉ 4.2. Main Folder Page ΓòÉΓòÉΓòÉ
Main Folder Notebook Page
This notebook page controls the look and feel of the project folder you are
about to create.
This page has 4 controls:
Folder Open Icon - This icon will be used to indicate an open project folder.
This is a drag/drop area.
Folder Closed Icon - This icon will be used to indicate an open project
folder. This is a drag/drop area.
Folder Wallpaper - This graphic will be used as wallpaper in an open project
folder. This is a drag/drop area.
Icon Placement - Select Sort to cause the icons within the project folder to
sort, usually by name. Select No Sort to cause icons within the project folder
to remain where they were placed manually
ΓòÉΓòÉΓòÉ 4.2.1. Folder Icons, Open ΓòÉΓòÉΓòÉ
Folder Open Icon
This is drag/drop area where you can drop an icon (*.ICO) to indicate an open
project folder. To avoid confusion, use some variation of a folder icon. See
Installation for a source of free folder icons.
You may also right click on this area to pop up a file dialog. Select an ICO
file from your hard disk drive.
ΓòÉΓòÉΓòÉ 4.2.2. Folder Icons, Closed ΓòÉΓòÉΓòÉ
Folder Closed Icon
This is drag/drop area where you can drop an icon (*.ICO) to indicate a closed
project folder. To avoid confusion, use some variation of a folder icon. See
Installation for a source of free folder icons.
You may also right click on this area to pop up a file dialog. Select an ICO
file from your hard disk drive.
ΓòÉΓòÉΓòÉ 4.2.3. Folder Wallpaper ΓòÉΓòÉΓòÉ
Folder Wallpaper
Either drag and drop an OS/2 BMP file to this area or right click on the
component to pop up a file dialog box. The BMP file you drop here will be used
as a folder background for your new project folder.
OS/2 ships with a number of BMP files that are suitable for folder wallpaper.
Look in D:\OS2\BITMAPS for a large selection of files. Replace D: with your
boot partition drive letter.
ΓòÉΓòÉΓòÉ 4.2.4. Icon Placement ΓòÉΓòÉΓòÉ
Icon Placement
This radio button cluster selects the manner in which the icons will be placed
in the folder.
You may select:
No Sort
Sort Icons
The PrjBld sort settings override any system global icon sort stettings for
project folders. They will not affect the sorting characteristics of other
folders or your desktop.
ΓòÉΓòÉΓòÉ 4.2.5. Save Button ΓòÉΓòÉΓòÉ
Save Button
Press the button to close the settings notebook. Your changes are
automatically saved as you modify each field, so you may exit at any time
without using your changes.
ΓòÉΓòÉΓòÉ 4.3. DOS Applications ΓòÉΓòÉΓòÉ
DOS 1, DOS 2, DOS 3, DOS 4
The "DOS x" notebook pages control the behavior of up to 4 DOS program objects
placed in your new project folder. Suggested uses are DOS utilities that act
on your source code or support files found in your main project directory.
This notebook page has several controls used to set up a DOS application icon
(Program Object).
The controls include:
Application Path
Application name
Command line options
Window Size
Attributes
Browser
Enable
ΓòÉΓòÉΓòÉ 4.3.1. DOS App Path ΓòÉΓòÉΓòÉ
DOS Application Path
Use this field to enter the path and filename of a DOS executable program used
by your project.
You may drag and drop a file object (providing it has an EXE or CMD suffix).
You may not drop program objects on this field.
Alternatively, you may click the Browse button or right-click on the App Path
field to pop up a file dialog box.
ΓòÉΓòÉΓòÉ 4.3.2. DOS App Name ΓòÉΓòÉΓòÉ
App Name
The name that will be applied to the DOS Program Object icon. Use a caret (^)
to insert line breaks in the name string.
ΓòÉΓòÉΓòÉ 4.3.3. DOS App Command Line Options ΓòÉΓòÉΓòÉ
DOS Command Line
Enter the command line flags and settings used by this application.
See also: Command Line Macros
Since the application will use the project directory as the default directory,
you may use relative paths.
You may use OS/2 "%" and "[]" command line macros here if you want to be very
clever. See the OS/2 documention for details.
See your application documentation for appropriate command line flags and
settings.
ΓòÉΓòÉΓòÉ 4.3.4. DOS App Window Size ΓòÉΓòÉΓòÉ
Win Size
Use this radio button cluster to select the type of VDM in which you would like
to run this application.
If you want it to run in a window on your desktop, select Windowed.
If you want the applcation to go "full screen", select Full.
ΓòÉΓòÉΓòÉ 4.3.5. DOS App Browse Button ΓòÉΓòÉΓòÉ
Browser Button
Click this button to pop up a file dialog box. The dialog box allows you to
select an existing file and automatically fill in the path field to the left of
this button.
ΓòÉΓòÉΓòÉ 4.3.6. DOS App Enable ΓòÉΓòÉΓòÉ
Enabled
This checkbox controls the creation of the Program Object found on the current
notebook page.
If this checkbox is on, this Program Object will be created in the new project
folder.
If the checkbox is not checked, then creation of this program object will be
inhibited.
If you uncheck the box, all your settings are retained so that you don't have
to re-enter them.
In disabled mode, the other fields on this form are grayed out. You must
enable this control prior to editing the other fields.
ΓòÉΓòÉΓòÉ 4.3.7. DOS Attributes ΓòÉΓòÉΓòÉ
Attributes
Use this multiline editor control to set this applications DOS Settings. These
settings override any default DOS Settings from your CONFIG.SYS.
Some example settng are:
SET DOS_BREAK=1
SET DOS_LASTDRIVE=H
SET DOS_AUTOEXEC=D:\AUTOEXEC.Bp7
SET IDLE_SENSITIVITY=5
SET IDLE_SECONDS=3
SET XMS_MEMORY_LIMIT=64
SET DPMI_DOS_API=ENABLED
SET AUDIO_ADAPTER_SHARING=Optional
DPMI_DOS_API=ENABLED is especially important for DOS hosted Borland compilers.
The OS/2 default value for this setting is incompatible with Borland Pascal
7.0. The IDLE_xxx settings can make "CPU hogs" behave.
Leave this field blank if you want to use the default DOS settings.
ΓòÉΓòÉΓòÉ 4.4. PM Applications ΓòÉΓòÉΓòÉ
PM 1, PM 2, PM 3, PM 4
The "PM x" notebook pages control the behavior of up to 4 Presentation Manager
Program Objects placed in your new project folder.
You may enter the filename, application name and command line options for each
application.
PM Applications are typically compilers and tools used to work on your project
or documentation.
This notebook page has several controls used to set up a PM application icon
(Program Object).
App Path
App Name
App CmdLine
Browse
Enabled
ΓòÉΓòÉΓòÉ 4.4.1. PM App Path ΓòÉΓòÉΓòÉ
PM Application Path
Use this field to enter the path and filename of an OS/2 executable program
used by your project. In most cases, this will be a compiler or OS/2 utility
that will operate on your source code, project support files or documentation.
You may drag and drop a file object (providing it has an EXE or CMD suffix).
You may not drop program objects on this field.
Alternatively, you may click the Browse button or right-click on the App Path
field to pop up a file dialog box.
ΓòÉΓòÉΓòÉ 4.4.2. PM App Name ΓòÉΓòÉΓòÉ
PM Applicaton Name
Enter the name of the OS/2 application. It does not have to match the EXE
name.
This string will be used as the application icon (program object) name that
appears on the screen.
Use a caret (^) to insert line breaks in the name string if you want a
multiline icon name.
ΓòÉΓòÉΓòÉ 4.4.3. PM Command Line ΓòÉΓòÉΓòÉ
PM Command Line
Enter the command line flags and settings used by this application.
See also: Command Line Macros
Since the application will use the project directory as the default directory,
you may use relative paths.
You may use OS/2 "%" and "[]" command line macros here if you want to be very
clever.
See your application documentation for appropriate flags and settings.
ΓòÉΓòÉΓòÉ 4.4.4. PM App Browse Button ΓòÉΓòÉΓòÉ
Browser Button
Click this button to pop up a file dialog box. The dialog box allows you to
select an existing file and automatically fill in the path field to the left of
this button.
ΓòÉΓòÉΓòÉ 4.4.5. PM App Enable ΓòÉΓòÉΓòÉ
Enabled
This checkbox controls the creation of the Program Object found on the current
notebook page.
If this checkbox is on, this Program Object will be created in the new project
folder.
If the checkbox is not checked, then creation of this program object will be
inhibited.
If you uncheck the box, all your settings are retained so that you don't have
to re-enter them.
In disabled mode, the other fields on this form are grayed out. You must
enable this control prior to editing the other fields.
ΓòÉΓòÉΓòÉ 4.5. WinOS/2 Applications ΓòÉΓòÉΓòÉ
WinOS2 1, WinOS2 2, WinOS2 3, WinOS2 4
The "WinOS/2 x" notebook pages control the behavior of up to 4 WinOS/2 Program
Objects placed in your new project folder.
WinOS/2 applications can include Delphi 1.0, or any other tool that might be
useful for application development.
You may enter the filename, application name and command line options for each
application.
This notebook page has several controls used to set up a WinOS/2 application
icon (Program Object).
App Path
App Name
Attributes
App Cmd Line
Windows Mode
Enabled
Browse
ΓòÉΓòÉΓòÉ 4.5.1. WinOS/2 App Path ΓòÉΓòÉΓòÉ
WinOS/2 Application Path
Use this field to enter the path and filename of an Win3.x executable program
used by your project.
You may drag and drop a file object (providing it has an EXE or CMD suffix).
You may not drop program objects on this field.
Alternatively, you may click the Browse button or right-click on the App Path
field to pop up a file dialog box.
ΓòÉΓòÉΓòÉ 4.5.2. WinOS/2 App Name ΓòÉΓòÉΓòÉ
WinOS/2 Application Name
Enter the name of the WinOS/2 application. It does not have to match the EXE
name.
This string will be used as the application icon (program object) name that
appears on the screen.
Use a caret (^) to insert line breaks in the name string if you want a
multiline icon name.
ΓòÉΓòÉΓòÉ 4.5.3. WinOS/2 App Command Line ΓòÉΓòÉΓòÉ
WinOS/2 Command Line
Enter the flags and settings used by this application.
See also: Command Line Macros
Since the application will use the project directory as the default directory,
you may use relative paths in the command line.
You may use OS/2 "%" and "[]" command line macros here if you want to be very
clever.
See your application documentation for appropriate flags and settings.
ΓòÉΓòÉΓòÉ 4.5.4. WinOS/2 Windows Mode ΓòÉΓòÉΓòÉ
WinOS/2 Windows Mode
Use this radio button cluster to select the type of WinOS/2 session in which
you would like to run this application.
If you want it to run directly on your OS/2 desktop, select Seamless mode.
If you want to use the application from the WinOS/2 desktop, select Full Screen
ΓòÉΓòÉΓòÉ 4.5.5. WinOS/2 Seamless ΓòÉΓòÉΓòÉ
WinOS/2 Seamless Mode
Select this mode if you want to run your Windows 3.x application directly on
your OS/2 desktop. This allows you to mix the use of OS/2 applications with
Windows applications on your desktop.
Note that some Win3.x applications do not run very well in seamless mode.
Video hardware or OS/2 configuration problems may also preclude the use of this
mode.
ΓòÉΓòÉΓòÉ 4.5.6. WinOS/2 Full Screen ΓòÉΓòÉΓòÉ
WinOS/2 Full Screen Mode
Select this mode if you wish to run this Windows application using a full
screen Windows session. You may then switch between the Windows desktop and
the OS/2 desktop.
Use this mode If your application will not run in seamless mode, or you prefer
running the application in full screen windows mode.
When you double click on the application icon, the WinOS/2 desktop will appear
and the application will start.
You may switch between your OS/2 an WinOS/2 desktops with an Ctrl+Esc keystroke
or by clicking on the OS/2 icon at the bottom of the WinOS/2 desktop.
Return to WinOS/2 by pressing Ctrl-Esc and selecting the WinOS/2 session from
the task list.
ΓòÉΓòÉΓòÉ 4.5.7. WinOS/2 Enabled ΓòÉΓòÉΓòÉ
WinOS/2 Enabled
This checkbox controls the creation of the Program Object found on the current
notebook page.
If this checkbox is on, this Program Object will be created in the new project
folder.
If the checkbox is not checked, then creation of this program object will be
inhibited.
If you uncheck the box, all your settings are retained so that you don't have
to re-enter them.
In disabled mode, the other fields on this form are grayed out. You must
enable this control prior to editing the other fields.
ΓòÉΓòÉΓòÉ 4.5.8. WinOS/2 Browse Button ΓòÉΓòÉΓòÉ
WinOS/2 Browse Button
Click this button to pop up a file dialog box. The dialog box allows you to
select an existing file and automatically fill in the path field to the left of
this button.
ΓòÉΓòÉΓòÉ 4.5.9. WinOS/2 Attributes ΓòÉΓòÉΓòÉ
Attributes
Use this multiline editor control to set this applications DOS Settings. These
settings override any default WinOS/2 Settings from your CONFIG.SYS.
Some example settng are:
SET DOS_BREAK=1
SET DOS_LASTDRIVE=H
SET DOS_AUTOEXEC=D:\AUTOEXEC.Bp7
SET IDLE_SENSITIVITY=5
SET IDLE_SECONDS=3
SET XMS_MEMORY_LIMIT=64
SET DPMI_DOS_API=ENABLED
SET AUDIO_ADAPTER_SHARING=Optional
DPMI_DOS_API=ENABLED is especially important for DOS hosted Borland compilers.
The OS/2 default value for this setting is incompatible with Borland Pascal
7.0. The IDLE_xxx settings can make "CPU hogs" behave.
Leave this field blank if you want to use the default WinOS/2 settings.
ΓòÉΓòÉΓòÉ 4.6. Shadow Paths ΓòÉΓòÉΓòÉ
Paths Notebook Page (Main folder Pg2)
This notebook page is used to identify subdirectories that need shadow
directory icons in the new project folder. There are 5 directories useful in
most projects, and 5 general purpose paths.
In reality, you can ignore the Doc, Release, Temp, VCS and Graphics tags and
use the fields for some other subdirectory theme. The actual name of the
directory is what appears under the shadow icon in your project folder.
Leave any unneeded paths blank to prevent directory shadow object creation.
You may drag/drop directory folders on any of the path fields. You may also
right-mouse click or click on the associated Browse button to pop up a path
selector dialog box. You can hand type paths as well.
If you enter a relative path, the subdirectory will be created under your
project directory.
Example:
If you selected C:\MYNEWPRJ as your project directory and then entered
.\VCS
Multiple directory levels below the project directory are allowed.
Example:
.\non\existant\path\VCS
Is perfectly legal. PrjBld will create each segment of the multilevel path for
you.
in VCS Path. The result would be that PrjBld would create a C:\MYNEWPRJ\VCS
directory and make a shadow icon for it.
For more details, see:
DOC
Release
Temp
VCS
Aux Paths
ΓòÉΓòÉΓòÉ 4.6.1. DOC Path ΓòÉΓòÉΓòÉ
DOC Path
Enter the relative or fully qualified Absolute path to your project
Documentation and memos. PrjBld will create a shadow folder for this
directory. You may use the DOC path for other purposes if you don't need a
project related documentation path. Leave this field blank if you do not need
it at all.
ΓòÉΓòÉΓòÉ 4.6.2. Release Path ΓòÉΓòÉΓòÉ
Release Path
Enter the relative or fully qualified Absolute path to your project release
directory (normally the location of the production EXE and support files).
PrjBld will create a shadow folder for this directory. You may use the Release
path for other purposes if you don't need a separate release directory. Leave
this field blank if you do not need it at all.
ΓòÉΓòÉΓòÉ 4.6.3. Temp Path ΓòÉΓòÉΓòÉ
Temp Path
Enter the relative or fully qualified Absolute path to your TEMP directory
(normally the location of temp files and possibly Internet download files).
PrjBld will create a shadow folder for this directory. You may use the TEMP
path for other purposes if you don't need to look at temp files. Leave this
field blank if you do not need it at all.
ΓòÉΓòÉΓòÉ 4.6.4. VCS Path ΓòÉΓòÉΓòÉ
VCS Path
Enter the relative or fully qualified Absolute path to your Version Control
System (VCS) directory (normally the location of archived source code and
support files maintained by a VCS like MKS Source Integrity, TLIB, PVCS, Etc).
PrjBld will create a shadow folder for this directory.
You may use the VCS path for other purposes if you don't use a version control
system (shame on you!). Leave this field blank if you do not need it at all.
ΓòÉΓòÉΓòÉ 4.6.5. Graphics Path ΓòÉΓòÉΓòÉ
Graphics Path
Enter the relative or fully qualified Absolute path to the Graphics FIles
associated with your project.
You may use the Graphics path for other purposes if you don't use graphics
files with your project. Leave this field blank if you do not need it at all.
ΓòÉΓòÉΓòÉ 4.6.6. Aux Paths ΓòÉΓòÉΓòÉ
Aux Path n
Enter the relative or fully qualified Absolute path to anywhere you like.
Aux paths are general purpose paths that may be important to your project.
PrjBld will create a shadow folder for this directory. Leave this field blank
if you do not need it at all.
ΓòÉΓòÉΓòÉ 4.6.7. PathBrowse ΓòÉΓòÉΓòÉ
Path Browse Button
Click this button to select a drive/path. The path you select will appear in
the field to the left of the button.
ΓòÉΓòÉΓòÉ 4.7. OS2 Command Window Settings ΓòÉΓòÉΓòÉ
OS/2 Command Window Notebook Page
This page has 2 controls. You can set window size of the OS/2 session using
the Full Screen / Windowed radio buttons. To enable creation of this icon in
the project folder, you must check the Enabled checkbox. If this checkbox is
unchecked, the icon creation will be supressed.
ΓòÉΓòÉΓòÉ 4.8. DOS Command Window Settings ΓòÉΓòÉΓòÉ
DOS Command Window Notebook Page
This page has 3 controls.
You can set window size of the OS/2 session using the Full Screen / Windowed
radio buttons. To enable creation of this icon in the project folder, you must
check the Enabled checkbox. If this checkbox is unchecked, icon creation will
be supressed.
See also:
Attributes
Full Screen
Windowed
Enabled
ΓòÉΓòÉΓòÉ 4.8.1. DOS Full Screen ΓòÉΓòÉΓòÉ
Full Screen
Select this radio button to cause the DOS Command line to open in full screen
mode. Once open, you can shrink it with Alt-Home or switch back to the OS/2
desktop using Alt-Esc.
ΓòÉΓòÉΓòÉ 4.8.2. DOS Windowed ΓòÉΓòÉΓòÉ
Windowed
Select this radio button to cause the DOS Command line to open in windowed
mode. Once open, you can expand it with Alt-Home or switch back to the OS/2
desktop using Alt-Esc.
ΓòÉΓòÉΓòÉ 4.8.3. DOS Screen Enable ΓòÉΓòÉΓòÉ
Enable
Select this check box to enable creation of the DOS Command window.
ΓòÉΓòÉΓòÉ 4.9. Icon Dialog ΓòÉΓòÉΓòÉ
Icon Dialog Box
Use this dialog box to select folder icons for your project. You may resize
this dialog to view more icons in the Icon Container at the same time.
This dialog has several controls:
Icon Dir
Icon Dirs
Icon Drives
Icon Container
Icon Cancel
Icon Small Icons
Icon Large Icons
Icon Update Button
Icon Manual Mode
Icon Auto Mode
ΓòÉΓòÉΓòÉ 4.9.1. Icon Dir ΓòÉΓòÉΓòÉ
Icon Directory Field
Use this field to select a directory containing folder icons. This field
updates as you click on paths in the Icon Dirs field.
ΓòÉΓòÉΓòÉ 4.9.2. Icon Dirs ΓòÉΓòÉΓòÉ
Icon Directory List
Use this field to select a directory containing folder icons. Double click on
the .. line to move up a directory level.
ΓòÉΓòÉΓòÉ 4.9.3. Icon Drives ΓòÉΓòÉΓòÉ
Icon Drives Field
Use this field to select a disk drive letter.
ΓòÉΓòÉΓòÉ 4.9.4. Icon Container ΓòÉΓòÉΓòÉ
Icon Container
Use this field to select an icon for use with your project. Double click on
the desired icon to select it for use.
In Icon Auto Mode the Icon Container updates as you move from subdirectory to
subdirectory.
In Icon Manual Mode the Icon Container updates only when you press the Icon
Update Button.
Drag the dialog box larger to see more icons. The Icon Container resizes to
match the overall dialog box size.
See also:
Icon Dir
Icon Dirs
Icon Drives
Icon Container
Icon Cancel
Icon Small Icons
Icon Large Icons
Icon Update Button
Icon Manual Mode
Icon Auto Mode
ΓòÉΓòÉΓòÉ 4.9.5. Icon Cancel ΓòÉΓòÉΓòÉ
Cancel Button
Press this button to exit the Icon Dialog box without making a selection.
ΓòÉΓòÉΓòÉ 4.9.6. Icon Small Icons ΓòÉΓòÉΓòÉ
Small Icons
Click this radio button to select small icons in the Icon Container. Small
icons allow you to see more icons in the container at a time. It may be
difficult to see artwork in this mode.
Icon size does not affect the size of the actual project icon on your desktop.
See also:
Large Icons
ΓòÉΓòÉΓòÉ 4.9.7. Icon Large Icons ΓòÉΓòÉΓòÉ
Large Icons
Click this radio button to select large icons in the Icon Container. Large
icons allow you to see more artwork detail the icons in the container. Using
large icons decreases the number of icons you can see at the same time.
Icon size does not affect the size of the actual project icon on your desktop.
See also:
Small Icons
ΓòÉΓòÉΓòÉ 4.9.8. Icon Update Button ΓòÉΓòÉΓòÉ
Update Button
Press this button to scan the current directory for icon files and view them in
the Icon Container. This button is disabled in Icon Auto Mode.
ΓòÉΓòÉΓòÉ 4.9.9. Icon Manual Mode ΓòÉΓòÉΓòÉ
Manual Mode
Select this mode to inhibit update of the Icon Container as you change
subdirectories. Manual Mode can make this dialog box more responsive when
viewing directories with large numbers of icons.
See also:
Icon Auto Mode
ΓòÉΓòÉΓòÉ 4.9.10. Icon Auto Mode ΓòÉΓòÉΓòÉ
Auto Mode
Select this mode to enable automatic update of the Icon Container as you change
subdirectories. Auto Mode can make this dialog box very slow when viewing
directories with large numbers of icons, but you will always have a fresh view
of the current subdirectory.
Note that when you change directories, PrjBld must flush the Icon Container
before it can refill it with the new set of icons. Be patient.
See also:
Icon Manual Mode
ΓòÉΓòÉΓòÉ 4.10. Command Line Macros ΓòÉΓòÉΓòÉ
Command Line Macros
Command line macros are used to create dynamic command line parameters for
OS/2, DOS, and WinOS/2 applicatons. Macros are available that expand into the
project drive letter, project path, project name and a prompted dialog for
variable strings.
Macro keywords are case sensitive. They must be in upper case. You may use
more than one instance of a macro in the same command line. However, beware of
excessive expanded command line length.
Examples:
Given a project name of "HyperSnore" and a project path of
"C:\projects\hsnore":
$DIR\HS.C
- expands to: C:\projects\hsnore\HS.C
$DIR\$NAME.C
- expands to: C:\projects\hsnore\HyperSnore.C
$DIR\$PROMPT/Top module name/.C
- pops a dialog box and expands to: C:\projects\hsnore\<your answer>.C
- /Top module name/ is used as the prompt in the dialog box. You may
use any character for leading and trailing quotes, but they must
match and not appear in the prompt string.
- Note: If you do not enter a value and click OK, the line will expand
to C:\projects\hsnore\.C
$DRIVE\LIB
- expands to: C:\LIB
ΓòÉΓòÉΓòÉ 5. Feedback ΓòÉΓòÉΓòÉ
Feedback
Please send any comments, suggestions or bug reports for this version of
PrjBld. Contact IDK, Inc. by Email at:
prjbld@idk-inc.com
Thank you for trying PrjBld!
Visit our Web site!
View IDK web site with Netscape
View IDK web site with Web Explorer (not recommended)
Send mail to IDK, Inc. via Netscape
Send mail to IDK, Inc. via Web Explorer
If you have problems with your browser, click here: Netscape and Explorer
ΓòÉΓòÉΓòÉ 6. License ΓòÉΓòÉΓòÉ
Software License
PrjBld is shareware. This means:
1. All copyrights to PrjBld are exclusively owned by the author - IDK, Inc.
2. Anyone may use this software for a test period of 40 days. Following this
test period of 40 days or less, if you wish to continue to use PrjBld, you MUST
register.
3. Once registered, the user is granted a non-exclusive license to use PrjBld
on one computer (i.e. a single CPU), for any legal purpose, at a time. The
registered PrjBld software may not be rented or leased, but may be permanently
transferred, if the person receiving it agrees to terms of this license. If the
software is an update, the transfer must include the update and all previous
versions.
4. The PrjBld unregistered shareware version may be freely distributed,
provided the distribution package is not modified. No person or company may
charge a fee for the distribution of PrjBld without written permission from the
copyright holder.
5. To register you must complete the registration form and send it, with
registration fee, to one of the authorized registration sites.
6. PrjBld IS DISTRIBUTED "AS IS". NO WARRANTY OF ANY KIND IS EXPRESSED OR
IMPLIED. YOU USE IT AT YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA
LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR
MISUSING THIS SOFTWARE.
7. There are NO additional license fees, apart from the cost of registration.
Visit our Web site!
View IDK web site with Netscape
View IDK web site with Web Explorer (not recommended)
Send mail to IDK, Inc. via Netscape
Send mail to IDK, Inc. via Web Explorer
If you have problems with your browser, click here: Netscape and Explorer
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
If No Sort is turned on, icons in the project folder will remain as placed.
You will have to manually move them to asthetically pleasing locations. If you
subsequently resize the window, you will have to manually reset their
locations.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
If Sort is turned on, the icons will automatically sort (usually in name
order), and will rearrange themselves as the project window is resized.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
A relative path is a subdirectory located below the project directory.
Paths that look like so: .\mypath\a\directory\under\my\project
will cause PrjBld to create a series of nested subdirectories under your newly
created project directory if such a path does not exist. Prjbld will create a
shadow icon for this directory and place it in your project folder.
Relative paths are useful for creating a directory tree under your project
directory that you use frequently. Directories for version control archives,
project documentation and graphics come to mind.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
An absolute path is a fully qualified path (drive letter, path) to any
subdirectory.
Paths that look like so:
C:\mypath\somewhere\on\my\drive\or\network
will cause PrjBld to create a series of nested subdirectories on your C: drive
if such a path does not exist. Prjbld will create a shadow icon for this
directory and place it in your project folder.
Absolute paths are useful for creating shadow icons of frequently used
directories. Directories for libraries, utilities, Etc. come to mind.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
$DIR expands into the fully qualified path to your Project directory.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
$DRIVE expands into the drive letter from your Project directory.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
$NAME expands into the name of your Project.
ΓòÉΓòÉΓòÉ <hidden> ΓòÉΓòÉΓòÉ
$PROMPT is a special macro used to insert variable command line values at
folder creation time.
PROMPT macros pop up a dialog box similar to this, asking for the desired
expansion value. Enter a value and click OK.