summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBen Craig <bencraig@apache.org>2015-07-09 20:55:53 -0500
committerBen Craig <bencraig@apache.org>2015-07-09 20:55:53 -0500
commit012dd4e3fc1e75e3434f608ce2ba30dbd29c56cb (patch)
tree77b5e6dec0797cf27626f0b22e3d48df650ba6bf
parent3ea26be2ae08c2c7992137e5142cec146627e119 (diff)
downloadthrift-012dd4e3fc1e75e3434f608ce2ba30dbd29c56cb.tar.gz
Renamed, relocated, and reformated the audit tool's readme file
-rw-r--r--compiler/cpp/src/audit/readme.txt32
-rw-r--r--test/audit/README.md40
2 files changed, 40 insertions, 32 deletions
diff --git a/compiler/cpp/src/audit/readme.txt b/compiler/cpp/src/audit/readme.txt
deleted file mode 100644
index f1c53e3d7..000000000
--- a/compiler/cpp/src/audit/readme.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-Typical usage:
- thrift.exe --audit <oldFile> <newFile>
-Example run:
- > thrift.exe --audit test.thrift break1.thrift
- [Thrift Audit Failure:break1.thrift] New Thrift File has missing function base_function3
- [Thrift Audit Warning:break1.thrift] Constant const3 has different value
-
-Problems that the audit tool can catch:
-Errors
- Removing an enum value
- Changing the type of a struct field
- Changing the required-ness of a struct field
- Removing a struct field
- Adding a required struct field
- Adding a struct field 'in the middle'. This usually indicates an old ID has been recycled
- Struct removed
- Oneway-ness change
- Return type change
- Missing function
- Missing service
- Change in service inheritance
-Warnings
- Removing a language namespace declaration
- Changing a namespace
- Changing an enum value's name
- Removing an enum class
- Default value changed
- Struct field name change
- Removed constant
- Type of constant changed
- Value of constant changed
- \ No newline at end of file
diff --git a/test/audit/README.md b/test/audit/README.md
new file mode 100644
index 000000000..412f8d5b6
--- /dev/null
+++ b/test/audit/README.md
@@ -0,0 +1,40 @@
+Typical usage
+=============
+```
+thrift.exe --audit <oldFile> <newFile>
+```
+Example run
+===========
+```
+> thrift.exe --audit test.thrift break1.thrift
+[Thrift Audit Failure:break1.thrift] New Thrift File has missing function base_function3
+[Thrift Audit Warning:break1.thrift] Constant const3 has different value
+```
+
+Problems that the audit tool can catch
+======================================
+Errors
+* Removing an enum value
+* Changing the type of a struct field
+* Changing the required-ness of a struct field
+* Removing a struct field
+* Adding a required struct field
+* Adding a struct field 'in the middle'. This usually indicates an old ID has been recycled
+* Struct removed
+* Oneway-ness change
+* Return type change
+* Missing function
+* Missing service
+* Change in service inheritance
+
+Warnings
+* Removing a language namespace declaration
+* Changing a namespace
+* Changing an enum value's name
+* Removing an enum class
+* Default value changed
+* Struct field name change
+* Removed constant
+* Type of constant changed
+* Value of constant changed
+ \ No newline at end of file