summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDan McGee <dan@archlinux.org>2008-02-05 18:23:18 -0600
committerDan McGee <dan@archlinux.org>2008-02-05 18:23:18 -0600
commita7a9f37561b45d2d2900b4c419ac3b9f0c7f2d75 (patch)
tree75e5e987a532a4eb7422a17229ea731e8ce3b4cb /doc
parent7069b96173aa256d1c2eaed2d21811639e10e566 (diff)
downloadpacman-a7a9f37561b45d2d2900b4c419ac3b9f0c7f2d75.tar.xz
doc/makepkg: document --log, address locale issues
Looks like no one ever documented -L/--log, so do that now. In addition, address some of the issues brought up in FS#9156 and add a note about build output and logs being in the current locale. Signed-off-by: Dan McGee <dan@archlinux.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/makepkg.8.txt14
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/makepkg.8.txt b/doc/makepkg.8.txt
index f3f5d7c9..59108f1b 100644
--- a/doc/makepkg.8.txt
+++ b/doc/makepkg.8.txt
@@ -28,6 +28,11 @@ build the package, install the package into a temporary root, make
customizations, generate meta-info, and package the whole thing up for pacman
to use.
+NOTE: makepkg uses your current locale by default and does not unset it when
+building packages. If you wish to share your build output with others when
+seeking help or for other purposes, you may wish to run "`LC_ALL=C makepkg`" so
+your logs and output are not localized.
+
Options
-------
*\--asroot*::
@@ -83,7 +88,7 @@ Options
if required and generate integrity checks. The integrity checks
generated are determined by the value of the INTEGRITY_CHECK array in
linkman:makepkg.conf[5]. This output can be redirected into your
- PKGBUILD for source validation (`makepkg -g >> PKGBUILD`).
+ PKGBUILD for source validation using "`makepkg -g >> PKGBUILD`".
*-h, \--help*::
Output syntax and command line options.
@@ -97,6 +102,13 @@ Options
Install or upgrade the package after a successful build using
linkman:pacman[8].
+*-L, \--log*::
+ Enable makepkg build logging. This will use the *tee* program to send
+ output of the `build()` function to both the console and to a text file in
+ the build directory named `pkgname-pkgver-pkgrel-arch.log`. As mentioned
+ above, the build log will be localized so you may want to set your locale
+ accordingly if sharing the log output with others.
+
*-m, \--nocolor*::
Disable color in output messages.