echo/CMake
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

cmake: Upgrade 'cmake -E' commands description

Browse Source 
Fixes: #13204
This commit is contained in:
Bartosz Kosiorek 2019-03-12 14:20:53 +01:00
parent 7358f317e3
commit da2e588935
2 changed files with 14 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
Help/manual/cmake.1.rst
View File

@ -390,16 +390,20 @@ Available commands are:
Copy files to ``<destination>`` (either file or directory). Copy files to ``<destination>`` (either file or directory).
If multiple files are specified, the ``<destination>`` must be If multiple files are specified, the ``<destination>`` must be
directory and it must exist. Wildcards are not supported. directory and it must exist. Wildcards are not supported.
``copy`` does follow symlinks. That means it does not copy symlinks,
but the files or directories it point to.
``copy_directory <dir>... <destination>`` ``copy_directory <dir>... <destination>``
Copy directories to ``<destination>`` directory. Copy directories to ``<destination>`` directory.
If ``<destination>`` directory does not exist it will be created. If ``<destination>`` directory does not exist it will be created.
``copy_directory`` does follow symlinks.
``copy_if_different <file>... <destination>`` ``copy_if_different <file>... <destination>``
Copy files to ``<destination>`` (either file or directory) if Copy files to ``<destination>`` (either file or directory) if
they have changed. they have changed.
If multiple files are specified, the ``<destination>`` must be If multiple files are specified, the ``<destination>`` must be
directory and it must exist. directory and it must exist.
``copy_if_different`` does follow symlinks.
``echo [<string>...]`` ``echo [<string>...]``
Displays arguments as text. Displays arguments as text.
@ -459,13 +463,16 @@ Available commands are:
exist, the command returns a non-zero exit code, but no message exist, the command returns a non-zero exit code, but no message
is logged. The ``-f`` option changes the behavior to return a is logged. The ``-f`` option changes the behavior to return a
zero exit code (i.e. success) in such situations instead. zero exit code (i.e. success) in such situations instead.
``remove`` does not follow symlinks. That means it remove only symlinks
and not files it point to.
``remove_directory <dir>`` ``remove_directory <dir>``
Remove a directory and its contents. If a directory does Remove a directory and its contents. If a directory does
not exist it will be silently ignored. not exist it will be silently ignored.
``rename <oldname> <newname>`` ``rename <oldname> <newname>``
Rename a file or directory (on one volume). Rename a file or directory (on one volume). If file with the ``<newname>`` name
already exists, then it will be silently replaced.
``server`` ``server``
Launch :manual:`cmake-server(7)` mode. Launch :manual:`cmake-server(7)` mode.
@ -494,10 +501,11 @@ Available commands are:
``time <command> [<args>...]`` ``time <command> [<args>...]``
Run command and display elapsed time. Run command and display elapsed time.
``touch <file>`` ``touch <file>...``
Touch a file. Creates ``<file>`` if file do not exist.
If ``<file>`` exists, it is changing ``<file>`` access and modification times.
``touch_nocreate <file>`` ``touch_nocreate <file>...``
Touch a file if it exists but do not create it. If a file does Touch a file if it exists but do not create it. If a file does
not exist it will be silently ignored. not exist it will be silently ignored.

4
Source/cmcmd.cxx
View File

@ -111,8 +111,8 @@ void CMakeCommandUsage(const char* program)
<< " tar [cxt][vf][zjJ] file.tar [file/dir1 file/dir2 ...]\n" << " tar [cxt][vf][zjJ] file.tar [file/dir1 file/dir2 ...]\n"
<< " - create or extract a tar or zip archive\n" << " - create or extract a tar or zip archive\n"
<< " time command [args...] - run command and display elapsed time\n" << " time command [args...] - run command and display elapsed time\n"
<< " touch file - touch a file.\n" << " touch <file>... - touch a <file>.\n"
<< " touch_nocreate file - touch a file but do not create it.\n" << " touch_nocreate <file>... - touch a <file> but do not create it.\n"
<< " create_symlink old new - create a symbolic link new -> old\n" << " create_symlink old new - create a symbolic link new -> old\n"
#if defined(_WIN32) && !defined(__CYGWIN__) #if defined(_WIN32) && !defined(__CYGWIN__)
<< "Available on Windows only:\n" << "Available on Windows only:\n"