mirror of
https://github.com/fish-shell/fish-shell
synced 2024-12-27 21:33:09 +00:00
Document time
This is a bit barebones, but `time` isn't super complicated to use and it should explain the basics. Fixes #6442 [ci skip]
This commit is contained in:
parent
f3dbede2a5
commit
23bf9661b2
1 changed files with 39 additions and 0 deletions
39
sphinx_doc_src/cmds/time.rst
Normal file
39
sphinx_doc_src/cmds/time.rst
Normal file
|
@ -0,0 +1,39 @@
|
|||
.. _cmd-time:
|
||||
|
||||
time - measure how long a command or block takes
|
||||
================================================
|
||||
|
||||
Synopsis
|
||||
--------
|
||||
|
||||
::
|
||||
|
||||
time COMMAND
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
``time`` causes fish to measure how long a command takes and print the results afterwards. The command can be a simple fish command or a block. The results can not currently be redirected.
|
||||
|
||||
For checking timing after a command has completed, check :ref:`$CMD_DURATION <variables-special>`.
|
||||
|
||||
Example
|
||||
-------
|
||||
|
||||
(for obvious reasons exact results will vary on your system)
|
||||
|
||||
::
|
||||
|
||||
>_ time sleep 1s
|
||||
|
||||
________________________________________________________
|
||||
Executed in 1,01 secs fish external
|
||||
usr time 2,32 millis 0,00 micros 2,32 millis
|
||||
sys time 0,88 millis 877,00 micros 0,00 millis
|
||||
|
||||
>_ time for i in 1 2 3; sleep 1s; end
|
||||
|
||||
________________________________________________________
|
||||
Executed in 3,01 secs fish external
|
||||
usr time 9,16 millis 2,94 millis 6,23 millis
|
||||
sys time 0,23 millis 0,00 millis 0,23 millis
|
Loading…
Reference in a new issue