From 4e0b649c3af6deeb6fcf765deaa3dc9b2f68452d Mon Sep 17 00:00:00 2001 From: Dan McGee Date: Fri, 9 Feb 2007 15:37:20 +0000 Subject: 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(-) diff --git a/TODO.dan b/TODO.dan index eecb6ad1..a56917df 100644 --- a/TODO.dan +++ b/TODO.dan @@ -93,3 +93,10 @@ Refine makepkg error codes. Each kind of failure could have its own code: --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. diff --git a/doc/PKGBUILD.5 b/doc/PKGBUILD.5 index 8e07e4e1..00ee8f7b 100644 --- a/doc/PKGBUILD.5 +++ b/doc/PKGBUILD.5 @@ -144,12 +144,34 @@ though the package has moved. .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 diff --git a/doc/makepkg.conf.5 b/doc/makepkg.conf.5 index f5714c21..3c6a2980 100644 --- a/doc/makepkg.conf.5 +++ b/doc/makepkg.conf.5 @@ -55,17 +55,17 @@ enable or disable an option simply remove or place an "!" at the front of the 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 @@ disable an option simply remove or place an "!" at the front of the option. 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 -- cgit v1.2.3-70-g09d2