summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* guix gc: Add `--requisites'.Ludovic Courtès2013-06-131-0/+7
| | | | | | | * guix/scripts/gc.scm (show-help, %options): Add `--requisites'. (guix-gc): Handle it. * doc/guix.texi (Invoking guix gc): Document `--requisites'. * NEWS: Update.
* doc: Write about patch submission and packaging guidelines.Ludovic Courtès2013-06-041-1/+14
| | | | | | * HACKING: Update the command names from `guix-build' to `guix build' & co. (Submitting Patches, Packaging Guidelines): New sections. * doc/guix.texi (Contributing): New section.
* build, package: Add `--fallback' option.Ludovic Courtès2013-05-291-0/+8
| | | | | | | | | * guix/scripts/build.scm (%options, show-help): Add `--fallback'. (guix-build): Call `set-build-options' with #:fallback?. * guix/scripts/package.scm (%options, show-help): Add `--fallback'. (guix-package): Call `set-build-options' with #:fallback?. * doc/guix.texi (Invoking guix package, Invoking guix build): Document `--fallback'.
* doc: Improve wording and fix typos in "Introduction" and "Requirements".Nikita Karetnikov2013-05-261-19/+19
| | | | * doc/guix.texi (Introduction, Requirements): Rephrase and fix typos.
* build: Add `--target' option.Ludovic Courtès2013-05-241-0/+6
| | | | | | | | | | * guix/scripts/build.scm (derivations-from-package-expressions): Add `package-derivation' parameter. (show-help, %options): Add `--target'. (guix-build): Use `package-cross-derivation' when `--target' is passed. * tests/guix-build.sh: Add dry-run test with `--target'. * doc/guix.texi (Invoking guix build): Document `--target'.
* packages: Implement `package-cross-derivation'.Ludovic Courtès2013-05-241-0/+17
| | | | | | | | | | | * guix/packages.scm (package-transitive-target-inputs, package-transitive-native-inputs): New procedures. (package-derivation): Parametrize `%current-target-system'. (package-cross-derivation): Implement. * guix/utils.scm (%current-target-system): New variable. * tests/packages.scm ("package-cross-derivation"): New test. * doc/guix.texi (Defining Packages): Document `package-cross-derivation'.
* Add `--max-silent-time' to `guix build' and `guix package'.Ludovic Courtès2013-05-201-1/+6
| | | | | | | | | | | | | | | | * guix/scripts/build.scm (%default-options): Add default `max-silent-time' value. (show-help, %options): Add `--max-silent-time'. (guix-build): Pass `max-silent-time' to `set-build-options'. * guix/scripts/package.scm (%default-options): Add default `max-silent-time' value. (show-help, %options): Add `--max-silent-time'. (guix-package): Pass `max-silent-time' to `set-build-options'. * guix/ui.scm (string->number*): New procedure. * tests/derivations.scm ("build-expression->derivation and max-silent-time"): New test. * doc/guix.texi (Invoking guix package, Invoking guix build): Document `--max-silent-time'.
* package: Make sure the profile directory is owned by the user.Ludovic Courtès2013-05-161-1/+2
| | | | | | | * guix/scripts/package.scm (guix-package)[ensure-default-profile]: Check the owner of %PROFILE-DIRECTORY. Report an error when the owner is not the current user. Add `rtfm' procedure. * doc/guix.texi (Invoking guix package): Mention the ownership test.
* doc: Document "guix download".Ludovic Courtès2013-05-111-4/+41
| | | | | | * doc/guix.texi (Defining Packages): Linke to "Invoking guix download". (Utilities): Add an overview paragraph. (Invoking guix download): New node.
* refresh: Add `--key-server' and `--gpg'.Ludovic Courtès2013-05-111-0/+13
| | | | | | | | * guix/scripts/refresh.scm (%options): Add `--key-server' and `--gpg'. (show-help): Update accordingly. (update-package): New procedure, formerly in `guix-refresh'. (guix-refresh): Use it. Parameterize `%openpgp-key-server' and `%gpg-command'.
* doc: Document `guix refresh'.Ludovic Courtès2013-05-081-3/+75
| | | | | | * doc/guix.texi (Defining Packages): Add cross-reference to "Invoking guix refresh". (Invoking guix refresh): New node.
* guix package: Add `--search-paths' & co.Ludovic Courtès2013-04-281-1/+21
| | | | | | | | | * guix/scripts/package.scm (search-path-environment-variables, display-search-paths): New procedures. (show-help, %options): Add `--search-paths'. (guix-package)[process-actions]: Call `display-search-paths' once the profile is ready. [process-query]: Honor `search-paths'.
* Add 'guix hash'.Nikita Karetnikov2013-04-211-2/+35
| | | | | | | | | * guix/scripts/hash.scm: New file. * Makefile.am (MODULES): Add it. * po/POTFILES.in: Add it. * doc/guix.texi (Invoking guix hash): New node. (Defining Packages): Add a cross-reference to the 'Invoking guix hash' node.
* daemon: Add `--no-substitutes'.Ludovic Courtès2013-04-181-0/+4
| | | | | | | | | | Suggested by Mark H. Weaver. * nix/nix-daemon/guix-daemon.cc (GUIX_OPT_NO_SUBSTITUTES): New macro. (options): Add `--no-substitutes'. (parse_opt): Add `GUIX_OPT_NO_SUBSTITUTES' case. (main): Leave `settings.substituters' empty when `settings.useSubstitutes' is false.
* doc: Mention the home page.Ludovic Courtès2013-04-181-2/+4
| | | | | * doc/guix.texi (Installation): Add a sentence pointing to the home page. Suggested by Arne Babenhauserheide.
* doc: Transparent binary deployment is implemented.Ludovic Courtès2013-04-171-4/+1
| | | | | * doc/guix.texi (Features): Remove footnote saying that transparent binary deployment is not implemented.
* package: allow users to upgrade the whole system by not providing a regexp.Cyril Roelandt2013-04-161-3/+4
| | | | | | * guix/scripts/packages.scm (guix-package) [process-actions]: When upgrading, use "" when REGEXP is #f. * doc/guix.texi: update the documentation accordingly.
* guix package: Add `--no-substitutes'.Ludovic Courtès2013-04-121-0/+3
| | | | | | * guix/scripts/package.scm (%default-options): Add `substitutes?'. (show-help, %options): Add and document `--no-substitutes'. (guix-package): Call `set-build-options' to honor `substitutes?'.
* guix package: Inform about new upstream versions of GNU packages.Ludovic Courtès2013-03-051-0/+6
| | | | | | | | * guix/gnu-maintenance.scm (gnu-package?): New procedure. * guix/scripts/package.scm (waiting): New macro. (check-package-freshness): New procedure. (guix-package)[process-actions]: Use it. * doc/guix.texi (Invoking guix package): Mention the feature.
* guix package: Add `--install-from-expression'.Ludovic Courtès2013-03-011-0/+13
| | | | | | | | | | | | * guix/scripts/package.scm (read/eval-package-expression): New procedure. (show-help): Add `-e'. (%options): Likewise. (guix-package)[process-actions]: Handle ('install . p) pairs, where P is a package. * tests/guix-package.sh: Add `boot_make_drv'. Use `-i $boot_make_drv' once, and then use `-e $boot_make'. * doc/guix.texi (Invoking guix package): Document `-e'.
* guix gc: Add `--references' and `--referrers'.Ludovic Courtès2013-02-271-0/+12
| | | | | | | | | | * guix/scripts/gc.scm (show-help): Update. (%options): Add `--references' and `--referrers'. (guix-gc)[symlink-target, store-directory]: New procedures. Handle the `list-references' and `list-referrers' actions. * tests/guix-gc.sh: Add tests for `--references'. * doc/guix.texi (Invoking guix gc): Document `--references' and `--referrers'.
* Add "guix pull".Ludovic Courtès2013-02-201-0/+33
| | | | | | | | | | | * guix/scripts/pull.scm: New file. * Makefile.am (MODULES): Add it. * doc/guix.texi (Invoking guix pull): New node. (Invoking guix package): Add cross-ref to it. * guix/ui.scm (config-directory): New procedure. * scripts/guix.in: When `GUIX_UNINSTALLED' is undefined, add $XDG_CONFIG_HOME/guix/latest to the search path. * po/POTFILES.in: Add guix/scripts/pull.scm.
* build: Adjust guix.texi to Texinfo 5.0.Ludovic Courtès2013-02-201-2/+2
| | | | * doc/guix.texi: Change @title and @subtitle syntax to please Texinfo 5.0.
* daemon: Add `--listen'.Ludovic Courtès2013-02-191-0/+7
| | | | | | | * nix/nix-daemon/guix-daemon.cc (GUIX_OPT_LISTEN): New macro. (options): Add `--listen'. (parse_opt): Handle it. * doc/guix.texi (Invoking guix-daemon): Mention it.
* Replace individual scripts with master 'guix' script.Mark H Weaver2013-02-161-41/+41
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * scripts/guix.in: New script. * Makefile.am (bin_SCRIPTS): Add 'scripts/guix'. Remove 'guix-build', 'guix-download', 'guix-import', 'guix-package', and 'guix-gc'. (MODULES): Add 'guix/scripts/build.scm', 'guix/scripts/download.scm', 'guix/scripts/import.scm', 'guix/scripts/package.scm', and 'guix/scripts/gc.scm'. * configure.ac (AC_CONFIG_FILES): Add 'scripts/guix'. Remove 'guix-build', 'guix-download', 'guix-import', 'guix-package', and 'guix-gc'. * guix-build.in, guix-download.in, guix-gc.in, guix-import.in, guix-package.in: Remove shell script boilerplate. Move to guix-COMMAND.in to guix/scripts/COMMAND.scm. Rename module from (guix-COMMAND) to (guix scripts COMMAND). Change "guix-COMMAND" to "guix COMMAND" in usage help string. * pre-inst-env.in: Add "@abs_top_builddir@/scripts" to the front of $PATH. Export $GUIX_UNINSTALLED. * tests/guix-build.sh, tests/guix-daemon.sh, tests/guix-download.sh, tests/guix-gc.sh, tests/guix-package.sh: Use "guix COMMAND" instead of "guix-COMMAND". * doc/guix.texi: Replace all occurrences of "guix-COMMAND" with "guix COMMAND". * po/POTFILES.in: Update.
* Build newest versions unless specified, and implement upgrades.Mark H Weaver2013-02-131-3/+4
| | | | | | | | | | | | | | | | | | | | | | | * gnu/packages.scm (find-newest-available-packages): New exported procedure. * guix-build.in (newest-available-packages, find-best-packages-by-name): New procedures. (find-package): Use find-best-packages-by-name, to guarantee that if a version number is not specified, only the newest versions will be considered. * guix-package.in (%options): Add --upgrade/-u option. (newest-available-packages, find-best-packages-by-name, upgradeable?): New procedures. (find-package): Use find-best-packages-by-name, to guarantee that if a version number is not specified, only the newest versions will be considered. (process-actions): Implement upgrade option. * doc/guix.texi (Invoking guix-package): In the description of --install, mention that if no version number is specified, the newest available version will be selected.
* doc: Document installation of propagated inputs.Ludovic Courtès2013-02-071-0/+10
| | | | | * doc/guix.texi (Invoking guix-package): Document installation behavior with propagated inputs.
* guix-package: Report `--search' matches in recutils format.Ludovic Courtès2013-02-011-3/+14
| | | | | | | | | | | | * guix/ui.scm (fill-paragraph, string->recutils, package->recutils): New procedures. * guix-package.in (guix-package)[process-query]: Use `package->recutils' to display package meta-data. * tests/guix-package.sh: Adjust test. * tests/ui.scm: New file. * Makefile.am (TESTS): Add it. * doc/guix.texi (Invoking guix-package): Adjust `--search' documentation, and give an example.
* guix-package: Add '--search'.Nikita Karetnikov2013-01-281-0/+9
| | | | | | | | * guix-package.in (find-packages-by-description): New procedure. (show-help, %options): Add '--search'. (guix-package)[process-query]: Add support for '--search'. * doc/guix.texi (Invoking guix-package): Document it. * tests/guix-package.sh: Add tests.
* guix-package: Always use the next number for new generations.Ludovic Courtès2013-01-271-0/+4
| | | | | | | | | | | | | | | | Suggested by Andreas Enge <andreas@enge.fr> at <http://lists.gnu.org/archive/html/bug-guix/2013-01/msg00325.html>. * guix-package.in (latest-profile-number): Remove. (switch-symlinks): New procedure. (roll-back)[switch-link]: Use it. (guix-package)[process-actions]: Always choose NUMBER + 1 for the new profile. Use `switch-symlinks' instead of `symlink'. Remove code to delete PROFILE when it exists since `switch-symlinks' has the same effect. * tests/guix-package.sh: Adjust existing `--roll-back' tests. * doc/guix.texi (Invoking guix-package): Document this `--roll-back' behavior.
* guix-package: When rolling back to nothingness, point to the empty profile.Ludovic Courtès2013-01-271-0/+5
| | | | | | | | | | | | Suggested by Andreas Enge <andreas@enge.fr> at <http://lists.gnu.org/archive/html/bug-guix/2013-01/msg00316.html>. * guix-package.in (roll-back): Check whether PROFILE is valid using `file-exists?'. When NUMBER is zero, just emit a notice. When PREVIOUS-NUMBER is zero and PREVIOUS-PROFILE does not exist, build the empty profile, and link to it. * tests/guix-package.sh: Add tests. * doc/guix.texi (Invoking guix-package): Document the new behavior.
* doc: Clarify that `guix-build' really is for developers.Ludovic Courtès2013-01-231-3/+7
| | | | | | * doc/guix.texi (Invoking guix-build): Make it clear that `guix-build' doesn't access the user's profile, and add cross-ref to `guix-package'. Suggested by Nikita Karetnikov <nikita@karetnikov.org>.
* doc: Improve wording and fix typos in "Features".Ludovic Courtès2013-01-231-10/+11
| | | | | * doc/guix.texi (Features): Fix typos, and rephrase according to the suggestions of Alex Sassmannshausen <alex.sassmannshausen@gmail.com>.
* guix-build: Allow version-qualified package names.Ludovic Courtès2013-01-221-3/+4
| | | | | | | | | * guix-build.in (guix-build)[find-package]: New procedure. Use it instead of using `find-packages-by-name' directly. Suggested by Andreas Enge <andreas@enge.fr>. * tests/guix-build.sh: Add tests. * doc/guix.texi (Invoking guix-build): Add `coreutils-8.20' as an example. Fix guile-1.8 example.
* packages: Have `package-derivation' return a <derivation> as a second value.Ludovic Courtès2013-01-201-3/+2
| | | | | | | | | * guix/packages.scm (cache): Change the `drv' argument to `thunk'. Memoize all the return values of THUNK. (cached-derivation): Remove. (cached): New macro. (package-derivation): Use `cached' instead of `(or (cached-derivation) …)'. * doc/guix.texi (Defining Packages): Update accordingly.
* doc: Run `useradd -g guix-builder -G guix-builder'.Ludovic Courtès2013-01-201-1/+4
| | | | | | * doc/guix.texi (Setting Up the Daemon): Add `-G guix-builder' when invoking `useradd'. Suggested by Aleix Conchillo Flaqué <aconchillo@gmail.com>.
* doc: Add a "GNU Distribution" node.Ludovic Courtès2013-01-181-4/+51
| | | | | | | | * doc/guix.texi (Introduction): Add cross-reference to "GNU Distribution". (Features): Mention reproducibility. (Invoking guix-package): Add cross-reference to "GNU Distribution". (GNU Distribution): New node.
* doc: Mark binary deployment as not implemented yet.Ludovic Courtès2013-01-181-1/+4
| | | | | * doc/guix.texi (Features): Add a footnote saying that binary deployment is missing.
* guix-package: Add `--roll-back'.Ludovic Courtès2013-01-171-0/+7
| | | | | | | | | | | | | | | | | | Based on a patch by Nikita Karetnikov <nikita@karetnikov.org>. * guix-package.in (profile-regexp): New procedure. (latest-profile-number): Remove `%profile-rx', and use `profile-regexp' instead. (profile-number, roll-back): New procedure. (show-help): Add `--roll-back'. (%options): Likewise. (guix-package)[process-actions]: First check whether `roll-back?' is among OPTS, and call `roll-back' if it is, followed by a recursive call to `process-actions'. Emit the "nothing to be done" message only when INSTALL or REMOVE is non-empty. * tests/guix-package.sh (readlink_base): New function. Add tests for `--roll-back'. * doc/guix.texi (Invoking guix-package): Document `--roll-back'.
* doc: Start documenting derivations.Ludovic Courtès2013-01-161-2/+137
| | | | | | | * doc/guix.texi (Defining Packages): Add cross-reference to "Derivations". (The Store): Add `build-derivations'. (Derivations): Populate.
* doc: Fix typos, and improve daemon documentation.Ludovic Courtès2013-01-161-3/+13
| | | | | | | * doc/guix.texi: Fix typos. (Invoking guix-daemon): Add details about `--disable-log-compression' and `--disable-store-optimization'. Reported by Nikita Karetnikov <nikita@karetnikov.org>.
* doc: Remove @documentlanguage.Ludovic Courtès2013-01-161-1/+0
| | | | * doc/guix.texi: Remove @documentlanguage, which confuses TeX.
* doc: Start documenting (guix store).Ludovic Courtès2013-01-151-4/+55
| | | | | | * doc/guix.texi (The Store): Populate. (Introduction): Add cross-reference. Change "package store" to "the store".
* guix-package: Create or diagnose missing profile directory.Ludovic Courtès2013-01-141-1/+13
| | | | | | | | | | | Reported by Andreas Enge. * guix-package.in (%profile-directory): Honor $NIX_STATE_DIR. (guix-package)[ensure-default-profile]: Use it. [process-actions]: Call it when the `profile' option is %CURRENT-PROFILE. * tests/guix-package.sh: Add installation test with $HOME set, using the default profile.
* doc: Fix typos.Ludovic Courtès2013-01-131-2/+2
| | | | | | * doc/guix.texi (Setting Up the Daemon): Use "useradd -c" for comments. Reported by Andreas Enge. (Invoking guix-gc): Fix typo.
* doc: Mention store sharing with Nix; update `package' example.Ludovic Courtès2013-01-111-1/+21
| | | | | | | | * doc/guix.texi: Set @documentlanguage. (Installation): Add reference to `INSTALL' and `README'. (Requirements): Mention store sharing with Nix. (Defining Packages): Update example to include `use-modules' clauses and to use (guix licenses).
* Merge branch 'core-updates'Ludovic Courtès2013-01-111-1/+1
|\ | | | | | | | | Conflicts: guix/build/union.scm
| * distro: libsigsegv: Use a single output.Ludovic Courtès2013-01-101-1/+1
| | | | | | | | | | | | * distro/packages/libsigsegv.scm (libsigsegv): Use just a single output, otherwise nothing ends up in `out' as a consequence of commit a06a99f. Reported by Andreas Enge <andreas@enge.fr>.
* | doc: Clarify package version specification example.Ludovic Courtès2013-01-091-1/+1
| | | | | | | | | | * doc/guix.texi (Invoking guix-package): Use "guile-1.8.8" as the example, not "guile-1.8" since there is no such version.
* | guix-package: Create ~/.guix-profile when it doesn't exist.Ludovic Courtès2013-01-091-0/+6
| | | | | | | | | | | | * guix-package.in (guix-package): Create the %USER-ENVIRONMENT-DIRECTORY symlink if it doesn't exist yet. * doc/guix.texi (Invoking guix-package): Document it.