]> Shamusworld >> Repos - ardour-manual/blobdiff - include/patch-change.html
make last commit cover all OSs.
[ardour-manual] / include / patch-change.html
index ce0a2dbd9f468e4902192c32ceacc7013b7bef9e..a692a458a079a64528e52a78010e600c42e1ca0a 100644 (file)
 
 <h2>Names for Patch Numbers: MIDNAM files</h2>
 <p>
-  MIDNAM files assign human-redable names to the "coordinates" (MSB, LSB, pc) of 
-  instruments and controls of MIDI-devices. Quite some files already come pre-bundled 
+  MIDNAM files assign human-redable names to the "coordinates" (MSB, LSB, pc) of
+  instruments and controls of MIDI-devices. A number of MIDNAM files come already pre-bundled
   with Ardour. Should this not be the case for your device, you can add your own (see below).
 </p>
 
 <h3>Selecting a device</h3>
 <p>
-  For the proper names to show up in the "Patch Selector"-dialog, you have to assign a 
-  device to your current track. To do so, hover the lower border of the tracks header 
-  (the mouse-cursor will change to a "resize-cursor") and expand it. 
+  For the proper names to show up in the "Patch Selector"-dialog, you have to assign a
+  device to your current track. To do so, hover the lower border of the tracks header
+  (the mouse-cursor will change to a "resize-cursor") and expand it.
   You'll see dropdown menus. Select your device in the menu.
 </p>
 
 <h3>Adding a custom MIDNAM-file</h3>
 <p>
-  MIDNAM-files are XML-Files. You can edit them using your favorite text-editor. When 
+  MIDNAM-files are XML-Files. You can edit them using your favorite text-editor. When
   doing so, please ensure to change the "Model" of the device, as Ardour will only load
   each model once (i.e. it will skip files, if there are clashes).
 </p>
@@ -82,16 +82,18 @@ $ wget http://www.midi.org/dtds/MIDINameDocument10.dtd
 $ xmllint --dtdvalid MIDINameDocument10.dtd myfile.midnam
 </code></pre>
 <p>
-  Once you are satisfied with your file, you have to put it at a location where Ardour 
-  picks it up. The best place would be the (hidden) directory 
-  <i>.config/ardour5/patchfiles/</i>
-  in your home-folder. Should the sub-directory <i>patchfiles</i> not exist yet, just 
-  create it. The path and file-names are case-sensitive. The file should end with 
+  Once you are satisfied with your file, you have to put it at a location where Ardour
+  picks it up. The best place would be the (hidden) directory
+  <a href="@@files-and-directories-ardour-knows-about">Ardour configuration directory</a>
+  subdirectory patchfiles.
+  in your home-folder. Should the sub-directory <i>patchfiles</i> not exist yet, just
+  create it. The path and file-names are case-sensitive. The file should end with
   "<i>.midnam</i>".
 </p>
 <p>
   After restarting Ardour, hit the small Log-button in the upper right corner of the
-  main window. It should say something like:
+  main window. It should say something like
+  (this is Linux, Macos or Windows will be different):
 </p>
 <pre>[INFO]: Loading 3 MIDI patches from /home/username/.config/ardour5/patchfiles</pre>
 <p>
@@ -99,7 +101,7 @@ $ xmllint --dtdvalid MIDINameDocument10.dtd myfile.midnam
 </p>
 <p>
   Should the MIDNAM-file be useful for the general public, it would be nice to share it:
-  Fork the Ardour-project on <a href="https://github.com/Ardour/ardour">gitHub</a> by 
+  Fork the Ardour-project on <a href="https://github.com/Ardour/ardour">gitHub</a> by
   hitting the "Fork"-Button. Go to the <a>patchfiles</a>-directory (and read the README).
 </p>
 <p>