file: Clarify directory creation behavior when using WRITE

When using `file(WRITE)`, parent directories are also created. Documentation
has been updated to explain this behavior.

Co-Author: Craig Scott <craig.scott@crascit.com>
This commit is contained in:
Robert Dailey 2017-07-28 10:48:45 -05:00 committed by Brad King
parent f15cfd891d
commit d7472bbf16

View File

@ -13,8 +13,11 @@ File manipulation command.
Write ``<content>`` into a file called ``<filename>``. If the file does Write ``<content>`` into a file called ``<filename>``. If the file does
not exist, it will be created. If the file already exists, ``WRITE`` not exist, it will be created. If the file already exists, ``WRITE``
mode will overwrite it and ``APPEND`` mode will append to the end. mode will overwrite it and ``APPEND`` mode will append to the end.
(If the file is a build input, use the :command:`configure_file` command Any directories in the path specified by ``<filename>`` that do not
to update the file only when its content changes.) exist will be created.
If the file is a build input, use the :command:`configure_file` command
to update the file only when its content changes.
------------------------------------------------------------------------------ ------------------------------------------------------------------------------