summary refs log tree commit diff stats
path: root/doc/manual.rst
Commit message (Collapse)AuthorAgeFilesLines
* add `enumerate` macro (#15297)Miran2020-09-221-5/+6
| | | | | | | * add `enumerate` macro * address the comments * put `enumerate` in its own module
* Methods docs improvement (#15338)flywind2020-09-161-5/+31
| | | | | * docs improvement * minor
* [ci skip] fix typo in the manualnarimiran2020-09-091-2/+2
|
* "for-loop macros" are no longer an experimental feature (#15288)Miran2020-09-081-0/+42
|
* Fix #5691 (#15158)Clyybber2020-08-271-18/+7
| | | | | | | | * Fix #5691 * Cleanup and thoughts * Use scope approach * Seperate defined/declared/declaredInScope magics * Fix declaredInScope * Update spec accordingly
* Added array type definition to manual (#15173)Ico Doornekamp2020-08-101-0/+3
| | | Co-authored-by: Ico Doornekamp <git@zevv.nl>
* Minor improvements to typecast section of manual (#14896)awr12020-07-071-7/+18
| | | | | | | * Minor improvements to typecast section of manual * Clarification to casting w/ concrete types * Added less ambiguous language
* {.deprecated: [existsFile: fileExists].} (#14735)Timothee Cour2020-07-021-2/+2
| | | | | | | | | * {.deprecated: [existsFile: fileExists].} * s/existsFile/fileExists/ except under deps * workaround pending #14819 * fix test
* Fix some typos (#14843)Danil Yarantsev2020-06-281-1/+1
|
* Warn about calling wrappers at compile time until #14049 is fixed. (#14828)Sizhe Zhao2020-06-271-1/+4
|
* init checks and 'out' parameters (#14521)Andreas Rumpf2020-06-231-11/+21
| | | | | | | | | | | * I don't care about observable stores * enforce explicit initializations * cleaner code for the stdlib * stdlib: use explicit initializations * make tests green * algorithm.nim: set result explicitly * remove out parameters and bring the PR into a mergable state * updated the changelog
* Deprecate unroll pragma, remove from documentation (#14705)Juan Carlos2020-06-191-19/+0
|
* Change 'Future Directions' to link memory management documentation (#14664)Juan Carlos2020-06-151-2/+2
|
* Clarify imported exceptions note in manualDominik Picheta2020-06-131-1/+1
|
* manual: removed subjective phrase from 'macros' section (#14536)Ico Doornekamp2020-06-011-2/+1
| | | | | | Removed phrase "However, this is no real restriction because Nim's syntax is flexible enough anyway." from the manual - I find it very subjective, and I sometimes *do* find myself restricted by Nim's syntax when writing DSLs
* spec: be explicit that NRVO will evolve furtherAraq2020-05-301-0/+4
|
* document NVRO and exception handlingAraq2020-05-301-0/+65
|
* Add thiscall calling convention, mostly for hooking purpose (#14466)Huy Doan2020-05-271-0/+4
| | | | * Add thiscall calling convention, mostly for hooking purpose * add changelog and documentation
* manual.rst: updates [backport] (#14445)Andreas Rumpf2020-05-251-23/+24
|
* Fix some typos in the manual [backport] (#14399)Danil Yarantsev2020-05-201-10/+10
|
* refs #14369 improve docs for importcpp exceptions (#14391)Timothee Cour2020-05-181-8/+30
| | | | | * refs #14369 improve docs for importcpp exceptions * address comments
* docs:getCurrentException() and getCurrentExceptionMsg() are not available ↵cooldome2020-05-181-1/+3
| | | | for imported exceptions (#14392)
* docfix: fix wrong link in doc/manual.rst (#14367)Bung2020-05-161-1/+1
|
* Allow let to not have value when using importc (#14258)PMunch2020-05-121-0/+15
| | | | | | | | | | | | | | * Allow let to not have value when using importc This allows a let statement with the `{.importc.}` pragma to not be initialised with a value. This allows us to declare C constants as Nim lets without putting the value in the Nim code (which can lead to errors, and requires us to go looking for the value). Fixes #14253 * Proper fix and documentation + changelog entry * Improve testcase with one from timotheecour * Add test to verify it working with macros
* Added a reference to ternary operators. (#14309)Avahe Kellenberger2020-05-121-0/+1
| | | | | `if expressions` are similar to ternary operators in other languages. In order to make this easier to find in the manual, I've added a sentence about it.
* do not track 'raise Defect' in the .raises: [] clause anymore (#14298)Andreas Rumpf2020-05-111-0/+22
| | | | | | | | | * do not track 'raise Defect' in the .raises: [] clause anymore * --panics:on maps 'raise Defect' to an unrecoverable fatal error * make tests green again * update the documentation too
* make `from` an operator (#14241)hlaaftana2020-05-081-16/+16
|
* exp. features now in correct manual, closes #11932 (#14195)hlaaftana2020-05-021-167/+3
|
* discardable async procs are now an error (#14176)hlaaftana2020-05-011-1/+2
| | | | * add discard warning in manual
* Error -> Defect for defects (#13908)Jacek Sieka2020-04-281-14/+14
| | | | | | | | | | | | | | * Error -> Defect for defects The distinction between Error and Defect is subjective, context-dependent and somewhat arbitrary, so when looking at an exception, it's hard to guess what it is - this happens often when looking at a `raises` list _without_ opening the corresponding definition and digging through layers of inheritance. With the help of a little consistency in naming, it's at least possible to start disentangling the two error types and the standard lib can set a good example here.
* changed type() to typeof() in docs and error messages (#14084)hlaaftana2020-04-241-1/+1
|
* docs: move `not nil` to the experimental page (#14027)Rory O’Kane2020-04-211-26/+0
| | | | | When I heard that this feature existed, and found the 2018 changelog entry that said `not nil` was made experimental (https://github.com/nim-lang/Nim/blob/devel/changelogs/changelog_0_19_0.md#changes-affecting-backwards-compatibility), I looked for `not nil` documentation in https://nim-lang.org/docs/manual_experimental.html. When I didn’t find it there, I initially assumed the feature had no documentation. This change moves the documentation to where readers will expect it. As well as moving the text to another file, I added instructions for enabling the experimental feature and tweaked some wording.
* clarify tuples and objects in manual, fixes #12486 (#14044)hlaaftana2020-04-211-7/+20
|
* Small typo (#13824)Clyybber2020-03-311-1/+1
|
* 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>
* 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.
* catchable defects (#13626)Andreas Rumpf2020-03-121-13/+21
| | | | | | | | | | * 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
* 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
|
* 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
* fixes #3339 by documenting the limitations of case-statement (#13366)Miran2020-02-081-0/+29
|
* fixes #10665 (#13141) [backport]Andreas Rumpf2020-01-141-0/+3
|
* docs: tiny style improvementsAraq2019-12-241-2/+2
|
* update documentation for `closureScope` and `capture` (#12886)Judd2019-12-211-1/+2
|
* ARC: cycle detector (#12823)Andreas Rumpf2019-12-171-2/+26
| | | | | | | | | | | | | * 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
* 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.
* deviated -> derived (#12845) [backport]Mark2019-12-081-1/+1
|
* [backport] Fix spelling typos (#12755)Brian Wignall2019-11-281-5/+5
|
* fix typo in the manual (#12723)tauplus2019-11-251-1/+1
|