jyapayne/Nim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

documentation updates

Browse source
This commit is contained in:
Araq 2014-10-11 13:20:00 +02:00
commit 028a62e2ba
2 changed files with 67 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

21
doc/manual.txt
View file

@ -5039,6 +5039,27 @@ first implementation to play with a language feature before a nicer syntax
to access the feature becomes available. to access the feature becomes available.
deprecated pragma
-----------------
The deprecated pragma is used to mark a symbol as deprecated:
.. code-block:: nimrod
proc p() {.deprecated.}
var x {.deprecated.}: char
It can also be used as a statement. Then it takes a list of *renamings*. The
upcoming ``nimfix`` tool can automatically update the code and perform these
renamings:
.. code-block:: nimrod
type
File = object
Stream = ref object
{.deprecated: [TFile: File, PStream: Stream].}
noSideEffect pragma noSideEffect pragma
------------------- -------------------
The ``noSideEffect`` pragma is used to mark a proc/iterator to have no side The ``noSideEffect`` pragma is used to mark a proc/iterator to have no side

85
web/news.txt
View file

@ -2,51 +2,58 @@
News News
==== ====
.. 2014-10-11 Version 0.9.6 released
2014-06-29 Version 0.9.6 released =================================
=================================
Changes affecting backwards compatibility **Note: This is the last release of Nimrod. The language has been renamed to
----------------------------------------- Nim. Nim slightly breaks compatibility.**
- ``spawn`` now uses an elaborate self-adapting thread pool and as such This is a maintenance release. The upcoming 0.10.0 release has all
has been moved into its own module. So to use it, you now have to import the new features and exciting developments.
``threadpool``.
- The symbol binding rules in generics changed: ``bar`` in ``foo.bar`` is
now considered for implicit early binding.
- ``c2nim`` moved into its own repository and is now a Babel package.
- ``pas2nim`` moved into its own repository and is now a Babel package.
- ``system.$`` for floating point types now produces a human friendly string
representation.
- ``uri.TUrl`` as well as the ``parseurl`` module are now deprecated in favour
of the new ``TUri`` type in the ``uri`` module.
- The ``destructor`` pragma has been deprecated. Use the ``override`` pragma
instead. The destructor's name has to be ``destroy`` now.
- ``lambda`` is not a keyword anymore.
- **system.defined has been split into system.defined and system.declared**.
You have to use ``--symbol`` to declare new conditional symbols that can be
set via ``--define``.
- ``--threadanalysis:on`` is now the default. To make your program compile
you can disable it but this is only a temporary solution as this option
will disappear soon!
Language Additions
------------------
- There is a new ``parallel`` statement for safe fork&join parallel computing. Changes affecting backwards compatibility
-----------------------------------------
Library Additions - ``spawn`` now uses an elaborate self-adapting thread pool and as such
----------------- has been moved into its own module. So to use it, you now have to import
``threadpool``.
- The symbol binding rules in generics changed: ``bar`` in ``foo.bar`` is
now considered for implicit early binding.
- ``c2nim`` moved into its own repository and is now a Babel package.
- ``pas2nim`` moved into its own repository and is now a Babel package.
- ``system.$`` for floating point types now produces a human friendly string
representation.
- ``uri.TUrl`` as well as the ``parseurl`` module are now deprecated in favour
of the new ``TUri`` type in the ``uri`` module.
- The ``destructor`` pragma has been deprecated. Use the ``override`` pragma
instead. The destructor's name has to be ``destroy`` now.
- ``lambda`` is not a keyword anymore.
- **system.defined has been split into system.defined and system.declared**.
You have to use ``--symbol`` to declare new conditional symbols that can be
set via ``--define``.
- ``--threadanalysis:on`` is now the default. To make your program compile
you can disable it but this is only a temporary solution as this option
will disappear soon!
- Added module ``cpuinfo``.
- Added module ``threadpool``. Language Additions
- ``sequtils.distnct`` has been renamed to ``sequtils.deduplicate``. ------------------
- Added ``algorithm.reversed``
- Added ``uri.combine`` and ``uri.parseUri``. - This version introduces the new ``deprecated`` pragma statement that is used
- Some sockets procedures now support a ``SafeDisconn`` flag which causes to handle the upcoming massive amount of symbol renames.
them to handle disconnection errors and not raise them.
Library Additions
-----------------
- Added module ``cpuinfo``.
- Added module ``threadpool``.
- ``sequtils.distnct`` has been renamed to ``sequtils.deduplicate``.
- Added ``algorithm.reversed``
- Added ``uri.combine`` and ``uri.parseUri``.
- Some sockets procedures now support a ``SafeDisconn`` flag which causes
them to handle disconnection errors and not raise them.
2014-04-21 Version 0.9.4 released 2014-04-21 Version 0.9.4 released