comparison pwm.1.xml @ 27:722a45b4028b

Add define command for defining macros Macros are parsed when they are defined with the D command and can subsequently be used as arguments for other commands. Handle out of memory errors directly in tok.c.
author Guido Berhoerster <guido+pwm@berhoerster.name>
date Mon, 25 Sep 2017 21:21:25 +0200
parents 5bdea77d0c1d
children e3db02d7f1f4
comparison
equal deleted inserted replaced
26:5bdea77d0c1d 27:722a45b4028b
32 <surname>Berhoerster</surname> 32 <surname>Berhoerster</surname>
33 </personname> 33 </personname>
34 <email>guido+pwm@berhoerster.name</email> 34 <email>guido+pwm@berhoerster.name</email>
35 <personblurb/> 35 <personblurb/>
36 </author> 36 </author>
37 <date>17 September, 2017</date> 37 <date>25 September, 2017</date>
38 </info> 38 </info>
39 <refmeta> 39 <refmeta>
40 <refentrytitle>pwm</refentrytitle> 40 <refentrytitle>pwm</refentrytitle>
41 <manvolnum>1</manvolnum> 41 <manvolnum>1</manvolnum>
42 <refmiscinfo class="source"/> 42 <refmiscinfo class="source"/>
480 </cmdsynopsis> 480 </cmdsynopsis>
481 <para>Change the master password.</para> 481 <para>Change the master password.</para>
482 </listitem> 482 </listitem>
483 </varlistentry> 483 </varlistentry>
484 <varlistentry> 484 <varlistentry>
485 <term>Define macro</term>
486 <listitem>
487 <cmdsynopsis>
488 <command>define</command>
489 <arg choice="plain">
490 <replaceable>name</replaceable>=<replaceable>value</replaceable>
491 </arg>
492 </cmdsynopsis>
493 <cmdsynopsis>
494 <command>D</command>
495 <arg choice="plain">
496 <replaceable>name</replaceable>=<replaceable>value</replaceable>
497 </arg>
498 <sbr/>
499 </cmdsynopsis>
500 <para>Define the macro <replaceable>name</replaceable> to expand to
501 <replaceable>value</replaceable>. A Macro is a shorthand term for
502 a command and/or command arguments. Macros are tokenized when they
503 are defined, thus if a macro contains other macros, these other
504 macros are expanded once at the time the macro is defined and not
505 each time a macro is expanded later. A macro can be used as like a
506 command or as part of the command's argument by prefixing the macro
507 name by a &quot;$&quot;. It is expanded by substituting the
508 previously tokenized contents before the command is
509 evaluated.</para>
510 </listitem>
511 </varlistentry>
512 <varlistentry>
485 <term>Display help text</term> 513 <term>Display help text</term>
486 <listitem> 514 <listitem>
487 <cmdsynopsis> 515 <cmdsynopsis>
488 <command>help</command> 516 <command>help</command>
489 <arg choice="opt"> 517 <arg choice="opt">