PageSourceSearch

https://pkl-lang.org/main/current/index.html

html pkl-lang.org collected 2026-09-24 18:03:29 UTC 23,948 bytes, 615 lines download raw bytes

1<!DOCTYPE html>
2<html lang="en">
3  <head>
4    <meta charset="utf-8">
5    <meta name="viewport" content="width=device-width,initial-scale=1">
6    <title>User Manual :: Pkl Docs</title>
7    <link rel="canonical" href="https://pkl-lang.org/main/current/index.html">
8    <link rel="next" href="introduction/index.html">
9    <meta name="generator" content="Antora 3.1.15">
10    <link rel="stylesheet" href="../../_/css/site.css">
11<link rel="stylesheet" href="../../_/css/theme-vars.css">
12<link rel="stylesheet" href="../../_/css/theme-switch.css">
13<link rel="stylesheet" href="../../_/css/site-extra.css">
14<link rel="stylesheet" href="../../_/css/search.css">
15<link rel="stylesheet" href="../../_/css/syntax-highlights.css">
16<link rel="stylesheet" href="../../_/css/vendor/tabs.css">
17<link rel="icon" type="image/svg+xml" href="../../_/img/favicon.svg">
18<link rel="apple-touch-icon" sizes="180x180" href="../../_/img/apple-touch-icon.png">
19<link rel="icon" type="image/png" sizes="32x32" href="../../_/img/favicon-32x32.png">
20<link rel="icon" type="image/png" sizes="16x16" href="../../_/img/favicon-16x16.png">
21<script src="../../_/js/theme-switcher.js"></script>
21
22  </head>
23  <body class="article">
24<header class="header">
25  <nav class="navbar">
26    <div class="navbar-brand">
27      <div class="navbar-item">
28        <a href="../../index.html"><img src="../../_/img/favicon.svg" alt="Pkl" height="35" width="35"/></a>
29        <a href="../../index.html">Pkl</a>
30        <span class="separator">//</span>
31        <a href="../../main/current/index.html">Docs</a>
32      </div>
33      <button class="navbar-burger" aria-controls="topbar-nav" aria-expanded="false" aria-label="Toggle main menu">
34          <span></span>
35          <span></span>
36          <span></span>
37      </button>
38    </div>
39    <div id="topbar-nav" class="navbar-menu">
40      <div class="navbar-item search hide-for-print">
41        <div id="search-field" class="field">
42          <input id="search-input" type="text" placeholder="Enter Search Term">
43        </div>
44      </div>
45      <div class="navbar-end">
46        <a class="navbar-item" href="../../main/current/index.html">Language</a>
47        <div class="navbar-item has-dropdown is-hoverable">
48          <a href="../../main/current/language-bindings.html" class="navbar-link">Bindings</a>
49          <div class="navbar-dropdown">
50            <a class="navbar-item" href="../../main/current/java-binding/index.html">Java</a>
51            <a class="navbar-item" href="../../main/current/kotlin-binding/index.html">Kotlin</a>
52            <a class="navbar-item" href="../../swift/current/index.html">Swift</a>
53            <a class="navbar-item" href="../../go/current/index.html">Go</a>
54          </div>
55        </div>
56        <div class="navbar-item has-dropdown is-hoverable">
57          <a href="../../main/current/integrations.html" class="navbar-link">Frameworks</a>
58          <div class="navbar-dropdown">
59            <a class="navbar-item" href="../../spring/current/index.html">Spring (Boot)</a>
60          </div>
61        </div>
62        <div class="navbar-item has-dropdown is-hoverable">
63          <a href="../../main/current/tools.html" class="navbar-link">Editors</a>
64          <div class="navbar-dropdown">
65            <a class="navbar-item" href="../../intellij/current/index.html">IntelliJ</a>
66            <a class="navbar-item" href="../../neovim/current/index.html">Neovim</a>
67            <a class="navbar-item" href="../../vscode/current/index.html">VS Code</a>
68            <a class="navbar-item" href="../../lsp/current/index.html">Pkl Language Server</a>
69          </div>
70        </div>
71        <div class="navbar-item has-dropdown is-hoverable">
72          <a href="../../main/current/resources.html" class="navbar-link">Resources</a>
73          <div class="navbar-dropdown">
74            <a class="navbar-item" href="https://github.com/apple/pkl">GitHub</a>
75            <a class="navbar-item" href="https://pkl-lang.org/package-docs/pkl/current/index.html">Standard Library</a>
76            <a class="navbar-item" href="https://pkl-lang.org/package-docs/">Package Docs</a>
77            <a class="navbar-item" href="../../main/current/style-guide/index.html">Style Guide</a>
78            <a class="navbar-item" href="../../security.html">Security</a>
79          </div>
80        </div>
81        <div class="navbar-item has-dropdown is-hoverable">
82          <a href="../../community.html" class="navbar-link">Community</a>
83          <div class="navbar-dropdown is-right">
84            <a class="navbar-item" href="https://github.com/apple/pkl/discussions" target="_blank">GitHub Discussions</a>
85            <a class="navbar-item" href="../../blog/index.html">Blog</a>
86          </div>
87        </div>
88      </div>
89    </div>
90  </nav>
91</header>
92<div class="body">
93<div class="nav-container" data-component="main" data-version="0.32.1">
94  <aside class="nav">
95    <div class="panels">
96<div class="nav-panel-menu is-active" data-panel="menu">
97  <nav class="nav-menu">
98    <button class="nav-menu-toggle" aria-label="Toggle expand/collapse all" style="display: none"></button>
99    <h3 class="title"><a href="index.html">Main Project</a></h3>
100<ul class="nav-list">
101  <li class="nav-item" data-depth="0">
102<ul class="nav-list">
103  <li class="nav-item" data-depth="1">
104    <button class="nav-item-toggle"></button>
105    <a class="nav-link" href="introduction/index.html">Introduction</a>
106<ul class="nav-list">
107  <li class="nav-item" data-depth="2">
108    <a class="nav-link" href="introduction/use-cases.html">Use Cases</a>
109  </li>
110  <li class="nav-item" data-depth="2">
111    <a class="nav-link" href="introduction/concepts.html">Concepts</a>
112  </li>
113  <li class="nav-item" data-depth="2">
114    <a class="nav-link" href="introduction/comparison.html">Comparison</a>
115  </li>
116</ul>
117  </li>
118  <li class="nav-item" data-depth="1">
119    <a class="nav-link" href="pkl-cli/index.html#installation">Installation</a>
120  </li>
121  <li class="nav-item" data-depth="1">
122    <button class="nav-item-toggle"></button>
123    <a class="nav-link" href="language-tutorial/index.html">
123Tutorial</a>
124<ul class="nav-list">
125  <li class="nav-item" data-depth="2">
126    <a class="nav-link" href="language-tutorial/01_basic_config.html">Basic Configuration</a>
127  </li>
128  <li class="nav-item" data-depth="2">
129    <a class="nav-link" href="language-tutorial/02_filling_out_a_template.html">Filling out a Template</a>
130  </li>
131  <li class="nav-item" data-depth="2">
132    <a class="nav-link" href="language-tutorial/03_writing_a_template.html">Writing a Template</a>
133  </li>
134</ul>
135  </li>
136  <li class="nav-item" data-depth="1">
137    <button class="nav-item-toggle"></button>
138    <a class="nav-link" href="language.html">Language</a>
139<ul class="nav-list">
140  <li class="nav-item" data-depth="2">
141    <a class="nav-link" href="language-reference/index.html">Language Reference</a>
142  </li>
143  <li class="nav-item" data-depth="2">
144    <a class="nav-link" href="standard-library.html">Standard Library</a>
145  </li>
146  <li class="nav-item" data-depth="2">
147    <button class="nav-item-toggle"></button>
148    <a class="nav-link" href="language-bindings.html">Language Bindings</a>
149<ul class="nav-list">
150  <li class="nav-item" data-depth="3">
151    <button class="nav-item-toggle"></button>
152    <a class="nav-link" href="java-binding/index.html">Java</a>
153<ul class="nav-list">
154  <li class="nav-item" data-depth="4">
155    <a class="nav-link" href="java-binding/codegen.html">Code Generator</a>
156  </li>
157  <li class="nav-item" data-depth="4">
158    <a class="nav-link" href="pkl-core/index.html">pkl-core Library</a>
159  </li>
160  <li class="nav-item" data-depth="4">
161    <a class="nav-link" href="java-binding/pkl-config-java.html">pkl-config-java Library</a>
162  </li>
163</ul>
164  </li>
165  <li class="nav-item" data-depth="3">
166    <button class="nav-item-toggle"></button>
167    <a class="nav-link" href="kotlin-binding/index.html">Kotlin</a>
168<ul class="nav-list">
169  <li class="nav-item" data-depth="4">
170    <a class="nav-link" href="kotlin-binding/codegen.html">Code Generator</a>
171  </li>
172  <li class="nav-item" data-depth="4">
173    <a class="nav-link" href="kotlin-binding/pkl-config-kotlin.html">pkl-config-kotlin Library</a>
174  </li>
175</ul>
176  </li>
177  <li class="nav-item" data-depth="3">
178    <a class="nav-link" href="../../swift/current/index.html">Swift</a>
179  </li>
180  <li class="nav-item" data-depth="3">
181    <a class="nav-link" href="../../go/current/index.html">Go</a>
182  </li>
183  <li class="nav-item" data-depth="3">
184    <button class="nav-item-toggle"></button>
185    <a class="nav-link" href="bindings-specification/index.html">Specification</a>
186<ul class="nav-list">
187  <li class="nav-item" data-depth="4">
188    <a class="nav-link" href="bindings-specification/message-passing-api.html">Message Passing API</a>
189  </li>
190  <li class="nav-item" data-depth="4">
191    <a class="nav-link" href="bindings-specification/binary-encoding.html">Pkl Binary Encoding</a>
192  </li>
193</ul>
194  </li>
195</ul>
196  </li>
197</ul>
198  </li>
199  <li class="nav-item" data-depth="1">
200    <button class="nav-item-toggle"></button>
201    <a class="nav-link" href="tools.html">Tools</a>
202<ul class="nav-list">
203  <li class="nav-item" data-depth="2">
204    <a class="nav-link" href="pkl-cli/index.html">CLI</a>
205  </li>
206  <li class="nav-item" data-depth="2">
207    <a class="nav-link" href="pkl-doc/index.html">Pkldoc</a>
208  </li>
209  <li class="nav-item" data-depth="2">
210    <a class="nav-link" href="pkl-gradle/index.html">Gradle Plugin</a>
211  </li>
212  <li class="nav-item" data-depth="2">
213    <button class="nav-item-toggle"></button>
214    <span class="nav-text">Editor support</span>
215<ul class="nav-list">
216  <li class="nav-item" data-depth="3">
217    <a class="nav-link" href="../../intellij/current/index.html">IntelliJ</a>
218  </li>
219  <li class="nav-item" data-depth="3">
220    <a class="nav-link" href="../../vscode/current/index.html">VSCode</a>
221  </li>
222  <li class="nav-item" data-depth="3">
223    <a class="nav-link" href="../../neovim/current/index.html">Neovim</a>
224  </li>
225</ul>
226  </li>
227</ul>
228  </li>
229  <li class="nav-item" data-depth="1">
230    <a class="nav-link" href="examples.html">Examples</a>
231  </li>
232  <li class="nav-item" data-depth="1">
233    <a class="nav-link" href="evolution-and-roadmap.html">Evolution and Roadmap</a>
234  </li>
235  <li class="nav-item" data-depth="1">
236    <button class="nav-item-toggle"></button>
237    <a class="nav-link" href="release-notes/index.html">Release Notes</a>
238<ul class="nav-list">
239  <li class="nav-item" data-depth="2">
240    <a class="nav-link" href="release-notes/0.32.html">0.32 Release Notes</a>
241  </li>
242  <li class="nav-item" data-depth="2">
243    <a class="nav-link" href="release-notes/0.31.html">0.31 Release Notes</a>
244  </li>
245  <li class="nav-item" data-depth="2">
246    <a class="nav-link" href="release-notes/0.30.html">0.30 Release Notes</a>
247  </li>
248  <li class="nav-item" data-depth="2">
249    <a class="nav-link" href="release-notes/0.29.html">0.29 Release Notes</a>
250  </li>
251  <li class="nav-item" data-depth="2">
252    <a class="nav-link" href="release-notes/0.28.html">0.28 Release Notes</a>
253  </li>
254  <li class="nav-item" data-depth="2">
255    <a class="nav-link" href="release-notes/0.27.html">0.27 Release Notes</a>
256  </li>
257  <li class="nav-item" data-depth="2">
258    <a class="nav-link" href="release-notes/0.26.html">0.26 Release Notes</a>
259  </li>
260  <li class="nav-item" data-depth="2">
261    <a class="nav-link" href="release-notes/0.25.html">0.25 Release Notes</a>
262  </li>
263  <li class="nav-item" data-depth="2">
264    <a class="nav-link" href="release-notes/changelog.html">Changelog</a>
265  </li>
266</ul>
267  </li>
268</ul>
269  </li>
270</ul>
271  </nav>
272</div>
273<div class="nav-panel-explore" data-panel="explore">
274  <div class="context">
275    <span class="title">Main Project</span>
276    <span class="version">0.32.1</span>
277  </div>
278  <ul class="components">
279    <li class="component">
280      <div class="title"><a href="../../intellij/current/index.html">IntelliJ Plugin</a></div>
281      <ul class="versions">
282        <li class="version is-latest">
283          <a href="../../intellij/current/index.html">0.37.1</a>
284        </li>
285        <li class="version">
286          <a href="../../intellij/0.36.1/index.html">0.36.1</a>
287        </li>
288        <li class="version">
289          <a href="../../intellij/0.35.1/index.html">0.35.1</a>
290        </li>
291        <li class="version">
292          <a href="../../intellij/0.34.1/index.html">0.34.1</a>
293        </li>
294        <li class="version">
295          <a href="../../intellij/0.33.0/index.html">0.33.0</a>
296        </li>
297        <li class="version">
298          <a href="../../intellij/0.32.0/index.html">0.32.0</a>
299        </li>
300        <li class="version">
301          <a href="../../intellij/0.31.1/index.html">0.31.1</a>
302        </li>
303        <li class="version">
304          <a href="../../intellij/0.30.1/index.html">0.30.1</a>
305        </li>
306        <li class="version">
307          <a href="../../intellij/0.29.0/index.html">0.29.0</a>
308        </li>
309        <li class="version">
310          <a href="../../intellij/0.28.0/index.html">0.28.0</a>
311        </li>
312        <li class="version">
313          <a href="../../intellij/0.27.0/index.html">0.27.0</a>
314        </li>
315        <li class="version">
316          <a href="../../intellij/0.26.0/index.html">0.26.0</a>
317        </li>
318      </ul>
319    </li>
320    <li class="component is-current">
321      <div class="title"><a href="index.html">Main Project</a></div>
322      <ul class="versions">
323        <li class="version">
324          <a href="../latest/index.html">0.33.0-dev</a>
325        </li>
326        <li class="version is-current is-latest">
327          <a href="index.html">0.32.1</a>
328        </li>
329        <li class="version">
330          <a href="../0.31.1/index.html">0.31.1</a>
331        </li>
332        <li class="version">
333          <a href="../0.30.2/index.html">0.30.2</a>
334        </li>
335        <li class="version">
336          <a href="../0.29.1/index.html">0.29.1</a>
337        </li>
338        <li class="version">
339          <a href="../0.28.2/index.html">0.28.2</a>
340        </li>
341        <li class="version">
342          <a href="../0.27.2/index.html">0.27.2</a>
343        </li>
344        <li class="version">
345          <a href="../0.26.3/index.html">0.26.3</a>
346        </li>
347        <li class="version">
348          <a href="../0.25.3/index.html">0.25.3</a>
349        </li>
350      </ul>
351    </li>
352    <li class="component">
353      <div class="title"><a href="../../neovim/current/index.html">Neovim Plugin</a></div>
354      <ul class="versions">
355        <li class="version is-latest">
356          <a href="../../neovim/current/index.html">0.6.0</a>
357        </li>
358      </ul>
359    </li>
360    <li class="component">
361      <div class="title"><a href="../../blog/index.html">Pkl Blog</a></div>
362    </li>
363    <li class="component">
364      <div class="title"><a href="../../go/current/index.html">Pkl Go Bindings</a></div>
365      <ul class="versions">
366        <li class="version is-latest">
367          <a href="../../go/current/index.html">0.14.0</a>
368        </li>
369        <li class="version">
370          <a href="../../go/0.13.2/index.html">0.13.2</a>
371        </li>
372        <li class="version">
373          <a href="../../go/0.12.1/index.html">0.12.1</a>
374        </li>
375        <li class="version">
376          <a href="../../go/0.11.1/index.html">0.11.1</a>
377        </li>
378        <li class="version">
379          <a href="../../go/0.10.0/index.html">0.10.0</a>
380        </li>
381        <li class="version">
382          <a href="../../go/0.9.0/index.html">0.9.0</a>
383        </li>
384        <li class="version">
385          <a href="../../go/0.8.0/index.html">0.8.0</a>
386        </li>
387        <li class="version">
388          <a href="../../go/0.7.0/index.html">0.7.0</a>
389        </li>
390        <li class="version">
391          <a href="../../go/0.6.0/index.html">0.6.0</a>
392        </li>
393        <li class="version">
394          <a href="../../go/0.5.3/index.html">0.5.3</a>
395        </li>
396      </ul>
397    </li>
398    <li class="component">
399      <div class="title"><a href="../../lsp/current/index.html">Pkl Language Server</a></div>
400      <ul class="versions">
401        <li class="version is-latest">
402          <a href="../../lsp/current/index.html">0.8.0</a>
403        </li>
404        <li class="version">
405          <a href="../../lsp/0.7.1/index.html">0.7.1</a>
406        </li>
407        <li class="version">
408          <a href="../../lsp/0.6.0/index.html">0.6.0</a>
409        </li>
410        <li class="version">
411          <a href="../../lsp/0.5.1/index.html">0.5.1</a>
412        </li>
413        <li class="version">
414          <a href="../../lsp/0.4.0/index.html">0.4.0</a>
415        </li>
416        <li class="version">
417          <a href="../../lsp/0.3.2/index.html">0.3.2</a>
418        </li>
419        <li class="version">
420          <a href="../../lsp/0.2.0/index.html">0.2.0</a>
421        </li>
422        <li class="version">
423          <a href="../../lsp/0.1.2/index.html">
4230.1.2</a>
424        </li>
425      </ul>
426    </li>
427    <li class="component">
428      <div class="title"><a href="../../swift/current/index.html">Pkl Swift Bindings</a></div>
429      <ul class="versions">
430        <li class="version is-latest">
431          <a href="../../swift/current/index.html">0.10.0</a>
432        </li>
433        <li class="version">
434          <a href="../../swift/0.9.0/index.html">0.9.0</a>
435        </li>
436        <li class="version">
437          <a href="../../swift/0.8.2/index.html">0.8.2</a>
438        </li>
439        <li class="version">
440          <a href="../../swift/0.7.2/index.html">0.7.2</a>
441        </li>
442        <li class="version">
443          <a href="../../swift/0.6.0/index.html">0.6.0</a>
444        </li>
445        <li class="version">
446          <a href="../../swift/0.5.0/index.html">0.5.0</a>
447        </li>
448        <li class="version">
449          <a href="../../swift/0.4.2/index.html">0.4.2</a>
450        </li>
451        <li class="version">
452          <a href="../../swift/0.3.0/index.html">0.3.0</a>
453        </li>
454        <li class="version">
455          <a href="../../swift/0.2.3/index.html">0.2.3</a>
456        </li>
457      </ul>
458    </li>
459    <li class="component">
460      <div class="title"><a href="../../index.html">ROOT</a></div>
461    </li>
462    <li class="component">
463      <div class="title"><a href="../../spring/current/index.html">Spring Boot Integration</a></div>
464      <ul class="versions">
465        <li class="version is-latest">
466          <a href="../../spring/current/index.html">0.18.0</a>
467        </li>
468        <li class="version">
469          <a href="../../spring/0.17.1/index.html">0.17.1</a>
470        </li>
471        <li class="version">
472          <a href="../../spring/0.16.0/index.html">0.16.0</a>
473        </li>
474        <li class="version">
475          <a href="../../spring/0.15.0/index.html">0.15.0</a>
476        </li>
477      </ul>
478    </li>
479    <li class="component">
480      <div class="title"><a href="../../vscode/current/index.html">VS Code Extension</a></div>
481      <ul class="versions">
482        <li class="version is-latest">
483          <a href="../../vscode/current/index.html">0.23.1</a>
484        </li>
485        <li class="version">
486          <a href="../../vscode/0.22.0/index.html">0.22.0</a>
487        </li>
488        <li class="version">
489          <a href="../../vscode/0.21.0/index.html">0.21.0</a>
490        </li>
491        <li class="version">
492          <a href="../../vscode/0.20.0/index.html">0.20.0</a>
493        </li>
494        <li class="version">
495          <a href="../../vscode/0.19.0/index.html">0.19.0</a>
496        </li>
497        <li class="version">
498          <a href="../../vscode/0.18.2/index.html">0.18.2</a>
499        </li>
500        <li class="version">
501          <a href="../../vscode/0.17.0/index.html">0.17.0</a>
502        </li>
503        <li class="version">
504          <a href="../../vscode/0.16.0/index.html">0.16.0</a>
505        </li>
506        <li class="version">
507          <a href="../../vscode/0.11.0/index.html">0.11.0</a>
508        </li>
509      </ul>
510    </li>
511  </ul>
512</div>
513    </div>
514  </aside>
515</div>
516<main class="article">
517<div class="toolbar" role="navigation">
518<button class="nav-toggle"></button>
519  <a href="../../index.html" class="home-link"></a>
520<nav class="breadcrumbs" aria-label="breadcrumbs">
521  <ul>
522    <li><a href="index.html">Main Project</a></li>
523    <li><a href="index.html">User Manual</a></li>
524  </ul>
525</nav>
526<div class="page-versions">
527  <button class="version-menu-toggle" title="Show other versions of page">0.32.1</button>
528  <div class="version-menu">
529    <a class="version" href="../latest/index.html">0.33.0-dev</a>
530    <a class="version is-current" href="index.html">0.32.1</a>
531    <a class="version" href="../0.31.1/index.html">0.31.1</a>
532    <a class="version" href="../0.30.2/index.html">0.30.2</a>
533    <a class="version" href="../0.29.1/index.html">0.29.1</a>
534    <a class="version" href="../0.28.2/index.html">0.28.2</a>
535    <a class="version" href="../0.27.2/index.html">0.27.2</a>
536    <a class="version" href="../0.26.3/index.html">0.26.3</a>
537    <a class="version" href="../0.25.3/index.html">0.25.3</a>
538  </div>
539</div>
540<div class="edit-this-page"><a href="https://github.com/apple/pkl/edit/release/0.32/docs/modules/ROOT/pages/index.adoc">Edit this Page</a></div>
541</div>
542  <div class="content">
543<aside class="toc sidebar" data-title="Page Contents" data-levels="2">
544  <div class="toc-menu"></div>
545</aside>
546<article class="doc">
547<h1 class="page">User Manual</h1>
548<div class="paragraph">
549<p>Quick Links:
550<a href="pkl-cli/index.html#installation" class="xref page">Installation</a>
551| <a href="language-reference/index.html" class="xref page">Language Reference</a>
552| <a href="https://pkl-lang.org/package-docs/pkl/current/index.html">Standard Library</a></p>
553</div>
554<div class="paragraph">
555<p>Pkl&#8201;&#8212;&#8201;pronounced <em>Pickle</em>&#8201;&#8212;&#8201;is an embeddable configuration language which provides rich support for data templating and validation.
556It can be used from the command line, integrated in a build pipeline, or embedded in a program.
557Pkl scales from small to large, simple to complex, ad-hoc to repetitive configuration tasks.</p>
558</div>
559<div class="dlist">
560<dl>
561<dt class="hdlist1"><a href="introduction/index.html" class="xref page">Introduction</a></dt>
562<dd>
563<p>Why we created Pkl and what it can do for you.</p>
564</dd>
565<dt class="hdlist1"><a href="language.html" class="xref page">Language</a></dt>
566<dd>
567<p>Get to know the language and standard library.</p>
568</dd>
569<dt class="hdlist1"><a href="language-bindings.html" class="xref page">Bindings</a></dt>
570<dd>
571<p>Libraries for embedding Pkl into general-purpose languages.</p>
572</dd>
573<dt class="hdlist1"><a href="tools.html" class="xref page">Tools</a></dt>
574<dd>
575<p>CLI, Gradle plugin, code generators, and other tools.</p>
576</dd>
577<dt class="hdlist1"><a href="https://github.com/apple/pkl-jvm-examples">Examples</a></dt>
578<dd>
579<p>Ready-to-go examples with full source code.</p>
580</dd>
581<dt class="hdlist1"><a href="release-notes/index.html" class="xref page">Release Notes</a></dt>
582<dd>
583<p>What&#8217;s new in each release.</p>
584</dd>
585</dl>
586</div>
587<nav class="pagination">
588  <span class="next"><a href="introduction/index.html">Introduction</a></span>
589</nav>
590</article>
591  </div>
592</main>
593</div>
594<footer class="footer">
595  <div class="footer-content">
596    <p>Copyright © 2024-2025 Apple Inc. All rights reserved.</p>
597    <div class="theme-selector">
598      <label for="theme-select">Theme</label>
599      <select id="theme-select" class="theme-dropdown">
600        <option value="system">💻 System</option>
601        <option value="light">☀️ Light</option>
602        <option value="dark">
602🌙 Dark</option>
603      </select>
604    </div>
605  </div>
606</footer>
607<script src="../../_/js/site.js"></script>
vendor: 1 bytes, line 607
607
608<script src="../../_/js/site-support.js"></script>
vendor: 1 bytes, line 608
608
609<script async src="../../_/js/vendor/highlight.js"></script>
vendor: 1 bytes, line 609
609
610<script async src="../../_/js/vendor/tabs.js"></script>
vendor: 1 bytes, line 610
610
611<script src="../../_/js/vendor/lunr.js"></script>
vendor: 1 bytes, line 611
611
612<script src="../../_/js/search-ui.js" id="search-ui-script" data-site-root-path="../.." data-snippet-length="100" data-stylesheet="../../_/css/search.css"></script>
vendor: 1 bytes, line 612
612
613<script async src="../../search-index.js"></script>
613
614  </body>
615</html>

Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.