why is VOLATILE_LOG_DIR mentioned in ref manual when it doesn't exist?

Robert P. J. Day

not sure if i'm misreading this, but i note that an addition was
made to the ref manual back in dec 2016:

commit 5d2bdf49e569e44d02602501d72418f04dbe6e4a
Author: Scott Rifenbark <srifenbark@...>
Date: Fri Dec 30 10:20:28 2016 -0800

ref-manual: New VOLATILE_LOG_DIR variable description

Fixes [YOCTO #6132]

No mention of how to make the target directory /var/log
persistent. I added a note to the "post-install-logging"
image feature that points to the new VOLATILE_LOG_DIR
variable description, which I added to the glossary.

Signed-off-by: Scott Rifenbark <srifenbark@...>

diff --git a/documentation/ref-manual/ref-features.xml
index 282a517..a4516a2 100644
--- a/documentation/ref-manual/ref-features.xml
+++ b/documentation/ref-manual/ref-features.xml
@@ -297,6 +297,12 @@
Enables logging postinstall script runs to
the <filename>/var/log/postinstall.log</filename> file
on first boot of the image on the target system.
+ <note>
+ To make the <filename>/var/log</filename> directory
+ on the target persistent, use the
+ <ulink url='&YOCTO_DOCS_REF_URL;#var-VOLATILE_LOG_DIR'><filename>VOLATILE_LOG_DIR</filename></ulink>
+ variable by setting it to "no".
+ </note>
Installs ptest packages for all ptest-enabled recipes.

but that is a broken link, and i see no definition or usage of that
variable. can someone clarify what is happening here?



Robert P. J. Day Ottawa, Ontario, CANADA

Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday

Join yocto@lists.yoctoproject.org to automatically receive all group messages.