summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAge
* emacs: Add commands to show/hide build log phases.Alex Kost2015-09-18
| | | | | | | | | | | | | 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-15
| | | | | | * 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-15
| | | | | * doc/guix.texi: Replace outdated @author list with just "The GNU Guix Developers".
* emacs: Add modes for viewing build logs.Alex Kost2015-09-15
| | | | | | | | * 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-14
| | | | | | | | | * 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-14
| | | | | | | | | | 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-14
| | | | | | | | | | | | 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-13
| | | | This reverts commit daa48c31797b27e3a0991d0db7406c951ebc86df.
* services: 'mingetty-service' no longer takes monadic values.Ludovic Courtès2015-09-13
| | | | | | | | | | | * 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-10
| | | | | | | * 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-02
| | | | | | | | * 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-02
| | | | | * doc/guix.texi (Desktop Services): Add polkit-service and elogind-service documentation.
* build: Add R build system.Ricardo Wurmus2015-08-31
| | | | | | | * 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-31
| | | | | | | | | | | | * 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-30
| | | | | | | | | * 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-30
| | | | | | | | * 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-29
| | | | | | | | * 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-29
| | | | | * guix/gexp.scm (gexp->derivation): Add #:script-name parameter. * doc/guix.texi (G-Expressions): Document it.
* gnu: services: Add nginx-service.David Thompson2015-08-27
| | | | | | * 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-27
| | | | | | | | * 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-27
| | | | | | | | | | | | | | | | | * 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-27
| | | | | | | * 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-20
| | | | | | | | | | | | * 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-20
| | | | | | * 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-19
| | | | | | | | | | * 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-19
| | | | | | | | | | | * 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-18
| | | | | | | | | | | | | | | | | | | | | 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-02
| | | | | * doc/guix.texi (Invoking guix-daemon, Application Setup, The Store): Fix typos.
* doc: Make "Application Setup" more prominent.Ludovic Courtès2015-07-25
| | | | * doc/guix.texi (Binary Installation): Add reference to "Application Setup".
* doc: Fix name of GNU FreeFont package.Ludovic Courtès2015-07-24
| | | | | | | 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-24
| | | | | * doc/guix.texi (Binary Installation): Explain that warnings were triggered by tar <= 1.26.
* doc: Fix typos in "Setuid Programs".Ludovic Courtès2015-07-23
| | | | * doc/guix.texi (Setuid Programs): Fix typos.
* doc: Suggest unpacking with --warning=no-timestamp.Ludovic Courtès2015-07-22
| | | | | | 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-22
| | | | | | | | 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-22
| | | | | | | * 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-22
| | | | | | | | 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-19
|\
| * Merge branch 'master' into core-updatesMark H Weaver2015-07-19
| |\
| * \ Merge branch 'master' into core-updatesMark H Weaver2015-07-15
| |\ \
| * | | gnu: Require NEON on armhf.Mark H Weaver2015-07-11
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * 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-19
| |_|/ |/| | | | | | | | | | | | | | * 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-18
| | | | | | | | | | | | | | | | | | | | | | | | * 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>
* | | file-systems: Add a 'dependencies' field to <file-system>.Ludovic Courtès2015-07-17
| | | | | | | | | | | | | | | | | | | | | * gnu/system/file-systems.scm (<file-system>)[dependencies]: New field. * gnu/system.scm (other-file-system-services)[requirements]: Honor 'file-system-dependencies'. * doc/guix.texi (File Systems): Document it.
* | | system: Add 'kernel-arguments' field.Ludovic Courtès2015-07-17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * gnu/system.scm (<operating-system>)[kernel-arguments]: New field. (operating-system-grub.cfg): Honor it. (operating-system-parameters-file): Add 'kernel-arguments' to the parameters file. * guix/scripts/system.scm (previous-grub-entries)[system->grub-entry]: Read the 'kernel-arguments' field of the parameters file, when available. * gnu/system/vm.scm (system-qemu-image/shared-store-script): Use (operating-system-kernel-arguments os) in '-append'. * doc/guix.texi (operating-system Reference): Document it.
* | | Add 'guix-daemon.service' file for systemd.Ludovic Courtès2015-07-15
| | | | | | | | | | | | | | | | | | | | | | | | | | | * etc/guix-daemon.service.in: New file, provided by Ricardo Wurmus. * daemon.am (CLEANFILES): Add etc/guix-daemon.service. (systemdservicedir, nodist_systemdservice_DATA): New variables. (EXTRA_DIST): Add etc/guix-daemon.service.in. * doc/guix.texi (Binary Installation, Build Environment Setup): Mention 'guix-daemon.service'.
* | | doc: Reinstate bit about creating build accounts.Ludovic Courtès2015-07-15
| |/ |/| | | | | | | * doc/guix.texi (Binary Installation): Reinstate bit about creating group and user accounts, which was inadvertently removed in 01dbc7e0.
* | file-systems: Allow users to specify file system UUIDs as strings.Ludovic Courtès2015-07-14
| | | | | | | | | | | | | | | | | | | | | | | | Fixes <http://bugs.gnu.org/19778>. Reported by Mark H Weaver <mhw@netris.org>. * gnu/system/file-systems.scm (%uuid-rx): New variable. (string->uuid): New procedure. (uuid): New macro. * tests/file-systems.scm: New file. * Makefile.am (SCM_TESTS): Add it. * doc/guix.texi (File Systems): Give an example of UUID.
* | guix build: Add '--substitute-urls' client option.Ludovic Courtès2015-07-13
|/ | | | | | | | | | | * guix/scripts/build.scm (%standard-build-options, show-build-options-help): Add --substitute-urls=URLS. (set-build-options-from-command-line): Honor it. * guix/store.scm (%default-substitute-urls): Make public. * doc/guix.texi (Substitutes): Add xref to the client --substitute-urls option. (Invoking guix build): Document it. (Invoking guix-daemon): Add 'daemon-substitute-urls' anchor.
* doc: Augment offloading documentation.Ludovic Courtès2015-07-09
| | | | | | * doc/guix.texi (Daemon Offload Setup): Mention that we're using lsh. Mention GUILE_LOAD_PATH settings on the target machine. Explain that machines must authorize each other.
* doc: Remove extra quotes around URLs.Ludovic Courtès2015-07-08
| | | | * doc/guix.texi (Invoking guix import): Remove extraneous quotes around URLs.