summaryrefslogtreecommitdiff
path: root/share/patchfiles/README
diff options
context:
space:
mode:
Diffstat (limited to 'share/patchfiles/README')
-rw-r--r--share/patchfiles/README16
1 files changed, 16 insertions, 0 deletions
diff --git a/share/patchfiles/README b/share/patchfiles/README
new file mode 100644
index 0000000000..c82fd4ed2d
--- /dev/null
+++ b/share/patchfiles/README
@@ -0,0 +1,16 @@
+Please preserve the following when adding files here:
+
+All documents except MIDI.midnam have the conventional naming scheme
+Manufacturer_Model.midnam, with spaces replaced with underscores.
+
+All documents validate against MIDINameDocument10.dtd. Often the DOCTYPE needs
+to be updated to the standard one, many old .midnam files use outdated versions
+with broken links.
+
+To validate a document, run:
+
+xmllint --dtdvalid MIDINameDocument10.dtd Acme_Synthomatic.midnam > /dev/null
+
+The same tool can be used to format the file nicely:
+
+xmllint --format My_Device.ugly.midnam > Acme_Synthomatic.midnam