OS/2 Shareware BBS: 10 Tools/10-Tools.zip/prjbld.zip/PRJBLD.INF

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: [e-mail]

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:

  [e-mail]

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.