216 |
Emacs. |
Emacs. |
217 |
@end defvar |
@end defvar |
218 |
|
|
219 |
@xref{Init File Examples,,, emacs, The GNU Emacs Manual}, for |
@xref{Init Examples,, Init File Examples, emacs, The GNU Emacs Manual}, for |
220 |
examples of how to make various commonly desired customizations in your |
examples of how to make various commonly desired customizations in your |
221 |
@file{.emacs} file. |
@file{.emacs} file. |
222 |
|
|
400 |
|
|
401 |
The command-line arguments are parsed by the @code{command-line-1} |
The command-line arguments are parsed by the @code{command-line-1} |
402 |
function in the @file{startup.el} file. See also @ref{Command |
function in the @file{startup.el} file. See also @ref{Command |
403 |
Switches, , Command Line Switches and Arguments, emacs, The GNU Emacs |
Arguments, , Command Line Arguments, emacs, The GNU Emacs Manual}. |
|
Manual}. |
|
404 |
@end defvar |
@end defvar |
405 |
|
|
406 |
@defvar command-line-args |
@defvar command-line-args |
796 |
If @var{use-float} is non-@code{nil}, then they are returned |
If @var{use-float} is non-@code{nil}, then they are returned |
797 |
as floating point numbers and without multiplying by 100. |
as floating point numbers and without multiplying by 100. |
798 |
|
|
799 |
|
If it is impossible to obtain the load average, this function signals |
800 |
|
an error. On some platforms, access to load averages requires |
801 |
|
installing Emacs as setuid or setgid so that it can read kernel |
802 |
|
information, and that usually isn't advisable. |
803 |
|
|
804 |
@example |
@example |
805 |
@group |
@group |
806 |
(load-average) |
(load-average) |
922 |
|
|
923 |
@defun user-real-uid |
@defun user-real-uid |
924 |
This function returns the real @sc{uid} of the user. |
This function returns the real @sc{uid} of the user. |
925 |
|
The value may be a floating point number. |
926 |
|
|
927 |
@example |
@example |
928 |
@group |
@group |
934 |
|
|
935 |
@defun user-uid |
@defun user-uid |
936 |
This function returns the effective @sc{uid} of the user. |
This function returns the effective @sc{uid} of the user. |
937 |
|
The value may be a floating point number. |
938 |
@end defun |
@end defun |
939 |
|
|
940 |
@node Time of Day |
@node Time of Day |
1168 |
the inverse conversion, use @code{float-time}. |
the inverse conversion, use @code{float-time}. |
1169 |
@end defun |
@end defun |
1170 |
|
|
1171 |
@defun decode-time time |
@defun decode-time &optional time |
1172 |
This function converts a time value into calendrical information. The |
This function converts a time value into calendrical information. If |
1173 |
return value is a list of nine elements, as follows: |
you don't specify @var{time}, it decodes the current time. The return |
1174 |
|
value is a list of nine elements, as follows: |
1175 |
|
|
1176 |
@example |
@example |
1177 |
(@var{seconds} @var{minutes} @var{hour} @var{day} @var{month} @var{year} @var{dow} @var{dst} @var{zone}) |
(@var{seconds} @var{minutes} @var{hour} @var{day} @var{month} @var{year} @var{dow} @var{dst} @var{zone}) |
1238 |
|
|
1239 |
The operating system puts limits on the range of possible time values; |
The operating system puts limits on the range of possible time values; |
1240 |
if you try to encode a time that is out of range, an error results. |
if you try to encode a time that is out of range, an error results. |
1241 |
|
For instance, years before 1970 do not work on some systems; |
1242 |
|
on others, years as early as 1901 do work. |
1243 |
@end defun |
@end defun |
1244 |
|
|
1245 |
@node Time Calculations |
@node Time Calculations |
1285 |
@section Timers for Delayed Execution |
@section Timers for Delayed Execution |
1286 |
@cindex timer |
@cindex timer |
1287 |
|
|
1288 |
You can set up a @dfn{timer} to call a function at a specified future time or |
You can set up a @dfn{timer} to call a function at a specified |
1289 |
after a certain length of idleness. |
future time or after a certain length of idleness. |
1290 |
|
|
1291 |
Emacs cannot run timers at any arbitrary point in a Lisp program; it |
Emacs cannot run timers at any arbitrary point in a Lisp program; it |
1292 |
can run them only when Emacs could accept output from a subprocess: |
can run them only when Emacs could accept output from a subprocess: |
1295 |
timer's execution may be delayed if Emacs is busy. However, the time of |
timer's execution may be delayed if Emacs is busy. However, the time of |
1296 |
execution is very precise if Emacs is idle. |
execution is very precise if Emacs is idle. |
1297 |
|
|
1298 |
|
Emacs binds @code{inhibit-quit} to @code{t} before calling the timer |
1299 |
|
function, because quitting out of many timer functions can leave |
1300 |
|
things in an inconsistent state. This is normally unproblematical |
1301 |
|
because most timer functions don't do a lot of work. Indeed, for a |
1302 |
|
timer to calls a function that takes substantial time to run is likely |
1303 |
|
to be annoying. |
1304 |
|
|
1305 |
@defun run-at-time time repeat function &rest args |
@defun run-at-time time repeat function &rest args |
1306 |
This function arranges to call @var{function} with arguments @var{args} |
This function arranges to call @var{function} with arguments @var{args} |
1307 |
at time @var{time}. The argument @var{function} is a function to call |
at time @var{time}. The argument @var{function} is a function to call |
2080 |
nil) |
nil) |
2081 |
@end group |
@end group |
2082 |
@end example |
@end example |
2083 |
|
|
2084 |
|
@ignore |
2085 |
|
arch-tag: 8378814a-30d7-467c-9615-74a80b9988a7 |
2086 |
|
@end ignore |