[pacman-dev] CVS update of pacman-lib (TODO.dan doc/PKGBUILD.5 doc/makepkg.conf.5)

[dan at archlinux.org]

    Date: Friday, February 9, 2007 @ 10:37:20
  Author: dan
    Path: /home/cvs-pacman/pacman-lib

Modified: TODO.dan (1.6 -> 1.7) doc/PKGBUILD.5 (1.5 -> 1.6)
          doc/makepkg.conf.5 (1.1 -> 1.2)

Man pages, man pages, man pages. Just a few more additions and clarifications,
ensured force option was still documented in PKGBUILD.5.


--------------------+
 TODO.dan           |    7 +++++++
 doc/PKGBUILD.5     |   34 ++++++++++++++++++++++++++++------
 doc/makepkg.conf.5 |   16 ++++++++--------
 3 files changed, 43 insertions(+), 14 deletions(-)


Index: pacman-lib/TODO.dan
diff -u pacman-lib/TODO.dan:1.6 pacman-lib/TODO.dan:1.7
--- pacman-lib/TODO.dan:1.6	Thu Feb  8 00:24:17 2007
+++ pacman-lib/TODO.dan	Fri Feb  9 10:37:20 2007
@@ -93,3 +93,10 @@
   --failed integ checks
   --failed build
   --etc.
+
+Add utility function to either frontend or backend to convert sizes: e.g. bytes
+to KB, MB, GB.
+
+Revamp the downloadprog function a bit. Seems kind of messy.
+
+Add localized pkgdesc variables to makepkg.
Index: pacman-lib/doc/PKGBUILD.5
diff -u pacman-lib/doc/PKGBUILD.5:1.5 pacman-lib/doc/PKGBUILD.5:1.6
--- pacman-lib/doc/PKGBUILD.5:1.5	Fri Feb  9 01:08:31 2007
+++ pacman-lib/doc/PKGBUILD.5	Fri Feb  9 10:37:20 2007
@@ -144,12 +144,34 @@
 
 .TP
 .B options \fI(array)\fP
-This array allows you to override some of \fBmakepkg\fP's default behavior
-when building packages. To set an option, just include the option name
-in the \fBoptions\fP array.
-See
-.BR makepkg (8)
-for details on the options array.
+This array allows you to override some of \fBmakepkg\fP's default behavior when
+building packages. To set an option, just include the option name in the
+\fBoptions\fP array. To reverse the default behavior, place an "!" at the front
+of the option. Only specify the options you specifically want to override, the
+rest will be taken from \fBmakepkg.conf\fP. NOTE: 'force' is a special option
+only used in \fB\*(PB\fPs, do not use it unless you know what you are doing.
+.RS
+.TP
+.B strip
+Strip symbols from binaries and libraries. If you frequently use a debugger on
+programs or libraries, it may be helpful to disable this option.
+.TP
+.B docs
+Save doc and info directories. If you wish to delete doc and info directories,
+specify "!docs" in the array.
+.TP
+.B libtool
+Leave libtool (.la) files in packages. Specify "!libtool" to remove them.
+.TP
+.B emptydirs
+Leave empty directories in packages.
+.TP
+.B force
+Force the package to be upgraded by a \fBpacman\fP system upgrade operation,
+even if the version number would normally not trigger such an upgrade. This is
+useful when the version numbering scheme of a package changes (or is
+alphanumeric).
+.RE
 
 .SH INSTALL/UPGRADE/REMOVE SCRIPTING
 \fBPacman\fP has the ability to store and execute a package-specific script
Index: pacman-lib/doc/makepkg.conf.5
diff -u pacman-lib/doc/makepkg.conf.5:1.1 pacman-lib/doc/makepkg.conf.5:1.2
--- pacman-lib/doc/makepkg.conf.5:1.1	Thu Feb  8 22:44:54 2007
+++ pacman-lib/doc/makepkg.conf.5	Fri Feb  9 10:37:20 2007
@@ -55,17 +55,17 @@
 option. Each works as follows:
 .RS
 .TP
-fakeroot
+.B fakeroot
 Allow building packages as a non-root user. This is \fIhighly\fP recommended.
 .TP
-distcc
+.B distcc
 Use the distributed C/C++/ObjC compiler to spread compilation among multiple
 machines. If this is enabled, \fBDISTCC_HOSTS\fP must be specified as well.
 .TP
-color
+.B color
 Colorize output messages, making output easier to read.
 .TP
-ccache
+.B ccache
 Use ccache to cache compilation by default. This allows for faster compiles if
 you are continuously recompiling the same packages. It can be disabled for
 individual packages by passing the \fB-B\fP or \fB--noccache\fP flag to
@@ -85,18 +85,18 @@
 Each works as follows:
 .RS
 .TP
-strip
+.B strip
 Strip symbols from binaries and libraries. If you frequently use a debugger on
 programs or libraries, it may be helpful to disable this option.
 .TP
-docs
+.B docs
 Save doc and info directories. If you wish to delete doc and info directories,
 specify "!docs" in the array.
 .TP
-libtool
+.B libtool
 Leave libtool (.la) files in packages. Specify "!libtool" to remove them.
 .TP
-emptydirs
+.B emptydirs
 Leave empty directories in packages.
 .RE
 .TP