Commit graph

44 commits

Author SHA1 Message Date
Joshua Branson 07ef129db3
doc: cookbook: Add "Guix System Image API" section.
* doc/guix-cookbook.texi (Guix System Image API): New section.

Signed-off-by: Mathieu Othacehe <othacehe@gnu.org>
2021-01-21 14:40:36 +01:00
Julien Lepiller 2a9784ffa2
doc: Replace TP with Weblate mentions.
* doc/contributing.texi: Replace link to TP with a link to Weblate.
* doc/guix.texi: Replace link to TP with a link to Weblate.
* doc/guix-cookbook.texi: Replace link to TP with a link to Weblate.
2021-01-20 16:16:45 +01:00
Pierre Neidhardt af67e8d0b1
doc: cookbook: Fix "fiction-less" typo.
* doc/guix-cookbook.texi (Guix Profiles in Practice): Change "friction-less"
to "frictionless".
2020-12-23 11:45:06 +01:00
Ludovic Courtès f54149062e
doc: cookbook: Balance parens in custom kernel examples.
* doc/guix-cookbook.texi (Customizing the Kernel): Add missing paren in
example.  Remove extra parens in other example.
2020-10-17 22:40:18 +02:00
Ludovic Courtès c0001b8bfc
doc: cookbook: Clarify what keywords are.
* doc/guix-cookbook.texi (A Scheme Crash Course): Clarify what keywords
are.
2020-10-15 23:51:04 +02:00
Ludovic Courtès 61263e1ba3
doc: Add "Build Utilities" section.
* doc/guix.texi (Build Utilities): New section.
(Defining Packages): Refer to it.
(Build Systems): Likewise.
* doc/guix-cookbook.texi (Extended example): Likewise.
2020-10-15 18:50:22 +02:00
Ludovic Courtès 48720afb32
doc: cookbook: Use @code for the identifiers of utility functions.
* doc/guix-cookbook.texi (Utility functions): Use @code instead of @asis.
2020-10-15 18:50:22 +02:00
Ludovic Courtès 3451368345
doc: cookbook: More "#true" and "#false".
* doc/guix-cookbook.texi (Extended example)
(Customizing the Kernel, Running Guix on a Linode Server): Use #true and #false.
2020-10-15 18:50:22 +02:00
Ludovic Courtès 51f34e21c6
doc: cookbook: Use @var for meta-syntactic variables.
* doc/guix-cookbook.texi (Extended example): Use @var for meta-syntactic
variables in 'modify-phases' description.
2020-10-15 18:50:22 +02:00
Ludovic Courtès 7802988201
doc: cookbook: Fix 'let' form in example.
* doc/guix-cookbook.texi (Extended example): Fix 'let' form in example.
2020-10-15 18:50:22 +02:00
Oleg Pykhalov 00014f7692
services: nginx: Add lua module.
* gnu/services/web.scm (<nginx-configuration>)
[lua-package-path, lua-package-cpath]: New record types.
* gnu/services/web.scm (default-nginx-config): Use them.
* doc/guix.texi (Web Services): Document this.
* doc/guix-cookbook.texi (System Configuration): Document this.
2020-10-14 23:41:26 +03:00
Ludovic Courtès cd958802f2
doc: cookbook: Mention "#true" and "#false".
* doc/guix-cookbook.texi (A Scheme Crash Course): Mention "#true" and
"#false".
(Extended example): Likewise.
2020-10-14 15:22:56 +02:00
Joshua Branson 191e79dab2
doc: cookbook: Adding a section "Running Guix on a Linode Server"
* doc/guix-cookbook.texi (Running Guix on a Linode Server):
I added a section that explains how to run guix on a linode server.
Thanks Chris Webber!

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-09-09 09:28:12 +02:00
Oleg Pykhalov d0fc1e832c
doc: cookbook: Add chapter about Guix environment.
* doc/guix-cookbook.texi (Environment management): New chapter.
2020-08-23 10:47:35 +03:00
Tobias Geerinckx-Rice e892b9c3dc
doc: cookbook: Fix ‘file system’ spelling.
* doc/guix-cookbook.texi (Getting help, Customizing the Kernel):
Fix ‘file system’ spelling.
2020-07-09 19:57:39 +02:00
Ludovic Courtès e3d2e618fe
doc: cookbook: Fix encoding of "André".
This is a followup to f8945734a5.

* doc/guix-cookbook.texi: Encode "André" as UTF-8, not ISO-8859-1.
2020-06-28 23:28:55 +02:00
André Batista f8945734a5
doc: cookbook: Update entry about getting substitutes through Tor.
* doc/guix-cookbook.texi (Getting substitutes from Tor): Update
section warning to mention the use of torsocks when pulling.
2020-06-28 13:26:14 +02:00
Ludovic Courtès 4ebbd92c29
doc: cookbook: Fix typos.
* doc/guix-cookbook.texi (Extended example): Fix typos.
2020-06-23 23:39:42 +02:00
Ludovic Courtès 96a95aa9c7
doc: cookbook: Tweak intro to the REPL.
* doc/guix-cookbook.texi (A Scheme Crash Course): Reword first
paragraph.  Remove extra paren.
2020-06-23 00:03:08 +02:00
Ludovic Courtès 2f562699ea
doc: cookbook: Mention "guix hash -rx" for Git checkouts.
* doc/guix-cookbook.texi (Extended example): Mention "guix hash -rx ."
2020-06-23 00:03:08 +02:00
Ludovic Courtès ab83e1f054
doc: cookbook: Clarify 'git-fetch' conventions.
* doc/guix-cookbook.texi (Extended example): Clarify use of 'git-file-name'
and 'git-version'.
2020-06-23 00:03:08 +02:00
Brice Waegeneire c987b72382
doc: cookbook: Add entry about getting substitutes through Tor.
* doc/guix-cookbook.texi (Getting substitutes from Tor): New section.
2020-06-04 14:48:09 +02:00
Marcin Karpezo 5c3e94cdf8
doc: cookbook: Add entry about Wireguard VPN.
Co-authored-by: Brice Waegeneire <brice@waegenei.re>

* doc/guix-cookbook.texi (Connect to Wireguard VPN): New section.
2020-06-02 11:31:48 +02:00
Chris Bøg 3142191da6
doc: cookbook: Add subsection about session locking with xss-lock.
* doc/guix-cookbook.texi (Session lock): New node.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
2020-05-25 00:00:27 +02:00
Jean-Baptiste Note 751d1f01e4
doc: cookbook: Fix sbcl-ttf-fonts package name.
* doc/guix-cookbook.texi (StumpWM): Adjust sbcl-ttf-fonts package name.

Signed-off-by: Marius Bakke <mbakke@fastmail.com>
2020-05-05 20:09:39 +02:00
Marcin Karpezo 145df67b25
doc: cookbook: Rename stumpwm package to current state.
* doc/guix-cookbook.texi (StumpWM): Rename STUMPWM package to current state.

Signed-off-by: Oleg Pykhalov <go.wigust@gmail.com>
2020-04-30 00:43:46 +03:00
Nicolas Goaziou 128b136ec6
doc: cookbook: Fix quotes.
* doc/guix-cookbook.texi (Basic setup with manifests):
(Default profile):
(The benefits of manifests): Use proper quotes in regular texts.
2020-04-25 23:10:16 +02:00
Nicolas Goaziou 2c8305d140
doc: cookbook: Use @file for file names and extensions.
* doc/guix-cookbook.texi (@samp{GUIX_PACKAGE_PATH}):
(Extended example):
(Setting up a bind mount):
(Basic setup with manifests):
(Default profile): Use @file instead of @samp or @code for file names and
extensions.
2020-04-24 18:40:04 +02:00
Nicolas Goaziou cc765e478a
doc: cookbook: Fix misuses of double spacing.
* doc/guix-cookbook.texi (Extended example):
(StumpWM):
(Basic setup with manifests): Prevent Texinfo from ending a sentence where it
should not.
(Setting up a bind mount): Add two spaces where needed.
2020-04-24 18:32:56 +02:00
Matthew Brooks 60651dd962
doc: cookbook: Explain how to use bind mounts.
* doc/guix-cookbook.texi (Setting up a bind mount): Add example.

Signed-off-by: Leo Famulari <leo@famulari.name>
2020-04-22 15:49:53 -04:00
Oleg Pykhalov 65051fdce1
gnu: Add sbcl-stumpwm-ttf-fonts.
* gnu/packages/wm.scm (sbcl-stumpwm-ttf-fonts): New variable.
* doc/guix-cookbook.texi (Customizing a Window Manager): Document
SBCL-STUMPWM-TTF-FONTS installation and configuration.
2020-03-30 23:20:54 +03:00
Ludovic Courtès a9e255127a
doc: cookbook: Avoid URL reference to the manual.
* doc/guix-cookbook.texi (Other build systems): Use @xref instead of
@uref, and remove section number.
2020-01-17 14:22:07 +01:00
Ludovic Courtès 6a893fa869
doc: cookbook: Add cross-references to the Guile manual.
* doc/guix-cookbook.texi (A Scheme Crash Course): Add cross-reference to
the Guile manual.
2019-11-26 00:16:36 +01:00
Ludovic Courtès cf1e6f5f90
doc: cookbook: Use @result{} & co. instead of a '>' prompt.
* doc/guix-cookbook.texi (A Scheme Crash Course)
(Extended example): Use @result{}, @print{}, and @error{}.
2019-11-26 00:16:35 +01:00
Ludovic Courtès 0cbef07b34
doc: cookbook: Use Texinfo quotes.
* doc/guix-cookbook.texi: Use Texinfo quotes ``like this'' instead of
straight quotes or curly quotes.
2019-11-26 00:16:35 +01:00
Ludovic Courtès e97a4a2944
doc: cookbook: Add cross-reference about ./pre-inst-env.
* doc/guix-cookbook.texi (Direct checkout hacking): Refer to "Running
Guix Before It Is Installed".
2019-11-26 00:16:35 +01:00
Ludovic Courtès d482e13fbe
doc: cookbook: Use @lisp for Scheme snippets.
* doc/guix-cookbook.texi: Use @lisp instead of @example where
appropriate.
2019-11-26 00:16:35 +01:00
Pierre Neidhardt cb7b501deb
doc: Explain how to switch profile from empty shell in "Profiles in Practice".
* doc/guix-cookbook.texi (Profiles in Practice): Add example.
2019-10-30 09:33:53 +01:00
Pierre Neidhardt ed79636c8b
doc: Link to SICP Info page in "A Scheme Crash Course".
* doc/guix-cookbook.texi (Scheme tutorials): Replace Emacs Info reader hint
  with more useful interactive link to SICP Info page.
2019-10-28 11:09:19 +01:00
Pierre Neidhardt ffe059afb5
doc: Finish importing the "Packaging Tutorial".
* doc/guix-cookbook.texi (Packaging Tutorial): Import all sections after the
  Scheme crash course.
2019-10-28 11:09:19 +01:00
Pierre Neidhardt f6c27c5541
doc: Fix some typos in "Guix Profiles in Practice".
* doc/guix-cookbook.texi (Guix Profiles in Practice): Fix typos.
2019-10-28 11:09:18 +01:00
Ludovic Courtès b1eecb5c46
doc: cookbook: Use "@lisp" for Scheme snippets.
* doc/guix-cookbook.texi: Use @lisp for Scheme snippets instead of
"@example scheme".  This allows for syntax highlighting of the HTML
output.
2019-10-25 12:14:09 +02:00
Pierre Neidhardt 4c463569b7
doc: Add "Guix Profiles in Practice" to the cookbook.
* doc/guix-cookbook.texi (Advanced package management): New chapter.
* doc/guix-cookbook.texi (Guix Profiles in Practice): New section.
2019-10-24 11:34:52 +02:00
Ricardo Wurmus 7bc46ecc34
doc: Add Guix Cookbook.
* .gitignore: Update ignore list.
* Makefile.am (assert-no-store-file-names): Exclude the cookbook.
* bootstrap: Generate po files for cookbook translations.
* doc/guix-cookbook.texi: New file.
* doc/local.mk (info_TEXINFOS): Add it; add a rule to build cookbook
translations.
* po/doc/local.mk (DOC_COOKBOOK_PO_FILES): New variable.
(EXTRA_DIST): Add cookbook pot file and po files.
(doc-po-update-cookbook-%): New target.
(doc-pot-update): Also update cookbook pot file.
(doc-po-update): Also update cookbook po files.
2019-09-18 11:38:14 +02:00