Changes between Version 7 and Version 8 of doc/install/advanced

Timestamp:

Sep 5, 2018 11:10:35 AM (7 years ago)

Author:

raasch

Comment:

--

doc/install/advanced

@@ -16 +16 @@
   ~/palm/current_version/JOBS
 }}}
-The names of these directories can be freely selected (except {{{~/job_queue}}}), however new users should choose them as suggested, since many examples in this documentation as well as all example files are based on these settings. The directory {{{~/palm/current_version}}} on the local host will be called the working directory from now on.\\\\
-In the '''second step''' a working copy of the recent PALM version, including the source code, scripts, documentation, etc.  must be copied to the working directory (local host!) by executing the following commands. Replace {{{<your username>}}} by the name that you have chosen to access the repository, and {{{<#>}}} by any of the available PALM releases, e.g. "''3.7a''" (new releases will be announced to members of the PALM mailing list).
+The names of these directories can be freely selected by adjusting the [wiki:doc/app/palm_config configuration file], however new users should choose them as suggested, since many examples in this documentation as well as all example files are based on these settings. The directory {{{~/palm/current_version}}} on the local host will be called the working directory from now on.\\\\
+
+In the '''second step''' a working copy of the recent PALM revision, including the source code, scripts, helper routines, etc.  must be copied to the working directory by entering the following commands. Replace {{{<your username>}}} by the name that you have chosen in the [https://palm.muk.uni-hannover.de/trac/register register form].
 {{{
   cd ~/palm/current_version
+  svn checkout --username <your username> https://palm.muk.uni-hannover.de/svn/palm/trunk trunk
+}}}
+You will then be prompted for your password that you have set in the register form too. After completion, a subdirectory {{{trunk}}} should appear in your working directory. It contains a number of further subfolders, which contain e.g. the PALM source code ({{{SOURCE}}}) and the scripts for running PALM ({{{SCRIPTS}}}). '''Please never touch any file in your working copy of PALM, unless you know what you are doing.''' In case of any problems with the {{{svn checkout}}} command, the most probable reason are firewall settings on your system. Please check or ask your system administrator, if https-ports are open. \\\\
+
+The above {{{svn checkout}}} command provides you the most recent revision (developer version) of PALM. In case that you like to use a fixed release, please enter
+{{{
   svn checkout --username <your username> https://palm.muk.uni-hannover.de/svn/palm/tags/release-<#> trunk
 }}}
-You will then be prompted for your password. After completion, there should be a subdirectory {{{trunk}}} in your working directory. It contains a number of further subdirectories, which contain e.g. the PALM source code ({{{SOURCE}}}) and the scripts for running PALM ({{{SCRIPTS}}}).\\\\
-Alternatively, executing
-{{{
-  svn checkout --username <your username> https://palm.muk.uni-hannover.de/svn/palm/tags/release-<#> abcde
-}}}
-will place your working copy in a directory named {{{abcde}}} (instead of a directory named {{{trunk}}}). But keep in mind that you will have to adjust several paths given below, if you do not use the default directory {{{trunk}}}.\\\\
-Please never touch any file in your working copy of PALM, unless you know what you are doing.\\\\
-You can also get a copy of the most recent developer code by executing
-{{{
-  svn checkout --username <your username> https://palm.muk.uni-hannover.de/svn/palm/trunk trunk
-}}}
-This version may contain new features (they might not be documented well), but it may also contain bugs.\\\\
-
+where {{{<#>}}} can be any of the available PALM releases, e.g. "''5.0''". See the [wiki:doc/tec/releasenotes release notes] for a list of available releases. New releases will be announced via the PALM mailing list.