Patch title: Release 87 bulk changes
Abstract:
File: /pliant/welcome/install_step_by_step.page
Key:
    Removed line
    Added line
module "/pliant/language/context.pli"
module "/pliant/fullpliant/this_computer.pli"

title "Step by step installation"

var Str os := options option "os" Str
if os=""
  [Select the operating system you are using in the ]
  link "installation" "install"
  [ page.]
  return
eif os="win32"
  var Str archive := "pliant-"+string:pliant_release_number+".zip"
else
  var Str archive := "pliant-"+string:pliant_release_number+".tgz"

var Str temp := options option "temp" Str
if temp=""
  if os="win32"
    temp := "\temp"
  else
    temp := "/tmp"


[We currently assume that are using a ] ; text os ; [ based system]
[ and will download the Pliant archive file in the] ; fixed (text " "+temp+" ") ; [directory.] ; eol
[If you plan to download it elsewhere, please specify the directory where you want to download it, then press 'update' button.] ; eol
[I will download] ; fixed (text " "+archive+" ")
input " in " temp noeol
button "update"
page button "update"
  if os="win32" and (temp 0 1)<>"\"
    [You must specify an absolute path, such as]
    fixed (text " \"+temp+" ")
    [, not]
    fixed (text " "+temp+" ")
    [!]
  eif os<>"win32" and (temp 0 1)<>"/"
    [You must specify an absolute path, such as]
    fixed (text " /"+temp+" ")
    [, not]
    fixed (text " "+temp+" ")
    [!]
  else
    if (temp temp:len-1)="/" or (temp temp:len-1)="\"
      temp := temp 0 temp:len-1
    options := "os "+string:os+" temp "+string:temp
    execute_dynamic_page http_request:url_path
    execute_dynamic_page http_request:path


header "step 1: downloading Pliant archive file"
 
  [Download] ; fixed [ ] ; link archive "/archive/"+archive ; fixed [ ] ; [archive file in] ; fixed (text " "+temp+" ") ; [directory.]


header "step 2: installing Pliant tree"

  if os="win32"
  
    para
      [If you haven't installed the unzip utility for Win32 yet, please see instructions on ] ; link "Infozip" "http://www.cdrom.com/pub/infozip/" ; [ site.]

    [Open a DOS prompt window, then type in:] ; eol
    fixed 
      [cd \] ; eol
      text "unzip "+temp+"\"+archive ; eol
    [This will install Pliant in the] ; fixed [ \pliant ] ; [directory.]

    para
      [It is possible to install Pliant on any unit (C: D: etc) because Pliant loader will try all of them.]

  else

    [Get a shell, then type in:] ; eol
    fixed 
      [cd /] ; eol
      text "tar -zxv -P -f "+temp+"/"+archive ; eol
    [This will install Pliant in the] ; fixed [ /pliant/ ] ; [directory.]

    para
      italic [Question: ] ; [I dont what to install Pliant in ] ; fixed [/pliant/] ; [ directory because it's not possible on my Unix system. Can I install it somewhere else ?] ; eol
      italic [Answer: ] ; [Yes, it should. More details available ]
      note "here"
        title "Where to install Pliant tree"
        [Under Unix, there are three possible locations for Pliant:]
        table columns 1
          cell
            italic [${HOME}] ; fixed [/pliant/]
          cell
            fixed [/pliant/]
          cell
            fixed [/usr/local/pliant/]
        [If you plan to install Pliant on an alternative location, you are expected to be an experimented Unix user, so I will not explain here how the 'tar' command described in the installation page should be updated.] ; eol
        [Anyway, provided you choose one of the three valid locations, it should be transparent for your Pliant applications because Pliant has it's own file system tree at application level.]


header "step 3: compiling Pliant binaries"

  if os="win32"

    [Ready to use binaries are included in the] ; fixed (text " "+archive+" ") ; [file, so you have nothing to do at this step. Lucky you :-)]

  eif os="linux"

    [Ready to use binaries are included in the] ; fixed (text " "+archive+" ") ; [file, so you have nothing to do at this step. Lucky you :-)]
    para
      [Now, if you want to compile Pliant yourself anyway, then just type in:] ; eol
      fixed
        [/pliant/pliant/install/make-linux-i386] ; eol

  else  

    [Type in:] ; eol
    fixed
      [/pliant/pliant/install/make-posix-i386-gcc] ; eol
    [It should build Pliant binaries in] ; fixed [ /pliant/binary/ ] ; [ directory.]


header "step 4: running Pliant installation script"

  text "type in:" ; eol
  fixed
    if os="win32"
      [\pliant\pliant\install\install ] ; eol
    else
      [/pliant/pliant/install/install ] ; eol
  [This will precompile the Pliant default extensive environment (PDEE) in] ; fixed [ /pliant/binary/ ] ; [directory.]
  note " (more details)"
    title "Pliant installation script"
    para
      [Pliant is a dynamic compiler: it compiles the application on the fly each each time you launch it. ]
      [The advantage is that you can run Pliant applications directly from the source code, but the draw back is that it may take a long time at startup in order to compile all of a huge application, so there is the possibility to precompile. ]
      [Precompiling means starting Pliant, then compiling a set of source files, then writing the process memory image on the disk so that next time, instead of starting from the beginning, we can load the memory image (it's really fast) then start from the point we reached when we wrote that memory image. ]
      [In other words, precompiling is just like if you had the ability to stop the process, and restart it any time later.]
    para
      if os="win32"
        [The second operation performed by Pliant installation script is to copy a Pliant executable in your windows executables directory.]
      else
        [The second operation performed by Pliant installation script is to create a symbolic link from] ; fixed [ /bin/pliant ] ; [to one of the Pliant loader executables.]