Skip to content

Commit 4e5b195

Browse files
committed
Update freezing.rst
1 parent 1255d8f commit 4e5b195

File tree

1 file changed

+17
-13
lines changed

1 file changed

+17
-13
lines changed

docs/shipping/freezing.rst

Lines changed: 17 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -4,21 +4,25 @@
44
Freezing Your Code
55
==================
66

7-
To 'Freeze' your code is to distribute to end-users as an executable which
8-
includes a bundled Python interpreter.
7+
'Freezing' your code is creating a single-file executable file to distribute
8+
to end-users, that contains all of your application code as well as the
9+
Python interpreter.
910

10-
Applications such as 'Dropbox', BitTorrent clients, 'Eve Online' and
11-
'Civilisation IV' do this.
11+
Applications such as 'Dropbox', 'Eve Online', 'Civilisation IV', and
12+
BitTorrent clients do this.
1213

13-
The advantage of distributing this way is that your application will work even
14-
if the user doesn't already have the required version of Python installed. On
15-
Windows, and even on many Linux distributions and OSX versions, the right
14+
The advantage of distributing this way is that your application will "just work",
15+
even if the user doesn't already have the required version of Python installed.
16+
On Windows, and even on many Linux distributions and OS X, the right
1617
version of Python will not already be installed.
1718

18-
One disadvantage is that it will bloat your distribution by about 2MB.
19-
Another problem is that your application will not receive any security updates
20-
to the version of Python it uses unless you freeze a new version and get
21-
users to download it.
19+
Besides, end-user software should always be in an executable format. Files
20+
ending in ``.py`` are for software engineers and system administrators.
21+
22+
One disadvantage of freezing is that it will increase the size of your
23+
distribution by about 2–12MB. Also, you will be responsible for shipping
24+
updated versions of your application when security vulnerabilities to
25+
Python are patched.
2226

2327
Alternatives to Freezing
2428
------------------------
@@ -33,8 +37,8 @@ On Linux, an alternative to freezing is to
3337
.. todo:: Fill in "Freezing Your Code" stub
3438

3539

36-
Comparison
37-
----------
40+
Comparison of Freezing Tools
41+
----------------------------
3842

3943
Solutions and platforms/features supported:
4044

0 commit comments

Comments
 (0)