escaping $ in build_flags

What kind of issue is this?

• Question.
  This issue tracker is not the place for questions. If you want to ask how to do something,
  or to understand why something isn't working the way you expect it to,
  use Community Forums or Premium Support

• PlatformIO IDE.
  All issues related to PlatformIO IDE should be reported to appropriate repository:
  PlatformIO IDE for Atom or
  PlatformIO IDE for VSCode

• Development Platform or Board.
  All issues (building, uploading, adding new boards, etc.) related to PlatformIO development platforms
  should be reported to appropriate repository related to your hardware
  https://github.com/topics/platformio-platform

• [x ] Feature Request.
  Start by telling us what problem you’re trying to solve. Often a solution
  already exists! Don’t send pull requests to implement new features without first getting our
  support. Sometimes we leave features out on purpose to keep the project small.

• PlatformIO Core.
  If you’ve found a bug, please provide an information below.

You can erase any parts of this template not applicable to your Issue.

Configuration

Operating system: windwos

PlatformIO Version (platformio --version):

Description of problem

using env.StringifyMacro() doesn't escape special characters
also it isn't obvious what the escapes are, for instance "$$" to escape "$" isn't obvious. "\$" produces "/$" which is also baffeling. The docs only say to escape characters they don't say how you do it.

Request: document escape characters and special characters used in .ini build_flags and env variables

Start by reviewing the documentation for .ini build_flags, environment variables, and env.StringifyMacro(). Check the current explanation and examples for special characters and escaping; done means the documentation clearly describes the supported escape syntax and characters.