summary refs log tree commit diff stats
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* DrNim (Nim compiler with Z3 integration) (#13743)Andreas Rumpf2020-03-311-0/+203
| | | | | | | | | | | | | | | | | | | | | | | | * code cleanups and feature additions * added basic test and koch/CI integration * make it build on Unix * DrNim: now buildable on Unix, only takes 10 minutes, enjoy * added basic documentation for DrNim which can also be seen as the RFC we're following * drnim: change the build setup so that drnim.exe ends up in bin/ * makes simple floating point ranges work * added basic float range check * drnim: teach Z3 about Nim's range types plus code refactoring * drnim: make unsigned numbers work * added and fixed index checking under setLen * first implementation of .ensures, .invariant and .assume (.requires still missing and so is proc type compatibility checking * drnim: .requires checking implemented * drnim: implemented .ensures properly * more impressive test involving min() * drnim: check for proc type compatibility and base method compatibility wrt .requires and .ensures * testament: support for 'pattern <directory> * koch: uses new <directory> feature of testament * drnim: added tiny musings about 'old' * Make testament work with old SSL versions * koch: add support for 'koch drnim -d:release' * drnim: preparations for the param.old notation
* macros for proc types, macros for types (#13778)Andreas Rumpf2020-03-311-44/+74
| | | | | | | | | * new minor feature: macros for proc types, to be documented * Finished the implementation and added tests * [skip ci] Describe the new custom pragmas in the manual and the changelog Co-authored-by: Zahary Karadjov <zahary@gmail.com>
* stacktraces can now show custom runtime msgs per frame (#13351)Timothee Cour2020-03-301-0/+1
| | | | | | | | * stacktraces can now show custom runtime msgs * improve tests/stdlib/tstackframes.nim * fix test for --gc:arc * test --stacktraceMsgs:on and --stacktraceMsgs:off * --stacktracemsgs:off by default
* [ci skip] docs: make the syntax for generics easy to look up (#13754)Rory O’Kane2020-03-251-1/+2
|
* [skip ci] docs: reword Part 3 link to communicate that it exists (#13755)Rory O’Kane2020-03-251-1/+1
|
* docs: say that `nil` can be used as a value (#13756)Rory O’Kane2020-03-251-5/+8
| | | | | and improve wording in other ways Showing that `nil` can be assigned helps to warn readers that variables can be `nil` even after being assigned a value.
* gc.rst that doesn't lie (#13686)Andreas Rumpf2020-03-191-54/+34
|
* Documentation GC (#13109)Juan Carlos2020-03-181-76/+98
| | | | | | | | | | | | | | | | * Update Documentation about GC, add ARC based on code observations and https://forum.nim-lang.org/t/5734#35562 * Rephrase 'Garbage Collector' on documentation, see #13331 * Peer Review Feedbacks * When the body of a documentation section is all for garbage collector details then add 'for garbage collectors' to the title to identify they may not apply for ARC * Change 'GC' for 'garbage collector'. * Move 'Memory Management Strategies' at the top, without changes * Move the info for RefC GC from 'Introduction' to 'RefC' section without changes, make 'Introduction' about Nims 'Multi-paradigm Memory Management Strategies'.
* arc optimizations (#13325)Andreas Rumpf2020-03-181-0/+1
| | | | | * scope based destructors * handle 'or' and 'and' expressions properly, see the new test arc/tcontrolflow.nim * make this branch mergable, logic is disabled for now
* fix typo (#13660) [ci skip]Kartik Saranathan2020-03-161-1/+1
|
* fix #13218: avoid some irrelevant warnings for nim doc,rst2html,--app:lib, + ↵Timothee Cour2020-03-131-2/+2
| | | | | | | | other fixes (#13550) * fix #13218: avoid some irrelevant warnings for nim doc,rst2html * suppress warnRedefinitionOfLabel for nim doc * lots of fixes for UnusedImport warnings
* catchable defects (#13626)Andreas Rumpf2020-03-122-13/+22
| | | | | | | | | | * allow defects to be caught even for --exceptions:goto (WIP) * implemented the new --panics:on|off switch; refs https://github.com/nim-lang/RFCs/issues/180 * new implementation for integer overflow checking * produce a warning if a user-defined exception type inherits from Exception directly * applied Timothee's suggestions; improved the documentation and replace the term 'checked runtime check' by 'panic' * fixes #13627 * don't inherit from Exception directly
* Only print the link command when listCmd is active; fix docs (#13603)Clyybber2020-03-071-2/+2
|
* sink parameter inference for types that have destructors (#13544)Andreas Rumpf2020-03-042-1/+19
| | | | | | | | | | | | | | * ensure capitalize doesn't take an inferred sink parameter * sink parameter inference: first version, for now disabled. Changed that sink parameters can be consumed multiple times in order to adhere to our spec. * sink inference can now be disabled with .nosinks; sometimes for proc type interop this is required * fixes yet another critical DFA bug * better implementation that also understands if expressions etc * document sink parameter inference and allow for global disabling
* fix #13409: Document as infix operator (#13570)hlaaftana2020-03-041-16/+16
|
* Document import/include outside of top level semantics (#13548)hlaaftana2020-03-011-0/+14
|
* [backport] tut1: Update the proc overloading examples (#13497) [skip ci]Kaushal Modi2020-02-251-5/+11
|
* only enable linenoise for -d:nimUseLinenoise (#13478)Timothee Cour2020-02-242-2/+2
| | | | | | * only enable linenoise for -d:nimUseLinenoise * fixup
* Update advopt.txt to include link to nim cache docs (#13464)Lee Matos2020-02-221-0/+1
|
* Fixed non-working examples in Manual: Exception Handling (#13424)Manav2020-02-201-1/+3
|
* manual: documents changes regarding dynlib (#13425)alaviss2020-02-181-4/+4
| | | | | | | | * manual: documents changes regarding dynlib Closes #13416 * manual: clean up sentence phrasing
* lib.rst: add a link for jsconsole [backport] (#13383)Jjp1372020-02-111-0/+3
|
* fixes #3339 by documenting the limitations of case-statement (#13366)Miran2020-02-081-0/+29
|
* fix #13150 `nim doc --project` now works reliably (#13223)Timothee Cour2020-02-061-0/+7
| | | | | | | | | | * fix #13150 `nim doc --project` works with duplicate names and with imports below main project file * add to help; fixup after #13212 isRelativeTo got merged * fix test tests/compilerapi/tcompilerapi.nim * remove nimblePkg field; compute on the fly instead * kochdocs: compiler docs now under compiler/ * --docRoot now has smart default: best among @pkg, @path
* contributing.rst: Add a special rule for 'outplace'-like featuresAraq2020-02-051-2/+15
|
* contributing docs: symbols need package prefix; changed allocStats to ↵Timothee Cour2020-01-251-0/+14
| | | | nimAllocStats (#13247)
* Updated 'nim for embedded systems' section to use --os:any and --gc:arc (#13237)Ico Doornekamp2020-01-231-15/+33
| | | | | | * Updated 'nim for embedded systems' section to use --os:any and --gc:arc * Added section about size optimization to embedded systems
* VM: allow overriding MaxLoopIterations without rebuilding nim (#13233)Timothee Cour2020-01-231-0/+1
|
* [backport] Documentation Fix #12251 (#13226) [ci skip]Juan Carlos2020-01-221-0/+8
|
* followup on #10435 : should be diff, not show (#13162)Timothee Cour2020-01-171-1/+1
|
* make sink operator optional (#13068)cooldome2020-01-171-2/+6
| | | | | | | | | | | | | | | | * make sink operator optional * bug fix, add changelog entry * Trigger build * fix one regression * fix test * Trigger build * fix typos
* Fix typo in doc/destructors.rst (#13148)Tomohiro2020-01-141-1/+1
|
* fixes #10665 (#13141) [backport]Andreas Rumpf2020-01-142-23/+28
|
* [easy] --hint:link:on now shows link cmd instead of nothing (#13056)Timothee Cour2020-01-071-1/+2
| | | | | | * --hint:link:on now shows link cmd instead of nothing * update doc for --listCmd
* Fix typo (#13015) [backport]Siegfried Ehret2020-01-031-1/+1
|
* --exception:goto switch for deterministic exception handling (#12977)Andreas Rumpf2020-01-011-1/+2
| | | | | This implements "deterministic" exception handling for Nim based on goto instead of setjmp. This means raising an exception is much cheaper than in C++'s table based implementations. Supports hard realtime systems. Default for --gc:arc and the C target because it's generally a good idea and arc is all about deterministic behavior. Note: This implies that fatal runtime traps are not catchable anymore! This needs to be documented.
* [ci skip] docfix .. < => ..< (#12981) [backport]Timothee Cour2019-12-291-1/+1
|
* added guidelines for evolving Nim's stdlibAraq2019-12-241-0/+62
|
* docs: tiny style improvementsAraq2019-12-242-2/+3
|
* update documentation for `closureScope` and `capture` (#12886)Judd2019-12-211-1/+2
|
* ARC: cycle detector (#12823)Andreas Rumpf2019-12-172-6/+30
| | | | | | | | | | | | | * first implementation of the =trace and =dispose hooks for the cycle collector * a cycle collector for ARC: progress * manual: the .acyclic pragma is a thing once again * gcbench: adaptations for --gc:arc * enable valgrind tests for the strutils tests * testament: better valgrind support * ARC refactoring: growable jumpstacks * ARC cycle detector: non-recursive algorithm * moved and renamed core/ files back to system/ * refactoring: --gc:arc vs --gc:orc since 'orc' is even more experimental and we want to ship --gc:arc soonish
* Add `--git.devel` option to the documentationBinHong Lee2019-12-151-0/+4
|
* feature dracula themed doc (#12816)Andreas Rumpf2019-12-101-214/+800
| | | | | | | | | | * Implement gorgeous Dracula themed Nim documentation * Add color for escape sequences * fixes the test cases * the big CSS cleanup
* Manual update: custom exceptions (#12847) [backport]Mark2019-12-081-0/+17
| | | Said that you can have custom exceptions and showed how to create and raise them.
* Removing the mention of using `discard` for block comments (#12837) [backport]Elliot Waite2019-12-081-3/+0
| | | | | | * Remove mention of using `discard` for block comments * Add a 32x32 alternate favicon
* deviated -> derived (#12846) [backport]Mark2019-12-081-3/+3
|
* deviated -> derived (#12845) [backport]Mark2019-12-081-1/+1
|
* [backport] Fix spelling typos (#12755)Brian Wignall2019-11-283-9/+9
|
* fix typo in the manual (#12723)tauplus2019-11-251-1/+1
|
* Fix wrong section hierarchy in the manual (#12724) [backport]tauplus2019-11-251-9/+9
|