summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* 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.
* | guix-package: Show package outputs in `--list-available'.Ludovic Courtès2013-01-091-1/+3
| | | | | | | | | | | | * guix-package.in (guix-package)[process-query]: For `list-available', show the outputs of each package. * doc/guix.texi (Invoking guix-package): Update accordingly.
* | doc: Update copyright years; add visible copyright statement.Ludovic Courtès2013-01-091-2/+14
| | | | | | | | | | | | * doc/guix.texi (YEARS): New variable. Use it for all copyright statements. (Top): Add a copyright statement and license header here.
* | doc: Documentation installation and the daemon.Ludovic Courtès2013-01-091-0/+207
|/ | | | * doc/guix.texi (Installation): New node.
* Add `guix-gc'.Ludovic Courtès2013-01-061-4/+53
| | | | | | | | | | * guix-gc.in, tests/guix-gc.sh: New files. * configure.ac: Output `guix-gc', and make it executable. * Makefile.am (bin_SCRIPTS): Add `guix-gc'. (TESTS): Add `tests/guix-gc.sh'. * doc/guix.texi (Features): Add xref to "Invoking guix-gc". (Invoking guix-gc): New node. * po/POTFILES.in: Add `guix-gc.in'.
* guix-build: Add `--verbosity'.Ludovic Courtès2012-12-151-0/+6
| | | | | | | | * guix-build.in (%default-options): Add `verbosity'. (%options): Add `--verbosity'. (guix-build): Pass it to `set-build-options'. (show-help): Update accordingly. * doc/guix.texi (Invoking guix-build): Document `--verbosity'.
* guix-package: Add `--verbose'; silence the environment's build by default.Ludovic Courtès2012-12-121-0/+4
| | | | | | | * guix-package.in (%options): Add `--verbose'. (show-help): Update accordingly. (guix-package): Parameterize `current-build-output-port' according to VERBOSE?. By default, silence the environment build's output.
* doc: Fix typos.Ludovic Courtès2012-12-121-8/+8
| | | | * doc/guix.texi: Fix typos. Reported by Andreas Enge <andreas@enge.fr>.
* doc: Correct short name of `--install' option of `guix-package'.Ludovic Courtès2012-12-091-1/+1
| | | | | * doc/guix.texi (Invoking guix-package): Fix short form of `--install'. Reported by Andreas Enge <andreas@enge.fr>.
* doc: Mention the pronunciation of "Guix".Ludovic Courtès2012-11-251-6/+8
| | | | | * README: Mention pronunciation of "Guix". * doc/guix.texi (Introduction): Likewise.
* doc: Document basic package definitions.Ludovic Courtès2012-11-211-1/+149
| | | | | * doc/guix.texi (Programming Interface): Add introduction. (Defining Packages): Populate.
* guix-package: Add `--list-available'.Ludovic Courtès2012-11-191-0/+9
| | | | | | | | | | * guix-package.in (show-help, %options): Add `--list-available'. (guix-package)[process-query]: Add support for `--list-available'. * doc/guix.texi (Invoking guix-package): Document it. * tests/guix-package.sh: Add test. * guix/ui.scm (location->string): New procedure. * guix/utils.scm: Export <location>.
* guix-package: Add `--list-installed'.Ludovic Courtès2012-11-191-0/+18
| | | | | | | | | * guix-package.in (show-help, %options): Add `--list-installed'. (guix-package): Move main body to... [process-actions]: ... here. New internal procedure. [process-query]: New procedure. * tests/guix-package.sh: Add tests for `--list-installed'. * doc/guix.texi (Invoking guix-package): Document it.
* Turn Guix into "GNU Guix".Ludovic Courtès2012-11-181-13/+14
| | | | | | | | * configure.ac: Change package name to "GNU Guix", and bug-report address to `gnu-system-discuss@gnu.org'. * doc/guix.texi: Replace "Guix" by "GNU Guix" in some places. (Top, Introduction): Mention "for the GNU system". * HACKING, README: Use "GNU Guix" instead of "Guix" in some places.
* doc: Document the features and `guix-package'.Ludovic Courtès2012-11-071-2/+132
| | | | | | * doc/guix.texi: Change the category to "Package management". Add an @direntry for "Invoking guix-package". (Package Management): New chapter.
* doc: Document `guix-build'.Ludovic Courtès2012-11-071-0/+80
| | | | * doc/guix.texi (Invoking guix-build): Populate.
* doc: Remove unnecessary @ifinfo.Ludovic Courtès2012-11-071-2/+0
| | | | | * doc/guix.texi: Remove @ifinfo around @dir{category,entry}. Suggested by Karl Berry <karl@freefriends.org>.
* doc: Add the stub of a manual.Ludovic Courtès2012-10-132-0/+690
* doc/guix.texi: New file. * doc/fdl-1.3.texi: New file, copied from Gnulib. * Makefile.am (info_TEXINFOS): New variable. (EXTRA_DIST): Add `doc/fdl-1.3.texi'.