better comments

Author: Dominik Gehlich

PostgreSQL.tmLanguage

@@ -105,7 +105,9 @@
 						</dict>
 					</dict>
 					<key>comment</key>
-					<string>Assume multiline dollar quote is SQL body! Start if double dollar quote is followed by comment or linebreak. See match for dollar quotes as string: string.unquoted.dollar.pgsql. This could easily support other PL languages like PHP and Ruby -- see PHP heredoc as an example.</string>
+					<string>Assume multiline dollar quote is SQL body! Start if double dollar quote is followed by comment (-- or /**/) or linebreak (
+ or 
+). See match for dollar quotes as string: string.unquoted.dollar.pgsql. This could easily support other PL languages like PHP and Ruby -- see PHP heredoc as an example.</string>
 					<key>contentName</key>
 					<string>meta.dollar-quote.pgsql</string>
 					<key>end</key>
@@ -568,7 +570,7 @@
 					<key>begin</key>
 					<string>(\$[\w_]*\$)</string>
 					<key>comment</key>
-					<string>Color double dollar quotes as a string Only if no followed by comment or linebreak. See meta.dollar-quote.pgsql.</string>
+					<string>Color double dollar quotes as a string Only if not followed by comment or linebreak, see meta.dollar-quote.pgsql.</string>
 					<key>end</key>
 					<string>\1</string>
 					<key>name</key>