create 18.11

git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@2112 abb3cda0-5349-4a8f-a601-0c33ac3a8c38

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/create-object.wiki

@@ -0,0 +1,27 @@
+[[Property:title|Create an object]]
+[[Property:weight|1]]
+[[Property:uuid|b2ef8e81-a045-dce2-725f-c8db5ab1b6db]]
+An EiffelBuild [[EiffelBuild Notation|object]]  is a representation of an EiffelVision 2 component and its properties. 
+
+To create a new instance of an object, [[EiffelBuild Notation|pick]]  a type from the [[Type selector|type selector]]  and [[EiffelBuild Notation|drop]]  onto an existing [[EiffelBuild Notation|object]]  (Accessible from the [[Layout constructor|layout constructor]]  or [[Builder window|builder window]] ). You will only be able to complete the [[EiffelBuild Notation|drop]]  if the targeted [[EiffelBuild Notation|object]]  will accept a new object of the transported type. 
+
+{{note|Once an [[EiffelBuild Notation|object]]  has been [[Create an object|created]] , it will always be contained in a parent [[EiffelBuild Notation|object]]  until [[Delete an object|deleted]] . }}
+
+==Creating Window and Dialog Objects==
+
+Window and dialog objects are created by picking a type from the [[Type selector|type selector]]  and dropping into the [[Widget selector|widget selector]] . If the target of the drop is a directory within the widget selector, the new object is created within that directory, otherwise in the root of the project location. Window and dialog objects are generated as individual classes by EiffelBuild. 
+
+{{note|If there are no other windows or directories in the project, the newly created object is set as the root window.}}
+
+==Creating objects for re-use==
+
+If you wish to create an object that may be re-used in multiple locations within your EiffelBuild project, pick the type from the [[Type selector|type selector]]  and drop into the [[Widget selector|widget selector]] . This ensures that at generation time, the object is generated as a seperate class (as with all objects in the [[Widget selector|widget selector]] ). Objects within the [[Widget selector|widget selector]]  may be used in a client fashion within other object structures as required, and any changes made to these objects are reflected at all locations in which they are used. 
+
+{{seealso|<br/>
+[[Type selector|Type selector]]  <br/>
+[[Reparent an Object|Reparent an object]]  <br/>
+[[Delete an object|Delete an object]]  }}
+
+
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/delete-object.wiki

@@ -0,0 +1,16 @@
+[[Property:title|Delete an object]]
+[[Property:weight|2]]
+[[Property:uuid|87dbc23d-4f9c-bd2a-8451-30031b494d37]]
+To remove an [[EiffelBuild Notation|object]]  from your EiffelBuild system, [[EiffelBuild Notation|pick]]  the object you wish to delete, and [[EiffelBuild Notation|drop]]  it on  [[Image:icon-delete-small-color]] in the [[Main toolbar|main toolbar]] . 
+
+You may also delete via the keyboard by pressing the delete key while the tool containing the objects representation has the focus. Whichever [[EiffelBuild Notation|object]]  has the selection is deleted.
+
+{{note|To restore a deleted object, you may use the [[History|History]]  }}
+
+{{seealso|<br/>
+[[History|History]]  <br/>
+[[Type selector|Type selector]]  }}
+
+
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/eiffelbuild-starting-project/eiffelbuild-creating-new-project.wiki

@@ -0,0 +1,24 @@
+[[Property:title|EiffelBuild: Creating a new project]]
+[[Property:weight|0]]
+[[Property:uuid|8668676c-a189-5512-319e-34d70d4039e3]]
+When a project is not open in Build, there are only two menu options available. 'File' and 'Help'. To create a new project, select 'file', 'New project' as illustrated below:
+
+[[Image:new-project]]  
+
+This will bring up a directory dialog from which you can select the directory in which you wish to create the new Build project.
+
+Selecting a directory that does not already contain a Build project will create a new project in that directory and the Build tools will become available for development of the newly created project. If a directory was selected that already contains a Build project, the following dialog will be displayed:
+
+[[Image:overwrite-project]]  
+
+Selecting 'Ok' will create a new project, overwriting the existing project, and the Build tools will become available for development of the newly created project.
+
+Selecting 'Cancel' will return you to the directory selection dialog, from which you can select the directory in which you wish to create the new Build project.
+
+{{seealso|<br/>
+[[Retrieving a project from a Build project file|Retrieving a project from a Build project file]]  <br/>
+}}
+
+
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/eiffelbuild-starting-project/index.wiki

@@ -0,0 +1,5 @@
+[[Property:title|EiffelBuild: Starting a project]]
+[[Property:weight|0]]
+[[Property:uuid|803e2034-dec3-340c-e68e-fdbaefac8a5a]]
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/eiffelbuild-starting-project/retrieving-project-build-project-file.wiki

@@ -0,0 +1,21 @@
+[[Property:title|Retrieving a project from a Build project file]]
+[[Property:weight|1]]
+[[Property:uuid|556cfd8a-f4df-9778-cbb1-eb4a9d795f01]]
+When a project is not open in Build, there are only two menus available, 'File' and 'Help'. To retrieve an existing project, select 'file', 'Open Project
+
+[[Image:open-project]]  
+
+A directory dialog will be displayed from which you can select the Build project file that you wish to retrieve. All build project files are named 'build_project.bpr' and are qualified by the directory in which they reside.
+
+You may also open a recent EiffelBuild project via the 'Recent Projects' entry of the 'file' menu as shown below:
+
+[[Image:recent-projects]]  
+
+This list contains the most recent projects that have been used within EiffelBuild, and if none are available, this list is empty and the menu option disabled.
+
+{{seealso|<br/>
+[[EiffelBuild: Creating a new project|Creating a new project]]  }}
+
+
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/import-project.wiki

@@ -0,0 +1,22 @@
+[[Property:title|Import a project]]
+[[Property:weight|5]]
+[[Property:uuid|ad0b96e1-ca74-5344-44f1-e066205fb76d]]
+The contents of an existing project may be imported into the currently open project, permitting re-use of existing structures. All versions of EiffelBuild before 5.4 limited each project to a single titled window, with 5.4 removing this limitation. The ability to import multiple EiffelBuild projects into a single project is useful for maintaining larger systems with many windows.
+
+To import the contents of an existing project, select 'Import Project' from the 'File' menu as illustrated below:
+
+[[Image:import-project]]  
+
+Upon selection of the menu item, a file dialog is displayed prompting for the EiffelBuild project to be imported (".bpr" files) . Selecting a valid EiffelBuild project file causes the import to commence, during which, EiffelBuild is unresponsive. Please be patient, as importing a large EiffelBuild project may take a little while, depending on the speed of the system.
+
+Upon completion of the import, there are two possible outcomes:
+* No name clashes occurred: No names from the imported project clashes with those of the open project. In this case, notification of success is displayed in the status bar for a short period of time.
+* One or more name clashes occurred: One or more objects or constants from the imported project had names that matched that of objects in the open project. As the names are used directly in the generated code, they must be unique within their scope (accessible within the code), and therefore EiffelBuild must resolve these clashes. A dialog is displayed on screen showing all the names that were resolved by EiffelBuild: 
+[[Image:import-project-clashes]]  
+
+{{note|If a name clash occurs, the names of the imported project are modified, not the open project. }}
+
+
+
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/index.wiki

@@ -0,0 +1,5 @@
+[[Property:title|EiffelBuild How To's]]
+[[Property:weight|0]]
+[[Property:uuid|1df547c8-ca5b-f014-5b4f-a39ecefaa746]]
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/reparent-object.wiki

@@ -0,0 +1,22 @@
+[[Property:title|Reparent an Object]]
+[[Property:weight|4]]
+[[Property:uuid|bf920606-6a40-83fc-5069-034d32f8cd7a]]
+To reparent an [[EiffelBuild Notation|object]] , you need to [[EiffelBuild Notation|pick]]  the [[EiffelBuild Notation|object]]  and [[EiffelBuild Notation|drop]]  it on the [[EiffelBuild Notation|object]]  you wish it to be parented in. The [[EiffelBuild Notation|object]]  will be removed from its current parent, and inserted in the new parent at the next available position. 
+
+When an [[EiffelBuild Notation|object]]  is inserted into a parent, it is always added at the next available position. If you wish to place an [[EiffelBuild Notation|object]]  at a particular position within a parent, you must hold down the '''Shift''' key, and drop on an [[EiffelBuild Notation|object]]  already contained in parent, Your [[EiffelBuild Notation|object]]  will then be inserted in the parent, in the position preceding the child [[EiffelBuild Notation|object]]  that you dropped on. 
+
+You can access [[EiffelBuild Notation|objects]]  from both the [[Builder window|builder window]]  and [[Layout constructor|layout constructor]] . 
+
+{{note|Although window and dialog objects may be accessed within the [[Widget selector|widget selector]] , it is not possible to build into these objects, you should use the [[Layout constructor|layout constructor]]  or [[Builder window|builder window]]  directly in this situation. }}
+
+For more information about an [[EiffelBuild Notation|objects]]  capacity and permitted children, see the [[EiffelVision Introduction|EiffelVision 2]]  documentation. 
+
+{{seealso|<br/>
+[[Create an object|Create an object]]  <br/>
+[[Delete an object|Delete an object]]  <br/>
+[[Builder window|Builder window]]  <br/>
+[[Layout constructor|Layout constructor]]  }}
+
+
+
+

documentation/18.11/solutions/gui-building/eiffelbuild/eiffelbuild-how-tos/save-project.wiki

@@ -0,0 +1,15 @@
+[[Property:title|Save a project]]
+[[Property:weight|3]]
+[[Property:uuid|f2c46797-34c5-5de7-fcad-3447c3db61f5]]
+To save the project that is currently open, select '''Save''' from the '''File''' menu or click on  [[Image:icon-save-color]]  in the [[Main toolbar|main toolbar]] . 
+
+Alternatively, you may use the keyboard shortcut - '''Ctrl+S''' 
+
+{{note|If no changes have been made to the system, the save command will be disabled. }}
+
+{{seealso|<br/>
+[[EiffelBuild: Key shortcuts|Key shortcuts]]  }}
+
+
+
+