Ide/Creating new Project Items/Creating a Package - Revision history

Thomas Linder Puls: remove v7 reference

2018-09-25T13:12:47Z

remove v7 reference

← Older revision		Revision as of 15:12, 25 September 2018
Line 2:		Line 2:
	== Creating a Package ==		== Creating a Package ==

	The basic units of code organization accepted in Visual Prolog ~~v.7~~ are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.		The basic units of code organization accepted in Visual Prolog are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.

	By default, the IDE organizes projects into packages. When you create a new package in a project, the IDE creates:		By default, the IDE organizes projects into packages. When you create a new package in a project, the IDE creates:

Thomas Linder Puls: Category

2013-06-13T14:19:41Z

Thomas Linder Puls: header level

2013-06-13T14:09:20Z

header level

← Older revision		Revision as of 16:09, 13 June 2013
Line 1:		Line 1:
	<noinclude>[[Category:Ide]]</noinclude>		<noinclude>[[Category:Ide Create New Project Items]]</noinclude>

			== Creating a Package ==

	The basic units of code organization accepted in Visual Prolog v.7 are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.		The basic units of code organization accepted in Visual Prolog v.7 are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.

GalinaTchekmareva at 10:36, 17 April 2013

2013-04-17T10:36:28Z

← Older revision		Revision as of 12:36, 17 April 2013
Line 5:		Line 5:

	* The subdirectory into which the package files will be placed.		* The subdirectory into which the package files will be placed.
	* The package header file (i.e. ~~'''~~NewPackage.ph~~'''~~) that describes the ''public'' view of the package. The package header file should be inserted by <vp>#include</vp> directives in all other packages that use the package. The package header file contains the list of ''public'' interfaces, the list of ''public'' classes, and some <vp>#requires</vp> directives.<br />Names declared in public interfaces and classes are seen outside the package in all places where the package header file is included. <vp>#requires</vp> directives are used to guaranty that all packages required to use the package are included into the project.		* The package header file (i.e. <vp>NewPackage.ph</vp>) that describes the ''public'' view of the package. The package header file should be inserted by <vp>#include</vp> directives in all other packages that use the package. The package header file contains the list of ''public'' interfaces, the list of ''public'' classes, and some <vp>#requires</vp> directives.<br />Names declared in public interfaces and classes are seen outside the package in all places where the package header file is included. <vp>#requires</vp> directives are used to guaranty that all packages required to use the package are included into the project.
	* The package implementation file (i.e. ~~'''~~NewPackage.pack~~'''~~) produces a Visual Prolog compilation unit which is added to a set of project modules.		* The package implementation file (i.e. <vp>NewPackage.pack</vp>) produces a Visual Prolog compilation unit which is added to a set of project modules.

	=== How to Create a New Package? ===		=== How to Create a New Package? ===
Line 16:		Line 16:
	'''Name:'''		'''Name:'''

	:In the '''Name''' edit control you should type in the name of the package being created (~~'''~~NewPackage~~'''~~ in the picture).		:In the '''Name''' edit control you should type in the name of the package being created (<vp>NewPackage</vp> in the picture).

	'''Parent Directory'''		'''Parent Directory'''
Line 24:		Line 24:
	:In this '''Parent Directory''' the IDE creates a new subdirectory with the name correspondent to the specified package name. The package will be placed into this subdirectory.		:In this '''Parent Directory''' the IDE creates a new subdirectory with the name correspondent to the specified package name. The package will be placed into this subdirectory.

	After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file ~~'''~~NewPackage.ph~~'''~~, and the package implementation file ~~'''~~NewPackage.pack~~'''~~. (They will appear in the {{ide\|Project Tree#The Project Tree\|project tree}} in the '''Project Window''' after the created package is compiled.)		After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file <vp>NewPackage.ph</vp>, and the package implementation file <vp>NewPackage.pack</vp>. (They will appear in the {{ide\|Project Tree#The Project Tree\|project tree}} in the '''Project Window''' after the created package is compiled.)

	=== Packages ===		=== Packages ===
Line 32:		Line 32:
	The package is a collection of several grouped together interfaces and classes. The package provides some common name to all these interfaces and classes. Each declaration or implementation of each interface or class from a package is placed in a separate file. Each filename (of these files) coincides with the name of a class or an interface that is declared or implemented in this file. All package files are stored in the same separate package directory. (If a package contains sub-packages, then they are placed in subdirectories of the package directory.)		The package is a collection of several grouped together interfaces and classes. The package provides some common name to all these interfaces and classes. Each declaration or implementation of each interface or class from a package is placed in a separate file. Each filename (of these files) coincides with the name of a class or an interface that is declared or implemented in this file. All package files are stored in the same separate package directory. (If a package contains sub-packages, then they are placed in subdirectories of the package directory.)

	Except for files with declarations and implementations of interfaces and classes, each package contains two special files: the ''package header'' ('''.PH''') and the ''package implementation'' ('''.~~PACK~~''') files.		Except for files with declarations and implementations of interfaces and classes, each package contains two special files: the ''package header'' ('''.ph''') and the ''package implementation'' ('''.pack''') files.

	* The ''package header'' file provides declarations of all names exported from the package. Therefore, the package header file should be inserted by the <vp>#include</vp> directive in each other package that uses some names exported from this package.		* The ''package header'' file provides declarations of all names exported from the package. Therefore, the package header file should be inserted by the <vp>#include</vp> directive in each other package that uses some names exported from this package.
	* The ''package implementation'' file provides code implementing the package classes which can be compiled into an object file. The package implementation file should be included only once into a project that uses this package.		* The ''package implementation'' file provides code implementing the package classes which can be compiled into an object file. The package implementation file should be included only once into a project that uses this package.

	So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our ~~[..\..\pfc\pfcOverview.htm~~ Visual Prolog Foundation Classes] (PFC).		So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our Visual Prolog Foundation Classes (PFC).

	=== Package Header Files ===		=== Package Header Files ===
Line 53:		Line 53:
	A package header file does not produce any compiled code, but it is used while compilation to declare names exported from the package.		A package header file does not produce any compiled code, but it is used while compilation to declare names exported from the package.

	Usually a package header file has the ~~'''~~PackageName.ph~~'''~~ name.		Usually a package header file has the <vp>PackageName.ph</vp> name.

	=== Package Implementation Files ===		=== Package Implementation Files ===
Line 65:		Line 65:
	* It provides <vp>#include</vp> directives for all files with class implementations ('''.pro''' files) that provides Prolog code implementing all classes declared the package.		* It provides <vp>#include</vp> directives for all files with class implementations ('''.pro''' files) that provides Prolog code implementing all classes declared the package.

	Usually a package implementation file has the ~~'''~~PackageName.pack~~'''~~ name.		Usually a package implementation file has the <vp>PackageName.pack</vp> name.

GalinaTchekmareva at 11:30, 5 March 2013

2013-03-05T11:30:49Z

← Older revision		Revision as of 13:30, 5 March 2013
Line 39:		Line 39:
	So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our [..\..\pfc\pfcOverview.htm Visual Prolog Foundation Classes] (PFC).		So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our [..\..\pfc\pfcOverview.htm Visual Prolog Foundation Classes] (PFC).

	==== Package Header Files ====		=== Package Header Files ===

	The package header file provides external view of the package.		The package header file provides external view of the package.
Line 55:		Line 55:
	Usually a package header file has the '''PackageName.ph''' name.		Usually a package header file has the '''PackageName.ph''' name.

	==== Package Implementation Files ====		=== Package Implementation Files ===

	The package implementation file provides code implementing classes declared in the package. Compilation of the package implementation file generates object file that provides real implementations of classes declared in the package.		The package implementation file provides code implementing classes declared in the package. Compilation of the package implementation file generates object file that provides real implementations of classes declared in the package.

GalinaTchekmareva at 11:58, 4 March 2013

2013-03-04T11:58:36Z

← Older revision		Revision as of 13:58, 4 March 2013
Line 16:		Line 16:
	'''Name:'''		'''Name:'''

	In the '''Name''' edit control you should type in the name of the package being created ('''NewPackage''' in the picture).		:In the '''Name''' edit control you should type in the name of the package being created ('''NewPackage''' in the picture).

	'''Parent Directory'''		'''Parent Directory'''

	In the '''Parent Directory''' field you should type in or select (using the '''Browse''' button) the ''parent directory'' for the package. The package will be placed into the subdirectory of this ''parent directory''. By default, when you activate this dialog, '''Parent Directory''' displays the directory selected in the {{ide\|Project Tree#The Project Tree\|project tree}}. If this directory is one of project subdirectories, then its path is displayed relatively to the project root directory.		:In the '''Parent Directory''' field you should type in or select (using the '''Browse''' button) the ''parent directory'' for the package. The package will be placed into the subdirectory of this ''parent directory''. By default, when you activate this dialog, '''Parent Directory''' displays the directory selected in the {{ide\|Project Tree#The Project Tree\|project tree}}. If this directory is one of project subdirectories, then its path is displayed relatively to the project root directory.

	In this '''Parent Directory''' the IDE creates a new subdirectory with the name correspondent to the specified package name. The package will be placed into this subdirectory.		:In this '''Parent Directory''' the IDE creates a new subdirectory with the name correspondent to the specified package name. The package will be placed into this subdirectory.

	After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file '''NewPackage.ph''', and the package implementation file '''NewPackage.pack'''. (They will appear in the {{ide\|Project Tree#The Project Tree\|project tree}} in the '''Project Window''' after the created package is compiled.)		After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file '''NewPackage.ph''', and the package implementation file '''NewPackage.pack'''. (They will appear in the {{ide\|Project Tree#The Project Tree\|project tree}} in the '''Project Window''' after the created package is compiled.)

GalinaTchekmareva at 11:56, 4 March 2013

2013-03-04T11:56:03Z

GalinaTchekmareva at 11:50, 4 March 2013

2013-03-04T11:50:23Z

← Older revision		Revision as of 13:50, 4 March 2013
Line 1:		Line 1:
	<noinclude>[[Category:Ide]]</noinclude>		<noinclude>[[Category:Ide]]</noinclude>
	~~'''How to Create a New Project?'''~~

	To create a new project you should activate the '''Project \| New''' menu command. Then in the opened '''{{ide\|Project Settings\|Project Settings}}''' dialog you should type in or select the desired project settings and press the '''Create''' button. The new project with the default parameters correspondent to your settings will be created.

	~~=== Creating a New Package ===~~

	~~==== Overview ====~~

	The basic units of code organization accepted in Visual Prolog v.7 are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.		The basic units of code organization accepted in Visual Prolog v.7 are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.

GalinaTchekmareva: New page: Category:Ide '''How to Create a New Project?''' To create a new project you should activate the '''Project | New''' menu command. Then in the opened '''{{ide|Pr...

2013-03-04T11:48:40Z

New page: <noinclude>Category:Ide</noinclude> '''How to Create a New Project?''' To create a new project you should activate the '''Project | New''' menu command. Then in the opened '''{{ide|Pr...

New page

<noinclude>[[Category:Ide]]</noinclude>
'''How to Create a New Project?'''

To create a new project you should activate the '''Project | New''' menu command. Then in the opened '''{{ide|Project Settings|Project Settings}}''' dialog you should type in or select the desired project settings and press the '''Create''' button. The new project with the default parameters correspondent to your settings will be created.

=== Creating a New Package ===

==== Overview ====

The basic units of code organization accepted in Visual Prolog v.7 are ''packages''. We use packages in Visual Prolog to organize and structuring things. The use of packages ensures homogeneity in structuring principles among different projects. Packages define the standard for tool structuring, they ease sharing source code among projects.

By default, the IDE organizes projects into packages. When you create a new package in a project, the IDE creates:

* The subdirectory into which the package files will be placed.
* The package header file (i.e. '''NewPackage.ph''') that describes the ''public'' view of the package. The package header file should be inserted by <vp>#include</vp> directives in all other packages that use the package. The package header file contains the list of ''public'' interfaces, the list of ''public'' classes, and some <vp>#requires</vp> directives.<br />Names declared in public interfaces and classes are seen outside the package in all places where the package header file is included. <vp>#requires</vp> directives are used to guaranty that all packages required to use the package are included into the project.
* The package implementation file (i.e. '''NewPackage.pack''') produces a Visual Prolog compilation unit which is added to a set of project modules.

==== How to Create a New Package? ====

To create a new package in a project you should select the IDE menu command '''File | New'''. In the left pane of the appeared '''Create Project Item''' dialog you should select '''Package'''. Then the dialog accepts the following shape:

[[Image:Ide_How_NewPackage.png|center|frame|The '''New Package''' Dialog]]

'''Name:'''

In the '''Name''' edit control you should type in the name of the package being created ('''NewPackage''' in the picture).

'''Parent Directory'''

In the '''Parent Directory''' field you should type in or select (using the '''Browse''' button) the ''parent directory'' for the package. The package will be placed into the subdirectory of this ''parent directory''. By default, when you activate this dialog, '''Parent Directory''' displays the directory selected in the {{ide|Project Tree#The Project Tree|project tree}}. If this directory is one of project subdirectories, then its path is displayed relatively to the project root directory.

In this '''Parent Directory''' the IDE creates a new subdirectory with the name correspondent to the specified package name. The package will be placed into this subdirectory.

After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file '''NewPackage.ph''', and the package implementation file '''NewPackage.pack'''. (They will appear in the {{ide|Project Tree#The Project Tree|project tree}} in the '''Project Window''' after the created package is compiled.)

==== Packages ====

The concept of packages is used for grouping together several linked interfaces and classes. Packages can play a role of some class library. Packages can be used in your program instead of direct placing all these interfaces and classes into your program.

The package is a collection of several grouped together interfaces and classes. The package provides some common name to all these interfaces and classes. Each declaration or implementation of each interface or class from a package is placed in a separate file. Each filename (of these files) coincides with the name of a class or an interface that is declared or implemented in this file. All package files are stored in the same separate package directory. (If a package contains sub-packages, then they are placed in subdirectories of the package directory.)

Except for files with declarations and implementations of interfaces and classes, each package contains two special files: the ''package header'' ('''.PH''') and the ''package implementation'' ('''.PACK''') files.

* The ''package header'' file provides declarations of all names exported from the package. Therefore, the package header file should be inserted by the <vp>#include</vp> directive in each other package that uses some names exported from this package.
* The ''package implementation'' file provides code implementing the package classes which can be compiled into an object file. The package implementation file should be included only once into a project that uses this package.

So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our [..\..\pfc\pfcOverview.htm Visual Prolog Foundation Classes] (PFC).

===== Package Header Files =====

The package header file provides external view of the package.

* It provides <vp>#include</vp> directives for all files containing declarations of all interfaces ('''.i''' fles) and all classes ('''.cl''' files) exported from the package (''public ''interfaces and classes).
* It contains <vp>#include</vp> directives for package header ('''.ph''' files) files of all packages publicly used by the package. Since these package header files provide declarations of all public names declared in them; therefore, all public names declared in these packages are also publicly visible from the package.
* It contains some <vp>#requires</vp> directives. <vp>#requires</vp> directives define packages whose implementations (compiled code) have to A be accessible in order to use the package.

So the package header file provides declarations of all names exported from the package. Not only of exported names declared in the package itself, but also of all names declared in other packages that are included in the package header file.

A package header file should be inserted by <vp>#include</vp> directives in all places where the public names exported from the package should be visible.

A package header file does not produce any compiled code, but it is used while compilation to declare names exported from the package.

Usually a package header file has the '''PackageName.ph''' name.

===== Package Implementation Files =====

The package implementation file provides code implementing classes declared in the package. Compilation of the package implementation file generates object file that provides real implementations of classes declared in the package.

* It contains the <vp>#include</vp> directive for the package header file.
* It provides <vp>#include</vp> directives for package header files of external packages privately used by the package implementation. These header files provide declarations of all external names used in the package implementation ('''.pro''') files.
* It provides <vp>#include</vp> directives for files containing interfaces ('''.i''' files) privately used by the package implementation. These interfaces are only used inside the package implementation and are not seen externally.
* It provides <vp>#include</vp> directives for files containing declarations of classes ('''.cl''' files) privately used by the package implementation. These classes are only used inside the package implementation and are not seen externally.
* It provides <vp>#include</vp> directives for all files with class implementations ('''.pro''' files) that provides Prolog code implementing all classes declared the package.

Usually a package implementation file has the '''PackageName.pack''' name.

← Older revision		Revision as of 16:19, 13 June 2013
Line 1:		Line 1:
	<noinclude>[[Category:Ide Create New Project Items]]</noinclude>		<noinclude>[[Category:Ide/Create New Project Items]]</noinclude>

	== Creating a Package ==		== Creating a Package ==

← Older revision		Revision as of 13:56, 4 March 2013
Line 8:		Line 8:
	* The package implementation file (i.e. '''NewPackage.pack''') produces a Visual Prolog compilation unit which is added to a set of project modules.		* The package implementation file (i.e. '''NewPackage.pack''') produces a Visual Prolog compilation unit which is added to a set of project modules.

	==== How to Create a New Package? ====		=== How to Create a New Package? ===

	To create a new package in a project you should select the IDE menu command '''File \| New'''. In the left pane of the appeared '''Create Project Item''' dialog you should select '''Package'''. Then the dialog accepts the following shape:		To create a new package in a project you should select the IDE menu command '''File \| New'''. In the left pane of the appeared '''Create Project Item''' dialog you should select '''Package'''. Then the dialog accepts the following shape:
Line 26:		Line 26:
	After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file '''NewPackage.ph''', and the package implementation file '''NewPackage.pack'''. (They will appear in the {{ide\|Project Tree#The Project Tree\|project tree}} in the '''Project Window''' after the created package is compiled.)		After you fill in all required settings for the package, you can press the '''Create''' button. Then the IDE creates the package subdirectory, the package header file '''NewPackage.ph''', and the package implementation file '''NewPackage.pack'''. (They will appear in the {{ide\|Project Tree#The Project Tree\|project tree}} in the '''Project Window''' after the created package is compiled.)

	==== Packages ====		=== Packages ===

	The concept of packages is used for grouping together several linked interfaces and classes. Packages can play a role of some class library. Packages can be used in your program instead of direct placing all these interfaces and classes into your program.		The concept of packages is used for grouping together several linked interfaces and classes. Packages can play a role of some class library. Packages can be used in your program instead of direct placing all these interfaces and classes into your program.
Line 39:		Line 39:
	So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our [..\..\pfc\pfcOverview.htm Visual Prolog Foundation Classes] (PFC).		So using the concept of packages we can create sets of linked interfaces and classes grouped into packages. Once created package can be included (and used) in several programs without copying package sources into each project. The example of such set of packages is our [..\..\pfc\pfcOverview.htm Visual Prolog Foundation Classes] (PFC).

	===== Package Header Files =====		==== Package Header Files ====

	The package header file provides external view of the package.		The package header file provides external view of the package.
Line 55:		Line 55:
	Usually a package header file has the '''PackageName.ph''' name.		Usually a package header file has the '''PackageName.ph''' name.

	===== Package Implementation Files =====		==== Package Implementation Files ====

	The package implementation file provides code implementing classes declared in the package. Compilation of the package implementation file generates object file that provides real implementations of classes declared in the package.		The package implementation file provides code implementing classes declared in the package. Compilation of the package implementation file generates object file that provides real implementations of classes declared in the package.