aboutsummaryrefslogtreecommitdiff
path: root/doc/contributing.texi
Commit message (Collapse)AuthorAge
* pull: Install the new Guix in a profile.Ludovic Courtès2018-06-09
| | | | | | | | | | | | | | | | | | * guix/scripts/pull.scm (%pull-version): New variable. (build-from-source): Pass #:pull-version to BUILD. (whole-package-for-legacy, derivation->manifest-entry): New procedure. (build-and-install): Rewrite in terms of 'build-and-use-profile'. * guix/scripts/system.scm (maybe-suggest-running-guix-pull)[latest]: Switch to "/current". * scripts/guix.in (augment-load-paths!): Remove use of ~/.config/guix/latest. * build-aux/compile-as-derivation.scm: Replace "/guix/latest/" with "/current/share/guile/site/X.Y" * guix/scripts.scm (warn-about-old-distro)[age]: Check "/current" instead of "/latest". * doc/guix.texi (Invoking guix pull): Document it. * doc/contributing.texi (Running Guix Before It Is Installed): Remove footnote about abusing ~/.config/guix/latest.
* doc: Add tips for Vim users.Ludovic Courtès2018-04-27
| | | | * doc/contributing.texi (Formatting Code): Add a paragraph about Vim.
* doc: Suggest running guix-daemon with 'sudo -E'.Ludovic Courtès2018-01-17
| | | | | | | Suggested by Martin H. <maze@strahlungsfrei.de>. * doc/contributing.texi (Running Guix Before It Is Installed): Suggest 'sudo -E'.
* etc: Add snippets.Ricardo Wurmus2017-12-15
| | | | | | | | | | | | * etc/snippets/scheme-mode/guix-cvs-reference, etc/snippets/scheme-mode/guix-git-reference, etc/snippets/scheme-mode/guix-hg-reference, etc/snippets/scheme-mode/guix-origin, etc/snippets/scheme-mode/guix-package, etc/snippets/scheme-mode/guix-svn-reference, etc/snippets/text-mode/guix-commit-message-add-package, etc/snippets/text-mode/guix-commit-message-update-package: New files. * doc/contributing.texi (The Perfect Setup): Document snippets.
* doc: Move paragraph about signature verification to the top.Ricardo Wurmus2017-11-08
| | | | | * doc/contributing.texi (Submitting Patches): Remind contributors to verify cryptographic signatures at the very beginning.
* doc: Add a note about closing bug threads.Jan Nieuwenhuizen2017-09-19
| | | | | | | * doc/contributing.texi (Submitting Patches): Add a note about closing bug threads by mailing to NNN-done@debbugs.gnu.org. Suggested-by: Nicolas Goaziou <mail@nicolasgoaziou.fr>
* doc: Add "Sending a Patch Series" subsection.Jan Nieuwenhuizen2017-09-19
| | | | | | | | | | | | | Searching for `git send-email' took you to the end of `Submitting Patches' section which said You may use your email client or the ‘git send-email’ command. without further warning or remark. * doc/contributing.texi (Sending a Patch Series): Move information about debbugs bug 15361 to subsection. Add git-send-email index entries. (Submitting Patches): Reference it.
* Revert "doc: Suggest running guix-daemon with 'sudo -E'."Leo Famulari2017-08-07
| | | | | | | | This change might not correct, so we revert it for now: https://lists.gnu.org/archive/html/guix-devel/2017-08/msg00057.html This reverts commit 6a4364335c967f841b53ed35c22f90445437e4b0.
* doc: Suggest running guix-daemon with 'sudo -E'.Ludovic Courtès2017-08-06
| | | | | | | Suggested by Martin H. <maze@strahlungsfrei.de>. * doc/contributing.texi (Running Guix Before It Is Installed): Suggest 'sudo -E'.
* doc: Show the "git clone" command.Ludovic Courtès2017-07-20
| | | | | | Suggested by Joshua Branson <jbranso91@gmail.com>. * doc/contributing.texi (Building from Git): Add "git clone" command.
* doc: Encourage signature verification.Ricardo Wurmus2017-06-25
| | | | | * doc/contributing.texi (Submitting Patches): Remind contributors to verify cryptographic signatures.
* doc: Document the branching and rebuild scheduling strategy.Ludovic Courtès2017-05-13
| | | | | * doc/contributing.texi (Submitting Patches): Document the branching scheme.
* doc: Add references to Emacs-Guix manual.Alex Kost2017-05-04
| | | | | | * doc/htmlxref.cnf: Add links to the real manual. * doc/contributing.texi (Formatting Code): Add reference to it. * doc/guix.texi (Package Management): Likewise.
* doc: Update patch submission instructions.Ludovic Courtès2017-02-13
| | | | | * doc/contributing.texi (Submitting Patches): Add paragraph on guix-patches@gnu.org.
* etc: Support indentation of whole files.Ludovic Courtès2017-01-13
| | | | | | | * etc/indent-package.el.in: Rename to... * etc/indent-code.el.in: ... this. Add case for a single argument. * doc/contributing.texi (Formatting Code): Adjust accordingly. * configure.ac: Likewise.
* etc: Add 'indent-package.el' script.Ludovic Courtès2017-01-12
| | | | | | | | | | | * configure.ac: Check for 'emacs', substitute 'EMACS', and emit 'etc/indent-package.el'. * etc/indent-package.el.in: New file. * doc/contributing.texi (Formatting Code): Mention 'etc/indent-package.el'. (Submitting Patches): Likewise, and link to the above node. Co-authored-by: Alex Kost <alezost@gmail.com>
* Remove Emacs interface.Alex Kost2016-12-29
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * emacs/guix-about.el: Remove file. * emacs/guix-backend.el: Likewise. * emacs/guix-base.el: Likewise. * emacs/guix-buffer.el: Likewise. * emacs/guix-build-log.el: Likewise. * emacs/guix-command.el: Likewise. * emacs/guix-config.el.in: Likewise. * emacs/guix-devel.el: Likewise. * emacs/guix-entry.el: Likewise. * emacs/guix-external.el: Likewise. * emacs/guix-geiser.el: Likewise. * emacs/guix-guile.el: Likewise. * emacs/guix-help-vars.el: Likewise. * emacs/guix-helper.scm.in: Likewise. * emacs/guix-history.el: Likewise. * emacs/guix-hydra-build.el: Likewise. * emacs/guix-hydra-jobset.el: Likewise. * emacs/guix-hydra.el: Likewise. * emacs/guix-info.el: Likewise. * emacs/guix-init.el: Likewise. * emacs/guix-license.el: Likewise. * emacs/guix-list.el: Likewise. * emacs/guix-location.el: Likewise. * emacs/guix-main.scm: Likewise. * emacs/guix-messages.el: Likewise. * emacs/guix-pcomplete.el: Likewise. * emacs/guix-popup.el: Likewise. * emacs/guix-prettify.el: Likewise. * emacs/guix-profiles.el: Likewise. * emacs/guix-read.el: Likewise. * emacs/guix-ui-generation.el: Likewise. * emacs/guix-ui-license.el: Likewise. * emacs/guix-ui-location.el: Likewise. * emacs/guix-ui-package.el: Likewise. * emacs/guix-ui-system-generation.el: Likewise. * emacs/guix-ui.el: Likewise. * emacs/guix-utils.el: Likewise. * emacs/local.mk: Likewise. * doc/emacs.texi: Likewise. * doc/guix.texi: Remove cross-references to Emacs nodes. (Package Management): Mention 'emacs-guix' package. * doc/contributing.texi (The Perfect Setup): Remove the reference. * doc/htmlxref.cnf: Add 'emacs-guix' URL. * Makefile.am: Remove Emacs stuff. * configure.ac: Likewise. * gnu/packages/package-management.scm (guix-0.12.0)[native-inputs]: Remove "emacs". [propagated-inputs]: Remove "geiser" and "emacs-magit-popup". Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Fix typo in Submitting Patches section.Maxim Cournoyer2016-12-14
| | | | | | * doc/contributing.texi (Submitting Patches): Fix "could could" typo. Signed-off-by: Leo Famulari <leo@famulari.name>
* doc: Discourage software bundling.Ludovic Courtès2016-07-28
| | | | | | | 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-28
| | | | | | | | * 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-28
| | | | | | | Suggested by ng0 <ng0@we.make.ritual.n0.is>. * doc/contributing.texi (Submitting Patches): Add note on packages with more than 100 dependents.
* doc: Point out preference of message format.ng02016-07-24
| | | | | | | | | * 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-24
| | | | | | | 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-22
| | | | | | | Suggested by ng0 <ng0@we.make.ritual.n0.is>. * doc/contributing.texi (Submitting Patches): Add @item regarding gender-neutral wording.
* doc: Mention --localstatedir for when building from Git.Ludovic Courtès2016-04-16
| | | | | | Reported by Hartmut Goebel <h.goebel@crazy-compilers.com>. * doc/contributing.texi (Building from Git): Mention --localstatedir.
* doc: Add footnote about pointing ~/.config/guix/latest at user's checkoutChristopher Allan Webber2016-03-11
| | | | * doc/contributing.texi (Running Guix Before It Is Installed): New footnote.
* doc: Fix minor typos and add missing words.Chris Marusich2016-02-24
| | | | | | | | | * doc/guix.texi (Shepherd Services): Add missing words. (Invoking guix system): Fix typo. (Service Types and Services): Fix typo. * doc/contributing.texi (Submitting Patches): Fix typo. Signed-off-by: Andreas Enge <andreas@enge.fr>
* doc: rephrase code of conduct.Alex Sassmannshausen2015-12-09
| | | | | | | * doc/contributing.texi (Contributing): Rephrase 'code of conduct' section. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* Add "Contributor Covenant".Ludovic Courtès2015-12-09
| | | | | | | * CODE-OF-CONDUCT: New file, adapted from <http://contributor-covenant.org/version/1/3/0/code_of_conduct.txt>. * doc/contributing.texi (Contributing): Mention it. * Makefile.am (EXTRA_DIST): Add it.
* guix build: Add '--rounds'.Ludovic Courtès2015-12-08
| | | | | | | | * guix/scripts/build.scm (show-build-options-help) (%standard-build-options): Add --rounds. (set-build-options-from-command-line): Honor it. * doc/guix.texi (Invoking guix build): Document it. * doc/contributing.texi (Submitting Patches): Mention it.
* doc: Mention 'guix environment guix'.Ludovic Courtès2015-11-22
| | | | | | * doc/contributing.texi (Building from Git): Mention 'guix environment guix'. Remove outdated description of ./bootstrap. Clarify a few things.
* doc: Remove extraneous "See."Ludovic Courtès2015-11-21
| | | | | * doc/contributing.texi (Building from Git): Remove extra "See" and use @xref instead of @pxref.
* doc: Fix 'geiser-guile-load-path' example.Alex Kost2015-11-21
| | | | | | | Reported by marusich on #guix. * doc/contributing.texi (The Perfect Setup): Wrap modifying 'geiser-guile-load-path' into 'with-eval-after-load'.
* doc: './pre-inst-env guix pull' won't upgrade local source tree.Alex Vong2015-11-03
| | | | | | | | * doc/contributing.texi (Running Guix Before It Is Installed): Clarify './pre-inst-env guix pull' won't upgrade local source tree. * doc/guix.texi (Invoking guix pull): Mention ~/.config/guix/latest. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* doc: Add texinfo to the requirements when building from git.Mark H Weaver2015-10-28
| | | | | * doc/contributing.texi (Building from Git): Add GNU Texinfo to the list of additional requirements.
* doc: Add a REPL example.Ludovic Courtès2015-10-27
| | | | | | * doc/contributing.texi (Running Guix Before It Is Installed): Add REPL example. * doc/emacs.texi (Emacs General info): Add @cindex.
* Add 'guix challenge'.Ludovic Courtès2015-10-20
| | | | | | | | | | | | * guix/scripts/challenge.scm, tests/challenge.scm: New files. * Makefile.am (MODULES): Add the former. (SCM_TESTS): Add the latter. * doc.am (SUBCOMMANDS): Add 'challenge'. * doc/guix.texi (Substitutes): Add xref to 'guix challenge'. (Invoking guix challenge): New node. * doc/contributing.texi (Submitting Patches): Add note about using 'guix challenge'. * po/guix/POTFILES.in: Add guix/scripts/challenge.scm.
* emacs: Add development utils.Alex Kost2015-09-23
| | | | | | | | | | | | * 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: 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.
* Add 'guix size'.Ludovic Courtès2015-06-18
| | | | | | | | | | | | | | | * guix/scripts/size.scm: New file. * Makefile.am (MODULES): Add it. (SCM_TESTS): Add tests/size.scm. * doc.am (SUBCOMMANDS): Add 'size'. * po/guix/POTFILES.in: Add guix/scripts/size.scm. * tests/size.scm: New file. * doc/guix.texi (Packages with Multiple Outputs): Add xref to "Invoking guix size". (Invoking guix size): New node. (Invoking guix gc): Add index for "closure" and xref to the above. * doc/contributing.texi (Submitting Patches): Use @enumerate for the check list. Add item about 'guix size'.
* doc: Move most 'HACKING' informations into the manual.Mathieu Lirzin2015-06-14
* HACKING (Contributing): New section. (Building from Git, The Perfect Setup, Coding Style, Submitting Patches): Move to ... * doc/guix.texi (Running Guix Before It Is Installed): Likewise. * doc/contributing.texi: ... here. New file. * doc.am (EXTRA_DIST): Use it. * README (Installation): Adapt to it. * configure.ac (DOT): Likewise.