-*- mode: org; coding: utf-8; -*-

#+TITLE: Hacking GNU Guix and Its Incredible Distro

Copyright © 2012, 2013, 2014, 2016, 2017, 2019 Ludovic Courtès <ludo@gnu.org>
Copyright © 2015, 2017 Mathieu Lirzin <mthl@gnu.org>
Copyright © 2017 Leo Famulari <leo@famulari.name>
Copyright © 2017 Arun Isaac <arunisaac@systemreboot.net>

  Copying and distribution of this file, with or without modification,
  are permitted in any medium without royalty provided the copyright
  notice and this notice are preserved.

* Contributing

See the manual for useful hacking informations, either by running

  info -f doc/guix.info "Contributing"

or by checking the [[https://guix.gnu.org/manual/devel/en/html_node/Contributing.html][web copy of the manual]].
='this.form.submit();'>
<option value='koszko' selected='selected'>koszko</option>
<option value='koszko-scripts'>koszko-scripts</option>
</select> <input type='submit' value='switch'/></form></td></tr>
<tr><td class='sub'>Wojtek's customized Guix</td><td class='sub right'></td></tr></table>
<table class='tabs'><tr><td>
<a href='/guix/about/'>about</a><a href='/guix/'>summary</a><a href='/guix/refs/?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>refs</a><a class='active' href='/guix/log/doc/build.scm'>log</a><a href='/guix/tree/doc/build.scm?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>tree</a><a href='/guix/commit/doc/build.scm?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>commit</a><a href='/guix/diff/doc/build.scm?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>diff</a></td><td class='form'><form class='right' method='get' action='/guix/log/doc/build.scm'>
<input type='hidden' name='id' value='2beffcb5585a860b2144807fbbdc92bbb00dbd86'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/guix/log/?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>root</a>/<a href='/guix/log/doc?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>doc</a>/<a href='/guix/log/doc/build.scm?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86'>build.scm</a></div><div class='content'><table class='list nowrap'><tr class='nohover'><th class='left'>Age</th><th class='left'>Commit message (<a href='/guix/log/doc/build.scm?id=2beffcb5585a860b2144807fbbdc92bbb00dbd86&amp;showmsg=1'>Expand</a>)</th><th class='left'>Author</th></tr>
<tr><td><span title='2019-11-28 13:30:53 +0100'>2019-11-28</span></td><td><a href='/guix/commit/doc/build.scm?id=295c6a7e834d1bede4cc5c9211b594bfbfa5ff35'>doc: Handle right arrows in 'syntax-highlighted-html'.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (syntax-highlighted-html)[build](entity-&gt;string): Add "rarr".
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-10-22 18:32:52 +0200'>2019-10-22</span></td><td><a href='/guix/commit/doc/build.scm?id=208cc522b93998050940372cef62287c08358188'>doc: Use the right title in HTML indices for the cookbook.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (html-manual-indexes): Add #:title.
[build]: Replace "GNU Guix Reference Manual" by references to TITLE.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-10-21 21:17:01 +0200'>2019-10-21</span></td><td><a href='/guix/commit/doc/build.scm?id=2f000f2ef48972b2544f0da3aa96faf19be8a04b'>doc: More responsive online manual.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (%makeinfo-html-options): Add viewport to all generated
html pages for better mobile device support.
</span></span></td><td>Julien Lepiller</td></tr>
<tr><td><span title='2019-10-21 18:16:16 +0200'>2019-10-21</span></td><td><a href='/guix/commit/doc/build.scm?id=cacb5576cc517cba45f69f1fb1551348714d85d0'>doc: Add support for "guix-cookbook.texi" to 'build.scm'.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (%manual): New variable.
(html-manual): #:manual now defaults to %MANUAL.
[build]: Define 'language-&gt;texi-file-name' and use it.  Filter out items
of LANGUAGES that lack a .texi file.
(pdf-manual, html-manual-indexes, pdf+html-manual): #:manual now
defaults to %MANUAL.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-09-25 15:46:48 +0200'>2019-09-25</span></td><td><a href='/guix/commit/doc/build.scm?id=012c93e916279f7df0e495aa1a73f696de15b80e'>doc: Support paren matching via CSS hover.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (syntax-highlighted-html)[build](pair-open/close)
(highlights-&gt;sxml*): New procedures.
(syntax-highlight): Use 'highlights-&gt;sxml*'.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-09-07 18:42:08 +0200'>2019-09-07</span></td><td><a href='/guix/commit/doc/build.scm?id=7854bbeb3f88ad4747b0a4ca01021ef2741f7b4e'>doc: Work around (htmlprag) parser issue.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (guile-lib/htmlprag-fixed): New variable.
(syntax-highlighted-html): Use it instead of GUILE-LIB.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-09-07 00:36:34 +0200'>2019-09-07</span></td><td><a href='/guix/commit/doc/build.scm?id=f8c143a7131d6f40f387f4cd2ad1fa78b5e2f429'>doc: Highlight Scheme syntax in the HTML output.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (syntax-highlighted-html): New procedure.
(html-manual): Use it.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-07-16 10:37:49 +0200'>2019-07-16</span></td><td><a href='/guix/commit/doc/build.scm?id=e3e9c191ed045234aa2929c12f6916eeb201744e'>doc: Add 'images' directory next to HTML pages.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (html-manual): Add images/ symlinks.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-07-15 12:48:49 +0200'>2019-07-15</span></td><td><a href='/guix/commit/doc/build.scm?id=e591541d36215eda3aa2d877578e00939001fb85'>doc: Build a top-level index of the manuals.</a><span class='msg-avail'>...<span class='msg-tooltip'>Suggested by Julien Lepiller.

* doc/build.scm (html-manual-indexes)[build]: Add 'with-extensions'.
(translate): Actually honor DOMAIN.  Add call to 'bindtextdomain' for
ISO-CODES.
(%iso639-languages): New variable.
(language-code-&gt;name, top-level-index): New procedures.
Add call to 'write-html' for OUTPUT/index.html.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-07-15 12:48:49 +0200'>2019-07-15</span></td><td><a href='/guix/commit/doc/build.scm?id=21bec78357ff5b93a14107bbeb5798923162f4b8'>doc: Generalize build procedures of HTML indexes.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm (html-manual-indexes)[build](sxml-index): Generalize;
add a 'title' and a 'body' parameter and honor them.
(language-index): New procedure.
(write-index): Remove.
(write-html): New procedure.
Use 'write-html' and 'language-index'.
</span></span></td><td>Ludovic Courtès</td></tr>
<tr><td><span title='2019-07-07 15:48:17 +0200'>2019-07-07</span></td><td><a href='/guix/commit/doc/build.scm?id=ccadafdcefee012c261513e9d8663a22704bc496'>build: Add 'doc/build.scm' to build on-line copies of the manual.</a><span class='msg-avail'>...<span class='msg-tooltip'>* doc/build.scm: New file.
* Makefile.am (EXTRA_DIST): Add it.
</span></span></td><td>Ludovic Courtès</td></tr>