diff options
| author | Ludovic Courtès <ludo@gnu.org> | 2025-07-01 22:58:58 +0200 |
|---|---|---|
| committer | Ludovic Courtès <ludo@gnu.org> | 2025-07-01 23:21:32 +0200 |
| commit | 04e80066a2ecb90b3cd75200e758aa071222fcd3 (patch) | |
| tree | be59e39337e9bb5b32fb9f4b8bc722450953b770 /doc/contributing.texi | |
| parent | c4b332bfc1579dfd1b7b2bbf6d56ac16526ffc7e (diff) | |
doc: More typographical tweaks for “Bulk Updates” section.
* 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
Diffstat (limited to 'doc/contributing.texi')
| -rw-r--r-- | doc/contributing.texi | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi index 0649e3b2e1b..670e9498515 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -1099,7 +1099,7 @@ needed is to review and apply the patch. * Synopses and Descriptions:: Helping users find the right package. * Snippets versus Phases:: Whether to use a snippet, or a build phase. * 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. * Python Modules:: A touch of British comedy. * 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 called at the top level. -@node Bulk updates -@subsection Bulk updates +@node Bulk Updates +@subsection Bulk Updates @cindex packaging, maintenance Sometimes you may need to update a monotonic collection of grouped packages, in a particular module---e.g., @code{(gnu packages astronomy)}. 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 following technique. @@ -1442,9 +1442,9 @@ already ran @code{bootstrap} and @code{configure}: @example ~$ 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 etc/commiter.scm +> ./pre-inst-env etc/committer.scm @end example 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 collection has no regressions and can still be built successfully: @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@}') @end example |
