Commit 4e5b195
committed
Update freezing.rst
1 parent 1255d8f commit 4e5b195
1 file changed
Lines changed: 17 additions & 13 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -4,21 +4,25 @@ | |||
| 4 | 4 | Freezing Your Code | |
| 5 | 5 | ================== | |
| 6 | 6 | ||
| 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. | ||
| 9 | 10 | ||
| 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. | ||
| 12 | 13 | ||
| 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 | ||
| 16 | 17 | version of Python will not already be installed. | |
| 17 | 18 | ||
| 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. | ||
| 22 | 26 | ||
| 23 | 27 | Alternatives to Freezing | |
| 24 | 28 | ------------------------ | |
@@ -33,8 +37,8 @@ On Linux, an alternative to freezing is to | |||
| 33 | 37 | .. todo:: Fill in "Freezing Your Code" stub | |
| 34 | 38 | ||
| 35 | 39 | ||
| 36 | - Comparison | ||
| 37 | - ---------- | ||
| 40 | + Comparison of Freezing Tools | ||
| 41 | + ---------------------------- | ||
| 38 | 42 | ||
| 39 | 43 | Solutions and platforms/features supported: | |
| 40 | 44 | ||
0 commit comments