aboutsummaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* derivations: 'derivation' and related procedures return a single value.Ludovic Courtès2013-09-18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * guix/derivations.scm (derivation->output-path, derivation->output-paths): New procedures. (derivation-path->output-path): Use 'derivation->output-path'. (derivation-path->output-paths): Use 'derivation->output-paths'. (derivation): Accept 'derivation?' objects as inputs. Return a single value. (build-derivations): New procedure. (compiled-modules): Use 'derivation->output-paths'. (build-expression->derivation)[source-path]: Add case for when the input matches 'derivation?'. [prologue]: Accept 'derivation?' objects in INPUTS. [mod-dir, go-dir]: Use 'derivation->output-path'. * guix/download.scm (url-fetch): Adjust to the single-value return. * guix/packages.scm (package-output): Use 'derivation->output-path'. * guix/scripts/build.scm (guix-build): When the argument is 'derivation-path?', pass it through 'read-derivation'. Use 'derivation-file-name' to print out the .drv file names, and to register them. Use 'derivation->output-path' instead of 'derivation-path->output-path'. * guix/scripts/package.scm (roll-back): Adjust to the single-value return. (guix-package): Use 'derivation->output-path'. * guix/ui.scm (show-what-to-build): Adjust to deal with 'derivation?' objects instead of .drv file names. * gnu/system/grub.scm (grub-configuration-file): Use 'derivation->output-path' instead of 'derivation-path->output-path'. * gnu/system/vm.scm (qemu-image, system-qemu-image): Likewise. * tests/builders.scm, tests/derivations.scm, tests/packages.scm, tests/store.scm, tests/union.scm: Adjust to the new calling convention. * doc/guix.texi (Defining Packages, The Store, Derivations): Adjust accordingly.
* store: The 'references' parameter of 'add-text-to-store' is now optional.Ludovic Courtès2013-09-11
| | | | | | | * guix/store.scm (add-text-to-store): Make 'references' optional. * tests/store.scm ("dead-paths", "references"): Use 'add-text-to-store' with no optional argument. * doc/guix.texi (The Store): Adjust accordingly.
* doc: Stylistic changes to "Packaging Guidelines"Andreas Enge2013-08-31
|
* doc: Remove an extra space after @ref.Nikita Karetnikov2013-08-30
|
* doc: Add duplicate copyright notice again.Andreas Enge2013-08-29
| | | | | | * doc/guix.texi: Add second copyright notice again inside @ifinfo, needed since the first one does not appear in the info output. Partially undoes commit da7cabd.
* doc: Fix the image size in PDF/PS/DVI output.Ludovic Courtès2013-08-29
| | | | | | * doc/guix.texi (Bootstrapping): Specify an image width for the TeX output. Before that, the image would be much wider than the US Letter page width.
* build: Build docs from the top-level Makefile.Ludovic Courtès2013-08-29
| | | | | | | | | | | This undoes commit 575ed8d ("doc: Create own Makefile.am in subdirectory."), and fixes a bug whereby "make pdf" or "make ps" wouldn't do anything. * doc/Makefile.am: Remove. * doc.am: New file. Use `-local' rules to build the image. * Makefile.am: Include it. * configure.ac: Use `-Woverride' to avoid undesired overridding of Automake rules.
* doc: Add package guidelines for names and numbers.Andreas Enge2013-08-28
| | | | * doc/guix.texi: Three new subsections.
* doc: Shuffle some text around.Andreas Enge2013-08-28
| | | | | * doc/guix.texi: Drop duplicate copyright notice, start section "Packaging Guidelines" with existant text.
* doc: Create own Makefile.am in subdirectory.Andreas Enge2013-08-28
| | | | | * doc/Makefile.am: New file. * Makefile.am: Reference subdirectory doc.
* derivations: Rename #:dependency-graphs to #:references-graphs.Ludovic Courtès2013-08-28
| | | | | | | * guix/derivations.scm (derivation, build-expression->derivation): Rename #:dependency-graphs to #:references-graphs, for consistency in the terminology. * tests/derivations.scm: Adjust accordingly.
* derivations: Add #:dependency-graphs to `build-expression->derivation'.Ludovic Courtès2013-08-26
| | | | | | | | | * guix/derivations.scm (build-expression->derivation): Add #:dependency-graphs keyword argument. Pass it to `derivation'. * tests/derivations.scm ("build-expression->derivation with #:dependency-graphs"): New test. * doc/guix.texi (Derivations): Update `build-expression->derivation' description.
* derivations: Add #:dependency-graphs `derivation' parameter.Ludovic Courtès2013-08-26
| | | | | | | | | | | * guix/derivations.scm (derivation): Add `dependency-graphs' keyword parameter; honor it. * tests/derivations.scm (bootstrap-binary): New procedure. (%bash): Use it. (%mkdir): New variable. (directory-contents): Add `slurp' optional parameter. ("derivation with #:dependency-graphs"): New test. * doc/guix.texi (Derivations): Update accordingly.
* derivations: Move 3 positional parameters into keyword parameters.Ludovic Courtès2013-08-26
| | | | | | | | | * guix/derivations.scm (derivation): Turn `system', `env-vars', and `inputs' into keyword parameters. (build-expression->derivation): Adjust accordingly. * gnu/packages/bootstrap.scm (%bootstrap-guile): Likewise. * tests/derivations.scm, tests/store.scm: Likewise. * doc/guix.texi (Derivations): Likewise.
* doc: Mention what's in the chroot, and add a caveat about /dev/shm.Ludovic Courtès2013-08-24
| | | | | * doc/guix.texi (Setting Up the Daemon): Document the default content of the chroot, and the /dev/shm caveat.
* doc: Add "Adding New Packages".Ludovic Courtès2013-07-17
| | | | | | | | * doc/guix.texi (Adding New Packages): New section. (Packaging Guidelines): Make a subsection thereof. (From the Source Tarball to the Package): New subsection. (Contributing): Link to "Adding New Packages". (Package Modules): Link to modules in Guile's manual.
* doc: Mark 2.0.5 as being the minimum Guile version.Ludovic Courtès2013-07-17
| | | | | * doc/guix.texi (Requirements): Require Guile 2.0.5+. * README: Ditto.
* doc: Refer to guix-devel@gnu.org.Ludovic Courtès2013-07-16
| | | | * doc/guix.texi (Contributing): Refer to guix-devel@gnu.org.
* doc: Add "Installing Debugging Files".Ludovic Courtès2013-07-09
| | | | | * doc/guix.texi (Installing Debugging Files): New node. (Packages with Multiple Outputs): Add cross-reference.
* doc: Add "Packages with Multiple Outputs" section.Ludovic Courtès2013-07-08
| | | | | * doc/guix.texi (Packages with Multiple Outputs): New node. (Invoking guix package): Refer to it.
* doc: Move the packaging guidelines to the manual.Ludovic Courtès2013-07-07
| | | | | * HACKING (Packaging Guidelines): Remove. * doc/guix.texi (Packaging Guidelines): New node.
* doc: Add a "Porting" section.Ludovic Courtès2013-07-07
| | | | | | * HACKING (Porting the Guix distro on a new platform): Remove. * doc/guix.texi (Porting): New node. Describe cross-compilation as the only approach.
* doc: Add a "Boostrapping" section.Ludovic Courtès2013-07-07
| | | | | | | | | | | | * doc/guix.texi (Package Modules): New node, with material formerly under "GNU Distribution". (Bootstrapping): New node. * Makefile.am (EXTRA_DIST): Add doc/images/bootstrap-graph.dot and doc/images/bootstrap-graph.eps. (infoimagedir, dist_infoimage_DATA, DOT_OPTIONS): New variable. (.dot.png, .dot.eps, doc/guix.pdf, doc/guix.info, doc/guix.ps): New targets. * doc/images/bootstrap-graph.dot: New file.
* guix gc: Add `--requisites'.Ludovic Courtès2013-06-13
| | | | | | | * 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-04
| | | | | | * 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-29
| | | | | | | | | * 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-26
| | | | * doc/guix.texi (Introduction, Requirements): Rephrase and fix typos.
* build: Add `--target' option.Ludovic Courtès2013-05-24
| | | | | | | | | | * 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-24
| | | | | | | | | | | * 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-20
| | | | | | | | | | | | | | | | * 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-16
| | | | | | | * 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-11
| | | | | | * 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-11
| | | | | | | | * 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-08
| | | | | | * 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-28
| | | | | | | | | * 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-21
| | | | | | | | | * 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-18
| | | | | | | | | | 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-18
| | | | | * 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-17
| | | | | * 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-16
| | | | | | * 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-12
| | | | | | * 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-05
| | | | | | | | * 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-01
| | | | | | | | | | | | * 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-27
| | | | | | | | | | * 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-20
| | | | | | | | | | | * 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-20
| | | | * doc/guix.texi: Change @title and @subtitle syntax to please Texinfo 5.0.
* daemon: Add `--listen'.Ludovic Courtès2013-02-19
| | | | | | | * 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-16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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-13
| | | | | | | | | | | | | | | | | | | | | | | * 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-07
| | | | | * doc/guix.texi (Invoking guix-package): Document installation behavior with propagated inputs.