You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+13-1Lines changed: 13 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,14 +19,19 @@ will not be reflected, unless you use `Revise`.
19
19
20
20
## For all changes
21
21
22
-
1. Run `make check-whitespace` before creating the PR to make sure you're not committing any whitespace errors.
22
+
1. Run `make fix-whitespace` before creating the PR to make sure you're not committing any whitespace errors.
23
23
24
24
## Building Julia
25
25
26
26
If you made changes to the runtime (any files in `src/`), you will need to rebuild
27
27
julia. Run `make -j` to rebuild julia. This process may take up to 10 minutes
28
28
depending on your changes.
29
29
30
+
After `make` run these static analysis checks:
31
+
-`make -C src clang-sa-<filename>` (replace `<filename>` with the basename of the file you modified)
32
+
-`make -C src clang-sagc-<filename>` which may require adding JL_GC_PUSH arguments, or JL_GC_PROMISE_ROOTED statements., or require fixing locks. Remember arguments are assumed rooted, so check the callers to make sure that is handled. If the value is being temporarily moved around in a struct or arraylist, `JL_GC_PROMISE_ROOTED(struct->field)` may be needed as a statement (it return void) immediately after reloading the struct before any use of struct. Put the promise as early in the code as is legal.
33
+
-`make -C src clang-tidy-<filename>`
34
+
30
35
## Using Revise
31
36
32
37
If you have made changes to files included in the system image (base/ or stdlib/),
@@ -76,6 +81,13 @@ When modifying external dependencies (patches in `deps/patches/` or version upda
76
81
- Prefer using the full upstream commit in `git am` format (e.g., `git format-patch`) which includes proper commit metadata
77
82
3. When updating dependency versions, ensure all associated patches still apply
78
83
84
+
### External JLLs
85
+
86
+
To update a JLL to the latest version:
87
+
- Update the version number in the appropriate jll folder
88
+
- If the dependencies in the upstream jll changed, update the Project.toml
89
+
- Run `make -f contrib/refresh_checksums.mk <jll>` to update the checksums. This may take a few minutes.
90
+
79
91
### Writing code
80
92
After writing code, look up the docstring for each function you used. If there
81
93
are recommendations or additional considerations that apply to these functions,
Copy file name to clipboardExpand all lines: NEWS.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,11 +75,13 @@ Standard library changes
75
75
#### REPL
76
76
77
77
* The display of `AbstractChar`s in the main REPL mode now includes LaTeX input information like what is shown in help mode ([#58181]).
78
+
* Display of repeated frames and cycles in stack traces has been improved by bracketing them in the trace and treating them consistently ([#55841]).
78
79
79
80
#### Test
80
81
81
82
* Test failures when using the `@test` macro now show evaluated arguments for all function calls ([#57825], [#57839]).
82
83
* Transparent test sets (`@testset let`) now show context when tests error ([#58727]).
84
+
*`@test_throws` now supports a three-argument form `@test_throws ExceptionType pattern expr` to test both exception type and message pattern in one call ([#59117]).
0 commit comments