[anjuta] anjuta-manual: Improve project manager documentation
- From: Sebastien Granjoux <sgranjoux src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [anjuta] anjuta-manual: Improve project manager documentation
- Date: Wed, 18 Jan 2012 20:59:14 +0000 (UTC)
commit c355b81bcb6655ea4d04d3c4b3787f67f1ecf60b
Author: SÃbastien Granjoux <seb sfo free fr>
Date: Wed Jan 18 21:44:02 2012 +0100
anjuta-manual: Improve project manager documentation
.../C/autotools-project-folder-edit.page | 82 +++++++++++
.../C/autotools-project-root-edit.page | 52 +++++++
.../C/autotools-project-target-edit.page | 131 ++++++++++++++++++
.../C/autotools-project-target-type.page | 82 +++++++++++
manuals/anjuta-manual/C/index.page | 2 +-
manuals/anjuta-manual/C/project-import.page | 2 +-
manuals/anjuta-manual/C/project-manager-file.page | 105 --------------
.../C/project-manager-folder-add.page | 49 +++++++
.../C/project-manager-folder-remove.page | 35 +++++
.../anjuta-manual/C/project-manager-folder.page | 22 +++
.../C/project-manager-library-add.page | 84 +++++++++++
.../C/project-manager-library-remove.page | 41 ++++++
.../anjuta-manual/C/project-manager-library.page | 116 ++--------------
.../C/project-manager-module-add.page | 49 +++++++
.../C/project-manager-module-new.page | 75 ++++++++++
.../C/project-manager-module-remove.page | 38 +++++
.../anjuta-manual/C/project-manager-module.page | 146 --------------------
.../C/project-manager-package-add.page | 49 +++++++
.../C/project-manager-package-remove.page | 38 +++++
.../anjuta-manual/C/project-manager-package.page | 87 ------------
manuals/anjuta-manual/C/project-manager-root.page | 23 +++
.../C/project-manager-source-add.page | 55 ++++++++
.../C/project-manager-source-remove.page | 44 ++++++
.../anjuta-manual/C/project-manager-source.page | 23 +++
.../C/project-manager-target-add.page | 56 ++++++++
.../C/project-manager-target-remove.page | 39 +++++
.../anjuta-manual/C/project-manager-target.page | 87 +-----------
.../anjuta-manual/C/project-manager-treeview.page | 78 +++++++++++
manuals/anjuta-manual/C/project-wizard-create.page | 2 +-
manuals/anjuta-manual/Makefile.am | 25 +++-
30 files changed, 1185 insertions(+), 532 deletions(-)
---
diff --git a/manuals/anjuta-manual/C/autotools-project-folder-edit.page b/manuals/anjuta-manual/C/autotools-project-folder-edit.page
new file mode 100644
index 0000000..894fecc
--- /dev/null
+++ b/manuals/anjuta-manual/C/autotools-project-folder-edit.page
@@ -0,0 +1,82 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="autotools-project-folder-edit">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-folder" group="second"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Edit autotools folder properties.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Edit an Autotools Folder</title>
+
+ <p>These properties allows you to define common properties for all targets
+ belonging to this folder.</p>
+
+ <terms>
+ <item>
+ <title><gui>C compiler flags</gui></title>
+ <p>The flags to pass to the C compiler if a per target value is
+ not defined.</p>
+ </item>
+ <item>
+ <title><gui>C preprocessor flags</gui></title>
+ <p>These flags are passed to every compilation that invokes the
+ C preprocessor. This value is ignored if these flags are
+ defined for the target.</p>
+ </item>
+ <item>
+ <title><gui>C++ compiler flags</gui></title>
+ <p>The flags to pass to the C++ compiler flags if a per target value
+ is not defined.</p>
+ </item>
+ <item>
+ <title><gui>Fortran compiler flags</gui></title>
+ <p>The flags to pass to the Fortran 9x compiler if a per target value
+ is not defined.</p>
+ </item>
+ <item>
+ <title><gui>Installation directories</gui></title>
+ <p>This defines installation directories. It is needed if you want to
+ install files in custom directories.</p>
+ </item>
+ <item>
+ <title><gui>Java compiler flags</gui></title>
+ <p>The flags to pass to the Java compiler if a per target value is
+ not defined.</p>
+ </item>
+ <item>
+ <title><gui>Lex/Flex compiler flags</gui></title>
+ <p>The flags to pass to the scanner generator Lex or Flex if a per target
+ value is not defined.</p>
+ </item>
+ <item>
+ <title><gui>Linker flags</gui></title>
+ <p>The flags to pass to the linker if a per target value is not defined.</p>
+ </item>
+ <item>
+ <title><gui>Objective C compiler flags</gui></title>
+ <p>The flags to pass to the Objective C compiler if a per target value
+ is not defined.</p>
+ </item>
+ <item>
+ <title><gui>Vala compiler flags</gui></title>
+ <p>The flags to pass to the Vala compiler if a per target value is not
+ defined.</p>
+ </item>
+ <item>
+ <title><gui>Yacc/Bison compiler flags</gui></title>
+ <p>The flags to pass to the parser generator Bison or Yacc if a per
+ target value is not defined.</p>
+ </item>
+ </terms>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/autotools-project-root-edit.page b/manuals/anjuta-manual/C/autotools-project-root-edit.page
new file mode 100644
index 0000000..531ce77
--- /dev/null
+++ b/manuals/anjuta-manual/C/autotools-project-root-edit.page
@@ -0,0 +1,52 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="autotools-project-root-edit">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-root" group="second"/>
+ <link type="seealso" xref="autotools-project-folder-edit"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Edit autotools project properties.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Edit Autotools Project Properties</title>
+
+ <p>These are the properties of the root item.</p>
+
+ <terms>
+ <item>
+ <title><gui>Name</gui></title>
+ <p>The name of your project. It can contains space.</p>
+ </item>
+ <item>
+ <title><gui>Version</gui></title>
+ <p>This is the project version.</p>
+ </item>
+ <item>
+ <title><gui>Bug report URL</gui></title>
+ <p>This is an URL allowing to send bug report, by example an email
+ address or a link to a bug tracker. It is optional.</p>
+ </item>
+ <item>
+ <title><gui>Package name</gui></title>
+ <p>This is the name of distribution package, it shouldn't contain spaces.
+ It is optional.</p>
+ </item>
+ <item>
+ <title><gui>URL</gui></title>
+ <p>This is the home page of the project. It is optional.</p>
+ </item>
+ </terms>
+
+ <p>In addition, the root item works as a folder and has all its properties.
+ See <link xref="autotools-project-folder-edit"/> to see the list.</p>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/autotools-project-target-edit.page b/manuals/anjuta-manual/C/autotools-project-target-edit.page
new file mode 100644
index 0000000..39d8d44
--- /dev/null
+++ b/manuals/anjuta-manual/C/autotools-project-target-edit.page
@@ -0,0 +1,131 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="autotools-project-target-edit">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-target" group="second"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Edit autotools target properties.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Edit an Autotools Target</title>
+
+ <p>Here is a list of all target properties used in autotools project.
+ Some of them are not available on all targets.</p>
+
+ <terms>
+ <item>
+ <title><gui>Build for check only</gui></title>
+ <p>If checked, this target is not installed and has to be built only
+ when running checks.</p>
+ </item>
+ <item>
+ <title><gui>C compiler flags</gui></title>
+ <p>The flags to pass to the C compiler when compiling target source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>C preprocessor flags</gui></title>
+ <p>These flags are passed to every compilation that invokes the
+ C preprocessor. This value overrides the one eventually defined
+ in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>C++ compiler flags</gui></title>
+ <p>The flags to pass to the C++ compiler flags when compiling target
+ source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Do not install</gui></title>
+ <p>If checked, this target is not installed. It can be used for
+ utilities used to build other target or programs used only by
+ developers.</p>
+ </item>
+ <item>
+ <title><gui>Do not use prefix</gui></title>
+ <p>If checked, do not add prefix to manual page and executable.
+ Such prefix are used to provide alternative of system tools.</p>
+ </item>
+ <item>
+ <title><gui>Fortran compiler flags</gui></title>
+ <p>The flags to pass to the Fortran 9x compiler when compiling target
+ source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Include in distribution</gui></title>
+ <p>If checked, include the target in the distribution package.</p>
+ </item>
+ <item>
+ <title><gui>Installation directory</gui></title>
+ <p>It defines where the target is installed. It is not directly the
+ directory where the files are installed but the name of one of the
+ standard directory variable (bindir, sbindir, libdir, libexecdir,
+ datadir, pkgdatadir, pkglibexecdir, includedir, mandir, infodir,
+ docdir) or a custom variable defined in the folder properties.</p>
+ </item>
+ <item>
+ <title><gui>Java compiler flags</gui></title>
+ <p>The flags to pass to the Java compiler when compiling target
+ source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Keep target path</gui></title>
+ <p>If checked, keep the hierarchy of the project directory when
+ installing files.</p>
+ </item>
+ <item>
+ <title><gui>Lex/Flex compiler flags</gui></title>
+ <p>The flags to pass to the scanner generator Lex or Flex when generating
+ target source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Libraries</gui></title>
+ <p>Specify additional libraries used by the target. Useful for
+ adding non package libraries. See
+ <link xref="project-manager-library">Add non-packaged libraries</link>
+ page for more details.</p>
+ </item>
+ <item>
+ <title><gui>Linker flags</gui></title>
+ <p>The flags to pass to the linker when linking the target.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Manual section</gui></title>
+ <p>Specify the section of the manual where to add man page.
+ Valid section name are the digits â0â through â9â, and the letters
+ âlâ and ânâ.</p>
+ </item>
+ <item>
+ <title><gui>Objective C compiler flags</gui></title>
+ <p>The flags to pass to the Objective C compiler when compiling
+ target source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Vala compiler flags</gui></title>
+ <p>The flags to pass to the Vala compiler when compiling target source
+ files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ <item>
+ <title><gui>Yacc/Bison compiler flags</gui></title>
+ <p>The flags to pass to the parser generator Bison or Yacc when generating
+ target source files.
+ This value overrides the one eventually defined in the parent folder.</p>
+ </item>
+ </terms>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/autotools-project-target-type.page b/manuals/anjuta-manual/C/autotools-project-target-type.page
new file mode 100644
index 0000000..bd78219
--- /dev/null
+++ b/manuals/anjuta-manual/C/autotools-project-target-type.page
@@ -0,0 +1,82 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic"
+ id="autotools-project-target-type">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="seealso" xref="project-manager-target-add"/>
+ <desc>
+ Autotools target type.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Autotools project type</title>
+
+ <p>There are different types of target available.</p>
+
+ <terms>
+ <item>
+ <title>Shared Library</title>
+ <p>It represents a library shared by several programs which is linked
+ at run time. It is the most common kind of libraries on Linux.
+ It is called dynamic link library on Windows.</p>
+ <p>It uses the Libtool package. Its name must start with 'lib'
+ and has the '.la' extension.</p>
+ </item>
+ <item>
+ <title>Static Library</title>
+ <p>It represents a library linked with the program at compile time.
+ Only the function used are kept inside the generated executable.</p>
+ <p>It uses the Libtool package. Its name must start with 'lib'
+ and has the '.a' extension.</p>
+ </item>
+ <item>
+ <title>Program</title>
+ <p>It represents compiled program by example from C souces files.
+ All children represent the source files compiled to generate the
+ program.</p>
+ </item>
+ <item>
+ <title>Python module</title>
+ <p>It represents a program written in Python.</p>
+ </item>
+ <item>
+ <title>Java module</title>
+ <p>It represents a progran written in Java.</p>
+ </item>
+ <item>
+ <title>LISP module</title>
+ <p>It represents a progran written in LISP.</p>
+ </item>
+ <item>
+ <title>Header files</title>
+ <p>This target allows you to group header files and define where they
+ have to be installed.</p>
+ </item>
+ <item>
+ <title>Man documentation</title>
+ <p>It groups man pages needed by the project.</p>
+ </item>
+ <item>
+ <title>Info documentation</title>
+ <p>It groups info page needed by the project.</p>
+ </item>
+ <item>
+ <title>Miscellaneous Data</title>
+ <p>It groups data files which needed by the project like pictures,
+ ui description, settings files...</p>
+ </item>
+ <item>
+ <title>Script</title>
+ <p>It represents program those are scripts. Those scripts are only
+ installed in the specified directory. If scripts are generated
+ additional rules are needed.</p>
+ </item>
+ </terms>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/index.page b/manuals/anjuta-manual/C/index.page
index 669cb43..301db9a 100644
--- a/manuals/anjuta-manual/C/index.page
+++ b/manuals/anjuta-manual/C/index.page
@@ -24,7 +24,7 @@
Anjuta DevStudio
</title>
- <section id="anjuta-project-management" style="2column" groups="first second third">
+ <section id="anjuta-project-management" style="2column" groups="first second third fourth fifth">
<title>Project Management</title>
</section>
diff --git a/manuals/anjuta-manual/C/project-import.page b/manuals/anjuta-manual/C/project-import.page
index c7fa6d4..3547351 100644
--- a/manuals/anjuta-manual/C/project-import.page
+++ b/manuals/anjuta-manual/C/project-import.page
@@ -21,7 +21,7 @@
</credit>
</info>
- <title>Import a project</title>
+ <title>Import a Project</title>
<p>
<app>Anjuta</app> does not have its own project format. It loads projects
diff --git a/manuals/anjuta-manual/C/project-manager-folder-add.page b/manuals/anjuta-manual/C/project-manager-folder-add.page
new file mode 100644
index 0000000..92ebe84
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-folder-add.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-folder-add">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-folder" group="first"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add a folder to a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Add a Folder</title>
+
+ <p>A folder allows you to group several target allowing to set common
+ properties for all of them. It often corresponds to a directory.</p>
+
+ <steps>
+ <item>
+ <p>Select the group or the project where you want to add the new group
+ in the <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Add Group</gui>.</p>
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>Add Group</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Enter a new group name.</p>
+ <note style="tip">
+ <p>Groups names are typically restricted to letters, digits and
+ the underscore, so it's safer to avoid other characters.</p>
+ </note>
+ </item>
+ <item>
+ <p>You can select another group in the bottom <gui>group tree view</gui>.</p>
+ </item>
+ <item>
+ <p>When you have chosen the parent and enter the name, click on the <gui>Add</gui>
+ button to add the group to your project.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-folder-remove.page b/manuals/anjuta-manual/C/project-manager-folder-remove.page
new file mode 100644
index 0000000..02cec51
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-folder-remove.page
@@ -0,0 +1,35 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-folder-remove">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-folder" group="fourth"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Remove folders from a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Remove Folder</title>
+
+ <steps>
+ <item>
+ <p>Select the folder you want to remove in the
+ <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Remove</gui>.</p>
+ </item>
+ <item>
+ <p>Confirm the removal. This will only remove the folder from
+ the project files without removing any files or directories from
+ your disk.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-folder.page b/manuals/anjuta-manual/C/project-manager-folder.page
new file mode 100644
index 0000000..b6d95f4
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-folder.page
@@ -0,0 +1,22 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="guide" style="task"
+ id="project-manager-folder">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="index#anjuta-project-management" group="fifth"/>
+ <link type="seealso" xref="project-manager"/>
+ <link type="seealso" xref="project-manager-treeview"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add, edit or remove folders from a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Manage Folders</title>
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-library-add.page b/manuals/anjuta-manual/C/project-manager-library-add.page
new file mode 100644
index 0000000..a22ad41
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-library-add.page
@@ -0,0 +1,84 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-library-add">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-library" group="sixth"/>
+ <link type="seealso" xref="project-manager-target"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add a custom library to a target.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Add a Custom Library</title>
+
+ <p>It is easier to use a packaged library, which is common on Linux, so
+ check if it is the case <link xref="project-manager-module-new">here</link>.
+ But else you can still use the library as explained below.</p>
+
+ <p>In order to use a library in C, you need to tell the compiler
+ where the header files are, and tell the linker where to find the
+ needed libraries. The issue is that your program will not compile
+ on another computer if the header and the libraries are elsewhere.</p>
+
+ <steps>
+ <item>
+ <p>Select the directory containing the program where you want to
+ add the library in the <gui>project view</gui>, click on the
+ right mouse button to make the <gui>project context menu</gui>
+ appear and select <gui>Properties</gui>.</p>
+
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>Properties</gui></guiseq>. By default, it edits the
+ properties of the currently selected item in the project view.
+ You can select a different item in the drop-down list button.</p>
+ </item>
+ <item>
+ <p>If the header files are installed in a standard location
+ (<file>/usr/include</file>) you don't have to set this. If not,
+ you need to add <input>-I<var>include_path</var></input> in
+ the <gui>C preprocessor flags</gui> property if you are using
+ <app>gcc</app> as your compiler. You can add several paths separated with
+ spaces. These options will be used for all targets inside this
+ directory.</p>
+
+ <p>You might have to expand the <gui>More options</gui> button to see this.
+ Click on the <gui>Apply</gui> button when you are done.</p>
+ </item>
+ <item>
+ <p>Next, you need to add the library to a target.
+ Select the target where you want to
+ add the library in the <gui>project view</gui>, click on the
+ right mouse button to make the <gui>project context menu</gui>
+ appear and select <gui>Properties</gui>.</p>
+
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>Properties</gui></guiseq>. By default, it edits the
+ properties of the currently selected item in the project view.
+ You can select a different item in the drop-down list button.</p>
+ </item>
+ <item>
+ <p>You need to set the <gui>Linker flags</gui> property, adding
+ <input>-l<var>library_name</var></input> if your compiler is <app>gcc</app>.
+ <var>library_name</var> is the name of the library file without the
+ <file>lib</file> prefix and without the <file>.a</file> or
+ <file>.so</file> extension.</p>
+
+ <p>If the library is in not in a standard directory, <app>gcc</app>
+ can look in additional directories with the option
+ <input>-L<var>library_path</var></input>.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-library-remove.page b/manuals/anjuta-manual/C/project-manager-library-remove.page
new file mode 100644
index 0000000..ece61a2
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-library-remove.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-library-remove">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-library" group="seventh"/>
+ <link type="seealso" xref="project-manager-target"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Remove a custom library from a target.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Remove a Custom Library</title>
+
+ <steps>
+ <item>
+ <p>Select the target that has the library you want to remove in the
+ <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Properties</gui>.</p>
+ </item>
+ <item>
+ <p>Remove the library from the
+ <gui>C preprocessor flags</gui> and <gui>Linker flags</gui>
+ properties. Click on the <gui>Apply</gui> button to write the
+ changes to the project files.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-library.page b/manuals/anjuta-manual/C/project-manager-library.page
index 9cf49aa..4293d1c 100644
--- a/manuals/anjuta-manual/C/project-manager-library.page
+++ b/manuals/anjuta-manual/C/project-manager-library.page
@@ -1,122 +1,24 @@
<page xmlns="http://projectmallard.org/1.0/";
- type="topic" style="task"
- id="project-manager-library">
+ type="guide" style="task"
+ id="project-manager-library"
+ groups="first second third fourth fifth sixth seventh">
<info xmlns:facet="http://projectmallard.org/facet/1.0/";>
<facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="index#anjuta-project-management" group="fourth"/>
+ <link type="seealso" xref="project-manager"/>
+ <link type="seealso" xref="project-manager-treeview"/>
+ <link type="seealso" xref="project-manager-target"/>
<revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
<desc>
- Add or remove non-packaged libraries from a project.
+ Add or remove libraries to project targets.
</desc>
<credit type="author">
<name>SÃbastien Granjoux</name>
<email>seb sfo free fr</email>
</credit>
- <credit type="editor">
- <name>Philip Chimento</name>
- <email>philip chimento gmail com</email>
- </credit>
</info>
- <title>Add or remove non-packaged libraries</title>
-
- <section>
- <title>Add a non-packaged library to a target</title>
-
- <p>
- In order to use a library in C, you need to tell the compiler
- where the header files are, and tell the linker where to find the
- needed libraries. The issue is that your program will not compile
- on another computer if the header and the libraries are elsewhere.
- </p>
-
- <steps>
- <item>
- <p>
- Select the directory containing the program where you want to
- add the library in the <gui>project view</gui>, click on the
- right mouse button to make the <gui>project context menu</gui>
- appear and select <gui>Properties</gui>.
- </p>
- <p>
- Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
- <gui>Properties</gui></guiseq>. By default, it edits the
- properties of the currently selected item in the project view.
- You can select a different node, by expanding
- <gui>Browse other nodes</gui> and selecting another one.
- </p>
- </item>
- <item>
- <p>
- If the header files are installed in a standard location
- (<file>/usr/include</file>) you don't have to set this. If not,
- you need to add <input>-I<var>include_path</var></input> in
- the <gui>C preprocessor flags</gui> property if you are using
- <app>gcc</app> as your compiler. You can add several paths separated with
- spaces. These options will be used for all targets inside this
- directory.
- </p>
- <p>
- You might have to expand the <gui>More options</gui> button to see this.
- Click on the <gui>Apply</gui> button when you are done.
- </p>
- </item>
- <item>
- <p>
- Next, you need to add the library to a target.
- Select the target where you want to
- add the library in the <gui>project view</gui>, click on the
- right mouse button to make the <gui>project context menu</gui>
- appear and select <gui>Properties</gui>.
- </p>
- <p>
- Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
- <gui>Properties</gui></guiseq>. By default, it edits the
- properties of the currently selected item in the project view.
- You can select a different node, by expanding
- <gui>Browse other nodes</gui> and selecting another one.
- </p>
- </item>
- <item>
- <p>
- You need to set the <gui>Linker flags</gui> property, adding
- <input>-l<var>library_name</var></input> if your compiler is <app>gcc</app>.
- <var>library_name</var> is the name of the library file without the
- <file>lib</file> prefix and without the <file>.a</file> or
- <file>.so</file> extension.
- </p>
- <p>
- If the library is in not in a standard directory, <app>gcc</app>
- can look in additional directories with the option
- <input>-L<var>library_path</var></input>.
- </p>
- </item>
- </steps>
- </section>
-
- <section>
- <title>Remove a non packaged library from a target</title>
-
- <steps>
- <item>
- <p>
- Select the target that has the library you want to remove in the
- <gui>project view</gui>, click on the right mouse button to
- make the <gui>project context menu</gui> appear and select
- <gui>Properties</gui>.
- </p>
- </item>
- <item>
- <p>
- Remove the library from the
- <gui>C preprocessor flags</gui> and <gui>Linker flags</gui>
- properties. Click on the <gui>Apply</gui> button to write the
- changes to the project files.
- </p>
- </item>
- </steps>
-
- </section>
-
+ <title>Manage Libraries</title>
</page>
diff --git a/manuals/anjuta-manual/C/project-manager-module-add.page b/manuals/anjuta-manual/C/project-manager-module-add.page
new file mode 100644
index 0000000..525197f
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-module-add.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-module-add">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <link type="guide" xref="project-manager-library" group="fourth"/>
+ <link type="seealso" xref="project-manager-module-new"/>
+ <desc>
+ Add a set of libraries to a target.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Add a Module</title>
+
+ <p>Packages cannot be added directly to a target. You need to put them
+ into a module first and add this module to the target. See
+ <link xref="project-manager-module-new"/> to know how to do create a module.</p>
+
+ <steps>
+ <item>
+ <p>Select the program where you want to add the new library in
+ the <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Add Library</gui>.</p>
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>Add Library...</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>You need to select the target where you want to add the module
+ in the <gui>target button</gui> above, and select the module that
+ you want to add in the <gui>module view</gui> below. If you
+ select a library inside a module, the parent module will be added.</p>
+ <p>When you are done, click on the <gui>Add</gui> button to add the
+ module.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-module-new.page b/manuals/anjuta-manual/C/project-manager-module-new.page
new file mode 100644
index 0000000..8faab52
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-module-new.page
@@ -0,0 +1,75 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-module-new">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-library" group="first"/>
+ <link type="next" xref="project-manager-module-add"/>
+ <link type="seealso" xref="project-manager-library"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Create a set of libraries.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Create a Module</title>
+
+ <p>On Linux, most libraries are distributed with additional data stored
+ in a <app>pkg-config</app> file. This file contains information like
+ the other libraries needed, the C compiler and the linker flags needed
+ to use that library. This file, the header files and the library files
+ themselves is called a package.</p>
+
+ <p><app>Anjuta</app> provides an simple interface to use such library.
+ If the library you need is not one of these, check the
+ <link xref="project-manager-library-add">Add non-packaged libraries</link>
+ page.</p>
+
+ <p>A package cannot be added directly to your program; you first need to
+ create a module for it, which is just a group of packages.</p>
+
+ <steps>
+ <item>
+ <p>Select the program where you want to add the new library in
+ the <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear, and select
+ <gui>Add Library</gui>. Then click on the <gui>New Library</gui>
+ button on this dialog.</p>
+
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>New Library...</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>You will get a list of all the packaged libraries installed on your
+ system. You can check one or more libraries.</p>
+ <note style="tip">
+ <p>If the library you want does not appear here, perhaps it
+ is because it is not installed on your system.
+ Launch the application you
+ use to install new programs and search for the library name.
+ The package you need often has a "dev" or "devel" suffix and
+ should include header files and a <app>pkg-config</app> file with a
+ <file>.pc</file> extension.</p>
+ </note>
+ <p>After selecting one library, a module name will be
+ automatically generated but you can change it. When you are
+ done, click on the <gui>Add</gui> button to create the new module
+ with the selected libraries.</p>
+ </item>
+ <item>
+ <p>Read the <link xref="project-manager-module-add">next page</link> to
+ find out how to add this new module to your target.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-module-remove.page b/manuals/anjuta-manual/C/project-manager-module-remove.page
new file mode 100644
index 0000000..ec458c6
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-module-remove.page
@@ -0,0 +1,38 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-module-remove">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <link type="guide" xref="project-manager-library" group="fifth"/>
+ <link type="seealso" xref="project-manager-module-add"/>
+ <desc>
+ Remove a set of libraries from a target.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Remove a Module</title>
+
+ <steps>
+ <item>
+ <p>Select the library you want to remove in the
+ <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear, and select
+ <gui>Remove</gui>.</p>
+ </item>
+ <item>
+ <p>Confirm the removal. This library will be removed from the target.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-package-add.page b/manuals/anjuta-manual/C/project-manager-package-add.page
new file mode 100644
index 0000000..a181132
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-package-add.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-package-add">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-library" group="second"/>
+ <link type="next" xref="project-manager-module-add"/>
+ <link type="seealso" xref="project-manager-library-add"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add a library in a module.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Add a Package</title>
+
+ <steps>
+ <item>
+ <p>Select the module where you want to add the new library in
+ the <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>New Library</gui>.</p>
+
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>New Library...</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>In the list of all packaged libraries, check the additional
+ libraries wanted. Check that expected module name is selected
+ in the bottom text box.
+ Then click on the <gui>Add</gui> button to update the module.</p>
+ </item>
+ <item>
+ <p>Read the <link xref="project-manager-module-add">next page</link> to
+ find out how to add the module to your target.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-package-remove.page b/manuals/anjuta-manual/C/project-manager-package-remove.page
new file mode 100644
index 0000000..34c6e39
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-package-remove.page
@@ -0,0 +1,38 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-package-remove">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-library" group="third"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Remove a library from a module.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Remove a Package</title>
+
+ <steps>
+ <item>
+ <p>Select the package you want to remove in the
+ <gui>project view</gui> , click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Remove</gui>.</p>
+ </item>
+ <item>
+ <p>Confirm the removal. This package will be removed from the project
+ file.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-root.page b/manuals/anjuta-manual/C/project-manager-root.page
new file mode 100644
index 0000000..0a2fde0
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-root.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="guide" style="task"
+ id="project-manager-root">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="index#anjuta-project-management" group="fourth"/>
+ <link type="seealso" xref="project-manager"/>
+ <link type="seealso" xref="project-manager-treeview"/>
+ <link type="seealso" xref="project-manager-source"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Edit project properties.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Edit a Project</title>
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-source-add.page b/manuals/anjuta-manual/C/project-manager-source-add.page
new file mode 100644
index 0000000..451ae15
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-source-add.page
@@ -0,0 +1,55 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-source-add">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-source" group="first"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add existing files to a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Add Files</title>
+
+ <steps>
+ <item>
+ <p>Select the target where you want to add the new source files in
+ the <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Add Source File</gui>.</p>
+
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>Add Source File...</gui></guiseq></p>
+ </item>
+ <item>
+ <p>You can select another target in the top <gui>target chooser button</gui>.
+ </p>
+ </item>
+ <item>
+ <p>In the file chooser below, select the files you want to add.
+ Then click on the <gui>Add</gui> button to add those files to your
+ project. You can select several files at the same time keeping
+ <key>Ctrl</key> key pressed or using the <key>Shift</key> to select
+ a range of files.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>You can add files in sub-directories of the project. Most
+ project formats require the files to be under the project
+ directory. Added source files outside the project directory are
+ automatically copied inside to fulfill this requirement.</p>
+ </note>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-source-remove.page b/manuals/anjuta-manual/C/project-manager-source-remove.page
new file mode 100644
index 0000000..69fa1ef
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-source-remove.page
@@ -0,0 +1,44 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-source-delete">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-source" group="third"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Remove files from a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Remove Files</title>
+
+ <steps>
+ <item>
+ <p>Select the file you want to remove in the
+ <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Remove</gui>.</p>
+ </item>
+ <item>
+ <p>Confirm the removal. The file will only be removed from the project,
+ not from your disk.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>You can select several files at the same time by keeping the
+ <key>Ctrl</key> key pressed or select a range using the <key>Shift</key>
+ key.</p>
+ </note>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-source.page b/manuals/anjuta-manual/C/project-manager-source.page
new file mode 100644
index 0000000..8435d3f
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-source.page
@@ -0,0 +1,23 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="guide" style="task"
+ id="project-manager-source">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="index#anjuta-project-management" group="fourth"/>
+ <link type="seealso" xref="project-manager"/>
+ <link type="seealso" xref="project-manager-treeview"/>
+ <link type="seealso" xref="project-manager-target"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add or remove files from a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>Manage Files</title>
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-target-add.page b/manuals/anjuta-manual/C/project-manager-target-add.page
new file mode 100644
index 0000000..0fcfb17
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-target-add.page
@@ -0,0 +1,56 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-target-add">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-target" group="fifth"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Add a target to a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Add a Target</title>
+
+ <p>A target groups files together and defines their use.
+ It is used to represent a program, with all its source files as its children
+ or only group data files those should be installed at the same place.</p>
+
+ <steps>
+ <item>
+ <p>Select the directory where you want to add the new target in
+ the <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>New Target</gui>.</p>
+ <p>Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
+ <gui>New Target...</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>You can select another directory in the bottom <gui>directory tree view</gui>.
+ </p>
+ <p>Enter a target name and select the type of the target in the
+ drop-down list below.
+ Depending on your project backend, various types of target are possible,
+ see at the bottom.</p>
+ <note style="tip">
+ <p>Target names are typically restricted to letters, digits and
+ the underscore, so it's safer to avoid other characters.</p>
+ </note>
+ </item>
+ <item>
+ <p>When you have chosen the target name, type and parent, click on the
+ <gui>Add</gui> button to create this new target.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-target-remove.page b/manuals/anjuta-manual/C/project-manager-target-remove.page
new file mode 100644
index 0000000..37451d7
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-target-remove.page
@@ -0,0 +1,39 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="project-manager-target-remove">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="project-manager-target" group="fifth"/>
+ <revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
+ <desc>
+ Remove a target from a project.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ <credit type="editor">
+ <name>Philip Chimento</name>
+ <email>philip chimento gmail com</email>
+ </credit>
+ </info>
+
+ <title>Remove a Target</title>
+
+ <steps>
+ <item>
+ <p>Select the target you want to remove in the
+ <gui>project view</gui>, click on the right mouse button to
+ make the <gui>project context menu</gui> appear and select
+ <gui>Remove</gui>.</p>
+ </item>
+ <item>
+ <p>Confirm the removal. The target and all its properties will be
+ removed from the project file. All its files stay untouched on your
+ hard disk.</p>
+ </item>
+ </steps>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-manager-target.page b/manuals/anjuta-manual/C/project-manager-target.page
index 61726c6..23c1794 100644
--- a/manuals/anjuta-manual/C/project-manager-target.page
+++ b/manuals/anjuta-manual/C/project-manager-target.page
@@ -1,98 +1,23 @@
<page xmlns="http://projectmallard.org/1.0/";
- type="topic" style="task"
+ type="guide" style="task"
id="project-manager-target">
<info xmlns:facet="http://projectmallard.org/facet/1.0/";>
<facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
- <link type="guide" xref="index#anjuta-project-management" group="second"/>
+ <link type="guide" xref="index#anjuta-project-management" group="fourth"/>
<link type="seealso" xref="project-manager"/>
+ <link type="seealso" xref="project-manager-treeview"/>
+ <link type="seealso" xref="project-manager-source"/>
<revision pkgversion="3.0" version="0.1" date="2011-03-27" status="incomplete"/>
<desc>
- Add or remove a target from a project.
+ Add, edit or remove targets from a project.
</desc>
<credit type="author">
<name>SÃbastien Granjoux</name>
<email>seb sfo free fr</email>
</credit>
- <credit type="editor">
- <name>Philip Chimento</name>
- <email>philip chimento gmail com</email>
- </credit>
</info>
- <title>Add or remove targets</title>
-
- <p>
- If the project backend supports it, you can add or remove targets in your
- project without editing the project file. A target groups
- files together. It is typically used to represent a program, with
- all its source files as its children.
- </p>
-
- <section>
- <title>Add a target</title>
-
- <steps>
- <item>
- <p>
- Select the directory where you want to add the new target in
- the <gui>project view</gui>, click on the right mouse button to
- make the <gui>project context menu</gui> appear and select
- <gui>New Target</gui>.
- </p>
- <p>
- Or from the <gui>main menu</gui>, select <guiseq><gui>Project</gui>
- <gui>New Target...</gui></guiseq>
- </p>
- </item>
- <item>
- <p>
- You can select another directory in the bottom <gui>directory tree view</gui>.
- </p>
- <p>
- Enter a target name and select the type of the target in the
- drop-down list below. Depending on your project backend, various
- types of target are possible.
- </p>
- <note style="tip">
- <p>
- Target names are typically restricted to letters, digits and
- the underscore, so it's safer to avoid other characters.
- </p>
- </note>
- </item>
- <item>
- <p>
- When you have chosen the target name, type and parent, click on the
- <gui>Add</gui> button to create this new target.
- </p>
- </item>
- </steps>
-
- </section>
-
- <section>
- <title>Remove a target</title>
-
- <steps>
- <item>
- <p>
- Select the target you want to remove in the
- <gui>project view</gui>, click on the right mouse button to
- make the <gui>project context menu</gui> appear and select
- <gui>Remove</gui>.
- </p>
- </item>
- <item>
- <p>
- Confirm the removal. The target and all its properties will be
- removed from the project file. All its files stay untouched on your
- hard disk.
- </p>
- </item>
- </steps>
- </section>
-
-
+ <title>Manage Targets</title>
</page>
diff --git a/manuals/anjuta-manual/C/project-manager-treeview.page b/manuals/anjuta-manual/C/project-manager-treeview.page
new file mode 100644
index 0000000..57b4a6e
--- /dev/null
+++ b/manuals/anjuta-manual/C/project-manager-treeview.page
@@ -0,0 +1,78 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="guide"
+ id="project-manager-treeview">
+
+ <info xmlns:facet="http://projectmallard.org/facet/1.0/";>
+ <facet:tag key="all-pages" value="whatever"/> <!--Include page in index-->
+ <link type="guide" xref="index#anjuta-project-management" group="third"/>
+ <desc>
+ Display project's content.
+ </desc>
+ <credit type="author">
+ <name>SÃbastien Granjoux</name>
+ <email>seb sfo free fr</email>
+ </credit>
+ </info>
+
+ <title>View a Project</title>
+
+ <p>A project is represented by a tree, the root item corresponds
+ to the project while children represent programs, libraries, directories
+ and source files. Each item can have properties allowing to set more details
+ like project version, compiler flags or installation directories.
+ These item are divided in several categories, depending on the backend
+ not all are available:</p>
+
+ <terms>
+ <item>
+ <title>Root</title>
+ <p>There is only one node of this kind. It represents the project
+ itself. It is the place where you can set project wide properties
+ like the project name or the project version.</p>
+ </item>
+ <item>
+ <title>Module</title>
+ <p>This is a set of packages used in autotools project. They appear
+ as children of the root node to represent all modules defined and
+ as children of each target using them. For more details, see
+ <link xref="project-manager-module-new"/>.</p>
+ </item>
+ <item>
+ <title>Package</title>
+ <p>This is a packaged library used in autotools project. They appear
+ as children of each module. For more details, see
+ <link xref="project-manager-library"/>.</p>
+ </item>
+ <item>
+ <title>Folder</title>
+ <p>This is used to group targets allowing to set common
+ properties. They are often implemented by sub directories.
+ For more details, see <link xref="project-manager-folder"/>.</p>
+ </item>
+ <item>
+ <title>Target</title>
+ <p>It groups files and define how they are used.
+ There are several kinds of targets, by example program, library or data,
+ corresponding to different use of the child files.
+ They often represent generated project files like compiled programs or
+ libraries. For more details see <link xref="project-manager-target"/>.</p>
+
+ <note style="tip">
+ <p>You can drag and drop targets at the beginning of the project tree view
+ to create a shortcut allowing to access them more easily. By default all
+ program targets are already put here.</p>
+ </note>
+
+ </item>
+ <item>
+ <title>Source</title>
+ <p>Each source file is represented by a item in the project view. The use
+ of each file depends on its parent target. All children of a program
+ target are compiled to generate it. While children of a data target are
+ only copied to a directory when the project is installed.
+ For more details see <link xref="project-manager-source"/>.</p>
+ </item>
+ </terms>
+
+</page>
+
diff --git a/manuals/anjuta-manual/C/project-wizard-create.page b/manuals/anjuta-manual/C/project-wizard-create.page
index 4ac8642..6223e08 100644
--- a/manuals/anjuta-manual/C/project-wizard-create.page
+++ b/manuals/anjuta-manual/C/project-wizard-create.page
@@ -20,7 +20,7 @@
</credit>
</info>
- <title>Create a project</title>
+ <title>Create a Project</title>
<p>
New projects are created from templates. <app>Anjuta</app> will ask you
diff --git a/manuals/anjuta-manual/Makefile.am b/manuals/anjuta-manual/Makefile.am
index d247eaf..1244afa 100644
--- a/manuals/anjuta-manual/Makefile.am
+++ b/manuals/anjuta-manual/Makefile.am
@@ -11,6 +11,11 @@ DOC_PAGES = \
anjuta-code-symbols.page \
anjuta-glade-signals.page \
anjuta-glade-start.page \
+ autotools-project-backend.page \
+ autotools-project-folder-edit.page \
+ autotools-project-root-edit.page \
+ autotools-project-target-edit.page \
+ autotools-project-target-type.page \
autotools-build-build.page \
autotools-build-clean.page \
autotools-build-compile.page \
@@ -40,12 +45,26 @@ DOC_PAGES = \
introduction.page \
makefile-project-backend.page \
project-import.page \
- project-manager-file.page \
+ project-manager-folder-add.page \
+ project-manager-folder.page \
+ project-manager-folder-remove.page \
+ project-manager-library-add.page \
project-manager-library.page \
- project-manager-module.page \
- project-manager-package.page \
+ project-manager-library-remove.page \
+ project-manager-module-add.page \
+ project-manager-module-new.page \
+ project-manager-module-remove.page \
+ project-manager-package-add.page \
+ project-manager-package-remove.page \
project-manager.page \
+ project-manager-root.page \
+ project-manager-source-add.page \
+ project-manager-source.page \
+ project-manager-source-remove.page \
+ project-manager-target-add.page \
project-manager-target.page \
+ project-manager-target-remove.page \
+ project-manager-treeview.page \
project-wizard-create.page \
project-wizard-template.page \
run-parameters-dialog.page \
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
