OSGeo4W Packaging - Revision history

Warmerdam: migrated.

2008-06-03T16:07:21Z

migrated.

Show changes

Warmerdam: /* Creating Shortcuts */ add an example of a postinstall desktop icon creation.

2008-04-26T19:47:11Z

Creating Shortcuts: add an example of a postinstall desktop icon creation.

Warmerdam: /* Post-Install Actions */

2008-04-13T00:23:49Z

Post-Install Actions

Jmckenna: /* Post-Install Actions */

2008-03-24T17:18:50Z

Post-Install Actions

Jmckenna: /* Post-Install Actions */ minor

2008-03-24T17:17:20Z

Post-Install Actions: minor

Jmckenna: /* Post-Install Actions */ minor

2008-03-24T17:15:44Z

Post-Install Actions: minor

Jmckenna: /* Post-Install Actions */ add textreplace example without use of tmpl files

2008-03-24T17:08:37Z

Post-Install Actions: add textreplace example without use of tmpl files

Wiki-Assefa: /* Post-Install Actions */

2008-03-18T22:40:04Z

Post-Install Actions

Wiki-Assefa: /* Post-Install Actions */

2008-03-18T16:14:37Z

Post-Install Actions

Warmerdam: /* Installed Directory Layout */ added /src directory.

2008-03-15T23:56:20Z

Installed Directory Layout: added /src directory.

@@ Line 136: / Line 136: @@
 = Creating Shortcuts =
-Another postinstall task that packages might do is to create shortcuts that will be available to launch a certain command. As its is the case for the textreplace executable, there is an utility binary xxmklink.exe that is available in the installer (part of the msvcrt package). By typing xxmklink, you can see all the options supported by this utility. Here are some examples on how it can be used in a post install file::
+Another postinstall task that packages might do is to create shortcuts that will be available to launch a certain command. As its is the case for the textreplace executable, there is an utility binary xxmklink.exe that is available in the installer (part of the msvcrt package). By typing xxmklink, you can see all the options supported by this utility. Here are some examples on how it can be used in a post install file:
    mkdir "%ALLUSERSPROFILE%\start menu\Programs\OSGeo4W"
    mkdir "%ALLUSERSPROFILE%\start menu\Programs\OSGeo4W\Apache"
-   xxmklink "%ALLUSERSPROFILE%\start menu\Programs\OSGeo4W\Apache\OSGEO4W-Apache-Install.lnk" \
+   xxmklink "%ALLUSERSPROFILE%\start menu\Programs\OSGeo4W\Apache\OSGEO4W-Apache-Install.lnk"
      %OSGEO4W_ROOT%\Apache\bin\httpd.exe " -k install -n \"Apache OSGEO4W Web Server\""
-  Using icons:
+Using icons:
-   xxmklink "%ALLUSERSPROFILE%\start menu\Programs\OSGeo4W\ttt.lnk" cmd.exe "" . "my_desc" 1 \
+   xxmklink "%ALLUSERSPROFILE%\start menu\Programs\OSGeo4W\ttt.lnk" cmd.exe "" . "my_desc" 1
      "%OSGEO4W_ROOT%\OSGeo4W.ico"
 The postinstall scripts can run any DOS command or installed binary with desired arguments.

@@ Line 134: / Line 134: @@
 This applies the "standard" conversions to file bin/gdal-config.tmpl and puts the results in bin/gdal-config
-''Creating Shortcuts''
+= Creating Shortcuts =
 Another postinstall task that packages might do is to create shortcuts that will be available to launch a certain command. As its is the case for the textreplace executable, there is an utility binary xxmklink.exe that is available in the installer (part of the msvcrt package). By typing xxmklink, you can see all the options supported by this utility. Here are some examples on how it can be used in a post install file::

@@ Line 95: / Line 95: @@
 One very common thing to do in postinstall actions is to insert/update configuration files to include the installed path to the OSGeo4W tree.  This is normally done with a postinstall file, and here are 2 examples::
-''Example #1''
+''TextReplace Example #1''
 * hardcoded paths exist in the /httpd.d/httpd_gmap.conf file of the gmap package:
@@ Line 122: / Line 122: @@
-''Example #2''
+''TextReplace Example #2''
    textreplace -sf bin/gdal-config.tmpl -df bin/gdal-config \
@@ Line 134: / Line 134: @@
 This applies the "standard" conversions to file bin/gdal-config.tmpl and puts the results in bin/gdal-config
+''Creating Shortcuts''
 Another postinstall task that packages might do is to create shortcuts that will be available to launch a certain command. As its is the case for the textreplace executable, there is an utility binary xxmklink.exe that is available in the installer (part of the msvcrt package). By typing xxmklink, you can see all the options supported by this utility. Here are some examples on how it can be used in a post install file::

@@ Line 117: / Line 117: @@
    </Directory>
-* the second step is to create a postinstall script (that lives at /etc/postinstall/gmap.bat of the gmap package) to replace that variable with the actual user's install path:
+* the second step is to create a postinstall script named gmap.bat (that lives at /etc/postinstall/ of the gmap package) to replace that variable with the actual user's install path:
    textreplace -sf httpd.d/httpd_gmap.conf -df httpd.d/httpd_gmap.conf -map @osgeo4w@ %OSGEO4W_ROOT%

@@ Line 128: / Line 128: @@
      -map @osgeo4w_msys@ "%OSGEO4W_ROOT_MSYS%"
-This runs the bin/textreplace program (part of the msvcrt package) with source file bin/gdal-config.tmpl and destination file bin/gdal-config and replaces occurances of @osgeo4w@ with the value of the OSGEO4W_ROOT environment variable, and @osgeo4w_msys@ with the value of the OSGEO4W_ROOT_MSYS environment variable.  The pattern of processing a file from a .tmpl version is sufficiently common that textreplace supports this short form for the same action:
+Both examples use the bin/textreplace program (part of the msvcrt package).  The second example uses it with source file bin/gdal-config.tmpl and destination file bin/gdal-config and replaces occurances of @osgeo4w@ with the value of the OSGEO4W_ROOT environment variable, and @osgeo4w_msys@ with the value of the OSGEO4W_ROOT_MSYS environment variable.  The pattern of processing a file from a .tmpl version is sufficiently common that textreplace supports this short form for the same action:
   textreplace -std -t bin/gdal-config

@@ Line 91: / Line 91: @@
 = Post-Install Actions =
-Packages may take post-install actions by including a .bat file in the /etc/postinstall directory as part of the package.  The filename should be named etc/postinstall/<package>.bat.  The bat file will be run with the environment variables OSGEO4W_HOME and OSGEO4W_HOME_MSYS defined, and with OSGEO4W_HOME/bin already in the path.  One very common thing to do in postinstall actions is to insert/update configuration files to include the installed path to the OSGeo4W tree.  This is normally done with a postinstall file that looks like::
+Packages may take post-install actions by including a .bat file in the /etc/postinstall directory as part of the package.  The filename should be named etc/postinstall/<package>.bat.  The bat file will be run with the environment variables OSGEO4W_HOME and OSGEO4W_HOME_MSYS defined, and with OSGEO4W_HOME/bin already in the path.
    textreplace -sf bin/gdal-config.tmpl -df bin/gdal-config \
@@ Line 102: / Line 133: @@
 This applies the "standard" conversions to file bin/gdal-config.tmpl and puts the results in bin/gdal-config
 Another postinstall task that packages might do is to create shortcuts that will be available to launch a certain command. As its is the case for the textreplace executable, there is an utility binary xxmklink.exe that is available in the installer (part of the msvcrt package). By typing xxmklink, you can see all the options supported by this utility. Here are some examples on how it can be used in a post install file::

@@ Line 103: / Line 103: @@
 This applies the "standard" conversions to file bin/gdal-config.tmpl and puts the results in bin/gdal-config
-The postinstall scripts can run any DOS command or installed binary with desired arguments.
+Another postinstall task that packages might do is to create shortcuts that will be available to launch a certain command. As its is the case for the textreplace executable, there is an utility binary xxmklink.exe that is available in the installer (part of the msvcrt package). Here are some examples on how this utility can be used in a post install file::
 = Shell Initialization =

@@ Line 18: / Line 18: @@
 * /lib: static and stub libraries required for building additional packages and executables.
 * /share: static support data files.
 * /tmp - directory to store temporary files (non-web-accessible)
 * /tmp/ms_tmp/ directory to store temporary web-accessible files