amaharaneko/guix-mirrors
1
1
Fork 0
mirror of https://codeberg.org/guix/guix.git synced 2025-10-02 02:15:12 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: More typographical tweaks for “Bulk Updates” section.

Browse source 
* doc/contributing.texi (Bulk Updates): Capitalize title.  Leave two
spaces after end-of-sentence period.  Use @dots{} instead of showing
full store file names, as per ‘assert-no-store-file-names’ target.
Fix typo.

Change-Id: Iceb0079ec35fda95280afff1c0d4b2cd84717b96
This commit is contained in:
Ludovic Courtès 2025-07-01 22:58:58 +02:00
parent c4b332bfc1
commit 04e80066a2
No known key found for this signature in database
GPG key ID: 090B11993D9AEBB5
1 changed files with 7 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

14
doc/contributing.texi
View file

@ -1099,7 +1099,7 @@ needed is to review and apply the patch.
* Synopses and Descriptions:: Helping users find the right package. * Synopses and Descriptions:: Helping users find the right package.
* Snippets versus Phases:: Whether to use a snippet, or a build phase. * Snippets versus Phases:: Whether to use a snippet, or a build phase.
* Cyclic Module Dependencies:: Going full circle. * Cyclic Module Dependencies:: Going full circle.
* Bulk updates:: This Little Maneuver's Gonna Cost Us 51 Years * Bulk Updates:: This Little Maneuver's Gonna Cost Us 51 Years.
* Emacs Packages:: Your Elisp fix. * Emacs Packages:: Your Elisp fix.
* Python Modules:: A touch of British comedy. * Python Modules:: A touch of British comedy.
* Perl Modules:: Little pearls. * Perl Modules:: Little pearls.
@ -1426,14 +1426,14 @@ Care would need to be taken to ensure the above procedure is only ever
used in a package delayed fields or within another procedure also not used in a package delayed fields or within another procedure also not
called at the top level. called at the top level.
@node Bulk updates @node Bulk Updates
@subsection Bulk updates @subsection Bulk Updates
@cindex packaging, maintenance @cindex packaging, maintenance
Sometimes you may need to update a monotonic collection of grouped Sometimes you may need to update a monotonic collection of grouped
packages, in a particular module---e.g., @code{(gnu packages astronomy)}. packages, in a particular module---e.g., @code{(gnu packages astronomy)}.
Doing so requires refreshing package versions, creating commits Doing so requires refreshing package versions, creating commits
following guidelines and testing them. Let's say there are 200+ packages following guidelines and testing them. Let's say there are 200+ packages
with fresh versions, you may deal with this task by applying the with fresh versions, you may deal with this task by applying the
following technique. following technique.
@ -1442,9 +1442,9 @@ already ran @code{bootstrap} and @code{configure}:
@example @example
~$ guix shell --development guix ~$ guix shell --development guix
[env: /gnu/store/lzxbi1ps43msyw7m5wblziy8mj6hw5kw-profile] [env: /gnu/store/@dots{}-profile]
> ./pre-inst-env guix refresh --select=module:astronomy --update > ./pre-inst-env guix refresh --select=module:astronomy --update
> ./pre-inst-env etc/commiter.scm > ./pre-inst-env etc/committer.scm
@end example @end example
The first command updates all packages in @code{(gnu packages The first command updates all packages in @code{(gnu packages
@ -1456,7 +1456,7 @@ corresponding commits with the correct style.
If your machine is powerful enough, you may check that the whole If your machine is powerful enough, you may check that the whole
collection has no regressions and can still be built successfully: collection has no regressions and can still be built successfully:
@example @example
[env: /gnu/store/lzxbi1ps43msyw7m5wblziy8mj6hw5kw-profile] [env: /gnu/store/@dots{}-profile]
> ./pre-inst-env guix build $(./pre-inst-env guix package -A | awk '/astronomy.scm/@{print $1"@@"$2@}') > ./pre-inst-env guix build $(./pre-inst-env guix package -A | awk '/astronomy.scm/@{print $1"@@"$2@}')
@end example @end example