aboutsummaryrefslogtreecommitdiff
path: root/doc/contributing.texi
Commit message (Collapse)AuthorAge
* maint: update-guix-package: Optionally add sources to store.Maxim Cournoyer2020-11-12
| | | | | | | | | | | | | | | | | | | | | Following discussions in <https://issues.guix.gnu.org/43893>, keeping a copy of the updated package source is desirable when generating a release. * build-aux/update-guix-package.scm (version-controlled?): Remove variable. (call-with-temporary-git-worktree): Renamed from 'with-temporary-git-worktree'. Update doc. Do not change directory implicitly. Define as a procedure, not a syntax. (keep-source-in-store): New procedure. (main): Adjust to use with call-with-temporary-git-worktree. Add the sources to the store when GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT is set. Exit gracefully when FIND-ORIGIN-REMOTE returns #f. (%savannah-guix-git-repo-push-url-regexp): Adjust match for a potential colon separator. * Makefile.am (GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT): Adjust. * .dir-locals.el (scheme-mode): Remove entry for with-temporary-git-worktree. * doc/contributing.texi (Updating the Guix Package): Update doc. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
* build: Add GUIX_GIT_KEYRING variable for make authenticate.Miguel Ángel Arruga Vivas2020-10-24
| | | | | | | | * Makefile.am (GUIX_GIT_KEYRING): New variable. (authenticate): Use GUIX_GIT_KEYRING to select the keyring branch reference. * doc/contributing.texi (Building from Git): Add an example about the use of GUIX_GIT_KEYRING.
* doc: More uses of @lisp instead of @example.Ludovic Courtès2020-10-20
| | | | | | * doc/guix.texi (G-Expressions): Use @lisp for 'let-system' example. * doc/contributing.texi (Synopses and Descriptions): Use @lisp for second example.
* maint: update-guix-package: Prevent accidentally breaking guix pull.Maxim Cournoyer2020-10-19
| | | | | | | | | | | | | | | | | | | | | Fixes <https://issues.guix.gnu.org/43893>. This changes the 'update-guix-package' tool so that it: 1. Always uses a clean checkout to compute the hash of the updated 'guix' package. 2. Ensures the commit used in the updated 'guix' package definition has already been pushed upstream. * build-aux/update-guix-package.scm (%savannah-guix-git-repo-push-url): New variable. (with-input-pipe-to-string, with-temporary-git-worktree): New syntaxes. (find-origin-remote, git-add-worktree): New procedures. (commit-already-pushed?): New predicate. (main): Check the commit used has already been pushed upstream and compute the hash from a clean checkout. * doc/contributing.texi (Updating the Guix Package): Document it. * .dir-locals.el (scheme-mode): Fix indentation of with-temporary-git-worktree.
* doc: Clarify that guix-daemon doesn't have to be launched from the checkout.Ludovic Courtès2020-10-08
| | | | | | | | | Suggested by Emmanuel Agullo. * doc/contributing.texi (Running Guix Before It Is Installed): Move the "./pre-inst-env guix-daemon" snippet at the bottom. Make it clear that it's necessary only when hacking on guix-daemon or when guix-daemon is not already running.
* doc: Developers don't need to run "make install" in Guix.Ludovic Courtès2020-10-08
| | | | | | | Suggested by Emmanuel Agullo. * doc/contributing.texi (Building from Git): Mention that running "make install" is unnecessary.
* doc: Fix broken hyperlinks in the contribution instructions.Greg Hogan2020-09-18
| | | | | * doc/contributing.texi (Packaging Guidelines, Submitting Patches): Change URLs from relative to absolute links.
* doc: Document the use of snippets vs phases.Maxim Cournoyer2020-09-12
| | | | * doc/contributing.texi (Snippets versus phases): New section.
* doc: Improve the instructions regarding `guix git authenticate`.Joshua Branson2020-08-27
| | | | | | | * doc/contributing.texi (Building from Git): Instruct the user to fetch the 'keyring' branch. Fix a typo. Signed-off-by: Leo Famulari <leo@famulari.name>
* doc: Recommend running 'guix git authenticate' when cloning the repo.Ludovic Courtès2020-07-23
| | | | | * doc/contributing.texi (Building from Git): Adjust instruction and recommend 'guix git authenticate'.
* doc: Fix typo.Tobias Geerinckx-Rice2020-07-09
| | | | * doc/contributing.texi (The Perfect Setup): Fix spelling & placement of ‘additionally’.
* doc: Make issues.guix.gnu.org more visible.Ludovic Courtès2020-06-20
| | | | | * doc/contributing.texi (Tracking Bugs and Patches): Make issues.guix.gnu.org more visible, update issue URL.
* doc: Recommend "make authenticate" after ./bootstrap.Ludovic Courtès2020-06-16
| | | | | * doc/contributing.texi (Building from Git): Move "make authenticate" instructions below.
* doc: Adjust branching and rebuilding strategy to match reality.Marius Bakke2020-06-14
| | | | | | | | | The amount of packages has more than tripled since this section was written. Adjust the rebuild limits and cycle lengths based on current practices. * doc/contributing.texi (Submitting Patches): Increase 'staging' rebuild limit to 1800 packages, and adjust the cycle to six weeks. Increase 'core-updates' cycle to six months.
* doc: Remove explicit support for mips64el-linux.Efraim Flashner2020-05-28
| | | | | | | | | | | | | | | | | | It's been a good run, but no one is maintaining the architecture. So long, and thanks for all the fish. * doc/guix.texi (GNU Distribution): Change text for mips64el-linux to denote it is deprecated. (Daemon Offload Setup): Change occurrences of mips64el-linux to aarch64-linux and adjust local code snippets. (Guix Environment)[cross-compilation]: Change mips64el-linux-gnu to aarch64-linux-gnu. (GNU Build System)(package-cross-derivation]: Same. (G-Expressions)[cross compilation]: Same. (Additional Build Options)[cross-compilation, build logs]: Same. (qemu-binfmt-service-type): Remove mips64el. * doc/contributing.texi (Submitting Patches): Same. * m4/guix.m4: (GUIX_ASSERT_SUPPORTED_SYSTEM): Remove mips64el-linux.
* doc: Fix typos.zimoun2020-05-25
| | | | | | | * doc/guix.texi: Fix typos. * doc/contributing.texi: Fix typos. Signed-off-by: Julien Lepiller <julien@lepiller.eu>
* maint: Add "make check-channel-news".Ludovic Courtès2020-05-22
| | | | | | | * build-aux/check-channel-news.scm: New file. * Makefile.am (EXTRA_DIST): Add it. (check-channel-news): New phony rule. * doc/contributing.texi (Commit Access): Mention "make check-channel-news".
* doc: Specify the branch name in the title of a patch.Brice Waegeneire2020-05-12
| | | | | * doc/contributing.texi (Submitting Patches): Add branch name in the title of a patch if different than master.
* doc: Recommend against SHA1 OpenPGP signatures.Ludovic Courtès2020-05-04
| | | | | * doc/contributing.texi (Commit Access): Recommend against SHA1 signatures.
* doc: Document committer authorization.Ludovic Courtès2020-05-04
| | | | | * doc/contributing.texi (Commit Access): Add instructions for authorizing committers.
* doc: Update guidance about Python 2 package variants.Leo Famulari2020-03-13
| | | | | * doc/contributing.texi (Python Modules): Don't recommend adding Python-2 package variants by default.
* doc: Use HTTPS for external links.Vitaliy Shatrov2020-03-10
| | | | | | | | | | | | | | | | | | | | | | | | | * doc/contributing.texi (14.1 Building from Git, 14.3 The Perfect Setup, 14.4.1 Software Freedom, 14.4.4 Synopses and Descriptions, 14.5.4 Formatting Code): Use HTTPS for @uref{}s and @url{}s that support it. * doc/fdl-1.3.texi (Appendix A GNU Free Documentation License): Use HTTPS for @uref{}s and @url{}s that support it. * doc/guix.texi (6.3 Build Systems, 8.8.4 Networking Services, 8.8.8 Sound Services, 8.8.16 Web Services, 8.11 Name Service Switch, 12.2 Preparing to Use the Bootstrap Binaries); Use HTTPS for @uref{}s and @url{}s that support it. Signed-off-by: Marius Bakke <mbakke@fastmail.com>
* doc: Use an https link for Contributor Covenant.Jakub Kądziołka2020-03-09
| | | | | | | * doc/contributing.texi: Switch to https for the link to contributor-covenant.org Reported-By: guix-vits on IRC
* etc: Add copyright.Oleg Pykhalov2020-02-22
| | | | | * etc/copyright.el: New file. * doc/contributing.texi (The Perfect Setup): Document this.
* doc: Document packaging guidelines for Rust crates.Efraim Flashner2020-02-18
| | | | * doc/contributing.texi (Rust Crates): New section.
* Use HTTPS for www.emacswiki.org.Tobias Geerinckx-Rice2020-01-19
| | | | | | * doc/contributing.texi (The Perfect Setup): Use HTTPS for ParEdit wiki page. * gnu/packages/emacs-xyz.scm (emacs-wget, emacs-iedit)[home-page]: Use HTTPS. (emacs-transpose-frame)[source]: Likewise.
* doc: Add a cooptation policy for commit access.Ludovic Courtès2020-01-09
| | | | * doc/contributing.texi (Commit Access): Draft a cooptation policy.
* doc: Encourage patch review.Ludovic Courtès2020-01-09
| | | | * doc/contributing.texi (Commit Access): Add note about patch review.
* doc: Move "Commit Access" section from 'HACKING' to the manual.Ludovic Courtès2020-01-09
| | | | | | | * HACKING (Commit Access): Remove. (Contributing): Update URL of the manual. * doc/contributing.texi (Commit Access): New section. (Submitting Patches): Add cross reference.
* doc: Add "Tracking Bugs and Patches" section.Ludovic Courtès2020-01-09
| | | | | | | * doc/contributing.texi (Tracking Bugs and Patches): New section. (Submitting Patches): Refer to it. * doc/guix.texi: Update copyright line. * HACKING (Using emacs-debbugs): Remove.
* doc: Mention "make authenticate".Ludovic Courtès2019-12-27
| | | | | * doc/contributing.texi (Building from Git): Add instructions to run 'git verify-commit' and 'make authenticate'.
* doc: Link to "Building from Git" instead of quoting command to build Guix.Pierre Neidhardt2019-12-13
| | | | | * doc/contributing.texi (Submitting Patches): Remove example. Add link to "Building from Git" section.
* doc: Mention how to simulate a `guix pull' before submitting patches.Pierre Neidhardt2019-12-08
| | | | | * doc/contributing.texi (Submitting Patches): Mention the dummy guix pull command in the check list.
* doc: Mention how to rebuild guix before submitting patches.Pierre Neidhardt2019-12-08
| | | | | * doc/contributing.texi (Submitting Patches): Mention rebuild command in the check list.
* doc: Mention value /var to localstatedir option.zimoun2019-11-09
| | | | | | | | * README (Installing Guix from Guix): Mention value /var to localstatedir option. * doc/contributing.texi (Building from Git): Likewise. * doc/guix.texi (Requirements): Likewise. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Use @lisp instead of @example for Scheme snippets.Ludovic Courtès2019-09-07
| | | | | | | | This is a followup to f8c143a7131d6f40f387f4cd2ad1fa78b5e2f429, which allows syntax highlighting of @lisp snippets in the HTML output. * doc/guix.texi, doc/contributing.texi: Use @lisp instead of @example for all the Scheme snippets.
* doc: Reorder and clarify contributing instructions.Florian Pelz2019-07-17
| | | | | | | | * doc/contributing.texi (Building from Git, Running Guix Before It Is Installed): Make instructions using Guix come first and clarify which code is an instruction and which is merely an example. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: note how to install git send-emailArne Babenhauserheide2019-07-15
| | | | | | * doc/contributing.texi (git send-email): Add install instructions. Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Remove references to hydra.gnu.org.Tobias Geerinckx-Rice2019-06-29
| | | | | | | * doc/contributing.texi (Packaging Guidelines, Submitting Patches): Replace hydra URL with @value{SUBSTITUTE-SERVER}. * doc/guix.texi (Official Substitute Server): Remove ‘hydra’ @cindex. (Substitute Server Authorization): Remove note about hydra.gnu.org.pub.
* doc: use pure environment when building from gitGiovanni Biscuolo2019-05-20
| | | | | | | * doc/contributing.texi (Building from Git): Add --pure to "guix environment" invocations Signed-off-by: Ludovic Courtès <ludo@gnu.org>
* doc: Remove instances of powerpc-linux being a supported Guix architecture.Efraim Flashner2019-03-24
| | | | | | | * doc/contributing.texi (Submitting Patches): Remove powerpc-linux examples. * doc/guix.texi (Virtualization Services): Replace powerpc-linux example with mips64el-linux.
* doc: Document how to enable qemu binfmt service and how to use it.Danny Milosavljevic2019-02-04
| | | | | | | * doc/contributing.texi (Submitting Patches): Document how to enable qemu binfmt service and how to use it. Co-authored-by: Ricardo Wurmus <rekado@elephly.net>
* doc: Show how to install Emacs, Guile, and Geiser.Ludovic Courtès2019-02-04
| | | | | * doc/contributing.texi (The Perfect Setup): Show "guix package -i" command line.
* doc: Move "Packaging Guidelines" under "Contributing".Ludovic Courtès2019-01-22
| | | | | | * doc/guix.texi (Packaging Guidelines): Move to... * doc/contributing.texi (Packaging Guidelines): ... here. Turn into a section. Adjust references to "Contributing".
* doc: Replace @command by @code for packagesPierre Neidhardt2018-12-15
| | | | | * doc/contributing.texi (Submitting Patches): Replace @command by @code for packages.
* doc: Merge "discourage use of texlive" with existing paragraph on "guix size"Pierre Neidhardt2018-12-15
| | | | | * doc/contributing.texi (Submitting Patches): Merge "discourage use of texlive" with existing paragraph on "guix size".
* doc: Discourage the use of texlive as inputPierre Neidhardt2018-12-14
| | | | | * doc/contributing.texi (Submitting Patches): Discourage the use of texlive as input.
* Remove most references to hydra.gnu.org.Ludovic Courtès2018-12-04
| | | | | | | | | | | | | | | * Makefile.am (assert-binaries-available): Don't mention hydra.gnu.org in comment. * build-aux/check-available-binaries.scm: Likewise. * build-aux/check-final-inputs-self-contained.scm: Likewise. * doc/guix.texi (SUBSTITUTE-SERVER): New variable. Use it throughout instead of "mirror.hydra.gnu.org". * doc/contributing.texi (Submitting Patches): Likewise. * gnu/services/base.scm (hydra-key-authorization) (guix-activation): Remove mentions of "hydra.gnu.org" in comments and messages. * gnu/system/install.scm (%installation-services): Likewise. * guix/scripts/size.scm (guix-size): Likewise.
* doc: Mention that ./pre-inst-env is generated.Ludovic Courtès2018-11-16
| | | | | | | Suggested by swedebugia <swedebugia@riseup.net>. * doc/contributing.texi (Running Guix Before It Is Installed): Mention that ./pre-inst-env is generated.
* doc: Add recommendations for good origin URLs.Pierre Neidhardt2018-10-10
| | | | * doc/contributing.texi (Submitting Patches): URL recommendations.
generated by cgit v1.2.3 (git 2.45.0) at 2024-11-30 15:41:13 +0000