.. -*- coding: utf-8; -*-

.. include:: HEADER.rst

======

 NSIS

======

.. contents::

   :local:

Strings

=======

String is a sequence of chars. To represent spaces enclose string in quotes.

To escape quote use $\. ${MACRO_NAME}, $(VAR_NAME) substituted with

macros/variable values. To escape $ use $$.

  MessageBox MB_OK "I'll be happy" ; this one puts a ' inside a string

  MessageBox MB_OK 'And he said to me "Hi there!"' ; this one puts a " inside a string

  MessageBox MB_OK `And he said to me "I'll be happy!"` ; this one puts both ' and "s inside a string

  MessageBox MB_OK "$\"A quote from a wise man$\" said the wise man" ; this one shows escaping of quotes

Variables

=========

Allowed chaacters for variable names: [a-z][A-Z][0-9] and '_'.

Variable definition

-------------------

To declare variable::

  Var NAME

There are exist registers (predefined variable) through them passed args for

macros/functions/plug-ins::

  $0, $1, $2, $3, $4, $5, $6, $7, $8, $9, $R0, $R1, $R2, $R3, $R4, $R5, $R6, $R7, $R8, $R9

To assign value to variable use::

  StrCpy $NAME STRING

To access to there value use such syntax::

  $NAME

Language strings

----------------

To declare multilingual string use::

  LangString NAME LANGUAGE_ID STRING

For ``LANGUAGE_ID`` use ``${LANG_ENGLISH}``, ``${LANG_RUSSIAN}``, etc.

To access to there value use such syntax::

  $(NAME)

Standard language strings

-------------------------

You can see list of such var under Contrib\Language Files\*.nlf files, which

loaded by ``LoadLanguageFile``.

To access to there value use such syntax::

  $(^NAME)

Macros definition

-----------------

To define macro variable::

  !define NAME STRING

To access to there value use such syntax::

  ${NAME}