From 24057dcb6a5d33806de66de1e42137eca398350e Mon Sep 17 00:00:00 2001 From: Jade Lovelace Date: Thu, 6 Jun 2024 02:08:20 -0700 Subject: [PATCH] Remove rl-next-dev We realized that there's really no good place to put these dev facing bulletins, and the user-facing release notes aren't really the worst place to put them, I guess, and we do kind of hope that it converts users to devs. Change-Id: Id9387b2964fe291cb5a3f74ad6344157f19b540c --- .../{rl-next-dev => rl-next}/build-timing-analysis.md | 9 ++++++++- flake.nix | 2 -- maintainers/build-release-notes.py | 2 +- misc/pre-commit.nix | 2 +- 4 files changed, 10 insertions(+), 5 deletions(-) rename doc/manual/{rl-next-dev => rl-next}/build-timing-analysis.md (59%) diff --git a/doc/manual/rl-next-dev/build-timing-analysis.md b/doc/manual/rl-next/build-timing-analysis.md similarity index 59% rename from doc/manual/rl-next-dev/build-timing-analysis.md rename to doc/manual/rl-next/build-timing-analysis.md index e59f3ca02..1bf803dab 100644 --- a/doc/manual/rl-next-dev/build-timing-analysis.md +++ b/doc/manual/rl-next/build-timing-analysis.md @@ -1,11 +1,13 @@ --- synopsis: Clang build timing analysis cls: 587 +category: Development --- We now have Clang build profiling available, which generates Chrome tracing files for each compilation unit. To enable it, run `meson configure -build -Dprofile-build=enabled` then rerun the compilation. +build -Dprofile-build=enabled` in a Clang stdenv (`nix develop +.#native-clangStdenvPackages`) then rerun the compilation. If you want to make the build go faster, do a clang build with meson, then run `maintainers/buildtime_report.sh build`, then contemplate how to improve the @@ -13,3 +15,8 @@ build time. You can also look at individual object files' traces in . + +See [the wiki page][improving-build-times-wiki] for more details on how to do +this. + +[improving-build-times-wiki]: https://wiki.lix.systems/link/8#bkmrk-page-title diff --git a/flake.nix b/flake.nix index 66b836f03..d0b674464 100644 --- a/flake.nix +++ b/flake.nix @@ -227,7 +227,6 @@ in { user = rl-next-check "rl-next" ./doc/manual/rl-next; - dev = rl-next-check "rl-next-dev" ./doc/manual/rl-next-dev; } ); @@ -309,7 +308,6 @@ perlBindings = self.hydraJobs.perlBindings.${system}; nixpkgsLibTests = self.hydraJobs.tests.nixpkgsLibTests.${system}; rl-next = self.hydraJobs.rl-next.${system}.user; - rl-next-dev = self.hydraJobs.rl-next.${system}.dev; # Will be empty attr set on i686-linux, and filtered out by forAvailableSystems. pre-commit = self.hydraJobs.pre-commit.${system}; } diff --git a/maintainers/build-release-notes.py b/maintainers/build-release-notes.py index 45d5d6ff9..c8905cde0 100644 --- a/maintainers/build-release-notes.py +++ b/maintainers/build-release-notes.py @@ -1,6 +1,5 @@ from collections import defaultdict import frontmatter -import sys import pathlib import textwrap from typing import Any, Tuple @@ -27,6 +26,7 @@ CATEGORIES = [ 'Improvements', 'Fixes', 'Packaging', + 'Development', 'Miscellany', ] diff --git a/misc/pre-commit.nix b/misc/pre-commit.nix index 4f54141b3..292940e83 100644 --- a/misc/pre-commit.nix +++ b/misc/pre-commit.nix @@ -63,7 +63,7 @@ pre-commit-run { files = ''^doc/manual/(change-authors\.yml|rl-next(-dev)?)''; pass_filenames = false; entry = '' - ${lib.getExe pkgs.build-release-notes} --change-authors doc/manual/change-authors.yml doc/manual/rl-next doc/manual/rl-next-dev + ${lib.getExe pkgs.build-release-notes} --change-authors doc/manual/change-authors.yml doc/manual/rl-next ''; }; change-authors-sorted = {