PROJECT MANUAL

INTRODUCTION:

PROJECT is a program to manage TURBO C(tm) "project files". It allows 
you to create projects, add and remove modules from the project and 
set the compiler, linker and assembler options. But, above all, it 
allows you to automatically check if all the dependencies that exist 
between files are up to date.

THE PROJECT WINDOW

The PROJECT window contains a menu bar and a selector list that 
displays the modules in the project (if any). The menu bar is a copy 
of the menu at the top of the screen. The handling of the menu is 
slightly different: to open a menu, you must click on the title (not 
just move the mouse over the title. These are not "drop down" menus, 
but "pop down" menus). Click anywhere outside of the menu to close 
the menu. The selector list can be scrolled using the scroll bar and 
up and down arrows, just like ordinary windows. In addition, you can 
go to the top, resp. bottom, of the list by right-clicking on the up, 
resp. down, arrows. You can also scroll by using the cursor up and 
down keys to scroll one entry at the time, or by using the SHIFT-
cursor keys to scroll a "page" at a time. Click on the PROJECT box to 
display the About dialog.

THE FILE MENU

The menu item "New Project" creates a new project. You will be 
prompted for the name of the project and the name of the destination 
file.

The menu item "New Program" changes the destination file of the 
project. If no project exists, you must first create a project.

The menu item "Open Project" reads in an existing project.

The menu item "Save Project" saves the current project.

The menu item "Save as" saves the current project under a different 
name.

The menu item "Check project" checks the dependencies between ALL the 
files in the project. See the CHECKING chapter.

The menu item "Quit" exits the menu. If the current project was 
changed you are asked if the project must be saved.

THE OPTIONS MENU

The menu item "Settings" lets you load, save and change the 
configuration. PROJECT needs the name of three paths: the path with 
the library files, the path with the include files and the path of 
the program. When you load a new project, the path of the project 
file is automatically entered as the program path. You can also 
specify whether "system includes" (those include files that reside in 
the INCLUDE directory and are included with '#include <file.h>') must 
be considered when checking the project (see the CHECKING chapter). 
You can save and load configuration files. PROJECT automatically 
loads PROJECT.CFG at start up. PROJECT needs the names of the library 
and include directories to be able to check projects !

The menu items "Compiler" , "Linker" and "Assembler" are the same 
that you can enter in the TURBO C(tm) environment. These options are 
set globally. Local options can be set in the module selector.

MODULE SELECTOR

You can scroll the selector using the left and right mouse buttons 
and the scroll bar and arrow buttons or by using the up and down 
cursor keys (see the PROJECT WINDOW chapter).

When you right-click on a module a pop up menu appears. You can check 
a module (only if the module is a .C file). You can set the local 
options (assembler options for .S files, compiler options for .C 
files). You can remove an module. You can add a module BEFORE the 
selected module. If you right click outside of the selector the same 
pop up appears. If you select "check module", ALL modules are 
checked. If you select "Add module" the module is added at the end of 
the list. Note that, when adding a module, it is not automatically 
checked!

CHECKING

C modules #include .h files. The compiler looks in the project to see 
which .h files are included to decide which .C files need to be 
recompiled. Therefore it is important to specify a complete list of 
included files, if the compiler is to recompile correctly. The CHECK 
options of PROJECT automatically creates these lists of included 
files. For each .C file in the project a list of #included .h files 
is made. Each of the #included files is itself checked for #included 
files (and so on, recursively). Note that if you have added a .h file 
to the dependents list of a C module which is not #included by the C 
module, PROJECT will not remove it. Furthermore, #includes between /* 
and */ are ignored, but not #includes that are disabled using #ifdef.

KEYBOARD SHORTCUTS

Each menu item displays the keyboard shortcut that can be used to 
select that menu item. These shortcuts (and the menu strings) can be 
changed by using a "Resource Construction Set". Change the menu 
string and include (at the end) the shortcut you want (either CONTROL 
+ key or ALTERNATE + key).

The compiler, linker and assembler options can be set using the 
keyboard: type the letter of the option in the dialog. E.g. type 'K' 
to set the compiler to "unsigned chars" when the compiler options 
dialog is active.

The "pop down" menus can be called up using the F1 and F2 keys.

Pushing the HELP key displays the About dialog. Pushing the UNDO key 
quits the program.

CONCLUSION

PROJECT is public domain, you may use and copy it as you like, 
provided you do not change the program file, except the resource 
file. The copyright remains with the author of the program. The 
author disclaims any responsibility for any damage caused by the use 
of this program.

If you have any ideas to expand the program or have found bugs, send 
them to:

Pascal Van Cauwenberghe
Wezembeeklaan 88
B-1950 Kraainem
BELGIUM

Have fun.

(*) TURBO C is a trademark of BORLAND