Improved `uart_flush()` documentation.
Improved `uart_flush()` documentation.

Improved `uart_flush()` documentation based on this discussion: https://esp32.com/viewtopic.php?f=13&t=2804&p=13377&hilit=uart_flush#p13373

Merges https://github.com/espressif/esp-idf/pull/970

mashaoze/esp-idf,jaracil/esp-idf,shukyisme/esp-idf-kwik,mashaoze/esp-idf,www220/esp-idf,ajs124/esp-idf,Hermiedapwdrman/esp-idf,armada-ai/esp-idf,ajs124/esp-idf,armada-ai/esp-idf,espressif/esp-idf,shukyisme/esp-idf-kwik,MIhanguangyi/esp-idf,nineisk/esp-idf,MIhanguangyi/esp-idf,ajs124/esp-idf,nineisk/esp-idf,www220/esp-idf,armada-ai/esp-idf,www220/esp-idf,Hermiedapwdrman/esp-idf,nineisk/esp-idf,MIhanguangyi/esp-idf,mashaoze/esp-idf,ajs124/esp-idf,Hermiedapwdrman/esp-idf,mashaoze/esp-idf,armada-ai/esp-idf,jaracil/esp-idf,www220/esp-idf,empoweredhomes/esp-idf,Hermiedapwdrman/esp-idf,MIhanguangyi/esp-idf,jaracil/esp-idf,mashaoze/esp-idf,espressif/esp-idf,Hermiedapwdrman/esp-idf,shukyisme/esp-idf-kwik,empoweredhomes/esp-idf,shukyisme/esp-idf-kwik,espressif/esp-idf,empoweredhomes/esp-idf,MIhanguangyi/esp-idf,espressif/esp-idf,www220/esp-idf,empoweredhomes/esp-idf,nineisk/esp-idf,jaracil/esp-idf,shukyisme/esp-idf-kwik,empoweredhomes/esp-idf