summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* doc: Add "Installing GuixSD in a VM" node.Vincent Legoll2016-08-021-1/+54
| | | | | | | | * doc/guix.texi (Installing GuixSD in a VM): New node. (USB Stick Installation): Refer to it. (System Installation): Mention "GuixSD". Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* gnu-maintenance: Add KDE updater.David Craven2016-08-021-0/+2
| | | | | | | | * guix/gnu-maintenance.scm (kde-package?, latest-kde-release): New private functions. (%kde-updater): New public variable. * guix/scripts/refresh.scm (list-updaters): Add %kde-updater. * doc/guix.texi (Invoking guix refresh): Mention the new updater.
* Merge branch 'core-updates'Ludovic Courtès2016-08-011-3/+3
|
* doc: Discourage software bundling.Ludovic Courtès2016-07-281-0/+14
| | | | | | | Fixes <http://bugs.gnu.org/24008>. Suggested by ng0 <ng0@we.make.ritual.n0.is>. * doc/contributing.texi (Submitting Patches): Add item about bundling.
* doc: Send changes in your patch which are related.ng02016-07-281-0/+7
| | | | | | | | * doc/contributing.texi (Submitting Patches): New @item: This gives information about sending related changes and examples on what we view as related changes. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Mention separate branch for packages with many dependents.Ludovic Courtès2016-07-281-0/+7
| | | | | | | Suggested by ng0 <ng0@we.make.ritual.n0.is>. * doc/contributing.texi (Submitting Patches): Add note on packages with more than 100 dependents.
* environment: Set 'GUIX_ENVIRONMENT' to the profile.Ludovic Courtès2016-07-261-1/+9
| | | | | | | * guix/scripts/environment.scm (create-environment): Set 'GUIX_ENVIRONMENT' to PROFILE. * tests/guix-environment.sh: Test it. * doc/guix.texi (Invoking guix environment): Document it.
* doc: Explain authentication in "System Installation".Ludovic Courtès2016-07-261-1/+26
| | | | | | | | | Suggested by Vincent Legoll <vincent.legoll@gmail.com>. * doc/guix.texi (OPENPGP-SIGNING-KEY-ID): New constant. (Binary Installation): Use it. (USB Stick Installation): Copy and adjust the authentication bit from "Binary Installation".
* doc: Better illustration use of package revision numbers.ng02016-07-261-3/+5
| | | | | | | * doc/guix.texi (Version Numbers): Add the revision to the example of the git package used in 7.6.3. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* system: Add mapped devices for RAID.Andreas Enge2016-07-251-39/+74
| | | | | | | | | * gnu/system/mapped-devices.scm (raid-device-mapping, open-raid-device, close-raid-device): New variables. * doc/guix.texi (Mapped Devices): Add documentation for RAID devices, reorganize documentation for LUKS devices. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Explain when guix edit is read-only.myglc22016-07-251-3/+10
| | | | | | | * doc/guix.texi (Invoking guix edit): Explain when you can and can't edit the recipe. Signed-off-by: Alex Kost <alezost@gmail.com>
* doc: Describe how to make X server find TrueType fonts.Alex Kost2016-07-251-0/+19
| | | | | * doc/guix.texi (Application Setup): Document how to add TrueType fonts installed in a Guix profile to the X server font path.
* doc: Point out preference of message format.ng02016-07-241-1/+4
| | | | | | | | | * doc/contributing.texi (Submitting Patches): Includes a note on preference of plain text messages with either inline or MIME attachments and advise contributers to pay attention if their email client breaks the patches. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Explain that contributors can use a pseudonym.Ludovic Courtès2016-07-241-0/+4
| | | | | | | Suggested by ng0 <ng0@we.make.ritual.n0.is>. * doc/contributing.texi (Contributing): Explain that using a legal name is not required.
* doc: Add note on gender-neutral wording.Ludovic Courtès2016-07-221-0/+6
| | | | | | | Suggested by ng0 <ng0@we.make.ritual.n0.is>. * doc/contributing.texi (Submitting Patches): Add @item regarding gender-neutral wording.
* doc: Mention quoting and keywords.Ludovic Courtès2016-07-221-1/+33
| | | | | | | | Suggested by Vincent Legoll <vincent.legoll@gmail.com>. * doc/guix.texi (Defining Packages): Remove quasiquote in 'arguments' example. Mention quoting and keywords, with references to Guile's manual.
* publish: Handle '/file' URLs, for content-addressed files.Ludovic Courtès2016-07-201-0/+14
| | | | | | | | | | * guix/scripts/publish.scm (render-content-addressed-file): New procedure. (http-write): Add 'application/octet-stream' case. (make-request-handler): Add /file/NAME/sha256/HASH URLs. * tests/publish.scm ("/file/NAME/sha256/HASH") ("/file/NAME/sha256/INVALID-NIX-BASE32-STRING") ("/file/NAME/sha256/INVALID-HASH"): New tests. * doc/guix.texi (Invoking guix publish): Mention the /file URLs.
* services: Add pam-limits-service.Ricardo Wurmus2016-07-191-0/+30
| | | | | | | | * gnu/system/pam.scm (<pam-limits-entry>): New record type. (pam-limits-entry, pam-limits-entry->string): New procedures. * gnu/services/base.scm (pam-limits-service-type): New variable. (pam-limits-service): New procedure. * doc/guix.texi (Base Services): Document it.
* doc: Mention zlib as an optional dependency.Ludovic Courtès2016-07-191-1/+5
| | | | | * doc/guix.texi (Requirements): Mention zlib. (Invoking guix publish): Fix typo.
* publish: Add '--compression'.Ludovic Courtès2016-07-191-0/+12
| | | | | | | | | | | | | | | | | | | | | | | * guix/scripts/publish.scm (show-help, %options): Add '--compression'. (<compression>): New record type. (%no-compression, %default-gzip-compression): New variables. (%default-options): Add 'compression' key. (narinfo-string): Add #:compression parameter and honor it. (render-narinfo): Likewise. (render-nar): Likewise. <top level>: Add call to 'declare-header!'. (swallow-zlib-error): New macro. (nar-response-port): New procedure. (http-write): Add call to 'force-output'. Use 'nar-response-port' instead of 'response-port'. Use 'swallow-zlib-error'. (make-request-handler): Add #:compression parameter and honor it. Add "nar/gzip" URL handler. (run-publish-server): Add #:compression parameter and honor it. (guix-publish): Honor --compression. * tests/publish.scm (http-get-port, wait-until-ready): New procedures. <top level>: Run main server with "-C0". Call 'wait-until-ready'. ("/nar/gzip/*", "/*.narinfo with compression"): New tests. * doc/guix.texi (Invoking guix publish): Document it.
* services: Add 'dropbear-service'.David Craven2016-07-151-1/+42
| | | | | | | | | | * gnu/services/ssh.scm (<dropbear-configuration>): New record type. (dropbear-activation, dropbear-shepherd-service, dropbear-service): New procedures. (dropbear-service-type): New variable. * doc/guix.texi (Networking Services): Document it. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Explain 'guix hash -r' for Git checkouts.Ludovic Courtès2016-07-131-0/+16
| | | | | | | | | * doc/guix.texi (origin Reference): Add xref to "guix download" and "guix hash". (Invoking guix hash): Provide an example to compute the hash of a Git checkout. Co-authored-by: Troy Sankey <sankeytms@gmail.com>
* packages: <origin> no longer has an 'imported-modules' field.Ludovic Courtès2016-07-121-6/+3
| | | | | | | | | * guix/packages.scm (<origin>)[imported-modules]: Remove. (patch-and-repack): Remove #:imported-modules. Use 'with-imported-modules'. Remove #:modules argument to 'gexp->derivation'. (origin->derivation): Adjust accordingly. * doc/guix.texi (origin Reference): Adjust accordingly.
* gexp: 'program-file' and 'gexp->script' no longer have #:modules.Ludovic Courtès2016-07-121-3/+3
| | | | | | | * guix/gexp.scm (<program-file>)[modules]: Remove. (program-file): Remove #:modules and adjust accordingly. (program-file-compiler): Likewise. (gexp->script): Likewise.
* gexp: 'computed-file' no longer has a #:modules parameter.Ludovic Courtès2016-07-121-3/+2
| | | | | | | * guix/gexp.scm (<computed-file>)[modules]: Remove. (computed-file): Remove #:modules. (computed-file-compiler): Likewise. * doc/guix.texi (G-Expressions): Adjust accordingly.
* services: <shepherd-service> no longer has an 'imported-modules' field.Ludovic Courtès2016-07-121-4/+0
| | | | | | | | | | | | | | | | | | * gnu/services/shepherd.scm (<shepherd-service>)[imported-modules]: Remove. (%default-imported-modules): Make private. (shepherd-service-file): Use 'with-imported-modules'. (shepherd-configuration-file): Remove 'modules' and the calls to 'imported-modules' and 'compiled-modules'. Use 'with-imported-modules' instead. * doc/guix.texi (Shepherd Services): Adjust accordingly. * gnu/services/base.scm (file-system-shepherd-service): Use 'with-imported-modules'. Remove 'imported-modules' field. * gnu/system/mapped-devices.scm (device-mapping-service-type): Remove 'imported-modules'. (open-luks-device): Use 'with-imported-modules'. * gnu/tests.scm (marionette-shepherd-service): Remove 'imported-modules' field and use 'with-imported-modules'.
* gexp: 'gexp->file' emits code to set '%load-path'.Ludovic Courtès2016-07-121-1/+5
| | | | | | | * guix/gexp.scm (gexp->file): Add #:set-load-path? parameter and honor it. * gnu/system.scm (operating-system-parameters-file): Pass #:set-load-path? #f. * doc/guix.texi (G-Expressions): Adjust accordingly.
* gnu: Switch to 'with-imported-modules'.Ludovic Courtès2016-07-121-5/+1
| | | | | | | | | | | | | | | | | | | | | | | | * gnu/services.scm (directory-union): Use 'with-imported-modules' instead of the '#:modules' argument of 'computed-file'. * gnu/services/base.scm (udev-rules-union): Likewise. * gnu/services/dbus.scm (system-service-directory): Likewise. * gnu/services/desktop.scm (wrapped-dbus-service): (polkit-directory): Likewise. * gnu/services/networking.scm (tor-configuration->torrc): Likewise. * gnu/services/xorg.scm (xorg-configuration-directory): Likewise. * gnu/system/install.scm (self-contained-tarball): Likewise. * gnu/system/linux-container.scm (container-script): Likewise. * gnu/system/linux-initrd.scm (expression->initrd): Likewise, and remove #:modules parameter. (flat-linux-module-directory): Use 'with-imported-modules'. (base-initrd): Likewise. * gnu/system/locale.scm (locale-directory): Likewise. * gnu/system/shadow.scm (default-skeletons): Likewise. * gnu/system/vm.scm (expression->derivation-in-linux-vm): Likewise. * gnu/tests/base.scm (run-basic-test): Likewise. * gnu/tests/install.scm (run-install): Likewise. * doc/guix.texi (Initial RAM Disk): Update 'expression->initrd' documentation.
* gexp: Add 'with-imported-modules' macro.Ludovic Courtès2016-07-121-1/+37
| | | | | | | | | | | | | | | | | | | | | * guix/gexp.scm (<gexp>)[modules]: New field. (gexp-modules): New procedure. (gexp->derivation): Use it and append the result to %MODULES. Update docstring to mark #:modules as deprecated. (current-imported-modules, with-imported-modules): New macros. (gexp): Pass CURRENT-IMPORTED-MODULES as second argument to 'gexp'. (gexp->script): Use and honor 'gexp-modules'; define '%modules'. * tests/gexp.scm ("gexp->derivation & with-imported-modules") ("gexp->derivation & nested with-imported-modules") ("gexp-modules & ungexp", "gexp-modules & ungexp-splicing"): New tests. ("program-file"): Use 'with-imported-modules'. Remove #:modules argument to 'program-file'. * doc/guix.texi (G-Expressions): Document 'with-imported-modules'. Mark #:modules of 'gexp->derivation' as deprecated. * emacs/guix-devel.el: Add syntax for 'with-imported-modules'. (guix-devel-keywords): Add it. * .dir-locals.el: Likewise.
* services: Add rngd-service.David Craven2016-07-051-0/+7
| | | | | | | | | * gnu/services/base.scm (<rngd-configuration>): New record type. (rngd-service-type): New variable. (rngd-service): New procedure. * doc/guix.texi (Base Services): Document it. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* services: avahi: Add #:debug? parameter.Ludovic Courtès2016-06-271-1/+1
| | | | | | | * gnu/services/avahi.scm (<avahi-configuration>)[debug?]: New field. (avahi-shepherd-service): Honor it. (avahi-service): Add #:debug? and honor it. * doc/guix.texi (Networking Services): Adjust accordingly.
* doc: Fix typo for 'static-networking-service'.Ludovic Courtès2016-06-271-1/+1
| | | | | * doc/guix.texi (Networking Services): Change #:name-services to #:name-servers.
* doc: Augment mcron example.Ludovic Courtès2016-06-261-5/+23
| | | | | | | Suggested by Danny Milosavljevic. * doc/guix.texi (Scheduled Job Execution): Add unprivileged job example, and show the use of thunks as job actions and gexps.
* doc: Clarify /dev/kvm setup.Ludovic Courtès2016-06-261-6/+13
| | | | | | | | Reported by myglc2 <myglc2@gmail.com>. * doc/guix.texi (Build Environment Setup): Mention the "kvm" group. (Invoking guix system): Use "@quotation Note" for the note about KVM; make it clear that KVM is optional.
* doc: Document 'make check-system'.Ludovic Courtès2016-06-221-0/+25
| | | | * doc/guix.texi (Running the Test Suite): Document 'make check-system'.
* services: Add 'mcron-service'.Ludovic Courtès2016-06-221-0/+78
| | | | | | | | * gnu/services/mcron.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * gnu/tests/base.scm (%mcron-os, %test-mcron): New variables. (run-mcron-test): New procedure. * doc/guix.texi (Scheduled Job Execution): New node.
* gnu: services: Add bluetooth-service.宋文武2016-06-181-0/+7
| | | | | | | * gnu/services/desktop.scm (bluetooth-shepherd-service) (bluetooth-service): New Prodecures. (bluetooth-service-type): New variable. * doc/guix.text (Desktop Services): Document it.
* services: dicod: Add 'interfaces' configuration field.Ludovic Courtès2016-06-171-0/+5
| | | | | | | | | | | | | This makes 'dicod' listen on 'localhost' by default, whereas it was previously listening on all the interfaces, which is not a good default security-wise. * gnu/services/dict.scm (<dicod-configuration>)[interfaces]: New field. (dicod-configuration-file)[database->text]: New procedure, with code formerly in 'dicod-configuration->text'. [dicod-configuration->text]: Rename to... [configuration->text]: ... this. Honor 'interfaces'. * doc/guix.texi (Various Services): Document 'interfaces'.
* doc: Recommend against marketing phrases in descriptions.Ludovic Courtès2016-06-161-1/+7
| | | | | * doc/guix.texi (Synopses and Descriptions): Add note about marketing phrases.
* gnu: services: Add mysql-service.宋文武2016-06-161-1/+22
| | | | | | | | * gnu/services/database.scm (<mysql-configuration>): New record type. (%mysql-accounts, mysql-service-type): New variables. (mysql-configuration-file, %mysql-activation, mysql-shepherd-services) (mysql-services): New procedures. * doc/guix.texi (Database Services): Document it.
* gexp: Add #:select? parameter to 'local-file'.Ludovic Courtès2016-06-161-1/+6
| | | | | | | | | * guix/gexp.scm (<local-file>)[select?]: New field. (true): New procedure. (%local-file): Add #:select? and honor it. (local-file): Likewise. * tests/gexp.scm ("local-file, #:select?"): New test. * doc/guix.texi (G-Expressions): Adjust accordingly.
* doc: Fix typos.Ludovic Courtès2016-06-161-4/+4
| | | | | | | | Reported by ozzloy on #guix. * doc/guix.texi (package Reference): Add missing space. (G-Expressions, Invoking guix build): (Common Build Options): Fix typos.
* store: Add #:select? parameter to 'add-to-store'.Ludovic Courtès2016-06-151-1/+6
| | | | | | | | | | * guix/store.scm (write-arg): Remove 'file' case. (true): New procedure. (add-to-store): Add #:select? parameter and honor it. Use hand-coded stub instead of 'operation'. (interned-file): Add #:select? parameter and honor it. * doc/guix.texi (The Store Monad): Adjust 'interned-file' documentation accordingly.
* packages: The 'source' can be any lowerable object.Ludovic Courtès2016-06-151-2/+6
| | | | | | | | | | | * guix/packages.scm (expand-input): Use 'struct?' instead of 'origin?' when matching SOURCE. (package-source-derivation): Use 'lower-object' instead of 'origin->derivation'. * tests/packages.scm ("package-source-derivation, local-file"): New test. * doc/guix.texi (package Reference): Update 'source' documentation accordingly.
* import: pypi: read requirements from wheels.Cyril Roelandt2016-06-141-1/+3
| | | | | | | | * doc/guix.tex (Invoking guix import): Mention that the pypi importer works better with "unzip". * guix/import/pypi.scm (latest-wheel-release, wheel-url->extracted-directory): New procedures. * tests/pypi.scm (("pypi->guix-package, wheels"): New test.
* doc: Fix default value of #:recursive? for 'local-file'.Ludovic Courtès2016-06-121-1/+1
| | | | | * doc/guix.texi (G-Expressions): The #:recursive? parameter of 'local-file' defaults to #f.
* publish: Add '--ttl'.Ludovic Courtès2016-06-091-0/+10
| | | | | | | | * guix/scripts/publish.scm (show-help, %options): Add --ttl. (render-narinfo): Add #:ttl and honor it. (make-request-handler): Add #:narinfo-ttl and honor it. (run-publish-server): Likewise. (guix-publish): Honor --ttl, pass it to 'run-publish-server'.
* doc: Add missing quotes in wpa_supplicant example.Ludovic Courtès2016-06-081-1/+1
| | | | | | | Reported by Kete Foy <kete@ninthfloor.org>. * doc/guix.texi (Preparing for Installation): Add quotes in wpa_supplicant example.
* gnu: services: Add dicod-service.宋文武2016-06-051-0/+49
| | | | | | * gnu/services/dict.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Various Services): Document it.
* doc: Mention the 'ip' command.Ludovic Courtès2016-06-051-0/+7
| | | | | | Suggested by Alex Kost <alezost@gmail.com>. * doc/guix.texi (Preparing for Installation): Mention 'ip'.