@anchor{V}
@defvar V
If this variable equals to @samp{1}, the whole command lines for all
-executed commands are displayed. Otherwise, only short messages are
+executed commands are displayed. When not set or zero, only short
+messages are printed. Value of @samp{2} displays the whole command lines
+as with @samp{1} and in addition directory navigation messages are
printed.
@end defvar
@node Troubleshooting, , Interfacing OMK to popular IDEs, OMK User's Manual
@section Troubleshooting
-Renaming of some file => dependency problems.
+@itemize
+@item
+ If you rename some file or directory and then you can't compile your
+ project, call @command{make clean} in the directory with errors. The
+ reason for this behavior is that OMK remembers dependencies of every
+ file. After renaming something, the original name is still stored in
+ dependencies, but make doesn't know how to create this non-existent
+ source.
-Manual compilation ... V=1
+@item
+ Sometimes, you may want to compile one file the same way as OMK does
+ it, but run the compilation manually from command line. For example,
+ you want to debug some preprocessor macros and you only want to
+ produce preprocessed source instead of object file.
+
+ To compile something manually, you can run OMK with @command{make
+ V=2}. This will print all commands executed together with directory
+ navigation messages. Find the command you want to execute manually in
+ the output. To run it, you need to change the working directory to the
+ correct one in the @file{_build} tree. The correct directory can be
+ found in make output on the line @samp{Entering directory} preceding
+ the desired command.
+@end itemize
@node Original README, OMK Development, OMK User's Manual, Top
@chapter Original README