mirrors/Nim
1
0
Fork 0
mirror of https://github.com/nim-lang/Nim.git synced 2026-03-01 22:28:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Hyperlinks quit related docstrings in system module.

Browse Source
This commit is contained in:
Grzegorz Adam Hankiewicz
2014-07-19 14:44:41 +02:00
parent 078594cac6
commit 9c6d54dec6
1 changed files with 15 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
lib/system.nim
View File

@@ -1006,11 +1006,11 @@ else:
const
QuitSuccess* = 0
## is the value that should be passed to ``quit`` to indicate
## is the value that should be passed to `quit <#quit>`_ to indicate
## success.
QuitFailure* = 1
## is the value that should be passed to ``quit`` to indicate
## is the value that should be passed to `quit <#quit>`_ to indicate
## failure.
var programResult* {.exportc: "nim_program_result".}: int
@@ -1023,10 +1023,11 @@ proc quit*(errorcode: int = QuitSuccess) {.
## Stops the program immediately with an exit code.
##
## Before stopping the program the "quit procedures" are called in the
## opposite order they were added with ``addQuitProc``. ``quit`` never
## returns and ignores any exception that may have been raised by the quit
## procedures. It does *not* call the garbage collector to free all the
## memory, unless a quit procedure calls ``GC_collect``.
## opposite order they were added with `addQuitProc <#addQuitProc>`_.
## ``quit`` never returns and ignores any exception that may have been raised
## by the quit procedures. It does *not* call the garbage collector to free
## all the memory, unless a quit procedure calls `GC_fullCollect
## <#GC_fullCollect>`_.
##
## The proc ``quit(QuitSuccess)`` is called implicitly when your nimrod
## program finishes without incident. A raised unhandled exception is
@@ -1034,7 +1035,8 @@ proc quit*(errorcode: int = QuitSuccess) {.
##
## Note that this is a *runtime* call and using ``quit`` inside a macro won't
## have any compile time effect. If you need to stop the compiler inside a
## macro, use the ``error`` or ``fatal`` pragmas.
## macro, use the `error <manual.html#error-pragma>`_ or `fatal
## <manual.html#fatal-pragma>`_ pragmas.
template sysAssert(cond: bool, msg: string) =
when defined(useSysAssert):
@@ -1186,11 +1188,12 @@ proc toBiggestInt*(f: BiggestFloat): BiggestInt {.
proc addQuitProc*(QuitProc: proc() {.noconv.}) {.
importc: "atexit", header: "<stdlib.h>".}
## adds/registers a quit procedure. Each call to ``addQuitProc``
## registers another quit procedure. Up to 30 procedures can be
## registered. They are executed on a last-in, first-out basis
## (that is, the last function registered is the first to be executed).
## ``addQuitProc`` raises an EOutOfIndex if ``quitProc`` cannot be
## Adds/registers a quit procedure.
##
## Each call to ``addQuitProc`` registers another quit procedure. Up to 30
## procedures can be registered. They are executed on a last-in, first-out
## basis (that is, the last function registered is the first to be executed).
## ``addQuitProc`` raises an EOutOfIndex exception if ``QuitProc`` cannot be
## registered.
# Support for addQuitProc() is done by Ansi C's facilities here.