magic first line tells emacs to use utf8+bom

Add ".. -*- coding: utf-8-with-signature -*-" to the first line of each .rst
file. This tells emacs to treat the file contents as utf-8, and also to prepend
a so-called utf-8 "bom" marker at the beginning of the file. This patch also
prepends those markers to each of those files.

diff --git a/COPYING.TGPPL.rst b/COPYING.TGPPL.rst
index e89b079fefaed20eceaa4f99da4f0972b6840072..5bcf0aa26b443e106a47306e95fb25e018881808 100644 (file)
--- a/COPYING.TGPPL.rst
+++ b/COPYING.TGPPL.rst
@@ -1,4 +1,6 @@
-This work also comes with the added permission that you may combine it with a
+.. -*- coding: utf-8-with-signature -*-
+
+This work also comes with the added permission that you may combine it with a
 work licensed under the OpenSSL license (any version) and distribute the
 resulting combined work, as long as you follow the requirements of the
 licences of this work in regard to all of the resulting combined work

diff --git a/NEWS.rst b/NEWS.rst
index 49f9eaf66d8a2a68f01bb38c462c0b876bd30e65..92182e4d52bbb0bcbdb4e5d4406c6da04499b049 100644 (file)
--- a/NEWS.rst
+++ b/NEWS.rst
@@ -1,4 +1,6 @@
-==================================
+.. -*- coding: utf-8-with-signature -*-
+
+==================================
 User-Visible Changes in Tahoe-LAFS
 ==================================
 

diff --git a/docs/about.rst b/docs/about.rst
index 6e238882424a42686367dd921abf8839b5ab3579..c9594e27eeb8981c743da6283da647f81e2bf4cb 100644 (file)
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -1,6 +1,4 @@
-
-
-.. -*- coding: utf-8 -*-
+.. -*- coding: utf-8-with-signature -*-
 
 Welcome to Tahoe-LAFS!
 ======================

diff --git a/docs/architecture.rst b/docs/architecture.rst
index 85acb31d670a5be896c2f688ed16e1694def9155..98c70faae134698bb548b57e8ffebb1f95b6246a 100644 (file)
--- a/docs/architecture.rst
+++ b/docs/architecture.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =======================
 Tahoe-LAFS Architecture
 =======================

diff --git a/docs/backdoors.rst b/docs/backdoors.rst
index 031c87157de4d8295ee24b9070037f71f5c2d2af..97716fcadf83122ed7fd3678fab5e762760bf736 100644 (file)
--- a/docs/backdoors.rst
+++ b/docs/backdoors.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 Statement on Backdoors
 ======================
 

diff --git a/docs/backupdb.rst b/docs/backupdb.rst
index 5a36b5183bc5326f8233d361514773b7e8f0b27a..659c2fd7b5cf4de4a56dd8bb052fdcd2514abc6d 100644 (file)
--- a/docs/backupdb.rst
+++ b/docs/backupdb.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ==================
 The Tahoe BackupDB
 ==================

diff --git a/docs/cautions.rst b/docs/cautions.rst
index 7aee35c072649fbe1232bb5ca3c4fed4cda3a039..ae0281f953b1e5584dfdc4dba41fde9d6032b986 100644 (file)
--- a/docs/cautions.rst
+++ b/docs/cautions.rst
@@ -1,4 +1,5 @@
-
+.. -*- coding: utf-8-with-signature -*-
+
 =======================================================
  Things To Be Careful About As We Venture Boldly Forth
 =======================================================

diff --git a/docs/configuration.rst b/docs/configuration.rst
index f3db298017113d72c162f94c1d7f8caeef22b460..a0022df6781a0d85695374c0bcb98c184d3a8a9d 100644 (file)
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =============================
 Configuring a Tahoe-LAFS node
 =============================

diff --git a/docs/convergence-secret.rst b/docs/convergence-secret.rst
index d4fe51178685144a9157c2d937f7b63b2e73cbfa..e94392bbe490071a530706a183919d61a03809f8 100644 (file)
--- a/docs/convergence-secret.rst
+++ b/docs/convergence-secret.rst
@@ -1,4 +1,4 @@
-
+.. -*- coding: utf-8-with-signature -*-
 
 What Is It?
 -----------

diff --git a/docs/debian.rst b/docs/debian.rst
index cee6b445e95f5dc6c6c5f90b6fb8ad5096323bb0..31aabff31db68cfe5039f0a8234197e57e81f8fd 100644 (file)
--- a/docs/debian.rst
+++ b/docs/debian.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =========================
 Debian and Ubuntu Support
 =========================

diff --git a/docs/filesystem-notes.rst b/docs/filesystem-notes.rst
index 6128e20440af9f18b325dc8173422f9eda91c4b7..9c019fbb35a3e581c05c88446122d71a0bcb48d4 100644 (file)
--- a/docs/filesystem-notes.rst
+++ b/docs/filesystem-notes.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =========================
 Filesystem-specific notes
 =========================

diff --git a/docs/frontends/CLI.rst b/docs/frontends/CLI.rst
index ebeb34c91edfd766fe7adbda1b040a019e239184..96927dbedea664336b3ae72a4385fdade178627f 100644 (file)
--- a/docs/frontends/CLI.rst
+++ b/docs/frontends/CLI.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ===========================
 The Tahoe-LAFS CLI commands
 ===========================

diff --git a/docs/frontends/FTP-and-SFTP.rst b/docs/frontends/FTP-and-SFTP.rst
index acec6c84df1d0bff4d0a22dcb378ca82bc7f92a9..3b418a57ad6188176d7a3cce3d2f9a184bf220ea 100644 (file)
--- a/docs/frontends/FTP-and-SFTP.rst
+++ b/docs/frontends/FTP-and-SFTP.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =================================
 Tahoe-LAFS SFTP and FTP Frontends
 =================================

diff --git a/docs/frontends/download-status.rst b/docs/frontends/download-status.rst
index 4de60f54e6f6b3405f1c165f90102dcc4ad97ebf..cc82551a9963169ec3803635b8fc690b5c97b769 100644 (file)
--- a/docs/frontends/download-status.rst
+++ b/docs/frontends/download-status.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ===============
 Download status
 ===============

diff --git a/docs/frontends/drop-upload.rst b/docs/frontends/drop-upload.rst
index 0cc6be2192b91457a3a6eb4e8dae1e79e3acaecf..8d92052c48682dc9461f123cb8474fc3a591cd6e 100644 (file)
--- a/docs/frontends/drop-upload.rst
+++ b/docs/frontends/drop-upload.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ===============================
 Tahoe-LAFS Drop-Upload Frontend
 ===============================

diff --git a/docs/frontends/webapi.rst b/docs/frontends/webapi.rst
index 046d2c59e493cf795937895a7c2c4a57013694ab..1d3b33c68002f87ce125cc4263b58257c0131fef 100644 (file)
--- a/docs/frontends/webapi.rst
+++ b/docs/frontends/webapi.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ==========================
 The Tahoe REST-ful Web API
 ==========================

diff --git a/docs/garbage-collection.rst b/docs/garbage-collection.rst
index f1ae44cc1a77e993adea2a50a29d165c019be08d..716dcdc29f98eaf2a1e4368c039e3916d8f0789a 100644 (file)
--- a/docs/garbage-collection.rst
+++ b/docs/garbage-collection.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ===========================
 Garbage Collection in Tahoe
 ===========================

diff --git a/docs/helper.rst b/docs/helper.rst
index ae5d441877468cc374c297be68cccb33bd25503a..240db8a160b0b494c8af0b1c481cb80eaefeb223 100644 (file)
--- a/docs/helper.rst
+++ b/docs/helper.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =======================
 The Tahoe Upload Helper
 =======================

diff --git a/docs/historical/configuration.rst b/docs/historical/configuration.rst
index ca58b59f86afa905a60d3d6129cefd2eb28c0a4e..660bc8489d88d97ffdbf7ab432474d48b3279a9d 100644 (file)
--- a/docs/historical/configuration.rst
+++ b/docs/historical/configuration.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =======================
 Old Configuration Files
 =======================

diff --git a/docs/known_issues.rst b/docs/known_issues.rst
index 30918d6345530995234609bc0cace5455a52f7ce..af0e5b465e53f34487092882e51aeb60f174ec55 100644 (file)
--- a/docs/known_issues.rst
+++ b/docs/known_issues.rst
@@ -1,4 +1,5 @@
-
+.. -*- coding: utf-8-with-signature -*-
+
 See also `cautions.rst`_.
 
 .. _cautions.rst: cautions.rst

diff --git a/docs/logging.rst b/docs/logging.rst
index 8822787d655009148767d9722a066badec3f7f5c..4672e8f90bade5f3776f53383d9d8249b1c40a39 100644 (file)
--- a/docs/logging.rst
+++ b/docs/logging.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =============
 Tahoe Logging
 =============

diff --git a/docs/nodekeys.rst b/docs/nodekeys.rst
index 6ea5eb391c89a9e64a6e48e14535987e25809790..a5b73a99aa97c04736ed0d6741a8c5102e6076fd 100644 (file)
--- a/docs/nodekeys.rst
+++ b/docs/nodekeys.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =======================
 Node Keys in Tahoe-LAFS
 =======================

diff --git a/docs/performance.rst b/docs/performance.rst
index d9bd28ff59086756fe661ebc4f2d0c667a4b3588..6ddeb1fe8f319327295992920751f91f6cdb7264 100644 (file)
--- a/docs/performance.rst
+++ b/docs/performance.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ============================================
 Performance costs for some common operations
 ============================================

diff --git a/docs/proposed/leasedb.rst b/docs/proposed/leasedb.rst
index bbd0e92aa3ad0e7811d8fc3a8845912e3fc1a985..c0516c311f0c77f4c9b6a7285b3055c0983c9f13 100644 (file)
--- a/docs/proposed/leasedb.rst
+++ b/docs/proposed/leasedb.rst
@@ -1,4 +1,5 @@
-
+.. -*- coding: utf-8-with-signature -*-
+
 =====================
 Lease database design
 =====================

diff --git a/docs/quickstart.rst b/docs/quickstart.rst
index fda22c2c5864e70d8ef5981895cec4ad5da24b21..045913344af606b70d6e3929a89b3aeba01b4d33 100644 (file)
--- a/docs/quickstart.rst
+++ b/docs/quickstart.rst
@@ -1,4 +1,5 @@
-
+.. -*- coding: utf-8-with-signature -*-
+
 ==================
 Getting Tahoe-LAFS
 ==================

diff --git a/docs/running.rst b/docs/running.rst
index 50ad2cb42856b2868acc3f316739a9ef5ebf4f7d..0d3836e6cbae19df91838d3dd60539197cd2dbfe 100644 (file)
--- a/docs/running.rst
+++ b/docs/running.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =====================
 How To Run Tahoe-LAFS
 =====================

diff --git a/docs/specifications/URI-extension.rst b/docs/specifications/URI-extension.rst
index 6d40652ebb7f30a63a9fae34cdcfb3ec42117001..f225e510bdcba8ed5c56733072059159fdd10a7d 100644 (file)
--- a/docs/specifications/URI-extension.rst
+++ b/docs/specifications/URI-extension.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ===================
 URI Extension Block
 ===================

diff --git a/docs/specifications/backends/raic.rst b/docs/specifications/backends/raic.rst
index 92a4ec13bd0376f8c8818337304d0e115af6e4e9..ed88307ecd9509e958eca904c1362b852e994ae2 100644 (file)
--- a/docs/specifications/backends/raic.rst
+++ b/docs/specifications/backends/raic.rst
@@ -1,4 +1,5 @@
-
+.. -*- coding: utf-8-with-signature -*-
+
 =============================================================
 Redundant Array of Independent Clouds: Share To Cloud Mapping
 =============================================================

diff --git a/docs/specifications/dirnodes.rst b/docs/specifications/dirnodes.rst
index e68b02f68d7d834a70dcab28fc4aa593846ddf4d..4ea3ae4859fbfd858df7a8af4692e9ff08b666b7 100644 (file)
--- a/docs/specifications/dirnodes.rst
+++ b/docs/specifications/dirnodes.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ==========================
 Tahoe-LAFS Directory Nodes
 ==========================

diff --git a/docs/specifications/file-encoding.rst b/docs/specifications/file-encoding.rst
index 1f2ee7487085dd1d18f6e3adaaa8721d43fc8339..b11ef3294e657d8f65b82d655840e0894236447e 100644 (file)
--- a/docs/specifications/file-encoding.rst
+++ b/docs/specifications/file-encoding.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =============
 File Encoding
 =============

diff --git a/docs/specifications/mutable.rst b/docs/specifications/mutable.rst
index ea7ac49b3ba7489eda0aa68eb37d44e5a42dd702..09e25f32e03c2fd5fafc00cd5e4508f14e79ca36 100644 (file)
--- a/docs/specifications/mutable.rst
+++ b/docs/specifications/mutable.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 =============
 Mutable Files
 =============

diff --git a/docs/specifications/outline.rst b/docs/specifications/outline.rst
index 9ec69bff553f2941edda6f40221c483fd68fd854..6fb53492aabbfb07547a25fbe2cefc530d002407 100644 (file)
--- a/docs/specifications/outline.rst
+++ b/docs/specifications/outline.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ==============================
 Specification Document Outline
 ==============================

diff --git a/docs/specifications/servers-of-happiness.rst b/docs/specifications/servers-of-happiness.rst
index 7f0029bed29186e7eaadc9a2bfd69ce13092c1e1..18d384ae934d31e01921219acd0ed32f0c237b43 100644 (file)
--- a/docs/specifications/servers-of-happiness.rst
+++ b/docs/specifications/servers-of-happiness.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ====================
 Servers of Happiness
 ====================

diff --git a/docs/specifications/uri.rst b/docs/specifications/uri.rst
index b05be23bf7942b59e66c0d7c8f1247f1b6e5ee7b..1953a111f538cced4afbbb27565d45afc0a1425c 100644 (file)
--- a/docs/specifications/uri.rst
+++ b/docs/specifications/uri.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ==========
 Tahoe URIs
 ==========

diff --git a/docs/stats.rst b/docs/stats.rst
index 1a4699d04845f8b4acb3b51c37418e12a48425f7..76310841b6905cf42fa4b3667bfeb594f45d71af 100644 (file)
--- a/docs/stats.rst
+++ b/docs/stats.rst
@@ -1,4 +1,6 @@
-================
+.. -*- coding: utf-8-with-signature -*-
+
+================
 Tahoe Statistics
 ================
 

diff --git a/docs/write_coordination.rst b/docs/write_coordination.rst
index e855aec42d419179053d9e179d9719b5d6c2b520..4c0d319d3ea284e46a4f6bade8425799d25124c3 100644 (file)
--- a/docs/write_coordination.rst
+++ b/docs/write_coordination.rst
@@ -1,3 +1,5 @@
+.. -*- coding: utf-8-with-signature -*-
+
 ==================================
 Avoiding Write Collisions in Tahoe
 ==================================