Changes between Version 6 and Version 7 of pkg-apt

Timestamp:

10/08/09 15:00:09 (15 years ago)

Author:

maphew

Comment:

update docs, announce current release

pkg-apt

@@ -1 +1 @@
 = apt =
 
- * OSGeo4W command line Installer/Updater/Remover
+ * '''OSGeo4W command line Installer/Updater/Remover'''
  * Installs ''osgeo4w''\bin\apt.py which can be launched from the OSGeo4W shell.
- * Built from the source code at http://svn.osgeo.org/osgeo4w/trunk/apt
+ * Source code at http://trac.osgeo.org/osgeo4w/browser/trunk/apt
  * Maintained by MattWilkie
 
-''This program is still in Alpha stage. The primary functions (install, upgrade, remove) seem to work well enough but it's  not recommended for production use. There *are* bugs.''
+Current package version is v0.0-2. It can  be found under Commandline Utilities in the setup.exe installer.
 
-The package lags behind svn quite a bit right now, so please use [http://trac.osgeo.org/osgeo4w/browser/trunk/apt svn apt.py] when possible.
-
-Interim documentation: http://code.google.com/p/maphew/wiki/AptGetLike
-
-Not in the package but related is a 
-[http://code.google.com/p/maphew/downloads/list standalone apt.exe] which doesn't require an installed python and can be used to install OSGeo4W on a virgin system:
-
-Minimal o4w skeleton:
+First time use, from within OSGeo4W shell:
 {{{
-SET OSGEO4W_ROOT=C:\Osgeo4W
 apt setup
-apt update
 apt install msvcrt
 }}}
+After that:
+{{{
+apt update        (fetch up-to-date setup.ini)
+apt install gdal  (install package "gdal")
+apt new           (show possible upgrades)
+apt list          (show installed packages)
+apt available     (show installation candidates)
+apt remove xxx    (uninstall package xxx)
+}}}
 
-A skeleton install is not so useful, so after the above run `apt install gdal`, and perhaps `apt available` to see what other package choices there are.
+For a completely virgin system see
+[http://code.google.com/p/maphew/wiki/OsgeoFromScratch Osgeo From Scratch] which doesn't require an installed python or o4w shell.
+
+Changes since v0-0.1:
+
+    * much better package removal (though still misses .tmpl files in ./bin and start menu shortcuts, #109)
+    * new command "apt available" shows packages which could be installed (previously one had to know the name already, #111)
+    * download percentage counter no longer reports >100% recieved
+
+Apt.py and setup.exe use the same install database and procedures (though not code). One can switch between them at will depending on the needs of the moment. Configure setup.exe's cache directory to `C:\Osgeo4W\var\cache\setup` to avoid duplicating downloads. I would of course expect problems were both to run at the same time.
+
+I've been using apt.py without significant issues for over a year, nevertheless I still consider this alpha software. This is my first real  software development project and I've no training whatsoever. The only reason it works at all is because the original author, Jan Nieuwenhuizen, knew what he was doing when he wrote cyg-apt for cygwin.
+
+The biggest functional problem is that uninstall is not yet comprehensive. There is little error trapping and not enough feedback on commands. For example "apt remove" just silently exits back to the shell prompt when it should respond with a usage message ("apt remove [package_name]"), at the least. (#53)
+
+Feedback is welcome, especially on programming advice! Please use the o4w trac for logging bugs.
+
+Enjoy!