summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* guix gc: Add '--list-failures' and '--clear-failures'.Ludovic Courtès2015-09-281-0/+18
| | | | | | | | | | Suggested by Mark H Weaver <mhw@netris.org>. * guix/scripts/gc.scm (show-help, %options): Add --list-failures and --clear-failures. (guix-gc): Honor them. * doc/guix.texi (Invoking guix gc): Document them. (Invoking guix-daemon): Mention them.
* doc: Fix spelling.Mark H Weaver2015-09-281-1/+1
| | | | | | This is a followup to commit ba7d6c763c6adac4cf26fef656c7f98296601d0b. * doc/guix.texi (Synopses and Descriptions): Fix spelling.
* doc: Add more recommandations for package descriptions.Mathieu Lirzin2015-09-281-4/+16
| | | | | * doc/guix.texi (Synopses and Descriptions): Warn about special characters in Texinfo. Indicate how to help the translators.
* Merge branch 'master' into core-updatesLudovic Courtès2015-09-243-2/+53
|\
| * emacs: Add 'guix-devel-build-package-definition'.Alex Kost2015-09-231-0/+24
| | | | | | | | | | | | | | | | | | | | | | | | Suggested by Ludovic Courtès <ludo@gnu.org>. * emacs/guix-guile.el (guix-guile-definition-regexp): New variable. (guix-guile-current-definition, guix-guile-boolean): New functions. * emacs/guix-devel.el: Require 'guix-base'. (guix-devel-repl-processes): New variable. (guix-devel-setup-repl, guix-devel-setup-repl-maybe): New functions. (guix-devel-build-package-definition): New command. * doc/emacs.texi (Emacs Development): Document it.
| * emacs: Add development utils.Alex Kost2015-09-233-2/+29
| | | | | | | | | | | | | | | | | | | | | | | | * emacs/guix-guile.el (guix-guile-current-module): New function. * emacs/guix-devel.el: New file. * emacs.am (ELFILES): Add it. * doc/emacs.texi (Emacs Development): New node. (Emacs Interface): Add it. * doc/contributing.texi (The Perfect Setup): Mention it. * doc/guix.texi (Top): Add it. * emacs/guix-init.el: Add 'guix-devel-activate-mode-maybe' to 'scheme-mode-hook'.
* | doc: Mention /run/current-system/locale.Ludovic Courtès2015-09-241-0/+9
|/ | | | | * doc/guix.texi (Application Setup): Add anchor and index entry. (Locales): Refer to it. Mention /run/current-system/locale.
* linux-boot: Mount /dev as a devtmpfs from the start.Ludovic Courtès2015-09-201-6/+1
| | | | | | | | | | | | | | | | | | Suggested by Petter <petter@mykolab.ch> and Mark H Weaver <mhw@netris.org>. Reported by Duncan Keall <duncan@duncankeall.com>. Partly fixes <http://bugs.gnu.org/19190> by populating /dev/mapper early enough. * gnu/build/linux-boot.scm (mount-essential-file-systems): Mount /dev as a devtmpfs. (move-essential-file-systems): Add /dev. (mount-root-file-system): Mount /rw-root/dev as a devtmpfs instead of calling 'make-essential-device-nodes'. (boot-system): Remove call to 'make-essential-device-nodes'. * gnu/system/file-systems.scm (%devtmpfs-file-system): Remove. * doc/guix.texi (File Systems): Adjust accordingly.
* emacs: Add commands to show/hide build log phases.Alex Kost2015-09-181-0/+6
| | | | | | | | | | | | | Suggested by Ludovic Courtès <ludo@gnu.org>. * emacs/guix-build-log.el (guix-build-log-phase-end-regexp): New variable. (guix-build-log-phase-start, guix-build-log-phase-end, guix-build-log-phase-hide, guix-build-log-phase-show, guix-build-log-phase-hidden-p, guix-build-log-phase-toggle-function, guix-build-log-phase-toggle, guix-build-log-phase-toggle-all): New functions. (guix-build-log-mode-map): Add 'TAB'/'S-TAB' key bindings. * doc/emacs.texi (Emacs Build Log): Document them.
* doc: Add guidelines for synopses and descriptions.Ludovic Courtès2015-09-152-0/+54
| | | | | | * doc/guix.texi (Synopses and Descriptions): New node. * doc/contributing.texi (Submitting Patches): Add item that cross-references it.
* doc: Change authorship to "The GNU Guix Developers".Ludovic Courtès2015-09-151-3/+1
| | | | | * doc/guix.texi: Replace outdated @author list with just "The GNU Guix Developers".
* emacs: Add modes for viewing build logs.Alex Kost2015-09-152-0/+32
| | | | | | | | * emacs/guix-build-log.el: New file. * emacs.am (ELFILES): Add it. * doc/emacs.texi (Emacs Build Log): Document it. New node. (Emacs Interface): Add it. * doc/guix.texi (Top): Likewise.
* guix: lint: Check for meaningful origin file names.Eric Bavier2015-09-141-1/+4
| | | | | | | | | * guix/scripts/lint.scm (check-source-file-name): New procedure. (%checkers): Add 'source-file-name' checker. * tests/lint.scm ("source-file-name", "source-file-name: v prefix") ("source-file-name: valid", "source-file-name: bad checkout") ("source-file-name: good checkout"): New tests. * doc/guix.texi (Invoking guix lint): Mention file name check.
* doc: Use the recommended Scheme format.Mathieu Lirzin2015-09-142-17/+19
| | | | | | | | | | Apply the recommended formatting rules from '.dir-locals.el' to the examples in the manual in order to fulfill it's purpose of being a reference. * doc/package-hello.scm: Indent it. * doc/guix.texi (Defining Packages, Version Numbers): Likewise. * gnu/packages/base.scm (hello): Be consistent with the manual.
* build: ruby: Add support for tarball and directory sources.David Thompson2015-09-141-6/+7
| | | | | | | | | | | | Previously, the Ruby build system only knew how to work with gem archives, which made it difficult to build unreleased gems from a Git repository or released gems in tarball form. * gnu/build/ruby-build-system.scm (gnu:unpack, gem-archive?): New procedures. (unpack): Use GNU build system unpack phase for non-gem sources. (build): Rebuild the gemspec iff the source is a gem archive. * guix.texi ("ruby-build-system"): Mention that tarballs and directories are acceptable.
* Revert "services: 'mingetty-service' no longer takes monadic values."Ludovic Courtès2015-09-131-1/+1
| | | | This reverts commit daa48c31797b27e3a0991d0db7406c951ebc86df.
* services: 'mingetty-service' no longer takes monadic values.Ludovic Courtès2015-09-131-1/+1
| | | | | | | | | | | * gnu/services/base.scm (mingetty-service): Change default value of #:motd from a monadic value to a <plain-file>. Assume MOTD to be a file-like object. Assume LOGIN-PROGRAM is a gexp or #f. (%base-services): Use 'plain-file' instead of 'text-file' for motd. * gnu/system/linux.scm (unix-pam-service): Update docstring to mention that MOTD is a file-like object. * doc/guix.texi (Base Services): Adjust 'mingetty-service' documentation accordingly.
* guix build: '--log-file' can return URLs.Ludovic Courtès2015-09-101-1/+13
| | | | | | | * guix/scripts/build.scm (%default-log-urls): New variable. (log-url): New procedure. (guix-build): Use it. * doc/guix.texi (Invoking guix build): Document it.
* graph: Add '--expression'.Ludovic Courtès2015-09-021-0/+10
| | | | | | | | * guix/scripts/graph.scm (%options, show-help): Add '--expression'. (guix-graph): Call 'read/eval-package-expression' for 'expression' pairs in OPTS. * tests/guix-graph.sh: Add tests. * doc/guix.texi (Invoking guix graph): Document it.
* doc: Document polkit and elogind services.Andy Wingo2015-09-021-0/+82
| | | | | * doc/guix.texi (Desktop Services): Add polkit-service and elogind-service documentation.
* build: Add R build system.Ricardo Wurmus2015-08-311-0/+10
| | | | | | | * guix/build-system/r.scm: New file. * guix/build/r-build-system: New file. * Makefile.am (MODULES): Add new files. * doc/guix.texi (Build Systems): Document r-build-system.
* import: Add 'cran' importer.Ricardo Wurmus2015-08-311-0/+15
| | | | | | | | | | | | * guix/import/cran.scm: New file. * guix/scripts/import.scm: Add "cran" to 'importers'. * guix/scripts/import/cran.scm: New file. * tests/cran.scm: New file. * Makefile.am (MODULES): Add 'guix/import/cran.scm' and 'guix/scripts/import/cran.scm'. (SCM_TESTS): Add 'tests/cran.scm'. * doc/guix.texi (Invoking guix import): Document it. * po/guix/POTFILES.in: Add 'guix/scripts/import/cran.scm'.
* emacs: Add popup interface for guix commands.Alex Kost2015-08-302-0/+45
| | | | | | | | | * emacs/guix-command.el: New file. * emacs.am (ELFILES): Add it. * doc/emacs.texi (Emacs Initial Setup): Mention 'magit-popup' library. (Emacs Popup Interface): New node. (Emacs Interface): Add it. * doc/guix.texi (Top): Likewise.
* doc: Reorganize "Emacs Interface" node.Alex Kost2015-08-302-35/+43
| | | | | | | | * doc/guix.texi (Package Management): Move "Emacs Interface" node to ... (Top): ...here, since it is not just about package management. * doc/emacs.texi: Shift all nodes one level up (@section -> @chapter, etc.). Rename "Emacs Usage" node into "Emacs Package Management". Move "Emacs Configuration" node here.
* doc: Mention the "normalized codeset" used in locale names.Ludovic Courtès2015-08-291-3/+11
| | | | | | | | * doc/guix.texi (Locales): Introduce "codeset". <%default-locale-definitions>: Mention the "normalized codeset", with an xref to libc's manual. * gnu/system/locale.scm (%default-locale-definitions)[utf8-locale]: Mention the "normalized codeset" in a comment.
* gexp: Add #:script-name parameter to 'gexp->derivation'.Ludovic Courtès2015-08-291-3/+5
| | | | | * guix/gexp.scm (gexp->derivation): Add #:script-name parameter. * doc/guix.texi (G-Expressions): Document it.
* gnu: services: Add nginx-service.David Thompson2015-08-271-0/+21
| | | | | | * gnu/services/web.scm: New file. * gnu-system.am (GNU_SYSTEM_MODULES): Add it. * guix.texi ("Web Services"): New section.
* import: Add Ruby gem importer.David Thompson2015-08-271-0/+19
| | | | | | | | * gnu/scripts/import.scm (importers): Add "gem". * gnu/import/gem.scm: New file. * gnu/scripts/import/gem.scm: New file. * Makefile.am (MODULES): Add them. * guix.texi ("invoking guix import"): Document it.
* Add 'guix graph'.Ludovic Courtès2015-08-273-1/+341
| | | | | | | | | | | | | | | | | * guix/scripts/graph.scm, tests/graph.scm, tests/guix-graph.sh, doc/images/coreutils-bag-graph.dot, doc/images/coreutils-graph.dot: New files. * Makefile.am (MODULES): Add guix/scripts/graph.scm. (SH_TESTS): Add tests/guix-graph.sh. (SCM_TESTS): Add tests/graph.scm. * doc.am (DOT_FILES, DOT_VECTOR_GRAPHICS): New variables. (EXTRA_DIST): Use them. (dist_infoimage_DATA): Use $(DOT_FILES). (pdf-local, info-local, ps-local): Likewise. * doc/guix.texi (Packages with Multiple Outputs): Add cross-reference to 'guix graph'. (Invoking guix gc): Likewise. (Invoking guix graph): New section.
* gexp: Add 'lower-object'.Ludovic Courtès2015-08-271-1/+17
| | | | | | | * guix/gexp.scm (lower-object): New procedure. (lower-inputs, lower-references, gexp->sexp): Use it. * tests/gexp.scm ("lower-object"): New test. * doc/guix.texi (G-Expressions): Document it.
* gnu: Add GeoClue desktop service.Andy Wingo2015-08-201-3/+39
| | | | | | | | | | | | * gnu/services/desktop.scm (bool): New top-level helper. (upower-configuration-file): Use top-level `bool'. (geoclue-application): New public function. (%standard-geoclue-applications): New public variable. (geoclue-service): New public variable. (%desktop-services): Add GeoClue. Add a comment about activation. * doc/guix.texi (Desktop Services): Document the GeoClue service. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Add missing gawk dependency to hello recipe.Siniša Biđin2015-08-201-1/+2
| | | | | | * doc/guix.texi (Defining Packages): Add gawk dependency. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* scripts: package: Add --install-from-file option.David Thompson2015-08-192-0/+34
| | | | | | | | | | * guix/scripts/package.scm (show-help): Add help text for --install-from-file option. (%options): Add --install-from-file option. * tests/guix-package.sh: Test it. * doc/guix.texi ("invoking guix package"): Document it. * doc/package-hello.scm: New file. * doc.am (EXTRA_DIST): Add it.
* lint: Add 'formatting' checker.Ludovic Courtès2015-08-191-0/+4
| | | | | | | | | | | * guix/scripts/lint.scm (report-tabulations, report-trailing-white-space, report-long-line, report-formatting-issues, check-formatting): New procedures. (%formatting-reporters): New variable. (%checkers): Add 'formatting' checker. * tests/lint.scm ("formatting: tabulation", "formatting: trailing white space", "formatting: long line", "formatting: alright"): New tests. * doc/guix.texi (Invoking guix lint): Mention the 'formatting' checker.
* build: ruby: Rewrite build system to use gem archives.David Thompson2015-08-181-0/+7
| | | | | | | | | | | | | | | | | | | | | Co-Authored-By: Pjotr Prins <pjotr.public01@thebird.nl> * guix/build-system/ruby.scm (lower): Remove git dependency. (rubygems-uri): New procedure. * guix/build/ruby-build-system (gitify): Delete. (unpack): Use 'gem unpack' utility. (check): Add docstring. (build): Repack modified gem. (install): Rebuild unpacked gem and install it. (%standard-phases): Remove gitify and build phases. * gnu/packages/ruby.scm (ruby-hoe, ruby-rake-compiler, ruby-i18n, ruby-rspec-support, ruby-rspec-core, ruby-diff-lcs-for-rspec, ruby-rspec-expectations, ruby-rspec-mocks, ruby-rspec, bundler, ruby-useragent, ruby-bacon, ruby-arel, ruby-connection-pool, ruby-net-http-persistent, ruby-minitest, ruby-minitest-sprint, ruby-minitest-bacon, ruby-daemons, ruby-git, ruby-slop, ruby-multipart-post): Convert to new build system. * doc/guix.texi (ruby-build-system): Document the gem archive requirement.
* doc: Fix minor typos.Steve Sprang2015-08-021-3/+3
| | | | | * doc/guix.texi (Invoking guix-daemon, Application Setup, The Store): Fix typos.
* doc: Make "Application Setup" more prominent.Ludovic Courtès2015-07-251-1/+2
| | | | * doc/guix.texi (Binary Installation): Add reference to "Application Setup".
* doc: Fix name of GNU FreeFont package.Ludovic Courtès2015-07-241-1/+1
| | | | | | | Fixes <http://bugs.gnu.org/21121>. Reported by Malcolm Cook <MEC@stowers.org>. * doc/guix.texi (Application Setup): Fix name of GNU FreeFont package.
* doc: Clarify that tar timestamp warnings affect tar <= 1.26.Ludovic Courtès2015-07-241-2/+4
| | | | | * doc/guix.texi (Binary Installation): Explain that warnings were triggered by tar <= 1.26.
* doc: Fix typos in "Setuid Programs".Ludovic Courtès2015-07-231-2/+2
| | | | * doc/guix.texi (Setuid Programs): Fix typos.
* doc: Suggest unpacking with --warning=no-timestamp.Ludovic Courtès2015-07-221-7/+10
| | | | | | Suggested by Malcolm Cook <MEC@stowers.org>. * doc/guix.texi (Binary Installation): Suggest --warning=no-timestamp.
* doc: Mention zeroed mtimes in the binary tarball.Ludovic Courtès2015-07-221-0/+6
| | | | | | | | Fixes <http://bugs.gnu.org/21111>. Reported by Dave Love <fx@gnu.org>. * doc/guix.texi (Binary Installation): Add paragraph about "implausibly old time stamps" warning from tar.
* size: Add '--substitute-urls' option.Ludovic Courtès2015-07-221-0/+4
| | | | | | | * guix/scripts/size.scm (show-help, %options): Add --substitute-urls. (%default-options): Add 'substitute-urls'. (guix-size): Honor it. * doc/guix.texi (Invoking guix size): Document it.
* doc: Mention initial passwords in "System Installation".Ludovic Courtès2015-07-221-3/+9
| | | | | | | | Suggested by remo_ on IRC. * doc/guix.texi (System Installation): Explicitly mention user account passwords. (User Accounts): Add 'user-account-password' anchor.
* Merge branch 'core-updates'Mark H Weaver2015-07-191-1/+1
|\
| * Merge branch 'master' into core-updatesMark H Weaver2015-07-191-3/+28
| |\
| * \ Merge branch 'master' into core-updatesMark H Weaver2015-07-151-4/+34
| |\ \
| * | | gnu: Require NEON on armhf.Mark H Weaver2015-07-111-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/packages/gcc.scm (gcc-configure-flags-for-triplet): On armhf, include --with-fpu=neon. * doc/guix.texi (GNU Distribution): Document that our armhf port requires NEON.
* | | | doc: Update the "Limitations" section.Ludovic Courtès2015-07-191-4/+5
| |_|/ |/| | | | | | | | | | | | | | * doc/guix.texi (GNU Distribution): Use the new package list URL. (Limitations): Mention Enlightenment and improve wording. Update the package count.
* | | build-system/ruby: Add #:gem-flags parameter.pjotrp2015-07-181-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | * guix/build-system/ruby.scm (build): add 'gem-flags' key * guix/build/ruby-build-system.scm (build): use 'gem-flags' key * doc/guix.texi (Build Systems): Mention #:gem-flags. Co-authored-by: Ludovic Courtès <ludo@gnu.org>