Changeset - f747a32958da
[Not reviewed]
default
0 6 0
Michael Guravage - 14 years ago 2011-02-16 10:52:07
michael.guravage@cwi.nl
Reworked the recipe a bit.

--
user: Michael Guravage <michael.guravage@cwi.nl>
branch 'default'
changed doc/Makefile
changed doc/installation.pdf
changed doc/installation.rst
changed doc/recipe.rst
changed doc/stylesheet.json
changed doc/v1.pdf
6 files changed with 85 insertions and 100 deletions:
0 comments (0 inline, 0 general)
doc/Makefile
Show inline comments
 
@@ -6,13 +6,18 @@
 
.rst.html :
 
	rst2html.py $< $@
 

	
 
all: v1.pdf v1.html
 
all: v1.pdf v1.html installation.pdf installation.html recipe.pdf recipe.html 
 

	
 
v1.pdf : v1.rst
 
v1.html : v1.rst
 

	
 
v1.html : v1.rst
 
installation.pdf : installation.rst
 
installation.html : installation.rst
 

	
 
recipe.pdf : recipe.rst
 
recipe.html : recipe.rst
 

	
 
clean:
 
	/bin/rm -f v1.pdf v1.html
 
	/bin/rm -f v1.pdf v1.html installation.pdf installation.html recipe.pdf recipe.html
 

	
 
#finis
 
\ No newline at end of file
doc/installation.pdf
Show inline comments
 
@@ -110,7 +110,7 @@ endobj
 
% 'R10': class PDFInfo 
 
10 0 obj
 
<< /Author ()
 
 /CreationDate (D:20100623150545-01'00')
 
 /CreationDate (D:20110216100041-01'00')
 
 /Keywords ()
 
 /Producer (ReportLab http://www.reportlab.com)
 
 /Subject (\(unspecified\))
 
@@ -364,7 +364,7 @@ Q
 
q
 
1 0 0 1 56.69291 773.1969 cm
 
q
 
BT 1 0 0 1 0 4.82 Tm 160.0749 0 Td 12 TL /F1 10 Tf 0 0 0 rg (Installation Instructions - 2010-06-23) Tj T* -160.0749 0 Td ET
 
BT 1 0 0 1 0 4.82 Tm 160.0749 0 Td 12 TL /F1 10 Tf 0 0 0 rg (Installation Instructions - 2011-02-16) Tj T* -160.0749 0 Td ET
 
Q
 
Q
 
q
 
@@ -507,7 +507,7 @@ Q
 
q
 
1 0 0 1 56.69291 773.1969 cm
 
q
 
BT 1 0 0 1 0 4.82 Tm 160.0749 0 Td 12 TL /F1 10 Tf 0 0 0 rg (Installation Instructions - 2010-06-23) Tj T* -160.0749 0 Td ET
 
BT 1 0 0 1 0 4.82 Tm 160.0749 0 Td 12 TL /F1 10 Tf 0 0 0 rg (Installation Instructions - 2011-02-16) Tj T* -160.0749 0 Td ET
 
Q
 
Q
 
q
 
@@ -569,7 +569,7 @@ 0000015840 00000 n
 
trailer
 
<< /ID 
 
 % ReportLab generated PDF document -- digest (http://www.reportlab.com) 
 
 [(\361i\357\326\223\205\376 cX\3301\266\222\010\004) (\361i\357\326\223\205\376 cX\3301\266\222\010\004)] 
 
 [(&q\332\037\311\250\223EgHo\314\021\224\013\364) (&q\332\037\311\250\223EgHo\314\021\224\013\364)] 
 
 
 /Info 10 0 R
 
 /Root 9 0 R
doc/installation.rst
Show inline comments
 
@@ -9,7 +9,7 @@
 
.. footer::
 
  ###Page### 
 

	
 

	
 
=========================
 
Installation Instructions
 
=========================
 

	
doc/recipe.rst
Show inline comments
 
@@ -9,21 +9,20 @@
 
.. footer::
 
  ###Page### 
 

	
 

	
 
============
 
Virtual Leaf
 
============
 

	
 
------------------
 
Linux Installation
 
------------------
 

	
 
Material
 
++++++++
 
  #. The Virtual Leaf source code
 
  #. `QT SDK <http://qt.nokia.com>`_
 
````````
 
#. The Virtual Leaf source code from http://virtualleaf.googlecode.com/files/VirtualLeaf-v1.0-src.zip.
 
#. The QT SDK from http://qt.nokia.com.
 
  #. Development Systems will have many of these items already installed:
 

	
 
    #. Python programming language
 
    #. `Mercurial revision control system <http://mercurial.selenic.com/wiki>`_
 
    #. KDiff2 diff/merge tool.
 
    #. GCC, The GNU Compiler Collection
 
    #. GNU Make
 
@@ -33,12 +32,12 @@ Material
 
    #. Libxml2 XML parser
 

	
 
Methods
 
+++++++
 
  #. Install the aforementioned development software.  The following
 
     commands should show meaningful output::
 
```````
 

	
 
      python --version
 
      hg --version
 
#. Install the aforementioned development software. If any of these
 
   are missing, ask your system administrator to install them for
 
   you. The following commands should show meaningful output::
 

	
 
      gcc --version 
 
      make --version
 
      iconv --version
 
@@ -46,10 +45,11 @@ Methods
 
      locate libz.so
 
      locate libxml2.so
 

	
 

	
 
  #. The VirtualLeaf is written with the QT Cross platform application
 
     and UI framework. To compile the VirtualLeaf from source you will
 
     need to install the QT software development kit(SDK), which you
 
     can download from the `QT download site <http://qt.nokia.com/downloads/downloads>`_.
 
   can download from the QT download site: ``http://qt.nokia.com/downloads/downloads>``.
 

	
 
  #. Whether installed globally by a system administrator our locally in
 
     your own user space, make sure the QT bin directory containing qmake
 
@@ -57,27 +57,14 @@ Methods
 

	
 
      > PATH=/opt/QT/qt/bin:$PATH 
 

	
 
  #. Create a Mercurial configuration file named .hgrc in your home
 
     directory containing the following lines::
 

	
 
      [ui]
 
        username = Your Name <your e-mail address>
 
        merge = kdiff3
 

	
 
      [extdiff]
 
        cmd.vdiff = kdiff3
 

	
 
      [merge-tools]
 
        diffFiles.args = $local $other $base 
 
        kdiff3.args = $base $local $other -o $output
 

	
 
  #. Make or change to the directory where you wish to install the Virtual Leaf::
 

	
 
      > cd /home/michael/simulations
 

	
 
  #. Retrieve the Virtual Leaf source code from its  Google Code repository::
 

	
 
      > hg clone https://virtualleaf.googlecode.com/hg/ virtualleaf
 
    > wget http://virtualleaf.googlecode.com/files/VirtualLeaf-v1.0-src.zip
 
    > unzip http://virtualleaf.googlecode.com/files/VirtualLeaf-v1.0-src.zip
 

	
 
  #. Compilation is effected with make. To facilitate cross platform
 
     compatibility, the makefiles use two environment variables:
 
@@ -103,25 +90,30 @@ Methods
 
     Once the compilation is complete, you will find the ``VirtualLeaf``
 
     binary in ``virtualleaf/bin`` and the plugins in ``virtualleaf/bin/models``.
 

	
 

	
 
Windows
 
-------
 
--------------------
 
Windows Installation
 
--------------------
 

	
 
Material
 
++++++++
 
  #. The Virtual Leaf source code
 
  #. QT SDK:  http://get.qt.nokia.com/qtsdk/qt-sdk-win-opensource-2010.02.1.exe
 
````````
 
#. The Virtual Leaf source code from http://virtualleaf.googlecode.com/files/VirtualLeaf-v1.0-src.zip.
 

	
 
#. The QT SDK from http://get.qt.nokia.com/qtsdk/qt-sdk-win-opensource-2010.02.1.exe.
 

	
 
  #. Development Systems most likely will have most of the items in the following list already installed:
 

	
 
     #. Python programming language
 
     #. `Mercurial <http://mercurial.selenic.com/wiki/Download#Windows>`_ revision control system .
 
     #. `KDiff3 diff/merge tool <http://sourceforge.net/projects/kdiff3/files/>`_.
 
     #. `Iconv conversion utilities <http://sourceforge.net/projects/mingw/files/MinGW/libiconv/libiconv-1.13/>`_ 
 
        (rename libiconv.dll.a to libiconv.a).
 
     #. `Perl programming language <http://strawberry-perl.googlecode.com/files/strawberry-perl-5.10.1.1.msi>`_.
 
     #. `Zlib compression library <http://sourceforge.net/projects/mingw/files/MinGW/zlib/zlib-1.2.3-1-mingw32/>`_.
 
     #. `libz-1.dll <http://sourceforge.net/projects/mingw/files/MinGW/zlib/zlib-1.2.3-1-mingw32/>`_ (rename to zlib1.dll).
 
     #. Libxml2 XML parser: from ftp://ftp.zlatkovic.com/libxml/ or ftp://xmlsoft.org/libxml2/win32.
 
   #. KDiff3 diff/merge tool http://sourceforge.net/projects/kdiff3/files.
 

	
 
   #. Iconv utilities http://sourceforge.net/projects/mingw/files/MinGW/libiconv/libiconv-1.13 (rename libiconv.dll.a to libiconv.a).
 

	
 
   #. Perl http://strawberry-perl.googlecode.com/files/strawberry-perl-5.10.1.1.msi.
 

	
 
   #. Zlib library ftp://sourceforge.net/projects/mingw/files/MinGW/zlib/zlib-1.2.3-1-mingw32.
 

	
 
   #. libz-1.dll  http://sourceforge.net/projects/mingw/files/MinGW/zlib/zlib-1.2.3-1-mingw32 (rename to zlib1.dll).
 

	
 
   #. Libxml2 XML parser ftp://ftp.zlatkovic.com/libxml or ftp://xmlsoft.org/libxml2/win32. 
 

	
 
        Or compile from source::
 

	
 
          git clone git://git.gnome.org/libxml2
 
@@ -132,42 +124,27 @@ Material
 
         #. http://www.c-plusplus.de/forum/viewtopic-var-t-is-260421.html 
 
         #. http://markmail.org/message/rlpeuruibg2ruqqv 
 

	
 

	
 
Methods
 
+++++++
 
  #. Install the aforementioned development software.
 
```````
 
#. Install the aforementioned development software. If any of these
 
   are missing, ask your system administrator to install them for
 
   you.
 

	
 
  #. The VirtualLeaf is written with the QT Cross platform application
 
     and UI framework. To compile the VirtualLeaf from source you will
 
     need to install the QT software development kit(SDK), which you
 
     can download from the `QT download site <http://qt.nokia.com/downloads/downloads>`_.
 

	
 
  #. Create a Mercurial configuration file named .hgrc in your `home
 
     directory <http://mercurial.selenic.com/wiki/WindowsInstall#Setup_environment>`_::
 

	
 
       Notepad "C:\Documents and Settings\your_name\.hgrc"
 

	
 
     Add these lines to the configuration file::
 

	
 
       [ui]
 
         editor = Notepad
 
         username = your_name <your_email_address>
 

	
 
       [merge-tools]
 
         kdiff3.priority=-1
 
         kdiff3.args=-L1 base --L2 local --L3 other $base $local $other -o $output
 
         kdiff3.regkey=Software\KDiff3
 
         kdiff3.regappend=\kdiff3.exe
 
         kdiff3.fixeol=True
 
         kdiff3.gui=True
 

	
 
  #. Make or change to the directory where you wish to install the Virtual Leaf::
 
#. Make or change to the folder where you wish to install the Virtual Leaf::
 

	
 
      > c:\Documents and Settings\michael\simulations
 

	
 
  #. Retrieve the Virtual Leaf source code from its  Google Code repository::
 
#. Retrieve the Virtual Leaf source code from its Google Code
 
   repository by typing
 
   http://virtualleaf.googlecode.com/files/VirtualLeaf-v1.0-src.zip
 
   into your browser. Unpack the archive and place its contents in
 
   the folder named in the previous step.
 

	
 
      > hg clone https://virtualleaf.googlecode.com/hg/ virtualleaf
 

	
 
  #. Compilation is effected with make. To facilitate cross platform
 
     compatibility, the makefiles use two environment variables:
 
@@ -212,12 +189,12 @@ Methods
 
     When complete, you will find the ``VirtualLeaf.exe`` binary in
 
     ``v1.0/bin`` and the plugins in ``v1.0/bin/models``.
 

	
 

	
 
MacOS
 
-----
 
------------------
 
MacOS Installation
 
------------------
 

	
 
Material
 
++++++++
 
````````
 

	
 
  Identical to the Linux installation except that instead of GNU GCC
 
  and Make, install the XCode development environment from the MacOSX
 
@@ -225,7 +202,7 @@ Material
 

	
 

	
 
Methods
 
+++++++
 
```````
 

	
 
  Identical to the Linux installation except:
 
    #. Open the Terminal program (in ``/Applications/Utilities/``) and
doc/stylesheet.json
Show inline comments
 
@@ -216,10 +216,13 @@
 
    }],
 
    ["enumerated_list" , {
 
      "parent": "bodytext",
 
      "spaceBefore": 0
 
      "spaceBefore": 0,
 
      "spaceAfter": 0
 
    }],
 
    ["enumerated_list_item" , {
 
      "parent": "bodytext"
 
      "parent": "bodytext",
 
      "spaceBefore": 0,
 
      "spaceAfter": 0
 
    }],
 
    ["definition_list_term" , {
 
      "parent": "normal",
 
@@ -265,7 +268,7 @@
 
      "parent": "heading",
 
      "fontName": "stdBold",
 
      "fontSize": "200%",
 
      "alignment": "TA_LEFT",
 
      "alignment": "TA_CENTER",
 
      "keepWithNext": false,
 
      "spaceAfter": 10
 
    }],
doc/v1.pdf
Show inline comments
 
@@ -464,7 +464,7 @@ endobj
 
% 'R31': class PDFInfo 
 
31 0 obj
 
<< /Author ()
 
 /CreationDate (D:20101015155138-01'00')
 
 /CreationDate (D:20110216100033-01'00')
 
 /Keywords ()
 
 /Producer (ReportLab http://www.reportlab.com)
 
 /Subject (\(unspecified\))
 
@@ -842,14 +842,14 @@ endobj
 
% 'R63': class PDFStream 
 
63 0 obj
 
% page stream
 
<< /Length 8892 >>
 
<< /Length 8921 >>
 
stream
 
1 0 0 1 0 0 cm BT /F1 12 Tf 14.4 TL ET
 
q
 
1 0 0 1 62.69291 729.0236 cm
 
q
 
0 0 0 rg
 
BT 1 0 0 1 0 9.64 Tm /F2 20 Tf 24 TL (The Virtual Leaf) Tj T* ET
 
BT 1 0 0 1 0 9.64 Tm /F2 20 Tf 24 TL 159.9249 0 Td (The Virtual Leaf) Tj T* -159.9249 0 Td ET
 
Q
 
Q
 
q
 
@@ -3284,26 +3284,26 @@ 0000013385 00000 n
 
0000013558 00000 n
 
0000013719 00000 n
 
0000013870 00000 n
 
0000022863 00000 n
 
0000027768 00000 n
 
0000034521 00000 n
 
0000048763 00000 n
 
0000056736 00000 n
 
0000061413 00000 n
 
0000061571 00000 n
 
0000061648 00000 n
 
0000061725 00000 n
 
0000061802 00000 n
 
0000061879 00000 n
 
0000061956 00000 n
 
0000022892 00000 n
 
0000027797 00000 n
 
0000034550 00000 n
 
0000048792 00000 n
 
0000056765 00000 n
 
0000061442 00000 n
 
0000061600 00000 n
 
0000061677 00000 n
 
0000061754 00000 n
 
0000061831 00000 n
 
0000061908 00000 n
 
0000061985 00000 n
 
trailer
 
<< /ID 
 
 % ReportLab generated PDF document -- digest (http://www.reportlab.com) 
 
 [(\216\375C\374\237e3\302\016\020\3752\364q\006\373) (\216\375C\374\237e3\302\016\020\3752\364q\006\373)] 
 
 [(\037\323\227O\300\021\334\027\205\315\374[\264\010]\323) (\037\323\227O\300\021\334\027\205\315\374[\264\010]\323)] 
 
 
 /Info 31 0 R
 
 /Root 30 0 R
 
 /Size 76 >>
 
startxref
 
62003
 
62032
 
%%EOF
0 comments (0 inline, 0 general)