[geany/geany] 642553: Update geany.txt with the Project->New from Folder item

[Jiří Techet]

Branch:      refs/heads/master
Author:      Jiří Techet <techet at gmail.com>
Committer:   Jiří Techet <techet at gmail.com>
Date:        Thu, 28 Apr 2022 11:15:53 UTC
Commit:      642553bb887dcc1322a3c65598991054e8c11a02
             https://github.com/geany/geany/commit/642553bb887dcc1322a3c65598991054e8c11a02

Log Message:
-----------
Update geany.txt with the Project->New from Folder item


Modified Paths:
--------------
    doc/geany.txt

Modified: doc/geany.txt
37 lines changed, 29 insertions(+), 8 deletions(-)
===================================================================
@@ -2776,14 +2776,35 @@ The project menu items are detailed below.
 New project
 ^^^^^^^^^^^
 
-To create a new project, fill in the *Name* field. By default this
-will setup a new project file ``~/projects/name.geany``. Usually it's
-best to store all your project files in the same directory (they are
-independent of any source directory trees).
-
-The Base path text field is setup to use ``~/projects/name``. This
-can safely be set to any existing path -- it will not touch the file
-structure contained in it.
+There are two ways of creating new projects, either by using
+*Project->New* menu item or by using *Project->New from Folder* menu
+item.
+
+New
+    This method is more suitable for creating new, empty projects from
+    scratch at the default location without having any existing sources.
+
+    To create a new project, fill in the *Name* field. By default this
+    will setup a new project file ``~/projects/name/name.geany``.
+
+    The *Base path* text field is setup to use ``~/projects/name``. This
+    can safely be set to any existing path -- it will not touch the file
+    structure contained in it.
+
+New from Folder
+    This method is more suitable when there is already some folder
+    containing source files for which you want to create a new project.
+
+    When using this method, Geany first opens a directory selection
+    dialog to select the folder containing the sources, and the
+    *Base path* field is set to that value.
+
+    Afterwards, Geany shows the same dialog as the *Project->New*
+    method but already pre-filled with the values based on the
+    *Base path* selection. The *Name* field is filled with the folder
+    name, the *Filename* field is filled with
+    ``base_path/name.geany`` and the *Base path* field is filled with
+    the path specified in the previous dialog.
 
 
 Project properties



--------------
This E-Mail was brought to you by github_commit_mail.py (Source: https://github.com/geany/infrastructure).