diff --git a/manual/advanced_topics/viewports/colour-vp-syntax.tex b/manual/advanced_topics/viewports/colour-vp-syntax.tex
index d027c3b757..cd72363ac2 100644
--- a/manual/advanced_topics/viewports/colour-vp-syntax.tex
+++ b/manual/advanced_topics/viewports/colour-vp-syntax.tex
@@ -18,6 +18,9 @@
 
 \note{The correct number of commas with hyphens in
       blank fields are still needed.}
+\note{Any text or tags after \%Vf() or \%Vb() may or may not display depending
+      on context thus text or tags following on the same line should be avoided,
+      this behavior preserves backward compatibility.}
 
 \begin{example}
     %V(12,20,-,-,1) %Vf(000000) %Vb(FFFFFF) %Vg(FFC0CB, FF0000, FFFF00)
diff --git a/manual/advanced_topics/viewports/grayscale-vp-syntax.tex b/manual/advanced_topics/viewports/grayscale-vp-syntax.tex
index 2bced327d8..76966406f2 100644
--- a/manual/advanced_topics/viewports/grayscale-vp-syntax.tex
+++ b/manual/advanced_topics/viewports/grayscale-vp-syntax.tex
@@ -16,6 +16,9 @@
 
 \note{The correct number of commas with hyphens in
       blank fields are still needed.}
+\note{Any text or tags after \%Vf() or \%Vb() may or may not display depending
+      on context thus text or tags following on the same line should be avoided,
+      this behavior preserves backward compatibility.}
 
 \begin{example}
     %V(12,20,-,-,1) %Vf(0) %Vb(3)
diff --git a/manual/appendix/wps_tags.tex b/manual/appendix/wps_tags.tex
index bb27840f41..7c6dbe713a 100644
--- a/manual/appendix/wps_tags.tex
+++ b/manual/appendix/wps_tags.tex
@@ -62,14 +62,18 @@ show the information for the next song to be played.
      \config{\%V(x,y,[width],\tabnlindent[height],[font])}\newline
       \config{\%Vf([fgshade])}\newline
       \config{\%Vb([bgshade])}
-      & See section \ref{ref:Viewports}\\}}
+      & See section \ref{ref:Viewports}\newline
+      \note{Any text or tags after \%Vf() or \%Vb() may result in
+            unexpected behavior and should be avoided.}\\}}
 
     \opt{lcd_color}{%
       \config{\%V(x,y,[width],\tabnlindent[height],[font])}\newline
       \config{\%Vf([fgcolour])}\newline
       \config{\%Vb([bgcolour])}\newline
       \config{\%Vg(start,end \tabnlindent[,text])}
-      & See section \ref{ref:Viewports}\\}
+      & See section \ref{ref:Viewports}\newline
+      \note{Any text or tags after \%Vf() or \%Vb() may result in
+            unexpected behavior and should be avoided.}\\}
 
     \opt{lcd_non-mono}{%
       \config{\%Vs(mode[,param])}