Cleaned up some doc comments

modules/juce_audio_basics/mpe/juce_MPEInstrument.cpp

@@ -156,7 +156,7 @@ void MPEInstrument::processNextMidiEvent (const MidiMessage& message)
 //==============================================================================
 void MPEInstrument::processMidiNoteOnMessage (const MidiMessage& message)
 {
-    // Note: if a note-on with velocity = 0 is used to convey a note-off,
+    // Note: If a note-on with velocity = 0 is used to convey a note-off,
     // then the actual note-off velocity is not known. In this case,
     // the MPE convention is to use note-off velocity = 64.
 

modules/juce_audio_basics/mpe/juce_MPEInstrument.h

@@ -271,7 +271,7 @@ public:
             MPE note's key state (whether the key is down and/or the note is
             sustained) has changed.
 
-            Note: if the key state changes to MPENote::off, noteReleased is
+            Note: If the key state changes to MPENote::off, noteReleased is
             called instead.
         */
         virtual void noteKeyStateChanged (MPENote changedNote) = 0;

modules/juce_audio_basics/mpe/juce_MPEMessages.cpp

@@ -215,7 +215,7 @@ private:
         std::size_t pos = 0;
         MidiBuffer::Iterator iter (midiBuffer);
         MidiMessage midiMessage;
-        int samplePosition; // Note: not actually used, so no need to initialise.
+        int samplePosition; // Note: Not actually used, so no need to initialise.
 
         while (iter.getNextEvent (midiMessage, samplePosition))
         {

modules/juce_audio_basics/mpe/juce_MPEMessages.h

@@ -35,7 +35,7 @@ namespace juce
     class instead. You just need to take care to send them to the appropriate
     per-note MIDI channel.
 
-    Note: if you are working with an MPEZoneLayout object inside your app,
+    Note: If you are working with an MPEZoneLayout object inside your app,
     you should not use the message sequences provided here. Instead, you should
     change the zone layout programmatically with the member functions provided in the
     MPEZoneLayout class itself. You should also make sure that the Expressive

modules/juce_audio_devices/midi_io/juce_MidiOutput.cpp

@@ -42,7 +42,7 @@ void MidiOutput::sendBlockOfMessagesNow (const MidiBuffer& buffer)
 {
     MidiBuffer::Iterator i (buffer);
     MidiMessage message;
-    int samplePosition; // Note: not actually used, so no need to initialise.
+    int samplePosition; // Note: Not actually used, so no need to initialise.
 
     while (i.getNextEvent (message, samplePosition))
         sendMessageNow (message);

modules/juce_audio_devices/native/juce_android_Oboe.cpp

@@ -505,7 +505,7 @@ private:
 
             static int defaultFramesPerBurst = getDefaultFramesPerBurst();
 
-            // Note: letting OS to choose the buffer capacity & frames per callback.
+            // Note: Letting OS to choose the buffer capacity & frames per callback.
             builder.setDirection (direction);
             builder.setSharingMode (sharingMode);
             builder.setChannelCount (channelCount);

modules/juce_audio_processors/processors/juce_AudioProcessorListener.h

@@ -47,7 +47,7 @@ public:
     //==============================================================================
     /** Receives a callback when a parameter is changed.
 
-        IMPORTANT NOTE: this will be called synchronously when a parameter changes, and
+        IMPORTANT NOTE: This will be called synchronously when a parameter changes, and
         many audio processors will change their parameter during their audio callback.
         This means that not only has your handler code got to be completely thread-safe,
         but it's also got to be VERY fast, and avoid blocking. If you need to handle
@@ -61,7 +61,7 @@ public:
     /** Called to indicate that something else in the plugin has changed, like its
         program, number of parameters, etc.
 
-        IMPORTANT NOTE: this will be called synchronously, and many audio processors will
+        IMPORTANT NOTE: This will be called synchronously, and many audio processors will
         call it during their audio callback. This means that not only has your handler code
         got to be completely thread-safe, but it's also got to be VERY fast, and avoid
         blocking. If you need to handle this event on your message thread, use this callback
@@ -76,7 +76,7 @@ public:
         press the mouse button, and audioProcessorParameterChangeGestureEnd would be
         called when they release it.
 
-        IMPORTANT NOTE: this will be called synchronously, and many audio processors will
+        IMPORTANT NOTE: This will be called synchronously, and many audio processors will
         call it during their audio callback. This means that not only has your handler code
         got to be completely thread-safe, but it's also got to be VERY fast, and avoid
         blocking. If you need to handle this event on your message thread, use this callback
@@ -93,7 +93,7 @@ public:
         E.g. if the user is dragging a slider, this would be called when they release
         the mouse button.
 
-        IMPORTANT NOTE: this will be called synchronously, and many audio processors will
+        IMPORTANT NOTE: This will be called synchronously, and many audio processors will
         call it during their audio callback. This means that not only has your handler code
         got to be completely thread-safe, but it's also got to be VERY fast, and avoid
         blocking. If you need to handle this event on your message thread, use this callback

modules/juce_audio_processors/processors/juce_AudioProcessorParameter.h

@@ -242,7 +242,7 @@ public:
 
         /** Receives a callback when a parameter has been changed.
 
-            IMPORTANT NOTE: this will be called synchronously when a parameter changes, and
+            IMPORTANT NOTE: This will be called synchronously when a parameter changes, and
             many audio processors will change their parameter during their audio callback.
             This means that not only has your handler code got to be completely thread-safe,
             but it's also got to be VERY fast, and avoid blocking. If you need to handle
@@ -257,7 +257,7 @@ public:
             being true when they first press the mouse button, and it will be called again with
             gestureIsStarting being false when they release it.
 
-            IMPORTANT NOTE: this will be called synchronously, and many audio processors will
+            IMPORTANT NOTE: This will be called synchronously, and many audio processors will
             call it during their audio callback. This means that not only has your handler code
             got to be completely thread-safe, but it's also got to be VERY fast, and avoid
             blocking. If you need to handle this event on your message thread, use this callback

modules/juce_core/files/juce_MemoryMappedFile.h

@@ -71,7 +71,7 @@ public:
 
         If the file can't be opened for some reason, the getData() method will return a null pointer.
 
-        NOTE: the start of the actual range used may be rounded-down to a multiple of the OS's page-size,
+        NOTE: The start of the actual range used may be rounded-down to a multiple of the OS's page-size,
         so do not assume that the mapped memory will begin at exactly the position you requested - always
         use getRange() to check the actual range that is being used.
     */

modules/juce_core/memory/juce_SharedResourcePointer.h

@@ -39,7 +39,7 @@ namespace juce
     the underlying object is also immediately destroyed. This allows you to use scoping
     to manage the lifetime of a shared resource.
 
-    Note: the construction/deletion of the shared object must not involve any
+    Note: The construction/deletion of the shared object must not involve any
     code that makes recursive calls to a SharedResourcePointer, or you'll cause
     a deadlock.
 

modules/juce_core/xml/juce_XmlElement.cpp

@@ -241,7 +241,7 @@ namespace XmlOutputFunctions
                             outputStream << (char) character;
                             break;
                         }
-                        // Note: deliberate fall-through here!
+                        // Note: Deliberate fall-through here!
                     default:
                         outputStream << "&#" << ((int) character) << ';';
                         break;

modules/juce_dsp/filter_design/juce_FilterDesign.h

@@ -55,7 +55,7 @@ struct FilterDesign
 
         It generates linear phase filters coefficients.
 
-        Note : the flatTop WindowingMethod generates an impulse response with a
+        Note: The flatTop WindowingMethod generates an impulse response with a
         maximum amplitude higher than one, and might be normalized if necessary
         depending on the applications.
 

modules/juce_dsp/frequency/juce_Convolution.h

@@ -85,7 +85,7 @@ public:
         formats registered in JUCE, and performs some resampling and pre-processing
         as well if needed.
 
-        Note : obviously, don't try to use this function on float samples, since the
+        Note: Obviously, don't try to use this function on float samples, since the
         data is supposed to be an audio file in its binary format, and be sure that
         the original data is not going to move at all its memory location during the
         process !!

modules/juce_dsp/maths/juce_FastMathApproximations.h

@@ -39,7 +39,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function cosh(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -5 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -54,7 +54,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function cosh(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -5 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -67,7 +67,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function sinh(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -5 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -82,7 +82,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function sinh(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -5 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -95,7 +95,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function tanh(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -5 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -110,7 +110,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function tanh(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -5 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -124,7 +124,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function cos(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -pi and +pi for limiting the error.
     */
     template <typename FloatType>
@@ -139,7 +139,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function cos(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -pi and +pi for limiting the error.
     */
     template <typename FloatType>
@@ -152,7 +152,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function sin(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -pi and +pi for limiting the error.
     */
     template <typename FloatType>
@@ -167,7 +167,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function sin(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -pi and +pi for limiting the error.
     */
     template <typename FloatType>
@@ -180,7 +180,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function tan(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -pi/2 and +pi/2 for limiting the error.
     */
     template <typename FloatType>
@@ -195,7 +195,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function tan(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -pi/2 and +pi/2 for limiting the error.
     */
     template <typename FloatType>
@@ -209,7 +209,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function exp(x) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -6 and +4 for limiting the error.
     */
     template <typename FloatType>
@@ -223,7 +223,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function exp(x) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -6 and +4 for limiting the error.
     */
     template <typename FloatType>
@@ -236,7 +236,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function log(x+1) using a Pade approximant
         continued fraction, calculated sample by sample.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -0.8 and +5 for limiting the error.
     */
     template <typename FloatType>
@@ -250,7 +250,7 @@ struct FastMathApproximations
     /** Provides a fast approximation of the function log(x+1) using a Pade approximant
         continued fraction, calculated on a whole buffer.
 
-        Note : this is an approximation which works on a limited range. You are
+        Note: This is an approximation which works on a limited range. You are
         advised to use input values only between -0.8 and +5 for limiting the error.
     */
     template <typename FloatType>

modules/juce_dsp/maths/juce_LookupTable.h

@@ -164,7 +164,7 @@ private:
         LookupTableTransform<float> tanhApprox ([] (float x) { return std::tanh (x); }, -5.0f, 5.0f, 64);
         auto outValue = tanhApprox (4.2f);
 
-    Note : if you try to call the function with an input outside the provided
+    Note: If you try to call the function with an input outside the provided
     range, it will return either the first or the last recorded LookupTable value.
 
     @see LookupTable

modules/juce_dsp/processors/juce_Oversampling.h

@@ -75,7 +75,7 @@ public:
         Constructor of the oversampling class. All the processing parameters must be
         provided at the creation of the oversampling object.
 
-        Note : you might want to create a class heriting from Oversampling with a
+        Note: You might want to create a class inheriting from Oversampling with a
         different constructor if you need more control on what happens in the process.
 
         @param numChannels      the number of channels to process with this object
@@ -97,7 +97,7 @@ public:
         the oversampling, for example with a dry / wet functionality, and to report
         the latency to the DAW.
 
-        Note : the latency might not be integer, so you might need to round its value
+        Note: The latency might not be integer, so you might need to round its value
         or to compensate it properly in your processing code.
     */
     SampleType getLatencyInSamples() noexcept;

modules/juce_dsp/processors/juce_StateVariableFilter.h

@@ -44,7 +44,7 @@ namespace StateVariableFilter
         structures for more information). Its behaviour is based on the analog
         state variable filter circuit.
 
-        Note : the bandpass here is not the one in the RBJ CookBook, its gain can be
+        Note: The bandpass here is not the one in the RBJ CookBook, its gain can be
         higher than 0 dB. For the classic 0 dB bandpass, we need to multiply the
         result with R2
 
@@ -203,7 +203,8 @@ namespace StateVariableFilter
         Type type = Type::lowPass;
 
         /** Sets the cutoff frequency and resonance of the IIR filter.
-            Note : the bandwidth of the resonance increases with the value of the
+
+            Note: The bandwidth of the resonance increases with the value of the
             parameter. To have a standard 12 dB/octave filter, the value must be set
             at 1 / sqrt(2).
         */

modules/juce_gui_basics/filebrowser/juce_FileChooser.h

@@ -75,7 +75,7 @@ public:
                                               initialFileOrDirectory will be used as the initial
                                               directory of the native file chooser.
 
-                                              Note: on iOS when saving a file, a user will not
+                                              Note: On iOS when saving a file, a user will not
                                               be able to change a file name, so it may be a good
                                               idea to include at least a valid file name in
                                               initialFileOrDirectory. When no filename is found,
@@ -251,7 +251,7 @@ public:
         may return a URL to a remote document. If a local file is chosen then you can
         convert this file to a JUCE File class via the URL::getLocalFile method.
 
-        Note: on iOS you must use the returned URL object directly (you are also
+        Note: On iOS you must use the returned URL object directly (you are also
         allowed to copy- or move-construct another URL from the returned URL), rather
         than just storing the path as a String and then creating a new URL from that
         String. This is because the returned URL contains internally a security
@@ -274,7 +274,7 @@ public:
         This array may be empty if no files were chosen, or can contain multiple entries
         if multiple files were chosen.
 
-        Note: on iOS you must use the returned URL object directly (you are also
+        Note: On iOS you must use the returned URL object directly (you are also
         allowed to copy- or move-construct another URL from the returned URL), rather
         than just storing the path as a String and then creating a new URL from that
         String. This is because the returned URL contains internally a security

modules/juce_gui_basics/menus/juce_PopupMenu.cpp

@@ -1089,7 +1089,7 @@ private:
             {
                 PopupMenuSettings::menuWasHiddenBecauseOfAppChange = true;
                 window.dismissMenu (nullptr);
-                // Note: this object may have been deleted by the previous call..
+                // Note: This object may have been deleted by the previous call.
             }
         }
         else if (wasDown && timeNow > window.windowCreationTime + 250
@@ -1100,7 +1100,7 @@ private:
             else if ((window.hasBeenOver || ! window.dismissOnMouseUp) && ! isOverAny)
                 window.dismissMenu (nullptr);
 
-            // Note: this object may have been deleted by the previous call..
+            // Note: This object may have been deleted by the previous call.
         }
         else
         {

modules/juce_gui_basics/windows/juce_DialogWindow.h

@@ -153,7 +153,7 @@ public:
     //==============================================================================
     /** Easy way of quickly showing a dialog box containing a given component.
 
-        Note: this method has been superceded by the DialogWindow::LaunchOptions structure,
+        Note: This method has been superceded by the DialogWindow::LaunchOptions structure,
         which does the same job with some extra flexibility. The showDialog method is here
         for backwards compatibility, but please use DialogWindow::LaunchOptions in new code.
 
@@ -199,7 +199,7 @@ public:
    #if JUCE_MODAL_LOOPS_PERMITTED || DOXYGEN
     /** Easy way of quickly showing a dialog box containing a given component.
 
-        Note: this method has been superceded by the DialogWindow::LaunchOptions structure,
+        Note: This method has been superceded by the DialogWindow::LaunchOptions structure,
         which does the same job with some extra flexibility. The showDialog method is here
         for backwards compatibility, but please use DialogWindow::LaunchOptions in new code.
 

modules/juce_gui_extra/embedding/juce_NSViewComponent.h

@@ -57,14 +57,14 @@ public:
         The view will be retained and released by this component for as long as
         it is needed. To remove the current view, just call setView (nullptr).
 
-        Note: a void* is used here to avoid including the cocoa headers as
+        Note: A void* is used here to avoid including the cocoa headers as
         part of the juce.h, but the method expects an NSView*.
     */
     void setView (void* nsView);
 
     /** Returns the current NSView.
 
-        Note: a void* is returned here to avoid the needing to include the cocoa
+        Note: A void* is returned here to avoid the needing to include the cocoa
         headers, so you should just cast the return value to an NSView*.
     */
     void* getView() const;

modules/juce_gui_extra/embedding/juce_UIViewComponent.h

@@ -57,14 +57,14 @@ public:
         The view will be retained and released by this component for as long as
         it is needed. To remove the current view, just call setView (nullptr).
 
-        Note: a void* is used here to avoid including the cocoa headers as
+        Note: A void* is used here to avoid including the cocoa headers as
         part of the juce.h, but the method expects an UIView*.
     */
     void setView (void* uiView);
 
     /** Returns the current UIView.
 
-        Note: a void* is returned here to avoid the needing to include the cocoa
+        Note: A void* is returned here to avoid the needing to include the cocoa
         headers, so you should just cast the return value to an UIView*.
     */
     void* getView() const;

modules/juce_gui_extra/misc/juce_PushNotifications.h

@@ -615,7 +615,7 @@ public:
             notification was received when the app was in the foreground already. On iOS 10 it will be
             called when a user presses on a notification
 
-            Note: on Android, if remote notification was received while the app was in the background and
+            Note: On Android, if remote notification was received while the app was in the background and
             then user pressed on it, the notification object received in this callback will contain only
             "properties" member set. Hence, if you want to know what was the notification title, content
             etc, you need to set them as additional properties, so that you will be able to restore them

modules/juce_gui_extra/native/juce_android_PushNotifications.cpp

@@ -1128,7 +1128,7 @@ struct PushNotifications::Pimpl
         var resultVar;
         JSON::parse (juceString (varString.get()), resultVar);
 
-        // Note: we are not checking if result of parsing was okay, because there may be no properties set at all.
+        // Note: We are not checking if result of parsing was okay, because there may be no properties set at all.
         return resultVar;
     }
 
@@ -1321,8 +1321,8 @@ struct PushNotifications::Pimpl
                     auto objectClass    = LocalRef<jobject> (env->CallObjectMethod (object, JavaObject.getClass));
                     auto classAsString  = LocalRef<jstring> ((jstring) env->CallObjectMethod (objectClass, JavaClass.getName));
 
-                    // Note: seems that Firebase delivers values as strings always, so this check is rather unnecessary,
-                    //       at least till they change the behaviour.
+                    // Note: It seems that Firebase delivers values as strings always, so this check is rather unnecessary,
+                    //       at least untill they change the behaviour.
                     var value = juceString (classAsString) == "java.lang.Bundle" ? bundleToVar (object) : var (juceString (objectAsString.get()));
                     dynamicObject->setProperty (juceString (key.get()), value);
                 }
@@ -1411,7 +1411,7 @@ struct PushNotifications::Pimpl
             const uint8 b = (uint8) colourString.substring (4, 6).getIntValue();
             n.accentColour = Colour (r, g, b);
 
-            // Note: ignoring icon, because Firebase passes it as a string.
+            // Note: Ignoring the icon, because Firebase passes it as a string.
 
             propertiesDynamicObject->setProperty ("clickAction",           juceString (clickAction.get()));
             propertiesDynamicObject->setProperty ("bodyLocalizationKey",   juceString (bodyLocalizationKey.get()));

modules/juce_gui_extra/native/juce_win32_ActiveXComponent.cpp

@@ -108,7 +108,7 @@ namespace ActiveXHelpers
 
         JUCE_COMRESULT GetWindowContext (LPOLEINPLACEFRAME* lplpFrame, LPOLEINPLACEUIWINDOW* lplpDoc, LPRECT, LPRECT, LPOLEINPLACEFRAMEINFO lpFrameInfo)
         {
-            /* Note: if you call AddRef on the frame here, then some types of object (e.g. web browser control) cause leaks..
+            /* Note: If you call AddRef on the frame here, then some types of object (e.g. web browser control) cause leaks..
                If you don't call AddRef then others crash (e.g. QuickTime).. Bit of a catch-22, so letting it leak is probably preferable.
             */
             if (lplpFrame != nullptr) { frame->AddRef(); *lplpFrame = frame; }

modules/juce_osc/osc/juce_OSCAddress.cpp

@@ -97,7 +97,7 @@ namespace
             if (pattern == patternEnd)
                 return false;
 
-            // Note: in case this code is ever moved into the more generic CharPointerFunctions,
+            // Note: In case this code is ever moved into the more generic CharPointerFunctions,
             // the next two lines probably will not compile as soon as this class is used with a
             // Char template type parameter that is not the same type as String::Char.
             StringArray set;
@@ -486,7 +486,7 @@ public:
             expectDoesNotThrow (OSCAddressPattern ("/[a-e]"));
             expectDoesNotThrow (OSCAddressPattern ("/foo/[a-z]x{foo,bar}/*BAZ42/"));
 
-            /* Note: if malformed expressions are used, e.g. "bracenotclosed{" or "{a-e}" or "[-foo]",
+            /* Note: If malformed expressions are used, e.g. "bracenotclosed{" or "{a-e}" or "[-foo]",
                this should not throw at construction time. Instead it should simply fail any pattern match later.
                So there is no need to test for those.
                The reason is that we do not actually parse the expressions now, but only during matching.
@@ -517,7 +517,7 @@ public:
 
         beginTest ("basic string matching");
         {
-            /* Note: the actual expression matching is tested in OSCPatternMatcher, so here we just
+            /* Note: The actual expression matching is tested in OSCPatternMatcher, so here we just
                do some basic tests and check if the matching works with multi-part addresses.
              */
             {

modules/juce_osc/osc/juce_OSCAddress.h

@@ -70,7 +70,7 @@ public:
     bool operator!= (const OSCAddress& other) const noexcept;
 
     /** Converts the OSCAddress to a String.
-        Note: trailing slashes are always removed automatically.
+        Note: Trailing slashes are always removed automatically.
 
         @returns a String object that represents the OSC address.
     */
@@ -137,7 +137,7 @@ public:
     bool containsWildcards() const noexcept     { return wasInitialisedWithWildcards; }
 
     /** Converts the OSCAddressPattern to a String.
-        Note: trailing slashes are always removed automatically.
+        Note: Trailing slashes are always removed automatically.
 
         @returns a String object that represents the OSC address pattern.
     */

modules/juce_osc/osc/juce_OSCMessage.h

@@ -128,7 +128,7 @@ public:
     /** Creates a new OSCArgument of type blob with binary data content copied from
         the given MemoryBlock.
 
-        Note: if the argument passed is an lvalue, this may copy the binary data.
+        Note: If the argument passed is an lvalue, this may copy the binary data.
     */
     void addBlob (MemoryBlock blob);
 

modules/juce_osc/osc/juce_OSCReceiver.cpp

@@ -37,7 +37,7 @@ namespace
         This class is implementing the Open Sound Control 1.0 Specification for
         interpreting the data.
 
-        Note: some older implementations of OSC may omit the OSC Type Tag string
+        Note: Some older implementations of OSC may omit the OSC Type Tag string
         in OSC messages. This class will treat such OSC messages as format errors.
     */
     class OSCInputStream

modules/juce_osc/osc/juce_OSCReceiver.h

@@ -140,7 +140,7 @@ public:
         and has to be either MessageLoopCallback or RealtimeCallback. If not specified,
         MessageLoopCallback will be used by default.
 
-        Note: this type of listener will ignore OSC bundles.
+        Note: This type of listener will ignore OSC bundles.
 
         @see OSCReceiver::addListener, OSCReceiver::Listener,
              OSCReceiver::MessageLoopCallback, OSCReceiver::RealtimeCallback

modules/juce_osc/osc/juce_OSCSender.h

@@ -50,7 +50,7 @@ public:
     /** Connects to a datagram socket and prepares the socket for sending OSC
         packets to the specified target.
 
-        Note: the operating system will choose which specific network adapter(s)
+        Note: The operating system will choose which specific network adapter(s)
         to bind your socket to, and which local port to use for the sender.
 
         @param  targetHostName   The remote host to which messages will be send.

modules/juce_osc/osc/juce_OSCTypes.h

@@ -39,7 +39,7 @@ using OSCTypeList = Array<OSCType>;
 /** The definitions of supported OSC types and their associated OSC type tags,
     as defined in the OpenSoundControl 1.0 specification.
 
-    Note: this implementation does not support any additional type tags that
+    Note: This implementation does not support any additional type tags that
     are not part of the specification.
 
     @tags{OSC}
@@ -111,7 +111,7 @@ struct OSCFormatError : public OSCException
 //==============================================================================
 /** Exception type thrown in cases of unexpected errors in the OSC module.
 
-    Note: this should never happen, and all the places where this is thrown
+    Note: This should never happen, and all the places where this is thrown
     should have a preceding jassertfalse to facilitate debugging.
 
     @tags{OSC}

modules/juce_product_unlocking/in_app_purchases/juce_InAppPurchases.h

@@ -142,7 +142,7 @@ public:
 
             InAppPurchases class will own downloads and will delete them as soon as they are finished.
 
-            NOTE: it is possible to receive this callback for the same purchase multiple times. If that happens,
+            NOTE: It is possible to receive this callback for the same purchase multiple times. If that happens,
             only the newest set of downloads and the newest orderId will be valid, the old ones should be not used anymore!
         */
         virtual void productPurchaseFinished (const PurchaseInfo&, bool /*success*/, const String& /*statusDescription*/) {}
@@ -150,7 +150,7 @@ public:
         /** Called when a list of all purchases is restored. This can be used to figure out to
             which products a user is entitled to.
 
-            NOTE: it is possible to receive this callback for the same purchase multiple times. If that happens,
+            NOTE: It is possible to receive this callback for the same purchase multiple times. If that happens,
             only the newest set of downloads and the newest orderId will be valid, the old ones should be not used anymore!
         */
         virtual void purchasesListRestored (const Array<PurchaseInfo>&, bool /*success*/, const String& /*statusDescription*/) {}

modules/juce_product_unlocking/marketplace/juce_OnlineUnlockStatus.cpp

@@ -27,7 +27,7 @@
 namespace juce
 {
 
-/* Note: there's a bit of light obfuscation in this code, just to make things
+/* Note: There's a bit of light obfuscation in this code, just to make things
    a bit more annoying for crackers who try to reverse-engineer your binaries, but
    nothing particularly foolproof.
 */

modules/juce_video/capture/juce_CameraDevice.h

@@ -112,7 +112,7 @@ public:
     /** Creates a component that can be used to display a preview of the
         video from this camera.
 
-        Note: while you can change the size of the preview component, the actual
+        Note: While you can change the size of the preview component, the actual
         preview display may be smaller than the size requested, because the correct
         aspect ratio is maintained automatically.
     */