diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml
index a6b1e3dbed..1351991985 100644
--- a/documentation/ref-manual/ref-classes.xml
+++ b/documentation/ref-manual/ref-classes.xml
@@ -3460,14 +3460,23 @@
uninative.bbclass
- Provides a means of reusing native/cross over
- multiple distros.
-
- Currently, the method used by the uninative
- class is experimental.
-
- For more information, see the commit message
- here.
+ Attempts to isolate the build system from the host
+ distribution's C library in order to make re-use of native shared state
+ artifacts across different host distributions practical.
+ With this class enabled, a tarball containing a pre-built C library
+ is downloaded at the start of the build.
+ In the Poky reference distribution this is enabled by default
+ through
+ meta/conf/distro/include/yocto-uninative.inc.
+ Other distributions that do not derive from poky can also
+ "require conf/distro/include/yocto-uninative.inc"
+ to use this.
+ Alternatively if you prefer, you can build the uninative-tarball recipe
+ yourself, publish the resulting tarball (e.g. via HTTP) and set
+ UNINATIVE_URL and
+ UNINATIVE_CHECKSUM appropriately.
+ For an example, see the
+ meta/conf/distro/include/yocto-uninative.inc.