codesnip/Docs/Design/FileFormats/test-unit.html at develop · delphidabbler/codesnip · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
 * This Source Code Form is subject to the terms of the Mozilla Public License,
 * v. 2.0. If a copy of the MPL was not distributed with this file, You can
 * obtain one at https://mozilla.org/MPL/2.0/
 *
 * Copyright (C) 2012-2021, Peter Johnson (gravatar.com/delphidabbler).
 *
 * CodeSnip File Format Documentation: Test Units
-->
<html xmlns="https://www.w3.org/1999/xhtml" lang="en" xml:lang="en">

<head>

<title>
  CodeSnip File Format Documentation - Test Units
</title>

<link
  rel="stylesheet"
  type="text/css"
  media="screen"
  href="main.css"
/>

</head>

<body>

<div class="title">
  <div>
    DelphiDabbler CodeSnip
  </div>
  <div class="subtitle">
    File Format Documentation
  </div>
</div>

<h1>
  Test Units
</h1>

<h2>
  Introduction
</h2>

<p>
  CodeSnip saves temporary test units that are valid Pascal units. These units
  are used to perform test compiles.
</p>

<p>
  There is no specific file format for these files, other than they are valid
  Object Pascal source code.
</p>

<h2>
  Encoding
</h2>

<p>
  The encoding used for test units depends on the content of the unit.
</p>

<p>
  If the unit's source code contains only characters that are supported by the
  system default ANSI code page then the file is saved using that encoding.
</p>

<p>
  If the source code contains one or more characters that cannot be represented
  in the default ANSI code page then the file is saved as UTF-8, with byte order
  mark.
</p>

<p class="pullout">
  Note that files are saved using the ANSI default encoding if possible because
  earlier versions of Delphi cannot read UTF-8 encoded files and do not support
  Unicode characters in the source code. Versions of Delphi that permit Unicode
  characters in source code can read UTF-8 source files.
</p>

<p class="pullout">
  Unit filenames are limited to ANSI characters also for reasons of
  compatibility with earlier Delphis because they will report Unicode file names
  as &quot;not found&quot;.
</p>

</body>

</html>