═══ 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\.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 ═══ ═══ 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. ═══ ═══ If Sort is turned on, the icons will automatically sort (usually in name order), and will rearrange themselves as the project window is resized. ═══ ═══ 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. ═══ ═══ 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. ═══ ═══ $DIR expands into the fully qualified path to your Project directory. ═══ ═══ $DRIVE expands into the drive letter from your Project directory. ═══ ═══ $NAME expands into the name of your Project. ═══ ═══ $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.