[gegl] docs: update development.txt - add link to source-overview (source tree) - update set up instructi



commit f5685d69a04810a85cc0bf7fcaf7796980b5df83
Author: John Marshall <jtm home gmail com>
Date:   Tue Feb 9 12:49:06 2021 +0000

    docs: update development.txt
     - add link to source-overview (source tree)
     - update set up instructions

 docs/development.txt | 60 +++++++++++++++++++++++++++++++---------------------
 docs/meson.build     |  5 ++---
 2 files changed, 38 insertions(+), 27 deletions(-)
---
diff --git a/docs/development.txt b/docs/development.txt
index 2d6a2fccc..cae1a6358 100644
--- a/docs/development.txt
+++ b/docs/development.txt
@@ -4,26 +4,34 @@ Development
 image::images/GEGL.png[GEGL]
 *#Development#*
 
-This document describes some handy things to know when developing the gegl internals. The 
link:glossary.html[GEGL glossary] might help make sense of the terms used.
+This document describes some handy things to know when developing the gegl 
+internals. The link:glossary.html[GEGL glossary] might help make sense of the
+terms used.
 
 link:build.html[Getting sources, and building]::
   Links and information about various ways of getting a build environment for
   GEGL.
 link:images/inheritance.png[GEGL inheritance tree]::
   Generated class inheritance graph generated from runtime introspection.
+link:source-overview.html[Source overview]::
+  An overview of the source tree.
 
 == Setting up
 
-=== Ubuntu 8.10
-Setup instructions for Ubuntu 8.10 Intrepid Ibex
+=== Ubuntu 20.04
+Setup instructions for Ubuntu 20.04 Focal Fossa
 
 To install the mandatory dependencies:
 
- $ sudo apt-get install libtool automake glib libglib2.0-dev libpng12-dev libgtk2.0-dev git
+ $ sudo apt-get install build-essential pkg-config python3 python3-pip ninja-build git libglib2.0-dev 
libjson-glib-dev libpng-dev
+ $ sudo pip3 install meson
 
 Some of the other dependencies:
+  Documentation:
+ $ sudo apt-get install asciidoc source-highlight graphviz-dev
 
- $ sudo apt-get install asciidoc enscript libjpeg62 libopenraw graphviz-dev
+  Plugins:
+$ sudo apt-get install libjpeg libopenraw libtiff
 
 For running gegl the GEGL_PATH, which is used for dynamically loading the 
 operations, has to be set:
@@ -110,11 +118,13 @@ into an image. See http://www.graphviz.org/[graphviz website]
 
 It is done using:
 
- #include "../gegl/gegl-dot.h"
- /* for printing the dot output, note that gegl_node is a GeglNode pointer */
- gchar *dot_output = gegl_to_dot( gegl_node );
- printf( "%s\n", dot_output );
- g_free( dot_output );
+---------------------------------------------
+#include "../gegl/gegl-dot.h"
+/* for printing the dot output, note that gegl_node is a GeglNode pointer */
+gchar *dot_output = gegl_to_dot( gegl_node );
+printf( "%s\n", dot_output );
+g_free( dot_output );
+---------------------------------------------
 
 For creating the graph image:
 
@@ -122,20 +132,22 @@ For creating the graph image:
 
 This is the gaussian-blur.xml file:
 
- <?xml version='1.0' encoding='UTF-8'?>
- <gegl>
-       <node operation='gegl:gaussian-blur'>
-               <params>
-                       <param name='std-dev-x'>0.999</param>
-                       <param name='std-dev-y'>0.999</param>
-               </params>
-       </node>
-       <node operation='gegl:load'>
-               <params>
-                       <param name='path'>in.png</param>
-               </params>
-       </node>
- </gegl>
+---------------------------------------------
+<?xml version='1.0' encoding='UTF-8'?>
+<gegl>
+  <node operation='gegl:gaussian-blur'>
+    <params>
+      <param name='std-dev-x'>0.999</param>
+      <param name='std-dev-y'>0.999</param>
+    </params>
+  </node>
+  <node operation='gegl:load'>
+    <params>
+      <param name='path'>in.png</param>
+    </params>
+  </node>
+</gegl>
+---------------------------------------------
 
 link:images/gaussian-blur-graph.png[Resulting graph].
 
diff --git a/docs/meson.build b/docs/meson.build
index f4df25616..81e4e7107 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -44,12 +44,11 @@ asciidoc_files = files(
   'editor.txt',
   'environment.txt',
   'journal.txt',
-  'source-overview.txt',
 )
 asciidoc_files += [
   configure_file(
     input : 'hello-world.txt.in',
-    output: '@PLAINNAME@',
+    output: '@BASENAME@',
     configuration: asciidoc_config,
   ),
 ]
@@ -90,13 +89,13 @@ endif
 
 website_asciidoc_files = files(
   'index.txt',
-  'build.txt',
   'commandline.txt',
   'development.txt',
   'features.txt',
   'gegl-chain.txt',
   'glossary.txt',
   'operation-api.txt',
+  'source-overview.txt',
 )
 website_asciidoc_files += [
   configure_file(


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]