Permalink
Browse files

Prepare for v0.1.4

Signed-off-by: Pang Yan Han <pangyanhan@gmail.com>
  • Loading branch information...
1 parent 2560ad9 commit 1ca213586c63f9476f73447b7144d5661210e3db @yanhan committed Jun 9, 2011
Showing with 46 additions and 28 deletions.
  1. +5 −0 NEWS
  2. +4 −14 README.md
  3. +14 −8 TECHNICAL
  4. +23 −6 powaur.1.txt
View
5 NEWS
@@ -1,5 +1,10 @@
VERSION DESCRIPTION
--------------------------------------------------------------------------------
+0.1.4 - -Su added to check for outdated AUR packages
+ - --crawl operation to give valid topological order for packages
+ - Dependency resolution for -S
+ - Provides resolution for -G --deps
+ - --check option for -Su
0.1.3.1 - Handle '<' in PKGBUILDS
0.1.3 - Colorized output is now available!
0.1.2.1 - Update helptext to include --threads
View
@@ -6,10 +6,12 @@ a yaourt / pacman esque interface to the AUR.
Currently, powaur supports:
+- Installing packages from the AUR with dependency resolution (v0.1.4)
+- Checking for outdated AUR packages and updating them (v0.1.4)
+- Showing a valid topological order for packages (v0.1.4)
- Multithreaded downloading of packages from the AUR with dependency resolution
- Searching for packages on the AUR
- Querying local and sync databases for package information
-- Installing packages from the AUR (no dependency resolution)
- Backing up your pacman local database
- Colorized output (new in v0.1.3)
@@ -39,18 +41,6 @@ Inspiration for powaur has come from:
- git
-THE -S FLAG
------------
-
-Currently, the `-S` flag does not do any dependency resolution when it comes
-to installing packages. What it does is:
-
-- Downloads the tarball packages from the AUR
-- Unzips them in `/tmp/powaur`
-- Asks the user to edit the PKGBUILD
-- Invokes `makepkg -s` to install the package
-
-
A NOTE ABOUT THE AUR
--------------------
@@ -76,7 +66,7 @@ Some source code in powaur comes from the following projects:
BUG REPORTS
-----------
-Please email bug reports to powaurdev@gmail.com .
+Please email bug reports to pangyanhan@gmail.com .
AUTHOR
View
@@ -110,17 +110,23 @@ In the case that not all settings are specified in the config file, powaur
wll fall back to defaults for those unspecified settings.
----------------------------------
-DEPENDENCY RESOLUTION for -G flag
----------------------------------
+---------------------
+DEPENDENCY RESOLUTION
+---------------------
-The -G flag supports a limited form of dependency resolution. It DOES NOT
-recognize version strings, ie. to say if you have something like:
+powaur offers a form of partial dependency resolution. Why do I say partial?
+Because we do not take into account of:
-pacman>=3.5
+1. Version strings
+2. Conflicts
-inside a PKGBUILD, powaur recognizes the "pacman" part and discards the version
-string.
+Currently, dependency resolution works by
+1. Checking immediate dependencies
+2. "Normalize" dependencies, ie. to say, find it in a local/sync database OR
+ provides, then finally the AUR
+3. For any dependencies from the AUR, goto step 1
+A dependency graph is built and topologically sorted and checked for cyclic
+dependencies. The operation will abort when cyclic dependencies are detected.
That's all for now. Thanks for reading!
View
@@ -1,4 +1,4 @@
-.TH POWAUR 1 "31-05-2011" "powaur" "powaur manual"
+.TH POWAUR 1 "10-06-2011" "powaur" "powaur manual"
.SH NAME
powaur \- an AUR helper with a pacman-like interface
.SH SYNOPSIS
@@ -27,19 +27,28 @@ packages are provided, all installed packages will be queried.
.B "-S, --sync"
Synchronize packages. When used with no options, at least one target is
required and powaur will attempt to install the target package(s) from the AUR.
-There is no dependency resolution.
+Dependency resolution is now available.
.IP
Note that the use of this flag to install AUR packages is discouraged.
You are adviced to use the -G flag to download PKGBUILDS and review them
before installing them using makepkg.
.TP
+.B "-B, --backup"
+Backup the local pacman database. See Backup Usage.
+.TP
+.B "--crawl <package(s)>"
+Shows a valid topological order for the given package(s). The package(s) can
+be from local or sync databases or the AUR. For installed AUR packages, a fresh
+copy of the PKGBUILD will be downloaded and dependency resolution is based on
+the PKGBUILD instead of information in the local database.
+.IP
+NOTE: This option only shows a single valid topological order (there may be
+many other valid topological orders) for the packages.
+.TP
.B "-M, --maintainer <person>"
Search the AUR for packages maintained by person. 1 and only 1 maintainer must
be specified.
.TP
-.B "-B, --backup"
-Backup the local pacman database. See Backup Usage.
-.TP
.B "-h, --help"
Displays help message and exits.
.TP
@@ -93,6 +102,10 @@ Searches installed packages for the specified package(s). If no packages were
specified, then all installed packages will be listed.
.SH SYNC OPTIONS
.TP
+.B "--check"
+Only meaningful when used with -u. Will stop -Su before package upgrading. Use
+this flag to check for outdated AUR packages without upgrading them.
+.TP
.B "-i, --info"
Searches sync databases, followed by AUR for package information. If no
packages were specified, then information on all packages from all sync
@@ -102,6 +115,10 @@ databases is displayed.
Searches the AUR for a specified package. Currently, there is only support for
searching for 1 package.
.TP
+.B "-u, --upgrade"
+Checks all locally installed AUR packages and updates any outdated AUR packages,
+with all relevant dependencies resolved.
+.TP
.B "--vote"
.br
Used with -s. Orders search results from the AUR by vote count instead of
@@ -146,6 +163,6 @@ Dave Reisner - For his kind permission to let powaur use code from cower
pacman, git - Source code was used from both of these projects, especially
pacman
.SH BUG REPORTS
-Please email bug reports to <powaurdev@gmail.com>
+Please email bug reports to <pangyanhan@gmail.com>
.SH AUTHOR
Pang Yan Han <pangyanhan@gmail.com>

0 comments on commit 1ca2135

Please sign in to comment.