From a7a9f37561b45d2d2900b4c419ac3b9f0c7f2d75 Mon Sep 17 00:00:00 2001 From: Dan McGee Date: Tue, 5 Feb 2008 18:23:18 -0600 Subject: 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 --- doc/makepkg.8.txt | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) (limited to 'doc') 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. -- cgit v1.2.3-24-g4f1b