commit 638ad499d0b8331ddaf121ae7ed5fda0b7dc2598
Author:     ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
AuthorDate: Sun Dec 12 15:48:08 2021 +0100
Commit:     ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
CommitDate: Sun Dec 12 15:48:08 2021 +0100

    Documentation: discuss HighDPI support under Windows and app manifests.

 documentation/src/osissues.dox | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git documentation/src/osissues.dox documentation/src/osissues.dox
index 069d797..82d28d1 100644
--- documentation/src/osissues.dox
+++ documentation/src/osissues.dox
@@ -583,6 +583,17 @@ DrawSomething(fl_gc, ..., fl_brush());
 It may also be useful to refer to Fl_Window::current()
 to get the window's size or position.
 
+\subsection osissues_windows_highdpi HighDPI support
+FLTK apps for the Windows platform are by default "Per-monitor DPI-aware V2".
+This means that any window automatically adjusts its physical size
+in relation to the scaling factor of the display where it maps.
+This also means that all drawings (e.g., text, lines, images)
+take advantage of the full resolution of the display in use.
+FLTK apps may also use the manifest mechanism
+to declare their level of DPI awareness. The FLTK library
+adapts to the DPI awareness level set in the app's manifest, which can be lower
+than the default level if the manifest sets it so.
+
 \subsection osissues_windows_scaling Display Scaling Factor
 
 FLTK uses the value given by function GetDpiForMonitor() divided by 96.