From 24057dcb6a5d33806de66de1e42137eca398350e Mon Sep 17 00:00:00 2001 From: Jade Lovelace Date: Thu, 6 Jun 2024 02:08:20 -0700 Subject: 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 --- doc/manual/rl-next-dev/build-timing-analysis.md | 15 --------------- doc/manual/rl-next/build-timing-analysis.md | 22 ++++++++++++++++++++++ flake.nix | 2 -- maintainers/build-release-notes.py | 2 +- misc/pre-commit.nix | 2 +- 5 files changed, 24 insertions(+), 19 deletions(-) delete mode 100644 doc/manual/rl-next-dev/build-timing-analysis.md create mode 100644 doc/manual/rl-next/build-timing-analysis.md diff --git a/doc/manual/rl-next-dev/build-timing-analysis.md b/doc/manual/rl-next-dev/build-timing-analysis.md deleted file mode 100644 index e59f3ca02..000000000 --- a/doc/manual/rl-next-dev/build-timing-analysis.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -synopsis: Clang build timing analysis -cls: 587 ---- - -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. - -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 -build time. - -You can also look at individual object files' traces in -. diff --git a/doc/manual/rl-next/build-timing-analysis.md b/doc/manual/rl-next/build-timing-analysis.md new file mode 100644 index 000000000..1bf803dab --- /dev/null +++ b/doc/manual/rl-next/build-timing-analysis.md @@ -0,0 +1,22 @@ +--- +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` 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 +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 = { -- cgit v1.2.3